feat(tools): Add Nory x402 payment tools

[TheMemeBanker]

Summary

Adds tools for AI agents to make payments using the x402 HTTP payment protocol via Nory.

New Tools

Tool	Description
nory_get_payment_requirements	Get payment requirements for a resource (amount, supported networks, wallet address)
nory_verify_payment	Verify a signed payment transaction before settlement
nory_settle_payment	Submit a verified payment to the blockchain (~400ms)
nory_lookup_transaction	Check the status of a previously submitted payment
nory_health_check	Check Nory service health and supported networks

Supported Networks

• Solana (mainnet/devnet)
• Base, Polygon, Arbitrum, Optimism, Avalanche, Sei, IoTeX (all mainnet)

Use Cases

AI agents can now:

• Pay for premium API access on-the-fly
• Handle HTTP 402 Payment Required responses automatically
• Make micropayments for AI-to-AI services
• Access paid resources without pre-configured subscriptions

Usage Example

from haystack.tools import nory_get_payment_requirements, nory_settle_payment, NORY_X402_TOOLS
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.dataclasses import ChatMessage

# Use individual tools
requirements = nory_get_payment_requirements.invoke(
    resource="/api/premium/data",
    amount="0.10",
    network="solana-mainnet"
)

# Or use all tools with an agent
generator = OpenAIChatGenerator(model="gpt-4")
generator.run(messages=[...], tools=NORY_X402_TOOLS)

Documentation

• x402 Protocol Spec
• Nory API

🤖 Generated with Claude Code

[vercel]

Someone is attempting to deploy a commit to the deepset Team on Vercel.

A member of the Team first needs to authorize it.

[CLAassistant]

All committers have signed the CLA.

[TheMemeBanker]

Hi Haystack team! Following up on this PR. The x402 payment tools would complement Haystack's existing tool ecosystem nicely, enabling agents to access paid APIs and premium data sources. Let me know if there's anything I can improve or adjust!

[TheMemeBanker]

recheck

[TheMemeBanker]

recheck

[TheMemeBanker]

I have read the CLA Document and I hereby sign the CLA

[TheMemeBanker]

Update: We've now released the full x402 SDK suite:

• nory-x402-middleware - Add paywalls to any API
• nory-x402-payer - Auto-pay client for agents (NEW)
• nory-mcp-server - MCP/Claude integration

With this Haystack integration, users would have native payment tools for their pipelines. The payer SDK handles the other side - when Haystack agents encounter paid APIs, they can pay automatically.

CLA signed above. Ready for review when you have time!

[julian-risch]

Hello @TheMemeBanker, Thank you for the suggestion to add payment tools and opening this pull request. The new tools that you suggest to add are a better fit for a Haystack integration than for merging them into the Haystack core. I suggest that you publish this integration yourself as a pypi package and then open a PR in the following repo to make your integration more visible with an integration page: https://github.com/deepset-ai/haystack-integrations
Other successful community integrations, for example the MilvusDocumentStore are also maintained by our community in separate repositories and listed in https://github.com/deepset-ai/haystack-integrations .