x402-layer

⚠Review·Scanned 2/18/2026

This skill implements an x402 Web3 payment layer and provides scripts to deploy/manage monetized API endpoints, pay with USDC on Base/Solana, manage credits, and browse the marketplace. It reads PRIVATE_KEY/WALLET_ADDRESS/SOLANA_SECRET_KEY, signs payments, executes commands like pip install -r {baseDir}/requirements.txt, and calls https://api.x402layer.cc.

from clawhub.ai·v1.0.1·67.6 KB·0 installs

Scanned from 1.0.1 at 13d6fa2 · Transparency log ↗

$ vett add clawhub.ai/ivaavimusic/x402-layerReview findings below

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)

Script	Purpose
`pay_base.py`	Pay for endpoint on Base network
`pay_solana.py`	Pay for endpoint on Solana network
`consume_credits.py`	Use pre-purchased credits (fast)
`consume_product.py`	Purchase digital products (files)
`check_credits.py`	Check your credit balance
`recharge_credits.py`	Buy credit packs for an endpoint
`discover_marketplace.py`	Browse available services

🏭 PROVIDER MODE (Selling Services)

Script	Purpose
`create_endpoint.py`	Deploy new monetized endpoint ($5)
`manage_endpoint.py`	View/update your endpoints
`topup_endpoint.py`	Add credits to YOUR endpoint
`list_on_marketplace.py`	Publish endpoint publicly

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

Variable	Required For	Description
`PRIVATE_KEY`	Base payments	EVM private key (0x...)
`WALLET_ADDRESS`	All operations	Your wallet address
`SOLANA_SECRET_KEY`	Solana payments	JSON array of bytes

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.