feat: add versioning strategy for payment methods and intents by brendanjryan · Pull Request #113 · tempoxyz/mpp-specs

brendanjryan · 2026-02-06T17:11:28Z

Summary

Adds a formal versioning strategy for the Payment Auth spec

Three-Layer Versioning

Layer	Mechanism	Breaking Change
Core Protocol	No wire version (stable `Payment` scheme name)	New scheme name (`Payment2`)
Payment Methods	Identifier + optional `methodDetails.version`	New identifier (`tempo-v2`)
Payment Intents	`request.version` field (default: 1)	Increment version

Changes

Types

Added version?: number to TempoMethodDetails (method-level)
Added version?: number to all intent request types: ChargeRequest, AuthorizeRequest, SubscriptionRequest, StreamRequest
Both packages/paymentauth-protocol and packages/protocol

Apps

Set version: 1 in all app ChargeRequest constructions (paymentauth-basic, paymentauth-tetris, paymentauth-x402, payments, reth-snapshots)

Documentation

Added VERSIONING.md documenting the full strategy with prior art references

Design Rationale

Core unversioned: Matches every deployed HTTP auth scheme (Basic, Bearer, Digest). Core is thin enough that breaking changes are unlikely.
Methods version by identifier: Fundamentally different payment networks warrant distinct identifiers. IANA registry handles independent evolution.
Intents version in request blob: Intent schemas evolve incrementally; a version field inside the opaque request JSON avoids registry churn while enabling schema migration.

See VERSIONING.md for full details and IETF prior art analysis.

Adds comprehensive documentation for building Tempo AI payment apps: AGENTS.md enhancements: - Tempo blockchain integration (tempo.ts, TIP-20 tokens) - Fee sponsorship with access keys - IDXS for on-chain activity queries - Onramp integration (Coinbase) - Subscription with cron jobs - UI development (Tailwind CSS v4, CVA) - Local development (OrbStack, Tailscale) - New app creation guide SKILLS.md additions: - #9 Tempo Blockchain SDK (tempo.ts) - #10 IDXS Activity Queries - #11 Fee Sponsorship - #12 Onramp Integration - #13 Passkey Authentication - #14 Subscription Management - New app checklist New files: - apps/_template/ - Copy-paste starter app - scripts/create-app.ts - Scaffold new apps with `pnpm create-app` Based on team discussion for enabling one-shot full-stack app generation.

feat: enhance AGENTS.md and SKILLS.md with full Tempo stack

- Add biome.json for linting/formatting (tabs, single quotes, recommended rules) - Update package.json: - Bump pnpm to 10.28.0 - Add check and check:biome scripts - Add @biomejs/biome devDependency

chore: add Biome configuration

add basic github actions workflows

bootstrap pnpm lock

remove starter apps

Migrated all apps and packages from https://github.com/tempoxyz/ietf-paymentauth-demos ## Packages - `@tempo/paymentauth-protocol` - Core types and encoding for IETF 402 payment auth - `@tempo/paymentauth-hono` - Hono middleware for payment gating - `@tempo/paymentauth-x402-compat` - x402 protocol translation layer ## Demo Apps - `@tempo/paymentauth-basic` - Basic Tempo payment server - `@tempo/paymentauth-x402` - x402-compatible payment server - `@tempo/paymentauth-base` - Base Sepolia payment server (using paymentauth-hono) - `@tempo/paymentauth-tetris` - Pay-per-move Tetris game with WebAuthn support All packages and apps follow ai-payments conventions: - Turbo for build orchestration - TypeScript strict mode with workers types - Cloudflare Workers deployment - Vitest for testing

feat: merge paymentauth demos from ietf-paymentauth-demos

enable preview deploys

- Copy client with demo.ts, demo.sh, and paymentauth.sh scripts - Update imports to use @tempo/paymentauth-protocol - Add verification instructions to AGENTS.md Amp-Thread-ID: https://ampcode.com/threads/T-019bc4b2-cabc-74ed-b382-9e02fb2e3c9e Co-authored-by: Amp <amp@ampcode.com>

Add paymentauth-client package

- Paid reth mainnet snapshot downloads via IETF Payments Auth - Per-gigabyte pricing using pathUSD token - Streams snapshots from Cloudflare R2 bucket - Endpoints: /health, /snapshots (list), /snapshots/:filename (paid download) - Local protocol module for Payment Auth types and encoding

- Add pnpm workspace configuration with version catalog - Add biome.json for linting and formatting - Add base tsconfig.json - Add @ai-payments/protocol package (IETF Payment Auth types and utilities) - Add @ai-payments/hono package (Hono middleware for 402 flows) - Add comprehensive AGENTS.md for AI development guidance - Add SKILLS.md with pointers to relevant development skills - Add apps/ directory for Cloudflare Worker apps

Committed-By-Agent: claude

feat: Cloudflare Apps Monorepo + Paid Reth Snapshots API

…consistently in CI (#12)

)

Co-authored-by: Amp <amp@ampcode.com>

- Deploy verified contract at 0x9d136eEa063eDE5418A6BC7bEafF009bBb6CFa70 - Refactor streaming demo to use @tempo/stream-channels StreamChannelClient for on-chain operations (approve, open, getChannel, computeChannelId) - Move stream intent code from src/lib/ to src/stream/ with cleaner module structure (Types, Voucher, Intents, Chain, Receipt, Storage, Method) - Simplify demo.ts by removing manual encodeFunctionData/ABI calls - Update escrow contract address in wrangler.jsonc and demo.ts - Fix explorer URL to https://explore.testnet.tempo.xyz

