Snowblossom Docs
Docs › Start here › FAQ & troubleshooting

FAQ & troubleshooting

Short answers to the questions people actually ask, with pointers to the detailed pages.

General

What is the total supply?

50 SNOW per block at launch, halving every 210,240 blocks (about four years): 25 SNOW from May 2022, 12.5 SNOW from May 2026. The sum converges to just under 21,024,000 SNOW. Details.

How long is a block?

Ten minutes on average; the target adjusts every block and also eases while no block is found, so the network recovers quickly from hash-rate swings. Difficulty adjustment.

Was there a premine or ICO?

No. Block 0 had to contain the hash of Bitcoin block #523,850, so mining could not start before that block existed (22 May 2018). History.

Is the address format snow:… or just the letters?

Both are accepted; snow: is recommended because the label is part of the checksum. Testnet addresses start with snowtest:. Duck32.

Is Snowblossom quantum-safe?

It is designed to be quantum resistant: keys are hidden behind hashes until spent, addresses can combine several algorithms, and since 2025 the post-quantum schemes SPHINCS+, Dilithium and Falcon are available (key_mode=pqc1 / pqc_lite). Old secp256k1 wallets are as safe as Bitcoin's. Quantum resistance.

Is it sharded? Does my wallet need to care?

The protocol supports sharding since 2022, but mainnet still runs one shard because blocks are far from full. If a split ever happens, existing wallets keep working: their coins follow the coordinator lineage automatically. Sharding.

Node

Do I have to run a node?

No - wallets and miners can use any node, and the client falls back to public TLS seed nodes. Running your own is recommended for privacy (a node sees which addresses you ask about) and is required for indexes (addr_index, tx_index) that history and integrations need. Node.

How much disk and RAM?

About 100 GB for an indexed mainnet node (2026), growing; SSD recommended. 4 GB heap plus RocksDB memory - plan 6–8 GB.

“rocksdb does not work with 32-bit jvm”

Install a 64-bit Java. (db_type=lobstack works on 32-bit but is slow and has no TLS.)

“Block too far into future” / “Local clock seems to be off”

Your system clock is wrong. Blocks may be at most 45 s in the future; run NTP.

I enabled addr_index but history is empty

Indexes are not built retroactively. Delete the database and resync with the options on.

The miner says “We are not yet synced”

The node refuses templates until its head is within 10 blocks of the best header it has seen. Wait, or on a private network set bypass_sync_check=true.

“Illegal reflective access” / protobuf warnings

Harmless JVM warnings from older Java versions; ignore, or use Java 17+.

Wallet

Where is my wallet and how do I back it up?

In the directory set by wallet_path (IceLeaf: ~/.snowblossom/wallets/<name>/db). Back up the whole directory - or, for HD seed wallets, the 12 words (show_seed tells you whether every key comes from the seed). Non-seed wallets need a fresh backup whenever new addresses are created. Wallet files.

Why are there several .wallet files?

Every change is written as a new fragment and merged on the next start; this makes the wallet crash-safe and sync-friendly. Just never rsync --delete.

Is the wallet encrypted?

No. Use disk encryption and file permissions.

I restored a seed and the balance is wrong

Recovery needs a node with addr_index to find used addresses without balance; otherwise only addresses within the first 10 + 20 indexes are discovered. Run against an indexed node (or a public node that has the index) and let maintainKeys iterate.

“IO Exception” in the client

The node is not reachable: check node_uri/node_host, the node's port and that it is running.

Can I make a multisig address?

Yes, over any mix of algorithms. Single-wallet multisig comes from the key modes (qhard, pqc1); a shared M-of-N between people takes three commands: each co-signer runs pubkey, one person runs makemultisig <m> self <key>… --out share.json, everyone else runs import share.json. Spending passes a part-signed file through each wallet's signtx. Multi-party multisig.

How do I send to many recipients or attach a note?

On the command line: send --to snow:alice=1.5 --to snow:bob=0.25 --extra "invoice 7". Through JSON-RPC: send takes an outputs array and an extra (≤ 100 bytes) field. IceLeaf's Send tab also has a note field. send.

Can I choose exactly which coins get spent?

Yes - coin control is built into the CLI since 2.2: outputs lists every unspent output with a short id, and send/sweep/consolidate take --input txid:idx, --from address and value/shard filters. Coin control.

How do I get a quantum-resistant address without a new wallet?

newaddress --key-mode pqc_lite mints a Falcon address inside any wallet. It is not derived from your seed words, so run backup <dir> afterwards. Key modes.

Mining

Which snow field do I need?

At least the activated one - currently field 9 (hippo) - or larger. The explorer's mining page shows the next field and how close the network is to it. Snow fields.

Where do I get the field?

Torrents at snowblossom.org/snowfields, or generate it with auto_snow=true (very slow). Put it in snow/snowblossom.N/ with the deck files.

Can I mine with a GPU?

No. The proof of work is six dependent random reads per attempt; there is nothing for a GPU to compute. Storage IOPS or RAM decide the hash rate. Stoat.

Can I mine in RAM?

Yes, with RAM larger than the field: memfield=true (needed on Windows) or simply enough RAM for the Linux page cache; partial caching via memfield_precache_gb; or split the field across machines with Arktika. Mining.

When does the field change, and does it ever go back?

When the average difficulty reaches the next activation difficulty (two bits per field on mainnet). Never back: an activated field stays required even if difficulty drops.

“Unable to select a field of at least N”

No usable field ≥ N was found under snow_path. Check the directory name (snowblossom.N), the presence of all deck files, and the start-up self-test messages (“Unable to load …” means a corrupt file).

Solo or pool?

With ~160 blocks a day network-wide, solo mining pays rarely unless you have a large share of the hash rate. Pools pay every block they find, directly in the coinbase (PPLNS). Pools.

How do I vote on a proposal?

vote_yes=N / vote_no=N in the solo miner or pool config. Pool miners vote through their pool. Voting.

Developers

Which API should I use?

Wallet operations (addresses, sending, balances): the client's JSON-RPC. Chain data and push notifications: the node's gRPC. Quick reads without running anything: the explorer's HTTP API.

How are transaction ids and addresses computed?

tx_hash = Skein-256-256(inner_data); address = Skein-256-160(required_signers ‖ count ‖ (type ‖ len ‖ key)…), rendered with Duck32. Transactions, Addresses.

How do I build from source?

Install Bazel (bazelisk) and a JDK 17+, then bazel build :all; deploy jars with bazel build :<Name>_deploy.jar. Quickstart.

How do I run a private network for testing?

network=regtest, tiny fields from tools/snowfall-spoon.sh, a node with bypass_sync_check=true and a solo miner; blocks take seconds. Networks.