@temporalabs/treasury 0.1.1 → 0.1.3

package/dist/solana/constants.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Solana constants: the programs a Kamino vault deposit or withdrawal names, and the cluster.
+ *
+ * Every program id below was read on Solana mainnet-beta. Both Kamino programs are UPGRADEABLE by their
+ * upgrade authority, so a later upgrade can change any behaviour this client relies on. The decoders in
+ * `layout.ts` refuse an account of the wrong size or type rather than read it, which is the one change this
+ * client can notice; anything else is a disclosure, not a check.
+ */
+/** Kamino's vault program (a curated single-asset vault over Kamino lending reserves). */
+export declare const KVAULT_PROGRAM_ID: "KvauGMspG5k6rtzrqqn7WNn3oZdyKqLKwK2XWQ8FLjd";
+/** Kamino's lending program, where the vault's reserves live. */
+export declare const KLEND_PROGRAM_ID: "KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD";
+/** SPL Token: the program that owns USDC and the vault's share mint. */
+export declare const SPL_TOKEN_PROGRAM_ID: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/** The Associated Token Account program. */
+export declare const ASSOCIATED_TOKEN_PROGRAM_ID: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+/** The System Program. */
+export declare const SYSTEM_PROGRAM_ID: "11111111111111111111111111111111";
+/** The instructions sysvar, which a kVault withdrawal from a reserve names. */
+export declare const SYSVAR_INSTRUCTIONS_ID: "Sysvar1nstructions1111111111111111111111111";
+/** The Compute Budget program. */
+export declare const COMPUTE_BUDGET_PROGRAM_ID: "ComputeBudget111111111111111111111111111111";
+/** The all-zero key: an empty allocation slot's reserve. */
+export declare const DEFAULT_PUBKEY: "11111111111111111111111111111111";
+/**
+ * Solana mainnet-beta's genesis hash. An RPC endpoint is on mainnet exactly when `getGenesisHash` returns this:
+ * the Solana counterpart of an EVM endpoint's `eth_chainId`.
+ */
+export declare const MAINNET_GENESIS_HASH: "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+/** PDA seeds, as Kamino's vault program spells them. */
+export declare const SEEDS: {
+    readonly tokenVault: "token_vault";
+    readonly ctokenVault: "ctoken_vault";
+    readonly baseVaultAuthority: "authority";
+    readonly shares: "shares";
+    readonly globalConfig: "global_config";
+    readonly eventAuthority: "__event_authority";
+    /** The lending program's market authority. */
+    readonly lendingMarketAuthority: "lma";
+};
+/** Account sizes INCLUDING the 8-byte Anchor discriminator, from Kamino's IDL and measured on chain. */
+export declare const VAULT_STATE_SIZE = 62552;
+export declare const RESERVE_SIZE = 8624;
+/** A vault has this many allocation slots; an empty slot's `reserve` is the default key. */
+export declare const MAX_RESERVES = 25;
+/** Solana's packet limit for one serialized transaction. */
+export declare const MAX_TRANSACTION_BYTES = 1232;
+/** The most compute one transaction may request. */
+export declare const MAX_COMPUTE_UNITS = 1400000;

package/dist/solana/constants.js

