@kestrelfi/lyc-sdk 1.0.1 → 1.0.3

package/dist/sdks/long-yield-carry/src/constants/general.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOKEN_LOOKUP_TABLES = exports.GENERAL_LOOKUP_TABLES = exports.LYC_CB_KEYPAIR_FP = exports.LYC_MANAGER_KEYPAIR_FP = exports.LYC_ADMIN_KEYPAIR_FP = exports.AMOUNT_ALL_SENTINEL = exports.DEFAULT_MIN_INCENTIVE_UI_AMOUNT = exports.DEFAULT_RECOLLATERALIZE_LOSS_SLIPPAGE_BPS = exports.REBALANCE_TOKEN_RATE_LIMIT_SECS = exports.MAX_HEAP_FRAME_BYTES = exports.TOKEN_STALENESS_THRESHOLD_SECS = exports.REDEMPTION_EPOCH_STATUS_PROCESSING = exports.REDEMPTION_EPOCH_STATUS_FUNDING = exports.REDEMPTION_EPOCH_STATUS_OPEN = exports.PROTOCOL_FEE_WALLET = exports.PROTOCOL_ADMIN = exports.CIRCUIT_BREAKER_CONTROLLER = exports.MANAGER = exports.PROGRAM_ID = void 0;
-const core_1 = require("@anchor-lang/core");
-const kit_1 = require("@solana/kit");
-const common_1 = require("common");
-Object.defineProperty(exports, "PROTOCOL_ADMIN", { enumerable: true, get: function () { return common_1.PROTOCOL_ADMIN; } });
-/** Program ID per environment */
-exports.PROGRAM_ID = {
-    local: (0, kit_1.address)("7YPAKESPJ7zJAvBuk45ZVziu6tXGKoNzg3p9YpvrH6pX"),
-    test: (0, kit_1.address)("7C39GeKrqLygmgV9D4bicUaiyFhKrX6Eevk6PDACwuj7"),
-    prod: (0, kit_1.address)("LYC8YiiSzQfPpxUW2tpxfuPKGZwywAJhXKUfDP2B66f"),
-};
-/** Manager authority for manager-gated instruction accounts */
-exports.MANAGER = {
-    local: (0, kit_1.address)("4g1CzxGL2hopch95Aeww9RrQjx3NPq7NgN9QFK7jx8X1"),
-    test: (0, kit_1.address)("AqB478KVcoBwV39QjftJQ6qvV9xTh8CYB9jEnc2XSNLu"),
-    prod: (0, kit_1.address)("4g1CzxGL2hopch95Aeww9RrQjx3NPq7NgN9QFK7jx8X1"), // TODO
-};
-/** Circuit breaker controller for circuit-breaker-gated instruction accounts */
-exports.CIRCUIT_BREAKER_CONTROLLER = {
-    local: (0, kit_1.address)("CAcAFXBQBbr5xpESdbd9L1tEijPq1o2bdxju56qMZssj"),
-    test: (0, kit_1.address)("Wrj4caR4RJcmPgrRBE3HyFVMRKEmd2Y1ZuChbcjdeQu"),
-    prod: (0, kit_1.address)("7PxS1VMxKbzUTF4sxeAw4LqBfnGMaeQH2KwabmUcVxYC"), // TODO
-};
-/**
- * Protocol fee wallet — receives the protocol share of mint/burn + perf fees
- * and serves as the on-chain fallback for a token's `roles.fees` when unset
- * (`TokenRoles::curator_fee_wallet()` delegates to `protocol_fee_wallet()`).
- */
-exports.PROTOCOL_FEE_WALLET = {
-    local: (0, kit_1.address)("Fo6ihiHavRRnFG7k24JgwxNqVt6j7FWAWxDwoGoKd2MY"),
-    test: (0, kit_1.address)("8L2dWQqs6oQW6GCwp3fuosFTi5uCRJcbhhCKkjtyFG2e"),
-    prod: (0, kit_1.address)("Fo6ihiHavRRnFG7k24JgwxNqVt6j7FWAWxDwoGoKd2MY"), // TODO
-};
-/** Redemption epoch status: accepting new async burn requests. */
-exports.REDEMPTION_EPOCH_STATUS_OPEN = 0;
-/** Redemption epoch status: closed to new requests, collateral being funded. */
-exports.REDEMPTION_EPOCH_STATUS_FUNDING = 1;
-/** Redemption epoch status: funded, individual burn requests being processed. */
-exports.REDEMPTION_EPOCH_STATUS_PROCESSING = 2;
-/**
- * On-chain `TokenAccounting::MAX_FRESHNESS_SECS` = ONE_HOUR (3600s).
- * We use a 120s buffer so the refresh lands before on-chain staleness kicks in.
- */
-exports.TOKEN_STALENESS_THRESHOLD_SECS = 3600 - 120;
-/** Maximum heap-frame size requested by composed multi-CPI transactions. */
-exports.MAX_HEAP_FRAME_BYTES = 256 * 1024;
-/**
- * Mirror of the on-chain `REBALANCE_TOKEN_RATE_LIMIT_SECS` (24 hours). The
- * program rejects a `rebalance_token` on a lending position that was already
- * rebalanced within this window (`RebalanceRateLimited`); the SDK skips such
- * candidates client-side so we never build a transaction that would revert.
- */
-exports.REBALANCE_TOKEN_RATE_LIMIT_SECS = 24 * 60 * 60;
-/** Default recollateralize-loss swap slippage, capped by the on-chain 150 bps check. */
-exports.DEFAULT_RECOLLATERALIZE_LOSS_SLIPPAGE_BPS = 150;
-/**
- * Minimum claimable reward (in the reward token's UI units) for an incentive to
- * be worth harvesting. Below this, the on-chain `HarvestReward` moves only dust
- * while still costing a transaction fee, so `getOutstandingIncentives` omits it.
- */
-exports.DEFAULT_MIN_INCENTIVE_UI_AMOUNT = 0.01;
-/**
- * Sentinel value (u64::MAX) that callers can pass as an amount to `mint_token`
- * or `burn_token` to indicate "use the entire balance".
- * - mint_token: deposits the full collateral ATA balance.
- * - burn_token: burns the full yToken ATA balance.
- */
-exports.AMOUNT_ALL_SENTINEL = new core_1.BN("18446744073709551615");
-/** Re-exported from `common` — see {@link DEPLOYED_ADMIN_KEYPAIR_FP} there. */
-exports.LYC_ADMIN_KEYPAIR_FP = common_1.DEPLOYED_ADMIN_KEYPAIR_FP;
-/**
- * Filesystem paths to the manager keypair for future manager CLI scripts,
- * fixed per deployment tier (no env overrides).
- */
-exports.LYC_MANAGER_KEYPAIR_FP = {
-    test: "~/.config/solana/tp-lyc-manager-test.json",
-    prod: "~/.config/solana/tp-lyc-manager-prod.json",
-};
-/**
- * Filesystem paths to the circuit breaker controller keypair.
- * Used by emergency scripts (trigger circuit breaker, reset burn rate limit).
- */
-exports.LYC_CB_KEYPAIR_FP = {
-    test: "~/.config/solana/tp-lyc-cb-test.json",
-    prod: "~/.config/solana/tp-lyc-cb-prod.json",
-};
-/**
- * Shared general LUT per remote deployment tier (`test` | `prod`), same split as
- * {@link LYC_ADMIN_KEYPAIR_FP}. Populate via `pnpm run update-general-lut -- test|prod`.
- */
-exports.GENERAL_LOOKUP_TABLES = {
-    test: (0, kit_1.address)("GbiTxgWknTyRD2qwCvtytPXa1KnCwJWqakH4mJRpU3mF"),
-    prod: (0, kit_1.address)("11111111111111111111111111111111"), // TODO
-};
-exports.TOKEN_LOOKUP_TABLES = {
-    // TEST
-    [(0, kit_1.address)("7fEA5HTsveMn5HfnXN82nmTniXeWDs6YJuvLyk7qFcNG")]: (0, kit_1.address)("HTBxsGsKgfMmPVuxdia1PQkdATUrFofmbJAtC7he6qEK"),
-    [(0, kit_1.address)("2BGSs7s5mSJgSCMcppAaQj5Ppp1kHmQNQ9ESoGWK2Hmx")]: (0, kit_1.address)("5UmqM2LE4RwpF91aXiXNVB5tSJKsLoVfxLA3gc6Qrj35"),
-    [(0, kit_1.address)("6qtzJnVn6nTZXJhcAUgmofKsTYuaSp8ag1BcxcE9EEz7")]: (0, kit_1.address)("DJstSjLyA4KwhgRh3s1Bd28eSoke8st6nAXTDNVtckqj"),
-    [(0, kit_1.address)("3m9Nx5ZCghjsMPmBpJm1ZWb27SUHLzdUJdwb2mquo3Kb")]: (0, kit_1.address)("3bZYrhiqee6zPCvnXqMjNjtN5M7aPa4rebvmEtVUvGwG"),
-    [(0, kit_1.address)("HbhfU6ihxuzzpwmdgpWP5QC6HpemnMGZANCQEDQ7V92L")]: (0, kit_1.address)("EJSQZD9qzqaBacntUgouM9dmo9dgeBechNvASZ3V4NRr"),
-    [(0, kit_1.address)("GphwC2jwG3mcM8FYFFm5j8A4jNw3i7Hhic4poLbnoKpu")]: (0, kit_1.address)("6x8fiZxU6f82a3grAECC8nLuwkFoBPjFwAYhfpbeqw18"),
-    [(0, kit_1.address)("975Zp2WbD7WQfG6mTDPVUjc4mbEALMBXeyn4Pwr45f7p")]: (0, kit_1.address)("9ERF9KcYvehmMku9mqAvzhduDHpJu36pcvZ3xr2NJJ9o"),
-    // PROD
-};

package/dist/sdks/long-yield-carry/src/constants/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./general";
-export * from "./configs";
-export * from "./lycTokenMetadata";

package/dist/sdks/long-yield-carry/src/constants/index.js

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./general"), exports);
-__exportStar(require("./configs"), exports);
-__exportStar(require("./lycTokenMetadata"), exports);

package/dist/sdks/long-yield-carry/src/constants/lycTokenMetadata.d.ts

@@ -1,36 +0,0 @@
-import type { Environment } from "common";
-/**
- * Display fields used as the fallback when on-chain Metaplex Token-Metadata
- * is missing or empty. Mirrors {@link OnchainTokenMetadata} on the read path
- * so the consumer can treat both sources uniformly.
- */
-export interface LycTokenMetadataEntry {
-    /** Brand-cased symbol shown as the primary label (e.g. "ksBTC", "primeBTC"). */
-    symbol: string;
-    /** Human-readable name (e.g. "Kestrel BTC", "Prime BTC"). */
-    name: string;
-}
-/**
- * Curated fallback registry of LYC token display metadata, keyed by the
- * token's mint address. Only used when on-chain Metaplex Token-Metadata
- * isn't set yet — the on-chain value always wins.
- *
- * This exists because:
- *   1. Multiple LYC tokens can share the same underlying collateral
- *      (e.g. ksBTC and primeBTC both built on cbBTC), so the LYC token's
- *      symbol cannot be synthesized from the collateral's symbol alone.
- *   2. Metaplex `update_token_metadata` requires an admin transaction we
- *      don't always run before a token starts surfacing in the UI.
- *
- * Keyed by environment because LYC mints are unique per program deployment.
- *
- * To populate, add the LYC token mint address as the key. Once metadata is
- * set on-chain via:
- *
- *   pnpm --filter @kestrelfi/lyc-sdk run \
- *     update-token-metadata -- test|prod <TOKEN_PDA|COLLATERAL_SYMBOL> \
- *     --name "<Display Name>" --symbol "<ksXXX>" --uri "<json uri>"
- *
- * the entry here can be removed.
- */
-export declare const LYC_TOKEN_METADATA: Record<Environment, Record<string, LycTokenMetadataEntry>>;

package/dist/sdks/long-yield-carry/src/constants/lycTokenMetadata.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LYC_TOKEN_METADATA = void 0;
-/**
- * Curated fallback registry of LYC token display metadata, keyed by the
- * token's mint address. Only used when on-chain Metaplex Token-Metadata
- * isn't set yet — the on-chain value always wins.
- *
- * This exists because:
- *   1. Multiple LYC tokens can share the same underlying collateral
- *      (e.g. ksBTC and primeBTC both built on cbBTC), so the LYC token's
- *      symbol cannot be synthesized from the collateral's symbol alone.
- *   2. Metaplex `update_token_metadata` requires an admin transaction we
- *      don't always run before a token starts surfacing in the UI.
- *
- * Keyed by environment because LYC mints are unique per program deployment.
- *
- * To populate, add the LYC token mint address as the key. Once metadata is
- * set on-chain via:
- *
- *   pnpm --filter @kestrelfi/lyc-sdk run \
- *     update-token-metadata -- test|prod <TOKEN_PDA|COLLATERAL_SYMBOL> \
- *     --name "<Display Name>" --symbol "<ksXXX>" --uri "<json uri>"
- *
- * the entry here can be removed.
- */
-exports.LYC_TOKEN_METADATA = {
-    local: {},
-    test: {
-        EsMqszfbgHtVgh5N2q1wKSEQQAP4HqojRVjDgDo6MB4U: { symbol: "ksBTC", name: "Kestrel BTC" },
-        JD9axkbp23WabWcVJJQfBvJ9z7Qn4A2zayHhRED8ynZq: { symbol: "ksETH", name: "Kestrel ETH" },
-        GFMBAKop6cdzBTqW9PP2eKddowDgXZSK1P6Bp8rCuFFm: { symbol: "ksSOL", name: "Kestrel SOL" },
-        "2z8P6DvqPzii6vuNu8JGPFBrGHQ94Fjgi9hHQQ7JcS34": {
-            symbol: "ksDFDVSOL",
-            name: "Kestrel dfdvSOL",
-        },
-        "8k3eDWZ6wZkJcBWYS4tzmtHfk2HjqxmwkLzr8wixXAcj": { symbol: "ksQQQX", name: "Kestrel QQQx" },
-        "9tPaWdEkjBYW3FbEBMt38wYAGdSWFj6wGXvzPrYwC4Bp": { symbol: "ksSPYX", name: "Kestrel SPYx" },
-    },
-    prod: {},
-};

