{"_id":"@arcisprotocol/game-plugin-arcis","name":"@arcisprotocol/game-plugin-arcis","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@arcisprotocol/game-plugin-arcis","version":"1.0.0","description":"GAME (Virtuals) plugin for Arcis — give any GAME agent a treasury. Earn yield on idle USDC, check positions, borrow against reputation, and manage capital on Base mainnet.","type":"module","main":"dist/index.js","module":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsup src/index.ts --format esm --dts --clean","typecheck":"tsc --noEmit"},"keywords":["virtuals","game","game-by-virtuals","arcis","defi","treasury","yield","ai-agents","base","plugin"],"author":{"name":"Arcis Protocol"},"license":"MIT","peerDependencies":{"@virtuals-protocol/game":">=0.1.0"},"dependencies":{"@arcisprotocol/sdk":"^1.0.0","viem":"^2.21.0"},"devDependencies":{"@virtuals-protocol/game":"^0.1.8","tsup":"^8.0.0","typescript":"^5.4.0"},"homepage":"https://github.com/Arcis-Protocol/integrations/tree/main/typescript/game-plugin-arcis#readme","repository":{"type":"git","url":"git+https://github.com/Arcis-Protocol/integrations.git","directory":"typescript/game-plugin-arcis"},"bugs":{"url":"https://github.com/Arcis-Protocol/integrations/issues"},"_id":"@arcisprotocol/game-plugin-arcis@1.0.0","gitHead":"337f72d40442f9ae0f7cccdb1b17bc260163a7a2","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-kA/cQgnXghXPkb+EK5RQ+1j6ihvBiOBpM/iqJ2Qs2MEJdp84iFG3eMFik1Xrp4MSfNQhu0EZyUpDcVIoqLno6g==","shasum":"ae5e9852638fb1b1e76a1bc99921c1c74c72015a","tarball":"https://registry.npmjs.org/@arcisprotocol/game-plugin-arcis/-/game-plugin-arcis-1.0.0.tgz","fileCount":4,"unpackedSize":18586,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDz9J5QzubTrrYsSp1hRkc3lDRxhyM4bxnTLVEqqI1MSAiAw8bsnHW9jfVIZDIR26Zo3OH6FlvuZov/VqBjJ34GViQ=="}]},"_npmUser":{"name":"brandononchain","email":"brandononchain@gmail.com"},"directories":{},"maintainers":[{"name":"brandononchain","email":"brandononchain@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/game-plugin-arcis_1.0.0_1783107583761_0.18673817773913015"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-03T19:39:43.669Z","1.0.0":"2026-07-03T19:39:43.902Z","modified":"2026-07-03T19:39:44.054Z"},"maintainers":[{"name":"brandononchain","email":"brandononchain@gmail.com"}],"description":"GAME (Virtuals) plugin for Arcis — give any GAME agent a treasury. Earn yield on idle USDC, check positions, borrow against reputation, and manage capital on Base mainnet.","homepage":"https://github.com/Arcis-Protocol/integrations/tree/main/typescript/game-plugin-arcis#readme","keywords":["virtuals","game","game-by-virtuals","arcis","defi","treasury","yield","ai-agents","base","plugin"],"repository":{"type":"git","url":"git+https://github.com/Arcis-Protocol/integrations.git","directory":"typescript/game-plugin-arcis"},"author":{"name":"Arcis Protocol"},"bugs":{"url":"https://github.com/Arcis-Protocol/integrations/issues"},"license":"MIT","readme":"# @arcisprotocol/game-plugin-arcis\n\nA [GAME](https://docs.game.virtuals.io/) (Virtuals Protocol) plugin that gives any GAME agent a **treasury** on Base mainnet.\n\nYour agent can earn yield on idle USDC, check its position, discover agent-token vaults, and read its credit terms — through the Arcis Agent Treasury Interface, no human in the loop.\n\n> Where it fits: agent-payment rails like **x402** let your agent *earn* USDC. Arcis is where that idle USDC *works* — same asset, same chain, instantly withdrawable when the agent needs to spend again.\n\n## Install\n\n```bash\nnpm install @arcisprotocol/game-plugin-arcis @virtuals-protocol/game\n```\n\n## Usage\n\n```ts\nimport { GameAgent } from \"@virtuals-protocol/game\";\nimport { ArcisPlugin } from \"@arcisprotocol/game-plugin-arcis\";\n\nconst arcis = new ArcisPlugin({\n  privateKey: process.env.AGENT_PK as `0x${string}`, // omit for read-only\n});\n\nconst agent = new GameAgent(process.env.GAME_API_KEY!, {\n  name: \"Treasury Agent\",\n  goal: \"Keep idle USDC earning yield; withdraw when funds are needed\",\n  description: \"An agent that manages its own capital via Arcis on Base\",\n  workers: [arcis.getWorker()],\n});\n\nawait agent.init();\nawait agent.run();\n```\n\nThat's it — the agent now has one worker (`Arcis Treasury Worker`) exposing five functions.\n\n## Functions\n\n| Function | What it does | Writes? |\n|---|---|---|\n| `deposit_idle_usdc` | Deposit idle USDC into the Arcis vault to earn yield (auto-approves). Omit amount to deposit the full idle balance. | ✅ |\n| `withdraw_from_treasury` | Withdraw USDC back to the wallet. Omit amount / say \"all\" for the full position. Instant. | ✅ |\n| `check_treasury_position` | Read position value, shares, and live vault APY. | — |\n| `list_agent_vaults` | List all agent-token vaults in the factory registry (e.g. `$CUSTOS`). | — |\n| `get_credit_terms` | Read ERC-8004 reputation tiers and lending-pool size. | — |\n\nThe worker's `getEnvironment()` also surfaces the live vault APY, the agent's treasury value, and its idle USDC balance into the agent's state each planning cycle — so the agent *sees* when it has idle capital to put to work.\n\n## Options\n\n```ts\nnew ArcisPlugin({\n  privateKey,        // 0x-prefixed agent wallet key. Omit → read-only (reads still work).\n  rpcUrl,            // defaults to https://mainnet.base.org\n  id, name, description, // override the worker identity if you want\n});\n```\n\n## Read-only mode\n\nOmit `privateKey` and the read functions (`check_treasury_position`, `list_agent_vaults`, `get_credit_terms`) still work — useful for monitoring or research agents. Deposit/withdraw will return a clear \"no wallet configured\" result.\n\n## Network\n\nBase mainnet (chain `8453`). USDC vault: `0x00325d9da832b38179ed2f0dabd4062d93e325a7`. Full contract list and protocol docs: [arcis.money](https://arcis.money) · [github.com/Arcis-Protocol](https://github.com/Arcis-Protocol)\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-217a708f1d516e0722fa28880d4dd9c4"}