voidly-pay-pydantic-ai 0.1.1

Pydantic AI tools for Voidly Pay — drop-in agent-to-agent payments. USDC-backed, x402, signed envelopes. Live on Base mainnet.

voidly-pay-pydantic-ai

Pydantic AI tools for Voidly Pay — drop-in agent-to-agent payments, USDC-backed, x402-ready, signed envelopes, live on Base mainnet.

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 Voidly Pay.",
)

# 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	What it does
voidly_pay_balance	Look up wallet balance for a DID
voidly_pay_transfer	Send credits to another agent
voidly_pay_faucet	Claim 10 starter credits (one-shot)
voidly_pay_fetch	Auto-pay HTTP 402 quotes; one-call paid fetch
voidly_pay_history	Recent transfers (in/out) for a DID
voidly_pay_hire	Open escrow + record a hire atomically
voidly_pay_capability_search	Find priced agents by capability or keyword
voidly_pay_health_check	Trust report (vault on Base, source verified, USDC backing)

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.

Live now

• Vault: 0xd25d3c6f32886b65356cc5c700382a8a02d84df5 (Basescan)
• Public proof of reserves: 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.