X402 Layer

x402 Singularity Layer

x402 is a Web3 payment layer enabling AI agents to:

• 💰 Pay for API access using USDC
• 🚀 Deploy monetized endpoints
• 🔍 Discover services via marketplace
• 📊 Manage endpoints and credits

Networks: Base (EVM) • Solana
Currency: USDC
Protocol: HTTP 402 Payment Required

Quick Start

1. Install Dependencies

pip install -r {baseDir}/requirements.txt

2. Set Up Wallet

# For Base (EVM)
export PRIVATE_KEY="0x..."
export WALLET_ADDRESS="0x..."

# For Solana (optional)
export SOLANA_SECRET_KEY="[1,2,3,...]"  # JSON array

Scripts Overview

🛒 CONSUMER MODE (Buying Services)

🏭 PROVIDER MODE (Selling Services)

Consumer Flows

A. Pay-Per-Request (Recommended)

# Pay with Base (EVM) - 100% reliable
python {baseDir}/scripts/pay_base.py https://api.x402layer.cc/e/weather-data

# Pay with Solana - includes retry logic
python {baseDir}/scripts/pay_solana.py https://api.x402layer.cc/e/weather-data

B. Credit-Based Access (Fastest)

Pre-purchase credits for instant access without blockchain latency:

# Check your balance
python {baseDir}/scripts/check_credits.py weather-data

# Buy credits (consumer purchasing credits)
python {baseDir}/scripts/recharge_credits.py weather-data pack_100

# Use credits for instant access
python {baseDir}/scripts/consume_credits.py https://api.x402layer.cc/e/weather-data

C. Discover Services

# Browse all services
python {baseDir}/scripts/discover_marketplace.py

# Search by keyword
python {baseDir}/scripts/discover_marketplace.py search weather

Provider Flows

A. Create Endpoint ($5 one-time)

Deploy your own monetized API:

python {baseDir}/scripts/create_endpoint.py my-api "My AI Service" https://api.example.com 0.01

Includes 20,000 test credits.

B. Manage Your Endpoint

# List your endpoints
python {baseDir}/scripts/manage_endpoint.py list

# View stats
python {baseDir}/scripts/manage_endpoint.py stats my-api

# Update price
python {baseDir}/scripts/manage_endpoint.py update my-api --price 0.02

C. Top Up YOUR Endpoint (Provider)

Add credits to maintain your endpoint's balance:

python {baseDir}/scripts/topup_endpoint.py my-api 10  # Add $10 worth

Note: This is different from recharge_credits.py which is for CONSUMERS.

D. List on Marketplace

Make your endpoint publicly discoverable:

python {baseDir}/scripts/list_on_marketplace.py my-api --category ai --description "AI-powered analysis"

Payment Technical Details

Base (EVM) - EIP-712 Signatures

Uses USDC TransferWithAuthorization (EIP-3009):

• Gasless for payer
• Facilitator settles on-chain
• 100% reliable

Solana - Versioned Transactions

Uses VersionedTransaction with MessageV0:

• Facilitator pays gas (from extra.feePayer)
• SPL Token TransferChecked instruction
• ~75% success rate (retry logic included)

Environment Reference

API Base URL

• Endpoints: https://api.x402layer.cc/e/{slug}
• Marketplace: https://api.x402layer.cc/api/marketplace
• Credits: https://api.x402layer.cc/api/credits/*
• Agent API: https://api.x402layer.cc/agent/*

Resources

• 📖 Documentation: studio.x402layer.cc/docs/agentic-access/openclaw-skill
• 💻 GitHub Docs: github.com/ivaavimusic/SGL_DOCS_2025
• 🐦 OpenClaw: x.com/openclaw
• 🌐 x402 Studio: studio.x402layer.cc

Known Issues

⚠️ Solana payments have ~75% success rate due to facilitator-side fee payer infrastructure issue. Retry logic is included in pay_solana.py. Base (EVM) payments are 100% reliable and recommended for production.