{"_id":"@arcpaylabs/arbitrum-x402-agent-starter","_rev":"3-31c764266316b8d42cacba155590933e","name":"@arcpaylabs/arbitrum-x402-agent-starter","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@arcpaylabs/arbitrum-x402-agent-starter","version":"0.1.0","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/arbitrum-x402-agent-starter@0.1.0","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-arbitrum.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-arbitrum/issues"},"bin":{"arcpay-arbitrum-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"1cf90c8b95467e471227a1a30ed9742ade5106fe","tarball":"https://registry.npmjs.org/@arcpaylabs/arbitrum-x402-agent-starter/-/arbitrum-x402-agent-starter-0.1.0.tgz","fileCount":5,"integrity":"sha512-+tc44lYN7LPZSz3CZfwDCBW9sv2ZoNK9hJz4qGWTb1mOcYoiAZMRwh+9oJzM1Gg3cyXq2YZ9bnUVM+T30tl4JA==","signatures":[{"sig":"MEUCIQC8TqUZtgTyal/be0bpDNfgi+fs3d6vg1MC74ATuESPbwIgLUh8tLRvXWV7lq2Bo5s/1oZVlArqlKOr04p1cw/NRuE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5754},"type":"module","gitHead":"e8baaa2b18e0706316768d16531e70a5f53b8def","private":false,"scripts":{"quote":"node src/agent-client.mjs quote research-agent","locked":"node src/agent-client.mjs locked research-agent","agent-id":"node src/agent-client.mjs agent-id research-agent","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-arbitrum.git","type":"git","directory":"starter-kits/arbitrum-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Arbitrum x402 paid agent endpoints.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"dotenv":"^16.4.7","ethers":"^6.13.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/arbitrum-x402-agent-starter_0.1.0_1780356377665_0.07425562982908018","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arcpaylabs/arbitrum-x402-agent-starter","version":"0.1.1","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/arbitrum-x402-agent-starter@0.1.1","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-arbitrum.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-arbitrum/issues"},"bin":{"arcpay-arbitrum-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"ab3c421eaac12d46d949da38430a10351b5ed952","tarball":"https://registry.npmjs.org/@arcpaylabs/arbitrum-x402-agent-starter/-/arbitrum-x402-agent-starter-0.1.1.tgz","fileCount":5,"integrity":"sha512-yNI09su3kbHmUUp+kivARQ4e2WZRhLSTSuHSO7XcLWi9kZsHCYqpl5vIiPikHkqZb+j1pmtidFqt0ky17HwcNg==","signatures":[{"sig":"MEYCIQDyyD6bapjHlevW/EaNl+M9jHvstfqK1GfpsZgg++D7ggIhAOiJtKanBlG1oVVsJ9GcKBpvHqBr6GKr3fy3iWbeNm4i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6046},"type":"module","gitHead":"825b57f9c5da0abe27dedcb620016223e778fac3","private":false,"scripts":{"quote":"node src/agent-client.mjs quote research-agent","locked":"node src/agent-client.mjs locked research-agent","agent-id":"node src/agent-client.mjs agent-id research-agent","pack:dry":"npm pack --dry-run"},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"overrides":{"ws":"^8.20.1"},"repository":{"url":"git+https://github.com/ArcPayLabs/arcpay-arbitrum.git","type":"git","directory":"starter-kits/arbitrum-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Arbitrum x402 paid agent endpoints.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"dotenv":"^16.4.7","ethers":"^6.13.5"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/arbitrum-x402-agent-starter_0.1.1_1780389434116_0.4394433014477912","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@arcpaylabs/arbitrum-x402-agent-starter","version":"0.1.2","private":false,"description":"Starter client for integrating with ArcPay Arbitrum x402 paid agent endpoints.","license":"MIT","type":"module","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"homepage":"https://arcpay-arbitrum.vercel.app/docs/x402-agent-payments","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-arbitrum.git","directory":"starter-kits/arbitrum-x402-agent"},"bin":{"arcpay-arbitrum-x402-agent":"src/agent-client.mjs"},"publishConfig":{"access":"public"},"scripts":{"quote":"node src/agent-client.mjs quote research-agent","locked":"node src/agent-client.mjs locked research-agent","agent-id":"node src/agent-client.mjs agent-id research-agent","pack:dry":"npm pack --dry-run"},"dependencies":{"dotenv":"^16.4.7","ethers":"^6.13.5"},"overrides":{"ws":"^8.20.1"},"_id":"@arcpaylabs/arbitrum-x402-agent-starter@0.1.2","gitHead":"11863c7b3cd372b9631af2ef5b5d8daa041dfd33","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-arbitrum/issues"},"_nodeVersion":"22.17.1","_npmVersion":"11.6.0","dist":{"integrity":"sha512-nSRk6/DpamK98jT46PkSsMeKMONaSPNZBwqUOipS+vp8Q6OYKfFTjPOXBBHAwVQGzh6i4Cgg6IC+dKBGhQcPEg==","shasum":"9b9ede5d5d8d21fed5655c86c0396879a57d56fa","tarball":"https://registry.npmjs.org/@arcpaylabs/arbitrum-x402-agent-starter/-/arbitrum-x402-agent-starter-0.1.2.tgz","fileCount":5,"unpackedSize":11289,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCv+3M4yO6azdqEGUJrvF5DeOjOGnFxak1weGuKycrNfQIgQoqorUCsj0BlY58yFijKAbVlZli37UqJwi0AVM6bqd8="}]},"_npmUser":{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"},"directories":{},"maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/arbitrum-x402-agent-starter_0.1.2_1781396647632_0.8919300283586729"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-01T23:26:17.488Z","modified":"2026-06-14T00:24:07.923Z","0.1.0":"2026-06-01T23:26:17.815Z","0.1.1":"2026-06-02T08:37:14.262Z","0.1.2":"2026-06-14T00:24:07.784Z"},"bugs":{"url":"https://github.com/ArcPayLabs/arcpay-arbitrum/issues"},"author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","homepage":"https://arcpay-arbitrum.vercel.app/docs/x402-agent-payments","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-arbitrum.git","directory":"starter-kits/arbitrum-x402-agent"},"description":"Starter client for integrating with ArcPay Arbitrum x402 paid agent endpoints.","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"readme":"# ArcPay Arbitrum x402 Agent Starter\n\nThis starter is the plug-and-play client for Arbitrum agent builders who want to sell or consume paid agent work through ArcPay. Point it at ArcPay's live Arbitrum x402 server, request a protected resource, read the HTTP 402 quote, verify an order, and unlock the result after payment evidence exists.\n\nIt covers:\n\n- reading a payment quote\n- requesting a protected agent resource\n- checking HTTP 402 requirements\n- verifying an order id\n- deriving the agent id locally\n- generating a bring-your-own-agent onboarding payload\n- generating a USDC card delegation plan\n- generating workspace/per-agent policy requirements\n- printing the evidence checklist ArcPay expects before work is marked complete\n\nIt does not hold private keys by default. Wallet payment is intentionally left to your app, operator wallet, smart account, or agent wallet so teams can plug it into their own custody model.\n\n## Setup\n\n```bash\nnpm install\ncp src/env.example .env\n```\n\n## Commands\n\n```bash\nnode src/agent-client.mjs quote research-agent\nnode src/agent-client.mjs locked research-agent\nnode src/agent-client.mjs verify 0xORDER_ID research-agent\nnode src/agent-client.mjs unlock research-agent 0xORDER_ID\nnode src/agent-client.mjs agent-id research-agent\nnode src/agent-client.mjs onboard research-agent https://your-agent.example/work\nnode src/agent-client.mjs card research-agent 0xAgentWallet\nnode src/agent-client.mjs policy research-agent 10\nnode src/agent-client.mjs evidence research-agent\n```\n\n## Live Server\n\n```text\nhttps://arcpay-arbitrum.vercel.app/api\n```\n\n## Payment Flow\n\n1. `quote` the agent slug.\n2. Create an order in `AgentOrderBook` with the quoted `agentId`, `requestUri`, and `amountWei`.\n3. Provider fulfills the order.\n4. `unlock` the resource with `orderId`.\n\n## Bring Your Own Agent\n\nUse `onboard` when you already have a Claude/Codex/custom agent, smart account, or API endpoint and want it governed by ArcPay:\n\n```bash\nnode src/agent-client.mjs onboard treasury-router https://your-agent.example/work\n```\n\nThe output includes the Arbitrum contract addresses, deterministic `agentId`, x402 endpoint, optional ERC-8004 identity context, and the exact next steps for claim-code onboarding, policy assignment, order creation, and audit evidence.\n\n## Cards and Policies\n\nUse `card` to prepare a USDC agent card without opening the dashboard. Use `policy` to generate the global workspace plus per-agent policy requirements that should be enforced before a signed action.\n\n```bash\nnode src/agent-client.mjs card treasury-router 0xAgentWallet\nnode src/agent-client.mjs policy treasury-router 10\n```\n\nThese commands generate execution plans and proof requirements. Actual card creation, top-up, spend, and policy writes still require a wallet signature, ZeroDev smart account, or backend signer controlled by the builder.\n\nSee the main docs at:\n\n```text\nhttps://arcpay-arbitrum.vercel.app/docs/x402-agent-payments\n```\n","readmeFilename":"README.md"}