Testnet Integration Guide

Quick Setup

1. Start local testnet-in-a-box:

   cd axionax_v1.5_Testnet_in_a_Box
   docker compose up -d

2. Connect to RPC (http://localhost:8545) – Chain ID: 86137
3. Block explorer at http://localhost:4001

Configure axionax Core

Edit config.yaml or use environment variables:

node:
  chain_id: 31337
network:
  bootstrap_nodes:
    - "http://localhost:8545"

Or environment variables:

export AXIONAX_NODE_CHAIN_ID=31337
export AXIONAX_NETWORK_BOOTSTRAP_NODES="http://localhost:8545"

# Initialize configuration
./axionax-core config init
# Start node
./axionax-core start --network testnet

Smart Contract Integration (Go Example)

import (
  "fmt"
  "log"
  "math/big"
  "github.com/ethereum/go-ethereum/common"
  "github.com/ethereum/go-ethereum/ethclient"
)
func main() {
  client, err := ethclient.Dial("http://localhost:8545")
  // ... ChainID and balance checks
}

Faucet Integration

curl -H "Authorization: Basic YWRtaW46cGFzc3dvcmQ=" \
  "http://localhost:8081/request?address=0xYourAddress"

Or use the faucet web UI at http://localhost:8080

Development Workflow

1. Generate test keys:

   ./axionax-core keys generate --type validator
   ./axionax-core keys generate --type worker

2. Fund accounts using faucet
3. Register as validator:

   ./axionax-core stake deposit 10000 --address <your-address>
   ./axionax-core validator start

4. Register as worker:

   cat > worker-specs.json <