Before starting, complete the Installation & Setup guide. Commands require a .env file with ADMIN (path to vault owner keypair) and RPC configured.
Understanding CLI Modes
All Kamino Manager commands support different execution modes to test and verify operations before committing them:- inspect - Preview the transaction without executing it
- simulate - Test the transaction simulation on-chain
- execute - Execute the transaction immediately
- multisig - Generate a multisig proposal for the operation
It’s recommended to always start with
inspect or simulate mode to verify transactions before running with execute.Network Selection
By default, all commands run against mainnet and no additional flag is needed. To target a different network, pass one of the following flags:--staging— Use the staging program ID--devnet— Use the devnet program ID
The corresponding program IDs (
KVAULT_PROGRAM_ID_MAINNET, KVAULT_PROGRAM_ID_STAGING, KVAULT_PROGRAM_ID_DEVNET) must be configured in your .env file. See the Installation & Setup guide.Create a New Vault
Create a new Kamino vault to manage automated liquidity strategies.1
Create Vault
Run the create vault command with the desired liquidity token mint.
For testing purposes, add the
--staging flag to use the staging program ID or --devnet to use the devnet program ID. These flags are applicable to all CLI commands.2
Save Vault Address
After creation, save the vault address from the command output. This address is required for all subsequent vault operations.
Manage Reserve Allocations
Configure how vault assets are distributed across different lending reserves.Add or Update Reserve Allocation
Add a new reserve to the vault or update an existing reserve’s allocation parameters.allocation-weight- The allocation weight for this reserve; only relevant in relation to other reserve weights (proportional). If Reserve A has weight 100,000 and Reserve B has weight 50,000, Reserve A gets 2/3 of vault assets and Reserve B gets 1/3allocation-cap- The allocation cap in decimal (not lamports) for this reserve
First run with
--mode simulate to verify the operation works as expected, then use --mode execute to send the transaction.Remove Reserve Allocation
Remove a reserve from the vault’s allocation strategy.Vault Ownership Management
Transfer vault ownership to a different admin account. For production vaults, we recommend transferring ownership to a Squads multisig with hardware wallet support.
1
Set Pending Admin
Update the vault’s pending admin to the new owner address.Parameters:
vault- The vault address to change the pending admin fornew-admin- The new admin pubkey to set as pending admin (typically a multisig address)
2
Accept Ownership
The new admin must accept ownership to complete the transfer.
This command must be run with the new admin’s keypair in the ADMIN field of the .env file.
Fee Management
Configure and manage vault performance and management fees.Performance Fees
Set the performance fee taken on generated yield.Management Fees
Set the yearly management fee for vault operations.Withdraw Pending Fees
Withdraw accumulated fees from the vault.Relinquish Fees
The vault manager can give up pending fees (partial or full), which will be distributed to vault token holders. This is useful when pending fees grow larger than the total vault value, allowing the manager to restore the vault to a healthy state.vault- The vault address to give up fees formax-amount-to-give-up- The amount in tokens to be given up from the pending fees
Advanced Operations
Multisig Management
For multisig-controlled vaults, use the--mode multisig flag to generate Base58-encoded transactions for proposal submission.
We recommend using Squads with a hardware wallet for multisig management. The generated transaction can be submitted as a multisig proposal through Squads.
Next Steps
Market Operations
Create and manage lending markets and reserves
Installation & Setup
Review installation and configuration