{"_id":"402bot","_rev":"5-320b86471d9c2adfa191b1d7ae7074c2","name":"402bot","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"402bot","version":"0.1.0","keywords":["402bot","x402","mcp","base","usdc","cli"],"license":"UNLICENSED","_id":"402bot@0.1.0","maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"homepage":"https://github.com/sam00101011/402bot-cli","bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"bin":{"402bot":"index.js"},"dist":{"shasum":"67bc42f84fe39836f3cb5d2b54c8cede9bbc8a03","tarball":"https://registry.npmjs.org/402bot/-/402bot-0.1.0.tgz","fileCount":3,"integrity":"sha512-8v7XP+WGeVHw3uiphpFeuFsCxNBvbSOCOKfBFyUewxtGQn72YQSa6ABGoPKoQCQ6NfWmFnElTW+KMli+YxXq7A==","signatures":[{"sig":"MEUCICWHFrzkmuS3X8NVx7u8h4FKveaHehv18l1hafa/b5gBAiEAsFPioqFXIj7q8rOgZgDluopkBEhiYsoZh2bgePZCByE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/402bot@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":12192},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"a8e313631753f4c49583dc7a496d5a76f5cc86a8","scripts":{"test":"bun test tests/402bot-cli.test.ts"},"_npmUser":{"name":"sam00101011","email":"zeller.bucket@gmail.com"},"repository":{"url":"git+https://github.com/sam00101011/402bot-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"402.bot CLI powered by x402-proxy","directories":{},"_nodeVersion":"22.22.1","dependencies":{"x402-proxy":"^0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/402bot_0.1.0_1773405650904_0.8151561093795956","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"402bot","version":"0.2.0","keywords":["402bot","x402","mcp","base","usdc","cli"],"license":"UNLICENSED","_id":"402bot@0.2.0","maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"homepage":"https://github.com/sam00101011/402bot-cli","bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"bin":{"402bot":"index.js"},"dist":{"shasum":"5bfedc1942046a75ce9f163a1220a9771508c2b7","tarball":"https://registry.npmjs.org/402bot/-/402bot-0.2.0.tgz","fileCount":3,"integrity":"sha512-5BpomRhMESRzQ+FAsp913XCPLa55rVT+B0DPVzwGuRF7zmiYq3DwmkzRlLxxvQddNkTF2BIyKQZys268tGrbww==","signatures":[{"sig":"MEUCIQC4fzcJNFoIMmuG460CTQeDybhKTGRl5+4rbhco09HXSAIgH8TWIQX2zyCiWHn1vKeEZgLp7NnkVBafWrk45XkWrdY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/402bot@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":62637},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"998a1ffbe33eb74aeb5b3cad1e1801370f1665be","scripts":{"test":"bun test tests/402bot-cli.test.ts"},"_npmUser":{"name":"sam00101011","email":"zeller.bucket@gmail.com"},"repository":{"url":"git+https://github.com/sam00101011/402bot-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"402.bot CLI powered by x402-proxy","directories":{},"_nodeVersion":"22.22.0","dependencies":{"x402-proxy":"^0.3.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/402bot_0.2.0_1773406919504_0.7688366783993195","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"402bot","version":"0.3.0","keywords":["402bot","x402","mcp","base","usdc","cli"],"license":"UNLICENSED","_id":"402bot@0.3.0","maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"homepage":"https://github.com/sam00101011/402bot-cli","bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"bin":{"402bot":"index.js"},"dist":{"shasum":"f3e707e74d7e1fbd37881755a9fa131bb7d9cedc","tarball":"https://registry.npmjs.org/402bot/-/402bot-0.3.0.tgz","fileCount":4,"integrity":"sha512-l4S5UJTi7YHpjHcG1iAiXAClwNw9Y/xWWvJ4MCTDyv53J2MDmGPuArx25tFOImcjLZfMPNnuDPUHY0PeIUPm/w==","signatures":[{"sig":"MEUCIQDR3Q1pg7fRtJ3ytUEY8lekMt0MXN/zjK6IVX8yw5AmBgIgH4SzxDO0t569P7pVj/ziPMYYLBdLH12VWF0Bm4zPj20=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/402bot@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":145090},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"d74bdfd75bf418f0a91906c8a9a2674dd1fa2429","scripts":{"test":"bun test tests/402bot-cli.test.ts"},"_npmUser":{"name":"sam00101011","email":"zeller.bucket@gmail.com"},"repository":{"url":"git+https://github.com/sam00101011/402bot-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"402.bot CLI powered by x402-proxy","directories":{},"_nodeVersion":"22.22.0","dependencies":{"viem":"^2.47.0","yaml":"^2.8.2","x402-proxy":"^0.4.1","@scure/base":"^2.0.0","@scure/bip32":"^2.0.1","@scure/bip39":"^2.0.1","@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/402bot_0.3.0_1773425120222_0.39820382181767533","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"402bot","version":"0.3.1","keywords":["402bot","x402","mcp","base","usdc","cli"],"license":"UNLICENSED","_id":"402bot@0.3.1","maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"homepage":"https://github.com/sam00101011/402bot-cli","bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"bin":{"402bot":"index.js"},"dist":{"shasum":"f438144ebfa9a2d972c2eb424f7ceaf7c3cc84e1","tarball":"https://registry.npmjs.org/402bot/-/402bot-0.3.1.tgz","fileCount":4,"integrity":"sha512-QIqcez7VEUMpXxM46i8jtz466qBKANFzvRBh552XBz9kry5wbNLiQV3ptdfpwbo2Hg+GUzim/l8o88ANWkYOtA==","signatures":[{"sig":"MEUCIQDo0HXEcS8JrWj/lPr/1qksh6pfxJMkA2H79LB1na2dMwIgfAImAo9HnDWUrTAHaG0/LHa/OHI166foVXbAxSaMllc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/402bot@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":145022},"type":"module","engines":{"node":">=22.0.0"},"gitHead":"0e3a091095c4416ad32a522abfa9b777506c979e","_npmUser":{"name":"sam00101011","email":"zeller.bucket@gmail.com"},"repository":{"url":"git+https://github.com/sam00101011/402bot-cli.git","type":"git"},"_npmVersion":"10.9.4","description":"402.bot CLI powered by x402-proxy","directories":{},"_nodeVersion":"22.22.1","dependencies":{"viem":"^2.47.0","yaml":"^2.8.2","x402-proxy":"^0.4.1","@scure/base":"^2.0.0","@scure/bip32":"^2.0.1","@scure/bip39":"^2.0.1","@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/402bot_0.3.1_1773549984919_0.07719006970514664","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"402bot","version":"0.4.0","description":"402.bot CLI powered by x402-proxy","type":"module","bin":{"402bot":"index.js"},"keywords":["402bot","x402","mcp","base","usdc","cli"],"homepage":"https://github.com/sam00101011/402bot-cli","bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"repository":{"type":"git","url":"git+https://github.com/sam00101011/402bot-cli.git"},"publishConfig":{"access":"public"},"license":"UNLICENSED","dependencies":{"@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1","@scure/base":"^2.0.0","@scure/bip32":"^2.0.1","@scure/bip39":"^2.0.1","viem":"^2.47.0","x402-proxy":"^0.4.1","yaml":"^2.8.2"},"engines":{"node":">=22.0.0"},"_id":"402bot@0.4.0","gitHead":"aa48974a06d42c1a76a575a6d0bd86e180fa59dc","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-hguf9rzJ6E38e7sNbQZy7zfOaq9wihXVXao3QkUAXZsyRR6065GrhazBjXFgCR5/XYCGj1U+E2ZIfBh/dTmanA==","shasum":"0f9866980d30dbaa5319edeacea37e5e561e1d19","tarball":"https://registry.npmjs.org/402bot/-/402bot-0.4.0.tgz","fileCount":4,"unpackedSize":221065,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/402bot@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCOCW0GuqwskQQpjvkEpfV37qNitmd+VKFWmRLeIKffwwIgJsAk5lG/a1AbTxATlY/b4A/wByDzYWGJyhEWXgZ8a0k="}]},"_npmUser":{"name":"sam00101011","email":"zeller.bucket@gmail.com"},"directories":{},"maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/402bot_0.4.0_1773733605525_0.020496142332325107"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-13T12:40:50.790Z","modified":"2026-03-17T07:46:46.293Z","0.1.0":"2026-03-13T12:40:51.041Z","0.2.0":"2026-03-13T13:01:59.656Z","0.3.0":"2026-03-13T18:05:20.384Z","0.3.1":"2026-03-15T04:46:25.088Z","0.4.0":"2026-03-17T07:46:45.678Z"},"bugs":{"url":"https://github.com/sam00101011/402bot-cli/issues"},"license":"UNLICENSED","homepage":"https://github.com/sam00101011/402bot-cli","keywords":["402bot","x402","mcp","base","usdc","cli"],"repository":{"type":"git","url":"git+https://github.com/sam00101011/402bot-cli.git"},"description":"402.bot CLI powered by x402-proxy","maintainers":[{"name":"sam00101011","email":"zeller.bucket@gmail.com"}],"readme":"# 402bot\n\n`402bot` is a product CLI for `402.bot`, backed by [`x402-proxy`](https://github.com/cascade-protocol/x402-proxy).\n\nIt keeps wallet setup, x402 payment handling, MCP proxying, and spend history from `x402-proxy`, but adds higher-level commands for discovery, inspection, config defaults, docs crawls, wallet dossiers, market workflows, and agent setup.\n\n## Setup, Config, And History\n\n```bash\n402bot setup\n402bot status\n402bot doctor\n402bot wallet\n402bot config get\n402bot config set campaign-id codex-mcp-setup\n402bot config set spend-cap 2\n402bot spend --since 7d\n402bot history --since 7d --json\n402bot completion zsh\n```\n\n## Discovery And Agent Operations\n\n```bash\n\n402bot mcp --campaign-id defi-agent-alpha\n\n402bot discover \"find the best live Base wallet-intelligence or risk API for an autonomous trading agent\"\n402bot discover \"best Base treasury API\" --max-price 0.02 --freshness 6h --trust observed --requires-mcp\n402bot inspect weather-alpha\n402bot inspect 0x1111111111111111111111111111111111111111\n402bot compare \"find the best live Base treasury monitoring API\"\n\n402bot recipe list\n402bot recipe search \"polymarket\"\n402bot recipe inspect dune-onchain-brief\n402bot recipe inspect crypto-market-opening-bell\n402bot recipe inspect category-opening-bell\n402bot recipe inspect sector-rotation-watch\n402bot recipe inspect defi-yield-shortlist\n402bot recipe inspect hyperliquid-funding-crowding-watch\n402bot recipe inspect snapshot-governance-watch\n402bot recipe inspect paraswap-route-brief\n402bot recipe inspect jupiter-route-brief\n402bot recipe inspect liquid-staking-scorecard\n402bot recipe inspect lst-exchange-rate-watch\n402bot recipe inspect lst-premium-vs-yield-brief\n402bot recipe inspect cex-dislocation-watch\n402bot recipe inspect paraswap-vs-jupiter-execution-brief\n402bot recipe inspect crosschain-execution-board\n402bot recipe recommend \"best treasury watch workflow\"\n402bot providers list\n402bot providers search \"dune\"\n402bot providers inspect dune\n402bot market doctor\n402bot market price --ids bitcoin\n402bot --json market markets --category layer-2 --total 25\n402bot market history bitcoin --days 30\n402bot market watch --ids bitcoin,ethereum\n402bot market commands\n402bot catalog update\n402bot changelog\n402bot watch provider dune --once\n402bot export mcp-config codex\n402bot export openapi\n\n402bot prompt \"find the best live Base wallet risk API\"\n402bot plan \"monitor this wallet for treasury and prediction-market risk\"\n\n402bot init agent\n402bot init agent codex --campaign-id codex-mcp-setup\n```\n\n## Paid Execution Wrappers\n\n```bash\n402bot wallet dossier 0x1111111111111111111111111111111111111111\n402bot wallet dossier 0x1111111111111111111111111111111111111111 --profile treasury\n402bot wallet dossier 0x1111111111111111111111111111111111111111 --profile defi-risk\n402bot wallet dossier 0x1111111111111111111111111111111111111111 --profile counterparty-map --days 1\n402bot wallet dossier 0x1111111111111111111111111111111111111111 --profile prediction-markets --days 14\n\n402bot docs crawl https://docs.uniswap.org\n402bot docs crawl https://docs.uniswap.org --profile integration-notes --scope subdomains --depth 2\n\n402bot trade polymarket https://polymarket.com/event/example --outcome yes --side buy --size 5\n402bot trade polymarket us-recession-in-2026 --outcome no --side sell --amount 10 --kind market\n\n402bot run wallet-research 0x1111111111111111111111111111111111111111\n402bot run protocol-diligence https://docs.uniswap.org --question \"What are the obvious diligence gaps?\"\n402bot run market-briefing \"Polymarket election odds\" --min-likes 5\n402bot run swap-route 0x4200000000000000000000000000000000000006 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 1000000000000000000 --src-decimals 18 --dest-decimals 6 --network 8453\n402bot run jupiter-route So11111111111111111111111111111111111111112 EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000000 --slippage-bps 50\n402bot run staking-scorecard \"Compare liquid staking options for a conservative ETH treasury\"\n402bot run lst-rates --assets wsteth,reth,cbeth,weeth,sfrxeth --question \"Which LST exchange rates deserve monitoring?\"\n402bot run lst-premium \"Which ETH LSTs look mature enough for treasury collateral?\" --assets wsteth,reth,cbeth,weeth,sfrxeth\n402bot run cex-dislocation BTC --quote-asset USDT --include-funding\n402bot run paraswap-vs-jupiter 0x4200000000000000000000000000000000000006 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 1000000000000000000 So11111111111111111111111111111111111111112 EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 1000000000 --paraswap-src-decimals 18 --paraswap-dest-decimals 6\n402bot run crosschain-execution SOL USDC 1000000000 SOL --quote-asset USDT --include-funding\n402bot recipe run crypto-market-opening-bell --body '{\"input\":{\"vsCurrency\":\"usd\",\"limit\":5}}'\n402bot recipe run category-opening-bell --body '{\"input\":{\"category\":\"layer-2\",\"vsCurrency\":\"usd\",\"limit\":5}}'\n402bot recipe run sector-rotation-watch --body '{\"input\":{\"categories\":[\"artificial-intelligence\",\"layer-2\",\"real-world-assets-rwa\"],\"vsCurrency\":\"usd\",\"limitPerCategory\":5}}'\n402bot recipe run defi-yield-shortlist --body '{\"input\":{\"goal\":\"Find the best low-risk Base USDC parking opportunities.\",\"chain\":\"base\",\"stablecoinOnly\":true,\"minTvlUsd\":10000000,\"limit\":5}}'\n402bot recipe run hyperliquid-funding-crowding-watch --body '{\"input\":{\"coins\":[\"BTC\",\"ETH\"],\"sortBy\":\"fundingRate\",\"limit\":6}}'\n402bot recipe run snapshot-governance-watch --body '{\"input\":{\"question\":\"What governance votes should a DeFi operator monitor this week?\",\"spaceIds\":[\"aave.eth\",\"lido-snapshot.eth\"],\"state\":\"active\",\"limit\":6}}'\n402bot recipe run paraswap-route-brief --body '{\"input\":{\"network\":8453,\"srcToken\":\"0x4200000000000000000000000000000000000006\",\"destToken\":\"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\",\"amount\":\"1000000000000000000\",\"srcDecimals\":18,\"destDecimals\":6,\"side\":\"SELL\"}}'\n402bot recipe run jupiter-route-brief --body '{\"input\":{\"inputMint\":\"So11111111111111111111111111111111111111112\",\"outputMint\":\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\"amount\":\"1000000000\",\"slippageBps\":50}}'\n402bot recipe run liquid-staking-scorecard --body '{\"input\":{\"goal\":\"Compare liquid staking options for a conservative ETH treasury.\",\"protocols\":[\"lido\",\"rocket-pool\",\"coinbase-wrapped-staked-eth\",\"ether.fi\"],\"minTvlUsd\":50000000,\"limit\":8}}'\n402bot recipe run lst-exchange-rate-watch --body '{\"input\":{\"question\":\"Which LST exchange rates deserve monitoring?\",\"assets\":[\"wsteth\",\"reth\",\"cbeth\",\"weeth\",\"sfrxeth\"]}}'\n402bot recipe run lst-premium-vs-yield-brief --body '{\"input\":{\"goal\":\"Which ETH LSTs look mature enough for treasury collateral?\",\"assets\":[\"wsteth\",\"reth\",\"cbeth\",\"weeth\",\"sfrxeth\"],\"protocols\":[\"lido\",\"rocket-pool\",\"coinbase-wrapped-staked-eth\",\"ether.fi\",\"frax-ether\"],\"minTvlUsd\":50000000,\"limit\":10}}'\n402bot recipe run cex-dislocation-watch --body '{\"input\":{\"baseAsset\":\"BTC\",\"quoteAsset\":\"USDT\",\"includeFunding\":true}}'\n402bot recipe run paraswap-vs-jupiter-execution-brief --body '{\"input\":{\"paraswap\":{\"network\":8453,\"srcToken\":\"0x4200000000000000000000000000000000000006\",\"destToken\":\"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\",\"amount\":\"1000000000000000000\",\"srcDecimals\":18,\"destDecimals\":6},\"jupiter\":{\"inputMint\":\"So11111111111111111111111111111111111111112\",\"outputMint\":\"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\"amount\":\"1000000000\",\"slippageBps\":50}}}'\n402bot recipe run crosschain-execution-board --body '{\"input\":{\"goal\":\"Decide whether SOL execution currently looks cleaner on Jupiter or major CEX venues.\",\"solana\":{\"inputQuery\":\"SOL\",\"outputQuery\":\"USDC\",\"amount\":\"1000000000\",\"slippageBps\":50},\"cex\":{\"baseAsset\":\"SOL\",\"quoteAsset\":\"USDT\",\"includeFunding\":true}}}'\n\n402bot recipe run wallet-intel-brief --body '{\"input\":{\"walletAddress\":\"0x1111111111111111111111111111111111111111\"}}'\n402bot recipe run wallet-intel-brief --from-file ./input.json --wait --save ./output.json\n402bot route --body '{\"capability\":\"wallet-intelligence\",\"network\":\"eip155:8453\",\"strategy\":\"balanced\",\"limit\":3}'\n402bot fetch-transform --body '{\"sourceId\":\"cloudflare_crawl\",\"params\":{\"url\":\"https://docs.uniswap.org\"}}'\n```\n\n## Notes\n\n- `mcp` routes to `https://api.402.bot/mcp`\n- `config` persists `campaignId`, preferred network, spend caps, favorite wallet, and favorite recipe under `~/.config/402bot`\n- read-only discovery and analytics commands hit the public `402.bot` HTTP APIs directly\n- `discover`, `inspect`, `compare`, `doctor`, `spend`, `history`, and `completion` support stable `--json` output\n- `recipe inspect`, `providers inspect`, `catalog update`, `watch`, `export`, and `changelog` support stable `--json` output\n- `market` delegates to a local `cg` install from https://github.com/coingecko/coingecko-cli and respects global `--json` where the upstream command supports JSON output\n- paid execution commands still settle through `x402-proxy`\n- `BOT402_API_URL`, `BOT402_MCP_URL`, and `BOT402_CG_BIN` can override the defaults\n","readmeFilename":"README.md"}