Skip to main content

How do I… use the digstore CLI?

Drive everything from your terminal. digstore is the Git-shaped CLI for creating, publishing, sharing, and reading stores — scriptable and CI-ready. This page maps each task to the page that walks it. Building and previewing are free; you spend only when you publish.

The mental model​

The loop mirrors Git: scaffold and preview locally for free, then init to mint a store and commit to publish each capsule (a new on-chain root). A capsule costs the uniform price in $DIG; everything before publishing costs nothing. Configuration lives in a committable dig.toml (no secrets — those come from the environment).

How do I install it?​

Grab the installer for your OS from the Releases page (or build from source), then confirm with digstore --version.

→ Installing the CLI

How do I try it before I spend anything?​

Scaffold a runnable project with digstore new <template> and preview it live with digstore dev — served over the genuine chia:// read path with live reload and an injected dev window.chia. No mint, no chain, no spend. digstore doctor runs a pre-publish preflight, and digstore commit --dry-run previews the exact $DIG/XCH cost without spending.

→ Scaffold an app · CLI tutorial

How do I set up a wallet?​

Publishing spends real funds, so generate or import a seed and fund the wallet first: digstore seed generate, then digstore balance to see your receive address.

→ On-chain anchoring · Where to get DIG

How do I publish my first capsule?​

digstore init site --dir dist mints the store's singleton on Chia mainnet — the launcher id becomes your store id — and blocks until confirmed.

→ CLI tutorial → initialize

How do I ship an update?​

digstore add -A then digstore commit -m "v1.1" seals the current content into a new capsule and advances your on-chain root. For CI, digstore deploy --output-dir dist --json does add → commit → push in one command and never mints.

→ Using DigStore in your project · Project config

How do I share it / serve it over a remote?​

push, clone, and pull move a store over a §21 remote (the default is the public DIGHUb). This is the basis for hosting your own content and for the deploy flow.

→ Sharing over a remote

How do I read content back?​

digstore cat urn:dig:chia:<storeId>/<resource> — a URN both locates and decrypts the resource. The same chunked, verify-then-decrypt path the network uses.

→ Streaming & retrieval keys

How do I deploy from GitHub Actions?​

Wire dig-network/deploy-action so every push publishes a new capsule, with an if-changed guard (a byte-identical build is a no-op, no spend) and free PR previews. Authorize CI with a revocable deploy key — never your wallet seed.

→ Deploy from GitHub Actions · Deploy keys

Where's every command?​

The full reference, with the on-chain-cost notes and the free pre-publish commands.

→ Command reference

Go deeper​