KODA CLI Wallet Guide

1. Download the KODA Core Files Archive for your operating system:
   • Windows: xxx-win64.zip
   • Mac: xxx-osx.zip
   • Linux: xxx-linux.zip
2. Extract the files to a location of your choice (e.g., C:\kobra\)
3. You'll find several executable files, including kobrawallet.exe which is the CLI wallet

The CLI wallet requires command line parameters to run. For convenience, create batch (.bat) files for each operation:

1. Right-click in your KODA folder and select "Create → New text document"
2. Rename it to the operation name (e.g., create-wallet.bat)
3. Open the file with Notepad and add the command line for the operation
4. Add pause as the last line to keep the console window open

kobrawallet.exe create

pause

Create a batch file with the following content:

kobrawallet.exe create

pause

You'll be asked to set a password. A keys.json file will be created in%local\\appdata%\\kobrawallet\\kobra-mainnet folder.

There are two ways to backup your wallet:

1. Method 1: Copy your keys.json file to a safe location
2. Method 2: Create a batch file with the following content:

   kobrawallet.exe dump-unencrypted-data
   
   pause

   You'll be shown a set of 24 words (seed phrase). Write them down in the same order and keep them secure.

To restore your wallet from a seed phrase, create a batch file with:

kobrawallet.exe create --import

pause

You'll be asked to enter your seed phrase and set a new password.

Before performing wallet operations, you need to run the wallet daemon. Make sure you have a node running with the --utxoindex parameter.

For a local node, create a batch file with:

kobrawallet.exe start-daemon

pause

For a remote node:

kobrawallet.exe start-daemon -s 192.168.1.50

pause

Replace 192.168.1.50 with your node's IP address. The daemon will connect to the node and sync your wallet.

Create a batch file with:

kobrawallet.exe new-address

pause

This will generate a new public address in the format kobra:qblablabla. You can create multiple addresses as needed.

To see all your generated addresses, create a batch file with:

kobrawallet.exe show-addresses

pause

Create a batch file with:

kobrawallet.exe balance

pause

For detailed balance per address:

kobrawallet.exe balance -v

pause

To send coins, create a batch file with:

kobrawallet.exe send -v <amount> -t <destination_address>

pause

Replace <amount> with the number of KODA to send and <destination_address> with the recipient's address.

To send all your coins:

kobrawallet.exe send --send-all -t <destination_address>

pause

Multi-signature wallets require multiple keys to authorize transactions, providing enhanced security or collaborative control.

2-of-3 Self-Custody Example:

kobrawallet.exe create --min-signatures=2 --num-private-keys=3 --num-public-keys=3

pause

This creates a wallet where any 2 out of 3 keys are needed to spend funds. You'll receive extended public keys and seed phrases for each key.

3-of-5 Collaborative Example:

Each member creates a wallet with:

kobrawallet.exe create --min-signatures=3 --num-private-keys=1 --num-public-keys=5

pause

Each person generates one private key and shares their extended public key with all other members.

To verify transaction details before signing:

kobrawallet.exe parse -t <unsigned_transaction>

pause

To sign the transaction:

kobrawallet.exe sign -t <unsigned_transaction>

pause

For multi-signature wallets, the partially signed transaction must be passed to other signers until the required number of signatures is reached.

kobrawallet.exe broadcast -t <signed_transaction>

pause

This sends the fully signed transaction to the KODA network. You'll receive a transaction ID that can be used to track the transaction status.