Tutorials

Learn Divi, step by step

Practical guides for DIVI holders and builders: staking, vaults, explorers, running a node, and keeping your coins safe.

Getting started

Getting started

What is Divi?

Divi in five minutes: proof of stake, where new DIVI comes from, the weekly lottery, staking vaults, and how to hold and use the coin.

About 7 minutes
Getting started

Which wallet should I use?

Seven ways to hold DIVI, what each one can do today, and which to pick for holding, staking, dApps or Telegram.

About 6 minutes
Getting started

Create your first wallet

Create a Divi wallet in IronDivi, the web wallet, the extension, Telegram, Divi Desktop, BoxWallet and the C++ node, and save the recovery phrase in a password manager.

About 10 minutes
Getting started

Encrypt your wallet

Put a passphrase on your Divi wallet file in IronDivi, Divi Desktop, BoxWallet and the C++ node, with real outputs, and see how the web, extension and Telegram wallets lock. Do it before your first backup.

About 10 minutes
Getting started

Back up your wallet

Your recovery phrase is the backup. Why extra wallet.dat copies are a risk, the two cases where you still need one, and how to make that copy of an encrypted wallet into your password manager.

About 12 minutes
Getting started

Receive your first DIVI

Make a receiving address in IronDivi, Divi Desktop, BoxWallet and the light wallets, check it before you share it, and watch the payment confirm.

About 10 minutes
Getting started

Send DIVI

Send DIVI from every Divi wallet: check the address, see the fee, send a small test first, and avoid amounts the network refuses.

About 12 minutes
Getting started

Read a transaction

Read any Divi transaction in Explorer 2.0: the Unconfirmed, 1/6 and Confirmed badge, inputs, outputs, change, the fee, block rewards and the address page.

About 10 minutes
Getting started

Avoid scams

The scams that target Divi holders: fake support accounts, “validate your wallet” sites, giveaways, fake wallets and guaranteed returns, and the one rule that beats them all.

About 10 minutes
Getting started

Divi Glossary

Plain-language definitions of every word you meet in a Divi wallet or explorer: address, recovery phrase, passphrase, UTXO, confirmation, staking, lottery, vault and more.

About 12 minutes

Buying DIVI and the community

Community

Where to Buy DIVI

Where DIVI actually trades today, how to tell a real listing from a dead or fake one, and what the ERC-20 DIVI token on Ethereum is.

About 8 minutes
Community

Buy DIVI on an Exchange

What buying DIVI on an exchange involves, read from the public market page without an account: the order book, the real cost of a market order at four sizes, the 0.2% fee, how USDT gets there, and what to do the moment the coins arrive.

About 8 minutes
Community

Withdraw DIVI to Your Wallet

Move DIVI from an exchange to a wallet you control: get a receive address, send a small test first, fill in the withdrawal form, watch the coins arrive in Explorer 2.0, and what to do if they do not.

About 7 minutes
Community

Join the Official Divi Telegram

How to find and join the real Divi Telegram group and announcement channel, tell them from look-alikes, and stay safe once you are in.

About 7 minutes
Community

Official Divi Links

Every official Divi link in one place, each one checked live on 2026-10-21, plus the old links that no longer work and how to confirm a link yourself.

About 6 minutes
Community

DIVI Price and Market Cap

What DIVI's price, market cap, supply and volume mean, where to read them, why the trackers disagree, and the one site that shows the wrong DIVI.

About 7 minutes
Community

DIVI in Your Currency

See a DIVI balance or a staking reward in dollars, euros or pounds, record the day's price for your tax file, and check the currency columns on this site against a price tracker before you trust them.

About 6 minutes
Community

Ask the Divi Chatbot

How to use the Divi Assistant on this site: where it is, what it answers well, how to read its sources line, the one-question-a-minute limit, and five real questions with what came back and how right it was.

About 8 minutes
Community

Get Help Safely

Where to ask a Divi question, how to write one that gets answered, what is safe to share (txid, address, version, log lines) and what never is (recovery phrase, private keys, wallet files, config files).

About 6 minutes
Community

Announcements and Upgrades

Where Divi announcements and new wallet versions are posted, how to get told automatically, how to check which version you run and whether you are on the right chain, and how to upgrade a node without touching your wallet.

About 6 minutes

Block explorers

Explorers

A Tour of the Divi Explorers