package/dist/sdks/long-yield-carry/src/decoders/decodeTransaction.d.ts

@@ -1,86 +0,0 @@
-/**
- * Decoder: streamed Solana transaction payloads → normalized LYC user events.
- *
- * Wire shape is validator-style `getTransaction` data wrapped by the API into
- * {@link LycProgramTransactionRecord} when enqueued. Downstream consumers (the
- * indexer Lambda, backfill jobs) validate the envelope with
- * {@link parseLycProgramTransactionRecord} then call
- * {@link decodeLycProgramTransaction} to produce zero or more user-facing
- * {@link LycTransactionEvent}s.
- *
- * The set of indexed instructions is currently `mint_token` and `burn_token`.
- * Both are inlined in this module — if we ever add a third, promote back to a
- * registry/interface pattern.
- */
-import type { TxMessage, TxMeta } from "./transactionPayload";
-import type { LycProgramTransactionRecord, LycTransactionEvent } from "./types";
-/**
- * Validate and narrow an arbitrary JSON body (SQS message body / API request)
- * to {@link LycProgramTransactionRecord}. Returns `null` on any shape mismatch.
- */
-export declare function parseLycProgramTransactionRecord(input: unknown): LycProgramTransactionRecord | null;
-/**
- * Stable enum of why a matched-discriminator instruction produced no event.
- * All reasons are CPI-driven; none depend on balance deltas.
- */
-export type DecoderRejectionReason = "accounts_too_short" | "missing_key" | "no_inner_instructions_block" | "no_token_burn_cpi" | "no_token_mint_to_cpi" | "no_collateral_out_delta" | "no_collateral_in_delta";
-/**
- * One reason a tx produced zero events despite looking like something we index.
- *
- * - `payload_unparseable`: the envelope `payload` lacked `meta` / `transaction.message` and
- *   we couldn't even enumerate instructions.
- * - `instruction_data_invalid`: an LYC-program instruction's `data` field wasn't valid
- *   base58 so we couldn't read its discriminator.
- * - `decoder_rejected`: the discriminator matched a user-facing decoder but a guard rail
- *   returned null — `reason` identifies which guard.
- */
-export type DecodeRejection = {
-    kind: "payload_unparseable";
-} | {
-    kind: "instruction_data_invalid";
-    instructionIndex: number;
-} | {
-    kind: "decoder_rejected";
-    name: "mint_token" | "burn_token";
-    reason: DecoderRejectionReason;
-};
-export interface DecodeResult {
-    events: LycTransactionEvent[];
-    /**
-     * Non-empty only when something anomalous happened. Consumers that want to
-     * distinguish "refresh-only tx, nothing to do" from "tried and bailed" check
-     * `rejections.length === 0` for the former and `rejections.length > 0` for
-     * the latter.
-     */
-    rejections: DecodeRejection[];
-}
-/**
- * Decode one queued tx into zero or more user-facing events, in top-level
- * instruction order. Silently skips instructions we don't index or whose data
- * cannot be base58-decoded.
- */
-export declare function decodeLycProgramTransaction(record: LycProgramTransactionRecord): LycTransactionEvent[];
-/**
- * Same as {@link decodeLycProgramTransaction} but also returns structured
- * rejections for the indexer's CloudWatch log path. Use this when "zero events"
- * isn't enough information — e.g. you need to know whether a burn-shaped tx
- * bailed because its inner-instructions block was missing or because no
- * collateral transfer CPI landed in the user's ATA.
- */
-export declare function decodeLycProgramTransactionWithDiagnostics(record: LycProgramTransactionRecord): DecodeResult;
-/**
- * Per-tx data shared by the mint/burn decoders and by
- * {@link listLycTopLevelInstructionNames} in the sibling module. Exported so
- * the names helper can reuse the parse work — not part of the public SDK.
- */
-export interface ParsedTx {
-    message: TxMessage;
-    meta: TxMeta;
-    signature: string;
-    slot: number;
-    blockTime: number;
-    fee: number;
-    /** Static + ALT-loaded account keys, in the index order used by instructions. */
-    keys: string[];
-}
-export declare function parseRecordPayload(record: LycProgramTransactionRecord): ParsedTx | null;

package/dist/sdks/long-yield-carry/src/decoders/decodeTransaction.js

@@ -1,230 +0,0 @@
-"use strict";
-/**
- * Decoder: streamed Solana transaction payloads → normalized LYC user events.
- *
- * Wire shape is validator-style `getTransaction` data wrapped by the API into
- * {@link LycProgramTransactionRecord} when enqueued. Downstream consumers (the
- * indexer Lambda, backfill jobs) validate the envelope with
- * {@link parseLycProgramTransactionRecord} then call
- * {@link decodeLycProgramTransaction} to produce zero or more user-facing
- * {@link LycTransactionEvent}s.
- *
- * The set of indexed instructions is currently `mint_token` and `burn_token`.
- * Both are inlined in this module — if we ever add a third, promote back to a
- * registry/interface pattern.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseLycProgramTransactionRecord = parseLycProgramTransactionRecord;
-exports.decodeLycProgramTransaction = decodeLycProgramTransaction;
-exports.decodeLycProgramTransactionWithDiagnostics = decodeLycProgramTransactionWithDiagnostics;
-exports.parseRecordPayload = parseRecordPayload;
-const discriminators_1 = require("./discriminators");
-const idlAccounts_1 = require("./idlAccounts");
-const innerCpis_1 = require("./innerCpis");
-const programIds_1 = require("./programIds");
-const solana_1 = require("./solana");
-/**
- * Validate and narrow an arbitrary JSON body (SQS message body / API request)
- * to {@link LycProgramTransactionRecord}. Returns `null` on any shape mismatch.
- */
-function parseLycProgramTransactionRecord(input) {
-    if (!input || typeof input !== "object")
-        return null;
-    const o = input;
-    if (o.source !== "lyc-program-transaction")
-        return null;
-    if (typeof o.signature !== "string" || o.signature.length === 0)
-        return null;
-    if (!("payload" in o))
-        return null;
-    return {
-        source: "lyc-program-transaction",
-        receivedAt: typeof o.receivedAt === "number" ? o.receivedAt : 0,
-        signature: o.signature,
-        slot: typeof o.slot === "number" ? o.slot : undefined,
-        payload: o.payload,
-    };
-}
-/**
- * Decode one queued tx into zero or more user-facing events, in top-level
- * instruction order. Silently skips instructions we don't index or whose data
- * cannot be base58-decoded.
- */
-function decodeLycProgramTransaction(record) {
-    return decodeLycProgramTransactionWithDiagnostics(record).events;
-}
-/**
- * Same as {@link decodeLycProgramTransaction} but also returns structured
- * rejections for the indexer's CloudWatch log path. Use this when "zero events"
- * isn't enough information — e.g. you need to know whether a burn-shaped tx
- * bailed because its inner-instructions block was missing or because no
- * collateral transfer CPI landed in the user's ATA.
- */
-function decodeLycProgramTransactionWithDiagnostics(record) {
-    const tx = parseRecordPayload(record);
-    if (!tx) {
-        return { events: [], rejections: [{ kind: "payload_unparseable" }] };
-    }
-    const events = [];
-    const rejections = [];
-    for (let i = 0; i < tx.message.instructions.length; i++) {
-        const ix = tx.message.instructions[i];
-        const programId = tx.keys[ix.programIdIndex];
-        if (!programId || !programIds_1.LYC_PROGRAM_IDS.has(programId))
-            continue;
-        let data;
-        try {
-            data = (0, solana_1.decodeInstructionData)(ix.data);
-        }
-        catch {
-            rejections.push({ kind: "instruction_data_invalid", instructionIndex: i });
-            continue;
-        }
-        if ((0, solana_1.discriminatorMatches)(data, discriminators_1.MINT_TOKEN_DISCRIMINATOR)) {
-            const outcome = decodeMintToken(tx, ix.accounts, i);
-            if ("event" in outcome)
-                events.push(outcome.event);
-            else
-                rejections.push({ kind: "decoder_rejected", name: "mint_token", reason: outcome.reason });
-        }
-        else if ((0, solana_1.discriminatorMatches)(data, discriminators_1.BURN_TOKEN_DISCRIMINATOR)) {
-            const outcome = decodeBurnToken(tx, ix.accounts, i);
-            if ("event" in outcome)
-                events.push(outcome.event);
-            else
-                rejections.push({ kind: "decoder_rejected", name: "burn_token", reason: outcome.reason });
-        }
-    }
-    return { events, rejections };
-}
-function parseRecordPayload(record) {
-    const payload = record.payload;
-    if (!payload || typeof payload !== "object")
-        return null;
-    const p = payload;
-    const meta = p.meta;
-    const transaction = p.transaction;
-    const message = transaction?.message;
-    if (!meta || !message?.accountKeys || !Array.isArray(message.instructions)) {
-        return null;
-    }
-    const slot = typeof record.slot === "number" ? record.slot : typeof p.slot === "number" ? p.slot : 0;
-    return {
-        message,
-        meta,
-        signature: record.signature,
-        slot,
-        blockTime: typeof p.blockTime === "number" ? p.blockTime : 0,
-        fee: typeof meta.fee === "number" ? meta.fee : 0,
-        keys: (0, solana_1.buildAccountKeys)(message, meta),
-    };
-}
-/**
- * Authoritative reads: inner CPIs emitted by mint_token.
- *  - Token amount: SPL Token `MintTo` CPI whose `accounts[1]` (dest ATA)
- *    matches `user_token_account`. Amount is encoded in the ix data as a
- *    little-endian u64.
- *  - Collateral amount: sum of SPL Token `Transfer` / `TransferChecked`
- *    CPIs whose source matches `user_collateral_account`. The collateral
- *    mint is known structurally (`collateral_mint`), so we don't need to
- *    derive it per-transfer.
- *
- * Account positions are resolved by name from the IDL via
- * {@link MINT_TOKEN_ACCOUNTS} — resilient to account-list reordering, and
- * fail-fast at module load if a required account is renamed or removed.
- */
-function decodeMintToken(tx, accounts, ixIndex) {
-    const signerPos = idlAccounts_1.MINT_TOKEN_ACCOUNTS.signer;
-    const mintPos = idlAccounts_1.MINT_TOKEN_ACCOUNTS.mint;
-    const collateralMintPos = idlAccounts_1.MINT_TOKEN_ACCOUNTS.collateral_mint;
-    const userCollateralAtaPos = idlAccounts_1.MINT_TOKEN_ACCOUNTS.user_collateral_account;
-    const userTokenAtaPos = idlAccounts_1.MINT_TOKEN_ACCOUNTS.user_token_account;
-    const maxPos = Math.max(signerPos, mintPos, collateralMintPos, userCollateralAtaPos, userTokenAtaPos);
-    if (accounts.length <= maxPos)
-        return { reason: "accounts_too_short" };
-    const wallet = tx.keys[accounts[signerPos]];
-    const tokenMint = tx.keys[accounts[mintPos]];
-    const collateralMint = tx.keys[accounts[collateralMintPos]];
-    if (!wallet || !tokenMint || !collateralMint)
-        return { reason: "missing_key" };
-    const block = (0, innerCpis_1.findInnerInstructionBlock)(tx.meta, ixIndex);
-    if (!block)
-        return { reason: "no_inner_instructions_block" };
-    const mintedAmount = (0, innerCpis_1.splMintToAmountToDest)(tx.keys, block, accounts[userTokenAtaPos]);
-    if (mintedAmount === null)
-        return { reason: "no_token_mint_to_cpi" };
-    const collateralAmount = (0, innerCpis_1.sumSplTransfersFromSource)(tx.keys, block, accounts[userCollateralAtaPos]);
-    if (collateralAmount <= 0n)
-        return { reason: "no_collateral_in_delta" };
-    return {
-        event: {
-            signature: tx.signature,
-            slot: tx.slot,
-            blockTime: tx.blockTime,
-            type: "mint",
-            wallet,
-            tokenMint,
-            tokenAmountBaseUnits: mintedAmount.toString(),
-            collateralMint,
-            collateralAmountBaseUnits: collateralAmount.toString(),
-            fee: tx.fee,
-        },
-    };
-}
-/**
- * Authoritative reads: inner CPIs emitted by burn_token.
- *  - Token amount: SPL Token `Burn` CPI whose `accounts[0]` (source ATA)
- *    matches `user_token_account`. Amount is encoded in the ix data as a
- *    little-endian u64, not derived from a balance delta.
- *  - Collateral: SPL Token `Transfer` / `TransferChecked` CPIs whose
- *    destination matches `user_collateral_account`. Amounts are summed per
- *    mint; the dominant mint wins — in practice the Rust program emits a
- *    single transfer with a single mint, so the aggregation step is defensive
- *    (see `rust/.../burn_token.rs`).
- *
- * CPI-authoritative decoding does not depend on whether the user's collateral
- * ATA persists across the tx — created-and-closed-same-tx ATAs, pre-existing
- * ATAs closed at the end, and ATAs re-funded inside the same tx all decode
- * identically because the CPIs themselves never disappear.
- *
- * Account positions are resolved by name from the IDL via
- * {@link BURN_TOKEN_ACCOUNTS} — resilient to account-list reordering, and
- * fail-fast at module load if a required account is renamed or removed.
- */
-function decodeBurnToken(tx, accounts, ixIndex) {
-    const signerPos = idlAccounts_1.BURN_TOKEN_ACCOUNTS.signer;
-    const mintPos = idlAccounts_1.BURN_TOKEN_ACCOUNTS.mint;
-    const userTokenAtaPos = idlAccounts_1.BURN_TOKEN_ACCOUNTS.user_token_account;
-    const userCollateralAtaPos = idlAccounts_1.BURN_TOKEN_ACCOUNTS.user_collateral_account;
-    const maxPos = Math.max(signerPos, mintPos, userTokenAtaPos, userCollateralAtaPos);
-    if (accounts.length <= maxPos)
-        return { reason: "accounts_too_short" };
-    const wallet = tx.keys[accounts[signerPos]];
-    const tokenMint = tx.keys[accounts[mintPos]];
-    if (!wallet || !tokenMint)
-        return { reason: "missing_key" };
-    const block = (0, innerCpis_1.findInnerInstructionBlock)(tx.meta, ixIndex);
-    if (!block)
-        return { reason: "no_inner_instructions_block" };
-    const burnedAmount = (0, innerCpis_1.splBurnAmountFromSource)(tx.keys, block, accounts[userTokenAtaPos]);
-    if (burnedAmount === null)
-        return { reason: "no_token_burn_cpi" };
-    const transfers = (0, innerCpis_1.collectSplTransfersTo)(tx.keys, block, accounts[userCollateralAtaPos]);
-    const collateral = (0, innerCpis_1.aggregateCollateralTransfers)(tx.meta, transfers);
-    if (!collateral)
-        return { reason: "no_collateral_out_delta" };
-    return {
-        event: {
-            signature: tx.signature,
-            slot: tx.slot,
-            blockTime: tx.blockTime,
-            type: "burn",
-            wallet,
-            tokenMint,
-            tokenAmountBaseUnits: burnedAmount.toString(),
-            collateralMint: collateral.collateralMint,
-            collateralAmountBaseUnits: collateral.amount.toString(),
-            fee: tx.fee,
-        },
-    };
-}

package/dist/sdks/long-yield-carry/src/decoders/discriminators.d.ts

@@ -1,8 +0,0 @@
-/**
- * Anchor 8-byte instruction discriminators (see `idl/long_yield_carry.ts`).
- * Add new entries here when supporting additional indexed instructions.
- */
-/** `burn_token` */
-export declare const BURN_TOKEN_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
-/** `mint_token` */
-export declare const MINT_TOKEN_DISCRIMINATOR: Uint8Array<ArrayBuffer>;

package/dist/sdks/long-yield-carry/src/decoders/discriminators.js

@@ -1,11 +0,0 @@
-"use strict";
-/**
- * Anchor 8-byte instruction discriminators (see `idl/long_yield_carry.ts`).
- * Add new entries here when supporting additional indexed instructions.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MINT_TOKEN_DISCRIMINATOR = exports.BURN_TOKEN_DISCRIMINATOR = void 0;
-/** `burn_token` */
-exports.BURN_TOKEN_DISCRIMINATOR = Uint8Array.from([185, 165, 216, 246, 144, 31, 70, 74]);
-/** `mint_token` */
-exports.MINT_TOKEN_DISCRIMINATOR = Uint8Array.from([172, 137, 183, 14, 207, 110, 234, 56]);

package/dist/sdks/long-yield-carry/src/decoders/idlAccounts.d.ts

@@ -1,29 +0,0 @@
-/**
- * IDL-backed account resolution for the LYC decoder.
- *
- * The decoder reads specific accounts (wallet, mint, collateral mint, user
- * ATAs) out of each indexed instruction's account list. Rather than hardcoding
- * positional indices — which silently break if the on-chain
- * `#[derive(Accounts)]` struct is ever reordered — we resolve positions by
- * account name off the SDK's shipped IDL at module load.
- *
- * Guarantees:
- *  - **Resilient to reordering.** If the Rust program reorders accounts, the
- *    regenerated IDL updates the name→index map and the decoder follows.
- *  - **Fail-fast on rename/removal.** If an account we depend on is renamed
- *    or removed, this module throws at import time — the SDK fails to load
- *    instead of producing mislabeled events.
- *  - **Minimal surface.** Only pins the accounts the decoder actually reads
- *    (`signer`, `mint`, `collateral_mint`, `user_token_account`,
- *    `user_collateral_account`). Unused accounts can be renamed freely.
- */
-declare const MINT_TOKEN_REQUIRED_ACCOUNT_NAMES: readonly ["signer", "mint", "collateral_mint", "user_collateral_account", "user_token_account"];
-declare const BURN_TOKEN_REQUIRED_ACCOUNT_NAMES: readonly ["signer", "mint", "user_token_account", "user_collateral_account"];
-type MintTokenAccountName = (typeof MINT_TOKEN_REQUIRED_ACCOUNT_NAMES)[number];
-type BurnTokenAccountName = (typeof BURN_TOKEN_REQUIRED_ACCOUNT_NAMES)[number];
-/** Name→index map for the accounts list of `mint_token`. */
-export declare const MINT_TOKEN_ACCOUNTS: Readonly<Record<"signer" | "mint" | "user_token_account" | "collateral_mint" | "user_collateral_account", number>>;
-/** Name→index map for the accounts list of `burn_token`. */
-export declare const BURN_TOKEN_ACCOUNTS: Readonly<Record<"signer" | "mint" | "user_token_account" | "user_collateral_account", number>>;
-export { MINT_TOKEN_REQUIRED_ACCOUNT_NAMES, BURN_TOKEN_REQUIRED_ACCOUNT_NAMES };
-export type { MintTokenAccountName, BurnTokenAccountName };

