OshVanK Node ServiceOshVanK Node Service
MainnetMainnet
Arkhadian
Mainnet Live

Installation

A complete guide to running an Arkhadian Blockchain Mainnet node and validator.

💢 Quick Installation (Automated)

💢 One-Command Installation

wget -qO install.sh https://raw.githubusercontent.com/Edsny1/Arkhadian-Mainnet-Setup/Edsny/install.sh && chmod +x install.sh && ./install.sh

This script automatically handles:

  • ✅ System update
  • ✅ Required packages installation
  • ✅ Go installation (if missing)
  • ✅ Cosmovisor installation
  • ✅ Binary compilation and installation
  • ✅ Node configuration
  • ✅ Genesis and addrbook setup
  • ✅ State Sync configuration
  • ✅ Systemd service creation

Information required during setup:

  • Moniker (Your node name)
  • Wallet name (default: wallet)
  • Port configuration (default or custom)
  • State Sync usage (recommended: yes)

💻 System Requirements

💢 Minimum Requirements

ComponentMinimum
CPU4 Cores
RAM8 GB
Disk200 GB SSD
Bandwidth100 Mbps
OSUbuntu 20.04+

💢 Recommended Requirements

ComponentRecommended
CPU8 Cores
RAM16 GB
Disk500 GB NVMe SSD
Bandwidth1 Gbps
OSUbuntu 22.04 LTS

💢 Post-Installation Operations

💢 1. Start the Node

sudo systemctl start arkhd

💢 2. Monitor Logs

sudo journalctl -fu arkhd -o cat

💢 3. Check Sync Status

arkhd status 2>&1 | jq .SyncInfo

Wait until catching_up: false.

💢 4. Create a Wallet

New Wallet:

arkhd keys add wallet

Recover Existing Wallet:

arkhd keys add wallet --recover

⚠️ Important: Keep your mnemonic words in a safe place!

💢 5. Create a Validator

After the node is fully synced:

arkhd tx staking create-validator \
  --amount=1000000arkh \
  --pubkey=$(arkhd tendermint show-validator) \
  --moniker="YOUR_MONIKER" \
  --chain-id=arkh \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --min-self-delegation="1" \
  --gas="auto" \
  --gas-adjustment="1.5" \
  --gas-prices="0.0arkh" \
  --from=wallet \
  --fees=5000arkh \
  --gas=200000

💢 Useful Commands

💢 Node Management

# Node status
sudo systemctl status arkhd

# Start node
sudo systemctl start arkhd

# Stop node
sudo systemctl stop arkhd

# Restart node
sudo systemctl restart arkhd

# Monitor logs
sudo journalctl -fu arkhd -o cat

💢 Sync Checking

# Sync status
arkhd status 2>&1 | jq .SyncInfo

# Catching up check
arkhd status 2>&1 | jq .SyncInfo.catching_up

# Latest block height
arkhd status 2>&1 | jq .SyncInfo.latest_block_height

# Peer count
curl -s localhost:26657/net_info | jq -r .result.n_peers

💢 Wallet Operations

# Wallet list
arkhd keys list

# Balance check
arkhd query bank balances $(arkhd keys show wallet -a)

# Send tokens
arkhd tx bank send wallet <RECEIVER_ADDRESS> 1000000arkh \
  --chain-id=arkh \
  --gas=auto \
  --gas-adjustment=1.5 \
  --gas-prices=0.0arkh

💢 Validator Operations

# Validator information
arkhd query staking validator $(arkhd keys show wallet --bech val -a)

# Validator status
arkhd status 2>&1 | jq .ValidatorInfo

# Withdraw rewards
arkhd tx distribution withdraw-all-rewards \
  --from=wallet \
  --chain-id=arkh \
  --gas=auto \
  --gas-adjustment=1.5 \
  --gas-prices=0.0arkh

# Unjail a jailed validator
arkhd tx slashing unjail \
  --from=wallet \
  --chain-id=arkh \
  --gas=auto \
  --gas-adjustment=1.5 \
  --gas-prices=0.0arkh

💢 Troubleshooting

💢 Node Does Not Start

# Check logs
sudo journalctl -u arkhd -n 100 --no-pager

# Check binary
which arkhd
arkhd version

# Check permissions
ls -la ~/.arkh/

💢 No Peers Found

# Update Addrbook
rm ~/.arkh/config/addrbook.json
wget -O ~/.arkh/config/addrbook.json https://raw.githubusercontent.com/Edsny1/Arkhadian-Mainnet-Setup/refs/heads/Edsny/addrbook.json

