Kamino 백서

Kamino

원문

bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 75쪽 중 1쪽

# Building with LLMs Source: https://kamino.com/docs/build/agentic-finance/building-with-llms Leverage Kamino documentation with AI agents and language models for faster development <Note> Kamino documentation is optimized for AI-powered development. Our machine-readable resources enable LLMs and AI agents to understand our APIs and build transactions on Solana. </Note> ## Kamino AI Resources <div> <CardGroup> <Card title="skill.md" icon="brain-circuit" href="https://kamino.com/docs/skill.md"> Structured capability reference with API endpoints, SDK methods, and integration workflows. Start here for agent tool use. </Card> <Card title="llms.txt" icon="file-lines" href="https://kamino.com/docs/llms.txt"> Curated index of all documentation pages with one-line descriptions and direct URLs. </Card> <Card title="llms-pages.json" icon="brackets-curly" href="https://kamino.com/docs/llms-pages.json"> Machine-readable JSON mapping of every page with title, section, URL, and keywords. </Card> </CardGroup> </div> ### skill.md The skill.md file provides a comprehensive, machine-readable reference of Kamino's capabilities across all four products: Earn, Borrow, Multiply, and Liquidity. | Includes | Description | | - | - | | API endpoints | Complete REST endpoint reference for all products | | SDK methods | TypeScript method signatures with real code examples | | Workflows | Step-by-step operations: deposit, borrow, withdraw, repay, stake, harvest | | Integration patterns | Earn vaults, Borrow markets, Liquidity strategies, and Farms | | Use cases | Agent transaction building, API integration, automated DeFi strategies | ### llms.txt A structured navigation map of Kamino's entire documentation, enabling LLMs to discover relevant pages and resources efficiently. | Includes | Description | | - | - | | Page directory | All documentation pages with direct URLs | | Tutorials | Organized by category: Earn, Borrow, Liquidity, Rewards, Oracle | | API reference | Endpoint navigation and documentation links | | Recipes | Code example locations and implementation guides | ### llms-pages.json A JSON file mapping every page path to its metadata: title, URL, section, description, and keywords. Useful for programmatic discovery and filtering. ```json theme={null} { "/products/lending-vaults": { "title": "Lending Vaults", "url": "https://kamino.com/docs/products/lending-vaults", "section": "Docs", "description": "Single-token managed yield aggregation across Kamino's lending markets", "keywords": ["kamino", "lending vaults", "yield", "vault shares", "auto-compounding"] } } ``` # Agent Integrations: Using OpenClaw with Kamino Source: https://kamino.com/docs/build/agentic-finance/openclaw-agent-integration Build an OpenClaw skill to enable AI agents to autonomously interact with Kamino's lending markets and yield vaults <Check> By the end of this tutorial, you will have the following skill files configured for your agent. </Check> <div> | File | Purpose | | - | - | | [`SKILL.md`](#skill-md) | Main skill instructions: capabilities, quick reference, and workflows | | [`references/setup.md`](#references/setup-md) | Environment setup: RPC, wallet keypair, OpenClaw config | | [`references/earn.md`](#references/earn-md) | Earn vault operations: deposit, withdraw, vault data, user positions | | [`references/borrow.md`](#references/borrow-md) | Borrow market operations: deposit, borrow, repay, withdraw, market data | | [`references/multiply.md`](#references/multiply-md) | Multiply operations: leveraged positions, flash loans, position health | | [`references/liquidity.md`](#references/liquidity-md) | Liquidity strategy operations: deposit, withdraw, strategy metrics, user PnL | | [`references/rewards.md`](#references/rewards-md) | Farm operations: stake, unstake, harvest, farm state, pending rewards | | [`references/api.md`](#references/api-md) | Complete REST API endpoint reference for all products | </div> ## Prerequisites * Node.js 22+ * Solana wallet with SOL for transaction fees * RPC endpoint ## Skill Folder Structure <Steps> <Step title="Create Skill Directory"> Create a new directory for the Kamino skill in your OpenClaw workspace: ```bash theme={null} mkdir -p ~/.openclaw/workspace/skills/kamino cd ~/.openclaw/workspace/skills/kamino ``` </Step> <Step title="Create File Structure"> Create the following files in the directory: ``` kamino/ ├── SKILL.md # Main skill instructions for the agent └── references/ ├── setup.md # Environment and SDK setup ├── earn.md # Kamino Earn operations (vaults) ├── borrow.md # Kamino Borrow operations (lending) ├── multiply.md # Kamino Multiply operations (leverage) ├── liquidity.md # Kamino Liquidity operations (strategies) ├── rewards.md # Kamino Rewards operations (farms) └── api.md # Kamino API reference ``` ```bash theme={null} mkdir -p references touch SKILL.md references/setup.md references/earn.md references/borrow.md references/multiply.md references/liquidity.md references/rewards.md references/api.md ``` </Step> <Step title="Get a Solana RPC Endpoint"> Choose an RPC provider: * **Free**: `https://api.mainnet-beta.solana.com` (rate limited) * **Recommended**: Helius, QuickNode, or Triton (paid, production-ready) </Step> <Step title="Create or Use Existing Wallet Keypair"> Create a new keypair if needed: ```bash theme={null} solana-keygen new --outfile ~/solana-wallet.json ``` Or use an existing keypair file. </Step> <Step title="Configure OpenClaw"> Add your Solana credentials to `~/.openclaw/openclaw.json`: ```json theme={null} { "gateway": { "env": { "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com", "SOLANA_WS_URL": "wss://api.mainnet-beta.solana.com", "WALLET_KEYPAIR_PATH": "/path/to/your/solana-wallet.json" } } } ``` Replace `/path/to/your/solana-wallet.json` with the actual path to your keypair file. </Step> <Step title="Restart OpenClaw Gateway"> After updating the configuration: ```bash theme={null} openclaw gateway restart ``` </Step> <Step title="Verify Setup"> Test your RPC connection: ```bash theme={null} curl -X POST $SOLANA_RPC_URL \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}' ``` </Step> </Steps> ### For Other AI Agents * **Claude**: Copy the SKILL.md content into your conversation or attach as a file * **Cursor**: Clone into `.cursor/skills/kamino` directory * **Custom Agents**: Reference the markdown files directly ## File Templates Copy the following templates into your skill files. ### SKILL.md The main skill file that teaches agents how to interact with Kamino: ```markdown expandable theme={null} # Kamino Skill Interact with Kamino Finance on Solana: Earn vaults, Borrow markets, Liquidity strategies, and Rewards farms. ## Prerequisites See [setup.md](references/setup.md) for installation and configuration. Required: - Solana RPC endpoint - Wallet keypair for signing transactions - `@solana/kit` and relevant Kamino SDKs installed ## What You Can Do **Kamino Earn** - Deposit into yield-generating vaults **Kamino Borrow** - Supply collateral, borrow assets, repay loans **Kamino Multiply** - Open and manage leveraged positions **Kamino Liquidity** - Deposit into automated concentrated liquidity strategies **Kamino Rewards** - Stake, unstake, and harvest farm rewards **KSwap** - Swap between any two tokens via Kamino's swap aggregator **Oracle (Scope)** - Read token prices on-chain or via REST ## Quick Reference | Operation | Method | Reference | |-----------|--------|-----------| | Earn: Deposit | SDK or API | [earn.md](references/earn.md) | | Earn: Withdraw | SDK or API | [earn.md](references/earn.md) | | Borrow: Deposit Collateral | API | [borrow.md](references/borrow.md) | | Borrow: Borrow Assets | API | [borrow.md](references/borrow.md) | | Borrow: Repay Loan | API | [borrow.md](references/borrow.md) | | Borrow: Withdraw Collateral | API | [borrow.md](references/borrow.md) | | Multiply: Open Position | SDK | [multiply.md](references/multiply.md) | | Multiply: Monitor Health | SDK | [multiply.md](references/multiply.md) | | Multiply: Close Position | SDK | [multiply.md](references/multiply.md) | | Liquidity: Deposit | SDK | [liquidity.md](references/liquidity.md) | | Liquidity: Withdraw | SDK | [liquidity.md](references/liquidity.md) | | Liquidity: Strategy Data | SDK or API | [liquidity.md](references/liquidity.md) | | Rewards: Stake | SDK | [rewards.md](references/rewards.md) | | Rewards: Unstake | SDK | [rewards.md](references/rewards.md) | | Rewards: Harvest | SDK | [rewards.md](references/rewards.md) | | KSwap: Swap Tokens | API | [api.md](references/api.md) | | Oracle: Read Prices | SDK or API | [api.md](references/api.md) | | Query Market Data | SDK | [borrow.md](references/borrow.md) | | Get Vault/Market Lists | API | [api.md](references/api.md) | ## Core Workflow ### For Kamino Earn: 1. Choose a vault (get list via API or use known address) 2. Deposit tokens to earn yield 3. Withdraw vault shares when needed ### For Kamino Borrow: 1. Supply collateral to a market 2. Borrow assets against your collateral 3. Monitor health factor (keep LTV below 75%) 4. Repay loans and withdraw collateral ### For Kamino Multiply: 1. Choose a strategy (LST, JLP, stablecoin, or xStocks) 2. Open a leveraged position with target leverage 3. Monitor LTV and liquidation risk 4. Adjust leverage, repay debt, or close position ### For Kamino Liquidity: 1. Choose a strategy (get list via API or use known address) 2. Deposit tokens (single-sided or two-sided) 3. Monitor share price and PnL 4. Withdraw shares when needed ### For Kamino Rewards: 1. Find the farm for your position (by stake mint or known address) 2. Stake share tokens into the farm 3. Monitor pending rewards 4. Harvest rewards or unstake and withdraw **SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF` ## Reference Files - **[setup.md](references/setup.md)** — Installation and OpenClaw configuration - **[earn.md](references/earn.md)** — Vault deposit/withdraw code examples - **[borrow.md](references/borrow.md)** — Lending market operations - **[multiply.md](references/multiply.md)** — Leveraged position operations - **[liquidity.md](references/liquidity.md)** — Liquidity strategy operations - **[rewards.md](references/rewards.md)** — Farm staking and reward harvesting - **[api.md](references/api.md)** — Complete API endpoint reference ``` ### references/setup.md Setup guide for using Kamino with OpenClaw: ```markdown expandable theme={null} # Kamino Setup Configure OpenClaw to interact with Kamino Finance protocols on Solana. ## Prerequisites Before using this skill, you need: - OpenClaw installed (Node.js 22+) - Solana RPC endpoint (get from Helius, QuickNode, or use public endpoint) - Solana wallet keypair file for signing transactions For complete developer documentation: https://kamino.com/docs/build **SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF` ``` ### references/earn.md Kamino Earn vault operations: ````markdown expandable theme={null} # Kamino Earn Operations Deposit into yield-generating vaults, withdraw shares, and query vault/user data. ## Dependencies ```bash npm install @solana/kit @kamino-finance/klend-sdk decimal.js ``` ## SDK Instantiation ```typescript import { createSolanaRpc, address } from '@solana/kit'; import { KaminoVault, KaminoManager } from '@kamino-finance/klend-sdk'; const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com'); // Initialize a specific vault const vault = new KaminoVault( rpc, address('VAULT_PUBKEY_HERE') ); // Or use manager for multi-vault operations const manager = new KaminoManager(rpc); ``` ## SDK Operations | What to Do | SDK Method | Documentation | |------------|------------|---------------| | **Transactions** | | Deposit to vault | `vault.depositIxs(signer, amount)` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-via-sdk) | | Withdraw from vault | `vault.withdrawIxs(signer, shareAmount)` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-withdraw-via-sdk) | | **Read Vault Data** | | Get vault holdings | `vault.getVaultHoldings()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) | | Get vault APY | `vault.getAPYs()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) | | Get exchange rate | `vault.getExchangeRate()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) | | Get allocations | `vault.getVaultAllocations()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) | | Get vault overview | `manager.getVaultOverview(vault, tokenPrice)` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) | | **Read User Data** | | Get user shares | `vault.getUserShares(userAddress)` | [Data Docs](https://docs.kamino.finance/build/earn/data/user-position-data) | | Get all positions | `manager.getUserSharesBalanceAllVaults(userAddress)` | [Data Docs](https://docs.kamino.finance/build/earn/data/user-position-data) | ## API Operations | What to Do | API Endpoint | Documentation | |------------|--------------|---------------| | **Transactions** | | Deposit to vault | `POST /ktx/kvault/deposit` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-via-api) | | Withdraw from vault | `POST /ktx/kvault/withdraw` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-withdraw-via-api) | | **Read Vault Data** | | List all vaults | `GET /kvaults/vaults` | [API Docs](https://api-docs.kamino.finance) | | Get vault details | `GET /vault/{vaultPubkey}` | [API Docs](https://api-docs.kamino.finance) | | Get vault metrics | `GET /vault/{vaultPubkey}/metrics` | [API Docs](https://api-docs.kamino.finance) | | Historical metrics | `GET /vault/{vaultPubkey}/metrics/history` | [API Docs](https://api-docs.kamino.finance) | | **Read User Data** | | Get user positions | `GET /kvaults/users/{wallet}/positions` | [API Docs](https://api-docs.kamino.finance) | | Get vault position | `GET /kvaults/users/{wallet}/vaults/{vaultPubkey}/position` | [API Docs](https://api-docs.kamino.finance) | | Get position PnL | `GET /kvaults/users/{wallet}/vaults/{vaultPubkey}/pnl` | [API Docs](https://api-docs.kamino.finance) | | Get transactions | `GET /kvaults/users/{wallet}/transactions` | [API Docs](https://api-docs.kamino.finance) | ## Important Notes - Withdrawals use **vault share amounts**, not underlying token amounts - SDK automatically handles farm unstaking if needed - API transactions use Address Lookup Tables - must use `decompileTransactionMessageFetchingLookupTables` - Historical data only available via API ## Complete Tutorial [Earn and Withdraw Tutorial](https://docs.kamino.finance/build/tutorials/earn/earn-and-withdraw) ```` ### references/borrow\.md Kamino Borrow operations (deposit collateral, borrow, repay, withdraw): ````markdown expandable theme={null} # Kamino Borrow Operations Supply collateral, borrow assets, repay loans, withdraw collateral, and query market/user data. **SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF` ## Dependencies ```bash npm install @solana/kit @kamino-finance/klend-sdk decimal.js ``` ## SDK Instantiation ```typescript import { createSolanaRpc, address } from '@solana/kit'; import { KaminoMarket, VanillaObligation, PROGRAM_ID } from '@kamino-finance/klend-sdk'; const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com'); const marketPubkey = address('7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF'); // Load market with 400ms slot duration const market = await KaminoMarket.load(rpc, marketPubkey, 400, PROGRAM_ID); // Get user's obligation const userAddress = address('USER_WALLET_ADDRESS'); const obligation = await market.getObligationByWallet( userAddress, new VanillaObligation(PROGRAM_ID) ); ``` ## SDK Operations | What to Do | SDK Method | Documentation | |------------|------------|---------------| | **Read Market Data** | | Get total deposit TVL | `market.getTotalDepositTVL()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get total borrow TVL | `market.getTotalBorrowTVL()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get all reserves | `market.getReserves()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get reserve deposit TVL | `reserve.getDepositTvl()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get reserve borrow TVL | `reserve.getBorrowTvl()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get reserve borrow APY | `reserve.totalBorrowAPY(slot)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get reserve supply APY | `reserve.totalSupplyAPY(slot)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | Get reserve utilization | `reserve.calculateUtilizationRatio()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) | | **Read User Data** | | Get user's obligation | `market.getObligationByWallet(user, obligationType)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | | Get all user obligations | `market.getAllUserObligations(user)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | | Get LTV ratio | `obligation.loanToValue()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | | Get borrow utilization | `obligation.refreshedStats.borrowUtilization` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | | Get user deposits | `obligation.deposits` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | | Get user borrows | `obligation.borrows` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) | ## API Operations | What to Do | API Endpoint | Documentation | |------------|--------------|---------------| | **Transactions** | | Deposit collateral | `POST /ktx/klend/deposit` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/deposit-via-api) | | Borrow assets | `POST /ktx/klend/borrow` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/borrow-via-api) | | Repay loan | `POST /ktx/klend/repay` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/repay-via-api) | | Withdraw collateral | `POST /ktx/klend/withdraw` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/withdraw-via-api) | | **Read Market Data** | | List all markets | `GET /v2/kamino-market` | [API Docs](https://api-docs.kamino.finance) | | Get market details | `GET /kamino-market/{marketPubkey}` | [API Docs](https://api-docs.kamino.finance) | | Historical reserve APY | `GET /kamino-market/{marketPubkey}/reserves/{reservePubkey}/metrics/history` | [API Docs](https://api-docs.kamino.finance) | | **Read User Data** | | Get user obligations | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations` | [API Docs](https://api-docs.kamino.finance) | | Get obligation details | `GET /kamino-market/{marketPubkey}/obligations/{obligationPubkey}` | [API Docs](https://api-docs.kamino.finance) | | Get obligation PnL | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations/{obligationPubkey}/pnl` | [API Docs](https://api-docs.kamino.finance) | | Get user rewards | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/rewards` | [API Docs](https://api-docs.kamino.finance) | ## Important Notes - **Address Lookup Tables**: All API transactions use ALTs, must use `decompileTransactionMessageFetchingLookupTables` - **Health checks**: Always verify obligation LTV before borrowing or withdrawing collateral - **Commitment levels**: Use `finalized` for blockhash, `confirmed` for transaction sends - **Error handling**: Wrap all operations in try-catch blocks - **Historical da
프로젝트로 돌아가기