@@ -0,0 +1,50 @@
+/**
+ * Solana constants: the programs a Kamino vault deposit or withdrawal names, and the cluster.
+ *
+ * Every program id below was read on Solana mainnet-beta. Both Kamino programs are UPGRADEABLE by their
+ * upgrade authority, so a later upgrade can change any behaviour this client relies on. The decoders in
+ * `layout.ts` refuse an account of the wrong size or type rather than read it, which is the one change this
+ * client can notice; anything else is a disclosure, not a check.
+ */
+/** Kamino's vault program (a curated single-asset vault over Kamino lending reserves). */
+export const KVAULT_PROGRAM_ID = "KvauGMspG5k6rtzrqqn7WNn3oZdyKqLKwK2XWQ8FLjd";
+/** Kamino's lending program, where the vault's reserves live. */
+export const KLEND_PROGRAM_ID = "KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD";
+/** SPL Token: the program that owns USDC and the vault's share mint. */
+export const SPL_TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/** The Associated Token Account program. */
+export const ASSOCIATED_TOKEN_PROGRAM_ID = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+/** The System Program. */
+export const SYSTEM_PROGRAM_ID = "11111111111111111111111111111111";
+/** The instructions sysvar, which a kVault withdrawal from a reserve names. */
+export const SYSVAR_INSTRUCTIONS_ID = "Sysvar1nstructions1111111111111111111111111";
+/** The Compute Budget program. */
+export const COMPUTE_BUDGET_PROGRAM_ID = "ComputeBudget111111111111111111111111111111";
+/** The all-zero key: an empty allocation slot's reserve. */
+export const DEFAULT_PUBKEY = SYSTEM_PROGRAM_ID;
+/**
+ * Solana mainnet-beta's genesis hash. An RPC endpoint is on mainnet exactly when `getGenesisHash` returns this:
+ * the Solana counterpart of an EVM endpoint's `eth_chainId`.
+ */
+export const MAINNET_GENESIS_HASH = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
+/** PDA seeds, as Kamino's vault program spells them. */
+export const SEEDS = {
+    tokenVault: "token_vault",
+    ctokenVault: "ctoken_vault",
+    baseVaultAuthority: "authority",
+    shares: "shares",
+    globalConfig: "global_config",
+    eventAuthority: "__event_authority",
+    /** The lending program's market authority. */
+    lendingMarketAuthority: "lma",
+};
+/** Account sizes INCLUDING the 8-byte Anchor discriminator, from Kamino's IDL and measured on chain. */
+export const VAULT_STATE_SIZE = 62_552;
+export const RESERVE_SIZE = 8_624;
+/** A vault has this many allocation slots; an empty slot's `reserve` is the default key. */
+export const MAX_RESERVES = 25;
+/** Solana's packet limit for one serialized transaction. */
+export const MAX_TRANSACTION_BYTES = 1232;
+/** The most compute one transaction may request. */
+export const MAX_COMPUTE_UNITS = 1_400_000;
+//# sourceMappingURL=constants.js.map

package/dist/solana/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/solana/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,6CAAsD,CAAC;AACxF,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,6CAAsD,CAAC;AACvF,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,6CAAsD,CAAC;AAC3F,4CAA4C;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,8CAAuD,CAAC;AACnG,0BAA0B;AAC1B,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAA2C,CAAC;AAC7E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,6CAAsD,CAAC;AAC7F,kCAAkC;AAClC,MAAM,CAAC,MAAM,yBAAyB,GAAG,6CAAsD,CAAC;AAEhG,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,8CAAuD,CAAC;AAE5F,wDAAwD;AACxD,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,aAAa;IACzB,WAAW,EAAE,cAAc;IAC3B,kBAAkB,EAAE,WAAW;IAC/B,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,mBAAmB;IACnC,8CAA8C;IAC9C,sBAAsB,EAAE,KAAK;CACrB,CAAC;AAEX,wGAAwG;AACxG,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAClC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,oDAAoD;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC"}

package/dist/solana/kvault.d.ts

