[{"data":1,"prerenderedAt":290},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fcore-tech\u002Ftestnet-command-line-instructions":3,"docs-surround-\u002Fdocs\u002Fcore-tech\u002Ftestnet-command-line-instructions":280},{"id":4,"title":5,"body":6,"description":15,"extension":272,"image":273,"meta":274,"navTitle":273,"navigation":275,"path":276,"seo":277,"stem":278,"__hash__":279},"docs\u002Fdocs\u002Fcore-tech\u002FTestnet-Command-Line-Instructions.md","Testnet Command Line Instructions",{"type":7,"value":8,"toc":269},"minimark",[9,16,31,34,39,51,54,59,62,65,71,74,77,80,83,86,91,94,117,120,134,139,142,147,150,155,158,163,168,171,176,179,184,187,192,197,212,217,231,253,261,266],[10,11,12],"p",{},[13,14,15],"strong",{},"Welcome to Beam Testnet 1",[10,17,18,19,25,26,30],{},"Node binaries can be downloaded from the Beam website (",[20,21,22],"a",{"href":22,"rel":23},"http:\u002F\u002Fbeam-mw.com\u002Fdownloads",[24],"nofollow",") or from Github (",[20,27,28],{"href":28,"rel":29},"https:\u002F\u002Fgithub.com\u002Fbeam-mw\u002Fbeam-builds\u002Ftree\u002Fmaster\u002Ftestnet\u002Frelease",[24],")",[10,32,33],{},"You can run the node with command line options, or modify the attached config file. Once you start the node it will create a node.db file in the same folder. This file will store internal state of the node.",[10,35,36],{},[13,37,38],{},"Reporting issues",[10,40,41,42,46,47],{},"In case you encounter any problems, please report them via еmail to ",[20,43,45],{"href":44},"mailto:testnet@beam-mw.com","testnet@beam-mw.com"," or open a github ticket at ",[20,48,49],{"href":49,"rel":50},"https:\u002F\u002Fgithub.com\u002Fbeam-mw\u002Fbeam",[24],[10,52,53],{},"Attach archive with logs, configuration file and command line parameters to allow effective investigation of the issues.",[10,55,56],{},[13,57,58],{},"Running a node",[10,60,61],{},"Node parameters can be either passed through command line or written in the beam-node.cfg file.",[10,63,64],{},"Example:",[10,66,67],{},[68,69,70],"em",{},".\u002Fbeam-node --peer 138.68.130.189:8101 --wallet_seed 111 --mining_threads 1 --file_log_level debug",[10,72,73],{},"The --peer parameter specifies a comma separated list of peers that the node will initially connect to. After the connection is established, the node will get an updated list of peers from the nodes, along with peer ratings and from that moment it will manage the connections on its own.",[10,75,76],{},"--wallet_seed - is a secret key for the wallet that will connect to this node to collect mining rewards (if the node is mining)",[10,78,79],{},"--mining_treads - specifies the number of CPU cores utilized for mining. If set to 0, node acts as validating node only.",[10,81,82],{},"--file_log_level - allows you to see that is going on behind the scenes.",[10,84,85],{},"Upon first launch, the node will download current blockchain history in batch mode as one large macroblock. After the initial sync is complete, the node will continue to sync blocks and individual transactions from the current blockchain Tip and onwards. This can be seen in the log entry:",[10,87,88],{},[68,89,90],{},"My Tip: 24704-f2ab414ba6430d85",[10,92,93],{},"Here is the full list of options supported by the node",[10,95,96,97,101,102,105,106,109,110,112,113,116],{},"General options:\n-h ",[98,99,100],"span",{}," --help","                     \tlist of all options\n-p ",[98,103,104],{}," --port"," arg (=10000)        \tport to start the server on\n--wallet_seed arg                 \tsecret key generation seed\n--log_level arg                   \tlog level ",[98,107,108],{},"info|debug|verbose","\n--file_log_level arg              \tfile log level ",[98,111,108],{},"\n-v ",[98,114,115],{}," --version","               \treturn project version\n--git_commit_hash                 \treturn commit hash",[10,118,119],{},"Node options:\n--storage arg (=node.db)          \tnode storage path\n--history_dir arg (=.\u002F)           \tdirectory for compressed history\n--temp_dir arg (=\u002Ftmp\u002F)           \ttemp directory for compressed history,\nmust be on the same volume\n--mining_threads arg (=0)         \tnumber of mining threads(there is no\nmining if 0)\n--verification_threads arg (=-1)  \tnumber of threads for cryptographic\nverifications (0 = single thread, -1 =\nauto)\n--miner_id arg (=0)               \tseed for miner nonce generation\n--peer arg                        \tnodes to connect to\n--import arg (=0)                 \tSpecify the blockchain height to\nimport. The compressed history is\nassumed to be downloaded the the\nspecified directory",[10,121,122,123,126,127,130,131,133],{},"Rules configuration:\n--CoinbaseEmission arg (=80000000)\tcoinbase emission in a single block\n--MaturityCoinbase arg (=60)      \tnum of blocks before coinbase UTXO can\nbe spent\n--MaturityStd arg (=0)            \tnum of blocks before non-coinbase UTXO\ncan be spent\n--MaxBodySize arg (=1048576)      \tMax block body size ",[98,124,125],{},"bytes","\n--DesiredRate_s arg (=60)         \tDesired rate of generated blocks\n",[98,128,129],{},"seconds","\n--DifficultyReviewCycle arg (=1440)   num of blocks after which the mining\ndifficulty can be adjusted\n--MaxDifficultyChange arg (=2)    \tMax difficulty change after each cycle\n(each step is roughly x2 complexity)\n--TimestampAheadThreshold_s arg (=7200)\nBlock timestamp tolerance ",[98,132,129],{},"\n--WindowForMedian arg (=25)       \tHow many blocks are considered in\ncalculating the timestamp median\n--AllowPublicUtxos arg (=0)       \tset to allow regular (non-coinbase)\nUTXO to have non-confidential signature\n--FakePoW arg (=0)                \tDon't verify PoW. Mining is simulated\nby the timer. For tests only",[10,135,136],{},[13,137,138],{},"Running a command line wallet",[10,140,141],{},"After extracting the wallet binary to a folder, first we need to initialize the wallet by running:",[10,143,144],{},[68,145,146],{},".\u002Fbeam-wallet --command init",[10,148,149],{},"You will be prompted to provide wallet password and then seed. If you are using a miner node, the seed should be the same as was set in the --wallet_seed flag of the node",[10,151,152],{},[13,153,154],{},"Printing wallet information",[10,156,157],{},"To get the information about the status of the wallet, run:",[10,159,160],{},[68,161,162],{},".\u002Fbeam-wallet --command info -n 127.0.0.1:10000",[10,164,165],{},[13,166,167],{},"Receiving Beams",[10,169,170],{},"To receive beams we need to start a wallet in a listening mode by running:",[10,172,173],{},[68,174,175],{},".\u002Fbeam-wallet --command listen -n 127.0.0.1:10000;",[10,177,178],{},"After entering the password, wallet will print out the line similar to:",[10,180,181],{},[68,182,183],{},"WalletID 4a0e54b24d5fdf06891a8eaa57b4b3ac16731e932a64da8ec768083495d624f1 subscribes to BBS channel 9",[10,185,186],{},"This show the SBBS address the wallet is listening on. This address can be copied and sent to Sender.",[10,188,189],{},[13,190,191],{},"Sending Beams",[10,193,194],{},[68,195,196],{},".\u002Fbeam-wallet --command=send -n 127.0.0.1:10000 -r 77de6bd3de40bc58ab7e4fb68d5e0596fd1e72f3c4fb3eb3d106082d89264909 -a 11.3 -f 0.2",[10,198,199,200],{},"To send Beams, use 'send' command with the following parameters:\n-r ",[201,202,204,205],"sbbs",{"address":203,"of":203,"the":203,"receiver":203,"node":203},"","\n-a ",[206,207,208,209],"amount",{"of":203,"beams":203,"to":203,"send":203},"\n-f ",[210,211],"transaction",{"fee":203},[10,213,214],{},[13,215,216],{},"Full list of wallet options",[10,218,96,219,221,222,105,224,109,226,112,228,230],{},[98,220,100],{},"    \t                 list of all options\n-p ",[98,223,104],{},[98,225,108],{},[98,227,108],{},[98,229,115],{},"                  \treturn project version\n--git_commit_hash                 \treturn commit hash",[10,232,233,234,237,238,241,242,245,246,249,250],{},"Wallet options:\n--pass arg                        \tpassword for the wallet\n-a ",[98,235,236],{}," --amount"," arg               \tamount to send (in Beams, 1 Beam =\n1000000 chattle)\n-f ",[98,239,240],{}," --fee"," arg (=0)             \tfee (in Beams, 1 Beam = 1000000\nchattle)\n-r ",[98,243,244],{}," --receiver_addr"," arg        \taddress of receiver\n-n ",[98,247,248],{}," --node_addr"," arg            \taddress of node\n--treasury_path arg (=treasury.mw)\tBlock to create\u002Fappend treasury to\n--wallet_path arg (=wallet.db)    \tpath to wallet file\n--bbs_keystore_path arg (=bbs_keys.db)\npath to file with bbs keys\n--tx_history                      \tprint transacrions' history in info\ncommand\n--tr_Count arg (=30)              \ttreasury UTXO count\n--tr_HeightStep arg (=1440)       \ttreasury UTXO height lock step\n--tr_BeamsPerUtxo arg (=10)       \ttreasury value of each UTXO (in Beams)\n--command arg                     \tcommand to execute ",[98,251,252],{},"send|receive|listen\n|init|info|treasury",[10,254,122,255,126,257,130,259,133],{},[98,256,125],{},[98,258,129],{},[98,260,129],{},[10,262,263],{},[13,264,265],{},"List of testnet 1 nodes",[10,267,268],{},"142.93.89.204:8101\n188.166.148.169:8101\n206.189.141.171:8101\n138.68.130.189:8101\n178.128.225.252:8101\n128.199.142.41:8101\n139.59.191.116:8101\n206.189.3.9:8101\n206.189.15.198:8101\n204.48.26.118:8101\n174.138.58.140:8101\n142.93.241.66:8101\n188.166.122.215:8101\n142.93.17.121:8101\n104.248.77.220:8101\n104.248.27.246:8101\n188.166.60.223:8101\n128.199.144.164:8101\n104.248.182.148:8101\n104.248.182.152:8101\n159.203.72.8:8101\n178.128.233.252:8101\n104.248.43.86:8101\n104.248.43.99:8101\n178.62.19.156:8101\n104.248.75.183:8101\n206.81.11.82:8101\n206.189.138.82:8101\n178.128.225.8:8101\n142.93.246.182:8101\n104.248.31.169:8101\n128.199.144.48:8101\n178.128.229.48:8101\n128.199.144.196:8101\n159.65.40.42:8101\n178.128.229.50:8101\n138.197.193.229:8101\n128.199.144.206:8101\n178.128.229.65:8101\n159.89.234.65:8101\n104.248.43.120:8101\n104.248.186.25:8101\n128.199.145.212:8101\n188.166.15.205:8101\n138.68.163.99:8101",{"title":203,"searchDepth":270,"depth":270,"links":271},2,[],"md",null,{},true,"\u002Fdocs\u002Fcore-tech\u002Ftestnet-command-line-instructions",{"description":15},"docs\u002Fcore-tech\u002FTestnet-Command-Line-Instructions","Ev37u6XREWpOwKN8ttsINympkUO_-cHaW3r_JPfAFmo",[281,286],{"title":282,"path":283,"stem":284,"description":285,"children":-1},"Testing Beam Hard Fork On Local Testnet","\u002Fdocs\u002Fcore-tech\u002Ftesting-beam-hard-fork-on-local-testnet","docs\u002Fcore-tech\u002FTesting-Beam-Hard-Fork-on-Local-Testnet","Beam Clear Cathode 3.0 version includes a Hard Fork that will be activated in block 321321 (approximately around August 15th, 2019). As part of the fork, the mining algo will be updated to BeamHash II.",{"title":287,"path":288,"stem":289,"description":203,"children":-1},"Thoughts About Eliminating Transaction Kernels","\u002Fdocs\u002Fcore-tech\u002Fthoughts-about-eliminating-transaction-kernels","docs\u002Fcore-tech\u002FThoughts-about-eliminating-transaction-kernels",1783006084757]