impawn

AbeyChain Impawn CLI

AbeyChain Impawn CLI is a tool, which can call deposit contract participate in POS.

Building the source

Building impawn requires both a Go (version 1.9 or later) and a C compiler. You can install them using your favourite package manager. Once the dependencies are installed, run

go build -o impawn  main.go query_stake.go impawn.go

Command

The impawn project comes with several Sub Command.

Flag

• --key If you use private key, you need specify a file which contains private key.
• --keystore If you use private key, you need specify a file which contains private key.
• --rpcaddr HTTP-RPC server listening interface (default: localhost)
• --rpcport HTTP-RPC server listening port (default: 8545)
• --value Staking value units one true no wei
• --fee Staking fee 0 - 10000(default: 0)
• --address Transfer address or validator address in delegate
• --txhash query tx exec result

Running CLI

Impawn

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 50000 --fee 100

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node, this node should you run validator node, because of it will use your local bft pk to election.
• Deposit 50000 true to staking address, fee(0-10000) set to 100, feeRate = fee / 10000.
• If you want become a validator candidate, you must deposit balance > 50000(true).

Cancel

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10  cancel

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• Due to withdraw must call cancel first, sub command cancel represent you will cancel 10 true to locked state, next epoch you can withdraw.

withdraw

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 withdraw

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• Sub command append represent you want withdraw 10 true to your address.

Append

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 append

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node, and deposit 10 true to staking address.
• Sub command append represent you want continue staking after already having deposit.

UpdateFee

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --fee 10 updatefee

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• Sub command only update validator fee(0-10000), which will influence delegator benefit.

UpdatePK

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --bftkey f0f9fa54c701cdbc3e87adbe3936d2cafef66c9e018d0302587e932dab58fd85 updatepk

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• Sub command only update validator pk, you can use --bftkey + private key or --pubkey + public key .

Send

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 --address 0x3f944d3f12e904e1A647E5FF9f531B8deE2346B2 send 

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• Sub command send is send normal transaction not contract,value is transfer value, address is To address.

QueryStaking

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 querystaking

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node.
• querystaking will print in staking count(Staked), already cancel count(Locked), can withdraw count(Unlocked).
• Print withdraw height, after this, you can call withdraw.

QueryTx

$ impawn  --rpcaddr 39.100.97.129 --rpcport 8545 --txhash 0x40c78769add225421c45fa2e9dc206c1d9a03199f78c34644f3c0bf274f3066b querytx

This command will:

• Connect http://39.100.97.129:8545 node, and use querytx command specify txhash to query.

Delegate deposit

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 --address 0x3f944d3f12e904e1A647E5FF9f531B8deE2346B2 delegate deposit

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node, and delegate 10 true to staking address.
• Sub command delegate deposit express this is delegate call, address is you select validator address.

Delegate cancel

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 --address 0x3f944d3f12e904e1A647E5FF9f531B8deE2346B2 delegate cancel

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node, and delegate 10 true to staking address.
• Sub command delegate cancel express this is cancel call, address is you select validator address.

Delegate withdraw

$ impawn --key key/bftkey --rpcaddr 39.100.97.129 --rpcport 8545 --value 10 --address 0x3f944d3f12e904e1A647E5FF9f531B8deE2346B2 delegate withdraw

This command will:

• Load private key in key/bftkey file, connect http://39.100.97.129:8545 node, and delegate 10 true to staking address.
• Sub command delegate withdraw express this is withdraw call, address is you select validator address.