perena-vault-sdk 1.0.0

package/dist/services/consensusOracle/consensusOracleService.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsensusOracleService = void 0;
+const common_1 = require("common");
+const oracleService_1 = require("../oracleService");
+const types_1 = require("./types");
+const SYSTEM_PROGRAM = "11111111111111111111111111111111";
+const CONSENSUS_ORACLE_VARIANT = "consensusoracle";
+// ── Pure helpers ───────────────────────────────────────────────────────────
+/** Name of an Anchor enum variant, e.g. `{ consensusOracle: {} }` → "consensusOracle". */
+function variantName(value) {
+    if (value && typeof value === "object")
+        return Object.keys(value)[0] ?? "";
+    return String(value ?? "");
+}
+/** Decode a PodBool (which arrives in a few shapes depending on the codec). */
+function coerceBool(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return value !== 0;
+    const record = value;
+    return Boolean(record?.value ?? record?.[0]);
+}
+/** Re-denominate a USD price into the vault's accounting unit, fixed-point. */
+function priceInAccountingUnit(usd, baseUsd, assetDecimals) {
+    return BigInt(Math.round((usd / baseUsd) * 10 ** assetDecimals));
+}
+/** Sum external positions by mint (base58 → base units). */
+function sumPositionsByMint(positions) {
+    const byMint = new Map();
+    for (const pos of positions) {
+        const key = pos.mint.toString();
+        byMint.set(key, (byMint.get(key) ?? 0n) + pos.amount);
+    }
+    return byMint;
+}
+/** Index per-holding config by mint (base58). */
+function indexConfigByMint(holdings = []) {
+    return new Map(holdings.map((cfg) => [cfg.mint.toString(), cfg]));
+}
+class ConsensusOracleService {
+    constructor(client, deps) {
+        this.client = client;
+        this.deps = deps;
+        this.oracle = new oracleService_1.OracleService(client);
+        this.clock = deps.clock ?? types_1.systemClock;
+    }
+    /** Drive one vault: source prices/balances, push consensus update, crank NAV. */
+    async runOnce(signer, target, opts = {}) {
+        const log = opts.log ?? (() => { });
+        const dryRun = opts.dryRun ?? false;
+        const vaultState = await this.fetchDecodedVault(target.vault);
+        const consensusHoldings = selectConsensusHoldings(vaultState.holdings);
+        if (consensusHoldings.length === 0) {
+            log(`vault ${target.vault}: no consensus holdings, skipping`);
+            return { vault: target.vault, updates: [], dryRun };
+        }
+        const inputs = await this.gatherPricingInputs(target, vaultState, consensusHoldings);
+        const updates = await this.buildUpdates(consensusHoldings, inputs);
+        if (dryRun) {
+            log(`vault ${target.vault}: dry run, ${updates.length} holding(s)`);
+            return { vault: target.vault, updates, dryRun: true };
+        }
+        const { updateSignature, crankSignature } = await this.settleVault(signer, target.vault, updates, log);
+        return {
+            vault: target.vault,
+            updates,
+            dryRun: false,
+            updateSignature,
+            crankSignature,
+        };
+    }
+    /**
+     * Drive several vaults in sequence. Non-fatal: a failure on one vault is
+     * recorded and the rest still run (mirrors the oracle-updater daemon).
+     */
+    async run(signer, targets, opts = {}) {
+        const log = opts.log ?? (() => { });
+        const results = [];
+        const failures = [];
+        for (const target of targets) {
+            try {
+                results.push(await this.runOnce(signer, target, opts));
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                log(`FAILED vault ${target.vault}: ${error}`);
+                failures.push({ vault: target.vault, error });
+            }
+        }
+        return {
+            total: targets.length,
+            failed: failures.length,
+            results,
+            failures,
+        };
+    }
+    /**
+     * Discover all on-chain vaults for which `signer` is a registered consensus
+     * oracle signer. Fetches every vault and its oracle account, then filters by
+     * signer membership. Returns minimal `ConsensusOracleTarget` entries (no
+     * per-holding config); callers can overlay config from `targets.ts` if needed.
+     */
+    async discoverVaultsForSigner(signer, opts = {}) {
+        const log = opts.log ?? (() => { });
+        const signerBytes = signer.publicKey.toBytes();
+        const allVaults = await this.client.account.fetchAllVaults({ fresh: true });
+        log(`Discovered ${allVaults.length} vault(s) on-chain, checking oracle membership…`);
+        const results = [];
+        await Promise.all(allVaults.map(async ({ publicKey: vault }) => {
+            try {
+                const oracle = await this.client.account.fetchVaultOracleForVault(vault);
+                const data = oracle.data;
+                if (signerInOracleData(data, signerBytes)) {
+                    log(`  ${vault}: signer is registered oracle`);
+                    results.push({ vault });
+                }
+            }
+            catch {
+                // Vault oracle may not exist yet; skip silently.
+            }
+        }));
+        return results;
+    }
+    // ── Sourcing ───────────────────────────────────────────────────────────────
+    async fetchDecodedVault(vault) {
+        return (await this.client.account.fetchVault(vault, {
+            fresh: true,
+        }));
+    }
+    /** Fetch every external input the per-holding updates draw on, in parallel-ish. */
+    async gatherPricingInputs(target, vaultState, consensusHoldings) {
+        const manager = (0, common_1.fromWeb3Pk)(vaultState.roles.manager);
+        const holdingMints = consensusHoldings.map(({ holding }) => (0, common_1.fromWeb3Pk)(holding.mint));
+        // Derive the base mint from the holding flagged isBase — the strictAssetMint
+        // field on VaultConfig is reserved/deprecated.
+        const baseHolding = vaultState.holdings.find((h) => coerceBool(h.isBase));
+        const baseMint = baseHolding
+            ? (0, common_1.fromWeb3Pk)(baseHolding.mint)
+            : holdingMints[0];
+        if (!baseMint) {
+            throw new Error(`vault has no holdings — cannot determine base asset`);
+        }
+        const mintsToPrice = holdingMints.includes(baseMint)
+            ? holdingMints
+            : [...holdingMints, baseMint];
+        const usdPrices = await this.deps.priceSource.fetchUsdPrices(mintsToPrice);
+        const baseUsd = usdPrices[baseMint.toString()];
+        if (!baseUsd) {
+            throw new Error(`no USD price for base asset ${baseMint} (cannot denominate prices)`);
+        }
+        const walletBalances = await this.deps.balanceSource.fetchBalances(manager);
+        const lpByMint = await this.fetchExternalPositions(target, manager);
+        return {
+            assetDecimals: vaultState.config.assetDecimals,
+            baseUsd,
+            usdPrices,
+            walletBalances,
+            lpByMint,
+            configByMint: indexConfigByMint(target.holdings),
+        };
+    }
+    /** Live-LP balances for the target, summed by mint (empty if no provider). */
+    async fetchExternalPositions(target, manager) {
+        if (!this.deps.externalPositions)
+            return new Map();
+        const refs = (target.holdings ?? []).flatMap((cfg) => cfg.externalPositions ?? []);
+        const positions = await this.deps.externalPositions.positionsFor({
+            vault: target.vault,
+            manager,
+            refs,
+        });
+        return sumPositionsByMint(positions);
+    }
+    /** Accrued yield (base units) attributed to a holding via its configured accounts. */
+    async resolveYieldAmount(cfg, decimals) {
+        if (!this.deps.yieldTracker || !cfg?.yieldAccountNames?.length)
+            return 0n;
+        const totalYieldUi = await this.deps.yieldTracker.getTotalYield(cfg.yieldAccountNames);
+        return totalYieldUi > 0 ? (0, common_1.fromUiAmount)(totalYieldUi, decimals) : 0n;
+    }
+    // ── Aggregation ──────────────────────────────────────────────────────────────
+    async buildUpdates(consensusHoldings, inputs) {
+        const updates = [];
+        for (const entry of consensusHoldings) {
+            updates.push(await this.buildHoldingUpdate(entry, inputs));
+        }
+        return updates;
+    }
+    async buildHoldingUpdate(entry, inputs) {
+        const { holding, holdingIndex } = entry;
+        const mint = (0, common_1.fromWeb3Pk)(holding.mint);
+        const mintKey = mint.toString();
+        const usd = coerceBool(holding.isBase)
+            ? inputs.baseUsd
+            : inputs.usdPrices[mintKey];
+        if (!usd) {
+            throw new Error(`no USD price for holding ${mint}`);
+        }
+        const price = priceInAccountingUnit(usd, inputs.baseUsd, inputs.assetDecimals);
+        const walletAmount = inputs.walletBalances[mintKey] ?? 0n;
+        const lpAmount = inputs.lpByMint.get(mintKey) ?? 0n;
+        const yieldAmount = await this.resolveYieldAmount(inputs.configByMint.get(mintKey), holding.decimals);
+        return {
+            holdingIndex,
+            mint,
+            decimals: holding.decimals,
+            usdPrice: usd,
+            price,
+            walletAmount,
+            lpAmount,
+            yieldAmount,
+            externalAmount: walletAmount + lpAmount + yieldAmount,
+        };
+    }
+    // ── Settlement ───────────────────────────────────────────────────────────────
+    /** Push the consensus report for all holdings, then settle NAV. */
+    async settleVault(signer, vault, updates, log) {
+        const updateSignature = await this.oracle.updateAssetConsensusPrice(signer, {
+            vault,
+            updates: updates.map((u) => ({
+                holdingIndex: u.holdingIndex,
+                price: u.price,
+                externalAmount: u.externalAmount,
+            })),
+        }, log);
+        const crankSignature = await this.oracle.crankNav(signer, { vault }, log);
+        return { updateSignature, crankSignature };
+    }
+}
+exports.ConsensusOracleService = ConsensusOracleService;
+// ConsensusOracleData byte layout (C repr, bytemuck, within VaultOracle.data):
+//   [0..8)   settled_nav
+//   [8..16)  settled_nav_ts
+//   [16..24) previous_settled_nav
+//   [24..32) previous_settled_nav_ts
+//   [32..40) staleness_threshold_secs
+//   [40..)   entries[0..4]: each entry is 272 bytes (signer:32 + ts:8 + prices:96 + externals:96 + pad:40)
+const ENTRY_SIZE = 272;
+const ENTRIES_OFFSET = 40;
+const MAX_CONSENSUS_SIGNERS = 4;
+function signerInOracleData(data, signerBytes) {
+    const ZERO_PUBKEY = new Uint8Array(32);
+    for (let i = 0; i < MAX_CONSENSUS_SIGNERS; i++) {
+        const off = ENTRIES_OFFSET + i * ENTRY_SIZE;
+        const slice = data.slice(off, off + 32);
+        if (slice.length < 32)
+            break;
+        const bytes = new Uint8Array(slice);
+        if (bytes.every((b) => b === 0) ||
+            ZERO_PUBKEY.every((_, j) => bytes[j] === ZERO_PUBKEY[j]))
+            continue;
+        if (signerBytes.every((b, j) => b === bytes[j]))
+            return true;
+    }
+    return false;
+}
+/** Consensus-priced, non-empty holdings, paired with their on-chain slot index. */
+function selectConsensusHoldings(holdings) {
+    return holdings
+        .map((holding, holdingIndex) => ({ holding, holdingIndex }))
+        .filter(({ holding }) => {
+        const mint = (0, common_1.fromWeb3Pk)(holding.mint);
+        return (mint !== SYSTEM_PROGRAM &&
+            variantName(holding.priceOracleType).toLowerCase() ===
+                CONSENSUS_ORACLE_VARIANT);
+    });
+}
+//# sourceMappingURL=consensusOracleService.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Aggregation of {@link ExternalPositionProvider}s plus a trivial static
+ * provider. Concrete live-LP providers (Kamino, Marginfi) wrap protocol SDKs and
+ * live in the scripts layer to keep `vault_sdk`'s runtime dependencies lean; the
+ * service only ever sees the {@link ExternalPositionProvider} interface.
+ */
+import type { ExternalPosition, ExternalPositionContext, ExternalPositionProvider } from "./types";
+/**
+ * Fans a context out to every registered provider and concatenates the results.
+ * A provider that throws is logged and contributes no positions, so one bad
+ * protocol read never blocks the rest.
+ */
+export declare class ExternalPositionRegistry implements ExternalPositionProvider {
+    private readonly log;
+    private readonly providers;
+    constructor(providers?: ExternalPositionProvider[], log?: (msg: string) => void);
+    add(provider: ExternalPositionProvider): this;
+    positionsFor(ctx: ExternalPositionContext): Promise<ExternalPosition[]>;
+}
+/** Returns a fixed list of positions; handy for tests and dry runs. */
+export declare class StaticPositionProvider implements ExternalPositionProvider {
+    private readonly positions;
+    constructor(positions: ExternalPosition[]);
+    positionsFor(): Promise<ExternalPosition[]>;
+}
+//# sourceMappingURL=externalPositions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalPositions.d.ts","sourceRoot":"","sources":["../../../src/services/consensusOracle/externalPositions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,wBAAwB;IAKrE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;gBAGrD,SAAS,GAAE,wBAAwB,EAAO,EACzB,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAe;IAKxD,GAAG,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAKvC,YAAY,CAChB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAe/B;AAED,uEAAuE;AACvE,qBAAa,sBAAuB,YAAW,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,gBAAgB,EAAE;IAEpD,YAAY,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAGlD"}

