* 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