x402-payments 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42c2b33d7692d31886f45dde66a23fc750502aa7fe44db52d2c11ebd6d59b069
-  data.tar.gz: '081a125a98b562d5202396f96ceaaf950980f575d112b7c20dc2c3e96e2a235c'
+  metadata.gz: 6dc411d32e832d03fd677129c82073d40d921a878389e034a4ad66a6ac6b8844
+  data.tar.gz: 81fb4038fa051babdf3314dbff9bfd1e7dfa81a41954eb520ce401d8cd22b4ab
 SHA512:
-  metadata.gz: 6d79fed8b305baa86cc5378229bc039715cd70a4cfbce99424e84501d5890301698e80efc82b9d61d55ccd907aea2ec71eeaf1a7056dfe788b8ce8c99fffc683
-  data.tar.gz: 1fdc0978f6443a9d34de4e9596410fddf000461de27a2573a2e3adece08aeaae979d2029a1c569637541179a6902acb39cf0fda6e1c3b6f8af913339bbace821
+  metadata.gz: b6be1da37e65cd6fd6d2bf603a6d0119bc9b6c0888b0365e1364aa66959cf182f5733765a964fd64818ef6c1bc9371d00357d0e00755b7714ba631fde982db47
+  data.tar.gz: 0d4db3d797a2b1ea19f0e330ddb91c4a56ad0494d57636501e05d2286fe19a86d8f69ddacdbf75d7ef37fb7daa47b8db8207878f73a9cb075318cf2b91b33e52

data/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-01-08
+
+### Added
+
+- **Solana support** - Full support for Solana payments on `solana-devnet` and `solana` mainnet
+  - SPL Token `TransferChecked` transactions with partial signing
+  - Custom ATA (Associated Token Account) derivation with correct Ed25519 curve checking
+  - Facilitator fee payer model (uses x402.org facilitator by default)
+  - Inline `fee_payer:` override for different facilitators
+  - Configurable compute budget via `X402_SOLANA_COMPUTE_UNIT_LIMIT` and `X402_SOLANA_COMPUTE_UNIT_PRICE`
+- **Protocol v1 and v2 support** - Both protocol versions fully supported
+  - v1: `X-PAYMENT` header, human-readable network names
+  - v2: `PAYMENT-SIGNATURE` header, CAIP-2 network identifiers
+  - Override protocol version per-request with `version:` parameter
+- **Custom EVM chain registration** - `config.register_chain()` for adding custom EVM networks
+- **Custom token registration** - `config.register_token()` for adding tokens beyond USDC
+- **Networks module** - CAIP-2 network identifier conversion
+
+### Changed
+
+- Default protocol version is v2
+- Solana uses CAIP-2 format: `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` (devnet)
+- Improved error messages for configuration issues
+
+### Fixed
+
+- ATA derivation now uses correct Ed25519 curve equation (fixes `recipient_mismatch` errors)
+
+## [0.1.0] - Initial Release
+
+- Initial release with v1 protocol support
+- EIP-712 signing for USDC payments
+- Support for Base and Avalanche networks

data/README.md

@@ -1,10 +1,12 @@
 # X402::Payments
 
