OPEN SOURCE · SOROBAN · MCPPolicy enforced smart walletsfor AI agents on Stellar.
AgentWallet gives AI agents limited, policy controlled access to a Soroban C-address wallet, without exposing private keys or granting unrestricted spending authority.
Problem
Agents need wallet access. Private keys are too risky.
AI agents are beginning to make payments, call APIs, interact with onchain protocols, and automate user workflows. To do this onchain, they need wallet access.
Giving an agent the direct private key of a normal Stellar account is risky. The agent can misuse funds, interact with unknown contracts, or make irreversible transactions outside the user's intent.
Stellar's Soroban C-addresses make a safer model possible: wallet authority can be represented as smart contract logic rather than a single unrestricted key. AgentWallet turns that capability into a practical developer tool for agentic payments on Stellar.
Solution
Policy enforced C-address wallet
AgentWallet creates a policy enforced C-address wallet controlled by both the user and the agent, with onchain enforcement before any action executes.
01
User (admin)
Update policies, pause agent access, and approve restricted transactions.
02
Agent (restricted actor)
Request only actions allowed by the wallet's onchain policy.
03
C-address contract
Enforces spending limits and protocol allowlists before execution.
04
Mobile app
Policy dashboard and approval inbox for out of policy requests.
05
MCP connector
Lets agent runtimes request wallet actions without receiving private keys.
How it works
From policy setup to agent approval
User flow diagram
From wallet setup through agent requests, onchain policy checks, and human approval when needed.
01
User creates or connects a Stellar wallet that acts as the admin account
02
AgentWallet deploys a Soroban C-address smart wallet for agent controlled activity
03
User configures limits: per transaction limit, per day limit, and whitelisted protocols
04
An AI agent calls the AgentWallet MCP connector to request a payment or contract call
05
The C-address contract verifies the request against the policy
06
Allowed actions execute; restricted actions create a pending request for manual approval
07
User receives the request in the Android app and can approve, reject, or pause the agent
Policies
Supported policies
| Policy | Example | Enforcement |
|---|---|---|
| Per transaction limit | Agent cannot spend more than 5 USDC in one transaction | Blocked onchain unless the user approves |
| Per day spend limit | Agent cannot spend more than 25 USDC per calendar day | Contract tracks daily usage and rejects excess spend |
| Whitelisted protocols | Agent can interact only with approved Stellar/Soroban contracts | Unknown contract calls require approval or are rejected |
| Manual approval fallback | New recipient, larger payment, or protocol not on the allowlist | Creates a pending approval request for the user |
MCP connector
Safe wallet tools for agent runtimes
The MCP connector exposes wallet request tools for Codex, Claude Desktop, Hermes, OpenClaw, and other MCP compatible environments, rather than raw private key access.
Stack
Open source components
01
Soroban C-address contract
Open source smart wallet with admin/agent roles, policy storage, and onchain transaction validation.
02
Policy engine
Per transaction limits, daily spend accounting, protocol allowlists, and approval state handling with test coverage.
03
MCP connector
Agent facing tools for Codex, Claude Desktop, Hermes, OpenClaw, and other MCP compatible runtimes.
04
Android app
Policy dashboard, approval inbox, and release ready build for configuring limits and approving agent actions.
05
TypeScript SDK & docs
Demo flows, testnet deployment guide, and integration documentation for developers.
Why Stellar
C-address programmability for agentic payments
Soroban C-addresses allow smart wallet logic to be enforced onchain. AgentWallet uses Stellar's low cost transaction model and C-address programmability to create safer agentic payment infrastructure for developers building AI agents, x402 style payment flows, API agents, treasury agents, and autonomous commerce tools.
Get started
Build safer agentic payments on Stellar
Deploy a policy enforced C-address wallet on testnet, connect an MCP compatible agent, and approve out of policy actions from the Android app, all without giving agents private keys.