Wallet — Quick guide

The Blurt Wallet is the dedicated wallet application — send and receive BLURT, view balances and transaction history, track author and curation rewards, power up/down, and manage delegations and savings. It is a focused React front-end (server-side rendered, built from the condenser codebase) that talks to the stack through one RPC endpoint.

It reads the wallet indexer, with a safety net

The wallet's history and reward screens are accelerated by the wallet indexer: when enabled, they load through the wallet_history.* API instead of paginating chain history in the browser. If the indexer is off or unavailable, the wallet falls back to the chain node (get_account_history) and renders the same screens — one code path, whichever source serves the data.

Where it sits

  wallet (browser + Koa SSR)
     │  reads history + broadcasts
     ▼
  RPC proxy  ──►  wallet-indexer   (wallet_history.*  — fast history/rewards)
             └──►  blurtd          (balances, broadcast, history fallback)

Like condenser, the wallet uses a single RPC endpoint (SDC_CLIENT_BLURTD_URL / SDC_SERVER_BLURTD_URL) and lets the RPC proxy route each call: wallet_history.* to the indexer, everything else (balances, broadcasts, the history fallback) to blurtd. Transactions are signed in the browser; keys never leave the device.

The indexer toggle

A single flag — wallet_indexer_enabled (SDC_WALLET_INDEXER_ENABLED) — decides whether history/reward screens use the accelerated wallet_history.* path. With it off, the wallet works exactly the same, just sourcing history from the chain directly. The indexer is an accelerator, never a hard dependency.

What it does

Balances and transfers, full transaction history, author and curation reward totals, power up / power down (VESTS), delegations, and savings — the complete account-money surface, separate from the social experience in condenser.

Run it

The wallet ships as a container built from the same tooling as condenser and needs a stable session secret and an RPC endpoint:

export CHICKEN=$(base64 --wrap=0 /dev/urandom | head -c 64)
docker run -it -p 8080:8080 \
  -e SDC_SESSION_SECRETKEY=$CHICKEN \
  -e SDC_WALLET_INDEXER_ENABLED=true \
  registry.gitlab.com/blurt/blurt-wallet

See the Reference for the full configuration surface and the indexer integration.

Next

• Reference — architecture, the wallet-indexer integration and fallback, the main views, and configuration.
• Source: blurt/blurt-wallet.