How to Be a Compute Node in TOP AI Testnet

TOP AI Network Official

Published in

TOP AI Network

3 min readMar 6, 2025

Register for the Whitelist

Contact TOP AI officials to join the test program and get whitelisted. Submit your email, public IP address, and HTTP port.
The TOP AI official will send you the relevant test programs and accounts:

TOP AI Node program package.
Testnet GPU Provider account ETH wallet private key (a certain amount of test ETH will be deposited into it).

Preparation

Download the TOP AI Node program (topainode-linux-amd64-main-xxx-v0.1.x.tar.gz).
Prepare a Linux server (Ubuntu 22.04 LTS or higher recommended) with Docker pre-installed (Docker version 27 or higher recommended).
The server must have at least an NVIDIA GeForce RTX 2080 or higher GPU.
A publicly accessible IP address and port are required.
Extract the downloaded package, which contains the following files:

topainode: Node executable program.
topainode-cli: Command-line client for accessing the TOP AI network.
config.json: Blockchain configuration file.
ipmap_testnet.yaml: Proxy address IP mapping file.
node_config_0.yaml: Node program configuration file.

Create or Import a Wallet

Use the /create wallet command to create a wallet.
Note: The password is currently fixed to 123456.

Use the /import wallet command to import a wallet.

Modify Configuration File

nodeConfig:
managerConfig:
logDir: "./logs_0" (log file)
enableLog: true
httpPort: 12110 (HTTP port)
grpcPort: 12111

aiServingConfig:
grpcPort: 12112

proxyConfig:
grpcPort: 12113

p2pConfig:
bootstrap:
/ip4/127.0.0.1/tcp/9990/p2p/16Uiu2HAmUP5F6QczFJEk4bD49PMgvqukmT9VqbJ53Ge2t8Xd28H8

port: 9990 (P2P network binding port)
listen: "127.0.0.1" (local binding address)
natPort: 0 (publicly accessible port)
natIP: "" (public IP address)
loglevel: "debug"
logpath: "./logs_0"
logfile: "p2p.log"
stdoutEnable: false
stderrEnable: false

ChainConfig:
chainurl: "https://toptest.crosschain.topnetwork.org" (TOP testnet RPC service address)
wallet: "0xab57EF2B6477d7966E0c26f5869CCE9f1732c711" (node wallet address)
identifier: "0xab57EF2B6477d7966E0c26f5869CCE9f1732c711"
fromheight: 50 (TOP chain block height)

Modify the following fields: wallet, identifier, natPort, and natIP. Other fields can remain unchanged.

Start the Node Program

Run the following command:

bash

Copy

./topainode — config node_config.yaml

Verify Node Successfully Joined

Start the Client

You can run the client program (topainode-cli.exe) on Linux or Windows.

View Nodes in the TOP AI Testnet

In the interactive mode of topainode-cli.exe, use the /show all node command to view the nodes.

Check if the configured wallet address appears in the list.
For executing model inference tasks, refer to the TOP AI Testnet Developer Guide.

About TOP AI Network

TOP AI Network is a decentralized AI Model platform and also the infrastructure for AI Agents, empowering AI model developers to deploy and host their models without the need for costly hardware or complex software. TOP AI Network aims to provide a robust Layer 1 blockchain infrastructure that serves a wide range of users, from individual developers to large-scale businesses. With a mission to support decentralized AI computing power for Web3.0, DePIN, and gaming ecosystems, it ensures low transaction fees, high speed, scalability, and an exceptional user experience, addressing the growing demand for AI-driven applications.

Find More