voidly-pay-llamaindex

LlamaIndex 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.

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

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

Tools

Use with RAG flows

LlamaIndex shines for retrieval-augmented generation. voidpay 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)

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
• 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.