kasmage 0.2.0

Frog-wizard-themed CLI to monitor Kaspa transactions and save receipts

Kasmage 🐸 Kasmage is a whimsical, lightweight frog-wizard themed CLI that monitors a Kaspa address for transactions. It can print all historical transactions or watch for new ones in real time. Official mascot: Flubs Ompi, DAG Mage.

Quickstart (Install & Run)

Clone the repo, build the wheel, and install locally:

git clone https://github.com/yourname/kasmage.git
cd kasmage
poetry build
pip install --force-reinstall dist/kasmage-0.1.0-py3-none-any.whl

Now run:

kasmage --address kaspa:yourkaspaaddresshere

Features

• Live mode: watch an address and get notified when new transactions confirm
• Historical mode: print all confirmed transactions (oldest → newest) and exit
• Receipts (new!): automatically save each detected transaction as a TXT or JSON eceipt for record-keeping
• Compatible with Kaspa mainnet addresses (kaspa:...)

Installation

For now, clone the repo and install with Poetry:

git clone https://github.com/yourname/kasmage.git
cd kasmage
poetry install

Usage

Watch new transactions (default live mode)

kasmage --address kaspa:qpwhk9yja6n2l73enwl62s2u52c7u87mjkh4mwhyeueum660ght4735mlsas5

Output example:

🐸🔮 Peering into the orb... (Ctrl+C to stop)
✨👀 I scry with my amphibian eye a tx: 40.00000000 KAS | b7d51e1d29b... | 2025-10-13 07:28:45 UTC

Print all past transactions

kasmage --address kaspa:qpwhk9yja6n2l73enwl62s2u52c7u87mjkh4mwhyeueum660ght4735mlsas5 --historical

Output example:

📜 100.00000000 KAS | txid: 6c7a0b8473b... | 2025-10-12 02:43:09 UTC
📜 200.11837708 KAS | txid: 1a3ede08005... | 2025-10-12 01:21:17 UTC

Options

• -h, --help: All this info pretty much
• --address (required): Kaspa address to monitor
• --interval: Poll interval in seconds (default: 10)
• --page-size: Number of tx per API page (default: 50)
• --historical: Print all confirmed tx and exit
• -V, --version: Print version and exit
• --receipts: Write a recipt per new tx (live mode)
• --receipts-dir: Directory for receipts
• --receipt-format: Self explanitory

License

MIT © Ethan Villalobos