Explorer 2.0 for mainnet and testnet, the classic explorer, and chainz: what each Divi block explorer shows, how to read it, and when to use which.

About 15 minutes
Explorers

Look Up Any Divi Address

Paste an address into Explorer 2.0 and read its balance, history and staking figures, then check it on chainz.

About 10 minutes
Explorers

Export an Address History

Every transaction of a Divi address as a file: the explorer's CSV button, a CSV link with prices, a CoinTracker import or an OFX statement.

About 10 minutes
Explorers

Read a Block

Open any Divi block in Explorer 2.0 and understand every line: height, hash, time, size, difficulty, confirmations, the coinbase and the coinstake.

About 12 minutes
Explorers

Find the Lottery Winners

Find Divi's weekly lottery block, read the eleven winners off its coinstake, list the current candidates with getlotteryblockwinners, and learn how the draw works.

About 12 minutes
Explorers

Explorer 2.0 and chainz, Side by Side

What Divi's two public block explorers each show, why their balances can differ (staking vaults), and which one to open for which question.

About 10 minutes
Explorers

Watch New Blocks Live

Open the Divi ZMQ viewer, read each block and transaction card as it arrives, filter and pause the feed, and check a block against the explorer.

About 8 minutes
Explorers

Use the Explorer over Tor

Open Divi's Explorer 2.0 through Tor Browser, on the Divi .onion address, and how to send curl and scripts through Tor.

About 10 minutes
Explorers

Query the Chain Yourself

Fetch block, address and network data from Divi mainnet with curl: the RPC service behind Explorer 2.0, the classic explorer API and chainz, with real replies.

About 15 minutes
Explorers

A Walk Through the RPC Playground

Ask a Divi node questions by clicking: pick a method, send a request, read the answer, then copy it as curl, Python or JavaScript.

About 10 minutes

Staking

Staking

How Divi Staking Works

What staking is, who gets to make the next block, what a stake pays today, and how often you can expect one.

About 12 minutes
Staking

Stake in a Wallet

Turn staking on in IronDivi, Divi Desktop or BoxWallet, unlock an encrypted wallet safely, and read the status line.

About 10 minutes
Staking

Stake from the Command Line

Unlock an encrypted wallet for staking only and read getstakingstatus line by line, on the Divi node and on IronDivi.

About 12 minutes
Staking

Why isn't my wallet staking?

Seven checks in the order they usually turn out to be the cause, with the exact wallet message and the fix for each, and how long a stake should take.

About 8 minutes
Staking

Split and combine coins

The Divi node's split and auto-combine rules from source, how to change them, and how to cut a balance into staking-sized coins by hand, shown on testnet.

About 10 minutes
Staking

Estimate your stakes

How often a wallet your size should stake, from the explorer's Staking Intelligence tab, the sum by hand, and the Stake Watch bot's /check, with the slow and overdue thresholds explained.

About 9 minutes
Staking

Stake on a VPS

Run IronDivi or the Divi node as a service on a rented Linux server: vault or wallet route, server size, a divi user, ufw, systemd units, unlocking after restarts, crash recovery, and what we could not test.

About 12 minutes
Staking

Stake on a Raspberry Pi

Pick the right IronDivi or Divi node download for your Raspberry Pi, run it as a service, and see what we could and could not test without a Pi.

About 10 minutes
Staking

Stake alerts in Telegram

Get a Telegram message from the Stake Watch bot for every stake and lottery win on your Divi address, and a warning when stakes stop.

About 5 minutes
Staking

Track your staking returns in a spreadsheet

Export a Divi address history from Explorer 2.0 as CSV, load it into a free Google Sheets template, and see your staking rewards, yield and projected future balance.

About 25 minutes
Staking

Staking rewards and taxes

Download a year of Divi staking rewards as a CSV or OFX file valued in dollars or euros, spot the reward and lottery rows, and find what your tax office says. Not tax advice.

About 10 minutes
Staking

The Divi lottery

Who gets a lottery ticket, how the weekly winners are picked, how a win shows in your wallet, and a real draw replayed from the chain.

About 8 minutes

Vaults

Vaults

What a Vault Is

The owner key, the manager key, and how Divi lets someone stake your coins without ever being able to spend them.

About 10 minutes
Vaults

Create a Vault

Pick an owner address, get a manager address, build the owner:manager encoding, and fund it. Why addvault is the manager's step, not yours.

