ggxchain / transaction-receipt-relayer

transaction-receipt-relayer

This repository contains an Ethereum transaction receipt relayer for the GGX network. The relayer verifies finalized blocks using Helios light client. The relayer requires a Beacon and Consensus RPC node, which updates and blocks will be verified. It will relay transaction receipts for the smart contracts list managed by the pallet in this repository.

Install dependencies

sudo apt install libsqlite3-dev

Run

1. Run 2 nodes

export ETH1_INFURA_API_KEY=$(INFURA_API_KEY)

./target/release/ggxchain-node \
    --alice \
    --chain=dev \
    --port=30333 \
    --rpc-port=9944 \
    --base-path=/tmp/alice \
    --rpc-cors=all \
    --node-key=0000000000000000000000000000000000000000000000000000000000000001 \
    --light-client-relay-config-path eth-relay.toml \
    --light-client-init-pallet-config-path eth-init.toml

./target/release/ggxchain-node \
    --bob \
    --chain=dev \
    --port=30334 \
    --rpc-port=9945 \
    --base-path=/tmp/bob \
    --rpc-cors=all \
    --bootnodes=/ip4/127.0.0.1/tcp/30333/p2p/12D3KooWEyoppNCUx8Yx66oV9fJnriXwCcXwDDUA2kj6vnc6iDEp

2. Update INFURA_API_KEY and checkpoint in helios.toml

3. Run transaction-receipt-relayer

RUST_LOG=info cargo run --release -- --network sepolia --database db --helios-config-path helios.toml --substrate-config-path ggxchain-config.toml

How check that it works?

You can see an Ethereum client event in the explorer about 1 time per 10 minutes.

Configs

• GGX config

  Field	Definition
  is_dev	if set to true the Alice account will be used, and the phrase will be ignored
  ws_url	GGX RPC endpoint
  phrase	Account for signing transaction.

• Helios config

Please note that you need to update helios.toml checkpoint from time to time.

Action points to look

• Check how it works if multiple relayers are working simultaneously.
• Optimize batch sending of receipts.
• Remove blocks older than X

transaction-receipt-relayer's Issues

Unified Data Directory Environment Variable

Description

Rather than setting DB_PATH and HELIOS_HOME_PATH, set a single environment variable to be shared for all data gathered by the light client.

Definition of "Done"

Require only one environment variable set to determine where data is stored.

Factor Out Events Being Listened to Into Environment Variable

Description

Rather than listening for a hard-coded event, the event being listened for should be configurable via an environment variable.

Definition of "Done"

Introduce an environment variable for setting events we are listening for.

Prepare & Deploy ETH relayer for Brooklyn

Process `bloom positive` blocks to generate merkle proofs.

Send generated merkle proofs to the `ggxchain`

Todo:

• Send generated Merkle proofs to the chain using pallet-receipt-registry
• Maintain some accounts with balances to send transactions and receive rewards or pay deposits.

Implement bloom filtering

Filtering for contract addresses in saved blocks

Save block info for light client

Description

We need to change the stored value for our light client db implementation.
The light client should save the following:

• blocks_table: block_height: u64 -> (execution_payload_hash: H256, execution_payload_header: ExecutionPayloadHeader, queried_for_receipts: bool)
• latest_seen: (block_height, execution_payload_hash)

Definition of "Done"

• Light client saves data using below scheme
• Light client uses latst_seen to bootstrap when it comes online

Useful links

Ethreum Documentation

Removed unused and dead code

Make cleanup and remove dead code from transaction-receipt-relayer repository.

Continuous Integration

Description

We should run unit upon each PR.

Definition of "Done"

Configure GitHub to run unit tests upon each PR.