This is a command line interface that aims to make usage of the hubii nahmii APIs as easy and convenient as possible, while maintaining the flexibility of the platform.
nahmii 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.
See www.hubii.com for more information.
- 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 Python and a C++ compiler installed. For a Windows 10 guide, see here: https://blog.risingstack.com/node-js-windows-10-tutorial/
- You will also need an API key for access to hubii's APIs.
- An Ethereum wallet stored as an UTC/keystore file, and its passphrase.
To install and make the command part of your path:
npm install -g nahmii-cli
To use the nahmii CLI tool you need to first create a configuration in your
home folder as .nahmii/config.yaml
Use the init
command to create a new config file:
nahmii init
The 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 ~/.nahmii/keystore
.
For withdrawing the nahmii off-chain balances back to the base layer, it will have to go through the settlement processes. The processes will be as following:
- Start the settlements using the command
settle
with the amount and currency. This will initiate a settlement dispute period, which would last 5 minutes on Ropsten. - Once the settlement period ended, you will need to stage the qualified settlements by using command
stage
to update the staged balance, which is the maximum available amount for withdrawal. - After the staged balance is successfully updated in the second step, the next is to run the command
withdraw
to transfer a certain amount for a currency from the nahmii contracts to your wallet.
For details of the settlement and withdrawal commands, please refer to the example below or the help messages for the commands.
To show the built-in help:
nahmii --help
or to show help for a specific sub-command:
nahmii <command> --help
This will create a config folder and file if it doesnt already exist:
nahmii init
To recreate and discard previous settings add the --force
flag:
nahmii init --force
nahmii configuration
Deposit on-chain funds to be available in hubii nahmii:
nahmii deposit 1 ETH
nahmii deposit 1 TT1
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
Shows your balance in hubii nahmii:
nahmii show balance
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
nahmii pay 100 TT1 to 0a24740dcb4ba8fb8469ef4cfe22eeedcf069076
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
nahmii show payments
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
nahmii show receipts
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
nahmii show tokens
Results are printed as JSON. It is recommended to pipe the result
through jq
to get a pretty output in the shell.
This will start necessary settlements for the intended stage amount 1 in ETH currency:
nahmii settle 1 ETH
This will update staged balance(max withdrawal amount) according to the qualified settlements:
nahmii stage ETH
This will convert an amount of staged balance back to nahmii off-chain balance:
nahmii unstage 1 ETH
This will withdraw 1 ETH from staged balance to base layer:
nahmii withdraw 1 ETH