Skip to content

ecosystem: add x402s — state channel payments for agents and APIs#1907

Open
pr0toshi wants to merge 1 commit intox402-foundation:mainfrom
pr0toshi:ecosystem/x402s
Open

ecosystem: add x402s — state channel payments for agents and APIs#1907
pr0toshi wants to merge 1 commit intox402-foundation:mainfrom
pr0toshi:ecosystem/x402s

Conversation

@pr0toshi
Copy link
Copy Markdown

@pr0toshi pr0toshi commented Apr 2, 2026

Adds x402s to the ecosystem page under Infrastructure & Tooling, along with the statechannel scheme spec docs.

x402s is the reference implementation of the statechannel payment scheme for x402. Agents open a funded channel once, pay thousands of API calls off-chain via signed state updates, and settle on-chain only when the channel closes.
Reference implementation: github.com/Keychain-Inc/x402s

Description

Adds x402s to the ecosystem page under Infrastructure & Tooling, along with the statechannel scheme spec docs.
x402s is the reference implementation of the statechannel payment scheme for x402. Agents open a funded channel once, pay thousands of API calls off-chain via signed state updates, and settle on-chain only when the channel closes.
Components:
X402StateChannel.sol — on-chain dispute contract (deterministic CREATE2)
Hub server — quote/issue/settlement workflows with configurable fees
Agent SDK + CLI — discover offers, open channels, make paid API calls
Payee server template — protect any API route with 402 + statechannel offers
Challenge watcher — monitors and disputes stale on-chain closes

Ecosystem entry:

typescript/site/app/ecosystem/partners-data/x402s/metadata.json
typescript/site/public/logos/x402s.png

Spec docs:

specs/schemes/statechannel/scheme_statechannel.md — scheme overview, trust model, security requirements
specs/schemes/statechannel/scheme_statechannel_evm.md — EVM implementation: EIP-712 signing, contract interface, verification, settlement, streaming
docs/extensions/state-channels.mdx — user-facing docs page
docs/docs.json — nav entry (+1 line)

Reference implementation: github.com/Keychain-Inc/x402s

Tests

No runtime code changes — this PR adds only static content (spec markdown, docs page, ecosystem metadata, logo). Verified:

docs.json is valid JSON after nav entry insertion
All file paths match the existing ecosystem and specs directory conventions
Logo is PNG, metadata.json matches the schema used by other ecosystem entries

Checklist

  • [ x] I have formatted and linted my code
  • [ x] All new and existing tests pass
  • [ x] My commits are signed (required for merge) -- you may need to rebase if you initially pushed unsigned commits
  • [ x] I added a changelog fragment for user-facing changes (docs-only changes can skip)

@cb-heimdall
Copy link
Copy Markdown

cb-heimdall commented Apr 2, 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 Apr 2, 2026

Someone 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 ecosystem Additions to ecosystem site specs Spec changes or additions website docs labels Apr 2, 2026
Adds x402s to the ecosystem page under Infrastructure & Tooling, along with
the statechannel scheme spec docs.

x402s is the reference implementation of the statechannel payment scheme for
x402. Agents open a funded channel once, pay thousands of API calls off-chain
via signed state updates, and settle on-chain only when the channel closes.

Components:
- X402StateChannel.sol — on-chain dispute contract (deterministic CREATE2)
- Hub server — quote/issue/settlement workflows with configurable fees
- Agent SDK + CLI — discover offers, open channels, make paid API calls
- Payee server template — protect any API route with 402 + statechannel
- Challenge watcher — monitors and disputes stale on-chain closes

Ecosystem entry:
- typescript/site/app/ecosystem/partners-data/x402s/metadata.json
- typescript/site/public/logos/x402s.png

Spec docs:
- 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs ecosystem Additions to ecosystem site specs Spec changes or additions website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants