BTC Sovereign Tracker for Openclaw

A secure, watch-only Bitcoin self-custody tracker designed to monitor COLDCARD Q vault health, mempool fees, UTXOs, and on-chain metrics.

1beekeeper
v1.0.0
Jul 5, 2026
0
283
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install btc-sovereign-tracker

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install btc-sovereign-tracker using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BTC Sovereign Tracker?

The BTC Sovereign Tracker is an advanced utility built to assist Bitcoin self-custody practitioners in keeping tabs on their sovereign setups without compromising security. Designed around the principle of "verify, don't trust," this tool never touches private keys. It operates entirely on watch-only addresses and exposes zero sensitive information, keeping your air-gapped cold storage (such as COLDCARD Q) completely safe.

By leveraging this integration from Openclaw Skills, developers and sovereign holders can easily query mempool fees, track address balances, inspect UTXOs for dust consolidation, and verify network sync levels. Whether integrated with a local node for maximum privacy or querying public endpoints, this skill brings sovereign treasury metrics directly into your automated CLI workflows.

BTC Sovereign Tracker Use Cases

  • Daily Sovereignty Verification: Check mempool fees, confirmed watch-only address balances, block height status, and your local ZK-Bankir COLDCARD vault health in a single run.
  • Pre-Transaction Fee Calculation: Automatically evaluate the best fee rates (fastest, half-hour, hour, economy) to optimize outgoing transaction costs.
  • UTXO Consolidation Auditing: Identify dust outputs (UTXOs below 10,000 sats) and strategically plan consolidations to minimize future fee liabilities.
  • Air-Gapped Vault Monitoring: Securely query watch-only treasury stats via ZK-Bankir to track assets without ever connecting the physical COLDCARD Q hardware to the network.

How BTC Sovereign Tracker Works

  1. Fetch Recommended Fees: Queries mempool.space or a self-hosted API to retrieve real-time transaction fee estimates in sat/vB.
  2. Analyze Address State: Requests the confirmed balance and unspent transaction outputs (UTXOs) for the configured watch-only address.
  3. Query Vault Status: Accesses ZK-Bankir's local treasury endpoint to fetch physical vault statuses like COLDCARD balance and address mapping.
  4. Evaluate Network Sync: Retrieves the latest block height tip to cross-check network health and ensure your local blockchain indexer is up-to-date.
  5. Format Recommendations: Generates clear summaries of fee environments, UTXO distribution, dust flags, and potential consolidation actions.

BTC Sovereign Tracker Setup

Prerequisites

Make sure you have curl and jq installed on your PATH. This skill supports Linux and macOS systems.

Configuration

Define the required environment variables before initializing the skill:

export BTC_WATCH_ADDRESS="bc1qyourwatchonlyaddresshere"
export MEMPOOL_API="https://mempool.space/api" # Optional: change to local node
export ZK_BANKIR_HOST="http://localhost:3000" # Optional: ZK-Bankir treasury endpoint

Execution

To start using Openclaw Skills for your self-custody monitoring, initialize the tracker using your preferred CLI agent framework. For instance, to test core connectivity manually:

# Check mempool fees
curl -s "$MEMPOOL_API/v1/fees/recommended" | jq .

# Query vault balance via ZK-Bankir
curl -s "$ZK_BANKIR_HOST/api/v1/treasury/btc" -H "Accept: application/json" | jq .

BTC Sovereign Tracker Data Schema & Taxonomy

Metric Type Source Description
balance String Mempool API / ZK-Bankir Total watch-only BTC balance in sats
utxo_list Array Mempool API Current UTXOs including txid, vout, and value
dust_flag Boolean Computed Set to true if a UTXO is less than 10,000 sats
fee_rates Object Mempool API Current fastest, half-hour, and hour recommended fee rates
vault_health Object ZK-Bankir Information about physical vault tracking status (e.g., COLDCARD Q)

BTC Sovereign Tracker Advanced Features

  • Custom Mempool Node Integration: Switch the API target from public endpoints to a local, self-hosted Electrum or Mempool instance to prevent IP leaking.
  • Automated UTXO Consolidation Planning: Computes optimal cost structures for combining multiple tiny inputs into single larger outputs based on fluctuating fee rates.
  • ZK-Bankir Interoperability: Pairs directly with ZK-Bankir's sovereign banking structure to enable comprehensive, privacy-first multi-asset portfolio accounting.
  • Sovereignty Rule Compliance: Built-in safeguards align with watch-only protocols, actively warning the operator whenever a fallback to a third-party API is required.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*