Axelar Interchain Governance Orchestrator

Axelar Interchain Governance Orchestrator is a project that enhances on-chain governance protocols to facilitate interchain proposal execution. We demonstrate the extension using Compound's governance contracts, but the approach can be applied to any governance protocol.

Key Components

There are two essential contracts in this interchain extension:

1. InterchainProposalSender: Deployed on the source chain, this contract has a method called sendProposal. This method encodes a proposal into a payload for a remote chain and pays the Axelar Gas Service for the execution of the interchain call on the destination chain.

2. InterchainProposalExecutor: Deployed on the destination chain, this contract has a callback method _execute that executes the proposal on the target contracts.

For a visual transaction flow of the interchain proposal, see the mermaid diagram below.

flowchart
    subgraph "Destination Chain Contracts"
        direction TB
        PE{{InterchainProposalExecutor Contract}}
        PE -.->|Calls| TargetA
        PE -->|Calls| TargetB
        PE -.->|Calls| Target
        TargetA[Contract ..]
        TargetB[Contract A]
        Target[Contract ..]
    end

    subgraph "Axelar Interchain Proposal Sender"
        direction TB
        IPS -->|Encode & Submit| AxelarGateway
        AxelarGateway -.->|Emit Events| Relayer
        Relayer -.->|Execute| PE
    end

    subgraph "Source Chain Governance"
        direction TB
        Dev -->|Propose| Gov[Governor Contract]
        Gov -->|Vote & Queue| Timelock[Timelock Contract]
        Timelock -.->|Execute Proposal| IPS{{InterchainProposalSender Contract}}
    end

Loading

Getting Started

Get up and running with integrating your governance system using Axelar. Here are a few approaches to help you understand the process:

Prerequisite

• Requires Node v16+

1. Local Testing

To get a feel for the process, start by running local tests. This will help you understand the expected behavior of the system:

yarn install
yarn test

2. Code Review and Experimentation

Understand the codebase better by checking out our sample code. It provides an example of creating a proposal, such as updating a state variable in the DummyState.sol contract on Avalanche from Ethereum. You can find this in sample.md.

3. Integration

Once you're comfortable with the process, use the deployed addresses to integrate your governance system with Axelar.

Interchain Proposal Execution

In order to execute interchain proposals, you can use InterchainProposalSender on all EVM chains supported by Axelar. You can also deploy your own instance of it. On the destination chain, deploy InterchainProposalExecutor and set up access control by whitelisting the InterchainProposalSender sender address and the governance DAO caller address through which proposals can be received.

InterchainProposalSender
0x1f8A4d195B647647c7dD45650CBd553FD33cCAA6

Deployment Guide

To learn more about the deployment process, please follows this guide

Test Coverage Report

For the most recent test coverage report of the main branch, please visit the following page: Interchain Governance Orchestrator Test Coverage.