TOP AI Testnet Developer Guide

TOP AI Network Official

Published in

TOP AI Network

4 min readFeb 28, 2025

Register for the Whitelist

Please fill out the form to join the test plan and submit your email to qualify for the whitelist:

🧡Google Form Link

The TOP AI team will send the related test programs and accounts:

TOP AI Node program compressed package
Testnet GPU Provider account ETH wallet private key (a certain amount of test ETH will be transferred into this wallet)

Preparation

Download the TOP AI Node program (topainode-linux-amd64-main-xxx-v0.1.x.tar.gz)
Prepare a Linux server with Docker pre-installed.
Extract the compressed package, which contains the following files:

topainode: The node running program
topainode-cli: Command-line client to access the TOP AI network
config.json: Blockchain configuration
ipmap_testnet.yaml: Proxy address IP mapping file
node_config_0.yaml: Node program configuration file

Create or Import Wallet

Use the /create wallet command to create a wallet. Note: Currently, the password is only supported as 123456.

Use the /import wallet command to import a wallet.

Modify Configuration Files

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)

Note: Modify the wallet, identifier, natPort, and natIP as needed. Other settings can remain unchanged.

Start the Node Program

./topainode — config node_config.yaml

Start the Client

The client program can be run on either Linux or Windows:

View Nodes in the TOP AI Testnet

Use the following command in the interactive mode of topainode-cli.exe to view all nodes:

View Models in the Network

In the interactive mode of topainode-cli.exe, use the following command to view all models:

Add a Model

In the interactive mode of topainode-cli.exe, use the following command to add a model:

You will need to enter the wallet address, model name, model version, and model configuration information.

Run Model Inference

Run LLM Model Inference Service:

Create a session with /create session, then select the LLM model you want to use.
Execute the chat command with /chat. Enter your dialogue content after the prompt.

Run ASR Model Inference Service:

Create a session with /create session, then select the ASR model you want to use.
Execute the ASR command with /asr. Enter the local wav file path after the prompt.

Run TTS Model Inference Service:

Create a session with /create session, then select the TTS model you want to use.
Execute the TTS command with /tts. Enter the text you want to convert into speech after the prompt.

Run Text-To-Image Model Inference Service:

Create a session with /create session, then select the TTS model you want to use.
Execute the text-to-image command with /text-to-image. Enter the prompt for the image you want to generate after the prompt.

FAQ

If you encounter issues as shown above, try restarting a few times.

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