About 15 minutes
Vaults

Fund a Vault

Fundvault with IronDivi, divi-cli, the Divi Desktop debug console and BoxWallet: the plain form, manager-only form, JSON with repetitions, and what each error means.

About 15 minutes
Vaults

Decompose a Vault

Take a vault encoding, funding transaction or script hex apart: which address owns it, which manages it, and whether either key is in your wallet.

About 10 minutes
Vaults

Add a Vault to the Manager's Wallet

The manager side: addvault with IronDivi, divi-cli (vault=1 first), the Divi Desktop debug console and BoxWallet, and how to confirm the coins are staking.

About 10 minutes
Vaults

Take Your Coins Back: reclaimvaultfunds

The owner pulls coins out of a vault with IronDivi, divi-cli, the Divi Desktop debug console and BoxWallet, including receiver_pays, sweep_funds and metadata, and the IronDivi owner-wallet limitation.

About 15 minutes
Vaults

Spend From a Named Vault: debitvaultbyname

Pay from one vault and keep the change staking in it. divi-cli, the Divi Desktop debug console and BoxWallet, and why IronDivi refuses this command today.

About 10 minutes
Vaults

Remove a Vault From the Manager's Wallet

Removevault forgets a vault in the staking wallet and touches nothing on the chain. IronDivi, divi-cli, the Divi Desktop debug console and BoxWallet, plus how to undo it.

About 5 minutes
Vaults

Vault Errors: Every Message and Its Fix

Each vault command's error messages on IronDivi and Divi Core, produced on testnet, with the cause and the fix, plus the silent failures that print no error at all.

About 6 minutes
Vaults

Vault Security: What a Manager Can and Cannot Do

The vault script explained, and the proof: two manager wallets ordered to take the owner's coins, every attempt refused. What the owner must protect, and how to test a manager before trusting them.

About 10 minutes
Vaults

Run a Vault Staking Service

Stake other people's coins without ever holding their keys: node setup for IronDivi and Divi Core, one address per client, onboarding, monitoring, fees, and the limits you must tell clients about.

About 15 minutes
Vaults

Move a Vault to a New Manager

Sweep the old vault, fund a new one with the new manager's address, and have them add it: the exact steps run on testnet with Divi Core and IronDivi, the fees, and the coin-age cost.

About 15 minutes

Running a node

Running a node

The easy way: a Divi node with BoxWallet

Install BoxWallet, let it download and start the Divi node, watch it sync, back up the recovery phrase, and use the receive, send and settings tabs.

About 9 minutes
Running a node

Install IronDivi

Download IronDivi v0.2.5 for Linux or Mac (or build it from source), start it on Divi testnet, save the recovery phrase, and check that it is syncing.

About 15 minutes
Running a node

A tour of irondivi-cli

Every question you can ask a running IronDivi node with irondivi-cli: network, chain, wallet, transactions, staking, signing, help and errors. Real testnet answers.

About 20 minutes
Running a node

IronDivi vs the C++ node

The two Divi node programs compared side by side: files, ports, options, commands, answers, memory, disk and sync time, and which one to run.

About 8 minutes
Running a node

Install the Divi node

Download the original Divi node (C++ v3.0.0), run it on Divi testnet and check that it is talking to the network. Linux, Mac and Windows.

About 15 minutes
Running a node

Config files explained

Every line of divi.conf and irondivi.conf explained: format, defaults, what IronDivi ignores, and the traps that make a node ignore your file.

About 10 minutes
Running a node

Get the chain faster

How long a Divi node takes to sync, why the public snapshot has no checksum, and how to copy and check the chain from your own divid 3.0.0 or IronDivi node, tested on testnet.

About 4 minutes
Running a node

Run your node as a service

A systemd service file for IronDivi or the original Divi node so it starts at boot, stops cleanly and restarts after a crash, with what a crash really does to each node.

About 5 minutes
Running a node

Run a node in Docker

Build a Docker image for IronDivi or the original Divi node from the official release file with a checked fingerprint, and run a testnet node that keeps its data, restarts after a crash and keeps its command port private.

About 7 minutes
Running a node

Upgrade a node

Upgrade IronDivi without losing your wallet or chain: check the release, stop the node, back up the wallet, swap the programs, check the result, and go back if you need to.

About 4 minutes
Running a node

Recover a chain

