striim-cli v1.0.8
HUBII STRIIM CLI
About the CLI
This is a command line interface that aims to make usage of the hubii striim APIs as easy and convenient as possible, while maintaining the flexibility of the platform.
About striim
striim is hubii's scaling solution for the Ethereum block chain. It is a hybrid centralized/decentralized solution that enables instant (micro-) payments, trading and trustless settlements.
About hubii
See www.hubii.com for more information.
Prerequisites
- To use this software you need a modern version of NodeJS and NPM. We recommend having the current LTS version (v8.x) installed, or later, and updating NPM to the latest available version.
- You will also need an API key for access to hubii's APIs.
- An ethereum wallet stored as an UTC file, and is's passphrase.
Installation
To install and make the command part of your path:
npm install -g striim-cliConfiguration
To use the striim CLI tool you need to first create a configuration in your
home folder as .striim/config.yaml
Use the init command to create a new config file:
striim initThe config.yaml file is a YAML file where you will need to specify the
following properties:
- apiRoot - The root domain for hubii's APIs.
- appId - The application ID created in hubii's identity server.
- appSecret - The matching secret for the application ID.
- wallet:
- address - The address of your wallet.
- secret - The pass-phrase for your wallet's UTC file.
The CLI tool will give a warning in the shell if the configuration file is accessible by anyone besides the owner. To keep your wallet and API access secure, make sure only you have access to the config file.
Example file:
apiRoot: api2.dev.hubii.net
appId: 123456789012345678901234
appSecret: ********************
wallet:
address: 1234567890123456789012345678901234567890
secret: ********************The UTC file is expected to be found in ~/.striim/keystore.
Usage
To show the built-in help:
striim --helpor to show help for a specific sub-command:
striim <command> --helpInitialize configuration
This will create a config folder and file if it doesnt already exist:
striim initTo recreate and discard previous settings add the --force flag:
striim init --forceCheck configuration
striim configurationDeposit funds
Deposit on-chain funds to be available in hubii striim:
striim deposit 1 ETH
striim deposit 1 TT1Results are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.
Show balance
Shows your balance in hubii striim:
striim show balanceResults are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.
Make a payment
striim pay 100 TT1 to 0a24740dcb4ba8fb8469ef4cfe22eeedcf069076Results are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.
Show pending payments
striim show paymentsResults are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.
Show executed payments
striim show receiptsResults are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.
Get a list of supported currencies
striim show tokensResults are printed as JSON. It is recommended to pipe the result
through jq to get a pretty output in the shell.