* 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>
411 lines
8.9 KiB
Go
411 lines
8.9 KiB
Go
package x402
|
|
|
|
import (
|
|
"testing"
|
|
)
|
|
|
|
func TestValidatePaymentPayload(t *testing.T) {
|
|
tests := []struct {
|
|
name string
|
|
payload PaymentPayload
|
|
wantErr bool
|
|
errMsg string
|
|
}{
|
|
{
|
|
name: "valid v2 payload",
|
|
payload: PaymentPayload{
|
|
X402Version: 2,
|
|
Accepted: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
},
|
|
Payload: map[string]interface{}{"sig": "test"},
|
|
},
|
|
wantErr: false,
|
|
},
|
|
{
|
|
name: "valid v1 payload",
|
|
payload: PaymentPayload{
|
|
X402Version: 1,
|
|
Accepted: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
},
|
|
Payload: map[string]interface{}{"sig": "test"},
|
|
},
|
|
wantErr: false,
|
|
},
|
|
{
|
|
name: "invalid version",
|
|
payload: PaymentPayload{
|
|
X402Version: 3,
|
|
Accepted: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
},
|
|
Payload: map[string]interface{}{"sig": "test"},
|
|
},
|
|
wantErr: true,
|
|
errMsg: "unsupported x402 version",
|
|
},
|
|
{
|
|
name: "missing scheme",
|
|
payload: PaymentPayload{
|
|
X402Version: 2,
|
|
Accepted: PaymentRequirements{
|
|
Network: "eip155:1",
|
|
},
|
|
Payload: map[string]interface{}{"sig": "test"},
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment scheme is required",
|
|
},
|
|
{
|
|
name: "missing network",
|
|
payload: PaymentPayload{
|
|
X402Version: 2,
|
|
Accepted: PaymentRequirements{
|
|
Scheme: "exact",
|
|
},
|
|
Payload: map[string]interface{}{"sig": "test"},
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment network is required",
|
|
},
|
|
{
|
|
name: "missing payload",
|
|
payload: PaymentPayload{
|
|
X402Version: 2,
|
|
Accepted: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
},
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment payload is required",
|
|
},
|
|
}
|
|
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
err := ValidatePaymentPayload(tt.payload)
|
|
if (err != nil) != tt.wantErr {
|
|
t.Errorf("ValidatePaymentPayload() error = %v, wantErr %v", err, tt.wantErr)
|
|
}
|
|
if err != nil && tt.errMsg != "" {
|
|
if err.Error() != tt.errMsg && !contains(err.Error(), tt.errMsg) {
|
|
t.Errorf("ValidatePaymentPayload() error message = %v, want %v", err.Error(), tt.errMsg)
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
func TestValidatePaymentRequirements(t *testing.T) {
|
|
tests := []struct {
|
|
name string
|
|
req PaymentRequirements
|
|
wantErr bool
|
|
errMsg string
|
|
}{
|
|
{
|
|
name: "valid requirements",
|
|
req: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
Asset: "USDC",
|
|
Amount: "1000000",
|
|
PayTo: "0xrecipient",
|
|
},
|
|
wantErr: false,
|
|
},
|
|
{
|
|
name: "missing scheme",
|
|
req: PaymentRequirements{
|
|
Network: "eip155:1",
|
|
Asset: "USDC",
|
|
Amount: "1000000",
|
|
PayTo: "0xrecipient",
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment scheme is required",
|
|
},
|
|
{
|
|
name: "missing network",
|
|
req: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Asset: "USDC",
|
|
Amount: "1000000",
|
|
PayTo: "0xrecipient",
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment network is required",
|
|
},
|
|
{
|
|
name: "missing asset",
|
|
req: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
Amount: "1000000",
|
|
PayTo: "0xrecipient",
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment asset is required",
|
|
},
|
|
{
|
|
name: "missing amount",
|
|
req: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
Asset: "USDC",
|
|
PayTo: "0xrecipient",
|
|
// Amount is optional for v1 compatibility (v1 uses maxAmountRequired)
|
|
},
|
|
wantErr: false, // Changed: Amount validation removed for v1 compatibility
|
|
},
|
|
{
|
|
name: "missing payTo",
|
|
req: PaymentRequirements{
|
|
Scheme: "exact",
|
|
Network: "eip155:1",
|
|
Asset: "USDC",
|
|
Amount: "1000000",
|
|
},
|
|
wantErr: true,
|
|
errMsg: "payment recipient is required",
|
|
},
|
|
}
|
|
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
err := ValidatePaymentRequirements(tt.req)
|
|
if (err != nil) != tt.wantErr {
|
|
t.Errorf("ValidatePaymentRequirements() error = %v, wantErr %v", err, tt.wantErr)
|
|
}
|
|
if err != nil && tt.errMsg != "" {
|
|
if err.Error() != tt.errMsg && !contains(err.Error(), tt.errMsg) {
|
|
t.Errorf("ValidatePaymentRequirements() error message = %v, want %v", err.Error(), tt.errMsg)
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
func TestFindByNetworkAndScheme(t *testing.T) {
|
|
// Create test map
|
|
networkMap := map[Network]map[string]string{
|
|
"eip155:1": {
|
|
"exact": "mainnet-exact",
|
|
"transfer": "mainnet-transfer",
|
|
},
|
|
"eip155:8453": {
|
|
"exact": "base-exact",
|
|
},
|
|
"eip155:*": {
|
|
"wildcard": "any-eip155",
|
|
},
|
|
}
|
|
|
|
tests := []struct {
|
|
name string
|
|
scheme string
|
|
network Network
|
|
expected string
|
|
}{
|
|
{
|
|
name: "exact match mainnet exact",
|
|
scheme: "exact",
|
|
network: "eip155:1",
|
|
expected: "mainnet-exact",
|
|
},
|
|
{
|
|
name: "exact match mainnet transfer",
|
|
scheme: "transfer",
|
|
network: "eip155:1",
|
|
expected: "mainnet-transfer",
|
|
},
|
|
{
|
|
name: "exact match base exact",
|
|
scheme: "exact",
|
|
network: "eip155:8453",
|
|
expected: "base-exact",
|
|
},
|
|
{
|
|
name: "wildcard match for unregistered network",
|
|
scheme: "wildcard",
|
|
network: "eip155:137", // Polygon, not explicitly registered
|
|
expected: "any-eip155",
|
|
},
|
|
{
|
|
name: "no match",
|
|
scheme: "nonexistent",
|
|
network: "eip155:1",
|
|
expected: "",
|
|
},
|
|
{
|
|
name: "no match for different namespace",
|
|
scheme: "exact",
|
|
network: "solana:mainnet",
|
|
expected: "",
|
|
},
|
|
}
|
|
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
result := findByNetworkAndScheme(networkMap, tt.scheme, tt.network)
|
|
if result != tt.expected {
|
|
t.Errorf("findByNetworkAndScheme() = %v, want %v", result, tt.expected)
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
func TestFindSchemesByNetwork(t *testing.T) {
|
|
// Create test map
|
|
networkMap := map[Network]map[string]string{
|
|
"eip155:1": {
|
|
"exact": "mainnet-exact",
|
|
"transfer": "mainnet-transfer",
|
|
},
|
|
"eip155:8453": {
|
|
"exact": "base-exact",
|
|
},
|
|
"eip155:*": {
|
|
"wildcard": "any-eip155",
|
|
},
|
|
}
|
|
|
|
tests := []struct {
|
|
name string
|
|
network Network
|
|
expected map[string]string
|
|
isNil bool
|
|
}{
|
|
{
|
|
name: "exact match mainnet",
|
|
network: "eip155:1",
|
|
expected: map[string]string{
|
|
"exact": "mainnet-exact",
|
|
"transfer": "mainnet-transfer",
|
|
},
|
|
},
|
|
{
|
|
name: "exact match base",
|
|
network: "eip155:8453",
|
|
expected: map[string]string{
|
|
"exact": "base-exact",
|
|
},
|
|
},
|
|
{
|
|
name: "wildcard match",
|
|
network: "eip155:137", // Polygon, matches wildcard
|
|
expected: map[string]string{
|
|
"wildcard": "any-eip155",
|
|
},
|
|
},
|
|
{
|
|
name: "no match",
|
|
network: "solana:mainnet",
|
|
isNil: true,
|
|
},
|
|
}
|
|
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
result := findSchemesByNetwork(networkMap, tt.network)
|
|
if tt.isNil {
|
|
if result != nil {
|
|
t.Errorf("findSchemesByNetwork() = %v, want nil", result)
|
|
}
|
|
} else {
|
|
if len(result) != len(tt.expected) {
|
|
t.Errorf("findSchemesByNetwork() length = %d, want %d", len(result), len(tt.expected))
|
|
}
|
|
for k, v := range tt.expected {
|
|
if result[k] != v {
|
|
t.Errorf("findSchemesByNetwork()[%s] = %v, want %v", k, result[k], v)
|
|
}
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
func TestNetworkPatternMatching(t *testing.T) {
|
|
tests := []struct {
|
|
name string
|
|
network1 Network
|
|
network2 Network
|
|
matches bool
|
|
}{
|
|
{
|
|
name: "exact match",
|
|
network1: "eip155:1",
|
|
network2: "eip155:1",
|
|
matches: true,
|
|
},
|
|
{
|
|
name: "wildcard matches specific",
|
|
network1: "eip155:*",
|
|
network2: "eip155:8453",
|
|
matches: true,
|
|
},
|
|
{
|
|
name: "specific matches wildcard",
|
|
network1: "eip155:8453",
|
|
network2: "eip155:*",
|
|
matches: true,
|
|
},
|
|
{
|
|
name: "different namespaces",
|
|
network1: "eip155:1",
|
|
network2: "solana:mainnet",
|
|
matches: false,
|
|
},
|
|
{
|
|
name: "different chains same namespace",
|
|
network1: "eip155:1",
|
|
network2: "eip155:8453",
|
|
matches: false,
|
|
},
|
|
{
|
|
name: "wildcard different namespace",
|
|
network1: "eip155:*",
|
|
network2: "solana:mainnet",
|
|
matches: false,
|
|
},
|
|
}
|
|
|
|
for _, tt := range tests {
|
|
t.Run(tt.name, func(t *testing.T) {
|
|
result := tt.network1.Match(tt.network2)
|
|
if result != tt.matches {
|
|
t.Errorf("Network.Match() = %v, want %v", result, tt.matches)
|
|
}
|
|
// Test symmetry for non-wildcard cases
|
|
if !contains(string(tt.network1), "*") && !contains(string(tt.network2), "*") {
|
|
reverseResult := tt.network2.Match(tt.network1)
|
|
if reverseResult != tt.matches {
|
|
t.Errorf("Network.Match() not symmetric: forward = %v, reverse = %v", result, reverseResult)
|
|
}
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
// Helper function
|
|
func contains(s, substr string) bool {
|
|
return len(s) >= len(substr) && (s == substr || len(substr) > 0 && len(s) > len(substr) &&
|
|
(s[:len(substr)] == substr || s[len(s)-len(substr):] == substr ||
|
|
(len(s) > len(substr) && findSubstring(s, substr))))
|
|
}
|
|
|
|
func findSubstring(s, substr string) bool {
|
|
for i := 1; i < len(s)-len(substr); i++ {
|
|
if s[i:i+len(substr)] == substr {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|