@vultisig/core-chain 2.37.0 → 2.39.0

package/dist/chains/solana/kamino/tx/wire.d.ts

@@ -0,0 +1,107 @@
+import { VersionedTransaction } from '@solana/web3.js';
+/**
+ * Wire-level operations over the v0 transaction Kamino's builder returns:
+ * parsing, the two injections (compute budget in front, attribution memo
+ * behind), and the blockhash replacement that keeps a built transaction
+ * signable after a slow ceremony.
+ *
+ * Injection appends the program as a new static, read-only, unsigned account
+ * key. Static keys are ordered by privilege — writable signers, read-only
+ * signers, writable non-signers, read-only non-signers — so the read-only
+ * unsigned block is the tail, and appending there plus incrementing
+ * `numReadonlyUnsignedAccounts` preserves the ordering without moving any
+ * existing key.
+ *
+ * The one consequence is index drift: indexes at or above the old static
+ * count addressed lookup-table-loaded accounts, which now begin one slot
+ * later, so each is shifted by one. `programIdIndex` values are untouched — a
+ * versioned message may not invoke a program loaded from a lookup table, so
+ * every program is already a static key below the insertion point. The
+ * indexes *inside* each address-table lookup are positions in the table
+ * itself, not in this message, so they are untouched too.
+ */
+/** A failure to parse or edit the wire bytes. */
+export declare class KaminoWireError extends Error {
+    constructor(detail: string);
+}
+/**
+ * Parses the base64 transaction the build endpoints return. `undefined` for
+ * bytes that are not a v0 versioned transaction — a legacy message invoking
+ * the kVaults program must be surfaced as unreadable, never edited or
+ * described.
+ */
+export declare const parseKaminoWireTransaction: (base64Transaction: string) => VersionedTransaction | undefined;
+/** Serializes back to the base64 form the keysign payload carries. */
+export declare const serializeKaminoWireTransaction: (transaction: VersionedTransaction) => string;
+/**
+ * Whether this is the shape the app is willing to sign: one required
+ * signature, no read-only signers, every signature slot still an empty
+ * placeholder, and — when `feePayer` is given — that account in slot 0.
+ */
+export declare const isUnsignedSingleSigner: (transaction: VersionedTransaction, feePayer?: string) => boolean;
+/** The number of accounts the message addresses, static and lookup-loaded. */
+export declare const totalKaminoAccountCount: (transaction: VersionedTransaction) => number;
+/**
+ * Every account the message addresses, in runtime index order: static keys,
+ * then every table's writable loads, then every table's read-only loads.
+ * `undefined` when a table is missing from `lookupTables` or an index falls
+ * outside it — resolution either accounts for every index or fails whole.
+ */
+export declare const resolveKaminoAccountAddresses: ({ transaction, lookupTables, }: {
+    transaction: VersionedTransaction;
+    /** Table address to that table's full address list. */
+    lookupTables: Record<string, string[]>;
+}) => string[] | undefined;
+/**
+ * Whether the account at a runtime index may be written to, from the header
+ * privileges (static region) or the lookup section it was loaded through.
+ */
+export declare const isKaminoAccountWritable: ({ transaction, index, }: {
+    transaction: VersionedTransaction;
+    index: number;
+}) => boolean;
+/**
+ * The contents of every lookup table the transaction reads from, via RPC.
+ *
+ * Every failure surfaces as `KaminoWireError` — a missing table, a stalled
+ * node past the deadline, or a transport error — so callers see one rejection
+ * type from resolution rather than raw RPC errors.
+ */
+export declare const resolveKaminoLookupTables: (transaction: VersionedTransaction) => Promise<Record<string, string[]>>;
+/**
+ * Injects the app's ComputeBudget pair in front of the existing instructions.
+ *
+ * Kamino's builder emits no ComputeBudget instruction, so a transaction that
+ * already carries the program — as a key or as an instruction — is not one
+ * this app built the fee for, and appending a second pair would double-charge
+ * rather than repair it.
+ */
+export declare const injectKaminoComputeBudget: ({ transaction, unitLimit, unitPriceMicroLamports, }: {
+    transaction: VersionedTransaction;
+    unitLimit: number;
+    unitPriceMicroLamports: bigint;
+}) => VersionedTransaction;
+/**
+ * Appends the attribution memo behind every existing instruction: one SPL
+ * Memo instruction carrying exactly the tag, no accounts.
+ *
+ * The key and the instruction are two ways for a memo to already be here, and
+ * appending a second one would both duplicate the account and leave the
+ * transaction carrying two attributions — so either form is a refusal.
+ */
+export declare const injectKaminoAttributionMemo: (transaction: VersionedTransaction) => VersionedTransaction;
+/**
+ * The same transaction over a new recent blockhash.
+ *
+ * The build endpoints embed a blockhash worth ~60–90 seconds, and an MPC
+ * ceremony can outlive it — so the blockhash is replaced immediately before
+ * keysign rather than trusted to survive the wait. Nothing else in the
+ * message changes.
+ */
+export declare const withKaminoRecentBlockhash: ({ transaction, recentBlockhash, }: {
+    transaction: VersionedTransaction;
+    recentBlockhash: string;
+}) => VersionedTransaction;
+/** Fetches the current blockhash and stamps it onto the transaction. */
+export declare const refreshKaminoRecentBlockhash: (transaction: VersionedTransaction) => Promise<VersionedTransaction>;
+//# sourceMappingURL=wire.d.ts.map

package/dist/chains/solana/kamino/tx/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/solana/kamino/tx/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAK5E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,MAAM,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,mBAAmB,MAAM,KAAG,oBAAoB,GAAG,SAO7F,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,GAAI,aAAa,oBAAoB,KAAG,MAC1B,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,aAAa,oBAAoB,EAAE,WAAW,MAAM,KAAG,OAO7F,CAAA;AAED,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,GAAI,aAAa,oBAAoB,KAAG,MAKzE,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GAAI,gCAG3C;IACD,WAAW,EAAE,oBAAoB,CAAA;IACjC,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC,KAAG,MAAM,EAAE,GAAG,SAuBd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,yBAGrC;IACD,WAAW,EAAE,oBAAoB,CAAA;IACjC,KAAK,EAAE,MAAM,CAAA;CACd,KAAG,OAaH,CAAA;AAUD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,aAAa,oBAAoB,KAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA6BlC,CAAA;AAkED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,qDAIvC;IACD,WAAW,EAAE,oBAAoB,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB,EAAE,MAAM,CAAA;CAC/B,KAAG,oBAsBH,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GAAI,aAAa,oBAAoB,KAAG,oBAiB/E,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,mCAGvC;IACD,WAAW,EAAE,oBAAoB,CAAA;IACjC,eAAe,EAAE,MAAM,CAAA;CACxB,KAAG,oBAWH,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,GACvC,aAAa,oBAAoB,KAChC,OAAO,CAAC,oBAAoB,CAG9B,CAAA"}

package/dist/chains/solana/kamino/tx/wire.js

