> ## Documentation Index
> Fetch the complete documentation index at: https://xavierscript.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Tools

> Create, inspect, and manage agent wallets

The Wallet toolset gives AI agents self-awareness of their cryptographic identity, balances, and operational constraints.

## `create_wallet`

Generate a new Solana keypair stored in the local AES-256-GCM encrypted keystore.

* **Input:** `label` (optional) — human-readable name for the wallet
* **Returns:** Wallet ID (UUID), public key, Solana Explorer link
* **Side effects:** If a Master Funder is configured, the wallet is automatically seeded with SOL (amount set by `AGENT_SEED_SOL`)
* **Policy:** A default spending policy is attached at creation

## `list_wallets`

Returns all wallets loaded in the current KeyManager.

* **Input:** None
* **Returns:** Array of `{ wallet_id, label, publicKey, created_at }`

## `get_balance`

Fetches the full balance breakdown for a specific wallet.

* **Input:** `wallet_id`
* **Returns:** SOL balance + all SPL token balances (mint address, symbol, human-readable amount)

## `get_audit_logs`

Pulls recent transaction attempts, signatures, and policy engine decisions.

* **Input:** `wallet_id` (optional — omit for global logs)
* **Returns:** Array of log entries with timestamp, action, outcome, and transaction signature

## `get_status`

Returns system telemetry for the MCP server.

* **Input:** None
* **Returns:** Solana cluster, RPC URL, Kora availability, Master Funder status, total managed wallets

## `get_policy`

Retrieves the active spending policy and current usage counters.

* **Input:** `wallet_id` (optional)
* **Returns:** Per-transaction limit, daily cap, hourly rate limit, consumed amounts, whitelist status