{"_id":"@agntos/agentwallet","_rev":"5-fa8642be4ee64d16f7c4928505fd1db4","name":"@agntos/agentwallet","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.1":{"name":"@agntos/agentwallet","version":"1.0.1","keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","_id":"@agntos/agentwallet@1.0.1","maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"homepage":"https://github.com/0xArtex/agentwallet-aos#readme","bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"bin":{"agentwallet":"dist/cli.js"},"dist":{"shasum":"f88ad92330919c69f3acc75c19fed59462d0c1ae","tarball":"https://registry.npmjs.org/@agntos/agentwallet/-/agentwallet-1.0.1.tgz","fileCount":8,"integrity":"sha512-GpmD0asK6cr9XbrgYob2LcxsJo/Kke85heo0vZ6q8QVlocGWiFHUuiwcMKgfJeOsTQbiAUoYvNbGmmdKH2VliA==","signatures":[{"sig":"MEUCIAKu8hG2W4t482L3+gK65Pk0Ev6SdGryZ/iaDzysAJpqAiEA20C0Aq/VA3rUFhu6Rvx1hqJj6OIzdg07PPVWJtKhUtg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54309},"main":"./dist/sdk.js","type":"module","types":"./dist/sdk.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/sdk.d.ts","import":"./dist/sdk.js"}},"gitHead":"f150475452686a294b5e6d27b6e43cd85887cd5c","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"0xartex","email":"d7tomy0999@gmail.com"},"repository":{"url":"git+https://github.com/0xArtex/agentwallet-aos.git","type":"git","directory":"cli"},"_npmVersion":"10.9.2","description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","directories":{},"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agentwallet_1.0.1_1772806033828_0.9926079023748884","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agntos/agentwallet","version":"1.0.2","keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","_id":"@agntos/agentwallet@1.0.2","maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"homepage":"https://github.com/0xArtex/agentwallet-aos#readme","bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"bin":{"agentwallet":"dist/cli.js"},"dist":{"shasum":"2e0f56793b66281dcaaed1308fd270ed6f122410","tarball":"https://registry.npmjs.org/@agntos/agentwallet/-/agentwallet-1.0.2.tgz","fileCount":8,"integrity":"sha512-DWs+7zcqIqCgCPq3cPbBCvKrP8T8oxdihwIdOuJJ1AJaalkmIvjVpKkTbxjGXM8tcxi2c3q2pVv5FXzSwz+jVw==","signatures":[{"sig":"MEYCIQD2+fgb+rJxUqj2oL5d/LiC2ccnZs7MNgpaLx9RMdpfOwIhAP5PeLpxZQSmHmtdr8wSK5/1lXFCbAUvKQd8EsxIw6oT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agntos%2fagentwallet@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":54122},"main":"./dist/sdk.js","type":"module","types":"./dist/sdk.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/sdk.d.ts","import":"./dist/sdk.js"}},"gitHead":"dccc5fe487f2f2841ddf67cec5db6406d93b528d","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"0xartex","email":"d7tomy0999@gmail.com"},"repository":{"url":"git+https://github.com/0xArtex/agentwallet-aos.git","type":"git","directory":"cli"},"_npmVersion":"10.9.4","description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agentwallet_1.0.2_1772811050272_0.47257040000181494","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agntos/agentwallet","version":"1.0.3","keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","_id":"@agntos/agentwallet@1.0.3","maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"homepage":"https://github.com/0xArtex/agentwallet-aos#readme","bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"bin":{"agentwallet":"dist/cli.js"},"dist":{"shasum":"2b931399796b27fc5e9c98319437c25eefc9bfb5","tarball":"https://registry.npmjs.org/@agntos/agentwallet/-/agentwallet-1.0.3.tgz","fileCount":8,"integrity":"sha512-Jt6yQpZld3ODckXxvkdqDGif4g/Bjui9WCpSTixvGqbPSUr0VRG8x3JEw1Av8A/4JAnx6P1Fao7QHazGIiLJiw==","signatures":[{"sig":"MEUCIQDxrVz41aZkr7vwgI58itxn14xGsolP2jh//GRRvL8ZkgIgW+sNZZGNKBtNbQ5ocJ7vmzJi7waKtf67XB71RJ80Xgs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agntos%2fagentwallet@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":46511},"main":"./dist/sdk.js","type":"module","types":"./dist/sdk.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/sdk.d.ts","import":"./dist/sdk.js"}},"gitHead":"1b308119b499d6a8c5debe1574c50eaaf443d7cd","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"0xartex","email":"d7tomy0999@gmail.com"},"repository":{"url":"git+https://github.com/0xArtex/agentwallet-aos.git","type":"git","directory":"cli"},"_npmVersion":"10.9.4","description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@noble/hashes":"^2.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agentwallet_1.0.3_1772923549271_0.535649860512351","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@agntos/agentwallet","version":"1.1.0","keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","_id":"@agntos/agentwallet@1.1.0","maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"homepage":"https://github.com/0xArtex/agentwallet-aos#readme","bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"bin":{"agentwallet":"dist/cli.js"},"dist":{"shasum":"872652c3dfeb07234a296925786b933567594710","tarball":"https://registry.npmjs.org/@agntos/agentwallet/-/agentwallet-1.1.0.tgz","fileCount":8,"integrity":"sha512-2Q+goEYQdl9wAkRgQQfQdItFITSb3yva8BpmSFts1HkfBa/OtaeFPoRIgNEdaXvYSLAw+aEcEUQA+nXFkfao4A==","signatures":[{"sig":"MEUCIQD5j5bT6mAsXQqeuIW9XRuGva4ZyVfs/X5TRnjsx0DgjQIgdp5X4Z3W978XQhmVabpu4ouRud4/KkMR3+kEvXSP2As=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agntos%2fagentwallet@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":53188},"main":"./dist/sdk.js","type":"module","types":"./dist/sdk.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/sdk.d.ts","import":"./dist/sdk.js"}},"gitHead":"5b58f2131bdbdfdbfe970d34e8215491f02b6726","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"0xartex","email":"d7tomy0999@gmail.com"},"repository":{"url":"git+https://github.com/0xArtex/agentwallet-aos.git","type":"git","directory":"cli"},"_npmVersion":"10.9.4","description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@noble/hashes":"^2.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agentwallet_1.1.0_1772997526582_0.6901987166573094","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@agntos/agentwallet","version":"1.2.0","description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","type":"module","main":"./dist/sdk.js","types":"./dist/sdk.d.ts","bin":{"agentwallet":"dist/cli.js"},"exports":{".":{"import":"./dist/sdk.js","types":"./dist/sdk.d.ts"}},"scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/0xArtex/agentwallet-aos.git","directory":"cli"},"homepage":"https://github.com/0xArtex/agentwallet-aos#readme","engines":{"node":">=18.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7"},"dependencies":{"@noble/hashes":"^2.0.1"},"_id":"@agntos/agentwallet@1.2.0","gitHead":"049ab365c6a0b233c894469b853ec49ea909aead","bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-y4qJqiWgGYRmDBtm679SzxkBCzmmWBW2aqPfzfsv+bL4pW2AxwlVgLXbdohhEHNdltw2Ct2u4ddalZGm/3Lfuw==","shasum":"fef0073284b0f7048be02af9c0e12d5c61dba8e6","tarball":"https://registry.npmjs.org/@agntos/agentwallet/-/agentwallet-1.2.0.tgz","fileCount":8,"unpackedSize":58460,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agntos%2fagentwallet@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIG4cf9sihi1dupFJ9i68lGTd4FjbOxWUOPrUtEFbaTT7AiB/dGRiKE0xm2hnFxN81YO0v2EMJwGkAKN9QnrYTldQ9g=="}]},"_npmUser":{"name":"0xartex","email":"d7tomy0999@gmail.com"},"directories":{},"maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentwallet_1.2.0_1773070573422_0.5551938499396174"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-06T14:07:13.715Z","modified":"2026-03-09T15:36:13.991Z","1.0.1":"2026-03-06T14:07:13.981Z","1.0.2":"2026-03-06T15:30:50.433Z","1.0.3":"2026-03-07T22:45:49.423Z","1.1.0":"2026-03-08T19:18:46.723Z","1.2.0":"2026-03-09T15:36:13.567Z"},"bugs":{"url":"https://github.com/0xArtex/agentwallet-aos/issues"},"author":{"name":"AgentOS","email":"hello@agntos.dev"},"license":"MIT","homepage":"https://github.com/0xArtex/agentwallet-aos#readme","keywords":["ai","agent","wallet","smart-wallet","base","ethereum","non-custodial","passkey","webauthn","spending-limits","ai-agent","autonomous-agent","crypto","defi"],"repository":{"type":"git","url":"git+https://github.com/0xArtex/agentwallet-aos.git","directory":"cli"},"description":"Non-custodial, gas-sponsored smart wallets for AI agents on Base. Free gas, spending limits, passkey control.","maintainers":[{"name":"0xartex","email":"d7tomy0999@gmail.com"}],"readme":"# @agntos/agentwallet\n\nNon-custodial, gas-sponsored smart wallets for AI agents on Base.\n\nYour agent gets a real wallet with free gas, spending limits, and human control via FaceID — all enforced by smart contracts, not trust.\n\n```bash\nnpx @agntos/agentwallet create --agent 0xYourAgentAddress\n```\n\n## Why\n\nAI agents need to spend money. But giving an agent an unlimited wallet is terrifying.\n\n**AgentWallet** solves this:\n- **Gas-sponsored** — free gas on creation, your agent transacts immediately\n- **Hard spending limits** — $50/day, $25/tx by default, enforced on-chain\n- **Human oversight** — passkey (FaceID/YubiKey) controls limits and withdrawals\n- **Non-custodial** — agent's private key never leaves agent's machine\n\nNo custody. No trust. Architecturally impossible to steal funds.\n\n## Quick Start: From Zero to Transacting\n\n### 1. Generate a keypair\n\n```bash\nnpx @agntos/agentwallet keygen\n```\n\nThis gives you an **address** (your agent's identity) and a **private key** (signs transactions). Save the private key securely.\n\n> Already have an EVM keypair? Skip this — use your existing public address.\n\n### 2. Create a wallet\n\n```bash\n# Managed — human controls limits via FaceID/YubiKey\nnpx @agntos/agentwallet create --agent 0xYourAgentAddress\n\n# Unmanaged — fully autonomous, no human needed\nnpx @agntos/agentwallet create --agent 0xYourAgentAddress --unmanaged\n```\n\nManaged wallets return a **setup URL**. Send it to your human — one-time setup.\n\nEvery wallet gets **free gas** (~140 transactions on Base).\n\n### 3. Fund it\n\nSend ETH and/or USDC to the wallet address on **Base** (chain ID 8453).\n\n### 4. Transact\n\nYour agent calls the smart contract directly:\n\n```typescript\nimport { Wallet, Contract, JsonRpcProvider, parseEther } from 'ethers'\n\nconst provider = new JsonRpcProvider('https://base-rpc.publicnode.com')\nconst agent = new Wallet('0xYOUR_PRIVATE_KEY', provider)\n\nconst wallet = new Contract('0xYOUR_WALLET', [\n  'function execute(address to, uint256 value, bytes data) external',\n  'function executeERC20(address token, address to, uint256 amount) external',\n], agent)\n\n// Send ETH\nawait wallet.execute('0xRecipient', parseEther('0.001'), '0x')\n\n// Send USDC\nawait wallet.executeERC20(\n  '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base\n  '0xRecipient',\n  5_000_000n // 5 USDC (6 decimals)\n)\n```\n\nTransactions exceeding limits **revert instantly**. No queues, no waiting.\n\n### 5. Check status\n\n```bash\nnpx @agntos/agentwallet status 0xYourWallet\n```\n\n### 6. Need higher limits?\n\n```bash\nnpx @agntos/agentwallet limits 0xWallet --daily 200 --pertx 100\n```\n\nReturns a URL → send to human → they approve with passkey → done.\n\n## All Commands\n\n```bash\nkeygen                        # generate agent keypair\ncreate --agent 0x...          # managed wallet\ncreate --agent 0x... --unmanaged  # autonomous wallet\nstatus 0xWALLET               # wallet info + balances\nlimits 0xWALLET --daily N --pertx N  # request limit increase\ntoken-limit 0xWALLET --token 0x... --token-daily N --token-pertx N\nrm-token 0xWALLET --token 0x...  # remove token limit\npause 0xWALLET                # emergency pause\nunpause 0xWALLET              # resume\nstats                         # total wallets deployed\n```\n\nAll commands support `--json` for machine-readable output.\n\n## Contracts (Base Mainnet)\n\n| Contract | Address |\n|----------|---------|\n| Factory | [`0x77c2a63BB08b090b46eb612235604dEB8150A4A1`](https://basescan.org/address/0x77c2a63BB08b090b46eb612235604dEB8150A4A1) |\n| Implementation | [`0xEF85c0F9D468632Ff97a36235FC73d70cc19BAbA`](https://basescan.org/address/0xEF85c0F9D468632Ff97a36235FC73d70cc19BAbA) |\n\nSource: [github.com/0xArtex/agentwallet-aos](https://github.com/0xArtex/agentwallet-aos)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}