Overview
AtomOne is a constitutionally governed, minimalist L1 blockchain and neutral interchain hub. It’s built as a secure base layer rather than a feature-heavy app chain, focusing on routing value and security between many blockchains via IBC and shared security.
Core pieces:
AtomOne Hub – the main chain that provides security, IBC connectivity and Interchain Security to connected consumer chains, while letting them stay sovereign and specialize (DeFi, infra, etc.).
-
ATONE – the staking and governance token, used to secure the network and vote on proposals, including constitutional changes.
-
PHOTON – the dedicated fee and payment token for the hub and its connected environment, created only by burning ATONE and capped in total supply.
-
Constitution & DAOs – an on-chain constitution plus a set of DAOs (steering, oversight, treasury, etc.) that define and enforce how the protocol, economics and governance can evolve.
By separating security (ATONE) from everyday usage and fees (PHOTON), and by grounding upgrades in a formal constitution, AtomOne aims to be a long-term, predictable hub for an interchain ecosystem rather than just another experimental application chain.
Public Endpoints
| Type | Endpoint | Link |
|---|---|---|
| RPC | https://atomone-mainnet-rpc.crouton.digital | |
| API | https://atomone-mainnet-api.crouton.digital | |
| gRPC | atomone-mainnet-grpc.crouton.digital:30690 | |
| peer | [email protected]:30656 |
Hardware requirements
Recommended server specs for an AtomOne validator: 16 GB RAM, 8 CPU cores, and 250 GB NVMe storage.
Prepare
Update and install packages
sudo apt update && sudo apt upgrade -y && \ sudo apt install -y curl git wget jq make gcc clang tmux screen htop ncdu unzip tar lz4 bc build-essential pkg-config libssl-dev libleveldb-dev bsdmainutils fail2ban
Installing Go
VER="1.22.10" && \ cd $HOME && \ wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz" && \ sudo rm -rf /usr/local/go && \ sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz" && \ rm "go$VER.linux-amd64.tar.gz" && \ mkdir -p $HOME/go/bin && \ grep -qxF 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' $HOME/.bash_profile || echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> $HOME/.bash_profile && \ source $HOME/.bash_profile && \ go version
Binary
Building from source
cd $HOME && \ rm -rf atomone && \ git clone https://github.com/atomone-hub/atomone atomone && \ cd atomone && \ APP_VERSION="v3.2.0" && \ git checkout tags/$APP_VERSION -b $APP_VERSION && \ make install && \ atomoned version --long | grep -E 'version|commit' # version: v3.2.0 # commit: f65958224baf3072773beef139c179ce5dfa025a
Initialization
Initialize the node and create the default configuration files
atomoned init MONIKER --chain-id atomone-1
Replace MONIKER with your own validator name. This name will be used as your node’s identifier on the network.
Genesis
Download genesis
mkdir -p $HOME/.atomone/config && \ wget -O $HOME/.atomone/config/genesis.json https://storage.crouton.digital/mainnet/atomone/files/genesis.json
Addrbook
Download addrbook
mkdir -p $HOME/.atomone/config && \ wget -O $HOME/.atomone/config/addrbook.json https://storage.crouton.digital/mainnet/atomone/files/addrbook.json
Configuration
Set the minimum gas price in app.toml
sed -i.bak \ 's|^minimum-gas-prices *=.*|minimum-gas-prices = "0.025uatone,0.225uphoton"|' \ "$HOME/.atomone/config/app.toml"
Create a service file
sudo tee /etc/systemd/system/atomoned.service > /dev/null <<EOF [Unit] Description=atomone node After=network-online.target [Service] User=$USER WorkingDirectory=$HOME/.atomone ExecStart=$(which atomoned) start --home $HOME/.atomone Restart=on-failure RestartSec=5 LimitNOFILE=65535 [Install] WantedBy=multi-user.target EOF
Start the node
sudo systemctl daemon-reload && \ sudo systemctl enable atomoned && \ sudo systemctl restart atomoned && \ sudo journalctl -u atomoned -f -o cat
Restore node from snapshot
sudo apt install -y lz4 && \ sudo systemctl stop atomoned && \ cp $HOME/.atomone/data/priv_validator_state.json $HOME/.atomone/priv_validator_state.json.backup && \ rm -rf $HOME/.atomone/data && \ curl -L https://storage.crouton.digital/mainnet/atomone/snapshots/atomone_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.atomone && \ mkdir -p $HOME/.atomone/data && \ mv $HOME/.atomone/priv_validator_state.json.backup $HOME/.atomone/data/priv_validator_state.json && \ sudo systemctl restart atomoned && \ sudo journalctl -u atomoned -f -o cat
Key management
Wallet management commands are provided below as examples. Replace wallet with your own wallet name before running them.
atomoned keys add wallet
Before creating a validator, make sure your wallet is funded with the required self-delegation amount in ATONE and enough PHOTON to cover transaction fees.
Validator management
atomoned tx staking create-validator \ --amount 1000000uatone \ --from wallet \ --commission-rate 0.1 \ --commission-max-rate 0.2 \ --commission-max-change-rate 0.01 \ --min-self-delegation 1 \ --pubkey $(atomoned tendermint show-validator) \ --moniker "MONIKER" \ --identity "TESTKEY123" \ --website "https://example.com" \ --details "Reliable validator for the network." \ --chain-id atomone-1 \ --gas auto \ --gas-adjustment 1.5 \ --fees 60000uphoton \ -y
Replace the example values with your own details. If the command fails or the transaction does not go through, try increasing the gas limit or the commission fee.
Validator commands
atomoned status 2>&1 | jq
Make sure to replace wallet with the name of your wallet before running the command.
Governance
atomoned q gov proposals
"1" is only an example proposal ID, so replace it with the actual one. Available voting options are "yes" to approve, "no" to reject, "abstain" to abstain, and "no_with_veto" to reject with veto.
Onchain
atomoned tx distribution withdraw-rewards $(atomoned keys show wallet --bech val -a) --commission --from wallet --chain-id atomone-1 --gas auto -y
atomoned tx staking delegate $(atomoned keys show wallet --bech val -a) 1000000uatone --from wallet --chain-id atomone-1 --gas 300000 --fees 2000uatone -y
These commands contain example values. Be sure to replace them with your own validator address, wallet name, wallet address, and any other required details before running them.
Service operations
sudo journalctl -u atomoned -f -o cat
Manual upgrade
cd $HOME && \ rm -rf atomone && \ git clone https://github.com/atomone-hub/atomone atomone && \ cd atomone && \ APP_VERSION=v3.2.0 && \ git checkout tags/$APP_VERSION -b $APP_VERSION && \ make install && \ sudo systemctl restart atomoned && \ sudo journalctl -u atomoned -f