Repair a Divi node after a crash: save the wallet, -recoverblockdb, -forcestart and -reindex for divid 3.0.0, and a clean resync for IronDivi, all tested on testnet.

About 6 minutes
Running a node

Run a node over Tor

Send a Divi node through Tor and give it an onion address, tested on testnet with divid 3.0.0 and Tor 0.4.9.

About 4 minutes

Testnet and developers

Testnet

Get Testnet DIVI

Run a Divi testnet node with divid or IronDivi, make a testnet address, get free testnet DIVI from the faucet, and send it back when you are done.

About 30 minutes
Testnet

Testnet in the Wallets

Use Divi testnet in the IronDivi Web Wallet, the IronDivi browser extension (preview) and the IronDivi Telegram wallet: switch network, get faucet coins with /faucet, and see which RPC, paths and faucet calls each wallet uses.

About 15 minutes
Developers

Talk to a Divi Node from Python and JavaScript

Turn on JSON-RPC on a divid or IronDivi node, call it with curl, Python and Node.js, use the public read-only testnet endpoint, send batches, and handle errors from both node types.

About 25 minutes
Developers

React to New Blocks and Transactions with ZMQ

Turn on the Divi node's ZeroMQ publisher, subscribe from Python or JavaScript, read the three-frame messages, and act on every new block and transaction.

About 20 minutes
Developers

Accept DIVI Payments on Your Website

Give every invoice its own Divi address, watch for the payment with your node's wallet RPC, the public address index or ZMQ, and decide how many confirmations to wait for. Proven on testnet.

About 25 minutes
Developers

The Browser Extension API (preview)

How a web page talks to the IronDivi browser extension through window.irondivi: detect it, connect, read the balance, sign a message and verify it, send a testnet transaction, sign a raw transaction. A preview read from the source; the extension is not installable yet.

About 20 minutes
Developers

Prove You Own an Address: Sign and Verify a Message

Prove you own a Divi address by signing a message with signmessage in IronDivi or divid, and check any signature with verifymessage, including on the public testnet RPC.

About 15 minutes
Developers

Raw Transactions and Multisig

Build, sign and broadcast a Divi transaction by hand with createrawtransaction, signrawtransaction and sendrawtransaction, then make a 2-of-2 multisig address, fund it and spend it with two signatures. Every step run on testnet.

About 25 minutes

Regtest: your own private Divi chain

Regtest

What Regtest Is

What a Divi regtest chain is, how it differs from testnet and mainnet (ports, folders, rewards, maturity, who makes blocks), and when to use each.

About 8 minutes
Regtest

Start a Regtest Node

Run a private Divi regtest node: write divi.conf, start divid, make your first 100 blocks with setgenerate, send yourself a payment, and stop or reset the chain.

About 10 minutes
Regtest

Two Regtest Nodes on One Computer

Run C++ Divi and IronDivi together on a private regtest chain: C++ makes the blocks, IronDivi follows, and payments travel both ways between them.

About 12 minutes
Regtest

Give Yourself Coins on Regtest

Where regtest coins come from, when a block reward matures, what changes after block 100 (staked blocks, treasury and lottery), and how to put exact amounts on test addresses.

About 15 minutes
Regtest

Vaults on Regtest

Owner and manager nodes on a private Divi chain: fund a vault, watch the manager stake it, then debit, reclaim and remove it, with every command and its real output.

About 25 minutes
Regtest

A Chain You Can Rebuild

A script that builds the same regtest chain in five seconds, what changes between runs and what does not, and how to snapshot a chain so it comes back byte for byte.

About 15 minutes
Regtest

Test Your App on Regtest

Talk to a Divi regtest node from curl, Python and JavaScript, confirm or hold back payments on demand, test every error path, and react to new blocks and payments.

About 20 minutes
Regtest

Atomic Swaps on Regtest

Run the Divi half of an atomic swap on your own regtest chain: lock coins in hash time-locked contracts, claim with the secret, watch early refunds fail and the real refund work, and see what a full two-chain swap still needs.

About 25 minutes

Games and sidechains

Games

What a Divi Sidechain Is

How the Divi Games gamechain works: one sequencer, accounts that are Divi addresses, moves that are Divi signed messages, a Divi checkpoint in every block, anchors written to Divi testnet, and the bridge and HTLC paths for value. Every claim checked against the live chain.

