--- title: "AgentWallet for Radix" url: "https://radix.wiki/developers/ai-agents/agent-wallet-ai" version: "2.1.0" updated: 2026-08-11 last_verified: 2026-08-11 license: CC-BY-4.0 license_url: "https://creativecommons.org/licenses/by/4.0/" --- # AgentWallet for Radix | | | | --- | --- | | **Type** | Programmable wallet and SDK for AI agents | | **Package** | [`wallet-agent-ai`](https://www.npmjs.com/package/wallet-agent-ai) on npm | | **Latest version** | 2.0.3 (8 June 2026) | | **Agent runtime** | LangChain / LangGraph, plus an MCP server | | **Networks** | Radix Mainnet and [Stokenet](/contents/tech/releases/stokenet) | | **First release** | 0.1.0, 4 May 2026 | ## Overview **AgentWallet for Radix** is an open-source, policy-constrained programmable wallet and SDK that lets an [AI agent](/contents/tech/core-concepts/radix-for-ai-agents) transact autonomously on [Radix](/contents/tech/core-protocols/radix-engine) – performing swaps, staking, and liquidity provision across the major DEXs, and full [Weft Finance](/ecosystem/weft-finance) operations – while on-chain rules enforce owner-defined spending limits and allowlists. It is released under the GPL-3.0 license by the developer linuxx_xrd. ## Security Model The agent never holds funds directly. The owner deploys an on-chain **PolicyVault**, funds it, and configures rules. Two [badges](/contents/tech/core-concepts/badges) are minted: an Agent Session Badge (non-transferable, held by the agent's notarizer account) and a PolicyVault Owner Badge (held by the human owner). Every transaction is checked on-chain for a valid badge, a within-limit spend, and an allowlisted destination or protocol before it can execute. ## Capabilities Version 2.0 added liquidity-provision adapters for [CaviarNine](/ecosystem/caviarnine) QuantaSwap, [Ociswap](/ecosystem/ociswap) PrecisionPool, and [DeFiPlaza](/ecosystem/defiplaza); dedicated tools for adding and removing [LSULP](/contents/tech/core-concepts/liquid-stake-units); auto-stake and unstake across a whitelist of top validators; and a full [Weft Finance](/ecosystem/weft-finance) adapter (supply, withdraw, create CDP, borrow, repay, remove collateral, health). Swaps route through the AGGR aggregator (an [Astrolescent](/ecosystem/astrolescent) instance), and the toolkit ships [MCP tools](/developers/ai-agents/ai-agents-and-x402) for agent workflows. A companion demo, [AI Ventures](/ecosystem/ai-ventures), showcases agents running on-chain companies. ## Installation and Runtime AgentWallet is published to npm as [`wallet-agent-ai`](https://www.npmjs.com/package/wallet-agent-ai) and ships an `agent-wallet` command-line entry point alongside the library. The CLI is where the agent's own identity is set up: `init` creates the notarizer account, and `derive`, `unlock` and `recover` operate on a local encrypted keystore rather than on a hosted key service. That key signs transaction intents and pays fees; it is deliberately not the key that holds the funds, which is the point of the PolicyVault split described above. The package is an agent runtime, not only a signing library. It builds its tool surface for [LangChain and LangGraph](https://www.langchain.com/langgraph) in a single `LangChainTools.ts` module, and its [Model Context Protocol](/developers/ai-agents/ai-agents-and-x402) server exposes the same operations to any MCP client. Model providers are pluggable — the dependency list carries OpenAI, Google Gemini, Groq and [Ollama](https://ollama.com/) adapters, so the wallet can be driven by a local model as easily as a hosted one. The DEX and lending integrations resolve against a checked-in registry of roughly 130 pools and 32 tokens, which is what lets the agent name a venue rather than be handed a component address. Transaction building does not go through the [Radix dApp Toolkit](/developers/frontend/01-radix-dapp-toolkit). Since version 2.0.1 the project depends on [`@steleaio/radix-engine-toolkit`](https://www.npmjs.com/package/@steleaio/radix-engine-toolkit), part of the community [radix-web3.js](/developers/tools/radix-web3-js) suite, and pins it exactly at `2.0.0-dev.5` — a prerelease published on 4 March 2026 that draws about 35 downloads a month. That is a reasonable choice for an agent-first codebase, and it is also a single upstream maintainer and an unreleased version underneath the layer that assembles every transaction. Worth knowing before you build on it. ## Project Status (checked August 2026) AgentWallet is young and moves in bursts. The [repository](https://github.com/wallet-agent-ai/wallet-agent-ai) was created on 16 May 2026 and its own [changelog](https://github.com/wallet-agent-ai/wallet-agent-ai/blob/v2.0/CHANGELOG.md) dates 0.1.0 to 4 May, 1.0.0 to 10 May and 2.0.0 to 29 May 2026 — the staking, swap and badge tooling, then the three DEX liquidity adapters and the [Weft Finance](/ecosystem/weft-finance) CDP surface, inside four weeks. Five versions are published on npm, the most recent being 2.0.3 on 8 June 2026, and the last commit of any kind is dated 16 June 2026. Uptake is early-stage to match: about 119 npm downloads in the month to 9 August 2026, and two GitHub stars. Two practical notes for anyone reading the source. The repository's default branch is `v2.0`, not `main` or `master` — a deep link written against `/blob/main/` will silently 404, and the older `master` and `main-old` branches are still present. And although GitHub's licence detector reports the repository as unrecognised, the [LICENSE file](https://github.com/wallet-agent-ai/wallet-agent-ai/blob/v2.0/LICENSE) is the verbatim GNU General Public License v3 and `package.json` declares `GPL-3.0`: the copyleft terms are real, and they apply to anything you build on top of the SDK itself. ## External Links - [wallet-agent-ai – GitHub](https://github.com/wallet-agent-ai/wallet-agent-ai) - [AgentWallet – Website](https://wallet-agent-ai.github.io) - [wallet-agent-ai – npm](https://www.npmjs.com/package/wallet-agent-ai) - [AgentWallet changelog](https://github.com/wallet-agent-ai/wallet-agent-ai/blob/v2.0/CHANGELOG.md) - [Wallet-Agent-AI – Telegram](https://t.me/agent_wallet_ai_radix)