How to Join the Nebulas Testnet

Introduction

We are glad to release the Nebulas Testnet. It simulates the Nebulas network and NVM, and allows developers to interact with Nebulas without paying the cost of gas.

https://github.com/nebulasio/go-nebulas/tree/testnet

Build

The Nebulas Testnet‘s executable file and dependant libraries need to be built first. Several important modules are highlighted below:

• NBRE: The Nebulas Blockchain Runtime Environment is the platform for running Nebulas Protocol Representation, such as the DIP, the NR, etcetera.
• NEB: The main process of the Nebulas Testnet. NEB and NBRE run in standalone processes, and communicate through IPC.

Details of building the modules can be found in tutorials.

Configuration

The testnet configuration files are in the folder testnet/conf under testnet branch, including:

genesis.conf

All configurable information about the genesis block is defined in genesis.conf, such as:

• meta.chain_id: chain identity.
• consensus.dpos.dynasty: the initial dynasty of validators.
• token_distribution: the initial allocation of tokens.

Attention: DO NOT change the genesis.conf.

config.conf

All configurable information about the runtime is defined in config.conf.

Please check the template.conf to find more details about the runtime configuration.

Tips: the official seed node info is as below,

seed:["/ip4/47.92.203.173/tcp/8680/ipfs/QmfSJ7JUnCEDP6LFyKkBUbpuDMETPbqMVZvPQy4keeyBDP","/ip4/47.89.180.5/tcp/8680/ipfs/QmTmnd5KXm4UFUquAJEGdrwj1cbJCHsTfPWAp5aKrKoRJK"]

API List

Test Endpoint:

API	URL	Protocol
RESTful	https://testnet.nebulas.io/	HTTP

• GetNebState: returns nebulas client info.
• GetAccountState: returns the account balance and nonce.
• LatestIrreversibleBlock: returns the latest irreversible block.
• Call: execute smart contract locally. The tx won‘t be submitted on chain.
• SendRawTransaction: submit signed transaction. The transaction must be signed before sending.
• GetTransactionReceipt: get transaction receipt info from the transaction hash.

More Nebulas APIs at RPC.

Claim Tokens

Each email can claim tokens every day here.

Tutorials

1. Installation (thanks Victor)
2. Sending a Transaction (thanks Victor)
3. Writing Smart Contract in JavaScript (thanks otto)
4. Introducing Smart Contract Storage (thanks Victor)
5. Interacting with Nebulas by RPC API (thanks Victor)

Contributing

Feel free to join Nebulas Testnet. If you did find something wrong, please submit an issue or submit a pull request to let us know, we will add your name and url to this page as soon as possible.