- Add version field to TempoMethodDetails (method-level versioning) - Add version field to all intent request types (ChargeRequest, AuthorizeRequest, SubscriptionRequest, StreamRequest) - Set version: 1 in all app ChargeRequest constructions - Add VERSIONING.md documenting the three-layer versioning strategy: core (stable, no wire version), methods (version by identifier), intents (version in request schema)

github-actions · 2026-02-06T17:12:31Z

Cloudflare Deployments

App	Status	Preview

No deployments found.

Move versioning content from standalone VERSIONING.md into the Versioning section of STYLE.md where it belongs alongside the existing design principles and layered architecture docs.

Zygimantass and others added 30 commits January 15, 2026 23:40

first commit

ebb9d61

init

5dd2aac

Merge pull request #2 from tempoxyz/amp/enhance-agents-skills

d2a5036

feat: enhance AGENTS.md and SKILLS.md with full Tempo stack

chore: add Biome configuration

8ec9919

- Add biome.json for linting/formatting (tabs, single quotes, recommended rules) - Update package.json: - Bump pnpm to 10.28.0 - Add check and check:biome scripts - Add @biomejs/biome devDependency

Merge pull request #3 from tempoxyz/chore/add-ci-cd-and-biome

d7685e4

chore: add Biome configuration

add basic github actions workflows

cdfb29f

Merge branch 'main' into brendanryan-bootstrap

429ea28

Merge pull request #4 from tempoxyz/brendanryan-bootstrap

64c62fa

add basic github actions workflows

bootstrap pnpm install

0808630

Merge pull request #5 from tempoxyz/brendanryan-pnpm

dbdcd7a

bootstrap pnpm lock

remove starter apps

1b16fa7

tighten up ci

e439047

add workflow

0d15478

tests pass

79a6e7d

Merge pull request #7 from tempoxyz/brendanryan-rm-apps

fa619a4

remove starter apps

Merge pull request #8 from tempoxyz/feat/merge-paymentauth-demos

3bbbf67

feat: merge paymentauth demos from ietf-paymentauth-demos

enable preview deploys

d85bdd8

Merge pull request #9 from tempoxyz/brendanryan-deploy

7863400

enable preview deploys

Merge pull request #10 from tempoxyz/add-paymentauth-client

aaa9c25

Add paymentauth-client package

fix: use workspace protocol package in reth-snapshots app

bcae673

fix: add catalog to pnpm-workspace.yaml for reth-snapshots dependencies

a236b00

Committed-By-Agent: claude

chore: update pnpm-lock.yaml and format create-app script

3fcfaf3

Committed-By-Agent: claude

Merge pull request #1 from tempoxyz/feat/monorepo-setup

ab48fb3

feat: Cloudflare Apps Monorepo + Paid Reth Snapshots API

registers all services in auto deploy setup and ensures this happens …

97d02c6

…consistently in CI (#12)

flesh out tetris game to use access keys (#13)

4cf4e99

brendanjryan and others added 25 commits January 28, 2026 14:35

update pget site (#130)

338369c

fixes auto deploy for pget (#131)

16cf07b

fix: tempo tx validation should look at all calls (#132)

abfd03d

fix: block service response if tx reverts onchain (#133)

dca5f5a

fix: return tx hash on reverts (#134)

3e145cd

fix: dont require api key for rpc (#135)

6b2207c

fix: tempo rpc url path in directory (#136)

c5cc53e

chore: rename R2 bucket from purl-binaries to pget-binaries (#137)

4b177d9

pget: update site copy to be more wget-like with expanded examples (#138

72da040

)

use commit mono (#139)

e41fe2b

change description text on pget site (#140)

049d73f

Add Fal for image/video gen (#141)

0e49733

Add Twilio SMS service (#142)

1f697ea

Add ElevenLabs service (#143)

8715e8f

Add missing env var entries (#144)

8e352a7

Re-write Twilio URLs to omit account id (#145)

3411d0c

feat(payments): add basic auth support for RPC endpoints (#147)

5687035

Co-authored-by: Amp <amp@ampcode.com>

bump maxFeePerGas from 10 to 20 gwei (#149)

8df65ab

Co-authored-by: Amp <amp@ampcode.com>

feat(pget): add llms.txt and enable SSR (#150)

a4c4aba

Co-authored-by: Amp <amp@ampcode.com>

fix: use request URL as realm instead of payments/<service> (#151)

3cf5028

Co-authored-by: Amp <amp@ampcode.com>

fix: use host as realm instead of payments/<service> (#153)

376435f

Co-authored-by: Amp <amp@ampcode.com>

[wip] super simple streaming demo

9ee4b40

add back durable storage

c291ece

docs: move versioning strategy into STYLE.md

cf81b0e

Move versioning content from standalone VERSIONING.md into the Versioning section of STYLE.md where it belongs alongside the existing design principles and layered architecture docs.

brendanjryan changed the base branch from brendanryan-simple-stream to main February 7, 2026 15:40

brendanjryan closed this Feb 7, 2026

brendanjryan mentioned this pull request Feb 7, 2026

feat: add versioning strategy for payment methods and intents #115

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add versioning strategy for payment methods and intents#113

feat: add versioning strategy for payment methods and intents#113
brendanjryan wants to merge 149 commits into
mainfrom
feat/versioning-strategy

brendanjryan commented Feb 6, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Feb 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Uh oh!

Conversation

brendanjryan commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Three-Layer Versioning

Changes

Types

Apps

Documentation

Design Rationale

Uh oh!

github-actions Bot commented Feb 6, 2026

Cloudflare Deployments

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

brendanjryan commented Feb 6, 2026 •

edited

Loading