# Restart node
sudo systemctl restart arkhd

💢 Slow Synchronization

Use State Sync or restore from a snapshot. See the manual installation guide for detailed info.

💢 Disk Full

# Tighten pruning settings
sed -i -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \"100\"/" ~/.arkh/config/app.toml
sed -i -e "s/^pruning-interval *=.*/pruning-interval = \"10\"/" ~/.arkh/config/app.toml

# Restart node
sudo systemctl restart arkhd

💢 Port Configuration

💢 Default Ports (26xxx)

ServicePort
P2P26656
RPC26657
gRPC26090
API26317
Prometheus26660

💢 Custom Port Usage

If you select a custom port during installation (e.g., 27), all ports will be automatically adjusted (27656, 27657, etc.).

💢 Security Recommendations

  1. Firewall Configuration

    sudo ufw allow ssh
sudo ufw allow 26656/tcp
sudo ufw enable

  2. SSH Security

    • Use Key-based authentication
    • Disable root login
    • Change the default SSH port

  3. Backup

    • Backup the ~/.arkh/config/priv_validator_key.json file
    • Store your mnemonic words in a secure place

  4. Monitoring

    • Regularly check node status
    • Install Prometheus and Grafana
    • Set up an alert system

  5. Updates

    • Keep your system updated
    • Track new node versions

💢 Files and Directories

~/.arkh/
├── config/
│   ├── app.toml              # Application configuration
│   ├── config.toml           # Node configuration
│   ├── genesis.json          # Genesis file
│   ├── addrbook.json         # Peer addresses
│   └── priv_validator_key.json  # Validator key (IMPORTANT!)
├── data/                     # Blockchain data
└── cosmovisor/
    ├── genesis/
    │   └── bin/
    │       └── arkhd         # Genesis binary
    └── upgrades/             # Upgrade binaries

💢 Cosmovisor Upgrade

Cosmovisor automatically handles chain upgrades.

💢 Preparation for New Version

# Compile new version
cd ~/arkh-blockchain
git fetch
git checkout <NEW_VERSION>
go build -o arkhd ./cmd/arkhd

# Create upgrade directory
mkdir -p ~/.arkh/cosmovisor/upgrades/<UPGRADE_NAME>/bin

# Copy binary
cp arkhd ~/.arkh/cosmovisor/upgrades/<UPGRADE_NAME>/bin/

When the upgrade proposal passes, Cosmovisor will automatically transition to the new version.

💢 Useful Links

💢 Official Resources

💢 Community

  • Discord: [Discord Invite]
  • Telegram: [Telegram Group]
  • Twitter: [Twitter Profile]

💢 Explorer & Tools

💢 Contributing

This repository is open for community contributions. Feel free to submit a pull request!

💢 Contribution Process

  1. Fork this repo
  2. Create a new branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to your branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

💢 Support

If you experience issues:

  1. Check Documentation

  2. Community Support

    • Get help on Discord
    • Ask in the Telegram group

  3. Open an Issue

    • You can open an issue on GitHub
    • Explain your problem in detail

💢 Version History

💢 v2.0.0 (Current)

  • First mainnet version
  • Cosmovisor integration
  • State Sync support
  • Automated setup script

💢 License

MIT License - See the LICENSE file for details.

💢 Acknowledgements

  • Arkhadian Core Team
  • Cosmos SDK Team
  • All community contributors

Arkhadian Network

Prepared by: OshVanK

Last Updated: December 2025

GitHub stars GitHub forks

Installation

An automated setup and management script for Safrochain testnet nodes.

Installation

A complete guide to running an AtomOne node and validator.

On this page

💢 Quick Installation (Automated)💢 One-Command Installation💻 System Requirements💢 Minimum Requirements💢 Recommended Requirements💢 Post-Installation Operations💢 1. Start the Node💢 2. Monitor Logs💢 3. Check Sync Status💢 4. Create a Wallet💢 5. Create a Validator💢 Useful Commands💢 Node Management💢 Sync Checking💢 Wallet Operations💢 Validator Operations💢 Troubleshooting💢 Node Does Not Start💢 No Peers Found💢 Slow Synchronization💢 Disk Full💢 Port Configuration💢 Default Ports (26xxx)💢 Custom Port Usage💢 Security Recommendations💢 Files and Directories💢 Cosmovisor Upgrade💢 Preparation for New Version💢 Useful Links💢 Official Resources💢 Community💢 Explorer & Tools💢 Contributing💢 Contribution Process💢 Support💢 Version History💢 v2.0.0 (Current)💢 License💢 Acknowledgements