Voidly Pay Cookbook

Runnable recipes for Voidly Pay — agent-to-agent payments over HTTP 402 (x402), USDC-backed, live on Base mainnet.

Every recipe in this repo is a self-contained working program. Clone, set your keys, run, and watch a real settlement land on the rail.

What is Voidly Pay?

Voidly Pay is an x402 facilitator + drop-in SDKs that let AI agents charge each other in USDC-backed credits with one-line integrations for the major frameworks. Drop a 402 paywall on any HTTP route and a paying agent can settle it from their DID with no human in the loop.

• Live demo (no install): https://huggingface.co/spaces/emperor-mew/voidly-pay
• Universal proxy: https://voidly.ai/pay/proxy (paywall any URL with one query param)
• Comparison vs alternatives: https://voidly.ai/pay/compare
• Proof of reserves: https://voidly.ai/pay/proof
• Manifest: https://api.voidly.ai/v1/pay/manifest.json

Quick start (3 minutes)

1. Claim a DID + 10 starter credits in your browser: https://voidly.ai/pay/claim
2. Pick a recipe below that matches your stack
3. Set VOIDLY_PAY_DID and VOIDLY_PAY_KEYFILE as env vars
4. Run the recipe — every line is real, every settlement is on-chain (well, on the rail backed by an on-chain vault).

Recipes

Recipe	Stack	What it does
recipes/01-paywall-any-url	Shell + curl	Paywall any HTTPS URL with zero code via the universal proxy. The fastest path to your first earned credit.
recipes/02-hono-x402-server	TypeScript + Hono + @voidly/pay	A real Hono web server with one paid route. Drop into Cloudflare Workers, Vercel, Bun, or Node.
recipes/03-langchain-paying-agent	Python + LangChain + voidly-pay-langchain	A LangChain agent that calls a paid endpoint, pays the 402 quote, and uses the result.
recipes/04-claude-code-skill	Claude Code Agent Skill	The canonical SKILL.md for Voidly Pay. Drop into ~/.claude/skills/ and Claude learns when to use the rail. Pairs with @voidly/pay-mcp.

More recipes coming. PRs welcome — see CONTRIBUTING.md.

Why x402?

HTTP 402 "Payment Required" was reserved for digital cash in 1997 and lay dormant for 28 years. The x402 protocol finally activates it: a server returns 402 with a facilitator-signed quote; the client pays it and retries with an X-Payment header. The protocol is governed by the x402 Foundation and supported by Coinbase, Cloudflare, and ~200+ ecosystem projects.

Voidly Pay is one of those facilitators. The voidly-credit scheme is USDC-backed (Stage 2 vault on Base mainnet, Sourcify-verified, public reserves dashboard).

Trust posture

• Vault: 0xd25d3c6f32886b65356cc5c700382a8a02d84df5 on Base mainnet
• Source: Sourcify exact_match — non-upgradable
• Reentrancy: EIP-1153 transient-storage guard
• Caps: $100 daily, $10 per-tx (governance-tunable)
• Public reserves: https://voidly.ai/pay/proof — vault USDC ≥ Σ(stage2_credits), refreshed every 15s

Contributing

Fork, add a recipe under recipes/NN-your-recipe/, open a PR. Each recipe should:

• Be self-contained (one folder, one README, one runnable script)
• Use the canonical SDK (@voidly/pay, voidly-pay, @voidly/pay-mcp, etc.)
• Show the actual settlement happening (curl output, logs, or a screenshot)
• Be MIT licensed

License

MIT. See LICENSE.