Skip to content

specs: add draft SCP statechannel scheme docs#1338

Open
pr0toshi wants to merge 1 commit intox402-foundation:mainfrom
pr0toshi:feat/scp-scheme-spec
Open

specs: add draft SCP statechannel scheme docs#1338
pr0toshi wants to merge 1 commit intox402-foundation:mainfrom
pr0toshi:feat/scp-scheme-spec

Conversation

@pr0toshi
Copy link
Copy Markdown

@pr0toshi pr0toshi commented Feb 25, 2026

Summary

  • add draft SCP scheme docs under specs/schemes/statechannel/
  • add docs page: docs/extensions/state-channels.mdx
  • add docs nav entry in docs/docs.json

What this includes

  • profile family overview for statechannel-hub-v1 and statechannel-direct-v1
  • v2-aligned 402 example (amount, maxTimeoutSeconds, top-level extensions)
  • channel lifecycle and settlement overview
  • reference implementation API section clearly marked as non-normative

What this does not include

  • no runtime SDK changes
  • no facilitator/protocol code changes
  • no patch artifact files (PR_DESCRIPTION.md, state-channels-extension.patch)

Motivation

exact works well for per-request on-chain settlement. SCP draft profiles cover high-frequency payment use cases where off-chain state transitions are preferable.

@cb-heimdall
Copy link
Copy Markdown

cb-heimdall commented Feb 25, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@vercel
Copy link
Copy Markdown

vercel bot commented Feb 25, 2026

@pr0toshi is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions bot added specs Spec changes or additions docs labels Feb 25, 2026
Add draft spec for the statechannel payment scheme under specs/schemes/statechannel/.
Uses a single scheme identifier with route field (hub/direct) in extensions.

Files:
- specs/schemes/statechannel/scheme_statechannel.md — scheme overview
- specs/schemes/statechannel/scheme_statechannel_evm.md — EVM implementation
- docs/extensions/state-channels.mdx — user-facing docs
- docs/docs.json — nav entry

Reference implementation: github.com/Keychain-Inc/x402s
@pr0toshi pr0toshi force-pushed the feat/scp-scheme-spec branch from e44565c to 57f551d Compare April 2, 2026 12:51
@pr0toshi
Copy link
Copy Markdown
Author

pr0toshi commented Apr 2, 2026

thoughts

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs specs Spec changes or additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants