@hobba-io/core 0.1.0

package/dist/transactionBuilder.js

@@ -0,0 +1,287 @@
+import { Transaction, TransactionMessage, VersionedTransaction, ComputeBudgetProgram, } from "@solana/web3.js";
+import { isTickError } from "./juplend/tickUtils";
+/** Poll-based confirmation — avoids WebSocket dependency */
+async function pollConfirmation(connection, signature, lastValidBlockHeight, timeoutMs = 60000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const { value } = await connection.getSignatureStatuses([signature]);
+            const status = value[0];
+            if (status) {
+                if (status.err)
+                    throw new Error(`Transaction failed: ${JSON.stringify(status.err)}`);
+                if (status.confirmationStatus === "confirmed" || status.confirmationStatus === "finalized")
+                    return;
+            }
+        }
+        catch (e) {
+            // Ignore RPC errors (429 etc.) and keep polling
+            console.warn("[pollConfirmation] RPC error, retrying:", e.message?.slice(0, 80));
+        }
+        await new Promise((r) => setTimeout(r, 2000));
+    }
+    throw new Error(`Transaction not confirmed within ${timeoutMs / 1000}s. Check: https://solscan.io/tx/${signature}`);
+}
+export async function sendLegacyTx(connection, instructions, wallet, computeUnits) {
+    if (!wallet.publicKey || !wallet.signTransaction) {
+        throw new Error("Wallet not connected");
+    }
+    const tx = new Transaction();
+    if (computeUnits) {
+        tx.add(ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits }));
+    }
+    tx.add(ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 100000 }));
+    for (const ix of instructions) {
+        tx.add(ix);
+    }
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+    tx.recentBlockhash = blockhash;
+    tx.feePayer = wallet.publicKey;
+    const signed = await wallet.signTransaction(tx);
+    const sig = await connection.sendRawTransaction(signed.serialize(), {
+        skipPreflight: false,
+    });
+    await pollConfirmation(connection, sig, lastValidBlockHeight);
+    return sig;
+}
+export async function sendVersionedTx(connection, instructions, wallet, lutAddresses, computeUnits, skipSimulation, 
+// If supplied, called when pre-sign simulation fails with a JupLend tick error
+// (VaultInvalidTick / VaultTickMismatch / VaultTickHasDebtNotFound). Should return
+// a fresh instruction list (typically by re-fetching the SDK operate context) or
+// null to surface the original error.
+rebuildOnTickError) {
+    if (!wallet.publicKey || !wallet.signTransaction) {
+        throw new Error("Wallet not connected");
+    }
+    const budgetIxs = [
+        ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 100000 }),
+        ...(computeUnits ? [ComputeBudgetProgram.setComputeUnitLimit({ units: computeUnits })] : []),
+    ];
+    const allInstructions = [...budgetIxs, ...instructions];
+    // Load lookup tables
+    const lookupTables = [];
+    for (const lutAddress of lutAddresses) {
+        try {
+            const lutAccount = await connection.getAddressLookupTable(lutAddress);
+            if (lutAccount.value) {
+                lookupTables.push(lutAccount.value);
+            }
+            else {
+                console.warn(`[tx] LUT ${lutAddress.toBase58()} returned null (not found on RPC)`);
+            }
+        }
+        catch (e) {
+            console.warn(`[tx] LUT ${lutAddress.toBase58()} fetch failed: ${e?.message || e}`);
+        }
+    }
+    if (lookupTables.length === 0 && lutAddresses.length > 0) {
+        throw new Error("LUT not found or not yet activated");
+    }
+    const INIT_TICK_DISC = "160d3e8d4959b21d";
+    const INIT_TICK_ID_LIQ_DISC = "386e79a998f156b7";
+    const JUPLEND_PROGRAM = "jupr81YtYssSyPt8jbnGuiWon5f6x9TcDEFxYe3Bdzi";
+    const MAX_TX_SIZE = 1232;
+    const isInitTickIx = (ix) => {
+        if (ix.programId.toBase58() !== JUPLEND_PROGRAM)
+            return false;
+        const disc = Buffer.from(ix.data).subarray(0, 8).toString("hex");
+        return disc === INIT_TICK_DISC || disc === INIT_TICK_ID_LIQ_DISC;
+    };
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+    let finalInstructions = allInstructions;
+    const tryBuild = (ixs) => {
+        try {
+            const msg = new TransactionMessage({
+                payerKey: wallet.publicKey,
+                recentBlockhash: blockhash,
+                instructions: ixs,
+            }).compileToV0Message(lookupTables);
+            const tx = new VersionedTransaction(msg);
+            const size = tx.serialize().length;
+            return { tx, size };
+        }
+        catch (e) {
+            if (String(e?.message || e).includes("overruns Uint8Array"))
+                return null;
+            throw e;
+        }
+    };
+    let built = tryBuild(finalInstructions);
+    // If TX doesn't fit (build threw or over MAX_TX_SIZE), strip InitTick/InitTickIdLiq (retry path re-adds if simulation says missing)
+    if (!built || built.size > MAX_TX_SIZE) {
+        const stripped = finalInstructions.filter(ix => !isInitTickIx(ix));
+        if (stripped.length < finalInstructions.length) {
+            console.log(`[tx] TX too large (${built?.size ?? "overflow"}), stripping ${finalInstructions.length - stripped.length} InitTick instructions`);
+            finalInstructions = stripped;
+            built = tryBuild(finalInstructions);
+        }
+    }
+    if (!built) {
+        throw new Error(`Transaction too large even after stripping InitTick. Try splitting deposit/borrow or contact support.`);
+    }
+    const versionedTx = built.tx;
+    // Pre-simulate to catch errors before opening wallet popup
+    let txToSign = versionedTx;
+    if (skipSimulation) {
+        const signed = await wallet.signTransaction(versionedTx);
+        const sig = await connection.sendRawTransaction(signed.serialize(), { skipPreflight: true });
+        await pollConfirmation(connection, sig, lastValidBlockHeight);
+        return sig;
+    }
+    const simResult = await connection.simulateTransaction(versionedTx, {
+        sigVerify: false,
+        replaceRecentBlockhash: true,
+    });
+    if (simResult.value.err) {
+        if (simResult.value.logs) {
+            console.log("[simulation] Full logs:");
+            simResult.value.logs.forEach((l, i) => console.log(`  ${i}: ${l}`));
+        }
+        const logs = simResult.value.logs || [];
+        const logBlob = logs.join("\n");
+        // JupLend tick race: SDK-computed tick PDAs no longer match on-chain state.
+        // Recover by re-fetching the SDK operate context and rebuilding the ix list,
+        // then re-simulating with fresh ticks. Single wallet popup at the end.
+        // Retry up to 3 times — vault state can shift again between SDK refetch and
+        // the rebuilt simulation, especially for withdraw paths that touch tick_has_debt arrays.
+        let tickRebuildSucceeded = false;
+        if (rebuildOnTickError && isTickError(logBlob)) {
+            const MAX_REBUILD_ATTEMPTS = 3;
+            let lastErrJson = "";
+            let lastLogs = "";
+            for (let attempt = 0; attempt < MAX_REBUILD_ATTEMPTS && !tickRebuildSucceeded; attempt++) {
+                console.log(`[simulation] JupLend tick error — rebuilding from fresh SDK context (attempt ${attempt + 1}/${MAX_REBUILD_ATTEMPTS})`);
+                const rebuilt = await rebuildOnTickError();
+                if (!rebuilt)
+                    break;
+                let rebuiltIxs = [...budgetIxs, ...rebuilt];
+                // Strip any init-tick ixs that won't fit; the SDK already filters missing ones
+                let candidate = tryBuild(rebuiltIxs);
+                if (!candidate || candidate.size > MAX_TX_SIZE) {
+                    const stripped = rebuiltIxs.filter(ix => !isInitTickIx(ix));
+                    candidate = tryBuild(stripped);
+                    if (candidate)
+                        rebuiltIxs = stripped;
+                }
+                if (!candidate)
+                    break;
+                const retrySim = await connection.simulateTransaction(candidate.tx, {
+                    sigVerify: false,
+                    replaceRecentBlockhash: true,
+                });
+                if (!retrySim.value.err) {
+                    finalInstructions = rebuiltIxs;
+                    txToSign = candidate.tx;
+                    tickRebuildSucceeded = true;
+                    break;
+                }
+                lastErrJson = JSON.stringify(retrySim.value.err);
+                lastLogs = retrySim.value.logs?.slice(-10).join("\n") || "";
+                const retryBlob = (retrySim.value.logs || []).join("\n");
+                // If the new error isn't a tick error, no point retrying
+                if (!isTickError(retryBlob)) {
+                    throw new Error(`Simulation failed after tick rebuild: ${lastErrJson}\n${lastLogs}`);
+                }
+            }
+            if (!tickRebuildSucceeded) {
+                throw new Error(`Simulation failed after ${MAX_REBUILD_ATTEMPTS} tick rebuild attempts: ${lastErrJson}\n${lastLogs}`);
+            }
+        }
+        if (tickRebuildSucceeded) {
+            // fall through to signing below with the rebuilt instructions
+        }
+        else {
+            // If an InitTick/InitTickIdLiquidation failed (already exists, or unrecognized discriminator),
+            // strip those instructions and retry the simulation.
+            const hasAlreadyInUse = logs.some(l => l.includes("already in use"));
+            const hasFallbackNotFound = logs.some(l => l.includes("InstructionFallbackNotFound") || l.includes("custom program error: 0x65"));
+            if (hasAlreadyInUse || hasFallbackNotFound) {
+                // Strip problematic JupLend instructions:
+                // - "already in use": InitTick accounts already exist
+                // - "FallbackNotFound": SDK generated an instruction the program doesn't recognize
+                const filtered = finalInstructions.filter(ix => {
+                    if (ix.programId.toBase58() !== JUPLEND_PROGRAM)
+                        return true;
+                    // Keep known-good InitTick instructions, strip everything else from JupLend
+                    if (isInitTickIx(ix)) {
+                        // Strip InitTick only if accounts already exist
+                        return !hasAlreadyInUse;
+                    }
+                    // Strip unrecognized JupLend instructions (causes FallbackNotFound)
+                    return !hasFallbackNotFound;
+                });
+                if (filtered.length < finalInstructions.length) {
+                    console.log("[simulation] Retrying without initTick instructions");
+                    finalInstructions = filtered;
+                    const retryMsg = new TransactionMessage({
+                        payerKey: wallet.publicKey,
+                        recentBlockhash: blockhash,
+                        instructions: finalInstructions,
+                    }).compileToV0Message(lookupTables);
+                    txToSign = new VersionedTransaction(retryMsg);
+                    const retryResult = await connection.simulateTransaction(txToSign, {
+                        sigVerify: false,
+                        replaceRecentBlockhash: true,
+                    });
+                    if (retryResult.value.err) {
+                        const retryLogs = retryResult.value.logs?.slice(-10).join("\n") || "";
+                        throw new Error(`Simulation failed: ${JSON.stringify(retryResult.value.err)}\n${retryLogs}`);
+                    }
+                }
+                else {
+                    const logStr = logs.slice(-10).join("\n");
+                    throw new Error(`Simulation failed: ${JSON.stringify(simResult.value.err)}\n${logStr}`);
+                }
+            }
+            else {
+                const logStr = logs.slice(-10).join("\n");
+                throw new Error(`Simulation failed: ${JSON.stringify(simResult.value.err)}\n${logStr}`);
+            }
+        } // close tickRebuildSucceeded else
+    }
+    // Rebuild with fresh blockhash — the original may be stale after simulation + wallet delay.
+    // Extract instructions from the compiled message and recompile with fresh blockhash.
+    const { blockhash: freshHash } = await connection.getLatestBlockhash();
+    const freshMsg = new TransactionMessage({
+        payerKey: wallet.publicKey,
+        recentBlockhash: freshHash,
+        instructions: txToSign === versionedTx ? finalInstructions : finalInstructions,
+    }).compileToV0Message(lookupTables);
+    const freshTx = new VersionedTransaction(freshMsg);
+    const signed = await wallet.signTransaction(freshTx);
+    const rawTx = signed.serialize();
+    const sig = await connection.sendRawTransaction(rawTx, {
+        skipPreflight: true,
+    });
+    // Poll for confirmation, re-sending periodically in case the TX was dropped
+    const start = Date.now();
+    const TIMEOUT_MS = 60000;
+    const RESEND_INTERVAL_MS = 4000;
+    let lastResend = Date.now();
+    while (Date.now() - start < TIMEOUT_MS) {
+        try {
+            const { value } = await connection.getSignatureStatuses([sig]);
+            const status = value[0];
+            if (status) {
+                if (status.err)
+                    throw new Error(`Transaction failed: ${JSON.stringify(status.err)}`);
+                if (status.confirmationStatus === "confirmed" || status.confirmationStatus === "finalized")
+                    return sig;
+            }
+        }
+        catch (e) {
+            console.warn("[confirm] RPC error, retrying:", e.message?.slice(0, 80));
+        }
+        // Re-send TX periodically in case it was dropped
+        if (Date.now() - lastResend > RESEND_INTERVAL_MS) {
+            try {
+                await connection.sendRawTransaction(rawTx, { skipPreflight: true });
+                lastResend = Date.now();
+            }
+            catch { }
+        }
+        await new Promise((r) => setTimeout(r, 2000));
+    }
+    throw new Error(`Transaction not confirmed within ${TIMEOUT_MS / 1000}s. Check: https://solscan.io/tx/${sig}`);
+}
+//# sourceMappingURL=transactionBuilder.js.map

package/dist/transactionBuilder.js.map

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

package/dist/txHelpers.d.ts

@@ -0,0 +1,16 @@
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import BN from "bn.js";
+import type { deriveUserTokenAccounts } from "./pdas";
+import type { VaultInfo } from "./vault/vaultAccounts";
+export type UserTokenAccounts = Awaited<ReturnType<typeof deriveUserTokenAccounts>>;
+export type SafeGetAccountInfo = (addr: PublicKey) => Promise<Awaited<ReturnType<Connection["getAccountInfo"]>>>;
+export declare function makeSafeGetAccountInfo(connection: Connection): SafeGetAccountInfo;
+/** Build wSOL wrapping instructions (create ATA if missing → transfer → sync). */
+export declare function buildWrapSolIxs(owner: PublicKey, wsolAta: PublicKey, lamports: BN, safeGetAccountInfo: SafeGetAccountInfo): Promise<TransactionInstruction[]>;
+/** Shares ATA (owned by the UserState PDA) for the given yield vault. */
+export declare function getSharesAtaForVault(vaultType: string, tokens: UserTokenAccounts): PublicKey;
+/** Fetch a LUT address from the Hobba backend; null when not configured. */
+export declare function fetchMarketLut(apiBaseUrl: string, market: string): Promise<PublicKey | null>;
+/** Resolve LUTs for a vault, fetching from the backend + per-vault constant. */
+export declare function resolveVaultLuts(apiBaseUrl: string, vi: VaultInfo, extraLuts?: PublicKey[]): Promise<PublicKey[]>;
+//# sourceMappingURL=txHelpers.d.ts.map