@@ -0,0 +1,274 @@
+import { MessageV0, PublicKey, VersionedTransaction } from '@solana/web3.js';
+import { getSolanaClient } from '../../client.js';
+import { computeBudgetDiscriminators, kaminoAllowedPrograms, kaminoAttributionMemoTagBytes } from './instructions.js';
+/**
+ * Wire-level operations over the v0 transaction Kamino's builder returns:
+ * parsing, the two injections (compute budget in front, attribution memo
+ * behind), and the blockhash replacement that keeps a built transaction
+ * signable after a slow ceremony.
+ *
+ * Injection appends the program as a new static, read-only, unsigned account
+ * key. Static keys are ordered by privilege — writable signers, read-only
+ * signers, writable non-signers, read-only non-signers — so the read-only
+ * unsigned block is the tail, and appending there plus incrementing
+ * `numReadonlyUnsignedAccounts` preserves the ordering without moving any
+ * existing key.
+ *
+ * The one consequence is index drift: indexes at or above the old static
+ * count addressed lookup-table-loaded accounts, which now begin one slot
+ * later, so each is shifted by one. `programIdIndex` values are untouched — a
+ * versioned message may not invoke a program loaded from a lookup table, so
+ * every program is already a static key below the insertion point. The
+ * indexes *inside* each address-table lookup are positions in the table
+ * itself, not in this message, so they are untouched too.
+ */
+/** A failure to parse or edit the wire bytes. */
+export class KaminoWireError extends Error {
+    constructor(detail) {
+        super(`Kamino wire transaction: ${detail}`);
+        this.name = 'KaminoWireError';
+    }
+}
+/**
+ * Parses the base64 transaction the build endpoints return. `undefined` for
+ * bytes that are not a v0 versioned transaction — a legacy message invoking
+ * the kVaults program must be surfaced as unreadable, never edited or
+ * described.
+ */
+export const parseKaminoWireTransaction = (base64Transaction) => {
+    try {
+        const transaction = VersionedTransaction.deserialize(Buffer.from(base64Transaction, 'base64'));
+        return transaction.version === 0 ? transaction : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Serializes back to the base64 form the keysign payload carries. */
+export const serializeKaminoWireTransaction = (transaction) => Buffer.from(transaction.serialize()).toString('base64');
+/**
+ * Whether this is the shape the app is willing to sign: one required
+ * signature, no read-only signers, every signature slot still an empty
+ * placeholder, and — when `feePayer` is given — that account in slot 0.
+ */
+export const isUnsignedSingleSigner = (transaction, feePayer) => {
+    const { header, staticAccountKeys } = transaction.message;
+    if (header.numRequiredSignatures !== 1 || header.numReadonlySignedAccounts !== 0)
+        return false;
+    if (transaction.signatures.length !== 1)
+        return false;
+    if (transaction.signatures.some(signature => signature.some(byte => byte !== 0)))
+        return false;
+    if (feePayer !== undefined && staticAccountKeys[0]?.toBase58() !== feePayer)
+        return false;
+    return true;
+};
+/** The number of accounts the message addresses, static and lookup-loaded. */
+export const totalKaminoAccountCount = (transaction) => transaction.message.staticAccountKeys.length +
+    transaction.message.addressTableLookups.reduce((count, lookup) => count + lookup.writableIndexes.length + lookup.readonlyIndexes.length, 0);
+/**
+ * Every account the message addresses, in runtime index order: static keys,
+ * then every table's writable loads, then every table's read-only loads.
+ * `undefined` when a table is missing from `lookupTables` or an index falls
+ * outside it — resolution either accounts for every index or fails whole.
+ */
+export const resolveKaminoAccountAddresses = ({ transaction, lookupTables, }) => {
+    const resolved = transaction.message.staticAccountKeys.map(key => key.toBase58());
+    const load = (tableAddress, indexes) => {
+        const table = lookupTables[tableAddress];
+        if (!table)
+            return undefined;
+        const addresses = [];
+        for (const index of indexes) {
+            const address = table[index];
+            if (address === undefined)
+                return undefined;
+            addresses.push(address);
+        }
+        return addresses;
+    };
+    for (const kind of ['writableIndexes', 'readonlyIndexes']) {
+        for (const lookup of transaction.message.addressTableLookups) {
+            const addresses = load(lookup.accountKey.toBase58(), lookup[kind]);
+            if (!addresses)
+                return undefined;
+            resolved.push(...addresses);
+        }
+    }
+    return resolved;
+};
+/**
+ * Whether the account at a runtime index may be written to, from the header
+ * privileges (static region) or the lookup section it was loaded through.
+ */
+export const isKaminoAccountWritable = ({ transaction, index, }) => {
+    const { header, staticAccountKeys, addressTableLookups } = transaction.message;
+    const staticCount = staticAccountKeys.length;
+    if (index < staticCount) {
+        const writableSigners = header.numRequiredSignatures - header.numReadonlySignedAccounts;
+        if (index < writableSigners)
+            return true;
+        if (index < header.numRequiredSignatures)
+            return false;
+        return index < staticCount - header.numReadonlyUnsignedAccounts;
+    }
+    const writableLoads = addressTableLookups.reduce((count, lookup) => count + lookup.writableIndexes.length, 0);
+    return index < staticCount + writableLoads;
+};
+/**
+ * Deadline for one lookup-table read. This sits on the signing critical path
+ * and the RPC client itself carries no timeout, so an unbounded call would
+ * let a stalled node wedge the prepare indefinitely. Matches the HTTP layer's
+ * default deadline — comfortably above a healthy read, still bounding a hang.
+ */
+const lookupTableReadTimeoutMs = 20_000;
+/**
+ * The contents of every lookup table the transaction reads from, via RPC.
+ *
+ * Every failure surfaces as `KaminoWireError` — a missing table, a stalled
+ * node past the deadline, or a transport error — so callers see one rejection
+ * type from resolution rather than raw RPC errors.
+ */
+export const resolveKaminoLookupTables = async (transaction) => {
+    const client = getSolanaClient();
+    const tables = {};
+    for (const lookup of transaction.message.addressTableLookups) {
+        const address = lookup.accountKey.toBase58();
+        if (tables[address])
+            continue;
+        let timeoutId;
+        const deadline = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => reject(new KaminoWireError(`address lookup table ${address} read timed out after ${lookupTableReadTimeoutMs}ms`)), lookupTableReadTimeoutMs);
+        });
+        try {
+            const table = await Promise.race([client.getAddressLookupTable(lookup.accountKey), deadline]);
+            if (!table.value)
+                throw new KaminoWireError(`address lookup table ${address} not found`);
+            tables[address] = table.value.state.addresses.map(key => key.toBase58());
+        }
+        catch (error) {
+            if (error instanceof KaminoWireError)
+                throw error;
+            throw new KaminoWireError(`address lookup table ${address} could not be read: ${extractErrorMessage(error)}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    return tables;
+};
+const extractErrorMessage = (error) => (error instanceof Error ? error.message : String(error));
+/**
+ * Appends `programKey` as a new static, read-only, unsigned account key and
+ * rebuilds the message with `leading` instructions in front of the existing
+ * ones and `trailing` behind them. Both callbacks receive the index the new
+ * key lands at. See the module doc for why lookup-region indexes shift.
+ */
+const injectProgram = (transaction, programKey, leading, trailing) => {
+    const message = transaction.message;
+    const staticCount = message.staticAccountKeys.length;
+    const shift = (index) => (index >= staticCount ? index + 1 : index);
+    const shifted = message.compiledInstructions.map(instruction => ({
+        programIdIndex: instruction.programIdIndex,
+        accountKeyIndexes: instruction.accountKeyIndexes.map(shift),
+        data: instruction.data,
+    }));
+    const injected = new MessageV0({
+        header: {
+            numRequiredSignatures: message.header.numRequiredSignatures,
+            numReadonlySignedAccounts: message.header.numReadonlySignedAccounts,
+            numReadonlyUnsignedAccounts: message.header.numReadonlyUnsignedAccounts + 1,
+        },
+        staticAccountKeys: [...message.staticAccountKeys, new PublicKey(programKey)],
+        recentBlockhash: message.recentBlockhash,
+        compiledInstructions: [...leading(staticCount), ...shifted, ...trailing(staticCount)],
+        addressTableLookups: message.addressTableLookups,
+    });
+    return new VersionedTransaction(injected);
+};
+const invokesProgram = (transaction, programKey) => {
+    const keys = transaction.message.staticAccountKeys.map(key => key.toBase58());
+    return transaction.message.compiledInstructions.some(instruction => keys[instruction.programIdIndex] === programKey);
+};
+const hasStaticKey = (transaction, key) => transaction.message.staticAccountKeys.some(existing => existing.toBase58() === key);
+const u32LittleEndian = (value) => {
+    const bytes = new Uint8Array(4);
+    new DataView(bytes.buffer).setUint32(0, value, true);
+    return bytes;
+};
+const u64LittleEndian = (value) => {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setBigUint64(0, value, true);
+    return bytes;
+};
+/**
+ * Injects the app's ComputeBudget pair in front of the existing instructions.
+ *
+ * Kamino's builder emits no ComputeBudget instruction, so a transaction that
+ * already carries the program — as a key or as an instruction — is not one
+ * this app built the fee for, and appending a second pair would double-charge
+ * rather than repair it.
+ */
+export const injectKaminoComputeBudget = ({ transaction, unitLimit, unitPriceMicroLamports, }) => {
+    const program = kaminoAllowedPrograms.computeBudget;
+    if (hasStaticKey(transaction, program) || invokesProgram(transaction, program)) {
+        throw new KaminoWireError('compute budget already present');
+    }
+    return injectProgram(transaction, program, programIdIndex => [
+        {
+            programIdIndex,
+            accountKeyIndexes: [],
+            data: Uint8Array.from([computeBudgetDiscriminators.setUnitLimit, ...u32LittleEndian(unitLimit)]),
+        },
+        {
+            programIdIndex,
+            accountKeyIndexes: [],
+            data: Uint8Array.from([computeBudgetDiscriminators.setUnitPrice, ...u64LittleEndian(unitPriceMicroLamports)]),
+        },
+    ], () => []);
+};
+/**
+ * Appends the attribution memo behind every existing instruction: one SPL
+ * Memo instruction carrying exactly the tag, no accounts.
+ *
+ * The key and the instruction are two ways for a memo to already be here, and
+ * appending a second one would both duplicate the account and leave the
+ * transaction carrying two attributions — so either form is a refusal.
+ */
+export const injectKaminoAttributionMemo = (transaction) => {
+    const program = kaminoAllowedPrograms.memo;
+    if (hasStaticKey(transaction, program) || invokesProgram(transaction, program)) {
+        throw new KaminoWireError('attribution memo already present');
+    }
+    return injectProgram(transaction, program, () => [], programIdIndex => [
+        {
+            programIdIndex,
+            accountKeyIndexes: [],
+            data: kaminoAttributionMemoTagBytes,
+        },
+    ]);
+};
+/**
+ * The same transaction over a new recent blockhash.
+ *
+ * The build endpoints embed a blockhash worth ~60–90 seconds, and an MPC
+ * ceremony can outlive it — so the blockhash is replaced immediately before
+ * keysign rather than trusted to survive the wait. Nothing else in the
+ * message changes.
+ */
+export const withKaminoRecentBlockhash = ({ transaction, recentBlockhash, }) => {
+    const message = transaction.message;
+    return new VersionedTransaction(new MessageV0({
+        header: message.header,
+        staticAccountKeys: message.staticAccountKeys,
+        recentBlockhash,
+        compiledInstructions: message.compiledInstructions,
+        addressTableLookups: message.addressTableLookups,
+    }));
+};
+/** Fetches the current blockhash and stamps it onto the transaction. */
+export const refreshKaminoRecentBlockhash = async (transaction) => {
+    const { blockhash } = await getSolanaClient().getLatestBlockhash();
+    return withKaminoRecentBlockhash({ transaction, recentBlockhash: blockhash });
+};
+//# sourceMappingURL=wire.js.map

package/dist/chains/solana/kamino/tx/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../../../../../../packages/core/chain/chains/solana/kamino/tx/wire.ts"],"names":[],"mappings":"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"}

package/dist/chains/solana/kamino/vaultInfo.d.ts

@@ -0,0 +1,17 @@
+import { KaminoVaultInfo } from './models.js';
+/**
+ * Hydrates a curated vault with live state and metrics.
+ *
+ * Takes an address and resolves the descriptor from the registry itself, so
+ * descriptor-shaped data from anywhere else can never decide a vault's
+ * identity; an address the registry does not carry is refused. The response's
+ * account of the vault is then checked against the pinned identity, every
+ * numeric field is parsed under the strict decimal rules (a value that fails
+ * throws rather than defaulting to zero), and the published minimums are
+ * replaced by the effective ones the program actually accepts.
+ *
+ * Uncached — client layers own caching (and their caches then hold only
+ * hydrations that cleared every check here).
+ */
+export declare const fetchKaminoVaultInfo: (vaultAddress: string) => Promise<KaminoVaultInfo>;
+//# sourceMappingURL=vaultInfo.d.ts.map

package/dist/chains/solana/kamino/vaultInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaultInfo.d.ts","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/kamino/vaultInfo.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAA4B,MAAM,UAAU,CAAA;AA6EpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAU,cAAc,MAAM,KAAG,OAAO,CAAC,eAAe,CAmExF,CAAA"}

package/dist/chains/solana/kamino/vaultInfo.js

@@ -0,0 +1,150 @@
+import { isValidKaminoRequestAmount, kaminoTokenAmount, kaminoTokenAmountFromBaseUnitString, kaminoTokenAmountFromDecimalString, kaminoTokenToShareAmountRoundedUp, } from './amount.js';
+import { fetchKaminoVaultMetrics, fetchKaminoVaultState } from './api.js';
+import { parseKaminoDisplayDecimal } from './decimal.js';
+import { KaminoServiceError } from './KaminoServiceError.js';
+import { isPositiveKaminoRate, parseKaminoRate } from './rate.js';
+import { getKaminoVaultDescriptor } from './registry.js';
+/**
+ * A margin of one part in this many — a tenth of a percent — added to the
+ * published minimum deposit.
+ */
+const minimumDepositMarginDivisor = 1000n;
+/**
+ * Smallest deposit margin in base units, for a minimum too small for the
+ * proportional one to clear a rounding loss. Larger than either measured
+ * shortfall (8 and 10 base units on the launch vaults).
+ */
+const minimumDepositMarginFloor = 16n;
+/**
+ * Multiple of the published minimum a withdraw's token value must reach.
+ *
+ * The floor measured on-chain sits just above two; the third is margin,
+ * because the rule is a reading of observed behaviour rather than a documented
+ * contract.
+ */
+const minimumWithdrawMultiple = 3n;
+/** The Solana default/system address doubles as "no farm attached". */
+const systemProgramAddress = '11111111111111111111111111111111';
+/**
+ * The smallest deposit a form may offer.
+ *
+ * The published `minDepositAmount` is in the right unit — unlike its withdraw
+ * counterpart — but the program still refuses a deposit *at* it, with
+ * `DepositAmountBelowMinimum`. Measured at one base unit of resolution the
+ * shortfall is a handful of base units and moves with the share rate — a
+ * rounding loss in the share the deposit mints, not a second threshold. The
+ * margin is therefore proportional with an absolute floor, both generous
+ * against what was measured and both invisible in money.
+ */
+const effectiveMinimumDeposit = (published) => {
+    const proportional = (published.baseUnits + minimumDepositMarginDivisor - 1n) / minimumDepositMarginDivisor;
+    const margin = proportional > minimumDepositMarginFloor ? proportional : minimumDepositMarginFloor;
+    return kaminoTokenAmount(published.baseUnits + margin, published.decimals);
+};
+const malformed = (field, value) => new KaminoServiceError({ malformedNumber: { field, value } });
+const assertFieldMatchesRegistry = (field, actual, expected) => {
+    if (actual !== expected) {
+        throw new KaminoServiceError({ vaultMetadataMismatch: { field, expected, actual } });
+    }
+};
+/**
+ * Refuses a response whose account of the vault differs from the registry's.
+ *
+ * The mints, their decimals and the farm are immutable properties of a kVault,
+ * so this can never fire on a legitimate change. It exists because those
+ * values decide where funds go and how amounts are scaled: taking them from
+ * the API would mean validating a transaction the API built against values the
+ * same API supplied, and the pair could be made consistent. Checking here
+ * means the whole feature works from a vault identity the app already knew.
+ */
+const assertMatchesRegistry = (state, descriptor) => {
+    assertFieldMatchesRegistry('tokenMint', state.tokenMint, descriptor.tokenMint);
+    assertFieldMatchesRegistry('sharesMint', state.sharesMint, descriptor.sharesMint);
+    assertFieldMatchesRegistry('tokenMintDecimals', String(state.tokenMintDecimals), String(descriptor.tokenDecimals));
+    assertFieldMatchesRegistry('sharesMintDecimals', String(state.sharesMintDecimals), String(descriptor.sharesDecimals));
+    assertFieldMatchesRegistry('vaultFarm', normalizeFarm(state.vaultFarm) ?? '', descriptor.farm ?? '');
+};
+const normalizeFarm = (address) => {
+    if (!address || address === systemProgramAddress)
+        return undefined;
+    return address;
+};
+/**
+ * Hydrates a curated vault with live state and metrics.
+ *
+ * Takes an address and resolves the descriptor from the registry itself, so
+ * descriptor-shaped data from anywhere else can never decide a vault's
+ * identity; an address the registry does not carry is refused. The response's
+ * account of the vault is then checked against the pinned identity, every
+ * numeric field is parsed under the strict decimal rules (a value that fails
+ * throws rather than defaulting to zero), and the published minimums are
+ * replaced by the effective ones the program actually accepts.
+ *
+ * Uncached — client layers own caching (and their caches then hold only
+ * hydrations that cleared every check here).
+ */
+export const fetchKaminoVaultInfo = async (vaultAddress) => {
+    const descriptor = getKaminoVaultDescriptor(vaultAddress);
+    if (!descriptor) {
+        throw new KaminoServiceError({ vaultNotInRegistry: vaultAddress });
+    }
+    const [{ state }, metrics] = await Promise.all([
+        fetchKaminoVaultState(descriptor.address),
+        fetchKaminoVaultMetrics(descriptor.address),
+    ]);
+    assertMatchesRegistry(state, descriptor);
+    // The published figures are numbers a remote service hands us, and they end
+    // up bounding what a user may spend. A non-positive or absurd one is refused
+    // rather than propagated into a minimum nothing can satisfy.
+    const publishedMinDeposit = kaminoTokenAmountFromBaseUnitString(state.minDepositAmount, descriptor.tokenDecimals);
+    if (!publishedMinDeposit)
+        throw malformed('minDepositAmount', state.minDepositAmount);
+    const minDeposit = effectiveMinimumDeposit(publishedMinDeposit);
+    if (!isValidKaminoRequestAmount(publishedMinDeposit) || !isValidKaminoRequestAmount(minDeposit)) {
+        throw malformed('minDepositAmount', state.minDepositAmount);
+    }
+    // TOKEN base units, despite the field naming the unit the withdraw endpoint
+    // takes. The two scales differ on the SOL vault (9 vs 6), so reading it
+    // wrong is silent there and a ~930× error — see `models.ts`.
+    const publishedMinWithdraw = kaminoTokenAmountFromBaseUnitString(state.minWithdrawAmount, descriptor.tokenDecimals);
+    if (!publishedMinWithdraw)
+        throw malformed('minWithdrawAmount', state.minWithdrawAmount);
+    const apy30d = parseKaminoDisplayDecimal(metrics.apy30d);
+    if (apy30d === undefined)
+        throw malformed('apy30d', metrics.apy30d);
+    const tokenPriceUsd = parseKaminoDisplayDecimal(metrics.tokenPrice);
+    if (tokenPriceUsd === undefined)
+        throw malformed('tokenPrice', metrics.tokenPrice);
+    // Parsed exactly rather than as a display decimal: this rate converts a
+    // user's token amount into the shares a withdraw burns.
+    const tokensPerShare = parseKaminoRate(metrics.tokensPerShare);
+    if (!tokensPerShare || !isPositiveKaminoRate(tokensPerShare)) {
+        throw malformed('tokensPerShare', metrics.tokensPerShare);
+    }
+    // The program's own withdraw floor is higher than the published figure, so
+    // the form minimum is a multiple of it, converted to the share count a
+    // withdraw has to name — rounded up, because a share count worth
+    // fractionally less than the minimum is exactly the failure being avoided.
+    const minWithdraw = kaminoTokenToShareAmountRoundedUp({
+        tokens: kaminoTokenAmount(publishedMinWithdraw.baseUnits * minimumWithdrawMultiple, publishedMinWithdraw.decimals),
+        tokensPerShare,
+        shareDecimals: descriptor.sharesDecimals,
+    });
+    if (!minWithdraw || !isValidKaminoRequestAmount(publishedMinWithdraw) || !isValidKaminoRequestAmount(minWithdraw)) {
+        throw malformed('minWithdrawAmount', state.minWithdrawAmount);
+    }
+    return {
+        descriptor,
+        name: state.name,
+        minDeposit,
+        minWithdraw,
+        lookupTable: state.vaultLookupTable,
+        apy30d,
+        tokensPerShare,
+        tokenPriceUsd,
+        // Advisory, so an unreadable value drops the liquidity notice rather than
+        // failing the whole hydration and blocking deposits too.
+        tokensAvailable: kaminoTokenAmountFromDecimalString(metrics.tokensAvailable, descriptor.tokenDecimals),
+    };
+};
+//# sourceMappingURL=vaultInfo.js.map

package/dist/chains/solana/kamino/vaultInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaultInfo.js","sourceRoot":"","sources":["../../../../../../../packages/core/chain/chains/solana/kamino/vaultInfo.ts"],"names":[],"mappings":"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"}