1How to read an error
Every Divi Core message on this page was produced on testnet on 2026-10-21 with Divi Core 3.0.0 (divi-cli); every IronDivi message was produced again on 2026-10-23 with the IronDivi 0.2.6 release (irondivi-cli) on regtest, a private test chain. The Divi Desktop debug console and BoxWallet run Divi Core, so they print the Divi Core column. The number is the JSON-RPC error code:
| Code | Family |
|---|---|
| -1 | Wrong arguments (Divi Core prints the command's help text instead of a message) |
| -3 | Bad amount |
| -4 | Wallet could not build or sign the transaction |
| -5 | Bad address or encoding |
| -6 | Not enough coins |
| -8 | Bad parameter value |
| -32600 | Request refused (Divi Core addvault key checks) |
2fundvault
| You did | IronDivi says | Divi Core says | Fix |
|---|---|---|---|
| Only a manager address, no colon | -1 Owner address is required for funding vault. Use format: owner_address:manager_address | Succeeds: Divi Core creates a fresh owner address in your wallet (see fund a vault) | Write owner:manager on IronDivi |
| Owner address mistyped | -1 Invalid Divi address: address not found: Invalid address length: 9 | -5 Invalid owner DIVI address | Copy the address again |
| Manager address mistyped | (same as above) | -5 Invalid manager DIVI address | Copy the address again |
| More than you have | -6 Insufficient funds. Have 998.99997 DIVI, need 99999.00003 DIVI | -6 Insufficient funds | Check getbalance |
| Amount missing | -1 Missing required parameter: amount | -1 (help text) | Add the amount |
| Amount 0 or negative | -3 Invalid amount | -3 Invalid amount | Use a positive amount |
JSON form '{"O:M":5}' | -1 Missing required parameter: amount | Works | IronDivi takes only the two-argument form |
| JSON with a bad amount or repetition | n/a | -8 Unable to parse amount for: … / Unable to parse repetitions for: … / Unknown json input. Unable to parse input for … | Numbers only |
3addvault
| You did | IronDivi says | Divi Core says | Fix |
|---|---|---|---|
| No colon in the encoding | -1 Owner address is required. Use format: owner_address:manager_address | -8 Could not parse vault encoding! | Use owner:manager |
| Ran it on the owner wallet (manager key not here) | Success, but nothing is staked: the coins stay under Vaulted | -32600 AddingVaultScript: Does not have matching manager key! | Run it on the manager wallet |
No vault=1 in divi.conf | n/a | -32600 AddingVaultScript: Unable to sync TX! | Add the line and restart |
| Txid missing | -1 Missing required parameter: funding_txhash | -1 (help text) | Add the funding txid |
| Txid is not a hash | -1 Invalid transaction ID: notahash | {"succeeded": false} | Copy the txid |
| Txid is real but pays a different vault | -4 Transaction … does not pay to the specified vault script | {"succeeded": false} | Compare encoding with the explorer |
| Bad manager address | -1 Invalid Divi address… | -5 Vault Registry Failed: Invalid manager DIVI address | Copy again |
| Added twice | Success both times, registered once | Success both times, registered once | Nothing to fix |
4reclaimvaultfunds
| You did | IronDivi says | Divi Core says | Fix |
|---|---|---|---|
| Owner wallet that lacks the manager key | Works | Works | Nothing to fix |
| Not the owner (for example the manager) | -4 No vault funds available to reclaim | -6 Insufficient funds: 100000000(total requested) is greater than 0(total available) | Only the owner can reclaim |
| More than the vaults hold | -6 Insufficient vault funds. Have 50, need 100000.00003 | -6 Insufficient funds: …(total requested) is greater than …(total available) | Ask for less |
| Vault output unconfirmed or just spent | -4 No vault funds available to reclaim | -4 Insufficient funds to meet coin selection algorithm requirements. | Wait one block |
| Destination mistyped | -5 Invalid DIVI address | -5 Invalid DIVI address | Copy again |
| Destination missing | -1 Missing required parameter: diviaddress | -1 (help text) | Add it |
| Amount missing | -1 Missing required parameter: amount | -1 (help text) | Add it |
| Unknown option word | -8 Unknown option for reclaiming vault funds | -8 Unknown option for reclaiming vault funds | receiver_pays, sweep_funds or metadata |
5debitvaultbyname
| You did | IronDivi says | Divi Core says | Fix |
|---|---|---|---|
| A correct call | Works | Works | Nothing to fix |
| Encoding with no colon | -5 Invalid Vault Encoding | -5 Invalid Vault Encoding | owner:manager |
| Owner half not in this wallet | -5 Vault owner key is unknown: address=… | -5 Vault owner key is unknown: ownership=0 address=… | Run it on the owner wallet |
| Destination mistyped | -5 Invalid DIVI address | -5 Invalid DIVI address | Copy again |
| Unknown option word | -8 Unknown option for reclaiming vault funds | -8 Unknown option for reclaiming vault funds | receiver_pays, sweep_funds or metadata |
| More than the vault holds | -6 Insufficient vault funds. Have …, need … | -6 Insufficient funds: …(total requested) is greater than …(total available) | Ask for less |
| Vault output unconfirmed or just spent | -6 No funds available in vault O:M | -4 Insufficient funds to meet coin selection algorithm requirements. | Wait one block |
6removevault
| You did | IronDivi says | Divi Core says | Fix |
|---|---|---|---|
| Encoding only | Works | Works | Nothing to fix |
| Vault never added here | -4 Vault … not found in wallet | {"removal_status": false} (from source, not run) | Check getcoinavailability true |
| No colon | -8 Could not parse vault encoding! | -8 Could not parse vault encoding! (from source, not run) | owner:manager |
7What a manager gets when it tries to spend
These are the messages a manager wallet prints when it attempts to use the owner's coins. They are the proof behind the security tutorial.
# Divi Core manager holding 20 own coins and 170 in vaults
$ divi-cli sendtoaddress DEST 100
error: {"code":-6,"message":"Insufficient funds: 10000000000(total requested) is greater than 1999990080(total available)"}
$ divi-cli reclaimvaultfunds DEST 1
error: {"code":-6,"message":"Insufficient funds: 100000000(total requested) is greater than 0(total available)"}
$ divi-cli debitvaultbyname OWNER:MANAGER DEST 1
error: {"code":-5,"message":"Vault owner key is unknown: ownership=0 address=y8PL1RQSCWYPnJAvhvs6ZwkxfwuB5Ut5Aj"}
# IronDivi 0.2.6 manager holding 50 own coins and 189 in a vault
$ irondivi-cli --testnet sendtoaddress DEST 100
error code: -6: Insufficient funds. Have 48.99997 DIVI, need 100.00003 DIVI
$ irondivi-cli --testnet reclaimvaultfunds DEST 1
error code: -4: No vault funds available to reclaim
$ irondivi-cli --testnet debitvaultbyname OWNER:MANAGER DEST 1
error code: -5: Vault owner key is unknown: address=yHZ7CNR7ArAMpgS9TnfH3Jf32knX56gLSw
The 1,999,990,080 in the first line is the manager's own 19.9999 coins in satoshis; the 170 vaulted coins are not counted as available. IronDivi 0.2.6 does the same: it offered only the manager's own 48.99997 (after a 1-coin send it made from them without trouble), never the vault. Its lines are from regtest, a private test chain.
8Silent failures: no error, wrong result
- Divi Core
fundvault "manager" 100succeeds and invents an owner address in your wallet. Fine if you meant it; if you were copying someone's instructions you may now have a vault whose owner key you did not know about.getcoinavailability trueshows the encoding. - Divi Core
reclaimvaultfundsfor a part sends the rest to a plain change address. The vault looks like it vanished. It did; the coins are in your normal balance. sweep_fundsignores the amount and sends whole vault inputs.- IronDivi
reclaimvaultfundsfor a part returns the rest to the same vault, unlike Divi Core. - IronDivi
addvaulton the owner wallet says success but stakes nothing; the coins stay under Vaulted. Run it on the manager.
Still stuck? Ask the Divi chatbot.