Installation

autheod is the unified Autheo Chain binary combining CometBFT consensus, Cosmos SDK application logic, and the Ethermint EVM runtime in a single process.

Option A: Pre-built binary (recommended)

Download the latest release

curl -L -o autheod \
  https://github.com/autheo-blockchain/autheo-chain-core/releases/latest/download/autheod

Make executable and move to PATH

chmod +x autheod
sudo mv autheod /usr/local/bin/

Verify the version

autheod version

Expected output: 1.0.8

Option B: Build from source

Requirements: Go 1.23.12, GCC/Clang, Git, Make.

Install Go 1.23.12

wget https://go.dev/dl/go1.23.12.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.12.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

Clone the repository

git clone https://github.com/autheo-blockchain/autheo-chain-core.git
cd autheo-chain-core

Build

Standard build
With RocksDB

make build

COSMOS_BUILD_OPTIONS=rocksdb make build

Verify and install

./build/autheod version  # Expected: 1.0.8
make install

Initialize the node

autheod init <moniker> \
  --chain-id autheo_2127-1 \
  --home /path/to/node-home

Download the genesis file

curl -L -o /path/to/node-home/config/genesis.json \
  https://raw.githubusercontent.com/autheo-blockchain/networks/main/mainnet/genesis.json

Bootstrap from a snapshot (optional)

wget https://snapshot.autheo.com/data_backup_latest.tar.gz
sudo systemctl stop autheod
rm -rf /path/to/node-home/data/
tar xzvf data_backup_latest.tar.gz
mv data/ /path/to/node-home/data/

After restoring from a snapshot, always restore your own priv_validator_state.json from a secure backup. Never use the state file from a public snapshot.

Troubleshooting

Problem	Cause	Fix
Command not found	`/usr/local/bin` not in `$PATH`	`export PATH=$PATH:/usr/local/bin`
Permission denied	Binary not executable	`sudo chmod +x /usr/local/bin/autheod`
Exec format error	Wrong architecture binary	Check `uname -m`; use `linux-amd64` for x86_64
Version conflict	Old binary in PATH	Remove old binary before installing new one

Start Here

Getting Started

Web Apps

Developers

APIs

Node operations

SDKs

Papers

Option A: Pre-built binary (recommended)

Option B: Build from source

Initialize the node

Download the genesis file

Bootstrap from a snapshot (optional)

Troubleshooting

​Option A: Pre-built binary (recommended)

​Option B: Build from source

​Initialize the node

​Download the genesis file

​Bootstrap from a snapshot (optional)

​Troubleshooting

Option A: Pre-built binary (recommended)

Option B: Build from source

Initialize the node

Download the genesis file

Bootstrap from a snapshot (optional)

Troubleshooting