Expand description
Solana chain support for the x402 payment protocol.
This crate provides implementations of the x402 payment protocol for Solana blockchain
with the “exact” payment scheme based on SPL Token transfer instructions with
pre-signed authorization.
§Features
- CAIP-2 Addressing: Uses CAIP-2 chain IDs for chain identification
- SPL Token Payments: Token transfers using pre-signed transaction authorization
- Compute Budget Management: Automatic compute unit limit and price configuration
WebSocketSupport: Optional pubsub for faster transaction confirmation- Balance Verification: On-chain balance checks before settlement
§Architecture
The crate is organized into several modules:
§Feature Flags
server- Server-side price tag generationclient- Client-side payment signingfacilitator- Facilitator-side payment verification and settlementtelemetry-OpenTelemetrytracing support
Re-exports§
pub use exact::SolanaExact;pub use exact::client::SolanaExactClient;client
Modules§
Structs§
- CASH
- Ergonomic accessors for CASH token deployments on well-known Solana chains.
- PYUSD
- Ergonomic accessors for PYUSD token deployments on well-known Solana chains.
- USDC
- Ergonomic accessors for USDC token deployments on well-known Solana chains.
- USDG
- Ergonomic accessors for USDG token deployments on well-known Solana chains.
- USDT
- Ergonomic accessors for USDT token deployments on well-known Solana chains.
Constants§
- SOLANA_
MAX_ COMPUTE_ UNIT_ PRICE_ MICROLAMPORTS - Recommended hard cap for
max_compute_unit_price(micro-lamports).
Statics§
- SOLANA_
NETWORKS - Well-known Solana networks with their names and CAIP-2 identifiers.
Functions§
- cash_
solana_ deployment - Returns the CASH deployment for a specific Solana chain, if known.
- cash_
solana_ deployments - Returns all known CASH deployments on Solana chains.
- pyusd_
solana_ deployment - Returns the PYUSD deployment for a specific Solana chain, if known.
- pyusd_
solana_ deployments - Returns all known PYUSD deployments on Solana chains.
- usdc_
solana_ deployment - Returns the USDC deployment for a specific Solana chain, if known.
- usdc_
solana_ deployments - Returns all known USDC deployments on Solana chains.
- usdg_
solana_ deployment - Returns the USDG deployment for a specific Solana chain, if known.
- usdg_
solana_ deployments - Returns all known USDG deployments on Solana chains.
- usdt_
solana_ deployment - Returns the USDT deployment for a specific Solana chain, if known.
- usdt_
solana_ deployments - Returns all known USDT deployments on Solana chains.