perk-protocol 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { PerkClient } from "./client";
+export type { PerkClientConfig } from "./client";
+export { PerkCranker } from "./cranker";
+export type { CrankerConfig, CrankerMetrics } from "./cranker";
+export { PerkOracleCranker } from "./oracle-cranker";
+export type { OracleCrankerConfig, OracleCrankerMetrics } from "./oracle-cranker";
+export { findProtocolAddress, findMarketAddress, findPositionAddress, findVaultAddress, findTriggerOrderAddress, findPerkOracleAddress, } from "./pda";
+export { calculateMarkPrice, estimateExecutionPrice, calculateSlippageBps, effectivePositionQ, calculateNotional, initialMarginBps, marginRatio, isLiquidatable, estimateLiquidationPrice, calculateFee, fundingRateAnnualized, warmupProgress, haircutRatio, priceToNumber, numberToPrice, amountToNumber, accountEquity, calculateNotionalBN, isAboveMaintenanceMargin, } from "./math";
+export { PERK_PROGRAM_ID, PROTOCOL_SEED, MARKET_SEED, POSITION_SEED, VAULT_SEED, TRIGGER_SEED, MIN_LEVERAGE, MAX_LEVERAGE, LEVERAGE_SCALE, MIN_TRADING_FEE_BPS, MAX_TRADING_FEE_BPS, DEFAULT_TRADING_FEE_BPS, LIQUIDATION_FEE_BPS, MAINTENANCE_MARGIN_BPS, CREATOR_FEE_SHARE_BPS, PRICE_SCALE, POS_SCALE, ADL_ONE, K_SCALE, MIN_INITIAL_K, DEFAULT_MARKET_CREATION_FEE, FUNDING_RATE_PRECISION, MAX_FUNDING_ITERATIONS, FUNDING_RATE_CAP_BPS, PEG_UPDATE_COOLDOWN_SLOTS, AMM_PEG_THRESHOLD_BPS, ORACLE_STALENESS_SECONDS, INSURANCE_EPOCH_SECONDS, INSURANCE_EPOCH_CAP_BPS, WARMUP_PERIOD_SLOTS, MAX_TRIGGER_ORDERS, BPS_DENOMINATOR, PERK_ORACLE_SEED, MIN_ORACLE_STALENESS_SECONDS, MAX_ORACLE_STALENESS_SECONDS, MAX_MIN_SOURCES, MAX_ORACLE_PRICE, MIN_PRICE_CHANGE_BPS, MAX_PRICE_CHANGE_BPS, MIN_CIRCUIT_BREAKER_BPS, MAX_CIRCUIT_BREAKER_BPS, CIRCUIT_BREAKER_WINDOW_SLOTS, WINDOW_BAND_MULTIPLIER, PYTH_PROGRAM_ID, PYTH_SOL_USD_FEED, MAX_FUNDING_DT, MIN_REMAINING_POSITION_SIZE, MIN_RECLAIM_DELAY_SLOTS, DUST_THRESHOLD, MIN_NONZERO_MM_REQ, MIN_NONZERO_IM_REQ, LIQUIDATOR_SHARE_BPS, TRIGGER_EXECUTION_FEE_BPS, MIN_DEPOSIT_AMOUNT, MIN_A_SIDE, MAX_TRIGGER_ORDER_AGE_SECONDS, } from "./constants";
+export { Side, OracleSource, SideState, TriggerOrderType, } from "./types";
+export type { ProtocolAccount, MarketAccount, UserPositionAccount, TriggerOrderAccount, PerkOracleAccount, CreateMarketParams, AdminUpdateMarketParams, TriggerOrderParams, InitPerkOracleParams, UpdatePerkOracleParams, UpdateOracleConfigParams, SetFallbackOracleParams, PositionInfo, MarketInfo, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,OAAO,EACP,OAAO,EACP,aAAa,EACb,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,UAAU,EACV,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,101 @@
+"use strict";
+// @perk/sdk — TypeScript SDK for the Perk perpetual futures protocol on Solana
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FUNDING_RATE_PRECISION = exports.DEFAULT_MARKET_CREATION_FEE = exports.MIN_INITIAL_K = exports.K_SCALE = exports.ADL_ONE = exports.POS_SCALE = exports.PRICE_SCALE = exports.CREATOR_FEE_SHARE_BPS = exports.MAINTENANCE_MARGIN_BPS = exports.LIQUIDATION_FEE_BPS = exports.DEFAULT_TRADING_FEE_BPS = exports.MAX_TRADING_FEE_BPS = exports.MIN_TRADING_FEE_BPS = exports.LEVERAGE_SCALE = exports.MAX_LEVERAGE = exports.MIN_LEVERAGE = exports.TRIGGER_SEED = exports.VAULT_SEED = exports.POSITION_SEED = exports.MARKET_SEED = exports.PROTOCOL_SEED = exports.PERK_PROGRAM_ID = exports.isAboveMaintenanceMargin = exports.calculateNotionalBN = exports.accountEquity = exports.amountToNumber = exports.numberToPrice = exports.priceToNumber = exports.haircutRatio = exports.warmupProgress = exports.fundingRateAnnualized = exports.calculateFee = exports.estimateLiquidationPrice = exports.isLiquidatable = exports.marginRatio = exports.initialMarginBps = exports.calculateNotional = exports.effectivePositionQ = exports.calculateSlippageBps = exports.estimateExecutionPrice = exports.calculateMarkPrice = exports.findPerkOracleAddress = exports.findTriggerOrderAddress = exports.findVaultAddress = exports.findPositionAddress = exports.findMarketAddress = exports.findProtocolAddress = exports.PerkOracleCranker = exports.PerkCranker = exports.PerkClient = void 0;
+exports.TriggerOrderType = exports.SideState = exports.OracleSource = exports.Side = exports.MAX_TRIGGER_ORDER_AGE_SECONDS = exports.MIN_A_SIDE = exports.MIN_DEPOSIT_AMOUNT = exports.TRIGGER_EXECUTION_FEE_BPS = exports.LIQUIDATOR_SHARE_BPS = exports.MIN_NONZERO_IM_REQ = exports.MIN_NONZERO_MM_REQ = exports.DUST_THRESHOLD = exports.MIN_RECLAIM_DELAY_SLOTS = exports.MIN_REMAINING_POSITION_SIZE = exports.MAX_FUNDING_DT = exports.PYTH_SOL_USD_FEED = exports.PYTH_PROGRAM_ID = exports.WINDOW_BAND_MULTIPLIER = exports.CIRCUIT_BREAKER_WINDOW_SLOTS = exports.MAX_CIRCUIT_BREAKER_BPS = exports.MIN_CIRCUIT_BREAKER_BPS = exports.MAX_PRICE_CHANGE_BPS = exports.MIN_PRICE_CHANGE_BPS = exports.MAX_ORACLE_PRICE = exports.MAX_MIN_SOURCES = exports.MAX_ORACLE_STALENESS_SECONDS = exports.MIN_ORACLE_STALENESS_SECONDS = exports.PERK_ORACLE_SEED = exports.BPS_DENOMINATOR = exports.MAX_TRIGGER_ORDERS = exports.WARMUP_PERIOD_SLOTS = exports.INSURANCE_EPOCH_CAP_BPS = exports.INSURANCE_EPOCH_SECONDS = exports.ORACLE_STALENESS_SECONDS = exports.AMM_PEG_THRESHOLD_BPS = exports.PEG_UPDATE_COOLDOWN_SLOTS = exports.FUNDING_RATE_CAP_BPS = exports.MAX_FUNDING_ITERATIONS = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "PerkClient", { enumerable: true, get: function () { return client_1.PerkClient; } });
+var cranker_1 = require("./cranker");
+Object.defineProperty(exports, "PerkCranker", { enumerable: true, get: function () { return cranker_1.PerkCranker; } });
+var oracle_cranker_1 = require("./oracle-cranker");
+Object.defineProperty(exports, "PerkOracleCranker", { enumerable: true, get: function () { return oracle_cranker_1.PerkOracleCranker; } });
+var pda_1 = require("./pda");
+Object.defineProperty(exports, "findProtocolAddress", { enumerable: true, get: function () { return pda_1.findProtocolAddress; } });
+Object.defineProperty(exports, "findMarketAddress", { enumerable: true, get: function () { return pda_1.findMarketAddress; } });
+Object.defineProperty(exports, "findPositionAddress", { enumerable: true, get: function () { return pda_1.findPositionAddress; } });
+Object.defineProperty(exports, "findVaultAddress", { enumerable: true, get: function () { return pda_1.findVaultAddress; } });
+Object.defineProperty(exports, "findTriggerOrderAddress", { enumerable: true, get: function () { return pda_1.findTriggerOrderAddress; } });
+Object.defineProperty(exports, "findPerkOracleAddress", { enumerable: true, get: function () { return pda_1.findPerkOracleAddress; } });
+var math_1 = require("./math");
+Object.defineProperty(exports, "calculateMarkPrice", { enumerable: true, get: function () { return math_1.calculateMarkPrice; } });
+Object.defineProperty(exports, "estimateExecutionPrice", { enumerable: true, get: function () { return math_1.estimateExecutionPrice; } });
+Object.defineProperty(exports, "calculateSlippageBps", { enumerable: true, get: function () { return math_1.calculateSlippageBps; } });
+Object.defineProperty(exports, "effectivePositionQ", { enumerable: true, get: function () { return math_1.effectivePositionQ; } });
+Object.defineProperty(exports, "calculateNotional", { enumerable: true, get: function () { return math_1.calculateNotional; } });
+Object.defineProperty(exports, "initialMarginBps", { enumerable: true, get: function () { return math_1.initialMarginBps; } });
+Object.defineProperty(exports, "marginRatio", { enumerable: true, get: function () { return math_1.marginRatio; } });
+Object.defineProperty(exports, "isLiquidatable", { enumerable: true, get: function () { return math_1.isLiquidatable; } });
+Object.defineProperty(exports, "estimateLiquidationPrice", { enumerable: true, get: function () { return math_1.estimateLiquidationPrice; } });
+Object.defineProperty(exports, "calculateFee", { enumerable: true, get: function () { return math_1.calculateFee; } });
+Object.defineProperty(exports, "fundingRateAnnualized", { enumerable: true, get: function () { return math_1.fundingRateAnnualized; } });
+Object.defineProperty(exports, "warmupProgress", { enumerable: true, get: function () { return math_1.warmupProgress; } });
+Object.defineProperty(exports, "haircutRatio", { enumerable: true, get: function () { return math_1.haircutRatio; } });
+Object.defineProperty(exports, "priceToNumber", { enumerable: true, get: function () { return math_1.priceToNumber; } });
+Object.defineProperty(exports, "numberToPrice", { enumerable: true, get: function () { return math_1.numberToPrice; } });
+Object.defineProperty(exports, "amountToNumber", { enumerable: true, get: function () { return math_1.amountToNumber; } });
+Object.defineProperty(exports, "accountEquity", { enumerable: true, get: function () { return math_1.accountEquity; } });
+Object.defineProperty(exports, "calculateNotionalBN", { enumerable: true, get: function () { return math_1.calculateNotionalBN; } });
+Object.defineProperty(exports, "isAboveMaintenanceMargin", { enumerable: true, get: function () { return math_1.isAboveMaintenanceMargin; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "PERK_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.PERK_PROGRAM_ID; } });
+Object.defineProperty(exports, "PROTOCOL_SEED", { enumerable: true, get: function () { return constants_1.PROTOCOL_SEED; } });
+Object.defineProperty(exports, "MARKET_SEED", { enumerable: true, get: function () { return constants_1.MARKET_SEED; } });
+Object.defineProperty(exports, "POSITION_SEED", { enumerable: true, get: function () { return constants_1.POSITION_SEED; } });
+Object.defineProperty(exports, "VAULT_SEED", { enumerable: true, get: function () { return constants_1.VAULT_SEED; } });
+Object.defineProperty(exports, "TRIGGER_SEED", { enumerable: true, get: function () { return constants_1.TRIGGER_SEED; } });
+Object.defineProperty(exports, "MIN_LEVERAGE", { enumerable: true, get: function () { return constants_1.MIN_LEVERAGE; } });
+Object.defineProperty(exports, "MAX_LEVERAGE", { enumerable: true, get: function () { return constants_1.MAX_LEVERAGE; } });
+Object.defineProperty(exports, "LEVERAGE_SCALE", { enumerable: true, get: function () { return constants_1.LEVERAGE_SCALE; } });
+Object.defineProperty(exports, "MIN_TRADING_FEE_BPS", { enumerable: true, get: function () { return constants_1.MIN_TRADING_FEE_BPS; } });
+Object.defineProperty(exports, "MAX_TRADING_FEE_BPS", { enumerable: true, get: function () { return constants_1.MAX_TRADING_FEE_BPS; } });
+Object.defineProperty(exports, "DEFAULT_TRADING_FEE_BPS", { enumerable: true, get: function () { return constants_1.DEFAULT_TRADING_FEE_BPS; } });
+Object.defineProperty(exports, "LIQUIDATION_FEE_BPS", { enumerable: true, get: function () { return constants_1.LIQUIDATION_FEE_BPS; } });
+Object.defineProperty(exports, "MAINTENANCE_MARGIN_BPS", { enumerable: true, get: function () { return constants_1.MAINTENANCE_MARGIN_BPS; } });
+Object.defineProperty(exports, "CREATOR_FEE_SHARE_BPS", { enumerable: true, get: function () { return constants_1.CREATOR_FEE_SHARE_BPS; } });
+Object.defineProperty(exports, "PRICE_SCALE", { enumerable: true, get: function () { return constants_1.PRICE_SCALE; } });
+Object.defineProperty(exports, "POS_SCALE", { enumerable: true, get: function () { return constants_1.POS_SCALE; } });
+Object.defineProperty(exports, "ADL_ONE", { enumerable: true, get: function () { return constants_1.ADL_ONE; } });
+Object.defineProperty(exports, "K_SCALE", { enumerable: true, get: function () { return constants_1.K_SCALE; } });
+Object.defineProperty(exports, "MIN_INITIAL_K", { enumerable: true, get: function () { return constants_1.MIN_INITIAL_K; } });
+Object.defineProperty(exports, "DEFAULT_MARKET_CREATION_FEE", { enumerable: true, get: function () { return constants_1.DEFAULT_MARKET_CREATION_FEE; } });
+Object.defineProperty(exports, "FUNDING_RATE_PRECISION", { enumerable: true, get: function () { return constants_1.FUNDING_RATE_PRECISION; } });
+Object.defineProperty(exports, "MAX_FUNDING_ITERATIONS", { enumerable: true, get: function () { return constants_1.MAX_FUNDING_ITERATIONS; } });
+Object.defineProperty(exports, "FUNDING_RATE_CAP_BPS", { enumerable: true, get: function () { return constants_1.FUNDING_RATE_CAP_BPS; } });
+Object.defineProperty(exports, "PEG_UPDATE_COOLDOWN_SLOTS", { enumerable: true, get: function () { return constants_1.PEG_UPDATE_COOLDOWN_SLOTS; } });
+Object.defineProperty(exports, "AMM_PEG_THRESHOLD_BPS", { enumerable: true, get: function () { return constants_1.AMM_PEG_THRESHOLD_BPS; } });
+Object.defineProperty(exports, "ORACLE_STALENESS_SECONDS", { enumerable: true, get: function () { return constants_1.ORACLE_STALENESS_SECONDS; } });
+Object.defineProperty(exports, "INSURANCE_EPOCH_SECONDS", { enumerable: true, get: function () { return constants_1.INSURANCE_EPOCH_SECONDS; } });
+Object.defineProperty(exports, "INSURANCE_EPOCH_CAP_BPS", { enumerable: true, get: function () { return constants_1.INSURANCE_EPOCH_CAP_BPS; } });
+Object.defineProperty(exports, "WARMUP_PERIOD_SLOTS", { enumerable: true, get: function () { return constants_1.WARMUP_PERIOD_SLOTS; } });
+Object.defineProperty(exports, "MAX_TRIGGER_ORDERS", { enumerable: true, get: function () { return constants_1.MAX_TRIGGER_ORDERS; } });
+Object.defineProperty(exports, "BPS_DENOMINATOR", { enumerable: true, get: function () { return constants_1.BPS_DENOMINATOR; } });
+Object.defineProperty(exports, "PERK_ORACLE_SEED", { enumerable: true, get: function () { return constants_1.PERK_ORACLE_SEED; } });
+Object.defineProperty(exports, "MIN_ORACLE_STALENESS_SECONDS", { enumerable: true, get: function () { return constants_1.MIN_ORACLE_STALENESS_SECONDS; } });
+Object.defineProperty(exports, "MAX_ORACLE_STALENESS_SECONDS", { enumerable: true, get: function () { return constants_1.MAX_ORACLE_STALENESS_SECONDS; } });
+Object.defineProperty(exports, "MAX_MIN_SOURCES", { enumerable: true, get: function () { return constants_1.MAX_MIN_SOURCES; } });
+Object.defineProperty(exports, "MAX_ORACLE_PRICE", { enumerable: true, get: function () { return constants_1.MAX_ORACLE_PRICE; } });
+Object.defineProperty(exports, "MIN_PRICE_CHANGE_BPS", { enumerable: true, get: function () { return constants_1.MIN_PRICE_CHANGE_BPS; } });
+Object.defineProperty(exports, "MAX_PRICE_CHANGE_BPS", { enumerable: true, get: function () { return constants_1.MAX_PRICE_CHANGE_BPS; } });
+Object.defineProperty(exports, "MIN_CIRCUIT_BREAKER_BPS", { enumerable: true, get: function () { return constants_1.MIN_CIRCUIT_BREAKER_BPS; } });
+Object.defineProperty(exports, "MAX_CIRCUIT_BREAKER_BPS", { enumerable: true, get: function () { return constants_1.MAX_CIRCUIT_BREAKER_BPS; } });
+Object.defineProperty(exports, "CIRCUIT_BREAKER_WINDOW_SLOTS", { enumerable: true, get: function () { return constants_1.CIRCUIT_BREAKER_WINDOW_SLOTS; } });
+Object.defineProperty(exports, "WINDOW_BAND_MULTIPLIER", { enumerable: true, get: function () { return constants_1.WINDOW_BAND_MULTIPLIER; } });
+Object.defineProperty(exports, "PYTH_PROGRAM_ID", { enumerable: true, get: function () { return constants_1.PYTH_PROGRAM_ID; } });
+Object.defineProperty(exports, "PYTH_SOL_USD_FEED", { enumerable: true, get: function () { return constants_1.PYTH_SOL_USD_FEED; } });
+Object.defineProperty(exports, "MAX_FUNDING_DT", { enumerable: true, get: function () { return constants_1.MAX_FUNDING_DT; } });
+Object.defineProperty(exports, "MIN_REMAINING_POSITION_SIZE", { enumerable: true, get: function () { return constants_1.MIN_REMAINING_POSITION_SIZE; } });
+Object.defineProperty(exports, "MIN_RECLAIM_DELAY_SLOTS", { enumerable: true, get: function () { return constants_1.MIN_RECLAIM_DELAY_SLOTS; } });
+Object.defineProperty(exports, "DUST_THRESHOLD", { enumerable: true, get: function () { return constants_1.DUST_THRESHOLD; } });
+Object.defineProperty(exports, "MIN_NONZERO_MM_REQ", { enumerable: true, get: function () { return constants_1.MIN_NONZERO_MM_REQ; } });
+Object.defineProperty(exports, "MIN_NONZERO_IM_REQ", { enumerable: true, get: function () { return constants_1.MIN_NONZERO_IM_REQ; } });
+Object.defineProperty(exports, "LIQUIDATOR_SHARE_BPS", { enumerable: true, get: function () { return constants_1.LIQUIDATOR_SHARE_BPS; } });
+Object.defineProperty(exports, "TRIGGER_EXECUTION_FEE_BPS", { enumerable: true, get: function () { return constants_1.TRIGGER_EXECUTION_FEE_BPS; } });
+Object.defineProperty(exports, "MIN_DEPOSIT_AMOUNT", { enumerable: true, get: function () { return constants_1.MIN_DEPOSIT_AMOUNT; } });
+Object.defineProperty(exports, "MIN_A_SIDE", { enumerable: true, get: function () { return constants_1.MIN_A_SIDE; } });
+Object.defineProperty(exports, "MAX_TRIGGER_ORDER_AGE_SECONDS", { enumerable: true, get: function () { return constants_1.MAX_TRIGGER_ORDER_AGE_SECONDS; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return types_1.Side; } });
+Object.defineProperty(exports, "OracleSource", { enumerable: true, get: function () { return types_1.OracleSource; } });
+Object.defineProperty(exports, "SideState", { enumerable: true, get: function () { return types_1.SideState; } });
+Object.defineProperty(exports, "TriggerOrderType", { enumerable: true, get: function () { return types_1.TriggerOrderType; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/math.d.ts

@@ -0,0 +1,60 @@
+import BN from "bn.js";
+import { MarketAccount, UserPositionAccount, Side } from "./types";
+/** Convert on-chain scaled price (u64, 6 decimals) to human-readable number. */
+export declare function priceToNumber(price: BN): number;
+/** Convert human-readable price to on-chain scaled price. */
+export declare function numberToPrice(price: number): BN;
+/** Convert on-chain token amount (with decimals) to human-readable. */
+export declare function amountToNumber(amount: BN, decimals?: number): number;
+/** Calculate the vAMM mark price (returns human-readable number). */
+export declare function calculateMarkPrice(market: MarketAccount): number;
+/** Estimate execution price for a trade (constant product, returns human-readable). */
+export declare function estimateExecutionPrice(market: MarketAccount, side: Side, baseSize: BN): number;
+/** Calculate slippage in BPS between execution price and mark price. */
+export declare function calculateSlippageBps(executionPrice: number, markPrice: number): number;
+/** Calculate effective position size (accounts for ADL A-coefficient + epoch). */
+export declare function effectivePositionQ(position: UserPositionAccount, market: MarketAccount): BN;
+/** Calculate notional value of a position (BN, raw on-chain units). */
+export declare function calculateNotionalBN(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): BN;
+/** Calculate notional value (human-readable number, for display).
+ *  Uses BN precision internally; converts to JS Number at the end.
+ *  Note: for notional > Number.MAX_SAFE_INTEGER (~9e15) precision degrades
+ *  due to IEEE 754 limits. Use calculateNotionalBN for exact values. */
+export declare function calculateNotional(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): number;
+/** Compute account equity matching on-chain logic.
+ *  equity = max(0, collateral + pnl - feeDebt) */
+export declare function accountEquity(position: UserPositionAccount): BN;
+/** Calculate initial margin requirement in BPS for a given leverage. */
+export declare function initialMarginBps(maxLeverage: number): number;
+/** Check if position is above maintenance margin (matches on-chain). */
+export declare function isAboveMaintenanceMargin(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): boolean;
+/** Check if position is liquidatable. */
+export declare function isLiquidatable(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): boolean;
+/** Calculate margin ratio for a position (for display). */
+export declare function marginRatio(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): number;
+/** Estimate liquidation price for a position (human-readable, e.g. 150.0 for $150).
+ *
+ *  Uses closed-form solution derived from on-chain K-diff PnL model:
+ *    pnl_delta(P) = |basis| * A_mult * (P - P_last) / (a_basis * POS_SCALE)
+ *    notional(P)  = |effQ| * P / POS_SCALE
+ *
+ *  Liquidation occurs when equity <= mm_requirement:
+ *    equity_now + pnl_delta(P) = |effQ| * P * mmBps / (POS_SCALE * 10000)
+ *
+ *  Both sides are linear in P → solve directly. O(1), no binary search.
+ *
+ *  Approximation: ignores funding accrual between now and liquidation
+ *  (funding is time-dependent, not price-dependent). For UI display. */
+export declare function estimateLiquidationPrice(position: UserPositionAccount, market: MarketAccount, oraclePrice: BN): number | null;
+/** Calculate trading fee for a given notional. */
+export declare function calculateFee(notional: number, feeBps: number): number;
+/** Calculate funding rate (annualized %). */
+export declare function fundingRateAnnualized(market: MarketAccount): number;
+/** Calculate warmup progress (0 to 1).
+ *  Matches on-chain slope-based model: slope = max(1, R / period).
+ *  Release cap = slope * elapsed; progress = min(cap, R) / R. */
+export declare function warmupProgress(position: UserPositionAccount, market: MarketAccount, currentSlot: BN): number;
+/** Calculate haircut ratio (what fraction of matured PnL is withdrawable).
+ *  Matches on-chain risk::haircut_ratio() — computed dynamically from market state. */
+export declare function haircutRatio(market: MarketAccount): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AASvB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAUnE,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAE/C;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAE/C;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAEvE;AAID,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAWhE;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,EAAE,GACX,MAAM,CAyBR;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AASD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,GACpB,EAAE,CAkBJ;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,EAAE,CAKJ;AAED;;;wEAGwE;AACxE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,MAAM,CAMR;AAED;kDACkD;AAClD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,EAAE,CAc/D;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,OAAO,CAeT;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,OAAO,CAIT;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CACzB,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,MAAM,CAKR;AAED;;;;;;;;;;;;wEAYwE;AACxE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,MAAM,GAAG,IAAI,CAmEf;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKnE;AAED;;iEAEiE;AACjE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,EAAE,GACd,MAAM,CAsBR;AAED;uFACuF;AACvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAuB1D"}

package/dist/math.js

@@ -0,0 +1,330 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.priceToNumber = priceToNumber;
+exports.numberToPrice = numberToPrice;
+exports.amountToNumber = amountToNumber;
+exports.calculateMarkPrice = calculateMarkPrice;
+exports.estimateExecutionPrice = estimateExecutionPrice;
+exports.calculateSlippageBps = calculateSlippageBps;
+exports.effectivePositionQ = effectivePositionQ;
+exports.calculateNotionalBN = calculateNotionalBN;
+exports.calculateNotional = calculateNotional;
+exports.accountEquity = accountEquity;
+exports.initialMarginBps = initialMarginBps;
+exports.isAboveMaintenanceMargin = isAboveMaintenanceMargin;
+exports.isLiquidatable = isLiquidatable;
+exports.marginRatio = marginRatio;
+exports.estimateLiquidationPrice = estimateLiquidationPrice;
+exports.calculateFee = calculateFee;
+exports.fundingRateAnnualized = fundingRateAnnualized;
+exports.warmupProgress = warmupProgress;
+exports.haircutRatio = haircutRatio;
+const bn_js_1 = __importDefault(require("bn.js"));
+const constants_1 = require("./constants");
+const types_1 = require("./types");
+const ZERO = new bn_js_1.default(0);
+const BN_PRICE_SCALE = new bn_js_1.default(constants_1.PRICE_SCALE);
+const BN_POS_SCALE = new bn_js_1.default(constants_1.POS_SCALE);
+const BN_BPS_DENOM = new bn_js_1.default(constants_1.BPS_DENOMINATOR);
+const MIN_NONZERO_MM_REQ = new bn_js_1.default(10000);
+// ── Price Helpers ──
+/** Convert on-chain scaled price (u64, 6 decimals) to human-readable number. */
+function priceToNumber(price) {
+    return price.toNumber() / constants_1.PRICE_SCALE;
+}
+/** Convert human-readable price to on-chain scaled price. */
+function numberToPrice(price) {
+    return new bn_js_1.default(Math.round(price * constants_1.PRICE_SCALE));
+}
+/** Convert on-chain token amount (with decimals) to human-readable. */
+function amountToNumber(amount, decimals = 9) {
+    return amount.toNumber() / Math.pow(10, decimals);
+}
+// ── vAMM Math ──
+/** Calculate the vAMM mark price (returns human-readable number). */
+function calculateMarkPrice(market) {
+    if (market.baseReserve.isZero())
+        return 0;
+    // mark = quote_reserve * peg_multiplier / (base_reserve * PRICE_SCALE)
+    // Use BN arithmetic to avoid u128 overflow, convert to number at the end
+    const numerator = market.quoteReserve.mul(market.pegMultiplier);
+    const denominator = market.baseReserve.mul(BN_PRICE_SCALE);
+    // Result is a ratio close to 1.0 for balanced reserves, safe to convert
+    // Use high-precision: multiply numerator by 1e12 first, divide, then divide by 1e12
+    const PRECISION = new bn_js_1.default("1000000000000");
+    const scaled = numerator.mul(PRECISION).div(denominator);
+    return scaled.toNumber() / 1e12;
+}
+/** Estimate execution price for a trade (constant product, returns human-readable). */
+function estimateExecutionPrice(market, side, baseSize) {
+    const base = market.baseReserve;
+    const quote = market.quoteReserve;
+    const peg = market.pegMultiplier;
+    const k = market.k; // Use stored k, not recomputed (avoids rounding drift)
+    if (side === types_1.Side.Long) {
+        const newBase = base.sub(baseSize);
+        if (newBase.isZero() || newBase.isNeg())
+            return Infinity;
+        const newQuote = k.div(newBase);
+        const quoteDelta = newQuote.sub(quote);
+        // exec_price = quoteDelta * peg / (size * PRICE_SCALE)
+        const PRECISION = new bn_js_1.default("1000000000000");
+        const num = quoteDelta.mul(peg).mul(PRECISION);
+        const den = baseSize.mul(BN_PRICE_SCALE);
+        return num.div(den).toNumber() / 1e12;
+    }
+    else {
+        const newBase = base.add(baseSize);
+        const newQuote = k.div(newBase);
+        const quoteDelta = quote.sub(newQuote);
+        const PRECISION = new bn_js_1.default("1000000000000");
+        const num = quoteDelta.mul(peg).mul(PRECISION);
+        const den = baseSize.mul(BN_PRICE_SCALE);
+        return num.div(den).toNumber() / 1e12;
+    }
+}
+/** Calculate slippage in BPS between execution price and mark price. */
+function calculateSlippageBps(executionPrice, markPrice) {
+    if (markPrice === 0)
+        return 0;
+    return Math.abs(((executionPrice - markPrice) / markPrice) * constants_1.BPS_DENOMINATOR);
+}
+// ── Position Math ──
+/** Get the epoch for a side from the market. */
+function getEpochSide(market, isLong) {
+    return isLong ? market.longEpoch : market.shortEpoch;
+}
+/** Calculate effective position size (accounts for ADL A-coefficient + epoch). */
+function effectivePositionQ(position, market) {
+    const basis = position.basis;
+    if (basis.isZero())
+        return ZERO;
+    const isLong = !basis.isNeg();
+    const absBasis = basis.abs();
+    const aSide = isLong ? market.longA : market.shortA;
+    const aBasis = position.aSnapshot;
+    // Epoch mismatch check — position was wiped by ADL reset
+    const epochSide = getEpochSide(market, isLong);
+    if (!position.epochSnapshot.eq(epochSide))
+        return ZERO;
+    if (aBasis.isZero())
+        return ZERO;
+    // floor(|basis| * a_side / a_basis)
+    const result = absBasis.mul(aSide).div(aBasis);
+    return basis.isNeg() ? result.neg() : result;
+}
+/** Calculate notional value of a position (BN, raw on-chain units). */
+function calculateNotionalBN(position, market, oraclePrice) {
+    const effQ = effectivePositionQ(position, market);
+    if (effQ.isZero())
+        return ZERO;
+    // notional = |eff| * price / POS_SCALE
+    return effQ.abs().mul(oraclePrice).div(BN_POS_SCALE);
+}
+/** Calculate notional value (human-readable number, for display).
+ *  Uses BN precision internally; converts to JS Number at the end.
+ *  Note: for notional > Number.MAX_SAFE_INTEGER (~9e15) precision degrades
+ *  due to IEEE 754 limits. Use calculateNotionalBN for exact values. */
+function calculateNotional(position, market, oraclePrice) {
+    const notional = calculateNotionalBN(position, market, oraclePrice);
+    // For values within safe integer range, convert directly (lossless)
+    if (notional.bitLength() <= 53)
+        return notional.toNumber();
+    // For large values, go through string to avoid intermediate overflow
+    return parseFloat(notional.toString());
+}
+/** Compute account equity matching on-chain logic.
+ *  equity = max(0, collateral + pnl - feeDebt) */
+function accountEquity(position) {
+    const collateral = position.depositedCollateral;
+    const pnl = position.pnl; // i128 (can be negative)
+    const feeCredits = position.feeCredits; // i128 (negative = debt)
+    // fee_debt = abs(min(0, feeCredits))
+    const feeDebt = feeCredits.isNeg() ? feeCredits.abs() : ZERO;
+    // equity_raw = collateral + pnl - feeDebt
+    let equityRaw = new bn_js_1.default(collateral.toString()).add(pnl).sub(feeDebt);
+    // Clamp to 0 (matches on-chain max(0, eq_raw))
+    if (equityRaw.isNeg())
+        equityRaw = ZERO;
+    return equityRaw;
+}
+/** Calculate initial margin requirement in BPS for a given leverage. */
+function initialMarginBps(maxLeverage) {
+    const leverageActual = Math.floor(maxLeverage / constants_1.LEVERAGE_SCALE);
+    if (leverageActual <= 0)
+        return constants_1.BPS_DENOMINATOR;
+    const raw = Math.floor(constants_1.BPS_DENOMINATOR / leverageActual);
+    return Math.max(raw, constants_1.MAINTENANCE_MARGIN_BPS + 1);
+}
+/** Check if position is above maintenance margin (matches on-chain). */
+function isAboveMaintenanceMargin(position, market, oraclePrice) {
+    const equity = accountEquity(position);
+    const notional = calculateNotionalBN(position, market, oraclePrice);
+    // mm_req = notional * market.maintenanceMarginBps / 10000
+    const mmBps = new bn_js_1.default(market.maintenanceMarginBps);
+    let mmReq = notional.mul(mmBps).div(BN_BPS_DENOM);
+    // Apply MIN_NONZERO_MM_REQ floor for non-zero positions
+    if (!notional.isZero()) {
+        mmReq = bn_js_1.default.max(mmReq, MIN_NONZERO_MM_REQ);
+    }
+    // On-chain: eq_net > mm_req (strictly greater)
+    return equity.gt(mmReq);
+}
+/** Check if position is liquidatable. */
+function isLiquidatable(position, market, oraclePrice) {
+    const effQ = effectivePositionQ(position, market);
+    if (effQ.isZero() && position.baseSize.isZero())
+        return false;
+    return !isAboveMaintenanceMargin(position, market, oraclePrice);
+}
+/** Calculate margin ratio for a position (for display). */
+function marginRatio(position, market, oraclePrice) {
+    const notional = calculateNotional(position, market, oraclePrice);
+    if (notional === 0)
+        return Infinity;
+    const equity = accountEquity(position);
+    return equity.toNumber() / notional;
+}
+/** Estimate liquidation price for a position (human-readable, e.g. 150.0 for $150).
+ *
+ *  Uses closed-form solution derived from on-chain K-diff PnL model:
+ *    pnl_delta(P) = |basis| * A_mult * (P - P_last) / (a_basis * POS_SCALE)
+ *    notional(P)  = |effQ| * P / POS_SCALE
+ *
+ *  Liquidation occurs when equity <= mm_requirement:
+ *    equity_now + pnl_delta(P) = |effQ| * P * mmBps / (POS_SCALE * 10000)
+ *
+ *  Both sides are linear in P → solve directly. O(1), no binary search.
+ *
+ *  Approximation: ignores funding accrual between now and liquidation
+ *  (funding is time-dependent, not price-dependent). For UI display. */
+function estimateLiquidationPrice(position, market, oraclePrice) {
+    const effQ = effectivePositionQ(position, market);
+    if (effQ.isZero())
+        return null;
+    const isLong = !effQ.isNeg();
+    const currentPriceHuman = oraclePrice.toNumber() / constants_1.PRICE_SCALE;
+    // Already liquidatable
+    if (isLiquidatable(position, market, oraclePrice)) {
+        return currentPriceHuman;
+    }
+    // Current equity (scalar, can use .toNumber() — equity is clamped to u64 range)
+    const equity = accountEquity(position);
+    const equityNum = equity.toNumber();
+    // PnL sensitivity to price: how much PnL changes per unit of scaled price.
+    // On-chain: pnl_delta = |basis| * A_mult * delta_P / (a_basis * POS_SCALE)
+    // where A_mult = longA or shortA (the market-level ADL multiplier).
+    //
+    // The position's a_basis (aSnapshot) was set to A_mult at position open,
+    // so |basis| * A_mult / a_basis = |effQ| (the effective position size).
+    // This means: pnl_delta = |effQ| * delta_P / POS_SCALE
+    //
+    // In human price units (dividing scaled price by PRICE_SCALE):
+    //   pnl_per_unit = |effQ| * PRICE_SCALE / POS_SCALE
+    const absEffQ = effQ.abs().toNumber();
+    const pnlPerUnit = absEffQ * constants_1.PRICE_SCALE / constants_1.POS_SCALE;
+    // MM requirement per unit price:
+    //   mm_per_unit = |effQ| * mmBps / (POS_SCALE * 10000)
+    //   In human price units: mm_per_unit_human = |effQ| * PRICE_SCALE * mmBps / (POS_SCALE * 10000)
+    const mmBps = market.maintenanceMarginBps;
+    const mmPerUnit = absEffQ * constants_1.PRICE_SCALE * mmBps / (constants_1.POS_SCALE * constants_1.BPS_DENOMINATOR);
+    // Solve: equity + sign * pnlPerUnit * (P - currentPrice) = mmPerUnit * P
+    // where sign = +1 for longs (price up = profit), -1 for shorts (price down = profit)
+    //
+    // For longs:  equity + pnlPerUnit * P - pnlPerUnit * currentPrice = mmPerUnit * P
+    //             equity - pnlPerUnit * currentPrice = P * (mmPerUnit - pnlPerUnit)
+    //             P = (equity - pnlPerUnit * currentPrice) / (mmPerUnit - pnlPerUnit)
+    //
+    // For shorts: equity - pnlPerUnit * P + pnlPerUnit * currentPrice = mmPerUnit * P
+    //             equity + pnlPerUnit * currentPrice = P * (mmPerUnit + pnlPerUnit)
+    //             P = (equity + pnlPerUnit * currentPrice) / (mmPerUnit + pnlPerUnit)
+    let liqPrice;
+    if (isLong) {
+        const denominator = mmPerUnit - pnlPerUnit;
+        // If denominator >= 0, longs can't be liquidated (MM requirement grows
+        // slower than equity — position is always solvent as price rises)
+        if (denominator >= 0)
+            return null;
+        liqPrice = (equityNum - pnlPerUnit * currentPriceHuman) / denominator;
+    }
+    else {
+        const denominator = mmPerUnit + pnlPerUnit;
+        if (denominator <= 0)
+            return null; // Can't happen for valid positions
+        liqPrice = (equityNum + pnlPerUnit * currentPriceHuman) / denominator;
+    }
+    // Sanity: price must be positive
+    if (liqPrice <= 0)
+        return null;
+    // Sanity: longs liquidate below current price, shorts above
+    if (isLong && liqPrice >= currentPriceHuman)
+        return currentPriceHuman;
+    if (!isLong && liqPrice <= currentPriceHuman)
+        return currentPriceHuman;
+    return liqPrice;
+}
+/** Calculate trading fee for a given notional. */
+function calculateFee(notional, feeBps) {
+    return Math.ceil((notional * feeBps) / constants_1.BPS_DENOMINATOR);
+}
+/** Calculate funding rate (annualized %). */
+function fundingRateAnnualized(market) {
+    const ratePerSlot = market.fundingRateBpsPerSlotLast.toNumber();
+    // ~2.5 slots per second on Solana
+    const slotsPerYear = 2.5 * 86400 * 365;
+    return (ratePerSlot * slotsPerYear) / (constants_1.FUNDING_RATE_PRECISION * 100);
+}
+/** Calculate warmup progress (0 to 1).
+ *  Matches on-chain slope-based model: slope = max(1, R / period).
+ *  Release cap = slope * elapsed; progress = min(cap, R) / R. */
+function warmupProgress(position, market, currentSlot) {
+    if (position.reservedPnl.isZero())
+        return 1;
+    const period = market.warmupPeriodSlots;
+    if (period.isZero())
+        return 1;
+    // On-chain: slope = max(1, reserved_pnl / warmup_period_slots)
+    // The position stores warmupSlope set at warmup start.
+    const slope = position.warmupSlope.isZero()
+        ? bn_js_1.default.max(new bn_js_1.default(1), position.reservedPnl.div(period))
+        : position.warmupSlope;
+    const elapsed = currentSlot.sub(position.warmupStartedAtSlot);
+    if (elapsed.isNeg())
+        return 0;
+    // cap = slope * elapsed (saturating)
+    const cap = slope.mul(elapsed);
+    // released = min(reserved_pnl, cap)
+    const released = bn_js_1.default.min(position.reservedPnl, cap);
+    // Progress = released / reserved_pnl
+    if (position.reservedPnl.isZero())
+        return 1;
+    return released.toNumber() / position.reservedPnl.toNumber();
+}
+/** Calculate haircut ratio (what fraction of matured PnL is withdrawable).
+ *  Matches on-chain risk::haircut_ratio() — computed dynamically from market state. */
+function haircutRatio(market) {
+    // If no matured positive PnL, ratio is 1 (no haircut needed)
+    if (market.pnlMaturedPosTot.isZero())
+        return 1;
+    // Senior claims: c_tot + insurance + claimable fees
+    const claimable = market.creatorClaimableFees.add(market.protocolClaimableFees);
+    const seniorSum = market.cTot
+        .add(new bn_js_1.default(market.insuranceFundBalance.toString()))
+        .add(claimable);
+    // Residual = vault_balance - senior_claims (clamped to 0)
+    const vaultBal = new bn_js_1.default(market.vaultBalance.toString());
+    const residual = vaultBal.gt(seniorSum) ? vaultBal.sub(seniorSum) : ZERO;
+    // h = min(residual, pnl_matured_pos_tot) / pnl_matured_pos_tot
+    const hNum = bn_js_1.default.min(residual, market.pnlMaturedPosTot);
+    const hDen = market.pnlMaturedPosTot;
+    if (hDen.isZero())
+        return 1;
+    // Use BN precision to avoid .toNumber() overflow on large pnl_matured_pos_tot
+    const RATIO_PRECISION = new bn_js_1.default("1000000000000"); // 1e12
+    const scaled = hNum.mul(RATIO_PRECISION).div(hDen);
+    return scaled.toNumber() / 1e12;
+}
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

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

package/dist/oracle-cranker.d.ts

@@ -0,0 +1,72 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Wallet } from "@coral-xyz/anchor";
+export interface OracleCrankerConfig {
+    connection: Connection;
+    wallet: Wallet;
+    /** Token mints to post prices for. */
+    tokenMints: PublicKey[];
+    /** Update interval in ms (default: 3000 — ~every 7-8 slots). */
+    updateIntervalMs?: number;
+    /** Birdeye API key (optional — if not provided, skip Birdeye source). */
+    birdeyeApiKey?: string;
+    /** Priority fee in microlamports per CU (default: 50000). */
+    priorityFeeMicroLamports?: number;
+    /** Max deviation between sources before rejecting an outlier (default: 0.01 = 1%).
+     *  Must be ≤ half of on-chain ORACLE_CONFIDENCE_BPS (2%) because confidence = max-min,
+     *  so two sources at ±X% produce 2X% confidence. 1% deviation → max 2% confidence → passes. */
+    maxSourceDeviationPct?: number;
+    /** Minimum number of valid sources required (should match on-chain min_sources).
+     *  Default: 1 (since Raydium is stubbed, requiring 2 would deadlock when one API is down). */
+    minSources?: number;
+    /** HTTP fetch timeout in ms (default: 5000). Prevents hung connections from freezing the cranker. */
+    fetchTimeoutMs?: number;
+    /** Jito bundle configuration. If provided, oracle updates are submitted as private Jito bundles
+     *  to prevent front-running / MEV extraction on oracle price updates. */
+    jito?: {
+        /** Jito Block Engine URL (default: mainnet). */
+        blockEngineUrl?: string;
+        /** Tip in lamports to include in the bundle (default: 10000 = 0.00001 SOL). */
+        tipLamports?: number;
+        /** If true, do NOT fall back to normal RPC when Jito fails. Prevents mempool leakage
+         *  at the cost of missed updates when Jito is down. Default: false. */
+        jitoOnly?: boolean;
+    };
+    /** Callback for logging. */
+    onLog?: (msg: string) => void;
+    /** Callback for errors. */
+    onError?: (err: Error, context: string) => void;
+    /** Callback for metrics. */
+    onMetrics?: (metrics: OracleCrankerMetrics) => void;
+}
+export interface OracleCrankerMetrics {
+    tickDurationMs: number;
+    mintsProcessed: number;
+    updatesPosted: number;
+    sourcesFetched: number;
+    outlierRejections: number;
+    errors: number;
+}
+export declare class PerkOracleCranker {
+    private client;
+    private config;
+    private running;
+    private intervalId;
+    private tickInProgress;
+    constructor(config: OracleCrankerConfig);
+    /**
+     * Submit a transaction as a Jito bundle for private, front-run-resistant submission.
+     * Falls back to normal RPC submission if Jito fails.
+     */
+    private sendViaJito;
+    private log;
+    private handleError;
+    /** Start the oracle cranker loop. */
+    start(): void;
+    /** Stop the oracle cranker loop gracefully. Waits for current tick to finish (up to timeoutMs, default 30s). */
+    stop(timeoutMs?: number): Promise<void>;
+    /** Returns true if the oracle cranker is currently running. */
+    isRunning(): boolean;
+    private tick;
+    private _tickInner;
+}
+//# sourceMappingURL=oracle-cranker.d.ts.map