Kamino 백서

Kamino

원문

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

ta**: Only available via API ## Complete Tutorials - [Deposit and Borrow Tutorial](https://docs.kamino.finance/build/tutorials/borrow/deposit-and-borrow) - [Repay and Withdraw Tutorial](https://docs.kamino.finance/build/tutorials/borrow/repay-and-withdraw) ```` ### references/multiply.md Kamino Multiply leveraged position operations: ````markdown expandable theme={null} # Kamino Multiply Operations Open leveraged positions, monitor health, adjust leverage, and close positions. ## Dependencies ```bash npm install @solana/kit @kamino-finance/klend-sdk @kamino-finance/kswap-sdk @kamino-finance/scope-sdk decimal.js ``` ## SDK Instantiation ```typescript import { createSolanaRpc, address } from '@solana/kit'; import { KaminoMarket, PROGRAM_ID, getFlashLoanInstructions, getDepositWithLeverageIxs, getRepayWithCollIxs } from '@kamino-finance/klend-sdk'; const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com'); const marketPubkey = address('7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF'); const market = await KaminoMarket.load(rpc, marketPubkey, 400, PROGRAM_ID); ``` ## SDK Operations | What to Do | SDK Method | Documentation | |------------|------------|---------------| | **Transactions** | | Open leveraged position | `getDepositWithLeverageIxs({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/operations/deposit-xstocks) | | Repay with collateral | `getRepayWithCollIxs({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/operations/repay-collateral) | | Flash loan | `getFlashLoanInstructions({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/flash-loans) | | **Read Position Data** | | Get multiply positions | `market.getUserObligationsByTag(ObligationTypeTag.Multiply, userAddress)` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) | | Get position LTV | `obligation.refreshedStats.loanToValue` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) | | Get liquidation LTV | `obligation.refreshedStats.liquidationLtv` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) | | Get net value | `obligation.refreshedStats.netAccountValue` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) | ## Important Notes - Multiply uses flash loans to open positions atomically in a single transaction - Leveraged combo operations (`getDepositWithLeverageIxs`, `getRepayWithCollIxs`) are TypeScript SDK only, not available in Rust - Always monitor LTV to avoid liquidation - Requires KSwap SDK for swap routing and Scope SDK for oracle price refresh - Fetch pair LUTs from `cdn.kamino.finance/resources.json` before building transactions ## Complete Guides - [Flash Loans](https://docs.kamino.finance/build/developers/multiply/flash-loans) - [Open Position (xStocks)](https://docs.kamino.finance/build/developers/multiply/operations/deposit-xstocks) - [Repay with Collateral](https://docs.kamino.finance/build/developers/multiply/operations/repay-collateral) - [Monitor Position Health](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) ```` ### references/liquidity.md Kamino Liquidity strategy operations: ````markdown expandable theme={null} # Kamino Liquidity Operations Deposit into automated concentrated liquidity strategies, withdraw shares, and query strategy/user data. ## Dependencies ```bash npm install @solana/kit @kamino-finance/kliquidity-sdk decimal.js ``` ## SDK Instantiation ```typescript import { createSolanaRpc, address } from '@solana/kit'; import { Kamino } from '@kamino-finance/kliquidity-sdk'; const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com'); const kamino = new Kamino('mainnet-beta', rpc); ``` ## SDK Operations | What to Do | SDK Method | Documentation | |------------|------------|---------------| | **Transactions** | | Single-sided deposit | `kamino.singleSidedDepositTokenB(strategy, amount, signer, slippageBps)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit) | | Two-sided deposit | `kamino.deposit(strategyWithAddress, amountA, amountB, signer)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit) | | Withdraw all shares | `kamino.withdrawAllShares(strategyWithAddress, signer)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/withdraw) | | **Read Strategy Data** | | Get all strategies | `kamino.getAllStrategiesWithFilters(filters)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) | | Get share price and balances | `kamino.getStrategyShareData(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) | | Get share price only | `kamino.getStrategySharePrice(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) | | **Read User Data** | | Get user positions | `kamino.getUserPositions(walletAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/user-position) | ## API Operations | What to Do | API Endpoint | Documentation | |------------|--------------|---------------| | **Read Strategy Data** | | List all strategies | `GET /strategies?status=LIVE` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-list) | | Get strategy metrics | `GET /strategies/{pubkey}/metrics` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategy-metrics) | | Historical metrics | `GET /v2/strategies/{pubkey}/history` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategy-metrics-history) | | Total TVL | `GET /strategies/tvl` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-tvl) | | Fees and rewards | `GET /strategies/fees-and-rewards?period=24h` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-fees-and-rewards) | | **Read User Data** | | User PnL | `GET /v2/strategies/{pubkey}/shareholders/{wallet}/pnl` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/user-data/user-pnl) | | User transactions | `GET /v2/shareholders/{wallet}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/user-data/user-transactions) | ## Important Notes - Single-sided deposit auto-swaps half the input via the SDK's built-in swap router - Withdrawals return both Token A and Token B proportionally - Use `POST /luts/find-minimal` for address lookup table resolution on deposits and withdrawals - Historical data only available via API ## Complete Guide - [Deposit Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit) - [Withdraw Guide](https://docs.kamino.finance/build/developers/liquidity/operations/withdraw) ```` ### references/rewards.md Kamino Rewards farm operations: ````markdown expandable theme={null} # Kamino Rewards Operations Stake into farms, unstake, harvest rewards, and query farm/user data. ## Dependencies ```bash npm install @solana/kit @kamino-finance/farms-sdk decimal.js ``` ## SDK Instantiation ```typescript import { createSolanaRpc, address } from '@solana/kit'; import { Farms, FarmState } from '@kamino-finance/farms-sdk'; const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com'); const farms = new Farms(rpc); ``` ## SDK Operations | What to Do | SDK Method | Documentation | |------------|------------|---------------| | **Transactions** | | Stake tokens | `farms.stakeIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/stake) | | Unstake tokens | `farms.unstakeIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/unstake) | | Withdraw unstaked | `farms.withdrawUnstakedDepositIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/withdraw-unstaked) | | Harvest all rewards | `farms.claimForUserForFarmAllRewardsIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/harvest) | | **Read Farm Data** | | Get farm state | `FarmState.fetch(rpc, farmAddress)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) | | Batch-load farms | `farms.getAllFarmStatesByPubkeys(addresses)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) | | Find farms by mint | `farms.getFarmsForMint(stakeMint)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) | | Get incentive APY | `farms.getRewardsAPYForStrategy(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) | | **Read User Data** | | Get all user positions | `farms.getAllFarmsForUser(walletAddress, now)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) | | Get pending rewards | `farms.getUserPendingRewards(userState, farmState, now, oraclePrices)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) | | Get lockup status | `farms.getLockupDurationAndExpiry(farm, user, now)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) | ## API Operations | What to Do | API Endpoint | Documentation | |------------|--------------|---------------| | Farm transactions | `GET /farms/{farmPubkey}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/farm-transactions) | | Farm management history | `GET /farms/{farmPubkey}/management-history` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/farm-management-history) | | User farm transactions | `GET /farms/users/{pubkey}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/user-transactions) | | Oracle prices (for reward valuation) | `GET /oracles/prices` | [API Ref](https://kamino.com/docs/build/api-reference/oracle/oracle-prices) | ## Important Notes - **Delegated farms** (klend reserve farms, kvault farms) have no stake mint; a delegate authority stakes on behalf of users - **Non-delegated farms** own their stake token; use `getFarmsForMint` to discover them - Unstaking triggers a **withdrawal cooldown** before tokens can be withdrawn - Reward valuation requires oracle prices from `GET /oracles/prices?source=scope` - Farm operations are SDK-only; there are no transaction-building API endpoints for farms ## Complete Guide - [Farm State Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) - [User Position Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) - [Stake Guide](https://docs.kamino.finance/build/developers/rewards/operations/stake) - [Harvest Guide](https://docs.kamino.finance/build/developers/rewards/operations/harvest) ```` ### references/api.md Kamino REST API endpoints: ```markdown expandable theme={null} # Kamino API Reference Quick reference for Kamino Finance REST API. ## Base URL `https://api.kamino.finance` No API key required for public endpoints. ## Complete Documentation - Full API Reference: https://kamino.com/docs/build/api-reference - OpenAPI Specification: https://api-docs.kamino.finance ## Key Endpoints **Kamino Earn:** - `POST /ktx/kvault/deposit` - Deposit to vault - `POST /ktx/kvault/withdraw` - Withdraw from vault - `GET /kvaults/vaults` - List all vaults - `GET /kvaults/users/{walletAddress}/positions` - User positions **Kamino Borrow:** - `POST /ktx/klend/deposit` - Deposit collateral - `POST /ktx/klend/borrow` - Borrow assets - `POST /ktx/klend/repay` - Repay loan - `POST /ktx/klend/withdraw` - Withdraw collateral - `GET /v2/kamino-market` - List all markets - `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations` - User obligations **Kamino Multiply:** - Multiply operations are SDK-only (no API transaction endpoints) - Monitor positions via `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations` **Kamino Liquidity:** - `GET /strategies?status=LIVE` - List all strategies - `GET /strategies/{pubkey}/metrics` - Strategy metrics - `GET /v2/strategies/{pubkey}/history` - Historical metrics - `GET /strategies/tvl` - Total TVL - `GET /v2/strategies/{pubkey}/shareholders/{wallet}/pnl` - User PnL - `GET /v2/shareholders/{wallet}/transactions` - User transactions **Kamino Rewards (Farms):** - `GET /farms/{farmPubkey}/transactions` - Farm transactions - `GET /farms/{farmPubkey}/management-history` - Farm management history - `GET /farms/users/{pubkey}/transactions` - User farm transactions **Oracle:** - `GET /oracles/prices` - Oracle prices with timestamp and staleness - `GET /prices` - Token USD prices by mint **KSwap (Token Swaps):** - `GET /kswap/swap/` - Get best route and transaction for swapping between two tokens **Utilities:** - `POST /luts/find-minimal` - Find minimal Address Lookup Tables ## Important Notes - All transaction endpoints return base64-encoded transactions - Transactions use Address Lookup Tables and require `decompileTransactionMessageFetchingLookupTables` - Client must decode, sign with fresh blockhash, and submit transactions - Farm operations (stake, unstake, harvest) are SDK-only with no API transaction endpoints ``` ## Usage Examples Once installed, your agent can execute commands like: * "Deposit 100 USDC into the SOL-USDC vault" * "Check my current lending positions on Kamino" * "Withdraw 50% of my vault shares" * "Supply 1000 USDC to the lending market" * "What's the APY on the SOL-USDC vault?" * "Deposit into the KMNO/USDC liquidity strategy" * "What are my pending farm rewards?" * "Harvest all rewards from my staked positions" * "Swap 1 SOL to USDC" * "Get the current SOL price from the oracle" For detailed code examples, see the Kamino documentation links in the reference files. # Get airdrop metrics Source: https://kamino.com/docs/build/airdrop/get-airdrop-metrics /kamino-api.json get /v2/airdrop/metrics Fetches aggregated airdrop metrics and metadata for a specific points source. # Get user airdrop allocations Source: https://kamino.com/docs/build/airdrop/get-user-airdrop-allocations /kamino-api.json get /v2/airdrop/users/{pubkey}/allocations Fetches airdrop allocation data for a specific user and source (Seasons...) # Get transaction to borrow liquidity from a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/borrow/klend-borrow ktx-api.json POST /ktx/klend/borrow Borrow liquidity from the specified Kamino Lend market reserve # Get instructions to borrow liquidity from a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/borrow/klend-borrow-instructions ktx-api.json POST /ktx/klend/borrow-instructions Instructions to borrow liquidity from the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size # Get transaction to deposit into a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/deposit/klend-deposit ktx-api.json POST /ktx/klend/deposit Deposit tokens into the specified Kamino Lend market reserve. An optional `memo` is added to the transaction as an SPL memo instruction. # Get instructions to deposit into a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/deposit/klend-deposit-instructions ktx-api.json POST /ktx/klend/deposit-instructions Instructions to deposit tokens into the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size # Get transaction to repay debt of a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/repay/klend-repay ktx-api.json POST /ktx/klend/repay Repay a debt position for the specified Kamino Lend market reserve # Get instructions to repay debt of a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/repay/klend-repay-instructions ktx-api.json POST /ktx/klend/repay-instructions Instructions to repay a debt position for the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size # Get transaction to withdraw from a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/withdraw/klend-withdraw ktx-api.json POST /ktx/klend/withdraw Withdraw tokens from the specified Kamino Lend market reserve # Get instructions to withdraw from a klend reserve Source: https://kamino.com/docs/build/api-reference/borrow/actions/withdraw/klend-withdraw-instructions ktx-api.json POST /ktx/klend/withdraw-instructions Instructions to withdraw tokens from the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size # Get Kamino Market config Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-detail kamino-api.json GET /v2/kamino-market/{pubkey} Get configuration for a specific Kamino Lending market by market address. Optionally filter by program ID. # Get metrics for leverage/multiply vaults Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-leverage-metrics kamino-api.json GET /kamino-market/{pubkey}/leverage/metrics Get aggregated metrics for all leverage and multiply positions in a Kamino Lending market, including average leverage, total borrowed, total deposited, and number of obligations. # Get KLend reserve history Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserve-metrics-history kamino-api.json GET /kamino-market/{marketPubkey}/reserves/{reservePubkey}/metrics/history Get historical metrics for a specific reserve in a Kamino Lending market over a specified time range with configurable frequency (hour or day). Without a frequency, ranges shorter than 32 days are hourly and longer ranges are daily. APYs, amounts and capped available liquidity are means of raw snapshots in each UTC bucket. Other metrics retain the last snapshot. # Get KLend market reserves account data Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserves-account-data kamino-api.json GET /kamino-market/reserves/account-data Fetch reserve account data for given Klend markets. Returns base64-encoded account data for all reserves in the specified markets. # Get metrics for market reserves Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserves-metrics kamino-api.json GET /kamino-market/{pubkey}/reserves/metrics Get current metrics for all reserves in a Kamino Lending market, including APY, TVL, borrow/supply amounts, and LTV ratios. # Get all Kamino Markets config Source: https://kamino.com/docs/build/api-reference/borrow/market-data/markets-list kamino-api.json GET /v2/kamino-market Get all Kamino Lending markets configuration for a specific program ID. This is the V2 endpoint that allows filtering by program ID instead of cluster. # Get KLend reward history Source: https://kamino.com/docs/build/api-reference/borrow/rewards/rewards-history kamino-api.json GET /klend/{depositReservePubkey}/{borrowReservePubkey}/rewards/history Fetches historical KLend reward metrics for a specific deposit and borrow reserve pair # Get KLend rewards Source: https://kamino.com/docs/build/api-reference/borrow/rewards/rewards-list kamino-api.json GET /klend/rewards Fetches all active KLend reward metrics for a specific points source # Get information about a loan (obligation) Source: https://kamino.com/docs/build/api-reference/borrow/user-and-loans-data/loan-detail kamino-api.json GET /klend/loans/{pubkey} Fetches information about a loan # Get KLend obligation history Source: https://kamino.com/docs/build/api-reference/borrow/user-and-loans-data/obligation-metrics-history kamino-api.json GET /v2/kamino-market/{marketPubkey}/obligations/{obligationPubkey}/metrics/history Get historical metrics for a specific obligation in a Ka
프로젝트로 돌아가기