* 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>
91 lines
2.6 KiB
Go
91 lines
2.6 KiB
Go
package x402
|
|
|
|
import "fmt"
|
|
|
|
// ValidatePaymentPayload performs basic validation on a payment payload
|
|
// Version-aware: handles both v1 and v2 payload structures
|
|
func ValidatePaymentPayload(p PaymentPayload) error {
|
|
if p.X402Version < 1 || p.X402Version > 2 {
|
|
return fmt.Errorf("unsupported x402 version: %d", p.X402Version)
|
|
}
|
|
|
|
// V2 validation: check accepted field
|
|
if p.X402Version == 2 {
|
|
if p.Accepted.Scheme == "" {
|
|
return fmt.Errorf("payment scheme is required")
|
|
}
|
|
if p.Accepted.Network == "" {
|
|
return fmt.Errorf("payment network is required")
|
|
}
|
|
}
|
|
|
|
// Both v1 and v2 must have payload
|
|
if p.Payload == nil {
|
|
return fmt.Errorf("payment payload is required")
|
|
}
|
|
|
|
// Note: v1 validation is minimal here - scheme/network are validated
|
|
// by the mechanism-specific facilitator based on the payment requirements
|
|
return nil
|
|
}
|
|
|
|
// ValidatePaymentRequirements performs basic validation on payment requirements
|
|
func ValidatePaymentRequirements(r PaymentRequirements) error {
|
|
if r.Scheme == "" {
|
|
return fmt.Errorf("payment scheme is required")
|
|
}
|
|
if r.Network == "" {
|
|
return fmt.Errorf("payment network is required")
|
|
}
|
|
if r.Asset == "" {
|
|
return fmt.Errorf("payment asset is required")
|
|
}
|
|
// Note: Amount check is skipped for v1 compatibility (v1 uses maxAmountRequired)
|
|
// Version-specific facilitators will validate amount fields as needed
|
|
if r.PayTo == "" {
|
|
return fmt.Errorf("payment recipient is required")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// findByNetworkAndScheme finds a scheme implementation for a given network/scheme combination
|
|
// This supports pattern matching for networks (e.g., "eip155:*")
|
|
func findByNetworkAndScheme[T any](networkMap map[Network]map[string]T, scheme string, network Network) T {
|
|
var zero T
|
|
|
|
// Try exact match first
|
|
if schemeMap, exists := networkMap[network]; exists {
|
|
if impl, exists := schemeMap[scheme]; exists {
|
|
return impl
|
|
}
|
|
}
|
|
|
|
// Try pattern matching
|
|
for registeredNetwork, schemeMap := range networkMap {
|
|
if network.Match(registeredNetwork) || registeredNetwork.Match(network) {
|
|
if impl, exists := schemeMap[scheme]; exists {
|
|
return impl
|
|
}
|
|
}
|
|
}
|
|
|
|
return zero
|
|
}
|
|
|
|
// findSchemesByNetwork finds all schemes for a given network
|
|
func findSchemesByNetwork[T any](networkMap map[Network]map[string]T, network Network) map[string]T {
|
|
// Try exact match first
|
|
if schemeMap, exists := networkMap[network]; exists {
|
|
return schemeMap
|
|
}
|
|
|
|
// Try pattern matching
|
|
for registeredNetwork, schemeMap := range networkMap {
|
|
if network.Match(registeredNetwork) || registeredNetwork.Match(network) {
|
|
return schemeMap
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|