package/dist/sdks/long-yield-carry/src/decoders/idlAccounts.js

@@ -1,57 +0,0 @@
-"use strict";
-/**
- * IDL-backed account resolution for the LYC decoder.
- *
- * The decoder reads specific accounts (wallet, mint, collateral mint, user
- * ATAs) out of each indexed instruction's account list. Rather than hardcoding
- * positional indices — which silently break if the on-chain
- * `#[derive(Accounts)]` struct is ever reordered — we resolve positions by
- * account name off the SDK's shipped IDL at module load.
- *
- * Guarantees:
- *  - **Resilient to reordering.** If the Rust program reorders accounts, the
- *    regenerated IDL updates the name→index map and the decoder follows.
- *  - **Fail-fast on rename/removal.** If an account we depend on is renamed
- *    or removed, this module throws at import time — the SDK fails to load
- *    instead of producing mislabeled events.
- *  - **Minimal surface.** Only pins the accounts the decoder actually reads
- *    (`signer`, `mint`, `collateral_mint`, `user_token_account`,
- *    `user_collateral_account`). Unused accounts can be renamed freely.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BURN_TOKEN_REQUIRED_ACCOUNT_NAMES = exports.MINT_TOKEN_REQUIRED_ACCOUNT_NAMES = exports.BURN_TOKEN_ACCOUNTS = exports.MINT_TOKEN_ACCOUNTS = void 0;
-const long_yield_carry_1 = require("../idl/long_yield_carry");
-const MINT_TOKEN_REQUIRED_ACCOUNT_NAMES = [
-    "signer",
-    "mint",
-    "collateral_mint",
-    "user_collateral_account",
-    "user_token_account",
-];
-exports.MINT_TOKEN_REQUIRED_ACCOUNT_NAMES = MINT_TOKEN_REQUIRED_ACCOUNT_NAMES;
-const BURN_TOKEN_REQUIRED_ACCOUNT_NAMES = [
-    "signer",
-    "mint",
-    "user_token_account",
-    "user_collateral_account",
-];
-exports.BURN_TOKEN_REQUIRED_ACCOUNT_NAMES = BURN_TOKEN_REQUIRED_ACCOUNT_NAMES;
-function buildAccountIndexMap(instructionName, requiredNames) {
-    const ix = long_yield_carry_1.IDL.instructions.find((entry) => entry.name === instructionName);
-    if (!ix) {
-        throw new Error(`IDL account resolver: instruction "${instructionName}" not found`);
-    }
-    const map = {};
-    for (const name of requiredNames) {
-        const idx = ix.accounts.findIndex((a) => a.name === name);
-        if (idx < 0) {
-            throw new Error(`IDL account resolver: instruction "${instructionName}" is missing account "${name}"`);
-        }
-        map[name] = idx;
-    }
-    return Object.freeze(map);
-}
-/** Name→index map for the accounts list of `mint_token`. */
-exports.MINT_TOKEN_ACCOUNTS = buildAccountIndexMap("mint_token", MINT_TOKEN_REQUIRED_ACCOUNT_NAMES);
-/** Name→index map for the accounts list of `burn_token`. */
-exports.BURN_TOKEN_ACCOUNTS = buildAccountIndexMap("burn_token", BURN_TOKEN_REQUIRED_ACCOUNT_NAMES);

package/dist/sdks/long-yield-carry/src/decoders/index.d.ts

@@ -1,6 +0,0 @@
-export type { LycProgramTransactionRecord, LycTransactionEvent, LycTransactionType } from "./types";
-export { decodeLycProgramTransaction, decodeLycProgramTransactionWithDiagnostics, parseLycProgramTransactionRecord, } from "./decodeTransaction";
-export type { DecodeRejection, DecodeResult, DecoderRejectionReason } from "./decodeTransaction";
-export { listLycTopLevelInstructionNames } from "./lycInstructionNames";
-export { BURN_TOKEN_ACCOUNTS, BURN_TOKEN_REQUIRED_ACCOUNT_NAMES, MINT_TOKEN_ACCOUNTS, MINT_TOKEN_REQUIRED_ACCOUNT_NAMES, } from "./idlAccounts";
-export type { BurnTokenAccountName, MintTokenAccountName } from "./idlAccounts";