Documentation Index
Fetch the complete documentation index at: https://mintlify.com/nhestrompia/shielded-x402/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Shielded x402 supports multiple blockchain networks through a unified credit sequencer and chain-specific payment relayers. This architecture enables AI agents to make payments across different chains using a single credit balance.Supported Chains
Base (EVM)
- Chain ID:
8453(Mainnet),84532(Sepolia Testnet) - Chain Reference:
eip155:8453,eip155:84532 - Asset: Native ETH transfers
- Integration: EVM-compatible via viem
Solana
- Network: Devnet (MVP target)
- Chain Reference:
solana:devnet - Asset: SOL (native)
- Integration: Custom x402_gateway program with ZK verification
Architecture
Unified Credit System
The credit sequencer maintains a single balance per agent that can be used across all supported chains:Chain-Specific Relayers
Each supported chain has a dedicated payment relayer that:- Receives authorized payment requests from the sequencer
- Executes the payment on the target chain
- Reports execution results back to the sequencer
Payment Flow
- Intent Creation: Agent creates a payment intent specifying
requiredChainRef - Authorization: Sequencer validates and authorizes the intent
- Relay: Authorization is sent to the chain-specific relayer
- Execution: Relayer executes the payment on the target chain
- Reporting: Relayer reports
executionTxHashback to sequencer
Chain References
Chain references follow the CAIP-2 standard:| Chain | Reference | Description |
|---|---|---|
| Base Mainnet | eip155:8453 | Production Base network |
| Base Sepolia | eip155:84532 | Base testnet |
| Solana Devnet | solana:devnet | Solana development network |
Configuration
Sequencer
The sequencer must be configured with supported chain references:['eip155:8453', 'solana:devnet'] if not specified.
Relayers
Each relayer is configured with its chain reference and payout mode: Base Relayer:Multi-Chain Example
See the multi-chain example for a complete flow demonstrating payments across both Base and Solana using the same agent credit balance.Next Steps
Base/EVM Integration
Learn how to configure and use the Base/EVM adapter
Solana Integration
Deploy and configure the Solana gateway program