@@ -0,0 +1,99 @@
+/**
+ * The depositor's side of a Kamino vault: the PDAs a deposit or withdrawal names, the two instructions
+ * (`deposit`, `withdraw`), the token-account instruction a first deposit needs, and an UNSIGNED transaction.
+ *
+ * 🔴 HAND-WRITTEN, PINNED TO THE VENDOR'S BYTES. Each builder must produce exactly the data bytes and the
+ * account metas (address, role, order) Kamino's own SDK produces for the same inputs:
+ * `tests/solana-kvault.unit.test.ts` asserts byte equality against `vendor/kamino/instruction-fixtures.json`,
+ * written by Kamino's SDK (`vendor/kamino/generate-fixtures.mjs`, version in `vendor/kamino/PINNED`).
+ *
+ * Nothing here signs or sends. The signer slot is an ADDRESS: the operator's wallet signs.
+ */
+import { type Address, type Instruction } from "@solana/kit";
+/** `sha256("global:<name>")[0..8]`, per instruction. */
+export declare const DISCRIMINATORS: {
+    readonly deposit: readonly [242, 35, 198, 137, 82, 225, 242, 182];
+    readonly withdraw: readonly [183, 18, 70, 156, 148, 109, 161, 34];
+};
+/** Every PDA a vault owns, from its vault-state address alone. */
+export declare function vaultPdas(vaultState: string): Promise<{
+    tokenVault: Address;
+    baseVaultAuthority: Address;
+    sharesMint: Address;
+}>;
+/** The vault's ctoken account for one reserve. */
+export declare const ctokenVaultPda: (vaultState: string, reserve: string) => Promise<Address>;
+export declare const kvaultGlobalConfigPda: () => Promise<Address>;
+/** Anchor's event-CPI authority for the vault program: `deposit` and `withdraw` name it. */
+export declare const kvaultEventAuthorityPda: () => Promise<Address>;
+/** The lending program's authority for one market. */
+export declare const lendingMarketAuthorityPda: (lendingMarket: string) => Promise<Address>;
+/** The owner's associated token account for `mint` (SPL Token). */
+export declare function associatedTokenAccount(owner: string, mint: string): Promise<Address>;
+/** A reserve and its market, as every deposit and withdrawal lists them for the program to refresh. */
+export interface VaultReserve {
+    readonly reserve: string;
+    readonly lendingMarket: string;
+}
+/** What a withdrawal from one reserve needs to know about it (all read on chain). */
+export interface ReserveAccounts extends VaultReserve {
+    readonly liquiditySupplyVault: string;
+    readonly collateralMint: string;
+}
+/** The accounts both depositor instructions share, all derived from or read off the vault. */
+export interface VaultAccounts {
+    readonly vaultState: string;
+    readonly tokenVault: string;
+    readonly tokenMint: string;
+    readonly baseVaultAuthority: string;
+    readonly sharesMint: string;
+    readonly vaultReserves: readonly VaultReserve[];
+}
+/**
+ * `deposit(max_amount)`: the USER's tokens in, shares out to the user's own share account. The program
+ * refreshes every vault reserve first, which is why each reserve and its market follow the fixed accounts.
+ * There is no receiver: the shares can only land in the signer's own account.
+ */
+export declare function depositIx(p: VaultAccounts & {
+    user: string;
+    userTokenAta: string;
+    userSharesAta: string;
+    maxAmount: bigint;
+}): Promise<Instruction>;
+/**
+ * `withdraw(shares_amount)`: the user burns shares for the vault's token, paid from the vault's idle balance
+ * first and then from `reserve`. One reserve per instruction; a withdrawal larger than idle plus what one
+ * reserve can release takes one instruction per reserve. Paid to the signer's own token account only.
+ */
+export declare function withdrawIx(p: VaultAccounts & {
+    user: string;
+    userTokenAta: string;
+    userSharesAta: string;
+    sharesAmount: bigint;
+    reserve: ReserveAccounts;
+}): Promise<Instruction>;
+/**
+ * The Associated Token Account program's `CreateIdempotent` (instruction 1): creates `owner`'s token account for
+ * `mint` if it does not exist, and does nothing if it does. The payer is the owner, who pays its rent (about
+ * 0.002 SOL, returned if the account is ever closed). A first deposit needs it for the share account.
+ */
+export declare function createAtaIdempotentIx(owner: string, mint: string): Promise<Instruction>;
+/**
+ * `SetComputeUnitLimit(units)` (Compute Budget instruction 2, a u32). A deposit or withdrawal refreshes every
+ * vault reserve inside the program, which can exceed the default 200,000 units.
+ */
+export declare function setComputeUnitLimitIx(units: number): Instruction;
+/** A recent blockhash and the block height after which a transaction naming it can no longer land. */
+export interface Lifetime {
+    readonly blockhash: string;
+    readonly lastValidBlockHeight: bigint;
+}
+/**
+ * A legacy transaction, UNSIGNED (every signature slot zero), as base64 wire bytes. The fee payer is the
+ * signer; a wallet adds the signature. It lands only before `lifetime.lastValidBlockHeight`, about a minute
+ * after the blockhash was read.
+ */
+export declare function compileUnsigned(instructions: readonly Instruction[], feePayer: string, lifetime: Lifetime): {
+    base64: string;
+    bytes: number;
+};

package/dist/solana/kvault.js

