38. kortana-cli

kortana-cli is the primary tool for node operators and developers to manage accounts and broadcast transactions without needing a web interface.

38.1 Key Generation

• Command: kortana-cli keygen --type bls
• Description: Generates a new BLS12-381 key pair used strictly by validators for signing blocks and Quorum Certificates.
• Output: Saves to consensus.key (or the specified file).

38.2 Wallet Management

• Command: kortana-cli wallet new
• Description: Generates a new Ed25519 key pair, deriving a ktn: address. Used for holding DNR, staking, and deploying KVM contracts.
• Command: kortana-cli wallet import --mnemonic "your twelve words here"
• Description: Derives an Ed25519 key pair from a standard BIP-39 mnemonic phrase.

38.3 Staking Commands

These commands interact natively with the core protocol.

• stake: Bonds DNR to become an active validator.

  kortana-cli tx stake --amount 100000DNR --key operator.key --rpc <url>
  

• unstake: Begins the unbonding process for a validator.
• delegate: Delegates your DNR to another validator's address.

  kortana-cli tx delegate --to ktn:validator_address --amount 500DNR --key user.key
  

• claim-rewards: Pulls accrued epoch rewards to your liquid balance.

38.4 Governance Commands

• propose: Submits a new parameter change to the ParamStore.

  kortana-cli tx gov propose --param "min_gas_price" --value 2000000000 --deposit 1000DNR --key user.key
  

• vote: Casts a vote (Yes/No/Abstain) on an active governance proposal.

38.5 Genesis Initialization

• Command: kortana-cli genesis init --chain-id 72511
• Description: Bootstraps the ~/.kortana/data directory and prepares the node to sync from genesis.

38.6 Transaction Commands

• send: Sends a standard DNR transfer.

  kortana-cli tx send --to 0xRecipient --amount 5DNR --key user.key
  

• deploy: Deploys a compiled KVM module.

  kortana-cli tx deploy --code build/Contract.kvm --key deployer.key
  

---