+## Now supporting x402 v2!
+
 ![Coverage](./coverage/coverage.svg)
 
 Ruby gem for generating signed payment HTTP headers and links using the [x402 protocol](https://www.x402.org/).
 
-Supports USDC payments on Base, Avalanche, and other EVM networks with EIP-712 signing.
+Supports USDC and other token payments on Base, Avalanche, Solana, and other EVM networks with EIP-712 signing.
 
 ## Installation
 
@@ -52,31 +54,168 @@ gem install x402-payments
 
 ## Configuration
 
-The gem uses environment variables for configuration with sensible defaults:
-
-```bash
-# Required
-export X402_PAY_TO="0xYourWalletAddress"          # Default address to receive payments
-export X402_PRIVATE_KEY="0xYourPrivateKey"        # Private key for signing
-
-# Optional (with defaults shown)
-export X402_CHAIN="base-sepolia"                  # Network to use
-export X402_MAX_TIMEOUT_SECONDS="600"             # Payment validity timeout
-
-# Optional: Custom RPC URLs (override default RPC endpoints)
-export X402_BASE_RPC_URL="https://your-custom-rpc.com"
-export X402_BASE_SEPOLIA_RPC_URL="https://your-sepolia-rpc.com"
-export X402_AVALANCHE_RPC_URL="https://your-avax-rpc.com"
-export X402_AVALANCHE_FUJI_RPC_URL="https://your-avax-testnet-rpc.com"
-```
+Configure the gem using environment variables. See `examples/.env.example` for a template.
+
+### Environment Variables
+
+| Variable                         | Required     | Description                                      |
+| -------------------------------- | ------------ | ------------------------------------------------ |
+| `X402_PRIVATE_KEY`               | Yes (EVM)    | EVM private key for signing                      |
+| `X402_PAY_TO`                    | Yes (EVM)    | EVM recipient wallet address                     |
+| `X402_SOL_PRIVATE_KEY`           | Yes (Solana) | Solana private key (base58 or JSON array)        |
+| `X402_SOL_PAY_TO`                | Yes (Solana) | Solana recipient wallet address                  |
+| `X402_CHAIN`                     | No           | Network to use (default: `base-sepolia`)         |
+| `X402_CURRENCY`                  | No           | Token symbol (default: `USDC`)                   |
+| `X402_PROTOCOL_VERSION`          | No           | Protocol version 1 or 2 (default: `2`)           |
+| `X402_MAX_TIMEOUT_SECONDS`       | No           | Payment validity timeout (default: `600`)        |
+| `X402_SOLANA_FEE_PAYER`          | No           | Solana fee payer (default: x402.org facilitator) |
+| `X402_SOLANA_COMPUTE_UNIT_LIMIT` | No           | Solana compute unit limit (default: `200000`)    |
+| `X402_SOLANA_COMPUTE_UNIT_PRICE` | No           | Priority fee in micro-lamports (default: `1000`) |
+| `X402_SOLANA_RPC_URL`            | No           | Custom Solana mainnet RPC URL                    |
+| `X402_SOLANA_DEVNET_RPC_URL`     | No           | Custom Solana devnet RPC URL                     |
+| `X402_BASE_RPC_URL`              | No           | Custom Base mainnet RPC URL                      |
+| `X402_BASE_SEPOLIA_RPC_URL`      | No           | Custom Base Sepolia RPC URL                      |
+| `X402_AVALANCHE_RPC_URL`         | No           | Custom Avalanche mainnet RPC URL                 |
+| `X402_AVALANCHE_FUJI_RPC_URL`    | No           | Custom Avalanche Fuji RPC URL                    |
 
 ### Supported Networks
 
+**EVM Networks:**
+
 - `base-sepolia` (testnet) - Default
 - `base` (mainnet)
 - `avalanche-fuji` (testnet)
 - `avalanche` (mainnet)
 
+**Solana Networks:**
+
+- `solana-devnet` (testnet)
+- `solana` (mainnet)
+
+### Custom Chains and Tokens
+
+You can register custom EVM chains and tokens beyond the built-in options.
+
+#### Register a Custom Chain
+
+```ruby
+X402::Payments.configure do |config|
+  config.default_pay_to = ENV['X402_PAY_TO']
+  config.private_key = ENV['X402_PRIVATE_KEY']
+
+  # Register Polygon Amoy testnet
+  config.register_chain(
+    name: "polygon-amoy",
+    chain_id: 80002,
+    standard: "eip155"
+  )
+
+  # Register the token for that chain
+  config.register_token(
+    chain: "polygon-amoy",
+    symbol: "USDC",
+    address: "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
+    decimals: 6,
+    name: "USD Coin",
+    version: "2"
+  )
+
+  # Set the RPC URL for the custom chain
+  config.rpc_urls["polygon-amoy"] = "https://bitter-attentive-pool.matic-amoy.quiknode.pro"
+
+  config.chain = "polygon-amoy"
+  config.currency = "USDC"
+end
+```
+
+You can also set RPC URLs via environment variables using the pattern `X402_<CHAIN>_RPC_URL`:
+
+```bash
+export X402_POLYGON_AMOY_RPC_URL="https://bitter-attentive-pool.matic-amoy.quiknode.pro"
+```
+
+#### Register a Custom Token on a Built-in Chain
+
+```ruby
+X402::Payments.configure do |config|
+  config.default_pay_to = ENV['X402_PAY_TO']
+  config.private_key = ENV['X402_PRIVATE_KEY']
+
+  # Accept WETH on Base instead of USDC
+  config.register_token(
+    chain: "base",
+    symbol: "WETH",
+    address: "0x4200000000000000000000000000000000000006",
+    decimals: 18,
+    name: "Wrapped Ether",
+    version: "1"
+  )
+
+  config.chain = "base"
+  config.currency = "WETH"
+end
+```
+
+#### Token Registration Parameters
+
+| Parameter  | Required | Description                                    |
+| ---------- | -------- | ---------------------------------------------- |
+| `chain`    | Yes      | Chain name (built-in or custom registered)     |
+| `symbol`   | Yes      | Token symbol (e.g., "USDC", "WETH")            |
+| `address`  | Yes      | Token contract address                         |
+| `decimals` | Yes      | Token decimals (e.g., 6 for USDC, 18 for WETH) |
+| `name`     | Yes      | Token name for EIP-712 domain                  |
+| `version`  | No       | EIP-712 version (default: "1")                 |
+
+### Solana Configuration
+
+For Solana payments, ensure you've set the Solana-specific environment variables (see Configuration section above), then set your chain:
+
+```bash
+export X402_CHAIN="solana-devnet"  # or "solana" for mainnet
+```
+
+You can also override the fee payer per-request:
+
+```ruby
+X402::Payments.generate_header(
+  amount: 0.001,
+  resource: "http://example.com/api",
+  network: "solana-devnet",
+  fee_payer: "CustomFacilitatorFeePayer"  # use different facilitator
+)
+```
+
+> **Note**: Both sender and receiver must have a USDC [Associated Token Account (ATA)](https://spl.solana.com/associated-token-account). The sender must have USDC in their wallet (receiving USDC creates the ATA automatically).
+
+## Protocol Versions
+
+x402-payments supports both v1 and v2 of the x402 protocol. **v2 is the default**.
+
+### v2 (Default)
+
+```ruby
+X402::Payments.configure do |config|
+  config.private_key = ENV['X402_PRIVATE_KEY']
+  config.default_pay_to = ENV['X402_PAY_TO']
+  config.protocol_version = 2  # Default, can be omitted
+end
+```
+
+v2 uses CAIP-2 network identifiers (`eip155:84532`) and the `PAYMENT-SIGNATURE` header.
+
+### v1 (Legacy)
+
+```ruby
+X402::Payments.configure do |config|
+  config.private_key = ENV['X402_PRIVATE_KEY']
+  config.default_pay_to = ENV['X402_PAY_TO']
+  config.protocol_version = 1
+end
+```
+
+v1 uses simple network names (`base-sepolia`) and the `X-PAYMENT` header.
+
 ## Usage
 
 ### Basic Usage
@@ -92,8 +231,8 @@ header = X402::Payments.generate_header(
   pay_to: "0xRecipientAddress"                     # Optional: override recipient (defaults to config)
 )
 
-# Use the header in an HTTP request
-# curl -H "X-PAYMENT: #{header}" http://localhost:3000/api/weather
+# Use the header in an HTTP request (v2 uses PAYMENT-SIGNATURE, v1 uses X-PAYMENT)
+# curl -H "PAYMENT-SIGNATURE: #{header}" http://localhost:3000/api/weather
 ```
 
 **Note**: The `pay_to` parameter allows you to specify a different recipient wallet address per payment. If not provided, it uses the configured `default_pay_to`.
@@ -146,27 +285,27 @@ end
 header = X402::Payments.generate_header(
   amount: 0.001,
   resource: "http://localhost:3000/api/data",
+  # version: 1,                              # Override configured protocol version (1 or 2)
   # network: "avalanche",                    # Override default network
-  # private_key: "0xDifferentKey",          # Override default key
-  # pay_to: "0xRecipientWalletAddress",     # Override recipient address
-  # extra: {                                 # Override EIP-712 domain
-  #   name: "Custom Token",
-  #   version: "1"
-  # }
+  # private_key: "0xDifferentKey",           # Override default key
+  # pay_to: "0xRecipientWalletAddress",      # Override recipient address
 )
 
 puts "Payment Header:"
 puts header
 
-HTTParty.get("http://localhost:3000/api/data", headers: { "X-PAYMENT" => header })
+# v2 (default) uses PAYMENT-SIGNATURE, v1 uses X-PAYMENT
+HTTParty.get("http://localhost:3000/api/data", headers: { "PAYMENT-SIGNATURE" => header })
 ```
 
 ## How It Works
 
 1. **Payment Requirements**: The gem creates a payment requirement specifying the amount (in USDC atomic units), network, and resource
-2. **EIP-712 Signing**: Uses EIP-3009 `TransferWithAuthorization` to create a signature that authorizes the payment
-3. **Header Encoding**: Encodes the signed payment data as a base64 string for the `X-PAYMENT` HTTP header
-4. **Server Validation**: The server validates the signature and settles the payment on-chain
+2. **Transaction Signing**:
+   - **EVM**: Uses EIP-3009 `TransferWithAuthorization` to create a signature that authorizes the payment
+   - **Solana**: Creates a partially-signed `TransferChecked` transaction (facilitator adds fee payer signature)
+3. **Header Encoding**: Encodes the signed payment data as a base64 string for the HTTP header (`PAYMENT-SIGNATURE` for v2, `X-PAYMENT` for v1)
+4. **Server Validation**: The server validates the signature/transaction and settles the payment on-chain via the [facilitator](https://x402.org/facilitator)
 
 ## Example Script
 

data/examples/.env.example

@@ -1,14 +1,51 @@
+# ===========================================
 # X402 Payments Configuration
-# Copy this file to .env and fill in your actual values
+# ===========================================
+# Copy this file to .env and fill in your values
 
-# Required: Private key for signing payments
-X402_PRIVATE_KEY=0xYourPrivateKeyHere
+# -------------------------------------------
+# EVM Configuration (Required for EVM chains)
+# -------------------------------------------
+X402_PRIVATE_KEY=0xYourEvmPrivateKey
+X402_PAY_TO=0xEvmPayToAddress
 
-# Required: Default recipient wallet address for payments
-X402_PAY_TO=0xYourRecipientAddressHere
+# -------------------------------------------
+# Solana Configuration (Required for Solana)
+# -------------------------------------------
+X402_SOL_PRIVATE_KEY=YourSolPrivateKey
+X402_SOL_PAY_TO=SolPayToWalletAddress
 
-# Optional: Network/chain to use (default: base-sepolia)
-X402_CHAIN=base-sepolia
+# Optional: Override default x402.org facilitator
+X402_SOLANA_FEE_PAYER=CKPKJWNdJEqa81x7CkZ14BVPiY6y16Sxs7owznqtWYp5
 
-# Optional: Payment timeout in seconds (default: 600)
-X402_MAX_TIMEOUT_SECONDS=600
+# Optional: Solana compute budget for priority fees
+# X402_SOLANA_COMPUTE_UNIT_LIMIT=200000
+# X402_SOLANA_COMPUTE_UNIT_PRICE=1000
+
+# -------------------------------------------
+# General Configuration (Optional)
+# -------------------------------------------
+# X402_CHAIN=base-sepolia
+# X402_CURRENCY=USDC
+# X402_PROTOCOL_VERSION=2
+# X402_MAX_TIMEOUT_SECONDS=600
+
+# -------------------------------------------
+# Custom RPC URLs (Optional)
+# -------------------------------------------
+# Override default RPC endpoints for any chain
+# Pattern: X402_<CHAIN_NAME>_RPC_URL (dashes become underscores)
+
+# EVM chains
+# X402_BASE_RPC_URL=https://your-base-rpc.com
+# X402_BASE_SEPOLIA_RPC_URL=https://your-base-sepolia-rpc.com
+# X402_AVALANCHE_RPC_URL=https://your-avalanche-rpc.com
+# X402_AVALANCHE_FUJI_RPC_URL=https://your-avalanche-fuji-rpc.com
+
+# Solana chains
+# X402_SOLANA_RPC_URL=https://your-solana-mainnet-rpc.com
+# X402_SOLANA_DEVNET_RPC_URL=https://your-solana-devnet-rpc.com
+
+# Custom chains (example)
+# X402_POLYGON_AMOY_RPC_URL=https://your-rpc-amoy-rpc.com
+# X402_POLYGON_RPC_URL=https://your-polygon-rpc.com

data/examples/README.md

@@ -4,7 +4,7 @@ This directory contains example scripts demonstrating how to use the x402-paymen
 
 ## generate_payment.rb
 
-Generates a signed payment header and curl command for testing x402 payments.
+Generates a signed payment header and curl command for testing x402 payments on EVM chains and Solana.
 
 ### Setup
 
@@ -20,44 +20,123 @@ cp .env.example .env
 
 ```bash
 # From the gem root directory
-cd /Users/zachp/Dev/gems/x402-payments
+cd /path/to/x402-payments
 
 # Load environment variables and run
 export $(cat examples/.env | xargs)
 ruby examples/generate_payment.rb
 
-# Or set variables inline
+# Or set variables inline (EVM)
 X402_PRIVATE_KEY="0xYourPrivateKey" \
 X402_PAY_TO="0xYourRecipientAddress" \
-X402_CHAIN="base-sepolia" \
 ruby examples/generate_payment.rb
+
+# Or set variables inline (Solana)
+X402_SOL_PRIVATE_KEY="YourBase58PrivateKey" \
+X402_SOL_PAY_TO="YourSolanaWalletAddress" \
+ruby examples/generate_payment.rb -c solana-devnet
+```
+
+### Command Line Options
+
+```bash
+ruby examples/generate_payment.rb [options]
+
+Options:
+  -v, --version VERSION    Protocol version (1 or 2, default: 2)
+  -c, --chain CHAIN        Chain name (e.g., base-sepolia, solana-devnet)
+  -h, --help               Show help
+```
+
+### Examples
+
+```bash
+# EVM: Use v2 protocol on Base Sepolia (default)
+ruby examples/generate_payment.rb -v 2
+
+# EVM: Use Polygon Amoy testnet (custom chain)
+ruby examples/generate_payment.rb -c polygon-amoy -v 2
+
+# EVM: Use built-in Base Sepolia with v1
+ruby examples/generate_payment.rb -c base-sepolia -v 1
+
+# Solana: Use Solana devnet
+ruby examples/generate_payment.rb -c solana-devnet -v 2
+
+# Solana: Use Solana mainnet
+ruby examples/generate_payment.rb -c solana -v 2
 ```
 
 ### Environment Variables
 
-- `X402_PRIVATE_KEY` - Private key for signing (required)
-- `X402_PAY_TO` - Default recipient wallet address for payments (required)
-- `X402_CHAIN` - Network to use: `base-sepolia`, `base`, `avalanche-fuji`, or `avalanche` (default: `base-sepolia`)
+**EVM chains:**
+- `X402_PRIVATE_KEY` - EVM private key for signing (required for EVM)
+- `X402_PAY_TO` - EVM recipient wallet address (required for EVM)
+
+**Solana chains:**
+- `X402_SOL_PRIVATE_KEY` - Solana private key in base58 or JSON array format (required for Solana)
+- `X402_SOL_PAY_TO` - Solana recipient wallet address (required for Solana)
+- `X402_SOLANA_FEE_PAYER` - Facilitator fee payer (optional, defaults to x402.org facilitator)
+- `X402_SOLANA_COMPUTE_UNIT_LIMIT` - Compute unit limit (optional, default: 200000)
+- `X402_SOLANA_COMPUTE_UNIT_PRICE` - Priority fee in micro-lamports (optional, default: 1000)
+
+**General:**
+- `X402_CHAIN` - Network to use (default: `base-sepolia`, can be overridden with `-c`)
+
+### Supported Chains
+
+**EVM chains (built-in):**
+- `base-sepolia` (testnet) - default
+- `base` (mainnet)
+- `avalanche-fuji` (testnet)
+- `avalanche` (mainnet)
+
+**Solana chains (built-in):**
+- `solana-devnet` (testnet)
+- `solana` (mainnet)
 
-### Example Output
+**Custom EVM chains (pre-configured in example):**
+- `polygon-amoy` (Polygon testnet, chain ID: 80002)
+- `polygon` (Polygon mainnet, chain ID: 137)
+
+### Example Output (EVM)
 
 ```
-=== X402 Payment Generator ===
-Default Pay To: 0xYourRecipientAddress
+=== X402 Payment Generator (V2) ===
 Chain: base-sepolia
+CAIP-2: eip155:84532
+Protocol Version: 2
+
+Resource: http://localhost:3000/api/v2/weather/paywalled_info
+Amount: $0.001 USD
 
-Generating payment for:
-  Resource: http://localhost:3000/api/weather/current
-  Amount: $0.001 USD
+Header Name: PAYMENT-SIGNATURE
 
-Payment Header (X-PAYMENT):
-eyJ4NDAyVmVyc2lvbiI6MSwic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoi...
+Payment Header:
+eyJ4NDAyVmVyc2lvbiI6Miwic...
 
 Curl Command:
-curl -i -H "X-PAYMENT: eyJ4NDAyVmVyc2lvbiI6..." http://localhost:3000/api/weather/current
+curl -s -H "PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6Miwic..." http://localhost:3000/api/v2/weather/paywalled_info | jq .
+```
+
+### Example Output (Solana)
+
+```
+=== X402 Payment Generator (V2) ===
+Chain: solana-devnet (Solana)
+CAIP-2: solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
+Protocol Version: 2
+
+Resource: http://localhost:3000/api/v2/weather/paywalled_info_sol
+Amount: $0.001 USD
+
+Header Name: PAYMENT-SIGNATURE
 
-To test the payment, run:
-  curl -i -H "X-PAYMENT: eyJ4NDAyVmVyc2lvbiI6..." http://localhost:3000/api/weather/current
+Payment Header:
+eyJ4NDAyVmVyc2lvbiI6Miwic...
+
+Curl Command:
+curl -s -H "PAYMENT-SIGNATURE: eyJ4NDAyVmVyc2lvbiI6Miwic..." http://localhost:3000/api/v2/weather/paywalled_info_sol | jq .
 ```
 
 You can copy and paste the curl command to test your x402-enabled API endpoint.
@@ -68,21 +147,54 @@ You can modify `generate_payment.rb` to:
 
 - Change the amount (e.g., `amount = 0.005` for $0.005)
 - Target different resources (e.g., `resource_url = "https://api.example.com/data"`)
-- Use different networks (set `X402_CHAIN` environment variable)
+- Use different networks (set `X402_CHAIN` environment variable or `-c` flag)
 - Add custom descriptions
+- Override the fee payer for Solana transactions
 
-### Example: Generate Payment for Different Resource
+### Example: Generate EVM Payment Programmatically
 
 ```ruby
-# At the end of generate_payment.rb, add:
+require 'x402/payments'
 
-puts "\n=== Custom Payment ==="
-custom_link = X402::Payments.generate_link(
+X402::Payments.configure do |config|
+  config.private_key = ENV['X402_PRIVATE_KEY']
+  config.default_pay_to = ENV['X402_PAY_TO']
+  config.chain = 'base-sepolia'
+end
+
+link = X402::Payments.generate_link(
   amount: 0.005,
   resource: "http://localhost:3000/api/premium/data",
   description: "Premium API access"
 )
 
-puts "Custom Curl Command:"
-puts custom_link[:curl_command]
+puts link[:curl_command]
 ```
+
+### Example: Generate Solana Payment Programmatically
+
+```ruby
+require 'x402/payments'
+
+X402::Payments.configure do |config|
+  config.private_key = ENV['X402_SOL_PRIVATE_KEY']
+  config.default_pay_to = ENV['X402_SOL_PAY_TO']
+  config.chain = 'solana-devnet'
+end
+
+link = X402::Payments.generate_link(
+  amount: 0.001,
+  resource: "http://localhost:3000/api/sol/data",
+  description: "Solana payment",
+  # fee_payer: "CustomFeePayerAddress"  # Optional: override default facilitator
+)
+
+puts link[:curl_command]
+```
+
+### Solana Notes
+
+- Both sender and receiver must have a USDC Associated Token Account (ATA)
+- The sender must have USDC in their wallet
+- Transactions are partially signed by the sender; the facilitator adds the fee payer signature
+- Default facilitator is x402.org (`CKPKJWNdJEqa81x7CkZ14BVPiY6y16Sxs7owznqtWYp5`)