[]

Activity Ledger

Append-only audit trail for every agent operation. Every tool call, swap, transfer, alert, and tunnel action is logged with timestamps, wallet, chain, and status. SQLite-backed, queryable, and exportable.

Why

Autonomous agents need accountability. When an agent swaps tokens, sets alerts, or approves tunnel proposals, you need a record of what happened, when, and whether it succeeded. The ledger logs every tool invocation automatically and stores it locally at ~/.config/owl/ledger.db

CLI Commands

# show recent entries
owl ledger list

# filter by tool, wallet, or chain
owl ledger list -t mp_token_swap -w main

# show entries since a date
owl ledger list -s 2026-03-21

# show only errors
owl ledger list --status error

Flag	Description
-n, --limit	Number of entries to show (default 20)	optional
-t, --tool	Filter by tool name	optional
-w, --wallet	Filter by wallet name	optional
-c, --chain	Filter by chain	optional
-s, --since	Show entries since date (ISO format)	optional
--status	Filter by status (ok or error)	optional

Statistics

# overall stats
owl ledger stats

# stats for today
owl ledger stats -s 2026-03-21

Returns total operations, error count, breakdown by tool and chain.

Export

JSON

Full structured export with all fields.

owl ledger export -f json

CSV

Spreadsheet-friendly format for analysis.

owl ledger export -f csv -s 2026-03-01

Clear

# clear entries before a date
owl ledger clear --before 2026-03-01

# clear all entries
owl ledger clear

What Gets Logged

Field	Description
timestamp	ISO 8601 date and time of the operation
tool	Tool name (e.g. mp_token_swap, owl_alert_add)
args	JSON arguments passed to the tool
result	Tool output (truncated to 2000 chars)
wallet	Wallet used (if applicable)
chain	Chain used (if applicable)
status	ok or error
agent	Agent identifier (provider/model)

MCP Tools

Tool	Description
owl_ledger_query	Query ledger entries with filters
owl_ledger_stats	Get summary statistics
owl_ledger_export	Export as JSON or CSV
owl_ledger_clear	Clear entries