voidly-pay-pydantic-ai

Pydantic AI tools for voidpay — drop-in agent-to-agent payments in credits, x402-ready, signed envelopes. Credits are an internal accounting unit: not backed, not redeemable. The Base mainnet USDC vault is being retired.

First-mover lane: @stripe/agent-toolkit doesn't ship a Pydantic AI adapter. This package fills that gap with a type-safe, Pydantic-validated 8-tool surface.

Install

pip install voidly-pay-pydantic-ai

Use

from pydantic_ai import Agent
from voidly_pay_pydantic_ai import voidly_pay_tools

agent = Agent(
    "anthropic:claude-sonnet-4-7",
    tools=voidly_pay_tools(),
    system_prompt="You manage agent payments via voidpay.",
)

# Now run it.
result = await agent.run(
    "Check my balance, then claim the faucet if it's under 1 credit."
)
print(result.output)

Or attach to an existing agent:

from voidly_pay_pydantic_ai import register_voidly_pay_tools
from pydantic_ai import Agent

agent = Agent("anthropic:claude-sonnet-4-7")
register_voidly_pay_tools(agent)

Tools

Tool descriptions follow the tight Stripe-style template (action verb + arg list with types) so Claude / GPT / Gemini can pick the right tool reliably.

Identity

Each tool factory closes over a shared VoidlyPay client. On first use it mints an Ed25519 keypair and persists to ~/.voidly-pay/keypair.json (mode 0600). To bring your own:

from voidly_pay import VoidlyPay
from voidly_pay_pydantic_ai import voidly_pay_tools

pay = VoidlyPay(api_url="https://api.voidly.ai")  # or pass did=, secret=
tools = voidly_pay_tools(pay=pay)

Why Pydantic AI

Pydantic AI's tool model is the cleanest in the Python agent-framework world: every tool is a plain Python function with Pydantic-validated arguments, and the LLM-visible schema is built automatically from the function signature. Type errors at the LLM ↔ tool boundary turn into clean validation errors instead of silent miscalls.

Historical deployment references

• Vault: 0xd25d3c6f32886b65356cc5c700382a8a02d84df5 (Basescan)
• Public vault record (not a reserve — Stage 2 is being retired): https://api.voidly.ai/v1/pay/proof
• Marketplace: https://api.voidly.ai/v1/pay/marketplace
• Source verified on Sourcify

Sister packages

• LangChain (Python): pip install voidly-pay-langchain
• CrewAI (Python): pip install voidly-pay-crewai
• Vercel AI SDK (TS): npm install @voidly/pay-vercel-ai
• MCP server: npx @voidly/pay-mcp — 27 tools + registerPaidTool middleware (v0.2.0+)
• CLI: npm install -g @voidly/pay-cli
• Core SDK (TS): npm install @voidly/pay
• Core SDK (Python): pip install voidly-pay

Compare

• vs @stripe/agent-toolkit: https://voidly.ai/pay/vs/stripe-agent-toolkit
• Full rail comparison: https://voidly.ai/pay/compare

License

MIT.