{"_id":"@algovoi/plugin-elizaos","_rev":"2-26a7a9d2792143caf7b73b3f537fd873","name":"@algovoi/plugin-elizaos","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@algovoi/plugin-elizaos","version":"0.1.0","keywords":["elizaos","elizaos-plugins","ai-agent","payments","crypto","x402","ap2","a2a","algorand","voi","hedera","stellar","base","solana","tempo","stablecoin","usdc"],"author":{"name":"AlgoVoi","email":"support@algovoi.co.uk"},"license":"MIT","_id":"@algovoi/plugin-elizaos@0.1.0","maintainers":[{"name":"algovoi","email":"chopmob@gmail.com"}],"homepage":"https://algovoi.co.uk","bugs":{"url":"https://github.com/chopmob-cloud/elizaos-plugin-algovoi/issues"},"dist":{"shasum":"a2d10c3c7c50249ea63122735c106a8eed722078","tarball":"https://registry.npmjs.org/@algovoi/plugin-elizaos/-/plugin-elizaos-0.1.0.tgz","fileCount":13,"integrity":"sha512-3a/lP1lziV6ygdIf76fdyVeRtQGP8eXsv8VpZNXIo/oUvf269QPjjRrz6KP4290afmT1JwxNSEVnVun/84YA8w==","signatures":[{"sig":"MEQCIG3lFf410IJqRxyZdC4/JQwONInqirOI3sxUAkFpoxWrAiBRSBDrEb2J3/VL8jeWe3l3lVbxv7oKNUcx4mBklyU94A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":257858},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f4c397e73f71d59581395a3f3183a087ac4c5dcc","scripts":{"dev":"tsup --format esm --dts --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup --format esm --dts","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"algovoi","email":"chopmob@gmail.com"},"repository":{"url":"git+https://github.com/chopmob-cloud/elizaos-plugin-algovoi.git","type":"git"},"_npmVersion":"11.6.2","agentConfig":{"models":[],"actions":["CREATE_PAYMENT_REQUEST","VERIFY_PAYMENT","CHECK_PAYMENT_STATUS"],"services":[],"providers":["algovoi"],"evaluators":[],"pluginType":"elizaos:plugin:1.0.0","pluginParameters":{"ALGOVOI_API_KEY":{"type":"string","required":true,"sensitive":true,"description":"Tenant API key obtained from https://dash.algovoi.co.uk/signup. Required."},"ALGOVOI_API_BASE":{"type":"string","default":"https://api.algovoi.co.uk","required":false,"description":"AlgoVoi A2A endpoint base URL."},"ALGOVOI_DEFAULT_NETWORK":{"type":"string","default":"algorand_mainnet","required":false,"description":"Default settlement network when none is specified by the user. One of: algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet, base_mainnet, solana_mainnet, tempo_mainnet (or their testnet equivalents)."},"ALGOVOI_DEFAULT_CURRENCY":{"type":"string","default":"GBP","required":false,"description":"Default ISO 4217 currency for new checkouts. Defaults to GBP."}}},"description":"Multi-chain agent-to-agent (A2A) crypto payments for ElizaOS — ask, verify, and poll fiat-denominated payments that settle as USDC or native assets across Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. Non-custodial.","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.22.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^3.0.0","typescript":"^5.7.3","@types/node":"^20.0.0","@elizaos/core":"^0.25.0"},"peerDependencies":{"@elizaos/core":"^0.25.0 || ^1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/plugin-elizaos_0.1.0_1780393831895_0.23372990305425123","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@algovoi/plugin-elizaos","version":"0.1.1","description":"Multi-chain agent-to-agent (A2A) crypto payments for ElizaOS — ask, verify, and poll fiat-denominated payments that settle as USDC or native assets across Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. Non-custodial.","type":"module","main":"dist/index.js","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsup --format esm --dts","dev":"tsup --format esm --dts --watch","test":"vitest run","test:watch":"vitest","lint":"tsc --noEmit","prepublishOnly":"npm run build"},"dependencies":{"zod":"^3.22.4"},"peerDependencies":{"@elizaos/core":"^0.25.0 || ^1.0.0"},"devDependencies":{"@elizaos/core":"^0.25.0","@types/node":"^20.0.0","tsup":"^8.3.5","typescript":"^5.7.3","vitest":"^3.0.0"},"engines":{"node":">=20"},"keywords":["elizaos","eliza","plugin","elizaos-plugins","ai-agent","payments","crypto","x402","ap2","a2a","algorand","voi","hedera","stellar","base","solana","tempo","stablecoin","usdc"],"license":"MIT","author":{"name":"AlgoVoi","email":"support@algovoi.co.uk"},"homepage":"https://algovoi.co.uk","repository":{"type":"git","url":"git+https://github.com/chopmob-cloud/elizaos-plugin-algovoi.git"},"bugs":{"url":"https://github.com/chopmob-cloud/elizaos-plugin-algovoi/issues"},"agentConfig":{"pluginType":"elizaos:plugin:1.0.0","pluginParameters":{"ALGOVOI_API_KEY":{"type":"string","description":"Tenant API key obtained from https://dash.algovoi.co.uk/signup. Required.","sensitive":true,"required":true},"ALGOVOI_API_BASE":{"type":"string","description":"AlgoVoi A2A endpoint base URL.","default":"https://api.algovoi.co.uk","required":false},"ALGOVOI_DEFAULT_NETWORK":{"type":"string","description":"Default settlement network when none is specified by the user. One of: algorand_mainnet, voi_mainnet, hedera_mainnet, stellar_mainnet, base_mainnet, solana_mainnet, tempo_mainnet (or their testnet equivalents).","default":"algorand_mainnet","required":false},"ALGOVOI_DEFAULT_CURRENCY":{"type":"string","description":"Default ISO 4217 currency for new checkouts. Defaults to GBP.","default":"GBP","required":false}},"actions":["CREATE_PAYMENT_REQUEST","VERIFY_PAYMENT","CHECK_PAYMENT_STATUS"],"providers":["algovoi"],"evaluators":[],"services":[],"models":[]},"gitHead":"f4c397e73f71d59581395a3f3183a087ac4c5dcc","_id":"@algovoi/plugin-elizaos@0.1.1","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-WCPViQco753KWjNMp61c/HNIEfyHSQ+S+ra7y+f3uu7qFdMR0q44WDz3h9uXJIN0u2E4KKSOjrQks2RKJQsuJQ==","shasum":"4873063249fc1bb0597cfe6f870ee70f655c9728","tarball":"https://registry.npmjs.org/@algovoi/plugin-elizaos/-/plugin-elizaos-0.1.1.tgz","fileCount":14,"unpackedSize":259721,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDQOtNthKlUjxkuN0YZNSd2p2BGiCtzz2Nl3649ZH5cxwIhAP9PWvCefRel9QRD0NuyksEdWGBMapD5BfIX5+Q6Jm6X"}]},"_npmUser":{"name":"algovoi","email":"chopmob@gmail.com"},"directories":{},"maintainers":[{"name":"algovoi","email":"chopmob@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-elizaos_0.1.1_1780396996857_0.5331691270842878"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T09:50:31.717Z","modified":"2026-06-02T10:43:17.184Z","0.1.0":"2026-06-02T09:50:32.076Z","0.1.1":"2026-06-02T10:43:17.060Z"},"bugs":{"url":"https://github.com/chopmob-cloud/elizaos-plugin-algovoi/issues"},"author":{"name":"AlgoVoi","email":"support@algovoi.co.uk"},"license":"MIT","homepage":"https://algovoi.co.uk","keywords":["elizaos","eliza","plugin","elizaos-plugins","ai-agent","payments","crypto","x402","ap2","a2a","algorand","voi","hedera","stellar","base","solana","tempo","stablecoin","usdc"],"repository":{"type":"git","url":"git+https://github.com/chopmob-cloud/elizaos-plugin-algovoi.git"},"description":"Multi-chain agent-to-agent (A2A) crypto payments for ElizaOS — ask, verify, and poll fiat-denominated payments that settle as USDC or native assets across Algorand, VOI, Hedera, Stellar, Base, Solana, and Tempo. Non-custodial.","maintainers":[{"name":"algovoi","email":"chopmob@gmail.com"}],"readme":"# @algovoi/plugin-elizaos\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![ElizaOS Plugin](https://img.shields.io/badge/elizaos--plugins-1.0%2B-7c3aed)](https://github.com/elizaos-plugins/registry)\n[![Agent Trust Bench](https://img.shields.io/badge/Agent_Trust_Bench-100%25_71%2F71-238636)](https://agent-trust-bench.algovoi.co.uk)\n\n> Multi-chain agent-to-agent (A2A) crypto payments for [ElizaOS](https://elizaos.ai) agents.\n\n![AlgoVoi banner](images/banner.jpg)\n\nLets your Eliza agent **ask for, verify, and poll fiat-denominated crypto payments** that settle as stablecoins or native assets across **7 chains** — without holding any crypto, keys, or fiat.\n\n| What | How |\n|---|---|\n| **Ask for a payment** | Agent generates a hosted checkout URL the payer opens in any browser |\n| **Verify a payment** | Agent confirms an on-chain tx satisfies the expected amount, receiver, and binding |\n| **Poll a checkout** | Agent checks whether a previously-issued token has been paid |\n\nSettlement is direct on-chain customer-wallet → merchant-wallet via [AlgoVoi](https://algovoi.co.uk), the only live A2A-compliant crypto payment gateway as of 2026-04-26.\n\n## Why this plugin\n\n- **Non-custodial.** AlgoVoi never holds funds. Your agent doesn't need a wallet, a private key, or any fiat custody — only an API key.\n- **7 chains, one interface.** Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo — agent says \"GBP\", AlgoVoi handles the chain selection.\n- **4 payment protocols.** x402 (HTTP 402 micropayments), MPP (IETF), AP2 (Google Agentic Payments), and Google A2A v0.3.\n- **Stablecoin-first.** USDC across Algorand, VOI, Hedera, Stellar, Base, Solana, Tempo. Native asset support where the chain has it.\n- **No new SDK deps.** Plugin is a thin HTTP wrapper around the public A2A endpoint at `https://api.algovoi.co.uk/.well-known/agent.json`.\n\n## Install\n\n```bash\npnpm add @algovoi/plugin-elizaos\n# or\nnpm install @algovoi/plugin-elizaos\n# or\nyarn add @algovoi/plugin-elizaos\n```\n\n## Get an API key\n\nFree tier (testnet) at [dash.algovoi.co.uk/signup](https://dash.algovoi.co.uk/signup).\nMainnet activation requires KYC; the free trial covers your first $1,000 of mainnet payment volume across all chains.\n\n## Configure\n\nSet environment variables (or pass via the runtime's settings):\n\n```env\nALGOVOI_API_KEY=algvk_live_...        # required — from dash.algovoi.co.uk\nALGOVOI_API_BASE=https://api.algovoi.co.uk   # optional, this is the default\nALGOVOI_DEFAULT_NETWORK=algorand_mainnet           # optional, default\nALGOVOI_DEFAULT_CURRENCY=GBP                       # optional, default\n```\n\n## Use it in an Eliza character\n\n```ts\nimport { algovoiPlugin } from \"@algovoi/plugin-elizaos\";\n\nconst character = {\n  name: \"PayAgent\",\n  bio: \"I'm an AI assistant that can collect and verify crypto payments.\",\n  plugins: [algovoiPlugin],\n  // ... rest of your character config\n};\n```\n\nA complete character JSON is in [`examples/payments-character.json`](examples/payments-character.json).\n\n## Actions\n\nThe plugin registers three actions on the Eliza runtime:\n\n### `CREATE_PAYMENT_REQUEST`\n\nCreate a hosted checkout link for a fiat amount.\n\n**Triggers:** \"create a payment request for £9.99\", \"invoice 50 USD\", \"ask for $20 on solana\".\n\n**Returns:** `{ token, checkout_url, status, expires_at, chain, amount_microunits }`.\n\n### `VERIFY_PAYMENT`\n\nVerify an on-chain transaction satisfies a payment.\n\n**Triggers:** \"verify tx ABC123 on algorand_mainnet for token uW9MJN-abc123\", \"did the user pay for resource X\".\n\n**Returns:** `{ verified: true|false, access_token, error? }`. The `access_token` is a JWT your agent can use to gate downstream calls.\n\n### `CHECK_PAYMENT_STATUS`\n\nPoll a previously-issued checkout token.\n\n**Triggers:** \"is checkout X paid?\", \"check status of token Y\".\n\n**Returns:** `{ token, status: \"active\" | \"paid\" | \"expired\" | \"cancelled\", redirect_url }`.\n\n## End-to-end example\n\n```ts\nimport { algovoiPlugin, AlgoVoiClient } from \"@algovoi/plugin-elizaos\";\n\n// Or use the underlying client directly:\nconst client = new AlgoVoiClient({\n  ALGOVOI_API_KEY: process.env.ALGOVOI_API_KEY!,\n  ALGOVOI_API_BASE: \"https://api.algovoi.co.uk\",\n  ALGOVOI_DEFAULT_NETWORK: \"algorand_mainnet\",\n  ALGOVOI_DEFAULT_CURRENCY: \"GBP\",\n});\n\n// 1. Create a checkout\nconst checkout = await client.createCheckout({\n  amount: 9.99,\n  currency: \"GBP\",\n  label: \"Premium content access\",\n  preferred_network: \"algorand_mainnet\",\n  redirect_url: \"https://your-app.example.com/thanks\",\n});\n\nconsole.log(`Pay here: ${checkout.checkout_url}`);\nconsole.log(`Token to poll: ${checkout.token}`);\n\n// 2. Poll until paid\nlet status = checkout.status;\nwhile (status === \"active\") {\n  await new Promise((r) => setTimeout(r, 10_000));\n  const result = await client.checkStatus({ token: checkout.token });\n  status = result.status;\n}\n\n// 3. Or — verify a known tx_id directly\nconst verified = await client.verifyPayment({\n  network: \"algorand_mainnet\",\n  tx_id: \"7K9X...PQR\",\n  token: checkout.token,\n});\nif (verified.verified) {\n  console.log(`Access granted. JWT: ${verified.access_token}`);\n}\n```\n\n## Supported networks\n\n| Chain | Mainnet | Testnet | Stablecoin | Native |\n|---|---|---|---|---|\n| Algorand | ✅ | ✅ | USDC | ALGO |\n| VOI | ✅ | ✅ | — | VOI |\n| Hedera | ✅ | ✅ | USDC | HBAR |\n| Stellar | ✅ | ✅ | USDC | XLM |\n| Base | ✅ | ✅ (Sepolia) | USDC | ETH |\n| Solana | ✅ | ✅ (Devnet) | USDC | SOL |\n| Tempo | ✅ | ✅ | USDC | — |\n\n## Discovery\n\nThe plugin connects to a Google A2A v0.3 agent. You can inspect AlgoVoi's full agent card at:\n\n```bash\ncurl https://api.algovoi.co.uk/.well-known/agent.json\n```\n\n## Security\n\n- AlgoVoi is non-custodial — funds settle direct customer→merchant on a public blockchain\n- Your tenant API key is the only secret; rotate it via the dashboard\n- Compliance binder, security disclosure, and full policy library at [algovoi.co.uk/AlgoVoi/compliance.html](https://algovoi.co.uk/AlgoVoi/compliance.html)\n- Vulnerability disclosure: [security@algovoi.co.uk](mailto:security@algovoi.co.uk) / [/.well-known/security.txt](https://algovoi.co.uk/.well-known/security.txt)\n\n## Contributing\n\nPRs welcome. Open an issue first for substantial changes. The plugin's contract is intentionally narrow — it wraps the A2A endpoint and nothing more — so most enhancements belong in the upstream gateway, not here.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Links\n\n- AlgoVoi platform: [algovoi.co.uk](https://algovoi.co.uk)\n- Docs: [docs.algovoi.co.uk](https://docs.algovoi.co.uk)\n- A2A integration: [docs.algovoi.co.uk/protocols/a2a](https://docs.algovoi.co.uk/protocols/a2a)\n- ElizaOS: [elizaos.ai](https://elizaos.ai)\n- Plugin registry: [github.com/elizaos-plugins/registry](https://github.com/elizaos-plugins/registry)\n","readmeFilename":"README.md"}