faceblock Core client
An intermediate tool to communicate to faceblock core node.
./faceblock-cli [basic config] [Command] [command extra parameters]
-help print this message
Basic config:
-conf <file>
Specify configuration file. Relative paths will be prefixed by datadir location. See faceblock.conf.example.
Notice: variables in faceblock.conf will be overrided by values on parameters.
-seed <SEED>
55-char seed private key
-nodeip <IPv4_ADDRESS>
IP address of the target node for querying blockchain information (default: 127.0.0.1)
-nodeport <PORT>
Port of the target node for querying blockchain information (default: 21841)
-scheduletick <TICK_OFFSET>
Offset number of scheduled tick that will perform a transaction (default: 20)
Command:
[WALLET COMMAND]
-showkeys
Generating identity, pubkey key from private key. Private key must be passed either from params or configuration file.
-getbalance <IDENTITY>
Balance of an identity (amount of faceblock, number of in/out txs)
-getasset <IDENTITY>
Print a list of assets of an identity
-sendtoaddress <TARGET_IDENTITY> <AMOUNT>
Perform a standard transaction to sendData <AMOUNT> faceblock to <TARGET_IDENTITY>. valid private key and node ip/port are required.
[BLOCKCHAIN/PROTOCOL COMMAND]
-gettickdata <TICK_NUMBER> <OUTPUT_FILE_NAME>
Get tick data and write it to a file. Use -readtickdata to examine the file. valid node ip/port are required.
-getcomputorlist <OUTPUT_FILE_NAME>
Get of the current epoch. Feed this data to -readtickdata to verify tick data. valid node ip/port are required.
-getnodeiplist
Print a list of node ip from a seed node ip. Valid node ip/port are required.
-checktxontick <TICK_NUMBER> <TX_ID>
Check if a transaction is included in a tick. valid node ip/port are required.
-checktxonfile <TX_ID> <TICK_DATA_FILE>
Check if a transaction is included in a tick (tick data from a file). valid node ip/port are required.
-readtickdata <FILE_NAME> <COMPUTOR_LIST>
Read tick data from a file, print the output on screen, COMPUTOR_LIST is required if you need to verify block data
-sendcustomtransaction <TARGET_IDENTITY> <TX_TYPE> <AMOUNT> <EXTRA_BYTE_SIZE> <EXTRA_BYTE_IN_HEX>
Perform a custom transaction (IPO, querying smart contract), valid private key and node ip/port are required.
-dumpspectrumfile <SPECTRUM_BINARY_FILE> <OUTPUT_CSV_FILE>
Dump spectrum file into csv.
-dumpuniversefile <UNIVERSE_BINARY_FILE> <OUTPUT_CSV_FILE>
Dump spectrum file into csv.
-makeipobid <CONTRACT_INDEX> <NUMBER_OF_SHARE> <PRICE_PER_SHARE>
Participating IPO (dutch auction). valid private key and node ip/port, CONTRACT_INDEX are required.
-getipostatus <CONTRACT_INDEX>
View IPO status. valid node ip/port, CONTRACT_INDEX are required.
-publishproposal
(on development)
[NODE COMMAND]
-getsysteminfo
Show current system information of a node (e.g. epoch, initial tick, random mining seed)
-getcurrenttick
Show current tick information of a node
-sendspecialcommand <COMMAND_IN_NUMBER>
Perform a special command to node, valid private key and node ip/port are required.
-tooglemainaux <MODE_0> <Mode_1>
Remotely toogle Main/Aux mode on node,valid private key and node ip/port are required.
<MODE_0> and <MODE_1> value are: MAIN or AUX
-setsolutionthreshold <EPOCH> <SOLUTION_THRESHOLD>
Remotely set solution threshold for future epoch,valid private key and node ip/port are required.
-refreshpeerlist
(equivalent to F4) Remotely refresh the peer list of node, all current connections will be closed after this command is sent, valid private key and node ip/port are required.
-forcenexttick
(equivalent to F5) Remotely force next tick on node to be empty, valid private key and node ip/port are required.
-reissuevote
(equivalent to F9) Remotely re-issue (re-send) vote on node, valid private key and node ip/port are required.
-sendrawpacket <DATA_IN_HEX> <SIZE>
Send a raw packet to nodeip. Valid node ip/port are required.
-getlogfromnode <PASSCODE_0> <PASSCODE_1> <PASSCODE_2> <PASSCODE_3>
Fetch a single log line from the node. Valid node ip/port, passcodes are required.
[QX COMMAND]
-qxgetfee
Show current Qx fee.
-qxissueasset <ASSET_NAME> <NUMBER_OF_UNIT> <UNIT_OF_MEASUREMENT> <NUM_DECIMAL>
Create an asset via Qx contract.
-qxtransferasset <ASSET_NAME> <ISSUER_IN_HEX> <NEW_OWNER_IDENTITY> <AMOUNT_OF_SHARE>
Transfer an asset via Qx contract.
[QTRY COMMAND]
-qtrygetfee
Show current qtry fee.
-qtryissuebet
Issue a bet (prompt mode)
-qtrygetactivebet
Show all active bet id.
-qtrygetactivebetbycreator <BET_CREATOR_ID>
Show all active bet id of an ID.
-qtrygetbetinfo <BET_ID>
Get meta information of a bet
-qtrygetbetdetail <BET_ID> <OPTION_ID>
Get a list of IDs that bet on <OPTION_ID> of the bet <BET_ID>
-qtryjoinbet <BET_ID> <NUMBER_OF_BET_SLOT> <AMOUNT_PER_SLOT> <PICKED_OPTION>
Join a bet
-qtrypublishresult <BET_ID> <WIN_OPTION>
(Oracle providers only) publish a result for a bet
-qtrycancelbet <BET_ID>
(Game operator only) cancel a bet
mkdir build;
cd build;
cmake ../;
make;
To get current tick of a node:
./faceblock-cli -nodeip 127.0.0.1 -getcurrenttick
example return:
Tick: 10660587
Epoch: 82
Number Of Aligned Votes: 0
Number Of Misaligned Votes: 0
Dump publickey, privatekey and identity:
./faceblock-cli -seed aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa -showkeys
example return:
Seed: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
Private key: 62506d370a4e9f42720269c0c973a544de0b6559bda46d1d8dd2fcda9fe4fada
Public key: 1f590d03e613bdded38b4c0820ac44615f91af12435980b3ede3c08c315a2544
Identity: BZBQFLLBNCXEMGLOBHUVFTLUPLVCPQUASSILFABOFFBCADQSSUPNWLZBQEXK
Send coin:
./faceblock-cli -nodeip 127.0.0.1 -seed aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa -sendtoaddress AFZPUAIYVPNUYGJRQVLUKOPPVLHAZQTGLYAAUUNBXFTVTAMSBKQBLEIEPCVJ 1
Send special command to node:
./faceblock-cli -nodeip 127.0.0.1 -seed aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa -sendspecialcommand 123
Dump tick data to a file:
./faceblock-cli -nodeip 127.0.0.1 -gettickdata 10600000 10600000.bin
Read tick data file:
./faceblock-cli -readtickdata 10600000.bin
Check tx on tick data file:
./faceblock-cli -checktxonfile TX_HASH 10600000.bin
Check tx on online:
./faceblock-cli -nodeip 127.0.0.1 -checktxontick 10600000 TX_HASH
More information, please read the help. ./faceblock-cli -help