@@ -0,0 +1,192 @@
+/**
+ * The depositor's side of a Kamino vault: the PDAs a deposit or withdrawal names, the two instructions
+ * (`deposit`, `withdraw`), the token-account instruction a first deposit needs, and an UNSIGNED transaction.
+ *
+ * 🔴 HAND-WRITTEN, PINNED TO THE VENDOR'S BYTES. Each builder must produce exactly the data bytes and the
+ * account metas (address, role, order) Kamino's own SDK produces for the same inputs:
+ * `tests/solana-kvault.unit.test.ts` asserts byte equality against `vendor/kamino/instruction-fixtures.json`,
+ * written by Kamino's SDK (`vendor/kamino/generate-fixtures.mjs`, version in `vendor/kamino/PINNED`).
+ *
+ * Nothing here signs or sends. The signer slot is an ADDRESS: the operator's wallet signs.
+ */
+import { AccountRole, address, appendTransactionMessageInstructions, compileTransaction, createTransactionMessage, getAddressEncoder, getBase64EncodedWireTransaction, getProgramDerivedAddress, pipe, setTransactionMessageFeePayer, setTransactionMessageLifetimeUsingBlockhash, } from "@solana/kit";
+import { ASSOCIATED_TOKEN_PROGRAM_ID, COMPUTE_BUDGET_PROGRAM_ID, KLEND_PROGRAM_ID, KVAULT_PROGRAM_ID, MAX_COMPUTE_UNITS, SEEDS, SPL_TOKEN_PROGRAM_ID, SYSTEM_PROGRAM_ID, SYSVAR_INSTRUCTIONS_ID, } from "./constants.js";
+/** `sha256("global:<name>")[0..8]`, per instruction. */
+export const DISCRIMINATORS = {
+    deposit: [242, 35, 198, 137, 82, 225, 242, 182],
+    withdraw: [183, 18, 70, 156, 148, 109, 161, 34],
+};
+const encoder = getAddressEncoder();
+const utf8 = (s) => new TextEncoder().encode(s);
+const ro = (a) => ({ address: address(a), role: AccountRole.READONLY });
+const rw = (a) => ({ address: address(a), role: AccountRole.WRITABLE });
+const signer = (a, writable) => ({
+    address: address(a),
+    role: writable ? AccountRole.WRITABLE_SIGNER : AccountRole.READONLY_SIGNER,
+});
+function u64le(v) {
+    if (v < 0n || v > 0xffffffffffffffffn)
+        throw new Error(`${v} does not fit a u64`);
+    const b = new Uint8Array(8);
+    new DataView(b.buffer).setBigUint64(0, v, true);
+    return b;
+}
+function concat(...parts) {
+    const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+    let i = 0;
+    for (const p of parts) {
+        out.set(p, i);
+        i += p.length;
+    }
+    return out;
+}
+async function pda(program, seeds) {
+    const [found] = await getProgramDerivedAddress({
+        programAddress: address(program),
+        seeds: seeds.map((s) => (typeof s === "string" ? encoder.encode(address(s)) : utf8(s.text))),
+    });
+    return found;
+}
+/** Every PDA a vault owns, from its vault-state address alone. */
+export async function vaultPdas(vaultState) {
+    const [tokenVault, baseVaultAuthority, sharesMint] = await Promise.all([
+        pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.tokenVault }, vaultState]),
+        pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.baseVaultAuthority }, vaultState]),
+        pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.shares }, vaultState]),
+    ]);
+    return { tokenVault, baseVaultAuthority, sharesMint };
+}
+/** The vault's ctoken account for one reserve. */
+export const ctokenVaultPda = (vaultState, reserve) => pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.ctokenVault }, vaultState, reserve]);
+export const kvaultGlobalConfigPda = () => pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.globalConfig }]);
+/** Anchor's event-CPI authority for the vault program: `deposit` and `withdraw` name it. */
+export const kvaultEventAuthorityPda = () => pda(KVAULT_PROGRAM_ID, [{ text: SEEDS.eventAuthority }]);
+/** The lending program's authority for one market. */
+export const lendingMarketAuthorityPda = (lendingMarket) => pda(KLEND_PROGRAM_ID, [{ text: SEEDS.lendingMarketAuthority }, lendingMarket]);
+/** The owner's associated token account for `mint` (SPL Token). */
+export async function associatedTokenAccount(owner, mint) {
+    const [found] = await getProgramDerivedAddress({
+        programAddress: address(ASSOCIATED_TOKEN_PROGRAM_ID),
+        seeds: [encoder.encode(address(owner)), encoder.encode(address(SPL_TOKEN_PROGRAM_ID)), encoder.encode(address(mint))],
+    });
+    return found;
+}
+/**
+ * `deposit(max_amount)`: the USER's tokens in, shares out to the user's own share account. The program
+ * refreshes every vault reserve first, which is why each reserve and its market follow the fixed accounts.
+ * There is no receiver: the shares can only land in the signer's own account.
+ */
+export async function depositIx(p) {
+    return {
+        programAddress: address(KVAULT_PROGRAM_ID),
+        accounts: [
+            signer(p.user, true),
+            rw(p.vaultState),
+            rw(p.tokenVault),
+            ro(p.tokenMint),
+            ro(p.baseVaultAuthority),
+            rw(p.sharesMint),
+            rw(p.userTokenAta),
+            rw(p.userSharesAta),
+            ro(KLEND_PROGRAM_ID),
+            ro(SPL_TOKEN_PROGRAM_ID),
+            ro(SPL_TOKEN_PROGRAM_ID),
+            ro(await kvaultEventAuthorityPda()),
+            ro(KVAULT_PROGRAM_ID),
+            ...p.vaultReserves.map((r) => rw(r.reserve)),
+            ...p.vaultReserves.map((r) => ro(r.lendingMarket)),
+        ],
+        data: concat(DISCRIMINATORS.deposit, u64le(p.maxAmount)),
+    };
+}
+/**
+ * `withdraw(shares_amount)`: the user burns shares for the vault's token, paid from the vault's idle balance
+ * first and then from `reserve`. One reserve per instruction; a withdrawal larger than idle plus what one
+ * reserve can release takes one instruction per reserve. Paid to the signer's own token account only.
+ */
+export async function withdrawIx(p) {
+    const [ctokenVault, lma, eventAuthority, globalConfig] = await Promise.all([
+        ctokenVaultPda(p.vaultState, p.reserve.reserve),
+        lendingMarketAuthorityPda(p.reserve.lendingMarket),
+        kvaultEventAuthorityPda(),
+        kvaultGlobalConfigPda(),
+    ]);
+    return {
+        programAddress: address(KVAULT_PROGRAM_ID),
+        accounts: [
+            // withdrawFromAvailable
+            signer(p.user, false),
+            rw(p.vaultState),
+            ro(globalConfig),
+            rw(p.tokenVault),
+            ro(p.baseVaultAuthority),
+            rw(p.userTokenAta),
+            rw(p.tokenMint),
+            rw(p.userSharesAta),
+            rw(p.sharesMint),
+            ro(SPL_TOKEN_PROGRAM_ID),
+            ro(SPL_TOKEN_PROGRAM_ID),
+            ro(KLEND_PROGRAM_ID),
+            ro(eventAuthority),
+            ro(KVAULT_PROGRAM_ID),
+            // withdrawFromReserveAccounts
+            rw(p.vaultState),
+            rw(p.reserve.reserve),
+            rw(ctokenVault),
+            ro(p.reserve.lendingMarket),
+            ro(lma),
+            rw(p.reserve.liquiditySupplyVault),
+            rw(p.reserve.collateralMint),
+            ro(SPL_TOKEN_PROGRAM_ID),
+            ro(SYSVAR_INSTRUCTIONS_ID),
+            ro(eventAuthority),
+            ro(KVAULT_PROGRAM_ID),
+            ...p.vaultReserves.map((r) => rw(r.reserve)),
+            ...p.vaultReserves.map((r) => ro(r.lendingMarket)),
+        ],
+        data: concat(DISCRIMINATORS.withdraw, u64le(p.sharesAmount)),
+    };
+}
+/**
+ * The Associated Token Account program's `CreateIdempotent` (instruction 1): creates `owner`'s token account for
+ * `mint` if it does not exist, and does nothing if it does. The payer is the owner, who pays its rent (about
+ * 0.002 SOL, returned if the account is ever closed). A first deposit needs it for the share account.
+ */
+export async function createAtaIdempotentIx(owner, mint) {
+    return {
+        programAddress: address(ASSOCIATED_TOKEN_PROGRAM_ID),
+        accounts: [
+            signer(owner, true),
+            rw(await associatedTokenAccount(owner, mint)),
+            ro(owner),
+            ro(mint),
+            ro(SYSTEM_PROGRAM_ID),
+            ro(SPL_TOKEN_PROGRAM_ID),
+        ],
+        data: Uint8Array.from([1]),
+    };
+}
+/**
+ * `SetComputeUnitLimit(units)` (Compute Budget instruction 2, a u32). A deposit or withdrawal refreshes every
+ * vault reserve inside the program, which can exceed the default 200,000 units.
+ */
+export function setComputeUnitLimitIx(units) {
+    if (!Number.isInteger(units) || units <= 0 || units > MAX_COMPUTE_UNITS) {
+        throw new Error(`compute unit limit must be an integer in (0, ${MAX_COMPUTE_UNITS}], got ${units}`);
+    }
+    const data = new Uint8Array(5);
+    data[0] = 2;
+    new DataView(data.buffer).setUint32(1, units, true);
+    return { programAddress: address(COMPUTE_BUDGET_PROGRAM_ID), data };
+}
+/**
+ * A legacy transaction, UNSIGNED (every signature slot zero), as base64 wire bytes. The fee payer is the
+ * signer; a wallet adds the signature. It lands only before `lifetime.lastValidBlockHeight`, about a minute
+ * after the blockhash was read.
+ */
+export function compileUnsigned(instructions, feePayer, lifetime) {
+    const message = pipe(createTransactionMessage({ version: "legacy" }), (m) => setTransactionMessageFeePayer(address(feePayer), m), (m) => setTransactionMessageLifetimeUsingBlockhash({ blockhash: lifetime.blockhash, lastValidBlockHeight: lifetime.lastValidBlockHeight }, m), (m) => appendTransactionMessageInstructions(instructions, m));
+    const base64 = getBase64EncodedWireTransaction(compileTransaction(message));
+    return { base64, bytes: Buffer.from(base64, "base64").length };
+}
+//# sourceMappingURL=kvault.js.map

