Skip to content

Latest commit

 

History

History
119 lines (81 loc) · 6.13 KB

testnet.md

File metadata and controls

119 lines (81 loc) · 6.13 KB
Raw

How to Join Nebulas Testnet

Introduction

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

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

Configuration

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

genesis.conf

All configurable information about genesis block is defined in genesis.conf, including

  • 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 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"]

Miner config

Nodes can participate in mining and share rewards after signing up for mining. The miner node needs to turn on the mine switch and configure both the miner address and reward address(coinbase).

miner config example:

chain {
  # testnet chainID
  chain_id: 1001
  # testnet datadir, should be different with private chain
  datadir: "testnet/data.db"
  keydir: "keydir"
  # testnet genesis.conf
  genesis: "testnet/conf/genesis.conf"
  # testnet dynasty.conf
  dynasty: "testnet/conf/dynasty.conf"
  
  # start mine
  start_mine: true
  # receive the mining award, must change to your address
  coinbase: "n1XkoVVjswb5Gek3rRufqjKNpwrDdsnQ7Hq"
  # block signature address, needs to be placed in the node's configuration `keydir`. Also make sure that the address is the node address at the time of registration
  miner: "n1FF1nz6tarkDVwWQkMnnwFPuPKUaQTdptE"
  # 
  passphrase: "passphrase"

  signature_ciphers: ["ECC_SECP256K1"]
}

Synchronization

Since Nebulas testnet is running there for certain period of time, it will take quite some time to sync all the testnet data from scratch.

For developers' convenience, we provided a offline data package, which already includes the data of more than 1.2 million blocks, you can download the package directly by following either link below (choose whichever is faster for you):

Please note that, the data package should be put under the same path of "datadir" as specified in your config.conf file.

API List

Test Endpoint:

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

More Nebulas APIs at RPC.

Token Claim

Every email can claim some tokens every day at here.

Tutorials

English

  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)

中文

  1. 编译安装及运行neb
  2. 在星云链上发送交易
  3. 使用JavaScript编写智能合约
  4. 智能合约存储区介绍
  5. 通过RPC接口与星云链交互

Contribution

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