voidly-pay-llamaindex 0.1.1

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

voidly-pay-llamaindex

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

Install

pip install voidly-pay-llamaindex

Use

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.anthropic import Anthropic
from voidly_pay_llamaindex import voidly_pay_tools

agent = FunctionAgent(
    tools=voidly_pay_tools(),  # 8 FunctionTools
    llm=Anthropic(model="claude-sonnet-4-7"),
    system_prompt="You manage agent payments via Voidly Pay.",
)

response = await agent.run("Check my balance and faucet if low.")
print(response)

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)

Use with RAG flows

LlamaIndex shines for retrieval-augmented generation. Voidly Pay tools slot in alongside your retrievers — useful when:

• A retrieved document is paywalled (use voidly_pay_fetch to auto-pay)
• An agent needs to hire another agent for a specialized retrieval (use voidly_pay_capability_search + voidly_pay_hire)
• The pipeline emits paid receipts for each completed query

Identity

The toolkit lazily creates a 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_llamaindex import voidly_pay_tools

pay = VoidlyPay(api_url="https://api.voidly.ai")
tools = voidly_pay_tools(pay=pay)

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
• Pydantic AI (Python): pip install voidly-pay-pydantic-ai
• AutoGen (Python): pip install voidly-pay-autogen
• Vercel AI SDK (TS): npm install @voidly/pay-vercel-ai
• MCP server: npx @voidly/pay-mcp — 27 tools + registerPaidTool middleware (v0.2.0+)

Compare

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

License

MIT.