perena-vault-sdk 1.0.0

package/dist/services/consensusOracle/mockYieldTracker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * In-memory mock of the bankineco yield tracker.
+ *
+ * Mirrors the method surface of the real HTTP client
+ * (`bankineco-services/src/api/yieldApi.ts`) so it can be swapped for the live
+ * service without touching {@link ConsensusOracleService}. Each account accrues
+ * simple interest at a configured APR over the time its principal is held,
+ * re-based at every cashflow — a faithful-enough stand-in for the real
+ * segment-based calculation, with an injectable {@link Clock} so accrual is
+ * deterministic in tests.
+ *
+ * All amounts are **UI amounts** (token units), matching the real API.
+ */
+import { type Clock } from "./types";
+import type { YieldAccountSnapshot, YieldTracker } from "./types";
+export interface MockYieldAccountConfig {
+    aprBps: number;
+    /** Initial principal (UI amount). Defaults to 0. */
+    principal?: number;
+    /** Accrual start (ms since epoch). Defaults to the clock's current time. */
+    startTs?: number;
+}
+export interface MockYieldTrackerOptions {
+    accounts?: Record<string, MockYieldAccountConfig>;
+    clock?: Clock;
+}
+export declare class MockYieldTracker implements YieldTracker {
+    private readonly accounts;
+    private readonly clock;
+    constructor(opts?: MockYieldTrackerOptions);
+    /** Register (or replace) a tracked account. */
+    setAccount(name: string, cfg: MockYieldAccountConfig): void;
+    private require;
+    getYield(accountName: string, start?: Date, end?: Date): Promise<YieldAccountSnapshot>;
+    getTotalYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+    getBalance(accountName: string, atTime?: Date): Promise<number>;
+    addCashflow(params: {
+        accountName: string;
+        amount: number;
+        date?: Date;
+        cashflowType: "deposit" | "withdraw";
+    }): Promise<void>;
+}
+//# sourceMappingURL=mockYieldTracker.d.ts.map

package/dist/services/consensusOracle/mockYieldTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockYieldTracker.d.ts","sourceRoot":"","sources":["../../../src/services/consensusOracle/mockYieldTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAoBlE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,IAAI,GAAE,uBAA4B;IAY9C,+CAA+C;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAS3D,OAAO,CAAC,OAAO;IAQT,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,IAAI,EACZ,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,oBAAoB,CAAC;IA2C1B,aAAa,CACjB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,CAAC,EAAE,IAAI,EACZ,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC;IASZ,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D,WAAW,CAAC,MAAM,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlB"}

