Troubleshooting Index
Find your symptom. Each entry links to the page that explains the cause and fix.
Transaction rejected by the network
Section titled “Transaction rejected by the network”| Symptom | Page |
|---|---|
MissingRegistryCellDep (code 8) — transaction rejected, registry dep missing | Fix: MissingRegistryCellDep |
AmbiguousRegistryCellDep (code 17) — more than one matching registry dep | Fix: AmbiguousRegistryCellDep |
InvalidRegistryData (code 9) — payload failed to parse | Usually a wrong outpoint — see Fix: stale registry cell |
| Pre-flight passes but transaction fails on-chain | Fix: pre-flight passes, on-chain fails |
SDK errors
Section titled “SDK errors”| Symptom | Page |
|---|---|
fetchRegistryPayload throws “is not live” | Fix: stale registry cell |
| In-flight transaction fails after a governance update | Fix: in-flight failure |
| Temporary entry blocks a spend it should allow | Add header_deps — see How to handle time-based entries |
Governance CLI errors
Section titled “Governance CLI errors”| Symptom | Page |
|---|---|
execute fails: vote digest mismatch | Fix: vote digest mismatch |
vote rejects key: “not in validator set” | Your pubkey is not committed by the validatorMerkleRoot in the registry — see Join governance |
execute fails: review window not met | The proposal anchor has not aged long enough. Check on-chain confirmation time and wait. |
execute fails: threshold not met | Not enough yes-votes. Collect more validator votes via vote and import. |
Not in this list?
Section titled “Not in this list?”Check the full error codes reference for error code definitions from all contracts. For SDK error types, see the TypeScript SDK API or Rust SDK API.