{"_id":"@maroo-chain/agent-wallet-kit","_rev":"6-98feb328238bb7201c9adc49ad184af0","name":"@maroo-chain/agent-wallet-kit","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@maroo-chain/agent-wallet-kit","version":"0.1.0","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage"],"author":{"name":"Hashed Open Finance"},"license":"MIT","_id":"@maroo-chain/agent-wallet-kit@0.1.0","maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"}],"homepage":"https://agent.maroo.io","bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"bin":{"m-aws":"bin/m-aws.js"},"dist":{"shasum":"3b47b5d7a8ee45a9fa88adb865b239217fb88115","tarball":"https://registry.npmjs.org/@maroo-chain/agent-wallet-kit/-/agent-wallet-kit-0.1.0.tgz","fileCount":3,"integrity":"sha512-V3C29a02sceJAG76hcX3pQWuZzmpbIuuIK3wYwehcKLOI5u4rOpSS/UuB2Wp5X4vadi1XdMWTNBkfXKOWW9ivg==","signatures":[{"sig":"MEUCIQCG16WtNbxTOXIxY4z/bSsvQFxAupMfjTjSy8bq/x8DLgIgIhuBdOX0r1G5QFZDv7UlLyN84LVPBtcHql8I3Mdtojw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3509},"type":"module","engines":{"node":">=18"},"gitHead":"98ba7f2aa590675ccb317d83d54510074dc8e928","scripts":{"build":"chmod +x bin/*.js","prepublishOnly":"npm run build && test -x bin/m-aws.js || (echo 'bin missing +x' && exit 1)"},"_npmUser":{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},"repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"_npmVersion":"10.9.2","description":"Agent Wallet Kit — umbrella for Maroo's AI agent MCPs (m-aws now, mcp coming soon)","directories":{},"_nodeVersion":"23.11.0","dependencies":{"@maroo-chain/m-aws":"^0.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-wallet-kit_0.1.0_1778063770816_0.8080697457091115","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@maroo-chain/agent-wallet-kit","version":"0.2.0","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage","umbrella"],"author":{"name":"Hashed Open Finance"},"license":"MIT","_id":"@maroo-chain/agent-wallet-kit@0.2.0","maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"}],"homepage":"https://agent.maroo.io","bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"bin":{"m-aws":"dist/bin/m-aws.js","maroo-mcp":"dist/bin/maroo-mcp.js","agent-wallet-kit":"dist/bin/agent-wallet-kit.js"},"dist":{"shasum":"e4b8a6e32492a6b7d382e6d628535e3af95afe9f","tarball":"https://registry.npmjs.org/@maroo-chain/agent-wallet-kit/-/agent-wallet-kit-0.2.0.tgz","fileCount":19,"integrity":"sha512-OF1le/alB2+3aN50PnzQAx7YyRFvGSF5tbyhxRYIKRD6cSYtFl37KjMQBZgCPWCXEaSt1jgYmt77z/bsCZtNkA==","signatures":[{"sig":"MEYCIQDE6Ej0bMNz4Fi9VrD/FlsjPuPyahX4yrW5w9vnOnbFXQIhAP2Uo0obydCKgZAnEnXvrUGb55r0wtzYA8zBS89fzs5v","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54311},"type":"module","engines":{"node":">=18"},"gitHead":"7f4c8d3140f3f67898ee8d15340514ab1c75a4e7","scripts":{"build":"tsc && chmod +x dist/bin/*.js","postinstall":"node dist/src/postinstall.js || true","prepublishOnly":"npm run build && test -x dist/bin/agent-wallet-kit.js && test -x dist/bin/m-aws.js && test -x dist/bin/maroo-mcp.js || (echo 'bin scripts missing +x' && exit 1)"},"_npmUser":{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},"repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"_npmVersion":"11.12.1","description":"Agent Wallet Kit — umbrella metapackage for Maroo's AI agent MCPs (@maroo-chain/m-aws + @maroo-chain/mcp). Install once, get both bins on PATH plus an `agent-wallet-kit init` that wires both servers into every MCP client in a single pass.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@maroo-chain/mcp":"^0.1.2","@maroo-chain/m-aws":"^0.2.8"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-wallet-kit_0.2.0_1778151405078_0.9577465949417501","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@maroo-chain/agent-wallet-kit","version":"0.2.1","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage","umbrella"],"author":{"name":"Hashed Open Finance"},"license":"MIT","_id":"@maroo-chain/agent-wallet-kit@0.2.1","maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"}],"homepage":"https://agent.maroo.io","bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"bin":{"m-aws":"dist/bin/m-aws.js","maroo-mcp":"dist/bin/maroo-mcp.js","agent-wallet-kit":"dist/bin/agent-wallet-kit.js"},"dist":{"shasum":"863a3aaaa92a044e82025a27cb58872969850b13","tarball":"https://registry.npmjs.org/@maroo-chain/agent-wallet-kit/-/agent-wallet-kit-0.2.1.tgz","fileCount":19,"integrity":"sha512-m68oBsBozVXjNP3qagqdL1FV0KczdmBcT6KSrgRbp7QsoIdzWg6eSuJefVtWu/pGif1K79xLTACIYogwUAMvxw==","signatures":[{"sig":"MEUCIQDWsG3U4BfHnFJzGuBNc6FxSXG/c0BFHD/xBLddiu5h+QIgak65tUvq5GN1ezVEHqWO7jT47PE4MwPTkISYhf+9PtY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55500},"type":"module","engines":{"node":">=18"},"gitHead":"d653cb9ed1d4ea36d41f06aa0110bdbca6b718ef","scripts":{"build":"tsc && chmod +x dist/bin/*.js","postinstall":"node dist/src/postinstall.js || true","prepublishOnly":"npm run build && test -x dist/bin/agent-wallet-kit.js && test -x dist/bin/m-aws.js && test -x dist/bin/maroo-mcp.js || (echo 'bin scripts missing +x' && exit 1)"},"_npmUser":{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},"repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"_npmVersion":"11.12.1","description":"Agent Wallet Kit — umbrella metapackage for Maroo's AI agent MCPs (@maroo-chain/m-aws + @maroo-chain/mcp). Install once, get both bins on PATH plus an `agent-wallet-kit init` that wires both servers into every MCP client in a single pass.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@maroo-chain/mcp":"^0.1.2","@maroo-chain/m-aws":"^0.2.9"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-wallet-kit_0.2.1_1780046326985_0.7133018388567041","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@maroo-chain/agent-wallet-kit","version":"0.2.2","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage","umbrella"],"author":{"name":"Hashed Open Finance"},"license":"MIT","_id":"@maroo-chain/agent-wallet-kit@0.2.2","maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"},{"name":"wonheee","email":"wonhee@delightlabs.io"}],"homepage":"https://agent.maroo.io","bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"bin":{"m-aws":"dist/bin/m-aws.js","maroo-mcp":"dist/bin/maroo-mcp.js","agent-wallet-kit":"dist/bin/agent-wallet-kit.js"},"dist":{"shasum":"ee529b575bcffc3876421ac52bd1f924977c333e","tarball":"https://registry.npmjs.org/@maroo-chain/agent-wallet-kit/-/agent-wallet-kit-0.2.2.tgz","fileCount":19,"integrity":"sha512-RPohqwMJaYyiPSY0vR6z4m28xejp2CG2fgWSpQkENyDiWBZ2yc6Zn2RSaU+OQzz7Emqxn7dxsc/6K5DcSLD7VQ==","signatures":[{"sig":"MEUCIAdzO+4D2ckB3XoMrrcxXFBmRsA9gAeKolC3rw6/OpOLAiEAxwFjGwJ/mFyWHPGdkoRDTNnZ4wduureELhIXTj2GKlI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDDe+OAQdnQGgy47mZJWf6+7FwhhLM+x6+B+0S2MJvVuQIhAMCT62nOe/qi179FIR5QqKpTxK4/C6G63FZWzrLTve8q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58707},"type":"module","_from":"file:/private/tmp/claude-501/-Users-woogieboogie-github-maroo-agents/e52899a5-fa32-4b08-895a-a470933b0c9c/scratchpad/release/dist/maroo-chain-agent-wallet-kit-0.2.2.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"npm run build && node --test dist/src/cli/*.test.js","build":"tsc && chmod +x dist/bin/*.js","postinstall":"node dist/src/postinstall.js || true","prepublishOnly":"npm run build && test -x dist/bin/agent-wallet-kit.js && test -x dist/bin/m-aws.js && test -x dist/bin/maroo-mcp.js || (echo 'bin scripts missing +x' && exit 1)"},"_npmUser":{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},"_resolved":"/private/tmp/claude-501/-Users-woogieboogie-github-maroo-agents/e52899a5-fa32-4b08-895a-a470933b0c9c/scratchpad/release/dist/maroo-chain-agent-wallet-kit-0.2.2.tgz","_integrity":"sha512-RPohqwMJaYyiPSY0vR6z4m28xejp2CG2fgWSpQkENyDiWBZ2yc6Zn2RSaU+OQzz7Emqxn7dxsc/6K5DcSLD7VQ==","repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"_npmVersion":"11.12.1","description":"Agent Wallet Kit — umbrella metapackage for Maroo's AI agent MCPs (@maroo-chain/m-aws + @maroo-chain/mcp). Install once, get both bins on PATH plus an `agent-wallet-kit init` that wires both servers into every MCP client in a single pass.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"@maroo-chain/mcp":"^0.1.2","@maroo-chain/m-aws":"^0.2.11"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-wallet-kit_0.2.2_1793504341149_0.9015653360181015","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"_id":"@maroo-chain/agent-wallet-kit@0.2.3","bin":{"m-aws":"dist/bin/m-aws.js","maroo-mcp":"dist/bin/maroo-mcp.js","agent-wallet-kit":"dist/bin/agent-wallet-kit.js"},"bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"dist":{"shasum":"63ae61204eb456eb8f8b089779d2ba80813138d7","tarball":"https://registry.npmjs.org/@maroo-chain/agent-wallet-kit/-/agent-wallet-kit-0.2.3.tgz","fileCount":19,"integrity":"sha512-YOt+kuH/sTV86G44lQWk9sCm/hpoiTDxHzxPerPXUg7ymOApoIZ0D4NJRZ0t6JuFzejSnwuhnF67xtPxA7+iSA==","signatures":[{"sig":"MEUCIQDMJzAyr/DjO1gmYdjK5m2zNT24oUDMaB7/G1GNFiznowIgXqe0BkGaDjB4aJINmDdEFWso19F/ppgfiMxhaSYRJQU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIC7PmFlnLbnADfbNGLM2fGJE4jCp6wm/ALeJTQsSyLs5AiEAmOOnUMyV0cXQh+pyWusCatIuoNwQqq9QOeVyd60fxMk="}],"unpackedSize":79316},"name":"@maroo-chain/agent-wallet-kit","type":"module","_from":"file:/private/tmp/claude-501/-Users-woogieboogie-github-maroo-agents/e52899a5-fa32-4b08-895a-a470933b0c9c/scratchpad/publish/maws/out/maroo-chain-agent-wallet-kit-0.2.3.tgz","author":{"name":"Hashed Open Finance"},"engines":{"node":">=22.12.0"},"license":"MIT","scripts":{"test":"npm run build && node --test dist/src/cli/*.test.js","build":"tsc && chmod +x dist/bin/*.js","postinstall":"node dist/src/postinstall.js || true","prepublishOnly":"npm run build && test -x dist/bin/agent-wallet-kit.js && test -x dist/bin/m-aws.js && test -x dist/bin/maroo-mcp.js || (echo 'bin scripts missing +x' && exit 1)"},"version":"0.2.3","_npmUser":{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},"homepage":"https://agent.maroo.io","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage","umbrella"],"_resolved":"/private/tmp/claude-501/-Users-woogieboogie-github-maroo-agents/e52899a5-fa32-4b08-895a-a470933b0c9c/scratchpad/publish/maws/out/maroo-chain-agent-wallet-kit-0.2.3.tgz","_integrity":"sha512-YOt+kuH/sTV86G44lQWk9sCm/hpoiTDxHzxPerPXUg7ymOApoIZ0D4NJRZ0t6JuFzejSnwuhnF67xtPxA7+iSA==","repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"_npmVersion":"11.12.1","description":"Agent Wallet Kit — umbrella metapackage for Maroo's AI agent MCPs (@maroo-chain/m-aws + @maroo-chain/mcp). Install once, get both bins on PATH plus an `agent-wallet-kit init` that wires both servers into every MCP client in a single pass. The bundled chai","directories":{},"maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"},{"name":"wonheee","email":"wonhee@delightlabs.io"}],"_nodeVersion":"25.9.0","dependencies":{"@maroo-chain/mcp":"^0.1.4","@maroo-chain/m-aws":"^0.2.12"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-wallet-kit_0.2.3_1793630779107_0.4619888056056928"}}},"time":{"created":"2026-05-06T10:36:10.710Z","modified":"2026-11-02T14:46:19.392Z","0.1.0":"2026-05-06T10:36:10.977Z","0.2.0":"2026-05-07T10:56:45.220Z","0.2.1":"2026-05-29T09:18:47.130Z","0.2.2":"2026-11-01T03:39:01.231Z","0.2.3":"2026-11-02T14:46:19.191Z"},"bugs":{"url":"https://github.com/hashed-open-finance/m-aws/issues"},"author":{"name":"Hashed Open Finance"},"license":"MIT","homepage":"https://agent.maroo.io","keywords":["mcp","model-context-protocol","ai-agent","agent-wallet","blockchain","maroo","claude","claude-code","metapackage","umbrella"],"repository":{"url":"git+https://github.com/hashed-open-finance/m-aws.git","type":"git","directory":"packages/agent-wallet-kit"},"description":"Agent Wallet Kit — umbrella metapackage for Maroo's AI agent MCPs (@maroo-chain/m-aws + @maroo-chain/mcp). Install once, get both bins on PATH plus an `agent-wallet-kit init` that wires both servers into every MCP client in a single pass. The bundled chai","maintainers":[{"name":"woogieboogieatshardlab","email":"jaewook@shardlab.com"},{"name":"nowooj","email":"joowon@delightlabs.io"},{"name":"wonheee","email":"wonhee@delightlabs.io"}],"readme":"# @maroo-chain/agent-wallet-kit\n\nUmbrella metapackage for the two Maroo agent MCPs:\n\n- [`@maroo-chain/m-aws`](https://www.npmjs.com/package/@maroo-chain/m-aws) — **wallet stack** · 22 tools (`agent.*` / `policy.*` / `transfer.*` / `faucet.*`). Stateful: AA wallets, on-chain spending policy, preflighted transfers, testnet drips.\n- [`@maroo-chain/mcp`](https://www.npmjs.com/package/@maroo-chain/mcp) — **chain knowledge + local testnet key wallet** · 12 tools (`maroo_*`). KB search, chain reads and PCL compliance previews, plus `maroo_wallet_create`, `maroo_wallet_import` and `maroo_send`, which create or import a private key and sign Maroo Testnet OKRW transfers with it. It is not read-only: see [Chain MCP keys and passphrases](#chain-mcp-keys-and-passphrases).\n\nInstall once, get both bins on PATH plus a single `agent-wallet-kit init` that wires both servers into every detected AI client config in one pass.\n\n## Install\n\nRequires Node >=22.12.0. This release requires m-aws >=0.2.12 and @maroo-chain/mcp >=0.1.4; publish both packages before publishing the Kit. Use `make verify-packages` from the repository root to test both local tarballs together before release.\n\nAfter installation, run `agent-wallet-kit init`. npm 7+ normally hides install-script output; setup does not depend on that output or on lifecycle scripts. Running `agent-wallet-kit` in a terminal shows the setup command before the command list. If the command is missing, check `npm prefix -g` and add its `bin` directory to PATH (the prefix itself on Windows).\n\n```bash\nnpm i -g @maroo-chain/agent-wallet-kit\nagent-wallet-kit init\n```\n\nAfter install, three commands are on your PATH:\n\n| Bin | What it does |\n|---|---|\n| `m-aws` | Wallet-stack MCP server + CLI (auth, doctor, TUI, etc.) |\n| `maroo-mcp` | Chain-knowledge MCP server + CLI; its wallet tools also create, import and send with a local testnet key |\n| `agent-wallet-kit` | Umbrella init / version |\n\n## What `init` does\n\n`agent-wallet-kit init` lists the standard MCP-client config surfaces: the global configs of Claude Code, Claude Desktop, Cursor, Windsurf and Gemini CLI, and the Claude Code (`.mcp.json`), Cursor (`.cursor/mcp.json`) and Gemini CLI (`.gemini/settings.json`) project configs in the current directory. That is up to 8 in a project directory, 7 when one of its configs is a link to a global one; run from your home directory, or from a dotfiles repository your global configs link into, where the Cursor and Gemini project paths are the global files, it lists 6. In a terminal it asks once for each listed client, with yes as the default when the config exists:\n\n> Register both servers with Claude Code (global)? [config exists]\n\nA client without a config is asked too, with no as the default (`[will create <path>]`); answering yes creates that file. `agent-wallet-kit init --yes` asks nothing and registers only the clients whose config already exists.\n\nFor each yes, both `mcpServers.maws` and `mcpServers.maroo` entries land in that client's config in a single atomic write. Idempotent — re-running is safe.\n\nRegister the chain MCP with `agent-wallet-kit init`. It and `m-aws init` keep `env` keys in global configs and write a symlinked global config through its target. `maroo-mcp init` comes from `@maroo-chain/mcp` and does neither: it still replaces the whole `maroo` entry, dropping its `env`, and renames over a symlinked global config, which turns a dotfiles link into a regular file. 0.1.4 creates its temp file exclusively and refuses linked project configs. 0.1.3 did neither, so a symlink planted in a cloned project could redirect its write.\n\n## Chain MCP keys and passphrases\n\nThe chain MCP that `init` registers as `mcpServers.maroo` takes secrets as ordinary tool arguments:\n\n| Tool | Secret arguments | What it does |\n|---|---|---|\n| `maroo_wallet_create` | `passphrase` | Generates a private key and saves it, encrypted with the passphrase, under `~/.maroo/keystore` |\n| `maroo_wallet_import` | `privateKey`, `passphrase` | Imports a raw private key into that keystore |\n| `maroo_send` | `passphrase` | Decrypts the key, then signs and broadcasts a Maroo Testnet OKRW transfer |\n\nTool arguments are written by the model, so the model provider sees every private key and passphrase passed to these tools, and the MCP client keeps them in the conversation transcript. Import only a disposable testnet key, never one that controls funds on another network, and never reuse a passphrase from elsewhere. The m-aws wallet tools (`mcpServers.maws`) take no private keys or passphrases; WaaS signs for agents. To register only m-aws, run `m-aws init` instead of `agent-wallet-kit init`, or remove the `maroo` entry from the client configuration.\n\n## Subcommand reference\n\n```bash\nagent-wallet-kit init        # wire both servers into AI clients\nagent-wallet-kit version     # kit + subpackage versions\nagent-wallet-kit --help      # usage screen\n\n# subpackage CLIs:\nm-aws init                   # register only the wallet stack, multi-client\nm-aws doctor                 # auth + RPC + balance + TUI binary\nm-aws --help                 # full wallet-stack surface\nmaroo-mcp doctor             # KB + RPC + PCL + version\n```\n\n## Update\n\n```bash\nnpm i -g @maroo-chain/agent-wallet-kit@latest\n```\n\nThe kit requires `@maroo-chain/m-aws ^0.2.12` and `@maroo-chain/mcp ^0.1.4`. Compatible updates are resolved when npm installs or updates the kit. To pin individual subpackages, install them directly instead:\n\n```bash\nnpm i -g @maroo-chain/m-aws@0.2.12\nnpm i -g @maroo-chain/mcp@0.1.4\n```\n\n## License\n\nMIT. © Hashed Open Finance.\n\n`init` registers `m-aws serve` when a recognized installed bin is on PATH. Otherwise it pins the installed package version in `npx -y @maroo-chain/m-aws@<version> serve`. Kit also pins its chain MCP dependency when no `maroo-mcp` bin is installed. A pinned client keeps that version when the Kit is reinstalled, so rerun `agent-wallet-kit init` after upgrading; `m-aws doctor` lists m-aws pins older than the installed m-aws and `@maroo-chain/mcp` pins before 0.1.4. Rerunning init on an existing entry in a global config updates its command and arguments but keeps its `env` keys (for example a per-profile `MAROO_CONFIG_DIR` or a custom `MAROO_RPC_URL`); init sets only `MAROO_CONFIG_DIR`, and only when the shell running init has it, and the summary names the kept keys. In a project config (`.mcp.json`, `.cursor/mcp.json`, `.gemini/settings.json`) init replaces the whole entry and keeps no `env`, because a cloned repository controls that file and keys such as `NODE_OPTIONS` or `PATH` would run its code in the wallet server; to keep a per-profile project entry, run init from a shell with `MAROO_CONFIG_DIR` set. Restart the MCP client after changing these settings.\n\nA global client config that is a symlink (for example into a dotfiles repository) is updated through its target, so the link stays in place, and an existing config keeps its file mode. A symlinked project config (`.mcp.json`, `.cursor/mcp.json`, `.gemini/settings.json`) is refused and left unchanged, because a cloned repository controls that directory, unless it links to one of your global configs: that file is then handled once, as the global config. So is a project config that is a hard link to a global one; the write replaces the global file, though, so the hard link is split and a later init treats the project copy as a project config. A project config in a `.cursor` or `.gemini` directory that is itself a link is refused too, even when the link stays inside the project (for example a monorepo package's `.cursor` linked to the root's), so init never writes through it. The message names the linked directory and, when it links to another project's `.cursor` or `.gemini`, the directory to run init from instead; `init --yes` then exits 1 with \"Registration incomplete\" after writing the other clients. The exception is a directory that links to your home's `.cursor` or `.gemini`: the config is then your global one, handled once. init uses the physical working directory (`process.cwd()`): run from a path that goes through a link, it registers the project at its real path, which it prints as the working directory. In your home directory, or in a dotfiles repository your global configs link into, `.cursor/mcp.json` and `.gemini/settings.json` are the global Cursor and Gemini configs, so init run there handles each file once, as a global config: it keeps the entries' `env` and writes through a symlink.\n\nChoose one global package: `@maroo-chain/agent-wallet-kit` already supplies `m-aws`, so installing standalone `@maroo-chain/m-aws` alongside it causes a bin collision. `m-aws update` detects the owner of the command you launched and upgrades that package (Kit or standalone). To switch, uninstall the old package first, then install the other; avoid `--force` overwrites.\n\n### Paired patch releases\n\nEvery m-aws patch release must be followed by a Kit version bump that requires that m-aws patch. Publish m-aws, and any `@maroo-chain/mcp` version the Kit's range requires, first, then Kit. The Kit-owned `m-aws update` compares the Kit package version. When the Kit is already current, it also compares the bundled m-aws with the latest m-aws release and, if the bundled one is older, prints the reinstall command `npm install -g @maroo-chain/agent-wallet-kit@latest`, which picks up an m-aws patch within the Kit's dependency range. Installations whose bundled m-aws is 0.2.11 or older do not run that check, so a wallet patch without a Kit bump stays invisible to them. Verify the bundled m-aws version with `agent-wallet-kit version` after updating.\n","readmeFilename":"README.md"}