RADIX WikiRADIX Wiki

Overview

AgentWallet for Radix is an open-source, policy-constrained programmable wallet and SDK that lets an AI agent transact autonomously on Radix – performing swaps, staking, and liquidity provision across the major DEXs, and full 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 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 QuantaSwap, Ociswap PrecisionPool, and DeFiPlaza; dedicated tools for adding and removing LSULP; auto-stake and unstake across a whitelist of top validators; and a full Weft Finance adapter (supply, withdraw, create CDP, borrow, repay, remove collateral, health). Swaps route through the AGGR aggregator (an Astrolescent instance), and the toolkit ships MCP tools for agent workflows. A companion demo, AI Ventures, showcases agents running on-chain companies.

Installation and Runtime

AgentWallet is published to npm as 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 in a single LangChainTools.ts module, and its Model Context Protocol server exposes the same operations to any MCP client. Model providers are pluggable — the dependency list carries OpenAI, Google Gemini, Groq and Ollama 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. Since version 2.0.1 the project depends on @steleaio/radix-engine-toolkit, part of the community 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 was created on 16 May 2026 and its own changelog 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 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 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.

HydrateLast updated 6d agov2.1.05 revisionsVerified Aug 11, 2026