Runbook
Error decoding and operator actions
Fast map from common revert reason to concrete next action in dApp operations.
1. Common reverts
| Message / Signature | Meaning | What to do |
|---|
| `Alliance: unsupported token` | Transfer delta does not match expected amount | Use standard ERC20 token without fee/rebase side effects |
| `Alliance: quorum not reached` | Current vote weight below threshold | Collect additional participant votes or adjust proposal flow |
| `Alliance: no acquisition proposal` | Buy called before proposal init | Run `voteToAcquire` first with valid tuple |
| `Alliance: acquisition expired` | Proposal deadline passed | Call `resetAcquisitionProposal` then create new proposal |
| `Faucet: cooldown active` | Claim attempted before cooldown ended | Wait for timer or switch to wallet that is ready |
| `0xe450d38c` | `ERC20InsufficientBalance` on faucet transfer | Top up faucet liquidity from token owner wallet |
| `User rejected` / `4001` | Wallet signature denied by user | Resubmit tx and confirm in wallet popup |
2. Operator checklist before public testing
- Verify network, chainId, and deployed addresses in frontend env.
- Verify faucet token liquidity and cooldown configuration.
- Run full smoke path: create, deposit, acquire vote, buy, sale vote, execute.
- Check Etherscan links from docs and homepage status section.
- Publish changelog and migration notes with each core release.