@exponent-labs/kamino-vault-idl 0.9.29 → 0.9.30

package/README.md

@@ -0,0 +1,77 @@
+# Kamino Vault instructions
+
+The package exposes the same `args, accounts, programId?` instruction builder
+structure as `@exponent-labs/klend-idl`. Existing root exports (`IDL`, the string
+`PROGRAM_ID`, and `decodeVault`) are preserved.
+
+- `@exponent-labs/kamino-vault-idl/instructions`: `deposit`, `withdraw`, and
+  `getVaultReserveAccounts`, with their argument/account types.
+- `@exponent-labs/kamino-vault-idl/accounts`: `fetchVaultReserves`.
+
+The deposit and withdrawal account layouts match the
+[upstream v2.2.2 IDL](https://github.com/Kamino-Finance/klend-sdk/blob/master/src/idl/kvault.json)
+and the mainnet program's on-chain IDL, checked on 2026-10-06. The bundled IDL's
+withdrawal entries include the required `global_config` account. The rest of the
+bundled IDL retains its existing layout.
+
+## Refresh and build instructions
+
+```typescript
+import BN from "bn.js"
+
+import { fetchVaultReserves } from "@exponent-labs/kamino-vault-idl/accounts"
+import {
+  type DepositAccounts,
+  type WithdrawAccounts,
+  deposit,
+  getVaultReserveAccounts,
+  withdraw,
+} from "@exponent-labs/kamino-vault-idl/instructions"
+import { refreshReservesBatch } from "@exponent-labs/klend-idl/instructions"
+
+// connection, vaultAddress, depositAccounts, and withdrawAccounts are caller inputs.
+const reserves = await fetchVaultReserves(connection, vaultAddress)
+const refreshIx = refreshReservesBatch({ skipPriceUpdates: true })
+refreshIx.keys.push(
+  ...reserves.flatMap(({ reserveAddress, marketAddress }) => [
+    { pubkey: reserveAddress, isSigner: false, isWritable: true },
+    { pubkey: marketAddress, isSigner: false, isWritable: false },
+  ]),
+)
+
+const remainingAccounts = getVaultReserveAccounts(reserves)
+const depositIx = deposit(
+  { maxAmount: new BN("1000000") }, // 1 USDC, including crank fees
+  { ...depositAccounts, remainingAccounts } satisfies DepositAccounts,
+)
+const withdrawIx = withdraw(
+  { sharesAmount: new BN("936761") }, // Raw vault shares, not a USDC amount
+  { ...withdrawAccounts, remainingAccounts } satisfies WithdrawAccounts,
+)
+```
+
+Send `[refreshIx, depositIx]` or `[refreshIx, withdrawIx]` in one transaction,
+after any needed token account creation instructions. Refresh and the vault
+instruction need to execute in the same slot. `skipPriceUpdates: true` accrues
+reserve interest without fetching oracle updates.
+
+KLend refresh accounts alternate **reserve, market**. KVault's remaining accounts
+contain **all reserves, then all markets**, in allocation order. Repeated markets
+must be retained.
+
+`fetchVaultReserves` validates account ownership and discriminators and returns
+`reserveAddress`, `marketAddress`, `ctokenVault`, and the decoded KLend `account`.
+It skips unused allocation slots and throws if an active reserve is missing.
+
+Withdrawal takes the IDL's nested `withdrawFromAvailable` and
+`withdrawFromReserveAccounts` account groups. Select a reserve with sufficient
+withdrawable liquidity; the decoded reserve exposes its collateral mint and
+liquidity supply. Derive the lending market authority with seeds
+`[Buffer.from("lma"), marketAddress.toBuffer()]` under the KLend program. Derive
+`globalConfig` with `[Buffer.from("global_config")]` under the KVault program.
+These builders return individual instructions; reserve selection, ATA creation,
+and any farm unstaking are handled by the caller. If a vault requires a
+permissioning authority, append its signer meta after the reserve/market blocks.
+
+Run `yarn workspace @exponent-labs/kamino-vault-idl build` and
+`yarn workspace @exponent-labs/kamino-vault-idl test` to validate the bindings.

package/build/accounts/fetchVaultReserves.d.ts

@@ -0,0 +1,13 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Reserve } from "@exponent-labs/klend-idl/accounts";
+export type VaultReserve = {
+    reserveAddress: PublicKey;
+    marketAddress: PublicKey;
+    ctokenVault: PublicKey;
+    account: Reserve;
+};
+/**
+ * Fetches every active reserve in vault allocation order, including its market and cToken vault.
+ * Verifies vault/reserve ownership and discriminators; throws for missing accounts.
+ */
+export declare function fetchVaultReserves(connection: Connection, vaultAddress: PublicKey, programId?: PublicKey): Promise<VaultReserve[]>;

