Wallet

The wallet is the adapter’s economic identity - used for signing transactions, proving ownership, and receiving payments. It is self-custodial: the provider controls their keys.

Key Generation

On first setup, the adapter generates a Solana keypair. The keypair is encrypted at rest and stored locally. The provider never needs to interact with Solana tooling directly.

Import

Providers with existing wallets can import them:

# From a keypair file
agent-adapter wallet import --keypair ./my-wallet.json

# From a base58-encoded private key
agent-adapter wallet import --key "base58-encoded-key"

Or via environment variable in config:

wallet:
  type: "solana_raw"
  privateKey: "${WALLET_PRIVATE_KEY}"

Agent-Facing Tools

The embedded agent uses these tools for wallet operations:

Tool	Description
`wallet__get_address`	Returns the adapter’s public key
`wallet__get_balance`	Checks SOL and token balances
`wallet__sign_message`	Signs arbitrary bytes (for challenge-response auth)
`wallet__sign_transaction`	Signs a prepared Solana transaction

Wallet Plugins

The wallet system uses a plugin architecture:

solana-raw - direct Solana keypair management
ows - Open Wallet Standard integration

See Wallet Plugins for details on available plugins and building your own.