* feat: add TVM exact-payment mechanism to Python SDK
- add TVM exact client, server, and facilitator implementations
- add TVM signers, codecs, provider, and settlement helpers
- add unit and integration coverage for TON testnet/mainnet flows
- add Python examples and e2e wiring for TVM
* Enable TVM exact flows in Python e2e and tighten facilitator validation
Add TVM support to the Python e2e clients and servers, switch TVM usage to direct `ExactTvm*Scheme` registration after removing the old register helpers, and refresh docs/examples for testnet setup.
Also reject exact TVM settlements with excessively large attached TON amounts and cover the new validation with tests.
* fix: clarify minimum balance of the facilitator
* refactor(tvm): release settlement cache entry on confirmed settlement
On-chain seqno advances after a successful relay, so any retry of the same settlement BOC will fail at the W5 contract's seqno check regardless of the dedup reservation. Drop the entry as soon as the confirmation worker records success, so the invariant becomes "every is_duplicate=False is paired with a release" and TTL pruning is left as a crash safety-net only.
* feat(tvm): add TonAPI provider support
* feat(tvm): update e2e tests to make them compatible with new providers
* fix(tvm): update timeouts
* fix(tvm): increase http client timeout
* fix(tvm): align unit tests
* revert(e2e): remove .env-local config load
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* feat(python): add payment-identifier extension types and constants
- Add PaymentIdentifierInfo and PaymentIdentifierExtension Pydantic models
- Add constants: PAYMENT_IDENTIFIER, PAYMENT_ID_MIN_LENGTH, PAYMENT_ID_MAX_LENGTH, PAYMENT_ID_PATTERN
- Define PaymentIdentifierSchema type alias
* feat(python): add payment-identifier utility functions
- Add generate_payment_id() to create UUID v4-based payment IDs
- Add is_valid_payment_id() to validate ID format (16-128 chars, alphanumeric + hyphens/underscores)
* feat(python): add payment-identifier JSON Schema definition
- Add payment_identifier_schema compliant with JSON Schema Draft 2020-12
- Schema validates required boolean and optional id string field
* feat(python): add payment-identifier validation and extraction functions
- Add ValidationResult dataclass for validation results
- Add is_payment_identifier_extension() type guard
- Add validate_payment_identifier() for full extension validation
- Add extract_payment_identifier() to extract ID from PaymentPayload
- Add extract_and_validate_payment_identifier() combined function
- Add has_payment_identifier() to check extension presence
- Add is_payment_identifier_required() to check requirement flag
- Add validate_payment_identifier_requirement() for requirement compliance
* feat(python): add payment-identifier client utilities
- Add append_payment_identifier_to_extensions() to append payment ID to extensions dict
- Only appends if server declared the extension
- Generates new ID if not provided
* feat(python): add payment-identifier resource server utilities
- Add declare_payment_identifier_extension() to create extension declaration
- Add PaymentIdentifierResourceServerExtension class implementing ResourceServerExtension protocol
- Add payment_identifier_resource_server_extension singleton instance
* feat(python): add payment-identifier extension main module
- Export all public APIs from payment-identifier extension
- Add comprehensive usage documentation with examples for servers, clients, and idempotency
* feat(python): export payment-identifier extension from extensions module
- Add payment-identifier imports and exports to main extensions __init__.py
- Export all constants, types, functions, and classes for public API
* fix(python): resolve ValidationResult type mismatch in extensions module
- Export payment_identifier.ValidationResult as ValidationResult (matches payment_identifier function return types)
- Export bazaar.ValidationResult as BazaarValidationResult for explicit bazaar usage
- Both ValidationResult classes are structurally equivalent (same dataclass fields)
- Fixes type mismatch where payment_identifier functions returned payment_identifier.ValidationResult but ValidationResult imported from x402.extensions was bazaar.ValidationResult
* refactor(python): rename payment_identifier ValidationResult to PaymentIdentifierValidationResult
- Rename ValidationResult class to PaymentIdentifierValidationResult in payment_identifier/validation.py
- Update all function return types and usages throughout validation.py
- Update exports in payment_identifier/__init__.py
- Update imports/exports in extensions/__init__.py
- Keep ValidationResult from bazaar as default export for backward compatibility
- Export PaymentIdentifierValidationResult separately for explicit payment_identifier usage
- Makes naming consistent with BazaarValidationResult pattern
* test(python): add comprehensive test suite for payment_identifier extension
- Add test_types.py: Test constants and Pydantic models
- Add test_utils.py: Test ID generation and validation functions
- Add test_validation.py: Test all validation and extraction functions
- Add test_client.py: Test client-side utilities
- Add test_server.py: Test server-side utilities
- Tests cover all major functionality including edge cases and error handling
- Follows same structure as bazaar extension tests
* fix(python): fix payment_identifier test helper and assertions
- Fix create_extension_with_id helper to handle invalid IDs for testing
- Update test assertion to check for 'identifier' in error message
- All 67 tests now passing
* fix(python): add ValidationResult alias for backward compatibility
- Add ValidationResult = BazaarValidationResult alias after bazaar import
- Fixes AttributeError when importing ValidationResult from x402.extensions
- ValidationResult was imported as BazaarValidationResult but exported in __all__
- Now both ValidationResult and BazaarValidationResult are available
* test(python): add test to verify __all__ exports are importable
- Add test_exports.py to verify all items in __all__ can be imported
- Tests that ValidationResult alias works correctly
- Tests that 'import *' works as expected
- This would have caught the ValidationResult AttributeError bug
* fix(python): make jsonschema import lazy in payment_identifier validation
- Remove module-level jsonschema import that raised ImportError
- Import jsonschema lazily only when schema validation is needed
- Return validation error instead of raising ImportError at module level
- Allows payment_identifier extension to be imported without jsonschema
- Users can still use non-validation functions without optional dependency
* fix(python): fix linting errors
- Remove unused variable in test_types.py
- Fix import sorting in extensions/__init__.py
- Add noqa comment for intentional E402 (import after alias)
* Lint
* docs(python): add payment-identifier extension examples
Add client and server examples demonstrating how to use the
payment-identifier extension for idempotent payment processing.
Client example shows:
- Generating payment IDs with generate_payment_id()
- Using on_before_payment_creation hook to inject the ID
- Making duplicate requests to demonstrate cache behavior
Server example shows:
- Declaring extension support with declare_payment_identifier_extension()
- Extracting payment IDs with extract_payment_identifier()
- Caching responses after settlement for idempotency
* Lint
* Format
* Changelog
* chore: move packages, examples and e2e clients/servers/facilitators to legacy subfolders
* feat: added @x402/core to /typescript/packages
* feat: added @x402/evm to /typescript/packages/mechanism
* feat: added @x402/svm to /typescript/packages/mechanism
* feat: added @x402/extensions to /typescript/packages
* feat: added @x402/fetch to /typescript/packages/http
* feat: added @x402/axios to /typescript/packages/http
* feat: added @x402/paywall to /typescript/packages/http
* feat: added @x402/express to /typescript/packages/http
* feat: added @x402/hono to /typescript/packages/http
* feat: added @x402/next to /typescript/packages/http
* chore: update /typescript pnpm packaging
* feat: added core files to /go
* feat: added evm mechanism to /go
* feat: added svm mechanism to /go
* feat: added extensions to /go
* feat: added gin to /go/http
* feat: added tests to /go
* feat: rewrote e2e test suite system
* feat: added axios client to e2e suite
* feat: added fetch client to e2e suite
* feat: added go http client to e2e suite
* feat: added express server to e2e suite
* feat: added hono server to e2e suite
* feat: added next server to e2e suite
* feat: added gin server to e2e suite
* feat: added typescript facilitator to e2e suite
* feat: added go facilitator to e2e suite
* feat: added fetch example to examples/typescript/clients
* feat: added axios example to examples/typescript/clients
* feat: added advanced example to examples/typescript/clients
* feat: added custom example to examples/typescript/clients
* feat: added express example to examples/typescript/servers
* feat: added hono example to examples/typescript/servers
* feat: added advanced example to examples/typescript/servers
* feat: added custom example to examples/typescript/servers
* feat: added facilitator example to examples/typescript
* chore: update /examples/typescript pnpm packaging
* feat: added http client to examples/go/clients
* feat: added advanced client to examples/go/clients
* feat: added custom client to examples/go/clients
* feat: added gin server to examples/go/servers
* feat: added advanced server to examples/go/servers
* feat: added custom server to examples/go/servers
* feat: added facilitator to examples/go
* chore: updated github workflows
* fix: typescript examples fotmat/lint
* v2: next example (#706)
* fix legacy example builds
* add next example
* fix format
* upgrade to next 16
* fix legacy build
* fix e2e tests
* V2: next api wrapper (#707)
* add next route wrapper
* add protected api to example page
* add unit tests
* fix missing settle failure check
* added e2e tests for withX402
* add SettleResponse to ProcessSettleResultResponse
* add requirements to payment-header
* feat: add v2 support to x402.org facilitator
* feat: dynamically load bazaar extension in Next only when used
* fix: x402Facilitator in typescript calling onAfterVerify instead on onVerifyFailure on failure
* feat: add ERC1271 and ERC6492 support to Typescript facilitator
* feat: update typescript facilitator example & e2e test for ERC1271/ERC6492 support
* feat: add ERC1271 and ERC6492 support to Go facilitators
* feat: update go facilitator example & e2e test for ERC1271/ERC6492 support
* v2: express fixes + unit tests (#712)
* add express fixes from v1
* add units test for express/hono
* added fetch/axios unit tests
* v2: Clean up paywall (#710)
* Remove cdpClientKey and sessionTokenEndpoint from PaywallConfig
Remove Onramp functionality from EvmPaywall
Remove Coinbase fields from paywall template generation
* Migrate site to @x402/next with v2 protocol support
* Clean up tests
* remove CDP onramp from core paywall
* Update templates and build process
* Format
* Lockfile
* mock templates for CI
* Format
* Generate new templates
* Format
* v2: facilitator sync fix (#716)
* update next/react versions
* update site to next 16, tailwind 4 and fix env vars
* fix initializeOnStart pattern
* security: bump quic-go dependency for security fix GHSA-47m2-4cr7-mhcw
* v2:fix ts advanced/custom examples (#717)
* fix ts examples
* add clients/advanced/preferred-network example
* feat: improved e2e cli for external facilitator testing
* feat: updated evm & svm signer interfaces in go
* feat: updated evm & svm signer interfaces in typescript
* feat: reverted SupportedKind's kinds structure in go
* feat: reverted SupportedKind's kinds structure in typescript
* feat: refactor facilitator SVM signer interface in typescript
* go example fixes (#719)
* feat: cleanup go bazaar extension
* V2: docs update (#729)
* ts example docs
* improve ts package docs
* feat: dynamic bazaar import for all server middleware
* feat: allow dynamic response building for 402 response in typescript
* feat: allow dynamic response building for 402 response in go
* feat: added withBazaar HTTPFacilitatorClient wrapper
* feat: added linting to go
* fix: lint go
* improve go example docs (#733)
* feat: Solana PR review feedback in typescript
* feat: Solana PR review feedback in go
* fix: locks & paywall gen after rebase off main
* fix: format
* docs: improve @x402/extensions README with comprehensive documentation (#731)
* First draft of contributor docs (#738)
Correct ts contributing
Clean up contribution guidelines
* feat: updated specs for v2
* fix: merge with main, fixed lock
* v2: go settlement failure and initOnStart fixes (#720)
* go settlement failure and initOnStart fixes
* update go unit tests
* update readmes
* feat: review & improve examples & READMEs
* v2: add multiple payment options for go (#743)
* add multiple payment options for go
* fix SyncFacilitatorOnStart
* v2: add hooks for advanced go example (#745)
* add hooks for advanced go example
* fix legacy ts deps
* feat: added server initialization validation
* feat: added @x402 package workflows
* v2: add miniapp and mcp examples (#746)
* add miniapp example
* fix format
* add mcp example
* fix format
* v2: add manifest to miniapp example (#751)
* add manifest to miniapp
* fix format
* feat: x402 website redesign (#750)
* port new website to public repo
* chore: update pnpm-lock.yaml with motion dependency
* feat: add x402 V2 launch blog post and update hero code snippet
- Add /writing/x402-v2-launch blog post page
- Add blog images (blog_intro.png, blog_x402_layers.png, homepage_build5.png)
- Enable Writing nav link in NavBar and Footer
- Update hero code snippet to show V2 SDK usage
- Fix CodeSnippet to support multi-line code
* feat: edit nav for mobile
* Revert "feat: edit nav for mobile"
This reverts commit 475999a2a84f1fab875cd0fe2bb74d44dba7e1bd.
* feat: add ecosystem page and minor home page tweaks
* feat: fix typography in ecosystem
* homepage qa fixes
* feat: add ecosystem icons and fix halftone
* cleanup assets
* fix: minor bug on faq
* feat: add hamburger menu to mobile
* Update README (#755)
* Update readme
* Install instructions and typos
* feat: update site sample code & reduce supported networks
* fix: v1 header in README updated to v2
---------
Co-authored-by: phdargen <p.dargent@cern.ch>
Co-authored-by: A. McDermott <amanda.p.mcdermott@gmail.com>
Co-authored-by: Vedant Anand <136731196+VedantAnand17@users.noreply.github.com>
Co-authored-by: Faris Habib <frs@hbb.dev>
Co-authored-by: erikreppel-cb <erik.reppel@coinbase.com>
* Python pricing example WIP
* Update readme
* Update types, format
* Simplify, don't use http exception shape
* Fix bug where python pkg would set empty fields to nil instead of omitting entirely
* Update readmes, appease linter
* Fix bug where we always try to settle w/ the first payment requirement in the list
* Fix network filtering bug-- settle was always using the first one in the list
* Fix same payment requirements list bug in python example
* Add notes about the client network filter
* Add custom payment selector to the other python client as well
* use json5 for md formatting
* Din't need to recreate util
* Create find_matching_payment_requirements util in python
* Update middlewares, tests
* WIP python paywall
* Add paywall config
* Fix type errors, add flask to project deps
* Pydantic v2.10 doesn't support serialize_by_alias as a config option
* clean up middlewares
* That was unnecessarily complicated
* per pydantic: use instead of on Python < 3.12
* Update paywall to full html file, update path
* Allow users to pass in custom HTML as a string for their paywall
* Validate supported networks
* Don't use type in middleware, but do verify
* Minify paywall html during build process
* Add example that uses new python paywall
* Update env to be mainnet in mainnet example
* Add flask and fastapi fullstack examples
* Correct types
* Update paywall html
* Hide balance on paywall
* Format
* ADd proper logging to fastapi middleware
* Escape strings and guard against prototype pollution
* Automatically copy the paywall file over to the python directory
* Update example lockfiles
* Update python tests
* Update paywall template build steps so python matches TS
* Format and lint
* feat: added facilitator config
* initial
* working towards downgrading pydantic
* fix: first mainnet call
* feat: updated cdp-sdk version in example to prod