Skip to content

Conversation

@gigabit-eth
Copy link

@gigabit-eth gigabit-eth commented Dec 26, 2025

Description

Adds the escrow scheme specification for session-based, usage-metered payments within x402.

This scheme complements the existing exact scheme by enabling deferred settlement patterns where:

  • Payment amounts are determined after resource consumption
  • Funds are locked in escrow and released based on actual usage
  • Batch settlement reduces on-chain transactions from per-request to per-session

Use cases: Metered API access, LLM inference, compute services, multi-call agent workflows

Files added:

  • specs/schemes/escrow/scheme_escrow.md - Core scheme specification
  • specs/schemes/escrow/scheme_escrow_evm.md - EVM implementation (Base Sepolia)
  • specs/schemes/escrow/scheme_escrow_svm.md - Solana session layer w/ cross-chain relay (experimental)

Reference implementation: cart.fun contracts

Tests

This PR adds specification documentation only—no code changes requiring tests.

Checklist

@cb-heimdall
Copy link

cb-heimdall commented Dec 26, 2025

🟡 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 Dec 26, 2025

@gigabit-eth is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@cb-heimdall
Copy link

Review Error for kmk142789 @ 2025-12-27 03:57:31 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants