Give your AI agent a wallet.
AgentWallet lets agents pay, swap, and settle through wallets that owners can actually control.
Active agent wallet
Connect a wallet to own and publish agent policies.
Create or select the wallet your AI agent will use.
Register and publish a policy before the agent can spend.
Fund with devnet SOL first, then mint AgentWallet test tokens for payments. Custom token mints must be funded from their own devnet mint authority.
SOL is required before token minting.
Devnet proof links
Agent wallets
Generate hosted devnet wallets for AI agents. AgentWallet keeps signing keys encrypted server-side and routes every spend through the owner policy.
Create a link code, then send it to the shared Telegram bot. @agentspendbot
Telegram is only one interface. A real AI agent should call AgentWallet through the SDK or REST API using its hosted agent API key.
import { AgentWallet } from "@agentwallet/sdk";
const wallet = new AgentWallet({
baseUrl: "https://your-agentwallet.vercel.app",
apiKey: process.env.AGENTWALLET_API_KEY!
});
const me = await wallet.getAgent();
if (!me.status.readyForPayments) {
throw new Error("AgentWallet setup incomplete: " + me.status.missing.join(", "));
}
await wallet.pay({
recipient: "<recipient-public-key>",
amount: "1",
tokenMint: "6XigBN521xmNyFV4DDgLpfGVsXTP3JstsaSTkbpNRXgk"
});Current API key: copy the one-time key after generation or rotation
Agents call the hosted wallet API with their API key. Private keys stay encrypted server-side.
import { AgentWallet } from "@agentwallet/sdk";
const wallet = new AgentWallet({
baseUrl: "https://your-agentwallet.vercel.app",
apiKey: "<agent-api-key>"
});
await wallet.pay({
recipient: "<recipient-public-key>",
amount: "",
tokenMint: "6XigBN521xmNyFV4DDgLpfGVsXTP3JstsaSTkbpNRXgk"
});Run the paid API demo after selecting a funded hosted agent.
Merchant wallet is returned by the paid API challenge.
Price 1 AgentWallet devnet test token
Judge devnet setup
Use Phantom on devnet. The connected wallet owns the policy account.
Connect Phantom, then fund the connected devnet wallet with AgentWallet test tokens.
Initialize the policy, then execute through AgentWallet so the program checks caps and allowlists before transfer.
Policy rules
Connect owner wallet before updating the draft policy.
Agent registry
Register each AI agent wallet separately. Every agent gets its own policy account under the shared AgentWallet program.
No agents registered yet. Add an agent wallet above to create its policy.
Publish policy
No saved entries yet. Add one above, then check it to allow it.
Connect Phantom, paste the deployed program ID, then initialize or update the policy account.
Run agent action
Agent API integration
A Telegram bot or backend agent calls this HTTP route after it turns an owner command into a payment intent. The server signs with the configured agent wallet, then submits the same on-chain `execute_payment` instruction used above.
POST /api/agent-wallet/pay
Authorization: Bearer <agent-api-key>
Content-Type: application/json
{
"programId": "9eZMFa68NmfF4YNz5cF96AsJukbRzvvP1TDktN4cfbDU",
"policyPda": "<initialize-policy-first>",
"recipient": "<recipient-public-key>",
"tokenMint": "6XigBN521xmNyFV4DDgLpfGVsXTP3JstsaSTkbpNRXgk",
"amount": "",
"decimals": 6
}Manual payment test
Demo fallback: use this when you want Phantom to sign the agent payment manually. The normal agent workflow is AI Agent Chat or Telegram calling the backend executor.
Use the configured agent wallet to execute a policy-gated SPL token payment.