Cowrie Research

balance-of-satoshis-primary-sources-2026-05-01

3 min read

Balance of Satoshis primary-source snapshot

Fetched: 2026-05-01 UTC

1) Project README / overview

Source: https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/README.md

Selected excerpts from the README:

Balance of Satoshis

Commands for working with LND balances.

Additional signals from the source:

  • The top-line description is understated compared with the actual operating surface exposed lower in the README
  • The README is the clearest primary source because the project appears to use the repository as its canonical documentation hub

2) Operator command surface

Source: https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/README.md

Selected excerpts from the README:

bos fees

bos increase-inbound-liquidity

bos increase-outbound-liquidity

bos open-balanced-channel

bos probe “payment_request/public_key”

bos rebalance

bos report

bos telegram

Additional signals from the source:

  • The command list shows BOS is much closer to a Lightning operator toolkit than a narrow balance utility
  • Rebalancing, fee control, probing, and reporting are especially strong clues that BOS should be cataloged as node-operations infrastructure

3) Multi-node and credentials model

Source: https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/README.md

Selected excerpts from the README:

To use bos with arbitrary external nodes (or nodes with custom configuration), two things need to be done:

  1. Create directory ~/.bos/, and add node credentials in a format of:

~/.bos/YOUR_NODE_NAME/credentials.json

Additional signals from the source:

  • BOS is explicitly designed to operate across multiple saved nodes, not just a single local lnd instance
  • The saved-node model is an important clue that BOS is reusable operator infrastructure

4) Automation posture

Source: https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/README.md

Selected excerpts from the README:

Cron every 5 minutes adjust fees

*/5 * * * * /bin/timeout -s 2 30 /home/ubuntu/update-fees.sh

Cron: every 30 minutes send funds to reach 50:50

/30 * * * * /home/ubuntu/.npm-global/bin/bos send PUBKEY —max-fee 0 —message=“rebalance” —amount=“IF(OUTBOUND+1m>(LIQUIDITY/2), OUTBOUND-(LIQUIDITY/2), 0)”

/path/to/bos report —styled 2>&1 |
/path/to/sendnotification SNS “sns-topic-id” “%s” —subject=“Daily node update”

Additional signals from the source:

  • Cron examples, formulas, and notification pipelines make BOS look like a practical automation layer for Lightning node operations
  • This is stronger evidence for a control-plane classification than the short project tagline alone

5) Package metadata and technical footprint

Source: https://raw.githubusercontent.com/alexbosworth/balanceofsatoshis/master/package.json

Selected excerpts from the package metadata:

“description”: “Lightning balance CLI”

“bin”: { “bos”: “bos” }

“engines”: { “node”: ”>=20” }

“keywords”: [ “cli”, “lightning”, “lightning-network”, “lnd”, “rebalance”, “submarine-swaps” ]

Additional signals from the source:

  • The package metadata confirms that BOS ships as an installable CLI and is aimed at Lightning / LND operators
  • Dependencies such as ln-service, ln-sync, ln-telegram, probing, and paid-services support the picture of a broad operational toolkit rather than a single-purpose script

Notes

  • Balance of Satoshis appears best cataloged as Lightning node-operations CLI / liquidity and fee-management tooling / LND automation utility.
  • No canonical standalone whitepaper or litepaper surfaced in this pass.
  • The most useful primary sources were the GitHub README and package metadata.

Graph View