package/dist/solana/kvault.js.map

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

package/dist/solana/layout.d.ts

@@ -0,0 +1,143 @@
+/** klend's fixed-point scale: a `*_sf` field is value × 2^60. */
+export declare const SF_ONE: bigint;
+/** `sha256("account:VaultState")[0..8]` — Anchor's account discriminator. */
+export declare const VAULT_STATE_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
+/** `sha256("account:Reserve")[0..8]`. */
+export declare const RESERVE_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
+/** Byte offsets INTO THE ACCOUNT DATA (the 8-byte discriminator included). */
+export declare const VAULT_STATE_OFFSETS: {
+    readonly vaultAdminAuthority: 8;
+    readonly baseVaultAuthority: 40;
+    readonly tokenMint: 80;
+    readonly tokenMintDecimals: 112;
+    readonly tokenVault: 120;
+    readonly tokenProgram: 152;
+    readonly sharesMint: 184;
+    readonly sharesMintDecimals: 216;
+    readonly tokenAvailable: 224;
+    readonly sharesIssued: 232;
+    readonly unallocatedWeight: 248;
+    readonly performanceFeeBps: 256;
+    readonly managementFeeBps: 264;
+    readonly pendingFeesSf: 296;
+    readonly allocations: 312;
+    readonly minInvestAmount: 58424;
+    readonly minInvestDelaySlots: 58432;
+    readonly pendingAdmin: 58448;
+    readonly name: 58528;
+    readonly unallocatedTokensCap: 58640;
+    readonly allocationAdmin: 58648;
+    readonly allowAllocationsInWhitelistedReservesOnly: 58728;
+    readonly allowInvestInWhitelistedReservesOnly: 58729;
+    readonly depositCap: 58736;
+    readonly permissioningAuthority: 58840;
+};
+/** One `VaultAllocation` slot: its size, and each field's offset WITHIN the slot. */
+export declare const ALLOCATION_SLOT: {
+    readonly size: 2160;
+    readonly reserve: 0;
+    readonly ctokenVault: 32;
+    readonly targetAllocationWeight: 64;
+    readonly tokenAllocationCap: 72;
+    readonly ctokenAllocationCap: 88;
+    readonly ctokenAllocation: 1104;
+    readonly lastInvestSlot: 1112;
+};
+export declare const RESERVE_OFFSETS: {
+    readonly lastUpdateSlot: 16;
+    readonly lendingMarket: 32;
+    readonly liquidityMint: 128;
+    readonly liquiditySupplyVault: 160;
+    readonly totalAvailableAmount: 224;
+    readonly borrowedAmountSf: 232;
+    readonly liquidityMintDecimals: 272;
+    readonly accumulatedProtocolFeesSf: 344;
+    readonly accumulatedReferrerFeesSf: 360;
+    readonly pendingReferrerFeesSf: 376;
+    readonly collateralMint: 2560;
+    readonly collateralMintTotalSupply: 2592;
+    readonly depositLimit: 5016;
+};
+export interface VaultAllocation {
+    readonly reserve: string;
+    readonly ctokenVault: string;
+    readonly targetAllocationWeight: bigint;
+    readonly tokenAllocationCap: bigint;
+    readonly ctokenAllocationCap: bigint;
+    readonly ctokenAllocation: bigint;
+    readonly lastInvestSlot: bigint;
+}
+export interface VaultStateView {
+    readonly vaultAdminAuthority: string;
+    readonly baseVaultAuthority: string;
+    readonly tokenMint: string;
+    readonly tokenMintDecimals: bigint;
+    readonly tokenVault: string;
+    readonly tokenProgram: string;
+    readonly sharesMint: string;
+    readonly sharesMintDecimals: bigint;
+    readonly tokenAvailable: bigint;
+    readonly sharesIssued: bigint;
+    readonly unallocatedWeight: bigint;
+    readonly performanceFeeBps: bigint;
+    readonly managementFeeBps: bigint;
+    readonly pendingFeesSf: bigint;
+    /** Occupied slots only, in slot order (an empty slot's reserve is the default key). */
+    readonly allocations: readonly VaultAllocation[];
+    readonly minInvestAmount: bigint;
+    readonly minInvestDelaySlots: bigint;
+    readonly pendingAdmin: string;
+    readonly name: string;
+    readonly unallocatedTokensCap: bigint;
+    readonly allocationAdmin: string;
+    readonly allowAllocationsInWhitelistedReservesOnly: number;
+    readonly allowInvestInWhitelistedReservesOnly: number;
+    readonly depositCap: bigint;
+    readonly permissioningAuthority: string;
+}
+export interface ReserveView {
+    readonly lastUpdateSlot: bigint;
+    readonly lendingMarket: string;
+    readonly liquidityMint: string;
+    readonly liquiditySupplyVault: string;
+    readonly totalAvailableAmount: bigint;
+    readonly borrowedAmountSf: bigint;
+    readonly liquidityMintDecimals: bigint;
+    readonly accumulatedProtocolFeesSf: bigint;
+    readonly accumulatedReferrerFeesSf: bigint;
+    readonly pendingReferrerFeesSf: bigint;
+    readonly collateralMint: string;
+    readonly collateralMintTotalSupply: bigint;
+    readonly depositLimit: bigint;
+}
+export declare function decodeVaultState(data: Uint8Array): VaultStateView;
+export declare function decodeReserve(data: Uint8Array): ReserveView;
+/**
+ * A reserve's total supply in liquidity units, scaled by 2^60: available + borrowed − every fee bucket.
+ * klend-sdk's `Reserve.getTotalSupplySf()`, the numerator of the collateral exchange rate.
+ */
+export declare function totalSupplySf(r: ReserveView): bigint;
+/**
+ * What `ctokens` of this reserve are worth in liquidity base units, at the reserve's STORED state
+ * (floored): ctokens × totalSupply / ctokenSupply. A reserve accrues interest only when refreshed, so this
+ * lags the true value by the interest since `lastUpdateSlot` — conservative, and what klend-sdk's
+ * `getCollateralExchangeRate()` (the "stale" rate) also reports.
+ */
+export declare function ctokensToLiquidity(ctokens: bigint, r: ReserveView): bigint;
+/**
+ * A reserve's share price — liquidity per ctoken — as an 18-decimal fixed-point bigint. `0n` for a reserve
+ * with no ctokens.
+ */
+export declare function reserveSharePrice1e18(r: ReserveView): bigint;
+/** What the vault holds, by reserve and in total: kvault's own AUM rule, at stored reserve state. */
+export interface VaultHoldings {
+    readonly idle: bigint;
+    readonly byReserve: ReadonlyMap<string, bigint>;
+    /** idle + Σ reserves, BEFORE pending fees (klend-sdk's `totalAUMIncludingFees`). */
+    readonly aumIncludingFees: bigint;
+    /** Pending fees, floored to base units. */
+    readonly pendingFees: bigint;
+    /** What the depositors own: AUM − pending fees. */
+    readonly netAum: bigint;
+}
+export declare function vaultHoldings(vault: VaultStateView, reserves: ReadonlyMap<string, ReserveView>): VaultHoldings;