package/dist/services/consensusOracle/externalPositions.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticPositionProvider = exports.ExternalPositionRegistry = void 0;
+/**
+ * Fans a context out to every registered provider and concatenates the results.
+ * A provider that throws is logged and contributes no positions, so one bad
+ * protocol read never blocks the rest.
+ */
+class ExternalPositionRegistry {
+    constructor(providers = [], log = () => { }) {
+        this.log = log;
+        this.providers = [...providers];
+    }
+    add(provider) {
+        this.providers.push(provider);
+        return this;
+    }
+    async positionsFor(ctx) {
+        const results = await Promise.all(this.providers.map((provider) => provider.positionsFor(ctx).catch((err) => {
+            this.log(`external-position provider failed for ${ctx.vault}: ${err instanceof Error ? err.message : String(err)}`);
+            return [];
+        })));
+        return results.flat();
+    }
+}
+exports.ExternalPositionRegistry = ExternalPositionRegistry;
+/** Returns a fixed list of positions; handy for tests and dry runs. */
+class StaticPositionProvider {
+    constructor(positions) {
+        this.positions = positions;
+    }
+    async positionsFor() {
+        return this.positions;
+    }
+}
+exports.StaticPositionProvider = StaticPositionProvider;
+//# sourceMappingURL=externalPositions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"externalPositions.js","sourceRoot":"","sources":["../../../src/services/consensusOracle/externalPositions.ts"],"names":[],"mappings":";;;AAYA;;;;GAIG;AACH,MAAa,wBAAwB;IAGnC,YACE,YAAwC,EAAE,EACzB,MAA6B,GAAG,EAAE,GAAE,CAAC;QAArC,QAAG,GAAH,GAAG,CAAkC;QAEtD,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,QAAkC;QACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,GAA4B;QAE5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC9B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACvC,IAAI,CAAC,GAAG,CACN,yCAAyC,GAAG,CAAC,KAAK,KAChD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;YACF,OAAO,EAAwB,CAAC;QAClC,CAAC,CAAC,CACH,CACF,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF;AAhCD,4DAgCC;AAED,uEAAuE;AACvE,MAAa,sBAAsB;IACjC,YAA6B,SAA6B;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAE9D,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAND,wDAMC"}

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

