Documentation

const res = await fetch("https://api.ai-agentic-wallet.com/api/agents/create-mandate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Portal-Key": YOUR_PORTAL_API_KEY,
  },
  body: JSON.stringify({
    agentId:      "my-agent-001",  // unique ID, alphanumeric + hyphens
    ownerAddress: "PERA_ADDR...",  // optional — links agent to your wallet identity
    platform:     "anthropic",    // optional: "openai" | "anthropic" | "custom"
  }),
});

const { agentId, address, mnemonic, mandateAppId, appAddress } = await res.json();
// address      → agent's Algorand signing address
// mnemonic     → 25-word signing key — save to ALGO_MNEMONIC in your .env
// mandateAppId → MandateContract application ID — save to MANDATE_APP_ID in your .env
// appAddress   → contract app account — fund this with ALGO + USDC

ALGO_MNEMONIC="word1 word2 ... word25"  # in your .env file

// Poll until active (typically 10–30 seconds after deposit)
let agent;
do {
  await new Promise(r => setTimeout(r, 5000));
  const r = await fetch(`https://api.ai-agentic-wallet.com/api/agents/${agentId}`, {
    headers: { "X-Portal-Key": YOUR_PORTAL_API_KEY },
  });
  agent = await r.json();
} while (agent.status !== "active");

console.log("Agent active:", agent.address);

npm install @algo-wallet/x402-client algosdk

X-Agent-Gas-Status:    ok | low | critical
X-Agent-Gas-Remaining: 847   # estimated transactions remaining

import { AlgoAgentClient, parseGasInfo } from "@algo-wallet/x402-client";

const client = new AlgoAgentClient({
  baseUrl,
  privateKey:   account.sk,
  mandateAppId: Number(process.env.MANDATE_APP_ID),
});
const response = await client.fetch("/api/your-endpoint", { method: "POST", body: ... });
const gas = parseGasInfo(response);

if (gas?.status === "critical") {
  console.warn(`Gas critical — only ${gas.remaining} transactions remaining`);
  // trigger a refuel flow or alert your operator
}

import type {
  TradeParams,
  TradeResult,
  SettlementResult,
  SettlementFailure,
  SandboxExport,
  PayJson,
} from "@algo-wallet/x402-client";

import { X402Error, X402ErrorCode } from "@algo-wallet/x402-client";

try {
  const result = await client.executeTrade({ senderAddress: "AAAA...7Q" });
  if ("success" in result) {
    console.log("Settled:", result.settlement.txnId);
  } else {
    console.error("Pipeline failed at:", result.failedStage, result.detail);
  }
} catch (err) {
  if (err instanceof X402Error) {
    switch (err.code) {
      case X402ErrorCode.OFFER_EXPIRED:  // Re-initiate handshake
      case X402ErrorCode.POLICY_BREACH:  // Agent exceeded spending cap
      case X402ErrorCode.NETWORK_ERROR:  // Algorand node unreachable — retry
    }
  }
}

npm install -g @algo-wallet/x402-cli

# Required env vars
export X402_PORTAL_KEY="your-portal-api-key"   # from /dashboard → API Keys
export X402_API_URL="https://api.ai-agentic-wallet.com"  # default
export X402_NETWORK="testnet"                   # or "mainnet"

# Examples
x402 health
x402 balance --agent my-agent-001
x402 mandate list --agent my-agent-001 --all
x402 history --agent my-agent-001 --limit 50

npx @algo-wallet/x402-mcp

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "x402-wallet": {
      "command": "npx",
      "args": ["-y", "@algo-wallet/x402-mcp"],
      "env": {
        "ALGO_MNEMONIC": "your 25-word agent mnemonic",
        "X402_AGENT_ID": "your-agent-id",
        "X402_API_URL":  "https://api.ai-agentic-wallet.com"
      }
    }
  }
}

claude mcp add x402-wallet npx @algo-wallet/x402-mcp \
  --env ALGO_MNEMONIC="your 25-word mnemonic" \
  --env X402_AGENT_ID="your-agent-id"