{"_id":"@aeon-ai-pay/agent-pay","_rev":"4-bfbec203d90ca9a29953ceb03e2af0fe","name":"@aeon-ai-pay/agent-pay","dist-tags":{"latest":"0.8.8"},"versions":{"0.8.5":{"name":"@aeon-ai-pay/agent-pay","version":"0.8.5","keywords":["agent-skills","x402","ai-image","image-generation","crypto-payment","evm","bsc"],"license":"MIT","_id":"@aeon-ai-pay/agent-pay@0.8.5","maintainers":[{"name":"aeon_project","email":"code@alchemypay.org"}],"homepage":"https://github.com/AEON-Project/agent-pay#readme","bugs":{"url":"https://github.com/AEON-Project/agent-pay/issues"},"bin":{"agent-pay":"bin/cli.mjs"},"dist":{"shasum":"474dfeb1da0f4783a95aab37d1d7d4eaf9fda04a","tarball":"https://registry.npmjs.org/@aeon-ai-pay/agent-pay/-/agent-pay-0.8.5.tgz","fileCount":20,"integrity":"sha512-shQMdDPvVw8soN9fFgwNmXZEIOO1ogQ50dqREVTnOqrrrpqNvECKaR14fsw6AoYF7sWhbzZrMs9aoZwTFUWmtw==","signatures":[{"sig":"MEYCIQDWgs/di6gEzDtrzji5pBSzYZLlPq18FebjFm3pm5TupgIhAOfnhjBHVL3j1TXXPnUvYu7qt7CAXNXZ/sRjBxKfZYZk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":125688},"type":"module","engines":{"node":">=25"},"gitHead":"a016c43d20f4fde0dad944a0162a8ba2f4a46cff","scripts":{"wallet":"node bin/cli.mjs wallet","release":"node scripts/release.mjs","generate":"node bin/cli.mjs generate","postinstall":"node scripts/postinstall.mjs"},"_npmUser":{"name":"aeon_project","email":"code@alchemypay.org"},"repository":{"url":"git+https://github.com/AEON-Project/agent-pay.git","type":"git"},"_npmVersion":"11.11.0","description":"Agent skill & CLI for AI image generation, paid via x402 protocol with USDT on BSC","directories":{},"_nodeVersion":"25.8.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","commander":"^13.0.0","qrcode-terminal":"^0.12.0","@aeon-ai-pay/evm":"2.1.4","@aeon-ai-pay/axios":"2.1.2","@walletconnect/sign-client":"^2.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-pay_0.8.5_1778053117753_0.37038321967625576","host":"s3://npm-registry-packages-npm-production"}},"0.8.6":{"name":"@aeon-ai-pay/agent-pay","version":"0.8.6","keywords":["agent-skills","x402","ai-image","image-generation","crypto-payment","evm","bsc"],"license":"MIT","_id":"@aeon-ai-pay/agent-pay@0.8.6","maintainers":[{"name":"aeon_project","email":"code@alchemypay.org"}],"homepage":"https://github.com/AEON-Project/agent-pay#readme","bugs":{"url":"https://github.com/AEON-Project/agent-pay/issues"},"bin":{"agent-pay":"bin/cli.mjs"},"dist":{"shasum":"8a785a2c0db31ef4b091ddaa4f8e6fdd4e2d99b1","tarball":"https://registry.npmjs.org/@aeon-ai-pay/agent-pay/-/agent-pay-0.8.6.tgz","fileCount":20,"integrity":"sha512-6jQAtSO5D4N09K6FURUGNMIsaXRrUDDxJeOH7jukLC6WVhPTcH+rskNt9sNmwr7VUJzRcWdtfPv3opZOov06GQ==","signatures":[{"sig":"MEQCIGk2HLg56UbwP0CWcloc7ue7o4hjiFbnjr1IrEGqTgz6AiAOOYBl2sw+J+6+TAoo1/HOfNIFROoxuNgH7v7k8zb9KQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124317},"type":"module","engines":{"node":">=25"},"gitHead":"24919e5cbb937975eb96272a48b1b59b09757835","scripts":{"wallet":"node bin/cli.mjs wallet","release":"node scripts/release.mjs","generate":"node bin/cli.mjs generate","postinstall":"node scripts/postinstall.mjs"},"_npmUser":{"name":"aeon_project","email":"code@alchemypay.org"},"repository":{"url":"git+https://github.com/AEON-Project/agent-pay.git","type":"git"},"_npmVersion":"11.11.0","description":"Agent skill & CLI for AI image generation, paid via x402 protocol with USDT on BSC","directories":{},"_nodeVersion":"25.8.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","commander":"^13.0.0","qrcode-terminal":"^0.12.0","@aeon-ai-pay/evm":"2.1.4","@aeon-ai-pay/axios":"2.1.2","@walletconnect/sign-client":"^2.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-pay_0.8.6_1778054480177_0.8017377345827224","host":"s3://npm-registry-packages-npm-production"}},"0.8.7":{"name":"@aeon-ai-pay/agent-pay","version":"0.8.7","keywords":["agent-skills","x402","ai-image","image-generation","crypto-payment","evm","bsc"],"license":"MIT","_id":"@aeon-ai-pay/agent-pay@0.8.7","maintainers":[{"name":"aeon_project","email":"code@alchemypay.org"}],"homepage":"https://github.com/AEON-Project/agent-pay#readme","bugs":{"url":"https://github.com/AEON-Project/agent-pay/issues"},"bin":{"agent-pay":"bin/cli.mjs"},"dist":{"shasum":"d13eadb10cc720ae073fe1f03bfefb80d0a14657","tarball":"https://registry.npmjs.org/@aeon-ai-pay/agent-pay/-/agent-pay-0.8.7.tgz","fileCount":20,"integrity":"sha512-6emjPMj6ZYq2NU8Dr34IxnO8VpqNqf6QLfCSbTImXoV3iI9dw0DGbDICb0inF5vzT34aCESGrAbAGDePGV3EQw==","signatures":[{"sig":"MEUCIG5BtwPwFiH4ZnpShGjYRt8kn/7kd8U57RcIzE3BAe17AiEAnFfqIHSKl3Sq8Su4rE4/zyj3oIbrId9GrXOTvnBqTI0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124317},"type":"module","engines":{"node":">=25"},"gitHead":"37f38c22785215545522e9cb66d6e8d6060a1689","scripts":{"wallet":"node bin/cli.mjs wallet","release":"node scripts/release.mjs","generate":"node bin/cli.mjs generate","postinstall":"node scripts/postinstall.mjs"},"_npmUser":{"name":"aeon_project","email":"code@alchemypay.org"},"repository":{"url":"git+https://github.com/AEON-Project/agent-pay.git","type":"git"},"_npmVersion":"11.11.0","description":"Agent skill & CLI for AI image generation, paid via x402 protocol with USDT on BSC","directories":{},"_nodeVersion":"25.8.1","dependencies":{"viem":"^2.39.0","axios":"^1.13.2","commander":"^13.0.0","qrcode-terminal":"^0.12.0","@aeon-ai-pay/evm":"2.1.4","@aeon-ai-pay/axios":"2.1.2","@walletconnect/sign-client":"^2.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-pay_0.8.7_1778058658253_0.895371769659675","host":"s3://npm-registry-packages-npm-production"}},"0.8.8":{"name":"@aeon-ai-pay/agent-pay","version":"0.8.8","description":"Agent skill & CLI for AI image generation, paid via x402 protocol with USDT on BSC","type":"module","bin":{"agent-pay":"bin/cli.mjs"},"scripts":{"postinstall":"node scripts/postinstall.mjs","generate":"node bin/cli.mjs generate","wallet":"node bin/cli.mjs wallet","release":"node scripts/release.mjs"},"dependencies":{"@aeon-ai-pay/axios":"2.1.2","@aeon-ai-pay/evm":"2.1.4","@walletconnect/sign-client":"^2.17.0","axios":"^1.13.2","commander":"^13.0.0","qrcode-terminal":"^0.12.0","viem":"^2.39.0"},"engines":{"node":">=25"},"keywords":["agent-skills","x402","ai-image","image-generation","crypto-payment","evm","bsc"],"repository":{"type":"git","url":"git+https://github.com/AEON-Project/agent-pay.git"},"publishConfig":{"access":"public"},"license":"MIT","gitHead":"14e29b50b8ca463ba2bf55b4248e2811a4834850","_id":"@aeon-ai-pay/agent-pay@0.8.8","bugs":{"url":"https://github.com/AEON-Project/agent-pay/issues"},"homepage":"https://github.com/AEON-Project/agent-pay#readme","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-4ZhejeifnkuT+HPi0LFBdZGxTnZ/jMf2i2DWqtT/WVLQ0Z7XPnkYu8Hr+1NKZ+Vjgt6jRb7sh2sD41WLJD7+3Q==","shasum":"d3fc9db8087ce6796b85fb69ef2de60a814f3756","tarball":"https://registry.npmjs.org/@aeon-ai-pay/agent-pay/-/agent-pay-0.8.8.tgz","fileCount":20,"unpackedSize":124719,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGqubGoJ9R95qXbDKYBgbola6ojZFGv4PH958P7G80utAiEAgvSvN6RtEeLB5v7OZkd6WHgmjaTVtDEegJwYOcjYjgQ="}]},"_npmUser":{"name":"aeon_project","email":"code@alchemypay.org"},"directories":{},"maintainers":[{"name":"aeon_project","email":"code@alchemypay.org"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-pay_0.8.8_1778059434565_0.6742070783464831"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-06T07:38:37.650Z","modified":"2026-05-06T09:23:54.844Z","0.8.5":"2026-05-06T07:38:37.898Z","0.8.6":"2026-05-06T08:01:20.328Z","0.8.7":"2026-05-06T09:10:58.532Z","0.8.8":"2026-05-06T09:23:54.722Z"},"bugs":{"url":"https://github.com/AEON-Project/agent-pay/issues"},"license":"MIT","homepage":"https://github.com/AEON-Project/agent-pay#readme","keywords":["agent-skills","x402","ai-image","image-generation","crypto-payment","evm","bsc"],"repository":{"type":"git","url":"git+https://github.com/AEON-Project/agent-pay.git"},"description":"Agent skill & CLI for AI image generation, paid via x402 protocol with USDT on BSC","maintainers":[{"name":"aeon_project","email":"code@alchemypay.org"}],"readme":"# agent-pay\n\nAn Agent skill & CLI for **AI image generation**, paid per-request via the [x402 protocol](https://www.x402.org/) with USDT on BSC.\n\nThe user supplies a prompt; the CLI handles wallet setup, x402 payment, and returns the generated image.\n\n## Install Skill\n\n```bash\n# Install to all detected agents (Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, etc.)\nnpx skills add AEON-Project/agent-pay -g -y\n\n# Install to specific agents\nnpx skills add AEON-Project/agent-pay -a claude-code -a cursor -a codex -g -y\n```\n\nSupported agents: Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, GitHub Copilot, Windsurf, Roo Code, and [39+ more](https://agentskills.io).\n\n## CLI Usage\n\n```bash\n# First run: auto-create local wallet (private key generated locally, never uploaded)\nnpx @aeon-ai-pay/agent-pay setup --check\n\n# Generate an image (auto-funds via WalletConnect when balance is insufficient)\n# On success, every image in the response is downloaded to ~/agent-pay-images/\nnpx @aeon-ai-pay/agent-pay generate --prompt \"a cyberpunk fox under neon rain\"\n\n# Choose aspect ratio / output format / model (defaults shown)\nnpx @aeon-ai-pay/agent-pay generate \\\n  --prompt \"An orange tabby cat playing in the snow, cinematic lighting\" \\\n  --aspect-ratio 16:9 \\\n  --output-format png \\\n  --model replicate/black-forest-labs/flux-schnell\n\n# Save downloads to a custom directory\nnpx @aeon-ai-pay/agent-pay generate --prompt \"...\" --output ./out\n\n# Check wallet balance (BNB + USDT)\nnpx @aeon-ai-pay/agent-pay wallet\n\n# Manually top up USDT to local wallet\nnpx @aeon-ai-pay/agent-pay topup --amount 1\n\n# Top up BNB gas for local wallet\nnpx @aeon-ai-pay/agent-pay gas --amount 0.001\n\n# Withdraw remaining funds (USDT + BNB) back to main wallet\nnpx @aeon-ai-pay/agent-pay withdraw\n\n# Show current configuration\nnpx @aeon-ai-pay/agent-pay setup --show\n\n# Uninstall skill and clear cache\nnpx @aeon-ai-pay/agent-pay clean\n```\n\n## Prerequisites\n\n- Node.js >= 18\n- A mobile wallet app with WalletConnect support (MetaMask, OKX Wallet, Trust Wallet, etc.)\n- USDT (BEP-20) on BSC for image-generation payments\n- A small amount of BNB for approve gas (~$0.002/tx, only needed on first authorization)\n\n## How It Works\n\n```\n1. CLI auto-generates a session key (disposable wallet) locally\n2. On generate, if balance is insufficient, auto-funds via WalletConnect QR scan (USDT + BNB gas)\n   - Top-up amount = exactly the shortfall (requiredUsdt - currentBalance)\n3. First use requires a one-time approve authorization (unlimited allowance, no repeat needed)\n4. Session key auto-signs the x402 payment — no manual confirmation required\n5. Server returns the generated image (URLs); CLI downloads each, reads dimensions/size\n\nAgent flow:\n  User prompt -> Agent activates skill -> x402 two-phase protocol:\n    1. GET /open/ai/x402/skillBoss/create?body=<urlencoded JSON>\n       (decoded: { model, inputs: { prompt, aspect_ratio, output_format } })\n                                              -> HTTP 402 + payment requirements\n    2. Session key EIP-712 signature, retry same URL with PAYMENT-SIGNATURE header\n                                              -> HTTP 200, { transaction, data: { images } }\n    3. CLI downloads each images[].url to ~/agent-pay-images/, parses\n       PNG/JPEG/WebP headers for width × height, fs.stat for size\n```\n\n## Pricing\n\n- Per-call USDT amount is **decided by the server** in the 402 response — not hardcoded client-side.\n- The wallet is charged exactly that amount. Top-up covers exactly the shortfall (`requiredUsdt - currentBalance`).\n\n## Configuration\n\nConfig is stored in `~/.agent-pay/config.json` (file permissions 600).\n\nRun `setup --check` to auto-generate a local wallet. The main wallet private key is **never** stored locally — only the session key (a locally generated disposable wallet) is saved. Funding is done via WalletConnect QR scan.\n\nOverride the default service URL (optional):\n```bash\nnpx @aeon-ai-pay/agent-pay setup --service-url https://custom-api.example.com\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}