Skip to content

feat(specs): Add subscribe scheme specification for recurring payments#1133

Open
asghaier76 wants to merge 2 commits intocoinbase:mainfrom
asghaier76:feat/subscribe-scheme-spec
Open

feat(specs): Add subscribe scheme specification for recurring payments#1133
asghaier76 wants to merge 2 commits intocoinbase:mainfrom
asghaier76:feat/subscribe-scheme-spec

Conversation

@asghaier76
Copy link

@asghaier76 asghaier76 commented Feb 9, 2026

Introduces a new payment scheme to complement the existing scheme,
enabling subscription-based recurring payments for internet resources.

Key features:

  • Subscription lifecycle: discovery, subscribe, access with proof, renew/cancel
  • Pre-authorized renewals via EIP-3009 or Permit2 signatures
  • Subscription proof header for efficient access verification without per-request payments
  • Grace period handling for failed renewals
  • Support for multiple billing cycles (daily, weekly, monthly, annual)
  • AI agent optimization for automatic payment scheme selection

Includes:

  • specs/schemes/subscribe/scheme_subscribe.md - Scheme overview
  • specs/schemes/subscribe/scheme_subscribe_evm.md - EVM-specific implementation with reference smart contracts (x402SubscriptionRegistry, x402SubscriptionProxy)

References: #512

Description

Tests

Checklist

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

@cb-heimdall
Copy link

cb-heimdall commented Feb 9, 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

@github-actions github-actions bot added the specs Spec changes or additions label Feb 9, 2026
@vercel
Copy link

vercel bot commented Feb 9, 2026

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

A member of the Team first needs to authorize it.

   Introduces a new  payment scheme to complement the existing  scheme,
   enabling subscription-based recurring payments for internet resources.

   Key features:
   - Subscription lifecycle: discovery, subscribe, access with proof, renew/cancel
   - Pre-authorized renewals via EIP-3009 or Permit2 signatures
   - Subscription proof header for efficient access verification without per-request payments
   - Grace period handling for failed renewals
   - Support for multiple billing cycles (daily, weekly, monthly, annual)
   - AI agent optimization for automatic payment scheme selection

   Includes:
   - specs/schemes/subscribe/scheme_subscribe.md - Scheme overview
   - specs/schemes/subscribe/scheme_subscribe_evm.md - EVM-specific implementation with
     reference smart contracts (x402SubscriptionRegistry, x402SubscriptionProxy)

   References: coinbase#512
@asghaier76 asghaier76 force-pushed the feat/subscribe-scheme-spec branch from 6d00aab to 1872aac Compare February 9, 2026 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

specs Spec changes or additions

Development

Successfully merging this pull request may close these issues.

2 participants