package/dist/txHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txHelpers.d.ts","sourceRoot":"","sources":["../src/txHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAiB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAM/F,OAAO,EAAE,MAAM,OAAO,CAAC;AACvB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAEpF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,SAAS,KACZ,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,kBAAkB,CAQjF;AAED,kFAAkF;AAClF,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,EAAE,EACZ,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAenC;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAW5F;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ3B;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,SAAS,EACb,SAAS,CAAC,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAwBtB"}

package/dist/txHelpers.js

@@ -0,0 +1,82 @@
+import { PublicKey, SystemProgram } from "@solana/web3.js";
+import { createAssociatedTokenAccountInstruction, createSyncNativeInstruction, NATIVE_MINT, } from "@solana/spl-token";
+export function makeSafeGetAccountInfo(connection) {
+    return async (addr) => {
+        try {
+            return await connection.getAccountInfo(addr);
+        }
+        catch {
+            return null;
+        }
+    };
+}
+/** Build wSOL wrapping instructions (create ATA if missing → transfer → sync). */
+export async function buildWrapSolIxs(owner, wsolAta, lamports, safeGetAccountInfo) {
+    const ixs = [];
+    const ataInfo = await safeGetAccountInfo(wsolAta);
+    if (!ataInfo) {
+        ixs.push(createAssociatedTokenAccountInstruction(owner, wsolAta, owner, NATIVE_MINT));
+    }
+    ixs.push(SystemProgram.transfer({
+        fromPubkey: owner,
+        toPubkey: wsolAta,
+        lamports: BigInt(lamports.toString()),
+    }), createSyncNativeInstruction(wsolAta));
+    return ixs;
+}
+/** Shares ATA (owned by the UserState PDA) for the given yield vault. */
+export function getSharesAtaForVault(vaultType, tokens) {
+    switch (vaultType) {
+        case "prime":
+            return tokens.pdaPrimeSharesAta;
+        case "rockawayRWA":
+            return tokens.pdaRockawaySharesAta;
+        case "perena":
+            return tokens.pdaPerenaSharesAta;
+        default:
+            return tokens.pdaSharesAta; // allez
+    }
+}
+/** Fetch a LUT address from the Hobba backend; null when not configured. */
+export async function fetchMarketLut(apiBaseUrl, market) {
+    try {
+        const resp = await fetch(`${apiBaseUrl}/api/lut?market=${market}`);
+        const data = await resp.json();
+        return data.address ? new PublicKey(data.address) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve LUTs for a vault, fetching from the backend + per-vault constant. */
+export async function resolveVaultLuts(apiBaseUrl, vi, extraLuts) {
+    const luts = [];
+    const seen = new Set();
+    const addLut = (pk) => {
+        const key = pk.toBase58();
+        if (!seen.has(key) && !pk.equals(PublicKey.default)) {
+            seen.add(key);
+            luts.push(pk);
+        }
+    };
+    if (vi.provider === "perena") {
+        const lut = await fetchMarketLut(apiBaseUrl, "perena");
+        if (lut)
+            addLut(lut);
+    }
+    else {
+        // Vault LUT from the backend (batch accounts for the kvault CPI) …
+        const lut = await fetchMarketLut(apiBaseUrl, "vault");
+        if (lut)
+            addLut(lut);
+        // … plus the per-vault constant LUT as fallback.
+        if (!vi.lookupTable.equals(PublicKey.default))
+            addLut(vi.lookupTable);
+    }
+    if (extraLuts) {
+        for (const l of extraLuts)
+            addLut(l);
+    }
+    return luts;
+}
+//# sourceMappingURL=txHelpers.js.map

package/dist/txHelpers.js.map

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

package/dist/userState.d.ts

@@ -0,0 +1,21 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+export type CurrentVaultType = "allez" | "prime" | "rockawayRWA" | "perena" | "none";
+export interface UserStateData {
+    owner: PublicKey;
+    obligation: PublicKey;
+    lendingMarket: PublicKey;
+    lendingProvider: number;
+    depositedToVault: number;
+    currentVault: PublicKey;
+    currentVaultType: CurrentVaultType;
+    collateralMint: PublicKey;
+}
+/**
+ * Parse a Hobba UserState account buffer. Lifted verbatim from the app's
+ * useUserState hook so the app, the widget, and headless integrators share one
+ * layout definition.
+ */
+export declare function parseUserStateData(data: Buffer): UserStateData;
+/** Fetch + parse the UserState for (owner, collateral mint). Null when none exists. */
+export declare function fetchUserState(connection: Connection, owner: PublicKey, collateralMint: PublicKey): Promise<UserStateData | null>;
+//# sourceMappingURL=userState.d.ts.map

package/dist/userState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userState.d.ts","sourceRoot":"","sources":["../src/userState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAcxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,aAAa,EAAE,SAAS,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,SAAS,CAAC;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,SAAS,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA8C9D;AAED,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,SAAS,GACxB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAK/B"}

package/dist/userState.js

@@ -0,0 +1,60 @@
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import { CBBTC_MINT, DEPOSITED_TO_VAULT_OFFSET, CURRENT_VAULT_OFFSET, COLLATERAL_MINT_OFFSET, ALLEZ_USDC_VAULT, USDC_PRIME_VAULT, ROCKAWAY_RWA_VAULT, PERENA_VAULT_STATE, } from "./constants";
+import { deriveUserStatePda } from "./pdas";
+/**
+ * Parse a Hobba UserState account buffer. Lifted verbatim from the app's
+ * useUserState hook so the app, the widget, and headless integrators share one
+ * layout definition.
+ */
+export function parseUserStateData(data) {
+    const owner = new PublicKey(data.slice(9, 41));
+    const obligation = new PublicKey(data.slice(41, 73));
+    const lendingMarket = new PublicKey(data.slice(73, 105));
+    const lendingProvider = data[105];
+    let depositedToVault = 0;
+    if (data.length >= DEPOSITED_TO_VAULT_OFFSET + 8) {
+        depositedToVault = new BN(data.slice(DEPOSITED_TO_VAULT_OFFSET, DEPOSITED_TO_VAULT_OFFSET + 8), "le").toNumber();
+    }
+    let currentVault = PublicKey.default;
+    let currentVaultType = "none";
+    if (data.length >= CURRENT_VAULT_OFFSET + 32) {
+        currentVault = new PublicKey(data.slice(CURRENT_VAULT_OFFSET, CURRENT_VAULT_OFFSET + 32));
+        if (!currentVault.equals(PublicKey.default)) {
+            if (currentVault.equals(ALLEZ_USDC_VAULT))
+                currentVaultType = "allez";
+            else if (currentVault.equals(USDC_PRIME_VAULT))
+                currentVaultType = "prime";
+            else if (currentVault.equals(ROCKAWAY_RWA_VAULT))
+                currentVaultType = "rockawayRWA";
+            else if (currentVault.equals(PERENA_VAULT_STATE))
+                currentVaultType = "perena";
+        }
+    }
+    let collateralMint = CBBTC_MINT; // default for older accounts
+    if (data.length >= COLLATERAL_MINT_OFFSET + 32) {
+        collateralMint = new PublicKey(data.slice(COLLATERAL_MINT_OFFSET, COLLATERAL_MINT_OFFSET + 32));
+        if (collateralMint.equals(PublicKey.default)) {
+            collateralMint = CBBTC_MINT;
+        }
+    }
+    return {
+        owner,
+        obligation,
+        lendingMarket,
+        lendingProvider,
+        depositedToVault,
+        currentVault,
+        currentVaultType,
+        collateralMint,
+    };
+}
+/** Fetch + parse the UserState for (owner, collateral mint). Null when none exists. */
+export async function fetchUserState(connection, owner, collateralMint) {
+    const [pda] = deriveUserStatePda(owner, collateralMint);
+    const info = await connection.getAccountInfo(pda);
+    if (!info)
+        return null;
+    return parseUserStateData(info.data);
+}
+//# sourceMappingURL=userState.js.map

package/dist/userState.js.map

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

package/dist/vault/vaultAccounts.d.ts

@@ -0,0 +1,82 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+export type VaultType = "allez" | "prime" | "rockawayRWA" | "perena";
+export type VaultProvider = "kvault" | "perena";
+export interface VaultInfo {
+    vault: PublicKey;
+    tokenVault: PublicKey;
+    authority: PublicKey;
+    sharesMint: PublicKey;
+    lookupTable: PublicKey;
+    provider: VaultProvider;
+    batchAccounts: {
+        pubkey: PublicKey;
+        isSigner: boolean;
+        isWritable: boolean;
+    }[];
+    withdrawFixed: {
+        pubkey: PublicKey;
+        isSigner: boolean;
+        isWritable: boolean;
+    }[];
+}
+export declare function vaultProviderToU8(provider: VaultProvider): number;
+/**
+ * Build KVault deposit vault_remaining:
+ * [token_vault, base_vault_authority, event_authority, kamino_program, kvault_program, ...batchAccounts]
+ */
+export declare function getKvaultDepositRemaining(vaultInfo: VaultInfo): AccountMeta[];
+/**
+ * Build KVault withdraw vault_remaining:
+ * [kvault_global_config, token_vault, base_vault_authority, event_authority, kamino_program, kvault_program, ...withdrawFixed, ...batchAccounts]
+ */
+export declare function getKvaultWithdrawRemaining(vaultInfo: VaultInfo, withdrawFixed: AccountMeta[]): AccountMeta[];
+export declare function getVaultInfo(vaultType: VaultType): VaultInfo;
+type AccountMeta = {
+    pubkey: PublicKey;
+    isSigner: boolean;
+    isWritable: boolean;
+};
+/**
+ * Reads vault state on-chain, finds the allocation with the highest ctokenAllocation,
+ * reads that reserve to get lending_market / liquidity.supplyVault / collateral.mintPubkey,
+ * and returns the 11-account withdrawFixed array.
+ */
+export declare function resolveWithdrawFixed(connection: Connection, vaultPubkey: PublicKey): Promise<AccountMeta[]>;
+export declare function identifyVaultType(vaultKey: PublicKey): VaultType | null;
+export declare function identifyVaultProvider(vaultKey: PublicKey): VaultProvider;
+/**
+ * Build the 16-account list for Perena deposit (mint_w_yielding_gen).
+ * These go into remaining_accounts when vault_provider = 1 (Perena).
+ * 15 instruction accounts + Perena program for CPI resolution.
+ * MarginFi accounts are omitted — Perena's crank will deploy capital later.
+ * This matches the Perena frontend behavior and avoids MarginFi ProtocolPaused errors.
+ */
+export declare function getPerenaDepositAccounts(pdaKey: PublicKey, pdaUsdcAta: PublicKey, pdaStarAta: PublicKey): AccountMeta[];
+/**
+ * Build the 16-account list for Perena withdraw (burn_for_yielding_gen) WITHOUT
+ * MarginFi. Use this only as a fallback when MarginFi is paused — otherwise
+ * Perena can only pay out from its small USDC transit buffer and will fail
+ * with `insufficient funds` when that buffer is drained between crank runs.
+ *
+ * Prefer `getPerenaWithdrawAccountsWithMarginfi` for normal operation.
+ *
+ * 15 instruction accounts + Perena program for CPI resolution.
+ */
+export declare function getPerenaWithdrawAccounts(pdaKey: PublicKey, pdaUsdcAta: PublicKey, pdaStarAta: PublicKey): AccountMeta[];
+/**
+ * Build the 24-account list for Perena withdraw (burn_for_yielding_gen) WITH
+ * MarginFi. This is the **default** for our flows: when the Perena USDC transit
+ * buffer is insufficient to cover the requested amount, Perena uses the
+ * MarginFi accounts to pull deployed capital back, so withdrawals don't fail.
+ *
+ * If MarginFi is paused (Perena's internal ProtocolPaused error), fall back to
+ * `getPerenaWithdrawAccounts` and retry after the next crank.
+ *
+ * 15 instruction accounts + 8 MarginFi (incl. oracle) + Perena program.
+ * MarginFi's LendingAccountWithdraw needs 1 oracle per active balance slot in
+ * Perena's marginfi account; Perena holds 2 balance slots, both USDC, so we
+ * pass the USDC oracle (position 22) and MarginFi reads it twice.
+ */
+export declare function getPerenaWithdrawAccountsWithMarginfi(pdaKey: PublicKey, pdaUsdcAta: PublicKey, pdaStarAta: PublicKey): AccountMeta[];
+export {};
+//# sourceMappingURL=vaultAccounts.d.ts.map

package/dist/vault/vaultAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaultAccounts.d.ts","sourceRoot":"","sources":["../../src/vault/vaultAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAA6C,MAAM,iBAAiB,CAAC;AA+CnG,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,EAAE,SAAS,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC/E,aAAa,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAChF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEjE;AAQD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,EAAE,CAS7E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAW5G;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CA+C5D;AASD,KAAK,WAAW,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjF;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAkExB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAMvE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,GAAG,aAAa,CAGxE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,SAAS,GACpB,WAAW,EAAE,CAmBf;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,SAAS,GACpB,WAAW,EAAE,CAmBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,SAAS,GACpB,WAAW,EAAE,CA4Bf"}