This repository contains the Relayer that allows the Solana Gateway to communicate with Axelar Amplifier API.
The relayer is built of composable plug-n-play items, called components, which can communicate with each other via channels and (optionally) persist in their storage.
- Solana Listener: Receives transaction log data from Solana using WebSockets. Listens to Gas Service and the Gateway.
- Solana Event Forwarder: Parses transaction inner instructions into events and combines the Gas Service events with the Gateway events. Forwards them to the Amplifier component.
- Rest Service: Receives an off-chain payload from the end-user, combines it with an on-chain event and sends it to the Amplifier API.
- Solana Gateway Task Processor: Receives tasks from Amplifier API and composes transactions to interact with the Gateway and the destination contract.
- File-based storage: Simple file-based memory-mapped buffer storage for tracking metadata for different components.
- Retrying Solana HTTP Sender: Solana RPC client wrapped with a retrying mechanism to account for Solana node fluctuations. Used by all components that require Solana RPC access.
- Effective TX Sender: Evaluate the necessary compute budget and unit price and prefix this new instruction inside the transaction.
- Gateway Gas Computation: The Axelar Solana Gateway has a multi-computation model; therefore, figuring out how much money was spent on a single gateway action needs to be summed together based on all the actions that the relayer did across many transactions.
- Solana Contracts: The Solana on-chain contracts and home to some of the utillty crates used in this repository.
- Relayer Core: All Axelar-related relayer infrastructure. Used as a core building block for the Solana Relayer. The Axelar-Starknet and Axlelar-Aleo relayers also use it.
- Rust
- Solana CLI (for running tests during development)
- Surfpool (for gas cost estimation) (docker image).
This relayer depends on Surfpool, a Solana state forking service that enables accurate gas cost estimation by running transactions on forked cluster state. Surfpool is used by the Solana Gateway Task Processor component for estimating execution costs.
An official Docker image is available at surfpool/surfpool. Here's how to run it:
# Run Surfpool for devnet
docker run -p 8899:8899 surfpool/surfpool:latest start --slot-time 1 --no-tui -n devnet
# Run Surfpool for testnet
docker run -p 8899:8899 surfpool/surfpool:latest start --slot-time 1 --no-tui -n testnet
# Run Surfpool for mainnet
docker run -p 8899:8899 surfpool/surfpool:latest start --slot-time 1 --no-tui -n mainnetImportant: Currently, only ARM64 Docker images are available for Surfpool. If you're running on a different architecture (x86_64, etc.), you'll need to use QEMU emulation:
-
Install
qemu-user-staticfor cross-architecture support:# On Ubuntu/Debian sudo apt-get install qemu-user-static # On macOS brew install qemu
-
Enable multi-architecture support:
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
-
Run Surfpool with platform specification:
# For devnet docker run --platform linux/arm64 -p 8899:8899 surfpool/surfpool:latest start --slot-time 1 --no-tui -n devnet # For mainnet docker run --platform linux/arm64 -p 8899:8899 surfpool/surfpool:latest start --slot-time 1 --no-tui -n mainnet
For more information about QEMU user static emulation, see the official repository.
git clone [email protected]:eigerco/axelar-solana-relayer.git
cargo xtask test
cargo xtask --help # see what else you can do
# Confgure the config
cp config.example.toml config.toml
# Run the relayer
cargo run -p axelar-solana-relayerAbout Eiger
We are engineers. We contribute to various ecosystems by building low-level implementations and core components. We work on several Axelar and Solana projects, and connecting these two is a fundamental goal to achieve cross-chain execution.
Contact us at [email protected] Follow us on X/Twitter