Using the Koii CLI
To interact with the K2 locally, you need to install the Koii CLI, create a Koii wallet, and airdrop some Koii tokens into your wallet.
File-system wallets are the least secure method of storing tokens. Storing large amounts of tokens in a file-system wallet is not recommended.
Run the command below to install the Koii command-line tools:
sh -c "$(curl -sSfL https://koi-node-releases.s3.us-east-2.amazonaws.com/koii-install-init.sh)"
After installation is complete, you should see a prompt in the terminal:
Please update your PATH environment variable to include the koii programs
. Copy and run the command beneath this prompt to update your PATH
environment.To confirm your
PATH
environment has been updated run echo $PATH
Run the command below to confirm that the CLI was successfully installed:
koii --version
For Mac users, you might find if you open another terminal the koii cli would not work. Follow these steps to update PATH.
- After installing koii cli, copy the PATH first
- run command
vi ~/.zshrc
``- Insert "export <paste your path here>"
- Save and close exit it, and you are good to go!To run the test validator, use command:
koii-test-validator
The K2 would run locally.
The next step is to create a Koii file system wallet locally. To get the command for creating a wallet, run:
koii address
If you do not have a Koii wallet in
./.config/koii/id.json
,you should see an error prompt:Error: No default signer found, run "koii-keygen new -o /Users/<YOUR_HOME>/.config/koii/id.json" to create a new one
Run the "koii-keygen" command you're prompted to run.
koii-keygen new -o /Users/<YOUR_HOME>/.config/koii/id.json
For different operating system. The path might have a little bit different. Remeber to update your path before running the command.
This command will generate an identity keypair. You can add a BIP39 passphrase for extra security or click the ENTER button for an empty passphrase.
The identity public key can now be viewed by running:
koii-keygen pubkey /Users/<YOUR_HOME>/.config/koii/id.json
Copy and save your wallet path so you can interact with any Koii stack locally.
Your wallet path would be used in create a task and run desktop node.