01Executive Summary
Atomic Governance Rollback is JIL Sovereign's protocol for executing governance decisions across multiple blockchains with strict all-or-nothing atomicity. The protocol uses a three-phase commit model - Propose/Vote, Prepare, Execute/Rollback - that ensures all target chains either adopt the new governance state or retain their previous state, with no intermediate or inconsistent states possible.
This solves the "split-brain" governance problem where a governance change succeeds on some chains but fails on others, leaving the protocol in an inconsistent state. The Prepare phase distributes Merkle proofs of approved proposals to all target chains, where bridge contracts validate the proofs and lock governance state. Execution must complete within a bounded window of 2 blocks, and if any chain reports failure, automatic rollback reverts all chains to their pre-execution state.
02Problem Statement
As protocols expand to operate across multiple blockchains, governance execution becomes increasingly fragile. A parameter change, contract upgrade, or policy update that must be applied consistently across all chains can fail partially, leaving the protocol in an inconsistent state that is difficult or impossible to resolve.
Split-Brain Governance
Consider a protocol that operates on Ethereum, Solana, and JIL L1. A governance vote approves changing the bridge fee from 10 basis points to 5 basis points. The change executes successfully on Ethereum and JIL L1 but fails on Solana due to a transaction timeout. Now the protocol has two different fee structures simultaneously, creating arbitrage opportunities and user confusion. Resolving this requires another governance vote specifically for Solana, which may take days.
No Rollback Mechanism
Existing cross-chain governance systems (Compound Governor Bravo, Aave Governance v3, Uniswap Governance) have no mechanism to roll back a change that succeeded on some chains when it fails on others. Once a governance transaction is executed on a chain, it is permanent. The only recourse is a new governance proposal to reverse the change, which must go through the full voting cycle.
Timing Inconsistency
Different chains have different block times, finality models, and congestion patterns. A governance change that executes at block N on Ethereum may not execute until minutes or hours later on Solana, during which the protocol operates with inconsistent parameters across chains.
03Technical Architecture
The protocol operates in three distinct phases, each with cryptographic guarantees and bounded time windows.
Three-Phase Commit Model
| Phase | Duration | Actions | Failure Mode |
|---|---|---|---|
| Phase 1: Propose/Vote | Configurable (default 7 days) | Proposal submitted on primary chain; token holders vote; quorum and approval threshold verified | Proposal rejected if quorum or threshold not met |
| Phase 2: Prepare | Bounded (max 1 hour) | Merkle proofs distributed to target chains; bridge contracts validate proofs and lock governance state | Rollback if any chain fails to acknowledge within window |
| Phase 3: Execute/Rollback | Bounded (2 blocks per chain) | All chains execute simultaneously; status reported back; automatic rollback if any failure detected | Full rollback on all chains to pre-execution state |
Prepare Phase Detail
Proposal approved on primary governance chain (JIL L1)
|
+--> Generate Merkle proof of approved proposal
| Proof includes: proposal_hash, vote_tally, quorum_met, block_height
|
+--> Distribute Merkle proof to all target chains via bridge
| Each target chain's bridge contract:
| 1. Validates Merkle proof against known JIL L1 state root
| 2. Verifies proposal_hash matches expected governance change
| 3. Locks current governance state (no changes permitted)
| 4. Enters PREPARED state
| 5. Reports acknowledgment back to primary chain
|
+--> Primary chain collects acknowledgments
| All target chains must acknowledge within 1 hour
| If any chain fails to acknowledge: abort and unlock all chains
|
+--> All chains in PREPARED state - proceed to Execute phase
Execute/Rollback Phase Detail
Primary chain broadcasts EXECUTE signal to all target chains
|
+--> Each target chain has 2 blocks to execute governance change
| Execution is atomic within each chain (single transaction)
| Chain reports SUCCESS or FAILURE back to primary
|
+--> Primary chain evaluates results
|
+--> If ALL chains report SUCCESS:
| Governance change is finalized on all chains
| State locks released
| Transition recorded in governance history
|
+--> If ANY chain reports FAILURE:
Primary chain broadcasts ROLLBACK signal
All chains revert to locked pre-execution state
State locks released
Governance change marked as ROLLED_BACK
Detailed failure report generated
04Implementation
The atomic governance protocol is implemented through governance contracts on each supported chain and a coordination layer within the corridor-governance service.
Governance Contract State Machine
Each target chain runs a governance receiver contract that implements a strict state machine: IDLE (accepting new proposals), PREPARED (governance state locked, awaiting execute signal), EXECUTING (governance change in progress), and ROLLING_BACK (reverting to pre-execution state). Transitions between states require valid Merkle proofs signed by the JIL validator set.
State Locking Mechanism
When a governance receiver contract enters the PREPARED state, it captures a snapshot of all governance-relevant state variables (fees, thresholds, authorized addresses, parameters) and prevents any modifications. This snapshot serves as the rollback target if execution fails. The lock has a maximum duration of 2 hours - if neither EXECUTE nor ROLLBACK is received within this window, the contract automatically unlocks and returns to IDLE.
Cross-Chain Communication
Governance signals (PREPARE, EXECUTE, ROLLBACK) are transmitted through JIL's Merkle Bridge infrastructure. Each signal is a Merkle-proven message from the primary governance chain, verified by the bridge contracts on each target chain. This reuses the existing 14-of-20 validator attestation scheme, ensuring governance signals have the same security guarantees as asset transfers.
05Integration with JIL Ecosystem
Atomic governance rollback integrates with JIL Sovereign's multi-chain infrastructure to provide consistent protocol management.
Merkle Bridge
Governance signals are transmitted through the same 14-of-20 validator-attested bridge used for asset transfers. This ensures governance execution has BFT-grade security without requiring separate infrastructure.
Corridor Governance
The corridor-governance service orchestrates the three-phase commit across all target chains. It manages the prepare/execute/rollback lifecycle and maintains a complete audit trail of all governance execution attempts.
Policy Registry
Policy changes (fee updates, threshold modifications, zone parameter adjustments) flow through the atomic governance protocol when they affect multiple chains, ensuring policy consistency across the entire JIL deployment.
Upgrade Drill
The upgrade-drill service performs periodic dry runs of governance execution on testnets to validate that the atomic protocol functions correctly before real governance proposals are submitted for vote.
06Prior Art Differentiation
JIL's atomic governance rollback is the first protocol to provide strict atomicity guarantees for cross-chain governance execution.
| Feature | Compound Gov Bravo | Aave Gov v3 | LayerZero OApp | JIL Atomic Governance |
|---|---|---|---|---|
| Cross-Chain Execution | Single chain only | Multi-chain (sequential) | Multi-chain (async) | Multi-chain (atomic) |
| Rollback on Failure | Not applicable | No rollback | No rollback | Automatic full rollback |
| State Locking | Timelock only | Timelock only | No locking | Snapshot + lock during prepare |
| Execution Bound | Unbounded | Unbounded | Unbounded | 2 blocks per chain |
| Consistency Guarantee | Single chain | Eventually consistent | Eventually consistent | Strictly atomic (all or none) |
| Proof Distribution | Not applicable | Bridge messages | Oracle messages | Merkle proofs via validator bridge |
07Implementation Roadmap
Primary Chain Governance
Deploy governance contract on JIL L1 with propose/vote/queue/execute lifecycle. Implement Merkle proof generation for approved proposals. Build corridor-governance orchestration service.
Cross-Chain Prepare Phase
Deploy governance receiver contracts on Ethereum and Solana. Implement state locking and snapshot mechanism. Build Merkle proof distribution through bridge infrastructure. Test prepare/acknowledge flow.
Atomic Execute/Rollback
Implement bounded execution window with 2-block limit. Build automatic rollback mechanism triggered by any chain failure. Deploy governance audit trail with complete execution history. Run upgrade drills on testnet.
Full Multi-Chain and Analytics
Extend to Polygon, Arbitrum, Base, and Avalanche. Build governance analytics dashboard showing proposal history, execution success rates, and rollback events. Implement governance simulation for pre-vote impact analysis.