package/dist/services/consensusOracle/mockYieldTracker.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockYieldTracker = void 0;
+/**
+ * In-memory mock of the bankineco yield tracker.
+ *
+ * Mirrors the method surface of the real HTTP client
+ * (`bankineco-services/src/api/yieldApi.ts`) so it can be swapped for the live
+ * service without touching {@link ConsensusOracleService}. Each account accrues
+ * simple interest at a configured APR over the time its principal is held,
+ * re-based at every cashflow — a faithful-enough stand-in for the real
+ * segment-based calculation, with an injectable {@link Clock} so accrual is
+ * deterministic in tests.
+ *
+ * All amounts are **UI amounts** (token units), matching the real API.
+ */
+const types_1 = require("./types");
+const SECONDS_PER_YEAR = 365 * 24 * 60 * 60;
+class MockYieldTracker {
+    constructor(opts = {}) {
+        this.accounts = new Map();
+        this.clock = opts.clock ?? types_1.systemClock;
+        for (const [name, cfg] of Object.entries(opts.accounts ?? {})) {
+            this.accounts.set(name, {
+                aprBps: cfg.aprBps,
+                initialPrincipal: cfg.principal ?? 0,
+                startTs: cfg.startTs ?? this.clock.now(),
+                cashflows: [],
+            });
+        }
+    }
+    /** Register (or replace) a tracked account. */
+    setAccount(name, cfg) {
+        this.accounts.set(name, {
+            aprBps: cfg.aprBps,
+            initialPrincipal: cfg.principal ?? 0,
+            startTs: cfg.startTs ?? this.clock.now(),
+            cashflows: [],
+        });
+    }
+    require(name) {
+        const state = this.accounts.get(name);
+        if (!state) {
+            throw new Error(`Unknown yield account "${name}"`);
+        }
+        return state;
+    }
+    async getYield(accountName, start, end) {
+        const state = this.require(accountName);
+        const windowStartMs = Math.max(state.startTs, start ? start.getTime() : state.startTs);
+        const windowEndMs = end ? end.getTime() : this.clock.now();
+        const apr = state.aprBps / 10000;
+        // Principal as of the window start: initial principal plus any cashflows
+        // that landed before the window.
+        let principal = state.initialPrincipal;
+        for (const cf of state.cashflows) {
+            if (cf.ts <= windowStartMs)
+                principal += cf.amount;
+        }
+        // Walk the cashflow boundaries inside the window, accruing per segment.
+        const boundaries = state.cashflows
+            .filter((cf) => cf.ts > windowStartMs && cf.ts < windowEndMs)
+            .sort((a, b) => a.ts - b.ts);
+        let totalYield = 0;
+        let segStart = windowStartMs;
+        for (const cf of boundaries) {
+            const dtSecs = (cf.ts - segStart) / 1000;
+            totalYield += principal * apr * (dtSecs / SECONDS_PER_YEAR);
+            principal += cf.amount;
+            segStart = cf.ts;
+        }
+        const tailSecs = Math.max(0, (windowEndMs - segStart) / 1000);
+        totalYield += principal * apr * (tailSecs / SECONDS_PER_YEAR);
+        return {
+            account: accountName,
+            totalYield,
+            principalAtEnd: principal,
+            aprUsed: apr,
+            accrualStart: new Date(windowStartMs),
+            accrualEnd: new Date(windowEndMs),
+        };
+    }
+    async getTotalYield(accountNames, start, end) {
+        let total = 0;
+        for (const name of accountNames) {
+            const snapshot = await this.getYield(name, start, end);
+            total += snapshot.totalYield;
+        }
+        return total;
+    }
+    async getBalance(accountName, atTime) {
+        const snapshot = await this.getYield(accountName, undefined, atTime);
+        return snapshot.principalAtEnd + snapshot.totalYield;
+    }
+    async addCashflow(params) {
+        const state = this.require(params.accountName);
+        const signed = params.cashflowType === "deposit"
+            ? Math.abs(params.amount)
+            : -Math.abs(params.amount);
+        state.cashflows.push({
+            ts: params.date ? params.date.getTime() : this.clock.now(),
+            amount: signed,
+        });
+    }
+}
+exports.MockYieldTracker = MockYieldTracker;
+//# sourceMappingURL=mockYieldTracker.js.map

package/dist/services/consensusOracle/mockYieldTracker.js.map

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

