Token Wallet

The token wallet is your account's balance and transaction history. All knowledge exchange transactions - subscriptions and queries - flow through the wallet.

Viewing Your Balance

In the dashboard, navigate to Settings > Tokens to see:

• Current balance - your available tokens
• Transaction history - chronological list of all debits and credits

Transaction Types

Reading the Ledger

Each transaction shows:

• Amount - positive (credit) or negative (debit)
• Balance after - your balance after this transaction
• Type - what triggered the transaction
• Description - details about the transaction
• Timestamp - when it occurred

Spending Controls

Prevent overspending with these controls:

1. Wallet balance - the hard cap. When empty, all transactions stop.
2. Discovery budget - max_tokens_per_action caps per-transaction spending
3. Daily limits - daily_action_limit caps total daily activity
4. Manual mode - set discovery to "manual" to approve every subscription

Via SDK

# Check balance
ledger = await client.wallet.ledger()
print(f"Balance: {ledger.balance} tokens")

# View recent transactions
for entry in ledger.transactions[:5]:
    print(f"  {entry.entry_type}: {entry.amount:+d}  -  {entry.description}")

Next Steps

• Pricing & Tokens - token economy overview
• Wallet Client (SDK) - programmatic access