Wallet Operations

Tools for managing wallet connections, balances, and token transfers.

Note: All wallet tools support the optional userId parameter for session persistence. Include it in every call to maintain wallet state across reconnections.

connect_wallet

Connect a wallet for signing transactions.

Parameters

Wallet Modes

• test: Uses a mnemonic phrase for signing. Good for development and testing.
• external: Prepares transactions for external signing (e.g., browser wallets like Keplr). Returns unsigned transaction data.
• readonly: View-only mode. Can query data but cannot sign transactions.

Security Considerations

⚠️ Mnemonic Exposure Warning: When a mnemonic is provided via this tool, it may be stored in conversation history or logs. Only use mnemonics for test wallets or wallets containing funds you're willing to lose. For production use with real assets, use external mode with Keplr or another secure wallet that keeps private keys isolated.

Example

{
  "chainId": "galileo-4",
  "mode": "test",
  "mnemonic": "your twelve word mnemonic phrase here..."
}

get_wallet_info

Get information about the currently connected wallet.

Parameters

None required.

Response

Returns wallet address, chain ID, connection mode, and status.

get_wallet_balance

Get the balance of the connected wallet.

Parameters

Example

{
  "denom": "uandr"
}

create_wallet

Create a new wallet with a mnemonic phrase.

Parameters

Example

{
  "wordCount": 24
}

Response

Returns the new mnemonic phrase and derived address. Store the mnemonic securely - it cannot be recovered.

Security Considerations

⚠️ Mnemonic Exposure Warning: The generated mnemonic will appear in the response and may be stored in conversation history or logs. This feature is intended for creating test wallets for experimentation. If you create a wallet you intend to use with real assets, immediately copy the mnemonic to secure offline storage and treat the conversation history as potentially exposed.

send_native_tokens

Send native tokens from the connected wallet to another address.

Parameters

Amount Format

{
  "recipient": "andr1abc...",
  "amount": [
    {
      "denom": "uandr",
      "amount": "1000000"
    }
  ],
  "memo": "Payment for services"
}

Custom Fee Format

{
  "fee": {
    "amount": [{ "denom": "uandr", "amount": "5000" }],
    "gas": "200000"
  }
}

Simulation Mode

Set simulate: true to estimate gas costs without actually sending the transaction:

{
  "recipient": "andr1abc...",
  "amount": [{ "denom": "uandr", "amount": "1000000" }],
  "simulate": true
}