AirSign for BitShares
A command line tool to interface with the BitShares network.
Installation
Install with pip
:
pip3 install airsign
Manual installation:
git clone https://github.com/xeroc/airsign
cd airsign
python3 setup.py install --user
Upgrade
$ pip install --user --upgrade airsign
Usage
You can get a full length help by running:
$ airsign --help
usage: airsign [-h] [--node NODE] [--rpcuser RPCUSER]
[--rpcpassword RPCPASSWORD]
{addkey,listkeys,listaccounts,getbalance,transfer} ...
Command line tool to interact with the BitShares network
positional arguments:
{addkey,listkeys,listaccounts,getbalance,transfer}
sub-command help
addkey Add a new key to the wallet
listkeys List available keys in your wallet
listaccounts List available accounts in your wallet
getbalance Get balances of available account(s)
transfer Transfer funds from your wallet to someone else
optional arguments:
-h, --help show this help message and exit
--node NODE Websocket URL for public BitShares API (default:
"wss://bitshares.openledger.info/ws")
--rpcuser RPCUSER Websocket user if authentication is required
--rpcpassword RPCPASSWORD
Websocket password if authentication is required
Adding keys
airsign comes with its own encrypted wallet to which keys need to be added:
airsign addkey <posting-wif-key>
On first run, you will be asked to provide a new passphrase that you
will need to provide every time you want to post on the BitShares network.
If you chose an empty password, your keys will be stored in plain text
which allows automated posting but exposes your private key to your
local user.
List available Keys and accounts
airsign listkeys
This command will give the list of public keys to which the private keys
are available.
airsign listaccounts
This command tries to resolve the public keys into account names registered
on the network (experimental).
Get Balances
The command getbalance
only takes optional arguments if you want to
see the balance of a specific account, else it will show all balances
for which a key has been added to the wallet (see above)
$ airsign getbalance
Please unlock your existing wallet!
Passphrase:
wallet.xeroc:
+-------------+----------+
| Amount | Asset |
+-------------+----------+
| 61557.53766 | BTS |
| 1e-07 | OPEN.BTC |
| 107.5035 | MKR |
+-------------+----------+
live-coding:
+------------+-------+
| Amount | Asset |
+------------+-------+
| 9993.84531 | BTS |
+------------+-------+
Transfer
Transfers can be initiated from any account for which the active key
is installed. The --amount
parameter can be applied several times to
send different assets from the same origin to the same recepient. The
command supports encrypted memos. If your account has a distinct memo
key (usually identical to the active key), then you need to add that key
to your wallet aswell.
airsign transfer --from <fromaccount> --to <recepient> --amount "1 USD" --amount "2 BTS" --memo <Text>
The global --nobroadcast
flag can be added before transfer
to
prevent airsign to broadcast the transaction to the BitShares network:
airsign --nobroadcast transfer --from <fromaccount> --to <recepient> --amount "1 USD" --amount "2 BTS" --memo <Text>
The OP has been created using piston by running:
cat README.md | piston post --author xeroc --permlink "airsign-0-0-1" --category bitshares --title "[Release] AirSign 0.0.1 - Command Line Tool for BitShares"
This reply has been created with:
piston reply --replyto "@xeroc/airsign-0-0-1" --author xeroc --permlink "re-airsign-0-0-1" --title "created by piston"
May I suggest reformatting the OP so that the first line provides a better summary for the index page?
Thanks for the recommendation .. the post has been taken from the README file which starts with a headline. I'll think through another more convenient way to use piston.
Something along the line of a jekyll page with a yaml header ..
Nice work Xeroc. I can't wait till I get a chance to dig in and start playing with it.