加入星云测试网¶
Introduction¶
我们发布了Nebulas Testnet。它模拟了星云网络和NVM,并允许开发人员与星云交互而无需支付gas费用。
编译¶
需要首先构建Nebulas Mainnet的可执行文件和依赖库。 以下重点介绍几个重要模块:
- NEB: 星云主网的主进程。
NEB
和NBRE
运行于独立进程中,两者通过IPC进行通信。
有关编译的详细信息,请参阅 tutorials.
配置文件¶
testnet 配置文件在 testnet/conf
testnet
分支下, 包括
genesis.conf¶
关于genesis块的所有可配置信息都在genesis.conf中定义,包括
- meta.chain_id: chain identity
- consensus.dpos.dynasty: the initial dynasty of validators
- token_distribution: the initial allocation of tokens
注意: 不要修改 genesis.conf.
config.conf¶
有关运行时的所有可配置信息都在config.conf中定义。
请查看 template.conf
查找有关运行时配置的更多详细信息。
Tips: 官方节点信息如下,
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 yourconfig.conf
file.
API 列表¶
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 lastest 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 send.
- GetTransactionReceipt: get transaction receipt info by tansaction hash.
更多的星云 APIs : RPC.
作出贡献¶
可随意加入Nebulas Testnet。 如果你确实发现了什么问题,请 submit a issue 或者 submit a pull request 告诉我们,我们会尽快将您的姓名和网址添加到此页面。