About 10 minutes
Games

Run the Gamechain on Your Own Computer

Build divi-gamechain from source, make a sequencer key, write the config, run a gamechain of your own against Divi testnet, claim GOLD from its faucet with the SDK, replay it, and restart it. Every command run for real.

About 15 minutes
Games

Sign in with your Divi address

How Divi Games knows it is you without a password: your account is a Divi address, every action is a signed message, and the node verifies it by recovering your public key. With real signatures, a real transaction and the real error messages.

About 12 minutes
Games

Build Tic-Tac-Toe

Build a game module for the Divi gamechain, step by step: the GameModule trait, state keys, the real tic-tac-toe code for create, join, move, cancel and claim_timeout, its tests, and a full game played on the live testnet with the SDK.

About 20 minutes
Games

Build Blackjack: Fair Cards from a Committed Hash Chain

How the Divi Games blackjack module deals cards nobody can predict or choose: a committed hash chain, the exact card formula, the ops, state and payouts, two real hands on the live testnet, and a Node script that recomputes every card.

About 20 minutes
Games

Build Tower Defense

A Divi gamechain game the node replays to check your score: the deterministic dg-td simulation, its plain extern C wasm boundary, the wasm rebuilt and hashed, the golden-vector test, the towerdefense module, and a real run started, played from Node and submitted on the live testnet.

About 20 minutes
Games

The Trading Game

How the Divi Games order book works, what a trading season is, and how to write a bot for it: prices, escrow, matching, the limits, seasons, the house market-maker, all run for real on a gamechain node.

About 20 minutes
Games

The JavaScript SDK: put a game on your own page

Every export of divigames.js, how the vendored dependencies are laid out, how to put the SDK on your own page, and a complete minimal page that makes a guest key, claims GOLD and opens a tic-tac-toe table on the live Divi gamechain.

About 15 minutes
Games

Anchors and the tDIVI Bridge

How the Divi gamechain writes its block hash and state root into Divi testnet every N blocks, how to decode and check an anchor, and how testnet DIVI crosses the custodial bridge in both directions. Every command run for real on a gamechain node.

About 25 minutes
Games

Deploy Your Game

Put the Divi gamechain and the games site on your own test host as two hardened systemd services behind nginx, with deploy/deploy.sh from the divi-games repo. Every command run for real, twice.

About 20 minutes

Keeping your DIVI safe

Safety

Cold Storage and a Paper Wallet

Keep DIVI offline on a BIP38 paper wallet with bip38paperwallet, store the paper and its passphrase safely, bring the coins back with bip38decrypt, and keep an encrypted wallet backup next to your recovery phrase.

About 40 minutes
Safety

Inheritance: Make Sure Your Family Can Get to Your DIVI

Put your DIVI recovery phrase, wallet passphrase and encrypted backup in one password-manager entry, turn on emergency access (Proton Pass, Bitwarden, Keeper, 1Password, Dashlane, Apple), write the letter, and rehearse the recovery on testnet.

About 60 minutes
Safety

Harden a Staking Server: Firewall, SSH Keys and Automatic Updates

Lock down a Divi staking server with ufw, key-only SSH in a drop-in sshd config, unattended-upgrades, RPC kept on localhost and a staking-only wallet unlock, each step tested from a second terminal before the next.

About 45 minutes
Safety

Rescue a Wallet: a Forgotten Passphrase, an Old wallet.dat, a Missing Balance

Step-by-step tutorial, tested on testnet: open an old Divi wallet.dat in Divi Core 3.0.0, test your own passphrase guesses, recover from a damaged wallet file using the automatic backups, the phrase or a Berkeley DB salvage, find a missing balance, and move old keys into IronDivi.

About 30 minutes
Safety

A Yearly Checkup for Your DIVI

A once-a-year checklist for DIVI holders. Check wallet software versions, backups and the recovery phrase, test the wallet passphrase safely, review your password-manager entry and paper wallets, confirm vault managers are still staking, and save the year's tax export.

About 20 minutes
Safety

Masternodes on Divi: What They Were

History, not a setup guide: what Divi masternodes were, their five collateral tiers and 405 DIVI block share, why Divi 3.0 ended them in August 2023, and how to unlock old masternode collateral so it can stake.

About 15 minutes

New tutorials are added as each one is tested. Questions in the meantime? Try the Divi chatbot.