{"_id":"@agent-bill/client","name":"@agent-bill/client","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agent-bill/client","version":"0.1.0","description":"Payment-enabled fetch client for AI agents (x402 protocol)","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"build":"tsc","dev":"tsc --watch"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@x402/fetch":"^2.6.0","@x402/evm":"^2.6.0","viem":"^2.47.0"},"devDependencies":{"@types/node":"^25.3.5","typescript":"^5.9.3"},"_id":"@agent-bill/client@0.1.0","gitHead":"6829db28a9b89daed20763d4960c7eb63b977230","_nodeVersion":"21.7.3","_npmVersion":"10.9.0","dist":{"integrity":"sha512-5WsSo7gkUvZ9v06i62RriUh8LGw1V48EWEyddAWV2vN+gFSnb/1gmCuXW3ja8HoC3Kut6q4hCjq/mucufpaJgQ==","shasum":"321061159ace5577091b3eb77d15001fd7b6358d","tarball":"https://registry.npmjs.org/@agent-bill/client/-/client-0.1.0.tgz","fileCount":18,"unpackedSize":8122,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH9rIuxvkRMGEPWUfIxYvzECsnZ1Z04bnOOC0VuN6ztQAiEAq+qUF6tKb3xzAGbeoeAzHCIxOGjDoAMc9tRbio+3Q4o="}]},"_npmUser":{"name":"mulandi","email":"mulandicecilia4@gmail.com"},"directories":{},"maintainers":[{"name":"mulandi","email":"mulandicecilia4@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/client_0.1.0_1775111910717_0.7044730183232488"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T06:38:30.588Z","0.1.0":"2026-04-02T06:38:30.848Z","modified":"2026-04-02T06:38:31.054Z"},"maintainers":[{"name":"mulandi","email":"mulandicecilia4@gmail.com"}],"description":"Payment-enabled fetch client for AI agents (x402 protocol)","license":"MIT","readme":"# @agent-bill/client\n\nPayment-enabled fetch client for AI agents. Drop in and any x402-compatible API accepts USDC payments from your agent automatically.\n\n## Install\n\n```bash\nnpm install @agent-bill/client\n```\n\n## Quick Start\n\n```typescript\nimport { createPayingClient } from \"@agent-bill/client\";\n\nconst client = createPayingClient({\n  privateKey: \"0xYourWalletPrivateKey\",\n  network: \"base-sepolia\",\n});\n\n// Drop-in fetch replacement — handles 402 automatically\nconst response = await client.fetch(\"https://api.example.com/data\");\n\nconst data = await response.json();\nconsole.log(data);\n```\n\n## How It Works\n\n1. Your agent calls an x402-protected endpoint\n2. Server returns `402 Payment Required` with payment details\n3. Client signs the payment authorization using your wallet\n4. Client retries the request with the payment signature\n5. Server verifies and returns the data\n\nYour agent pays in USDC on Base — no API keys, no subscriptions, no human in the loop.\n\n---\n\n## API\n\n### `createPayingClient(config)`\n\n| Field | Type | Description |\n|---|---|---|\n| `privateKey` | `0x${string}` | Wallet private key that will pay for requests |\n| `network` | `\"base-mainnet\" \\| \"base-sepolia\"` | Network to use |\n| `rpcUrl` | `string` (optional) | Custom RPC URL. Defaults to public Base RPC |\n| `baseFetch` | `typeof fetch` (optional) | Underlying fetch to wrap. Defaults to `globalThis.fetch` |\n\n### Returns `PayingClient`\n\n| Field | Type | Description |\n|---|---|---|\n| `fetch` | `(input, init?) => Promise<Response>` | Drop-in replacement for `fetch`. Handles 402 automatically |\n| `address` | `0x${string}` | Your wallet address (derived from private key) |\n\n---\n\n## Networks\n\n| Config value | Chain |\n|---|---|\n| `\"base-sepolia\"` | Base Sepolia testnet (for development) |\n| `\"base-mainnet\"` | Base mainnet (for production) |\n\n## Requirements\n\n- Wallet must hold USDC on the target network\n- Base Sepolia USDC is faucet-available for testing\n- On Base mainnet, USDC payments via permit are gasless\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-74b17d74a5ff477f5b52393db47c5ac2"}