package/build/accounts/fetchVaultReserves.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchVaultReserves = fetchVaultReserves;
+const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
+const accounts_1 = require("@exponent-labs/klend-idl/accounts");
+const kaminovault_json_1 = __importDefault(require("../kaminovault.json"));
+const programId_1 = require("../programId");
+const ACCOUNT_CODER = new anchor_1.BorshAccountsCoder(kaminovault_json_1.default);
+/**
+ * Fetches every active reserve in vault allocation order, including its market and cToken vault.
+ * Verifies vault/reserve ownership and discriminators; throws for missing accounts.
+ */
+async function fetchVaultReserves(connection, vaultAddress, programId = programId_1.PROGRAM_ID) {
+    const info = await connection.getAccountInfo(vaultAddress);
+    if (!info)
+        throw new Error(`Kamino Vault not found: ${vaultAddress.toBase58()}`);
+    if (!info.owner.equals(programId))
+        throw new Error(`Account is not a Kamino Vault: ${vaultAddress.toBase58()}`);
+    const vault = ACCOUNT_CODER.decode("VaultState", info.data);
+    const allocations = vault.vault_allocation_strategy.filter(({ reserve }) => !reserve.equals(web3_js_1.PublicKey.default));
+    if (allocations.length === 0)
+        return [];
+    const reserves = await accounts_1.Reserve.fetchMultiple(connection, allocations.map(({ reserve }) => reserve));
+    return allocations.map((allocation, index) => {
+        const account = reserves[index];
+        if (!account)
+            throw new Error(`Kamino reserve not found: ${allocation.reserve.toBase58()}`);
+        return {
+            reserveAddress: allocation.reserve,
+            marketAddress: account.lendingMarket,
+            ctokenVault: allocation.ctoken_vault,
+            account,
+        };
+    });
+}
+//# sourceMappingURL=fetchVaultReserves.js.map

package/build/accounts/fetchVaultReserves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchVaultReserves.js","sourceRoot":"","sources":["../../src/accounts/fetchVaultReserves.ts"],"names":[],"mappings":";;;;;AAyBA,gDA0BC;AAnDD,8CAAgE;AAChE,6CAAuD;AAEvD,gEAA2D;AAE3D,2EAAqC;AACrC,4CAAyC;AAEzC,MAAM,aAAa,GAAG,IAAI,2BAAkB,CAAC,0BAAU,CAAC,CAAA;AAaxD;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,YAAuB,EACvB,YAAuB,sBAAU;IAEjC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;IAC1D,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAChF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAC/G,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAmB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/G,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,QAAQ,GAAG,MAAM,kBAAO,CAAC,aAAa,CAC1C,UAAU,EACV,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAC1C,CAAA;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC/B,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC3F,OAAO;YACL,cAAc,EAAE,UAAU,CAAC,OAAO;YAClC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,WAAW,EAAE,UAAU,CAAC,YAAY;YACpC,OAAO;SACR,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/accounts/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchVaultReserves } from "./fetchVaultReserves";
+export type { VaultReserve } from "./fetchVaultReserves";

package/build/accounts/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchVaultReserves = void 0;
+var fetchVaultReserves_1 = require("./fetchVaultReserves");
+Object.defineProperty(exports, "fetchVaultReserves", { enumerable: true, get: function () { return fetchVaultReserves_1.fetchVaultReserves; } });
+//# sourceMappingURL=index.js.map

package/build/accounts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/accounts/index.ts"],"names":[],"mappings":";;;AAAA,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA"}

package/build/index.d.ts

