Skip to content
Zyper Docs Beta

Manage Funds (Disperse / Consolidate)

The Manage Funds dialog on the Wallets page handles two flows: Disperse (one wallet to many) and Consolidate (many wallets to one).

Disperse (1 → N)

Use this to fund a group of burners from a single funder wallet.

  1. Pick the source wallet (the funder).
  2. Pick the destination group (the burners to fund).
  3. Pick the chain and asset (native or ERC-20).
  4. Enter amount per recipient.
  5. Review the preview — total cost, per-recipient breakdown.
  6. Confirm.

The runner uses a per-chain Disperse contract to bundle all sends into a single transaction, splitting the source wallet’s funds across recipients. Cheaper than N individual sends.

If the chain doesn’t have a Disperse contract configured (or it’s not deployed there), the runner falls back to individual sends. You can override the Disperse contract address per-chain via disperse.txt under your data directory.

Consolidate (N → 1)

Use this to sweep proceeds from burners back to a single wallet.

  1. Pick the source group (the burners holding funds).
  2. Pick the destination wallet (where everything lands).
  3. Pick chain and asset.
  4. The runner sweeps each wallet’s balance, leaving a small gas buffer behind (so the next withdrawal isn’t stuck behind a zero-balance wallet).
  5. Confirm.

Each wallet sends individually here — there’s no atomic batch sweep that’s safe across many holders.

Gas defaults

The dialog reads EIP-1559 defaults from Settings and shows the current base fee. You can override per-session.

Session logs

Every Manage Funds session is logged as JSONL to <exe-dir>\logs\funds-sessions.log. Rotates at 4 MiB to .1. Useful for:

  • Reconciling a batch that partially failed.
  • Auditing what got sent where, months later.
  • Replaying intent if you re-run a similar batch.

Things to know

  • Source wallet must have enough native gas for the entire batch on Disperse (it’s a single tx, but the gas limit scales with recipient count).
  • Tokens require an allowance step for ERC-20 Disperse on chains that use approve-then-send patterns. The dialog handles this automatically with a one-time approval tx.
  • Failures are partial-tolerant on Consolidate — if 1 out of 30 wallets fails to sweep, the other 29 still complete. The dialog summarizes results at the end.