{"_id":"@arcpaylabs/somnia-x402-agent-starter","_rev":"5-5e45b3ebd67b4e470ad7efd5b2cd3430","name":"@arcpaylabs/somnia-x402-agent-starter","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@arcpaylabs/somnia-x402-agent-starter","version":"0.1.0","author":{"name":"Henry Sammarfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-x402-agent-starter@0.1.0","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"00853bf368cd9b29d50d6dafc2e5ef84d9a23b20","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-x402-agent-starter/-/somnia-x402-agent-starter-0.1.0.tgz","fileCount":5,"integrity":"sha512-HmysYImiZ8ft7wGRCckWXCPIekDE5K7L3trJgH76uYKSD1NyOzHggCM6yT5btlx5V7kunAlARD/jk8SeDfxZUw==","signatures":[{"sig":"MEYCIQDHor4KhKRoTJfzZmxnq+tqcWJGn6MGoOAxjmQvb51mrgIhAMC2r+a4NH4XMRU6xXEkk1KFaKySGUQwAIDynrdSRYkJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5679},"type":"module","gitHead":"f677a172886b4c9c4e4e2dae93836c858d143e8e","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-somnia.git","type":"git","directory":"starter-kits/somnia-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Somnia 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/somnia-x402-agent-starter_0.1.0_1779953417342_0.26642488258655894","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arcpaylabs/somnia-x402-agent-starter","version":"0.1.1","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-x402-agent-starter@0.1.1","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"85b0794f478998d592c6341352cc72fd18469a2e","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-x402-agent-starter/-/somnia-x402-agent-starter-0.1.1.tgz","fileCount":5,"integrity":"sha512-U8pdKoieEeB6s08B4FYYZCDvDJG303hZtmp1jhyGEKJ/eWA2piEpODBdX3K9K6PmLu5OhlFAfD32z269t1pSrA==","signatures":[{"sig":"MEQCIBFQA4jbXWd9leHX+F1yYkVVX29fEkU9AG05fFl1HpPZAiBsZvpsaH8r2MzFmOdUvNog7n0U8g6nmu4GovM38KFX1w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5681},"type":"module","gitHead":"b258e5e74e138c12e4050aeb09fea773308bc748","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-somnia.git","type":"git","directory":"starter-kits/somnia-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Somnia 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/somnia-x402-agent-starter_0.1.1_1779968273521_0.3669979977030089","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@arcpaylabs/somnia-x402-agent-starter","version":"0.1.2","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-x402-agent-starter@0.1.2","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"2327db5145aa391d3f85398f87cfae516416c497","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-x402-agent-starter/-/somnia-x402-agent-starter-0.1.2.tgz","fileCount":5,"integrity":"sha512-n0UhxWTZs/Tf8eYSFtmYufKRZF+/Ss9dF9iLpPK3+FsoGhVPOk98YSXb84QHqmbsbnqUa9vSyfQXgqHRVRTqbA==","signatures":[{"sig":"MEUCICKXuUfr/QCQk4LWJKpRplI3LYGOGtC1OU6rzzML+DblAiEA0X4eFvVc943iJqCWVQcUS2nggy2gDCEM9uCEqojuXlk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5711},"type":"module","gitHead":"16c158d558c5bd3bf27f323f02d9df9a46b98eb8","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-somnia.git","type":"git","directory":"starter-kits/somnia-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Somnia 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/somnia-x402-agent-starter_0.1.2_1780356348465_0.25288185666402674","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@arcpaylabs/somnia-x402-agent-starter","version":"0.1.3","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","_id":"@arcpaylabs/somnia-x402-agent-starter@0.1.3","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"bin":{"arcpay-somnia-x402-agent":"src/agent-client.mjs"},"dist":{"shasum":"78b4c433431c5da026019814d251122cd35be38d","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-x402-agent-starter/-/somnia-x402-agent-starter-0.1.3.tgz","fileCount":5,"integrity":"sha512-RL3d07a0tOxAD8hKToDJ7Hl4kpoCW20PZvagZXzSyDJlgFSruvj7KTJoUOkVAzXDJuJ9t0YlirbfUn62WPt4iw==","signatures":[{"sig":"MEUCIFLNvW0N2vhIyvTVEn/+6+6++6dg4wFevrv6qWC4F6uZAiEAtyMGs5BPbUllm/HAbQTOnkAMhosvZj7nQ40Bdenp03E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5986},"type":"module","gitHead":"974a260afaf3fc456e989d1475a7578e9e2902ec","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-somnia.git","type":"git","directory":"starter-kits/somnia-x402-agent"},"_npmVersion":"11.6.0","description":"Starter client for integrating with ArcPay Somnia 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/somnia-x402-agent-starter_0.1.3_1780389390460_0.5788971725309855","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@arcpaylabs/somnia-x402-agent-starter","version":"0.1.4","private":false,"description":"Starter client for integrating with ArcPay Somnia x402 paid agent endpoints.","license":"MIT","type":"module","author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","directory":"starter-kits/somnia-x402-agent"},"bin":{"arcpay-somnia-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/somnia-x402-agent-starter@0.1.4","gitHead":"6bff146af63c125760dc31fa78e39844645bbc38","bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"_nodeVersion":"22.17.1","_npmVersion":"11.6.0","dist":{"integrity":"sha512-d/VUg+AEVPtV0kkmD+h6HOhv26CAhvBdwfBut5VPwt+xLrL0a/XMxJUlUhsETYemqfC6sS3hnvXFTcU64m2pEg==","shasum":"d6b0f6b2f06d8ad13ba793b842118da2248001cc","tarball":"https://registry.npmjs.org/@arcpaylabs/somnia-x402-agent-starter/-/somnia-x402-agent-starter-0.1.4.tgz","fileCount":5,"unpackedSize":10858,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG29vArKaEfkWbMge/VfVINxkzylvTR4e956+C5YFn47AiEAjjvRTmbczWRx2Ou9EzFShImzOak+AaBVrJ8/p/BY1B8="}]},"_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/somnia-x402-agent-starter_0.1.4_1781138685538_0.28088586650695335"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-28T07:30:17.146Z","modified":"2026-06-11T00:44:45.829Z","0.1.0":"2026-05-28T07:30:17.477Z","0.1.1":"2026-05-28T11:37:53.659Z","0.1.2":"2026-06-01T23:25:48.612Z","0.1.3":"2026-06-02T08:36:30.591Z","0.1.4":"2026-06-11T00:44:45.691Z"},"bugs":{"url":"https://github.com/ArcPayLabs/arcpay-somnia/issues"},"author":{"name":"Henry Sam Marfo","email":"jasonneil4040@gmail.com"},"license":"MIT","homepage":"https://arcpay-somnia.vercel.app/docs/x402-agent-payments","repository":{"type":"git","url":"git+https://github.com/ArcPayLabs/arcpay-somnia.git","directory":"starter-kits/somnia-x402-agent"},"description":"Starter client for integrating with ArcPay Somnia x402 paid agent endpoints.","maintainers":[{"name":"henrysammarfo","email":"jasonneil4040@gmail.com"}],"readme":"# ArcPay Somnia x402 Agent Starter\n\nThis starter is the plug-and-play client for Somnia agent builders who want to sell or consume paid agent work through ArcPay. Point it at ArcPay's live Somnia 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 SOMUSD 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, 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://x402.20.208.46.195.nip.io\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 or API endpoint and want it governed by ArcPay:\n\n```bash\nnode src/agent-client.mjs onboard research-agent https://your-agent.example/work\n```\n\nThe output includes the Somnia contract addresses, deterministic `agentId`, x402 endpoint, 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 SOMUSD 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 research-agent 0xAgentWallet\nnode src/agent-client.mjs policy research-agent 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 or a backend signer controlled by the builder.\n\nSee the main docs at:\n\n```text\nhttps://arcpay-somnia.vercel.app/docs/x402-agent-payments\n```\n","readmeFilename":"README.md"}