Documentation Index
Fetch the complete documentation index at: https://docs.autheo.com/llms.txt
Use this file to discover all available pages before exploring further.
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-lab/releases/latest/download/autheod
Make executable and move to PATH
chmod +x autheod
sudo mv autheod /usr/local/bin/
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-lab.git
cd autheo-chain-lab
Build
Standard build
With RocksDB
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_785-1 \
--home /path/to/node-home
Download the genesis file
curl -L -o /path/to/node-home/config/genesis.json \
https://github.com/autheo-blockchain/autheo-chain-lab/releases/latest/download/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 |