@@ -0,0 +1,7 @@
+export * from "./types";
+export * from "./jupiterPriceSource";
+export * from "./jupiterBalanceSource";
+export * from "./externalPositions";
+export * from "./mockYieldTracker";
+export * from "./consensusOracleService";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/consensusOracle/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/services/consensusOracle/index.js

@@ -0,0 +1,23 @@
+"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("./types"), exports);
+__exportStar(require("./jupiterPriceSource"), exports);
+__exportStar(require("./jupiterBalanceSource"), exports);
+__exportStar(require("./externalPositions"), exports);
+__exportStar(require("./mockYieldTracker"), exports);
+__exportStar(require("./consensusOracleService"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/consensusOracle/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,uDAAqC;AACrC,yDAAuC;AACvC,sDAAoC;AACpC,qDAAmC;AACnC,2DAAyC"}

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

@@ -0,0 +1,34 @@
+/**
+ * {@link WalletBalanceSource} backed by the Jupiter "portfolio" / Ultra balances
+ * API, with an on-chain RPC fallback.
+ *
+ *   Primary:  GET https://lite-api.jup.ag/ultra/v1/balances/{owner}
+ *             → { "<mint>": { amount, uiAmount, slot, isFrozen }, "SOL": {…} }
+ *   Fallback: `getParsedTokenAccountsByOwner` over the SPL Token and Token-2022
+ *             programs, summed per mint.
+ *
+ * `amount` from Jupiter is already in raw base units, matching the on-chain
+ * `external_amount` unit, so no decimal conversion is applied here.
+ */
+import type { Address } from "@solana/kit";
+import { Connection } from "@solana/web3.js";
+import type { WalletBalanceSource } from "./types";
+export interface JupiterBalanceSourceOptions {
+    baseUrl?: string;
+    fetchFn?: typeof fetch;
+    /** Skip the Jupiter call and read straight from RPC. */
+    rpcOnly?: boolean;
+    log?: (msg: string) => void;
+}
+export declare class JupiterBalanceSource implements WalletBalanceSource {
+    private readonly connection;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    private readonly rpcOnly;
+    private readonly log;
+    constructor(connection: Connection, opts?: JupiterBalanceSourceOptions);
+    fetchBalances(owner: Address): Promise<Record<string, bigint>>;
+    private fetchFromJupiter;
+    private fetchFromRpc;
+}
+//# sourceMappingURL=jupiterBalanceSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jupiterBalanceSource.d.ts","sourceRoot":"","sources":["../../../src/services/consensusOracle/jupiterBalanceSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAa,MAAM,iBAAiB,CAAC;AAIxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,qBAAa,oBAAqB,YAAW,mBAAmB;IAO5D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;gBAGzB,UAAU,EAAE,UAAU,EACvC,IAAI,GAAE,2BAAgC;IAQlC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAgBtD,gBAAgB;YA+BhB,YAAY;CAuB3B"}

package/dist/services/consensusOracle/jupiterBalanceSource.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JupiterBalanceSource = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const common_1 = require("common");
+const DEFAULT_BASE_URL = "https://lite-api.jup.ag/ultra/v1/balances";
+class JupiterBalanceSource {
+    constructor(connection, opts = {}) {
+        this.connection = connection;
+        this.baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
+        this.fetchFn = opts.fetchFn ?? fetch;
+        this.rpcOnly = opts.rpcOnly ?? false;
+        this.log = opts.log ?? (() => { });
+    }
+    async fetchBalances(owner) {
+        if (!this.rpcOnly) {
+            try {
+                const fromJup = await this.fetchFromJupiter(owner);
+                if (Object.keys(fromJup).length > 0)
+                    return fromJup;
+            }
+            catch (err) {
+                this.log(`Jupiter balances failed for ${owner}, falling back to RPC: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return this.fetchFromRpc(owner);
+    }
+    async fetchFromJupiter(owner) {
+        const res = await this.fetchFn(`${this.baseUrl}/${owner.toString()}`);
+        if (!res.ok) {
+            throw new Error(`Jupiter balances API ${res.status}`);
+        }
+        const body = (await res.json());
+        if (!body || typeof body !== "object") {
+            throw new Error("Jupiter balances API returned a non-object body");
+        }
+        const out = {};
+        for (const [key, value] of Object.entries(body)) {
+            // "SOL" is native lamports, not an SPL holding — skip it.
+            if (key === "SOL")
+                continue;
+            if (!value || typeof value !== "object")
+                continue;
+            const amount = value.amount;
+            if (amount === undefined || amount === null)
+                continue;
+            try {
+                const raw = BigInt(String(amount));
+                if (raw > 0n)
+                    out[key] = raw;
+            }
+            catch {
+                // Non-integer amount — ignore this entry.
+            }
+        }
+        return out;
+    }
+    async fetchFromRpc(owner) {
+        const ownerPk = (0, common_1.asWeb3PublicKey)(owner);
+        const out = {};
+        for (const programId of [spl_token_1.TOKEN_PROGRAM_ID, spl_token_1.TOKEN_2022_PROGRAM_ID]) {
+            const { value } = await this.connection.getParsedTokenAccountsByOwner(ownerPk, { programId: new web3_js_1.PublicKey(programId) });
+            for (const { account } of value) {
+                const info = account.data.parsed
+                    ?.info;
+                const mint = info?.mint;
+                const amount = info?.tokenAmount?.amount;
+                if (!mint || amount === undefined)
+                    continue;
+                const raw = BigInt(amount);
+                if (raw > 0n)
+                    out[mint] = (out[mint] ?? 0n) + raw;
+            }
+        }
+        return out;
+    }
+}
+exports.JupiterBalanceSource = JupiterBalanceSource;
+//# sourceMappingURL=jupiterBalanceSource.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * {@link PriceSource} backed by the Jupiter price API.
+ *
+ * Mirrors the existing feed in `oracle-service/src/feeds/jupiter.ts`
+ * (`GET /price/v3`, batched at 50 ids, small retry, reads `usdPrice`) but is
+ * self-contained so `vault_sdk` keeps its lean dependency set.
+ */
+import type { Address } from "@solana/kit";
+import type { PriceSource } from "./types";
+export interface JupiterPriceSourceOptions {
+    /** Override the price endpoint (e.g. the keyed `api.jup.ag` host). */
+    baseUrl?: string;
+    /** Retry attempts per batch request. */
+    retries?: number;
+    /** Injectable fetch (for tests); defaults to global `fetch`. */
+    fetchFn?: typeof fetch;
+}
+export declare class JupiterPriceSource implements PriceSource {
+    private readonly baseUrl;
+    private readonly retries;
+    private readonly fetchFn;
+    constructor(opts?: JupiterPriceSourceOptions);
+    fetchUsdPrices(mints: Address[]): Promise<Record<string, number>>;
+}
+//# sourceMappingURL=jupiterPriceSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jupiterPriceSource.d.ts","sourceRoot":"","sources":["../../../src/services/consensusOracle/jupiterPriceSource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAM3C,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAyBD,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,IAAI,GAAE,yBAA8B;IAM1C,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAiCxE"}

package/dist/services/consensusOracle/jupiterPriceSource.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JupiterPriceSource = void 0;
+const DEFAULT_BASE_URL = "https://lite-api.jup.ag/price/v3";
+const BATCH_SIZE = 50;
+const DEFAULT_RETRIES = 6;
+function chunk(items, size) {
+    const out = [];
+    for (let i = 0; i < items.length; i += size) {
+        out.push(items.slice(i, i + size));
+    }
+    return out;
+}
+async function withRetry(fn, attempts) {
+    let lastErr;
+    for (let i = 0; i < attempts; i += 1) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+class JupiterPriceSource {
+    constructor(opts = {}) {
+        this.baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
+        this.retries = opts.retries ?? DEFAULT_RETRIES;
+        this.fetchFn = opts.fetchFn ?? fetch;
+    }
+    async fetchUsdPrices(mints) {
+        const unique = [...new Set(mints.map((m) => m.toString()))];
+        if (unique.length === 0)
+            return {};
+        const batches = chunk(unique, BATCH_SIZE);
+        const responses = await Promise.all(batches.map((batch) => withRetry(async () => {
+            const url = `${this.baseUrl}?ids=${batch.join(",")}`;
+            const res = await this.fetchFn(url);
+            if (!res.ok) {
+                throw new Error(`Jupiter price API ${res.status} for ${url}`);
+            }
+            const body = (await res.json());
+            if (!body || typeof body !== "object") {
+                throw new Error("Jupiter price API returned a non-object body");
+            }
+            return body;
+        }, this.retries)));
+        const merged = Object.assign({}, ...responses);
+        const prices = {};
+        for (const mint of unique) {
+            const entry = merged[mint];
+            if (entry && typeof entry === "object" && "usdPrice" in entry) {
+                const usd = Number(entry.usdPrice);
+                if (Number.isFinite(usd) && usd > 0)
+                    prices[mint] = usd;
+            }
+        }
+        return prices;
+    }
+}
+exports.JupiterPriceSource = JupiterPriceSource;
+//# sourceMappingURL=jupiterPriceSource.js.map

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

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