Balance of Satoshis

• Name: Balance of Satoshis
• URL: https://github.com/alexbosworth/balanceofsatoshis
• Category: Lightning node-operations CLI / liquidity and fee-management tooling / LND automation utility
• Tags: bitcoin-ecosystem
• Summary: Balance of Satoshis (BOS) is an LND operator toolbox. The README still presents it as a balance CLI, but the real surface is fee management, liquidity measurement, probes, rebalancing, reporting, alerts, multi-node profile management, and cron-friendly automation. It is better thought of as day-two Lightning node operations software than as a wallet or a one-off script.
• What it does:
  • Provides a CLI for inspecting balances, forwards, peers, channels, UTXOs, closed channels, and general node activity
  • Supports routing-ops workflows such as fee updates, liquidity measurement, probes, rebalancing, opening channels, and opening balanced channels
  • Lets operators manage multiple nodes through saved-node credential profiles and a configurable default node
  • Exposes automation-oriented commands and examples for scheduled fee changes, liquidity balancing, certificate monitoring, daily reports, and notification pipelines
  • Ships Docker packaging, platform-specific install guidance, and a gateway mode for a separate UI project (ln-operator.github.io)
  • Includes optional Telegram integration and formula-based arguments for dynamic amounts, routing filters, and fee logic
• Key claims:
  • The README describes BOS as “Commands for working with LND balances,” but the command list and examples show a much broader operator surface across rebalancing, fees, channel opens, reporting, credential export, and gateway/Telegram integrations
  • The project supports multiple saved nodes through ~/.bos/.../credentials.json, optional default-node selection, and environment-variable overrides for both LND and BOS data directories
  • The README includes cron-friendly examples for automatic fee adjustment, periodic liquidity balancing, certificate-expiry alerts, and daily operational reports, which is a strong signal that BOS is intended as reusable node-automation infrastructure
  • The package metadata describes the project as a “Lightning balance CLI,” publishes a bos executable, requires Node 20+, and uses dependencies such as ln-service, ln-sync, ln-telegram, probing, and paid-services
  • The published keywords include lightning, lnd, rebalance, and submarine-swaps, reinforcing that the project is aimed at active Lightning operators rather than passive wallet users
• Whitepaper: No canonical standalone Balance of Satoshis whitepaper or litepaper surfaced in this pass. The clearest current sources of truth were the first-party GitHub README and package metadata; see ../whitepapers/balance-of-satoshis-primary-sources-2026-05-01.md.
• Sources:
  • https://github.com/alexbosworth/balanceofsatoshis
  • https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/README.md
  • https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/package.json

Internal linkages

• Direct backend BOS is built around: lnd

• Stronger general operator-console comparison: ride-the-lightning

• Marketplace-and-data-heavy contrast: amboss

• Last reviewed: 2026-05-22 UTC