{"title":"⚡ invinoveritas — Wallet Onboarding Guide","subtitle":"Required for Autonomous Agents","introduction":"Your agent needs a Lightning wallet to pay for reasoning and decision calls. Without it, every request returns 402 Payment Required.","wallet_options":[{"type":"NWC (Recommended)","description":"Easiest and fastest setup. No node required.","wallets":["Alby","Zeus","Mutiny"],"setup_time":"Under 3 minutes","pros":["Quick onboarding","No server maintenance","Great for most agents"],"code_example":{"language":"python","code":"from invinoveritas.providers import NWCProvider\nfrom invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools\n\nhandler = InvinoCallbackHandler(\n    provider=NWCProvider(uri=\"nostr+walletconnect://YOUR_WALLET_URI_HERE\")\n)\n\ntools = create_invinoveritas_tools(handler)"}},{"type":"LND Node","description":"Full control with your own Lightning node.","pros":["Maximum control","Best for high-volume agents","Self-custodial"],"code_example":{"language":"python","code":"from invinoveritas.providers import LNDProvider\nfrom invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools\n\nhandler = InvinoCallbackHandler(\n    provider=LNDProvider(\n        macaroon_path=\"/root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon\",\n        cert_path=\"/root/.lnd/tls.cert\"\n    )\n)\n\ntools = create_invinoveritas_tools(handler)"}}],"usage_example":{"description":"Once the handler is set up, your agent pays automatically:","code":"result = agent.run(\n    \"Should I increase my BTC exposure in 2026?\", \n    callbacks=[handler]\n)\nprint(f\"Spent: {handler.total_spent_sats} sats\")\nprint(result)"},"next_steps":["1. Choose NWC (easiest) or LND","2. Get your WalletConnect URI or macaroon/cert paths","3. Paste into the code above","4. Restart your agent — it will now pay autonomously"],"tips":["Start with small test queries to verify wallet connection","Ensure your wallet has sufficient sats","NWC is fastest for new agents; LND is better for production scale","All payments are atomic and cryptographically verifiable","No KYC or subscriptions required"],"resources":{"guide":"/guide","health":"/health","mcp":"/mcp","prices":"/prices","sdk":"https://pypi.org/project/invinoveritas/","lnd_docs":"https://docs.lightning.engineering","nwc_docs":"https://walletconnect.com/"},"urgent_note":"⚠️ Without configuring a Lightning wallet, your agent cannot use invinoveritas tools autonomously."}