Skip to content

Conversation

@whoabuddy
Copy link

@whoabuddy whoabuddy commented Jan 14, 2026

Summary

Adds x402 protocol support for the Stacks blockchain, including the "exact" payment scheme specification, ecosystem entries for available services, and supporting assets.

About Stacks

  • Bitcoin L2 with 100% Bitcoin finality for smart contracts and DeFi
  • Proof of Transfer (PoX) consensus anchored to Bitcoin's security
  • Fast blocks (~5 seconds) with multiple Stacks blocks per Bitcoin block
  • Clarity smart contracts with native Bitcoin state visibility
  • sBTC for decentralized, programmable BTC; STX for gas
  • Stacks Website | sBTC | Docs

What's Included

Scheme Specification

  • specs/schemes/exact/scheme_exact_stacks.md - Complete "exact" payment scheme for Stacks
    • Client-driven transactions with facilitator settlement
    • Support for STX (native) and SIP-010 fungible tokens (sBTC, USDCx)
    • Facilitator verification rules
    • Token contract addresses for mainnet/testnet

Ecosystem Entries

Entry Category Description
x402Stacks Client-Side Integrations TypeScript SDK (x402-stacks on npm)
x402Stacks Facilitator Facilitators Transaction settlement service
x402StacksScan Infrastructure & Tooling Ecosystem explorer and stats
AIBTC Sponsor Relay Infrastructure & Tooling Sponsored / gasless transaction relay
STX402 Endpoints x402 powered registry (mainnet)
AIBTC x402 API Endpoints AI inference and app storage (mainnet + testnet)
x402 Biwas Endpoints AI-powered DeFi analytics

Supported Tokens

Token Mainnet Testnet
STX Native Native
sBTC SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token::sbtc-token
USDCx SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx::usdcx-token Not yet deployed

Live Services

note: posting all links here for informational purposes and to make sure we didn't miss adding anything!

Protocol / facilitator:

Sponsored / gasless TX relay:

stx402 endpoints:

AIBTC endpoints:

Biwas endpoints:

🤖 Generated with Claude Code

whoabuddy and others added 9 commits January 12, 2026 17:03
Add two new ecosystem partners for Stacks blockchain support:

- x402-stacks: TypeScript client/server library for x402 payments
  on Stacks, supporting STX and sBTC tokens with axios interceptors
  and Express middleware

- STX402: Registry and dashboard for x402-enabled endpoints on
  the Stacks blockchain

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Document how the x402 exact payment scheme works on the Stacks
blockchain:

- Protocol flow for client-signed, facilitator-broadcast transactions
- PaymentRequirements and PaymentPayload structures
- Support for STX native token and SIP-010 fungible tokens (sBTC, USDCx)
- Facilitator verification rules
- Security considerations for fully-signed transactions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add stx402.svg and x402-stacks.svg logos
- Rename x402 Stacks SDK to x402Stacks (matching repo name)
- Update metadata to reference SVG logos
- Update spec reference to use consistent naming

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Update stx402.svg with new design
- Rename x402-stacks.svg to x402Stacks.svg
- Update logoUrl reference in metadata.json

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Update x402Stacks websiteUrl to x402stacks.xyz
- Add x402StacksScan for ecosystem explorer at scan.x402stacks.xyz
- Add x402Stacks Facilitator with live endpoint at facilitator.x402stacks.xyz

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add AIBTC x402 API, x402 Biwas, and AIBTC Sponsor Relay entries
- Update facilitator to support both mainnet and testnet
- Add GitHub URLs to stx402 and x402-stacks entries
- Document sBTC and USDCx contract addresses in scheme spec

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add aibtc.png logo for AIBTC entries
- Add biwas.jpg logo for x402 Biwas entry
- Update Biwas description with AI analytics details and STX support

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Change websiteUrl from incorrect GitHub URL to stacksx402.com
- Add correct githubUrl pointing to x402Stacks/x402-stacks-facilitator

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@cb-heimdall
Copy link

cb-heimdall commented Jan 14, 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 0
Sum 1

@vercel
Copy link

vercel bot commented Jan 14, 2026

@whoabuddy 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 labels Jan 14, 2026
whoabuddy and others added 4 commits January 14, 2026 14:07
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Move STX402 from Infrastructure & Tooling to Services/Endpoints.
Fix category name for AIBTC and Biwas entries. Update descriptions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add detailed low-level documentation for implementers including:
- CAIP-2 network identifiers and chain ID derivation
- Transaction structure and byte-level layout
- Payload types for STX and SIP-010 transfers
- Clarity value encoding with type IDs
- Standard and sponsored authorization structures
- Signature format (65-byte recoverable ECDSA)
- Post-condition encoding for STX and fungible tokens
- Annotated hex examples for STX and sBTC transfers
- Address version bytes for mainnet/testnet

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ecosystem Additions to ecosystem site specs Spec changes or additions

Development

Successfully merging this pull request may close these issues.

2 participants