package/dist/services/consensusOracle/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Shared interfaces for the consensus-oracle service.
+ *
+ * The orchestrator ({@link ConsensusOracleService}) depends only on these
+ * interfaces, so it carries no network/RPC/protocol dependencies of its own and
+ * can be unit-tested with in-memory fakes. Concrete implementations
+ * (Jupiter price/balance feeds, the mock yield tracker, live-LP providers) are
+ * injected by the caller.
+ */
+import type { Address } from "@solana/kit";
+/** Supplies USD spot prices for a set of mints. */
+export interface PriceSource {
+    /**
+     * Fetch USD prices keyed by mint (base58). A mint with no available price is
+     * omitted from the result (callers must treat a missing entry as an error).
+     */
+    fetchUsdPrices(mints: Address[]): Promise<Record<string, number>>;
+}
+/** Supplies an owner's SPL token balances (raw base units), keyed by mint. */
+export interface WalletBalanceSource {
+    fetchBalances(owner: Address): Promise<Record<string, bigint>>;
+}
+/** A balance deployed outside vault-owned token accounts, in the mint's base units. */
+export interface ExternalPosition {
+    mint: Address;
+    amount: bigint;
+}
+/**
+ * An opaque descriptor for one external position, consumed by whichever
+ * provider recognizes its `kind`. Extra protocol-specific fields (e.g. a Kamino
+ * vault-state address) ride along as additional keys.
+ */
+export interface ExternalPositionRef {
+    kind: string;
+    mint: Address;
+    [key: string]: unknown;
+}
+export interface ExternalPositionContext {
+    vault: Address;
+    /** The vault's manager wallet (positions are usually held against it). */
+    manager: Address;
+    /** Position descriptors gathered from the target config for this vault. */
+    refs: ExternalPositionRef[];
+}
+/** Reads live balances deployed into external protocols (Kamino, Marginfi, …). */
+export interface ExternalPositionProvider {
+    positionsFor(ctx: ExternalPositionContext): Promise<ExternalPosition[]>;
+}
+/**
+ * One account's accrual snapshot. Mirrors the subset of the real yield-tracker
+ * `AccountYieldResponse` (see `bankineco-services/src/api/yieldApi.ts`) that the
+ * oracle needs. Amounts are **UI amounts** (token units, not base units), as the
+ * real service returns; callers convert with `fromUiAmount(decimals)`.
+ */
+export interface YieldAccountSnapshot {
+    account: string;
+    totalYield: number;
+    principalAtEnd: number;
+    aprUsed: number;
+    accrualStart: Date;
+    accrualEnd: Date;
+}
+/**
+ * Queries accrued yield for named accounts. Mirrors the method surface of the
+ * real HTTP client (`yieldApi.ts`) so a production implementation can be dropped
+ * in without touching {@link ConsensusOracleService}.
+ */
+export interface YieldTracker {
+    getYield(accountName: string, start?: Date, end?: Date): Promise<YieldAccountSnapshot>;
+    /** Sum of `totalYield` (UI amount) across the named accounts. */
+    getTotalYield(accountNames: string[], start?: Date, end?: Date): Promise<number>;
+    /** Current balance (principal + accrued yield), UI amount. */
+    getBalance(accountName: string, atTime?: Date): Promise<number>;
+    addCashflow(params: {
+        accountName: string;
+        amount: number;
+        date?: Date;
+        cashflowType: "deposit" | "withdraw";
+    }): Promise<void>;
+}
+/** Injectable wall clock (ms since epoch). Lets tests pin time deterministically. */
+export interface Clock {
+    now(): number;
+}
+export declare const systemClock: Clock;
+/** Per-holding config: which yield accounts and external positions feed it. */
+export interface ConsensusOracleHoldingConfig {
+    mint: Address;
+    /** Yield-tracker account names whose accrual counts toward this holding. */
+    yieldAccountNames?: string[];
+    /** External-position descriptors whose balances count toward this holding. */
+    externalPositions?: ExternalPositionRef[];
+}
+/** One vault to drive, plus optional per-holding sourcing config. */
+export interface ConsensusOracleTarget {
+    vault: Address;
+    holdings?: ConsensusOracleHoldingConfig[];
+}
+/** Injected collaborators for {@link ConsensusOracleService}. */
+export interface ConsensusOracleDeps {
+    priceSource: PriceSource;
+    balanceSource: WalletBalanceSource;
+    /** Optional; omitted ⇒ no live-LP balances are folded in. */
+    externalPositions?: ExternalPositionProvider;
+    /** Optional; omitted ⇒ no yield accrual is folded in. */
+    yieldTracker?: YieldTracker;
+    clock?: Clock;
+}
+/** Per-holding breakdown of what the service computed (and would/did push). */
+export interface HoldingUpdatePreview {
+    holdingIndex: number;
+    mint: Address;
+    decimals: number;
+    usdPrice: number;
+    /** Price in the vault's accounting unit, fixed-point (scaled by assetDecimals). */
+    price: bigint;
+    /** Manager-wallet balance of this mint (base units). */
+    walletAmount: bigint;
+    /** Summed live-LP positions for this mint (base units). */
+    lpAmount: bigint;
+    /** Accrued yield attributed to this holding (base units). */
+    yieldAmount: bigint;
+    /** Total external balance pushed = wallet + lp + yield. */
+    externalAmount: bigint;
+}
+export interface VaultOracleResult {
+    vault: Address;
+    updates: HoldingUpdatePreview[];
+    dryRun: boolean;
+    /** `update_consensus_oracle` signature (absent on dry runs / no holdings). */
+    updateSignature?: string;
+    /** `crank_nav` signature (absent on dry runs / no holdings). */
+    crankSignature?: string;
+}
+export interface RunOptions {
+    /** Compute and return the would-be updates without sending transactions. */
+    dryRun?: boolean;
+    log?: (msg: string) => void;
+}
+export interface RunSummary {
+    total: number;
+    failed: number;
+    results: VaultOracleResult[];
+    failures: {
+        vault: Address;
+        error: string;
+    }[];
+}
+/** Minimal shape of a decoded on-chain holding slot the service relies on. */
+export interface DecodedHolding {
+    mint: unknown;
+    decimals: number;
+    priceOracleType: unknown;
+    isBase: unknown;
+}
+/** Minimal shape of a decoded vault account the service relies on. */
+export interface DecodedVault {
+    config: {
+        assetDecimals: number;
+    };
+    roles: {
+        manager: unknown;
+    };
+    holdings: readonly DecodedHolding[];
+}
+/** A consensus-priced holding paired with its on-chain slot index. */
+export interface ConsensusHoldingEntry {
+    holding: DecodedHolding;
+    holdingIndex: number;
+}
+/** Pre-fetched inputs shared across per-holding update construction. */
+export interface VaultPricingInputs {
+    assetDecimals: number;
+    baseUsd: number;
+    usdPrices: Record<string, number>;
+    walletBalances: Record<string, bigint>;
+    lpByMint: Map<string, bigint>;
+    configByMint: Map<string, ConsensusOracleHoldingConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/consensusOracle/types.d.ts.map

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

package/dist/services/consensusOracle/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemClock = void 0;
+exports.systemClock = { now: () => Date.now() };
+//# sourceMappingURL=types.js.map

package/dist/services/consensusOracle/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/consensusOracle/types.ts"],"names":[],"mappings":";;;AAgHa,QAAA,WAAW,GAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./withdrawalQueueService";
+export * from "./oracleService";
+export * from "./consensusOracle";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,20 @@
+"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("./withdrawalQueueService"), exports);
+__exportStar(require("./oracleService"), exports);
+__exportStar(require("./consensusOracle"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,kDAAgC;AAChC,oDAAkC"}

package/dist/services/oracleService.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Oracle / pricing updates for a vault.
+ *
+ * Backend/cron logic shared by the oracle-updater daemon and the
+ * `update-asset-price` CLI. Two distinct mechanisms:
+ *
+ *  - **Consensus oracle** (`update_consensus_oracle`): a consensus signer reports
+ *    per-holding prices + external balances (one or more at a time); the vault
+ *    NAV is derived from the resulting holdings and settled once quorum is
+ *    reached. Used for assets whose `price_oracle_type` is `ConsensusOracle`.
+ *  - **Asset price refresh** (`update_asset_price`): permissionlessly re-prices a
+ *    holding from its configured Pyth feed or nested-vault account.
+ *
+ * Price *sourcing* (Pyth/Jupiter feeds) lives in the `oracle-service` package;
+ * this service only submits the resulting values on-chain.
+ */
+import { type Address } from "@solana/kit";
+import { Keypair } from "@solana/web3.js";
+import type { VaultClient } from "../client/client";
+type LogFn = (msg: string) => void;
+/** A holding to refresh via `update_asset_price` (Pyth / nested-vault priced). */
+export interface AssetPriceRefreshTarget {
+    mint: Address;
+    /** Pyth price-update or nested-vault account quoting this live-oracle holding. */
+    oracleAccount: Address;
+    maxAgeSecs?: bigint;
+}
+export interface AssetRefreshResult {
+    mint: Address;
+    signature?: string;
+    error?: string;
+}
+export declare class OracleService {
+    private readonly client;
+    constructor(client: VaultClient);
+    /**
+     * Record consensus price + external balance for one or more holdings, signed
+     * by a consensus signer. Holdings are addressed by slot index; set `mint` on an
+     * update only to register a new consensus holding (pass `assetMint` too). NAV is
+     * NOT settled here — call {@link crankNav} afterward.
+     */
+    updateAssetConsensusPrice(signer: Keypair, args: {
+        vault: Address;
+        updates: {
+            holdingIndex: number;
+            mint?: Address;
+            price: bigint;
+            externalAmount: bigint;
+        }[];
+        assetMint?: Address;
+        assetTokenProgram?: Address;
+    }, log?: LogFn): Promise<string>;
+    /** Settle the vault NAV from its current holdings (permissionless). */
+    crankNav(cranker: Keypair, args: {
+        vault: Address;
+        vaultTrancheState?: Address;
+    }, log?: LogFn): Promise<string>;
+    /** Re-price one live-oracle holding from its bound Pyth/nested-vault account. */
+    refreshAssetPrice(updater: Keypair, args: {
+        vault: Address;
+        mint: Address;
+        oracleAccount: Address;
+        maxAgeSecs?: bigint;
+    }, log?: LogFn): Promise<string>;
+    /**
+     * Refresh several holdings in sequence. Non-fatal: one failure is recorded
+     * and the rest still run. Returns a per-mint result list.
+     */
+    refreshAssetPrices(updater: Keypair, vault: Address, targets: AssetPriceRefreshTarget[], log?: LogFn): Promise<AssetRefreshResult[]>;
+}
+export {};
+//# sourceMappingURL=oracleService.d.ts.map

package/dist/services/oracleService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracleService.d.ts","sourceRoot":"","sources":["../../src/services/oracleService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnC,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,kFAAkF;IAClF,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIhD;;;;;OAKG;IACG,yBAAyB,CAC7B,MAAM,EAAE,OAAO,EACf,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC;YACrB,IAAI,CAAC,EAAE,OAAO,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;YACd,cAAc,EAAE,MAAM,CAAC;SACxB,EAAE,CAAC;QACJ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,EACD,GAAG,CAAC,EAAE,KAAK,GACV,OAAO,CAAC,MAAM,CAAC;IAmBlB,uEAAuE;IACjE,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,EACrD,GAAG,CAAC,EAAE,KAAK,GACV,OAAO,CAAC,MAAM,CAAC;IAalB,iFAAiF;IAC3E,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;QACd,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EACD,GAAG,CAAC,EAAE,KAAK,GACV,OAAO,CAAC,MAAM,CAAC;IAalB;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,uBAAuB,EAAE,EAClC,GAAG,CAAC,EAAE,KAAK,GACV,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAkBjC"}

package/dist/services/oracleService.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Oracle / pricing updates for a vault.
+ *
+ * Backend/cron logic shared by the oracle-updater daemon and the
+ * `update-asset-price` CLI. Two distinct mechanisms:
+ *
+ *  - **Consensus oracle** (`update_consensus_oracle`): a consensus signer reports
+ *    per-holding prices + external balances (one or more at a time); the vault
+ *    NAV is derived from the resulting holdings and settled once quorum is
+ *    reached. Used for assets whose `price_oracle_type` is `ConsensusOracle`.
+ *  - **Asset price refresh** (`update_asset_price`): permissionlessly re-prices a
+ *    holding from its configured Pyth feed or nested-vault account.
+ *
+ * Price *sourcing* (Pyth/Jupiter feeds) lives in the `oracle-service` package;
+ * this service only submits the resulting values on-chain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OracleService = void 0;
+const common_1 = require("common");
+class OracleService {
+    constructor(client) {
+        this.client = client;
+    }
+    // ── Consensus oracle pushes ───────────────────────────────────────────────
+    /**
+     * Record consensus price + external balance for one or more holdings, signed
+     * by a consensus signer. Holdings are addressed by slot index; set `mint` on an
+     * update only to register a new consensus holding (pass `assetMint` too). NAV is
+     * NOT settled here — call {@link crankNav} afterward.
+     */
+    async updateAssetConsensusPrice(signer, args, log) {
+        const plan = await this.client.tx.updateConsensusOracle.getTx({
+            signer: (0, common_1.fromWeb3Pk)(signer.publicKey),
+            vault: args.vault,
+            updates: args.updates,
+            assetMint: args.assetMint,
+            assetTokenProgram: args.assetTokenProgram,
+        });
+        const sig = await this.client.sendTransaction(signer, plan);
+        log?.(`record consensus assets ${args.vault} (${args.updates
+            .map((u) => `#${u.holdingIndex}->${u.price}/${u.externalAmount}`)
+            .join(", ")}): ${sig}`);
+        return sig;
+    }
+    // ── Permissionless NAV crank ──────────────────────────────────────────────
+    /** Settle the vault NAV from its current holdings (permissionless). */
+    async crankNav(cranker, args, log) {
+        const plan = await this.client.tx.crankNav.getTx({
+            cranker: (0, common_1.fromWeb3Pk)(cranker.publicKey),
+            vault: args.vault,
+            vaultTrancheState: args.vaultTrancheState,
+        });
+        const sig = await this.client.sendTransaction(cranker, plan);
+        log?.(`crank nav ${args.vault}: ${sig}`);
+        return sig;
+    }
+    // ── Permissionless asset-price refresh ────────────────────────────────────
+    /** Re-price one live-oracle holding from its bound Pyth/nested-vault account. */
+    async refreshAssetPrice(updater, args, log) {
+        const plan = await this.client.tx.updateAssetPrice.getTx({
+            updater: (0, common_1.fromWeb3Pk)(updater.publicKey),
+            vault: args.vault,
+            mint: args.mint,
+            oracleAccount: args.oracleAccount,
+            maxAgeSecs: args.maxAgeSecs,
+        });
+        const sig = await this.client.sendTransaction(updater, plan);
+        log?.(`refresh asset price ${args.mint}: ${sig}`);
+        return sig;
+    }
+    /**
+     * Refresh several holdings in sequence. Non-fatal: one failure is recorded
+     * and the rest still run. Returns a per-mint result list.
+     */
+    async refreshAssetPrices(updater, vault, targets, log) {
+        const results = [];
+        for (const target of targets) {
+            try {
+                const signature = await this.refreshAssetPrice(updater, { vault, ...target }, log);
+                results.push({ mint: target.mint, signature });
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                log?.(`FAILED refresh ${target.mint}: ${error}`);
+                results.push({ mint: target.mint, error });
+            }
+        }
+        return results;
+    }
+}
+exports.OracleService = OracleService;
+//# sourceMappingURL=oracleService.js.map

package/dist/services/oracleService.js.map

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

package/dist/services/withdrawalQueueService.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Junior-tranche withdrawal-queue fulfillment.
+ *
+ * Backend/cron logic — kept out of scripts so the fulfiller daemon, a Lambda,
+ * and the `fulfill-junior-withdraw` CLI can all share one implementation.
+ *
+ * A request is recorded on-chain as a `VaultWithdrawalQueue` PDA that escrows
+ * junior shares (`input_mint`) and pays out the vault asset (`output_mint`)
+ * once its lockup elapses. The program permits fulfillment when
+ * `now >= request.expiry_ts` (where `expiry_ts = request_ts + lockup`), so this
+ * service discovers queues, filters the ones whose lockup has elapsed, and
+ * submits `fulfill_junior_tranche_withdraw` for each.
+ *
+ * The queue account itself carries both mints, so fulfillment needs no extra
+ * lookups — no dependency on the (separately-maintained) tranche-state IDL.
+ */
+import { type Address } from "@solana/kit";
+import { Keypair } from "@solana/web3.js";
+import type { VaultClient } from "../client/client";
+/** Decoded, JS-friendly view of a `VaultWithdrawalQueue` account. */
+export interface WithdrawalQueueSnapshot {
+    pda: Address;
+    vault: Address;
+    owner: Address;
+    /** Rent payer for the queue PDA; refunded on fulfillment/cancel. */
+    payer: Address;
+    queueId: number;
+    /** Token escrowed in the queue (junior shares). */
+    inputMint: Address;
+    /** Token paid out on fulfillment (vault asset). */
+    outputMint: Address;
+    inputAmount: bigint;
+    requestTs: number;
+    /** Lockup expiry — fulfillable once on-chain time reaches this. */
+    expiryTs: number;
+}
+export interface FulfillSummary {
+    fulfilled: number;
+    skippedNotDue: number;
+    failed: number;
+    signatures: string[];
+}
+type LogFn = (msg: string) => void;
+export declare class WithdrawalQueueService {
+    private readonly client;
+    constructor(client: VaultClient);
+    /** Current unix time in seconds (override in tests). */
+    private now;
+    /** All withdrawal-queue accounts owned by the vault program. */
+    fetchAllQueues(): Promise<WithdrawalQueueSnapshot[]>;
+    /** Withdrawal queues for a single vault. */
+    fetchQueuesForVault(vault: Address): Promise<WithdrawalQueueSnapshot[]>;
+    /** Fetch a single queue snapshot by owner/queueId for a vault. */
+    fetchQueue(vault: Address, owner: Address, queueId: number): Promise<WithdrawalQueueSnapshot>;
+    /** True once the queue's lockup has elapsed and it can be fulfilled. */
+    isDue(queue: WithdrawalQueueSnapshot, now?: number): boolean;
+    /** Seconds until the queue becomes fulfillable (0 if already due). */
+    secondsUntilDue(queue: WithdrawalQueueSnapshot, now?: number): number;
+    getDueQueues(queues: WithdrawalQueueSnapshot[], now?: number): WithdrawalQueueSnapshot[];
+    /**
+     * Fulfill a single queued junior withdrawal. `signer` pays fees and, if
+     * needed, initializes the owner's output ATA.
+     */
+    fulfill(signer: Keypair, queue: WithdrawalQueueSnapshot): Promise<string>;
+    /**
+     * Fulfill every due queue, optionally scoped to a single vault. Non-fatal:
+     * a failure on one queue is logged and the rest still run.
+     */
+    fulfillAllDue(signer: Keypair, opts?: {
+        vault?: Address;
+        log?: LogFn;
+    }): Promise<FulfillSummary>;
+    private toSnapshot;
+}
+export {};
+//# sourceMappingURL=withdrawalQueueService.d.ts.map