@@ -1,5 +1,9 @@
-/// <reference types="node" />
-/// <reference types="node" />
+export * as accounts from "./accounts";
+export * as instructions from "./instructions";
+export { fetchVaultReserves } from "./accounts";
+export type { VaultReserve } from "./accounts";
+export { deposit, getVaultReserveAccounts, withdraw } from "./instructions";
+export type { DepositArgs, DepositAccounts, WithdrawArgs, WithdrawAccounts, VaultReserveAccounts } from "./instructions";
 export declare const IDL: {
     address: string;
     metadata: {
@@ -34,16 +38,16 @@ export declare const IDL: {
             name: string;
             accounts: ({
                 name: string;
-                writable: boolean;
                 signer: boolean;
+                writable?: undefined;
             } | {
                 name: string;
                 writable: boolean;
                 signer?: undefined;
             } | {
                 name: string;
-                writable?: undefined;
                 signer?: undefined;
+                writable?: undefined;
             })[];
         } | {
             name: string;
@@ -77,7 +81,7 @@ export declare const IDL: {
             signer?: undefined;
             docs?: undefined;
         })[];
-        args: any[];
+        args: never[];
     } | {
         name: string;
         discriminator: number[];
@@ -129,7 +133,7 @@ export declare const IDL: {
             signer?: undefined;
             docs?: undefined;
         })[];
-        args: any[];
+        args: never[];
     })[];
     accounts: {
         name: string;

package/build/index.js

@@ -15,17 +15,35 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeVault = exports.PROGRAM_ID = exports.IDL = void 0;
+exports.decodeVault = exports.PROGRAM_ID = exports.IDL = exports.withdraw = exports.getVaultReserveAccounts = exports.deposit = exports.fetchVaultReserves = exports.instructions = exports.accounts = void 0;
 const anchor_1 = require("@coral-xyz/anchor");
 const idl = __importStar(require("./kaminovault.json"));
+exports.accounts = __importStar(require("./accounts"));
+exports.instructions = __importStar(require("./instructions"));
+var accounts_1 = require("./accounts");
+Object.defineProperty(exports, "fetchVaultReserves", { enumerable: true, get: function () { return accounts_1.fetchVaultReserves; } });
+var instructions_1 = require("./instructions");
+Object.defineProperty(exports, "deposit", { enumerable: true, get: function () { return instructions_1.deposit; } });
+Object.defineProperty(exports, "getVaultReserveAccounts", { enumerable: true, get: function () { return instructions_1.getVaultReserveAccounts; } });
+Object.defineProperty(exports, "withdraw", { enumerable: true, get: function () { return instructions_1.withdraw; } });
 exports.IDL = idl;
 exports.PROGRAM_ID = idl.address;
 const decodeVault = (data) => {

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8CAAmD;AACnD,wDAAyC;AAC5B,QAAA,GAAG,GAAG,GAAG,CAAA;AACT,QAAA,UAAU,GAAW,GAAG,CAAC,OAAO,CAAA;AAEtC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;IAC1C,MAAM,KAAK,GAAG,IAAI,mBAAU,CAAC,WAAU,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;IAEvD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AANY,QAAA,WAAW,eAMvB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8CAAmD;AAEnD,wDAAyC;AAEzC,uDAAsC;AACtC,+DAA8C;AAC9C,uCAA+C;AAAtC,8GAAA,kBAAkB,OAAA;AAE3B,+CAA2E;AAAlE,uGAAA,OAAO,OAAA;AAAE,uHAAA,uBAAuB,OAAA;AAAE,wGAAA,QAAQ,OAAA;AAEtC,QAAA,GAAG,GAAG,GAAG,CAAA;AACT,QAAA,UAAU,GAAW,GAAG,CAAC,OAAO,CAAA;AAEtC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;IAC1C,MAAM,KAAK,GAAG,IAAI,mBAAU,CAAC,WAAU,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;IAEvD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AANY,QAAA,WAAW,eAMvB"}

package/build/instructions/deposit.d.ts

@@ -0,0 +1,28 @@
+import { type AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type BN from "bn.js";
+export type DepositArgs = {
+    /** Maximum deposit in raw underlying token units, including Kamino crank fees. */
+    maxAmount: BN;
+};
+export type DepositAccounts = {
+    user: PublicKey;
+    vaultState: PublicKey;
+    tokenVault: PublicKey;
+    tokenMint: PublicKey;
+    baseVaultAuthority: PublicKey;
+    sharesMint: PublicKey;
+    userTokenAta: PublicKey;
+    userSharesAta: PublicKey;
+    klendProgram: PublicKey;
+    tokenProgram: PublicKey;
+    sharesTokenProgram: PublicKey;
+    eventAuthority: PublicKey;
+    program: PublicKey;
+    /** All active reserves followed by their lending markets; use getVaultReserveAccounts. */
+    remainingAccounts?: readonly AccountMeta[];
+};
+/**
+ * Builds the Kamino Vault deposit instruction from its IDL.
+ * Token accounts must already exist, and reserves must be refreshed before execution.
+ */
+export declare function deposit(args: DepositArgs, accounts: DepositAccounts, programId?: PublicKey): TransactionInstruction;

package/build/instructions/deposit.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deposit = deposit;
+const web3_js_1 = require("@solana/web3.js");
+const programId_1 = require("../programId");
+const encodeInstruction_1 = require("./encodeInstruction");
+/**
+ * Builds the Kamino Vault deposit instruction from its IDL.
+ * Token accounts must already exist, and reserves must be refreshed before execution.
+ */
+function deposit(args, accounts, programId = programId_1.PROGRAM_ID) {
+    const keys = [
+        { pubkey: accounts.user, isSigner: true, isWritable: true },
+        { pubkey: accounts.vaultState, isSigner: false, isWritable: true },
+        { pubkey: accounts.tokenVault, isSigner: false, isWritable: true },
+        { pubkey: accounts.tokenMint, isSigner: false, isWritable: false },
+        { pubkey: accounts.baseVaultAuthority, isSigner: false, isWritable: false },
+        { pubkey: accounts.sharesMint, isSigner: false, isWritable: true },
+        { pubkey: accounts.userTokenAta, isSigner: false, isWritable: true },
+        { pubkey: accounts.userSharesAta, isSigner: false, isWritable: true },
+        { pubkey: accounts.klendProgram, isSigner: false, isWritable: false },
+        { pubkey: accounts.tokenProgram, isSigner: false, isWritable: false },
+        { pubkey: accounts.sharesTokenProgram, isSigner: false, isWritable: false },
+        { pubkey: accounts.eventAuthority, isSigner: false, isWritable: false },
+        { pubkey: accounts.program, isSigner: false, isWritable: false },
+        ...(accounts.remainingAccounts ?? []).map((account) => ({ ...account })),
+    ];
+    const data = (0, encodeInstruction_1.encodeInstruction)("deposit", { max_amount: args.maxAmount });
+    return new web3_js_1.TransactionInstruction({ keys, programId, data });
+}
+//# sourceMappingURL=deposit.js.map

package/build/instructions/deposit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.js","sourceRoot":"","sources":["../../src/instructions/deposit.ts"],"names":[],"mappings":";;AAiCA,0BAuBC;AAxDD,6CAAqF;AAGrF,4CAAyC;AACzC,2DAAuD;AAyBvD;;;GAGG;AACH,SAAgB,OAAO,CACrB,IAAiB,EACjB,QAAyB,EACzB,YAAuB,sBAAU;IAEjC,MAAM,IAAI,GAAkB;QAC1B,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC3D,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QAClE,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QAClE,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QAClE,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QAC3E,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QAClE,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QACpE,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QACrE,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QACrE,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QACrE,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QAC3E,EAAE,MAAM,EAAE,QAAQ,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QACvE,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;QAChE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;KACzE,CAAA;IACD,MAAM,IAAI,GAAG,IAAA,qCAAiB,EAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACzE,OAAO,IAAI,gCAAsB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC9D,CAAC"}

package/build/instructions/encodeInstruction.d.ts

@@ -0,0 +1,3 @@
+import BN from "bn.js";
+/** Encodes the vault's u64 arguments using the bundled IDL, rejecting values outside the wire format. */
+export declare function encodeInstruction(name: "deposit" | "withdraw", args: Record<string, BN>): Buffer;

package/build/instructions/encodeInstruction.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeInstruction = encodeInstruction;
+const anchor_1 = require("@coral-xyz/anchor");
+const bn_js_1 = __importDefault(require("bn.js"));
+const kaminovault_json_1 = __importDefault(require("../kaminovault.json"));
+const INSTRUCTION_CODER = new anchor_1.BorshInstructionCoder(kaminovault_json_1.default);
+/** Encodes the vault's u64 arguments using the bundled IDL, rejecting values outside the wire format. */
+function encodeInstruction(name, args) {
+    for (const [field, value] of Object.entries(args)) {
+        if (!bn_js_1.default.isBN(value) || value.isNeg() || value.bitLength() > 64) {
+            throw new Error(`${field} must be an unsigned 64-bit integer`);
+        }
+    }
+    return INSTRUCTION_CODER.encode(name, args);
+}
+//# sourceMappingURL=encodeInstruction.js.map

package/build/instructions/encodeInstruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeInstruction.js","sourceRoot":"","sources":["../../src/instructions/encodeInstruction.ts"],"names":[],"mappings":";;;;;AAQA,8CAOC;AAfD,8CAAmE;AACnE,kDAAsB;AAEtB,2EAAqC;AAErC,MAAM,iBAAiB,GAAG,IAAI,8BAAqB,CAAC,0BAAU,CAAC,CAAA;AAE/D,yGAAyG;AACzG,SAAgB,iBAAiB,CAAC,IAA4B,EAAE,IAAwB;IACtF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,eAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAA;QAChE,CAAC;IACH,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAC7C,CAAC"}

package/build/instructions/getVaultReserveAccounts.d.ts

@@ -0,0 +1,7 @@
+import type { AccountMeta, PublicKey } from "@solana/web3.js";
+export type VaultReserveAccounts = {
+    reserveAddress: PublicKey;
+    marketAddress: PublicKey;
+};
+/** Builds KVault remaining accounts as an allocation-ordered reserve block followed by its market block. */
+export declare function getVaultReserveAccounts(reserves: readonly VaultReserveAccounts[]): AccountMeta[];

package/build/instructions/getVaultReserveAccounts.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVaultReserveAccounts = getVaultReserveAccounts;
+/** Builds KVault remaining accounts as an allocation-ordered reserve block followed by its market block. */
+function getVaultReserveAccounts(reserves) {
+    return [
+        ...reserves.map(({ reserveAddress }) => ({ pubkey: reserveAddress, isSigner: false, isWritable: true })),
+        ...reserves.map(({ marketAddress }) => ({ pubkey: marketAddress, isSigner: false, isWritable: false })),
+    ];
+}
+//# sourceMappingURL=getVaultReserveAccounts.js.map

package/build/instructions/getVaultReserveAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVaultReserveAccounts.js","sourceRoot":"","sources":["../../src/instructions/getVaultReserveAccounts.ts"],"names":[],"mappings":";;AAQA,0DAKC;AAND,4GAA4G;AAC5G,SAAgB,uBAAuB,CAAC,QAAyC;IAC/E,OAAO;QACL,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACxG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;KACxG,CAAA;AACH,CAAC"}

package/build/instructions/index.d.ts

@@ -0,0 +1,6 @@
+export { deposit } from "./deposit";
+export type { DepositArgs, DepositAccounts } from "./deposit";
+export { withdraw } from "./withdraw";
+export type { WithdrawArgs, WithdrawAccounts } from "./withdraw";
+export { getVaultReserveAccounts } from "./getVaultReserveAccounts";
+export type { VaultReserveAccounts } from "./getVaultReserveAccounts";

package/build/instructions/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVaultReserveAccounts = exports.withdraw = exports.deposit = void 0;
+var deposit_1 = require("./deposit");
+Object.defineProperty(exports, "deposit", { enumerable: true, get: function () { return deposit_1.deposit; } });
+var withdraw_1 = require("./withdraw");
+Object.defineProperty(exports, "withdraw", { enumerable: true, get: function () { return withdraw_1.withdraw; } });
+var getVaultReserveAccounts_1 = require("./getVaultReserveAccounts");
+Object.defineProperty(exports, "getVaultReserveAccounts", { enumerable: true, get: function () { return getVaultReserveAccounts_1.getVaultReserveAccounts; } });
+//# sourceMappingURL=index.js.map

package/build/instructions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instructions/index.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AAA1B,kGAAA,OAAO,OAAA;AAEhB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AAEjB,qEAAmE;AAA1D,kIAAA,uBAAuB,OAAA"}

package/build/instructions/withdraw.d.ts

@@ -0,0 +1,44 @@
+import { type AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type BN from "bn.js";
+export type WithdrawArgs = {
+    /** Vault shares to burn in raw share token units. */
+    sharesAmount: BN;
+};
+export type WithdrawAccounts = {
+    withdrawFromAvailable: {
+        user: PublicKey;
+        vaultState: PublicKey;
+        globalConfig: PublicKey;
+        tokenVault: PublicKey;
+        baseVaultAuthority: PublicKey;
+        userTokenAta: PublicKey;
+        tokenMint: PublicKey;
+        userSharesAta: PublicKey;
+        sharesMint: PublicKey;
+        tokenProgram: PublicKey;
+        sharesTokenProgram: PublicKey;
+        klendProgram: PublicKey;
+        eventAuthority: PublicKey;
+        program: PublicKey;
+    };
+    withdrawFromReserveAccounts: {
+        vaultState: PublicKey;
+        reserve: PublicKey;
+        ctokenVault: PublicKey;
+        lendingMarket: PublicKey;
+        lendingMarketAuthority: PublicKey;
+        reserveLiquiditySupply: PublicKey;
+        reserveCollateralMint: PublicKey;
+        reserveCollateralTokenProgram: PublicKey;
+        instructionSysvarAccount: PublicKey;
+    };
+    eventAuthority: PublicKey;
+    program: PublicKey;
+    /** All active reserves followed by their lending markets; use getVaultReserveAccounts. */
+    remainingAccounts?: readonly AccountMeta[];
+};
+/**
+ * Builds a reserve-specific Kamino Vault withdrawal using raw share units.
+ * Callers select a reserve with sufficient liquidity and refresh all active reserves before execution.
+ */
+export declare function withdraw(args: WithdrawArgs, accounts: WithdrawAccounts, programId?: PublicKey): TransactionInstruction;

package/build/instructions/withdraw.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withdraw = withdraw;
+const web3_js_1 = require("@solana/web3.js");
+const programId_1 = require("../programId");
+const encodeInstruction_1 = require("./encodeInstruction");
+/**
+ * Builds a reserve-specific Kamino Vault withdrawal using raw share units.
+ * Callers select a reserve with sufficient liquidity and refresh all active reserves before execution.
+ */
+function withdraw(args, accounts, programId = programId_1.PROGRAM_ID) {
+    const available = accounts.withdrawFromAvailable;
+    const reserve = accounts.withdrawFromReserveAccounts;
+    const keys = [
+        { pubkey: available.user, isSigner: true, isWritable: false },
+        { pubkey: available.vaultState, isSigner: false, isWritable: true },
+        { pubkey: available.globalConfig, isSigner: false, isWritable: false },
+        { pubkey: available.tokenVault, isSigner: false, isWritable: true },
+        { pubkey: available.baseVaultAuthority, isSigner: false, isWritable: false },
+        { pubkey: available.userTokenAta, isSigner: false, isWritable: true },
+        { pubkey: available.tokenMint, isSigner: false, isWritable: true },
+        { pubkey: available.userSharesAta, isSigner: false, isWritable: true },
+        { pubkey: available.sharesMint, isSigner: false, isWritable: true },
+        { pubkey: available.tokenProgram, isSigner: false, isWritable: false },
+        { pubkey: available.sharesTokenProgram, isSigner: false, isWritable: false },
+        { pubkey: available.klendProgram, isSigner: false, isWritable: false },
+        { pubkey: available.eventAuthority, isSigner: false, isWritable: false },
+        { pubkey: available.program, isSigner: false, isWritable: false },
+        { pubkey: reserve.vaultState, isSigner: false, isWritable: true },
+        { pubkey: reserve.reserve, isSigner: false, isWritable: true },
+        { pubkey: reserve.ctokenVault, isSigner: false, isWritable: true },
+        { pubkey: reserve.lendingMarket, isSigner: false, isWritable: false },
+        { pubkey: reserve.lendingMarketAuthority, isSigner: false, isWritable: false },
+        { pubkey: reserve.reserveLiquiditySupply, isSigner: false, isWritable: true },
+        { pubkey: reserve.reserveCollateralMint, isSigner: false, isWritable: true },
+        { pubkey: reserve.reserveCollateralTokenProgram, isSigner: false, isWritable: false },
+        { pubkey: reserve.instructionSysvarAccount, isSigner: false, isWritable: false },
+        { pubkey: accounts.eventAuthority, isSigner: false, isWritable: false },
+        { pubkey: accounts.program, isSigner: false, isWritable: false },
+        ...(accounts.remainingAccounts ?? []).map((account) => ({ ...account })),
+    ];
+    const data = (0, encodeInstruction_1.encodeInstruction)("withdraw", { shares_amount: args.sharesAmount });
+    return new web3_js_1.TransactionInstruction({ keys, programId, data });
+}
+//# sourceMappingURL=withdraw.js.map

package/build/instructions/withdraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdraw.js","sourceRoot":"","sources":["../../src/instructions/withdraw.ts"],"names":[],"mappings":"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"}

package/build/kaminovault.json

@@ -167,13 +167,15 @@
                     "accounts": [
                         {
                             "name": "user",
-                            "writable": true,
                             "signer": true
                         },
                         {
                             "name": "vault_state",
                             "writable": true
                         },
+                        {
+                            "name": "global_config"
+                        },
                         {
                             "name": "token_vault",
                             "writable": true
@@ -561,13 +563,15 @@
             "accounts": [
                 {
                     "name": "user",
-                    "writable": true,
                     "signer": true
                 },
                 {
                     "name": "vault_state",
                     "writable": true
                 },
+                {
+                    "name": "global_config"
+                },
                 {
                     "name": "token_vault",
                     "writable": true

package/build/programId.d.ts

@@ -0,0 +1,2 @@
+import { PublicKey } from "@solana/web3.js";
+export declare const PROGRAM_ID: PublicKey;

package/build/programId.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROGRAM_ID = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const kaminovault_json_1 = __importDefault(require("./kaminovault.json"));
+exports.PROGRAM_ID = new web3_js_1.PublicKey(kaminovault_json_1.default.address);
+//# sourceMappingURL=programId.js.map

package/build/programId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programId.js","sourceRoot":"","sources":["../src/programId.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA2C;AAE3C,0EAAoC;AAEvB,QAAA,UAAU,GAAG,IAAI,mBAAS,CAAC,0BAAG,CAAC,OAAO,CAAC,CAAA"}

package/package.json

@@ -1,16 +1,50 @@
 {
   "name": "@exponent-labs/kamino-vault-idl",
-  "version": "0.9.29",
+  "version": "0.9.30",
   "main": "build/index.js",
   "types": "build/index.d.ts",
+  "files": [
+    "build",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    },
+    "./instructions": {
+      "types": "./build/instructions/index.d.ts",
+      "default": "./build/instructions/index.js"
+    },
+    "./accounts": {
+      "types": "./build/accounts/index.d.ts",
+      "default": "./build/accounts/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "instructions": [
+        "./build/instructions/index.d.ts"
+      ],
+      "accounts": [
+        "./build/accounts/index.d.ts"
+      ]
+    }
+  },
   "license": "AGPL-3.0",
   "scripts": {
-    "build": "tsc --build"
+    "build": "tsc --build",
+    "test": "node --import tsx --test test/*.test.ts"
   },
   "dependencies": {
-    "@coral-xyz/anchor": "0.31.1"
+    "@coral-xyz/anchor": "0.31.1",
+    "@exponent-labs/klend-idl": "0.9.30",
+    "@solana/web3.js": "1.98.4",
+    "bn.js": "5.2.2"
   },
   "devDependencies": {
+    "@types/bn.js": "^5.1.0",
+    "tsx": "^4.19.4",
     "typescript": "5.4.5"
   }
 }

package/src/accounts/fetchVaultReserves.ts

@@ -0,0 +1,52 @@
+import { BorshAccountsCoder, type Idl } from "@coral-xyz/anchor"
+import { Connection, PublicKey } from "@solana/web3.js"
+
+import { Reserve } from "@exponent-labs/klend-idl/accounts"
+
+import idl from "../kaminovault.json"
+import { PROGRAM_ID } from "../programId"
+
+const ACCOUNT_CODER = new BorshAccountsCoder(idl as Idl)
+
+type VaultAllocations = {
+  vault_allocation_strategy: { reserve: PublicKey; ctoken_vault: PublicKey }[]
+}
+
+export type VaultReserve = {
+  reserveAddress: PublicKey
+  marketAddress: PublicKey
+  ctokenVault: PublicKey
+  account: Reserve
+}
+
+/**
+ * Fetches every active reserve in vault allocation order, including its market and cToken vault.
+ * Verifies vault/reserve ownership and discriminators; throws for missing accounts.
+ */
+export async function fetchVaultReserves(
+  connection: Connection,
+  vaultAddress: PublicKey,
+  programId: PublicKey = PROGRAM_ID,
+): Promise<VaultReserve[]> {
+  const info = await connection.getAccountInfo(vaultAddress)
+  if (!info) throw new Error(`Kamino Vault not found: ${vaultAddress.toBase58()}`)
+  if (!info.owner.equals(programId)) throw new Error(`Account is not a Kamino Vault: ${vaultAddress.toBase58()}`)
+  const vault = ACCOUNT_CODER.decode<VaultAllocations>("VaultState", info.data)
+  const allocations = vault.vault_allocation_strategy.filter(({ reserve }) => !reserve.equals(PublicKey.default))
+  if (allocations.length === 0) return []
+
+  const reserves = await Reserve.fetchMultiple(
+    connection,
+    allocations.map(({ reserve }) => reserve),
+  )
+  return allocations.map((allocation, index) => {
+    const account = reserves[index]
+    if (!account) throw new Error(`Kamino reserve not found: ${allocation.reserve.toBase58()}`)
+    return {
+      reserveAddress: allocation.reserve,
+      marketAddress: account.lendingMarket,
+      ctokenVault: allocation.ctoken_vault,
+      account,
+    }
+  })
+}

package/src/accounts/index.ts

@@ -0,0 +1,2 @@
+export { fetchVaultReserves } from "./fetchVaultReserves"
+export type { VaultReserve } from "./fetchVaultReserves"

package/src/index.ts

@@ -1,5 +1,13 @@
 import { BorshCoder, Idl } from "@coral-xyz/anchor"
+
 import * as idl from "./kaminovault.json"
+
+export * as accounts from "./accounts"
+export * as instructions from "./instructions"
+export { fetchVaultReserves } from "./accounts"
+export type { VaultReserve } from "./accounts"
+export { deposit, getVaultReserveAccounts, withdraw } from "./instructions"
+export type { DepositArgs, DepositAccounts, WithdrawArgs, WithdrawAccounts, VaultReserveAccounts } from "./instructions"
 export const IDL = idl
 export const PROGRAM_ID: string = idl.address
 

package/src/instructions/deposit.ts

@@ -0,0 +1,57 @@
+import { type AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js"
+import type BN from "bn.js"
+
+import { PROGRAM_ID } from "../programId"
+import { encodeInstruction } from "./encodeInstruction"
+
+export type DepositArgs = {
+  /** Maximum deposit in raw underlying token units, including Kamino crank fees. */
+  maxAmount: BN
+}
+
+export type DepositAccounts = {
+  user: PublicKey
+  vaultState: PublicKey
+  tokenVault: PublicKey
+  tokenMint: PublicKey
+  baseVaultAuthority: PublicKey
+  sharesMint: PublicKey
+  userTokenAta: PublicKey
+  userSharesAta: PublicKey
+  klendProgram: PublicKey
+  tokenProgram: PublicKey
+  sharesTokenProgram: PublicKey
+  eventAuthority: PublicKey
+  program: PublicKey
+  /** All active reserves followed by their lending markets; use getVaultReserveAccounts. */
+  remainingAccounts?: readonly AccountMeta[]
+}
+
+/**
+ * Builds the Kamino Vault deposit instruction from its IDL.
+ * Token accounts must already exist, and reserves must be refreshed before execution.
+ */
+export function deposit(
+  args: DepositArgs,
+  accounts: DepositAccounts,
+  programId: PublicKey = PROGRAM_ID,
+): TransactionInstruction {
+  const keys: AccountMeta[] = [
+    { pubkey: accounts.user, isSigner: true, isWritable: true },
+    { pubkey: accounts.vaultState, isSigner: false, isWritable: true },
+    { pubkey: accounts.tokenVault, isSigner: false, isWritable: true },
+    { pubkey: accounts.tokenMint, isSigner: false, isWritable: false },
+    { pubkey: accounts.baseVaultAuthority, isSigner: false, isWritable: false },
+    { pubkey: accounts.sharesMint, isSigner: false, isWritable: true },
+    { pubkey: accounts.userTokenAta, isSigner: false, isWritable: true },
+    { pubkey: accounts.userSharesAta, isSigner: false, isWritable: true },
+    { pubkey: accounts.klendProgram, isSigner: false, isWritable: false },
+    { pubkey: accounts.tokenProgram, isSigner: false, isWritable: false },
+    { pubkey: accounts.sharesTokenProgram, isSigner: false, isWritable: false },
+    { pubkey: accounts.eventAuthority, isSigner: false, isWritable: false },
+    { pubkey: accounts.program, isSigner: false, isWritable: false },
+    ...(accounts.remainingAccounts ?? []).map((account) => ({ ...account })),
+  ]
+  const data = encodeInstruction("deposit", { max_amount: args.maxAmount })
+  return new TransactionInstruction({ keys, programId, data })
+}

package/src/instructions/encodeInstruction.ts

@@ -0,0 +1,16 @@
+import { BorshInstructionCoder, type Idl } from "@coral-xyz/anchor"
+import BN from "bn.js"
+
+import idl from "../kaminovault.json"
+
+const INSTRUCTION_CODER = new BorshInstructionCoder(idl as Idl)
+
+/** Encodes the vault's u64 arguments using the bundled IDL, rejecting values outside the wire format. */
+export function encodeInstruction(name: "deposit" | "withdraw", args: Record<string, BN>): Buffer {
+  for (const [field, value] of Object.entries(args)) {
+    if (!BN.isBN(value) || value.isNeg() || value.bitLength() > 64) {
+      throw new Error(`${field} must be an unsigned 64-bit integer`)
+    }
+  }
+  return INSTRUCTION_CODER.encode(name, args)
+}

package/src/instructions/getVaultReserveAccounts.ts

@@ -0,0 +1,14 @@
+import type { AccountMeta, PublicKey } from "@solana/web3.js"
+
+export type VaultReserveAccounts = {
+  reserveAddress: PublicKey
+  marketAddress: PublicKey
+}
+
+/** Builds KVault remaining accounts as an allocation-ordered reserve block followed by its market block. */
+export function getVaultReserveAccounts(reserves: readonly VaultReserveAccounts[]): AccountMeta[] {
+  return [
+    ...reserves.map(({ reserveAddress }) => ({ pubkey: reserveAddress, isSigner: false, isWritable: true })),
+    ...reserves.map(({ marketAddress }) => ({ pubkey: marketAddress, isSigner: false, isWritable: false })),
+  ]
+}

package/src/instructions/index.ts

@@ -0,0 +1,6 @@
+export { deposit } from "./deposit"
+export type { DepositArgs, DepositAccounts } from "./deposit"
+export { withdraw } from "./withdraw"
+export type { WithdrawArgs, WithdrawAccounts } from "./withdraw"
+export { getVaultReserveAccounts } from "./getVaultReserveAccounts"
+export type { VaultReserveAccounts } from "./getVaultReserveAccounts"

package/src/instructions/withdraw.ts

@@ -0,0 +1,87 @@
+import { type AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js"
+import type BN from "bn.js"
+
+import { PROGRAM_ID } from "../programId"
+import { encodeInstruction } from "./encodeInstruction"
+
+export type WithdrawArgs = {
+  /** Vault shares to burn in raw share token units. */
+  sharesAmount: BN
+}
+
+export type WithdrawAccounts = {
+  withdrawFromAvailable: {
+    user: PublicKey
+    vaultState: PublicKey
+    globalConfig: PublicKey
+    tokenVault: PublicKey
+    baseVaultAuthority: PublicKey
+    userTokenAta: PublicKey
+    tokenMint: PublicKey
+    userSharesAta: PublicKey
+    sharesMint: PublicKey
+    tokenProgram: PublicKey
+    sharesTokenProgram: PublicKey
+    klendProgram: PublicKey
+    eventAuthority: PublicKey
+    program: PublicKey
+  }
+  withdrawFromReserveAccounts: {
+    vaultState: PublicKey
+    reserve: PublicKey
+    ctokenVault: PublicKey
+    lendingMarket: PublicKey
+    lendingMarketAuthority: PublicKey
+    reserveLiquiditySupply: PublicKey
+    reserveCollateralMint: PublicKey
+    reserveCollateralTokenProgram: PublicKey
+    instructionSysvarAccount: PublicKey
+  }
+  eventAuthority: PublicKey
+  program: PublicKey
+  /** All active reserves followed by their lending markets; use getVaultReserveAccounts. */
+  remainingAccounts?: readonly AccountMeta[]
+}
+
+/**
+ * Builds a reserve-specific Kamino Vault withdrawal using raw share units.
+ * Callers select a reserve with sufficient liquidity and refresh all active reserves before execution.
+ */
+export function withdraw(
+  args: WithdrawArgs,
+  accounts: WithdrawAccounts,
+  programId: PublicKey = PROGRAM_ID,
+): TransactionInstruction {
+  const available = accounts.withdrawFromAvailable
+  const reserve = accounts.withdrawFromReserveAccounts
+  const keys: AccountMeta[] = [
+    { pubkey: available.user, isSigner: true, isWritable: false },
+    { pubkey: available.vaultState, isSigner: false, isWritable: true },
+    { pubkey: available.globalConfig, isSigner: false, isWritable: false },
+    { pubkey: available.tokenVault, isSigner: false, isWritable: true },
+    { pubkey: available.baseVaultAuthority, isSigner: false, isWritable: false },
+    { pubkey: available.userTokenAta, isSigner: false, isWritable: true },
+    { pubkey: available.tokenMint, isSigner: false, isWritable: true },
+    { pubkey: available.userSharesAta, isSigner: false, isWritable: true },
+    { pubkey: available.sharesMint, isSigner: false, isWritable: true },
+    { pubkey: available.tokenProgram, isSigner: false, isWritable: false },
+    { pubkey: available.sharesTokenProgram, isSigner: false, isWritable: false },
+    { pubkey: available.klendProgram, isSigner: false, isWritable: false },
+    { pubkey: available.eventAuthority, isSigner: false, isWritable: false },
+    { pubkey: available.program, isSigner: false, isWritable: false },
+    { pubkey: reserve.vaultState, isSigner: false, isWritable: true },
+    { pubkey: reserve.reserve, isSigner: false, isWritable: true },
+    { pubkey: reserve.ctokenVault, isSigner: false, isWritable: true },
+    { pubkey: reserve.lendingMarket, isSigner: false, isWritable: false },
+    { pubkey: reserve.lendingMarketAuthority, isSigner: false, isWritable: false },
+    { pubkey: reserve.reserveLiquiditySupply, isSigner: false, isWritable: true },
+    { pubkey: reserve.reserveCollateralMint, isSigner: false, isWritable: true },
+    { pubkey: reserve.reserveCollateralTokenProgram, isSigner: false, isWritable: false },
+    { pubkey: reserve.instructionSysvarAccount, isSigner: false, isWritable: false },
+    { pubkey: accounts.eventAuthority, isSigner: false, isWritable: false },
+    { pubkey: accounts.program, isSigner: false, isWritable: false },
+    ...(accounts.remainingAccounts ?? []).map((account) => ({ ...account })),
+  ]
+  const data = encodeInstruction("withdraw", { shares_amount: args.sharesAmount })
+  return new TransactionInstruction({ keys, programId, data })
+}

package/src/kaminovault.json

@@ -167,13 +167,15 @@
           "accounts": [
             {
               "name": "user",
-              "writable": true,
               "signer": true
             },
             {
               "name": "vault_state",
               "writable": true
             },
+            {
+              "name": "global_config"
+            },
             {
               "name": "token_vault",
               "writable": true
@@ -561,13 +563,15 @@
       "accounts": [
         {
           "name": "user",
-          "writable": true,
           "signer": true
         },
         {
           "name": "vault_state",
           "writable": true
         },
+        {
+          "name": "global_config"
+        },
         {
           "name": "token_vault",
           "writable": true

package/src/programId.ts

@@ -0,0 +1,5 @@
+import { PublicKey } from "@solana/web3.js"
+
+import idl from "./kaminovault.json"
+
+export const PROGRAM_ID = new PublicKey(idl.address)

package/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "files": ["src/index.ts", "src/kaminovault.json"],
-  "compilerOptions": {
-    "rootDir": "src",
-    "sourceMap": true,
-    "incremental": true /* Save .tsbuildinfo files to allow for incremental compilation of projects. */,
-    "composite": true /* Enable constraints that allow a TypeScript project to be used with project references. */,
-    "target": "ESNext" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
-    "module": "CommonJS" /* Specify what module code is generated. */,
-    "declaration": true /* Generate .d.ts files from TypeScript and JavaScript files in your project. */,
-    "outDir": "./build" /* Specify an output folder for all emitted files. */,
-    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
-    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
-    "skipLibCheck": true /* Skip type checking all .d.ts files. */,
-    "resolveJsonModule": true
-  }
-}