@waterx/sdk 4.3.2 → 5.0.0

package/dist/cjs/src/perp/client.js

@@ -16,20 +16,21 @@ exports.PerpClient = void 0;
 const base_client_ts_1 = require("../base-client.js");
 const price_update_rule_ts_1 = require("../oracle/price-update-rule.js");
 const source_list_ts_1 = require("../oracle/source-list.js");
+const validate_ts_1 = require("../oracle/validate.js");
 const config_view_ts_1 = require("./config-view.js");
 const config_ts_1 = require("./config.js");
 class PerpClient extends base_client_ts_1.BaseLineClient {
     /** Caller-supplied Pyth credential + fetch policy — NO infra; each source owns its own tables. */
     pyth;
     /**
-     * Caller-supplied quote-center overrides for `oracleSource: 'waterx_rule'`
+     * Caller-supplied quote-center overrides for `waterx_rule`
      * (`waterxEndpoint` / `waterxFetch` create options) — access-only, mirroring
      * `pyth` above; unset fields resolve against the rule's own `WATERX_INFRA`.
      */
     waterx;
     /** Wormhole infra for the credit bridge (network defaults unless overridden). */
     wormhole;
-    /** The fed set: `oracleSource` create option normalized to a non-empty, deduped list. */
+    /** The fed set, derived from the config — see {@link deriveOracleSources}. */
     oracleSources;
     /** Canonical-schema lookups (delegated to below); no transport. */
     view;
@@ -51,18 +52,17 @@ class PerpClient extends base_client_ts_1.BaseLineClient {
             ...(opts.waterxEndpoint !== undefined ? { endpoint: opts.waterxEndpoint } : {}),
             ...(opts.waterxFetch !== undefined ? { fetch: opts.waterxFetch } : {}),
         };
-        // Normalize single-or-list to a deduped, order-preserving list, gated by
-        // `isOracleSource` — the SAME predicate `parseOracleSourceList` uses. An
-        // empty list, a nullish entry (an untyped caller omitting the REQUIRED
-        // option), or an unregistered value (`'core'`, `'pyth'`, …) fails
-        // construction loudly instead of booting green and surfacing as
-        // `OracleSourceNotImplemented` at the first tx-build.
-        const sources = Array.isArray(opts.oracleSource) ? opts.oracleSource : [opts.oracleSource];
-        this.oracleSources = [...new Set(sources)];
-        if (this.oracleSources.length === 0 ||
-            this.oracleSources.some((source) => !(0, source_list_ts_1.isOracleSource)(source))) {
-            throw new Error(`oracleSource is REQUIRED and must name at least one of ${price_update_rule_ts_1.ORACLE_SOURCES.join(" | ")} ` +
-                `(got ${JSON.stringify(sources)})`);
+        // The fed set is a property of the DEPLOYMENT, read off the same config
+        // that wires the rules — never a create option and never an env var.
+        this.oracleSources = (0, source_list_ts_1.deriveOracleSources)(config);
+        if (this.oracleSources.length === 0) {
+            // Not a per-ticker coverage question (that is left to tx-build, on
+            // purpose): a config wiring NO price-update source at all cannot price
+            // anything, so every build would skip every ticker and every trade would
+            // abort on chain. Fail at construction, where the config is in hand.
+            throw new Error(`this deployment's config wires no price-update source — expected a published ` +
+                `package with a non-empty feeds map for at least one of ` +
+                `${price_update_rule_ts_1.ORACLE_SOURCES.join(" | ")}.`);
         }
         this.view = new config_view_ts_1.PerpConfigView(() => this.config, () => this.wormhole);
     }
@@ -97,9 +97,36 @@ class PerpClient extends base_client_ts_1.BaseLineClient {
     getAggregator(ticker) {
         return this.view.getAggregator(ticker);
     }
-    /** @see PerpConfigView.getPythFeed */
-    getPythFeed(ticker) {
-        return this.view.getPythFeed(ticker);
+    /**
+     * WLP pool-token tickers THIS client's fed set can actually price — the
+     * ticker set the WLP builders refresh before `assert_prices_fresh`.
+     *
+     * Filtered, not raw `Object.keys(pool_tokens)`: a token only an UNLISTED
+     * source serves is not priceable by this client. The predicate is
+     * `refreshOraclePrices`'s own (`servableTickers`), so this list is exactly
+     * what a refresh would accept.
+     *
+     * NOTE this is a QUERY, not what the WLP builders use — they deliberately
+     * refresh and bump the WHOLE pool, because dropping an unpriceable asset
+     * from both halves is silent (see `assertWlpPoolRefreshed`).
+     */
+    pricedPoolTickers() {
+        return (0, validate_ts_1.servableTickers)(this, Object.keys(this.config.packages.wlp?.pool_tokens ?? {}));
+    }
+    /**
+     * {@link pricedPoolTickers} already joined to each token's Move type.
+     *
+     * A query, not a build primitive: the WLP builders deliberately refresh and
+     * bump the WHOLE pool (`refreshWlpPoolOracles`), because pre-filtering to
+     * what this client can price silently drops an asset from both halves. Use
+     * this to ASK what a fed set covers — e.g. a dashboard, or a boot assert
+     * pairing it with `assertOracleWriteCoverage`.
+     */
+    pricedPoolTokens() {
+        return this.pricedPoolTickers().map((ticker) => ({
+            ticker,
+            tokenType: this.getPoolTokenType(ticker),
+        }));
     }
     /** @see PerpConfigView.isConstantTicker */
     isConstantTicker(ticker) {

package/dist/cjs/src/perp/config-view.d.ts

@@ -19,27 +19,18 @@ export declare class PerpConfigView {
     getMarket(ticker: string): import("./config.ts").WaterxPerpMarketEntry;
     /** `waterx_oracle.aggregators[ticker]`, throws if unknown. */
     getAggregator(ticker: string): string;
-    /** `pyth_rule.feeds[ticker]`, throws if unknown. */
-    getPythFeed(ticker: string): {
-        feed_id: string;
-        price_info_object: string;
-    };
     /**
      * True when `ticker` is priced by `constant_rule` (a constant pin,
-     * e.g. `USDCUSD → $1`) rather than Pyth. Such tickers are fed via
-     * `constant_rule::feed` and need no Pyth update; see {@link refreshOraclePrices}.
+     * e.g. `USDCUSD → $1`) rather than a live source. Such tickers are fed via
+     * `constant_rule::feed` and need no source update leg; see
+     * {@link refreshOraclePrices}.
      *
      * All-or-nothing, mirroring {@link getSupraRule} and the keeper: only routes a
      * ticker to the constant rule when the rule is FULLY wired (`published_at` +
      * `config` present). A half-populated block — a `feeds` entry listed before the
      * rule is deployed, a realistic mid-rollout state — would otherwise make this
-     * true while {@link aggregateTicker} throws, aborting the whole price-refresh PTB
-     * instead of safely falling back to Pyth.
-     *
-     * Whether a constant ticker is *also* Pyth-fed (the dual-feed transition state)
-     * or constant-only is not a separate flag — it falls out of whether the ticker
-     * still has a `pyth_rule.feeds` entry. {@link aggregateTicker} feeds each rule the
-     * ticker is configured for, so no `isDualFeed` / `isConstantOnly` predicate is needed.
+     * true while {@link aggregateTicker} throws, aborting the whole price-refresh
+     * PTB instead of leaving the ticker to its live sources.
      */
     isConstantTicker(ticker: string): boolean;
     /**

package/dist/cjs/src/perp/config-view.js

@@ -42,29 +42,18 @@ class PerpConfigView {
             throw new Error(`No aggregator listed for ticker: ${ticker}`);
         return a;
     }
-    /** `pyth_rule.feeds[ticker]`, throws if unknown. */
-    getPythFeed(ticker) {
-        const f = (0, record_ts_1.ownEntry)(this.config.packages.pyth_rule?.feeds, ticker);
-        if (!f)
-            throw new Error(`No pyth feed listed for ticker: ${ticker}`);
-        return f;
-    }
     /**
      * True when `ticker` is priced by `constant_rule` (a constant pin,
-     * e.g. `USDCUSD → $1`) rather than Pyth. Such tickers are fed via
-     * `constant_rule::feed` and need no Pyth update; see {@link refreshOraclePrices}.
+     * e.g. `USDCUSD → $1`) rather than a live source. Such tickers are fed via
+     * `constant_rule::feed` and need no source update leg; see
+     * {@link refreshOraclePrices}.
      *
      * All-or-nothing, mirroring {@link getSupraRule} and the keeper: only routes a
      * ticker to the constant rule when the rule is FULLY wired (`published_at` +
      * `config` present). A half-populated block — a `feeds` entry listed before the
      * rule is deployed, a realistic mid-rollout state — would otherwise make this
-     * true while {@link aggregateTicker} throws, aborting the whole price-refresh PTB
-     * instead of safely falling back to Pyth.
-     *
-     * Whether a constant ticker is *also* Pyth-fed (the dual-feed transition state)
-     * or constant-only is not a separate flag — it falls out of whether the ticker
-     * still has a `pyth_rule.feeds` entry. {@link aggregateTicker} feeds each rule the
-     * ticker is configured for, so no `isDualFeed` / `isConstantOnly` predicate is needed.
+     * true while {@link aggregateTicker} throws, aborting the whole price-refresh
+     * PTB instead of leaving the ticker to its live sources.
      */
     isConstantTicker(ticker) {
         const c = this.config.packages.constant_rule;

package/dist/cjs/src/perp/config.d.ts

@@ -5,15 +5,15 @@
  * The schema mirrors the canonical JSON layout one-to-one (each package
  * groups its own object IDs + per-ticker maps). External chain infra is
  * **not** in the JSON — each oracle source owns its own per-network table
- * (`PYTH_CORE_INFRA` in `oracle/pyth.ts`, `LAZER_INFRA` in
- * `oracle/rules/pyth-lazer-rule.ts`); Wormhole bridge infra lives in
+ * (`LAZER_INFRA` in `oracle/rules/pyth-lazer-rule.ts`, `WATERX_INFRA` in
+ * `oracle/rules/waterx-rule.ts`); Wormhole bridge infra lives in
  * `WORMHOLE_DEFAULTS` below.
  */
 import type { AccountPackages, BasePackageEntry, WormholeInfraConfig } from "../account/config.ts";
 import type { OraclePackages } from "../oracle/config.ts";
 import type { Network } from "./constants.ts";
 export type { AccountConfig, AccountPackages, BasePackageEntry, NativeCustodyAsset, NativeCustodyPackage, WaterxCreditPackage, WaterxReferralPackage, WithdrawalQueuePackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "../account/config.ts";
-export type { ConstantFeedEntry, OracleConfig, OraclePackages, PythAccessConfig, PythFetchPolicy, PythLazerRulePackage, PythRulePackage, PythSponsorRulePackage, SupraFeedEntry, SupraRulePackage, WaterxConstantRulePackage, WaterxAccessConfig, WaterxOraclePackage, WaterxRulePackage, } from "../oracle/config.ts";
+export type { ConstantFeedEntry, OracleConfig, OraclePackages, PythAccessConfig, PythFetchPolicy, PythLazerRulePackage, SupraFeedEntry, SupraRulePackage, WaterxConstantRulePackage, WaterxAccessConfig, WaterxOraclePackage, WaterxRulePackage, } from "../oracle/config.ts";
 export interface WaterxPerpMarketEntry {
     market: string;
     config: string;

package/dist/cjs/src/perp/config.js

@@ -6,8 +6,8 @@
  * The schema mirrors the canonical JSON layout one-to-one (each package
  * groups its own object IDs + per-ticker maps). External chain infra is
  * **not** in the JSON — each oracle source owns its own per-network table
- * (`PYTH_CORE_INFRA` in `oracle/pyth.ts`, `LAZER_INFRA` in
- * `oracle/rules/pyth-lazer-rule.ts`); Wormhole bridge infra lives in
+ * (`LAZER_INFRA` in `oracle/rules/pyth-lazer-rule.ts`, `WATERX_INFRA` in
+ * `oracle/rules/waterx-rule.ts`); Wormhole bridge infra lives in
  * `WORMHOLE_DEFAULTS` below.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -19,14 +19,12 @@ const update_fetch_ts_1 = require("../oracle/update-fetch.js");
 // Wormhole — external chain infra, defaults by network
 // ============================================================================
 //
-// Oracle-source infra lives with each source (`PYTH_CORE_INFRA` in
-// `oracle/pyth.ts`, `LAZER_INFRA` in `oracle/rules/pyth-lazer-rule.ts`);
-// `client.pyth` is the caller-supplied access slice only (`PythAccessConfig`,
-// re-exported at the top of this file).
+// Oracle-source infra lives with each source (`LAZER_INFRA` in
+// `oracle/rules/pyth-lazer-rule.ts`, `WATERX_INFRA` in
+// `oracle/rules/waterx-rule.ts`); `client.pyth` is the caller-supplied access
+// slice only (`PythAccessConfig`, re-exported at the top of this file).
 // `WormholeInfraConfig` is defined in `account/config.ts` (funding base) and
-// re-exported at the top of this file. `state_id` is the same shared Sui
-// Wormhole `State` object Pyth uses (kept in sync with
-// `PYTH_CORE_INFRA[*].wormhole_state_id`).
+// re-exported at the top of this file.
 exports.WORMHOLE_DEFAULTS = {
     MAINNET: {
         state_id: "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c",
@@ -146,15 +144,15 @@ function validateConfig(cfg, expected, url) {
     };
     // Validate by deployment kind. A perp config must carry the perp set; a
     // credit config the credit set. `waterx_account` is common to both.
-    // `pyth_lazer_rule` is intentionally NOT required (and never will be by
-    // presence alone) — it's an optional/experimental package selected only via
-    // a client's `oracleSource` option, never by its presence in the config.
+    // NO oracle-rule package is required by presence — which rules run is the
+    // client's derived fed set, never a hand-declared list (and
+    // `pyth_rule`, once required here, was retired in 5.0.0 — a config may
+    // carry or omit its block freely).
     const isPerp = "waterx_perp" in cfg.packages;
     const isCredit = "waterx_credit" in cfg.packages || "wormhole_bridge" in cfg.packages;
     const required = isPerp
         ? [
             "bucket_framework",
-            "pyth_rule",
             "waterx_account",
             "waterx_oracle",
             "waterx_perp",

package/dist/cjs/src/perp/index.d.ts

@@ -1,10 +1,10 @@
 export { PerpClient } from "./client.ts";
 export type { CreateClientOptions } from "./client.ts";
 export { WORMHOLE_DEFAULTS, clearConfigCache, loadConfig } from "./config.ts";
-export type { BasePackageEntry, ConstantFeedEntry, WaterxReferralPackage, LoadConfigOptions, NativeCustodyAsset, NativeCustodyPackage, PythAccessConfig, PythFetchPolicy, PythLazerRulePackage, PythRulePackage, PythSponsorRulePackage, SupraFeedEntry, SupraRulePackage, TestnetFaucetPackage, WaterXConfig, WaterXPackages, WaterxCreditPackage, WaterxOraclePackage, WaterxPerpMarketEntry, WaterxPerpPackage, WaterxStakingPackage, WithdrawalQueuePackage, WlpPackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "./config.ts";
+export type { BasePackageEntry, ConstantFeedEntry, WaterxReferralPackage, LoadConfigOptions, NativeCustodyAsset, NativeCustodyPackage, PythAccessConfig, PythFetchPolicy, PythLazerRulePackage, SupraFeedEntry, SupraRulePackage, TestnetFaucetPackage, WaterXConfig, WaterXPackages, WaterxCreditPackage, WaterxOraclePackage, WaterxPerpMarketEntry, WaterxPerpPackage, WaterxStakingPackage, WithdrawalQueuePackage, WlpPackage, WormholeBridgePackage, WormholeInfraConfig, WxaAccountPackage, } from "./config.ts";
 export { ACTION_ADD_PRE_ORDER, ACTION_CANCEL_ORDER, ACTION_CANCEL_PRE_ORDER, ACTION_CLOSE_POSITION, ACTION_DECREASE_POSITION, ACTION_DEPOSIT_COLLATERAL, ACTION_INCREASE_POSITION, ACTION_LIQUIDATE, ACTION_OPEN_POSITION, ACTION_PLACE_ORDER, ACTION_UPDATE_ORDER, ACTION_WITHDRAW_COLLATERAL, BPS_SCALE, DOUBLE_SCALE, DRY_RUN_SENDER, FLOAT_SCALE, ORDER_LIMIT_BUY, ORDER_LIMIT_SELL, ORDER_STOP_BUY, ORDER_STOP_SELL, ORDER_TAG_WILDCARD, PERM_ALL, PERM_ALL_TRADING, PERM_CANCEL_ORDER, PERM_CLOSE_POSITION, PERM_DECREASE_POSITION, PERM_DEPOSIT_COLLATERAL, PERM_INCREASE_POSITION, PERM_MINT_WLP, PERM_OPEN_POSITION, PERM_PLACE_ORDER, PERM_REDEEM_WLP, PERM_WITHDRAW_COLLATERAL, STAKING_PERM_DEPOSIT_STAKE, STAKING_PERM_REDEEM_STAKE, STAKING_PERM_CLAIM_REWARD, STAKING_PERM_ALL, MS_PER_MINUTE, MS_PER_HOUR, MS_PER_YEAR, SUI_DECIMALS, WLP_DECIMALS, COLLATERAL_DECIMALS, TOKEN_DECIMALS, } from "./constants.ts";
 export type { Network } from "./constants.ts";
-export { getMarketTickers, getCollateralAssets } from "../utils/config.ts";
+export { getMarketTickers } from "../utils/config.ts";
 export { annualizedApyFromRatio, annualizeFundingRate, calcBorrowRate, calcBorrowRateAccrual, calcDynamicFeeBps, calcEffectiveCollateralUsd, calcEstLiqPrice, calcEstLiqPriceRaw, calcFee, calcFundingFeeUsd, calcFundingRate, calcImpactFeeRate, calcLeverage, calcMaxReducibleCollateralUsd, calcNotional, calcPositionBorrowFee, calcRealLiqNetCostUsd, calcTokenUtilizationBps, calcTotalTradingFeeRate, calcUnrealizedPnl, calcViewEstLiqFeesUsd, calcWlpIncentiveApy, calcWlpMintOut, calcWlpPrice, calcWlpRedeemOut, decodeFundingIndexDelta, rawPrice, } from "../utils/math.ts";
 export type { ExactDecimalUsd, LiqFeeBundle, RawPriceInput } from "../utils/math.ts";
 export { formatFundingInterval } from "../utils/format.ts";
@@ -13,8 +13,8 @@ export type { EstLiqPriceViewOpts } from "./liq-view.ts";
 export * from "./user/index.ts";
 export * from "./tx-builders.ts";
 export * from "./fetch.ts";
-export { FetchPolicyError, LazerApiKeyMissingError, OracleFeeSourceUnavailableError, OracleSourceNotImplementedError, PythCache, aggregateTicker, aggregateTickerWithConstant, aggregateTickerWithPyth, ORACLE_SOURCES, buildPythPriceUpdateCalls, fetchPriceFeedsUpdateData, isOracleSource, parseOracleSourceList, pythCoreHermesEndpoint, pythProHermesEndpoint, refreshOraclePrices, resolveHermesReadEndpoint, updatePythPrices, waterxEnvelopeOf, waterxQuoteCenterEndpoint, } from "../oracle/index.ts";
-export type { FetchPolicy, OracleFeeSource, OracleSource, UpdateDataProvider, } from "../oracle/index.ts";
+export { FetchPolicyError, LazerApiKeyMissingError, LazerNotEntitledError, OracleTickerUnservedError, OracleWeightCoverageError, OracleWeightUnreadableError, OracleSourceNotImplementedError, aggregateTicker, aggregateTickerWithConstant, ORACLE_SOURCES, assertOracleWeightCoverage, assertOracleWriteCoverage, fetchPythProHistory, fetchPythSymbolCatalog, fetchWaterxSignedLeaves, fetchWaterxSignedUpdate, fetchWaterxUpdateData, getMarketStatus, isFreshWaterxEntry, deriveOracleSources, missingOracleCredentials, parsePythSchedule, PythScheduleParseError, pullWaterxQuotes, readLazerPrices, readPlanTickers, readQuoteCenterPrices, refreshOraclePrices, resolveOracleReadPlan, resolveOracleRule, servableTickers, WATERX_MAX_PRICE_AGE_MS, waterxEnvelopeOf, waterxLeavesOf, parseSignedLeaves, MERKLE_ROOT_INTENT, waterxQuoteCenterEndpoint, } from "../oracle/index.ts";
+export type { FetchPolicy, HolidayDate, MarketStatusResult, OracleCredentialKind, OraclePriceEntry, OracleRefreshSummary, OracleReadPlan, OracleSource, ParsedPythSchedule, PythSymbolRecord, TradingHours, TradingSession, UpdateDataProvider, WaterxBatchItem, WaterxEnvelopePayload, WaterxLeafPayload, WaterxSignedEnvelope, WaterxSignedLeaf, WaterxUpdatePayload, } from "../oracle/index.ts";
 export { fetchDepositVaa, fetchVaa, listBridgeWithdrawalVaas, listVaasByEmitter, padEvmEmitter, toWormholescanEmitter, vaaBase64ToBytes, vaaBase64ToHex, vaaBytesToBase64, waitForVaa, } from "../account/funding/wormhole.ts";
 export type { VaaListItem, VaaResponse, WormholescanOptions } from "../account/funding/wormhole.ts";
 export { AccountData as AccountDataBcs, GlobalConfigData as GlobalConfigDataBcs, MarketData as MarketDataBcs, OrderData as OrderDataBcs, PoolData as PoolDataBcs, PositionData as PositionDataBcs, RedeemRequestData as RedeemRequestDataBcs, TokenPoolData as TokenPoolDataBcs, } from "../generated/waterx_perp_view/view.ts";
@@ -27,8 +27,6 @@ export * as viewCalls from "../generated/waterx_perp_view/view.ts";
 export * as wxaAccountCalls from "../generated/waterx_account/account.ts";
 export * as stakingCalls from "../generated/waterx_staking/waterx_staking.ts";
 export * as oracleCalls from "../generated/waterx_oracle/oracle.ts";
-export * as pythRuleCalls from "../generated/waterx_pyth_rule/pyth_rule.ts";
-export * as pythSponsorRuleCalls from "../generated/pyth_sponsor_rule/pyth_sponsor_rule.ts";
 export * as referralCalls from "../generated/waterx_referral/referral_table.ts";
 export * as nativeCustodyCalls from "../generated/native_custody/custody_vault.ts";
 export * as withdrawalQueueCalls from "../generated/withdrawal_queue/withdrawal_queue.ts";

package/dist/cjs/src/perp/index.js

@@ -36,9 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCollateralAssets = exports.getMarketTickers = exports.TOKEN_DECIMALS = exports.COLLATERAL_DECIMALS = exports.WLP_DECIMALS = exports.SUI_DECIMALS = exports.MS_PER_YEAR = exports.MS_PER_HOUR = exports.MS_PER_MINUTE = exports.STAKING_PERM_ALL = exports.STAKING_PERM_CLAIM_REWARD = exports.STAKING_PERM_REDEEM_STAKE = exports.STAKING_PERM_DEPOSIT_STAKE = exports.PERM_WITHDRAW_COLLATERAL = exports.PERM_REDEEM_WLP = exports.PERM_PLACE_ORDER = exports.PERM_OPEN_POSITION = exports.PERM_MINT_WLP = exports.PERM_INCREASE_POSITION = exports.PERM_DEPOSIT_COLLATERAL = exports.PERM_DECREASE_POSITION = exports.PERM_CLOSE_POSITION = exports.PERM_CANCEL_ORDER = exports.PERM_ALL_TRADING = exports.PERM_ALL = exports.ORDER_TAG_WILDCARD = exports.ORDER_STOP_SELL = exports.ORDER_STOP_BUY = exports.ORDER_LIMIT_SELL = exports.ORDER_LIMIT_BUY = exports.FLOAT_SCALE = exports.DRY_RUN_SENDER = exports.DOUBLE_SCALE = exports.BPS_SCALE = exports.ACTION_WITHDRAW_COLLATERAL = exports.ACTION_UPDATE_ORDER = exports.ACTION_PLACE_ORDER = exports.ACTION_OPEN_POSITION = exports.ACTION_LIQUIDATE = exports.ACTION_INCREASE_POSITION = exports.ACTION_DEPOSIT_COLLATERAL = exports.ACTION_DECREASE_POSITION = exports.ACTION_CLOSE_POSITION = exports.ACTION_CANCEL_PRE_ORDER = exports.ACTION_CANCEL_ORDER = exports.ACTION_ADD_PRE_ORDER = exports.loadConfig = exports.clearConfigCache = exports.WORMHOLE_DEFAULTS = exports.PerpClient = void 0;
-exports.fetchDepositVaa = exports.waterxQuoteCenterEndpoint = exports.waterxEnvelopeOf = exports.updatePythPrices = exports.resolveHermesReadEndpoint = exports.refreshOraclePrices = exports.pythProHermesEndpoint = exports.pythCoreHermesEndpoint = exports.parseOracleSourceList = exports.isOracleSource = exports.fetchPriceFeedsUpdateData = exports.buildPythPriceUpdateCalls = exports.ORACLE_SOURCES = exports.aggregateTickerWithPyth = exports.aggregateTickerWithConstant = exports.aggregateTicker = exports.PythCache = exports.OracleSourceNotImplementedError = exports.OracleFeeSourceUnavailableError = exports.LazerApiKeyMissingError = exports.FetchPolicyError = exports.calcEstLiqPriceRawFromView = exports.formatFundingInterval = exports.rawPrice = exports.decodeFundingIndexDelta = exports.calcWlpRedeemOut = exports.calcWlpPrice = exports.calcWlpMintOut = exports.calcWlpIncentiveApy = exports.calcViewEstLiqFeesUsd = exports.calcUnrealizedPnl = exports.calcTotalTradingFeeRate = exports.calcTokenUtilizationBps = exports.calcRealLiqNetCostUsd = exports.calcPositionBorrowFee = exports.calcNotional = exports.calcMaxReducibleCollateralUsd = exports.calcLeverage = exports.calcImpactFeeRate = exports.calcFundingRate = exports.calcFundingFeeUsd = exports.calcFee = exports.calcEstLiqPriceRaw = exports.calcEstLiqPrice = exports.calcEffectiveCollateralUsd = exports.calcDynamicFeeBps = exports.calcBorrowRateAccrual = exports.calcBorrowRate = exports.annualizeFundingRate = exports.annualizedApyFromRatio = void 0;
-exports.withdrawalQueueCalls = exports.nativeCustodyCalls = exports.referralCalls = exports.pythSponsorRuleCalls = exports.pythRuleCalls = exports.oracleCalls = exports.stakingCalls = exports.wxaAccountCalls = exports.viewCalls = exports.lpPoolCalls = exports.tradingCalls = exports.MarketConfigBcs = exports.MarketBcs = exports.OrderBcs = exports.PositionBcs = exports.TokenPoolDataBcs = exports.RedeemRequestDataBcs = exports.PositionDataBcs = exports.PoolDataBcs = exports.OrderDataBcs = exports.MarketDataBcs = exports.GlobalConfigDataBcs = exports.AccountDataBcs = exports.waitForVaa = exports.vaaBytesToBase64 = exports.vaaBase64ToHex = exports.vaaBase64ToBytes = exports.toWormholescanEmitter = exports.padEvmEmitter = exports.listVaasByEmitter = exports.listBridgeWithdrawalVaas = exports.fetchVaa = void 0;
+exports.annualizedApyFromRatio = exports.getMarketTickers = exports.TOKEN_DECIMALS = exports.COLLATERAL_DECIMALS = exports.WLP_DECIMALS = exports.SUI_DECIMALS = exports.MS_PER_YEAR = exports.MS_PER_HOUR = exports.MS_PER_MINUTE = exports.STAKING_PERM_ALL = exports.STAKING_PERM_CLAIM_REWARD = exports.STAKING_PERM_REDEEM_STAKE = exports.STAKING_PERM_DEPOSIT_STAKE = exports.PERM_WITHDRAW_COLLATERAL = exports.PERM_REDEEM_WLP = exports.PERM_PLACE_ORDER = exports.PERM_OPEN_POSITION = exports.PERM_MINT_WLP = exports.PERM_INCREASE_POSITION = exports.PERM_DEPOSIT_COLLATERAL = exports.PERM_DECREASE_POSITION = exports.PERM_CLOSE_POSITION = exports.PERM_CANCEL_ORDER = exports.PERM_ALL_TRADING = exports.PERM_ALL = exports.ORDER_TAG_WILDCARD = exports.ORDER_STOP_SELL = exports.ORDER_STOP_BUY = exports.ORDER_LIMIT_SELL = exports.ORDER_LIMIT_BUY = exports.FLOAT_SCALE = exports.DRY_RUN_SENDER = exports.DOUBLE_SCALE = exports.BPS_SCALE = exports.ACTION_WITHDRAW_COLLATERAL = exports.ACTION_UPDATE_ORDER = exports.ACTION_PLACE_ORDER = exports.ACTION_OPEN_POSITION = exports.ACTION_LIQUIDATE = exports.ACTION_INCREASE_POSITION = exports.ACTION_DEPOSIT_COLLATERAL = exports.ACTION_DECREASE_POSITION = exports.ACTION_CLOSE_POSITION = exports.ACTION_CANCEL_PRE_ORDER = exports.ACTION_CANCEL_ORDER = exports.ACTION_ADD_PRE_ORDER = exports.loadConfig = exports.clearConfigCache = exports.WORMHOLE_DEFAULTS = exports.PerpClient = void 0;
+exports.parsePythSchedule = exports.missingOracleCredentials = exports.deriveOracleSources = exports.isFreshWaterxEntry = exports.getMarketStatus = exports.fetchWaterxUpdateData = exports.fetchWaterxSignedUpdate = exports.fetchWaterxSignedLeaves = exports.fetchPythSymbolCatalog = exports.fetchPythProHistory = exports.assertOracleWriteCoverage = exports.assertOracleWeightCoverage = exports.ORACLE_SOURCES = exports.aggregateTickerWithConstant = exports.aggregateTicker = exports.OracleSourceNotImplementedError = exports.OracleWeightUnreadableError = exports.OracleWeightCoverageError = exports.OracleTickerUnservedError = exports.LazerNotEntitledError = exports.LazerApiKeyMissingError = exports.FetchPolicyError = exports.calcEstLiqPriceRawFromView = exports.formatFundingInterval = exports.rawPrice = exports.decodeFundingIndexDelta = exports.calcWlpRedeemOut = exports.calcWlpPrice = exports.calcWlpMintOut = exports.calcWlpIncentiveApy = exports.calcViewEstLiqFeesUsd = exports.calcUnrealizedPnl = exports.calcTotalTradingFeeRate = exports.calcTokenUtilizationBps = exports.calcRealLiqNetCostUsd = exports.calcPositionBorrowFee = exports.calcNotional = exports.calcMaxReducibleCollateralUsd = exports.calcLeverage = exports.calcImpactFeeRate = exports.calcFundingRate = exports.calcFundingFeeUsd = exports.calcFee = exports.calcEstLiqPriceRaw = exports.calcEstLiqPrice = exports.calcEffectiveCollateralUsd = exports.calcDynamicFeeBps = exports.calcBorrowRateAccrual = exports.calcBorrowRate = exports.annualizeFundingRate = void 0;
+exports.withdrawalQueueCalls = exports.nativeCustodyCalls = exports.referralCalls = exports.oracleCalls = exports.stakingCalls = exports.wxaAccountCalls = exports.viewCalls = exports.lpPoolCalls = exports.tradingCalls = exports.MarketConfigBcs = exports.MarketBcs = exports.OrderBcs = exports.PositionBcs = exports.TokenPoolDataBcs = exports.RedeemRequestDataBcs = exports.PositionDataBcs = exports.PoolDataBcs = exports.OrderDataBcs = exports.MarketDataBcs = exports.GlobalConfigDataBcs = exports.AccountDataBcs = exports.waitForVaa = exports.vaaBytesToBase64 = exports.vaaBase64ToHex = exports.vaaBase64ToBytes = exports.toWormholescanEmitter = exports.padEvmEmitter = exports.listVaasByEmitter = exports.listBridgeWithdrawalVaas = exports.fetchVaa = exports.fetchDepositVaa = exports.waterxQuoteCenterEndpoint = exports.MERKLE_ROOT_INTENT = exports.parseSignedLeaves = exports.waterxLeavesOf = exports.waterxEnvelopeOf = exports.WATERX_MAX_PRICE_AGE_MS = exports.servableTickers = exports.resolveOracleRule = exports.resolveOracleReadPlan = exports.refreshOraclePrices = exports.readQuoteCenterPrices = exports.readPlanTickers = exports.readLazerPrices = exports.pullWaterxQuotes = exports.PythScheduleParseError = void 0;
 // ======== Core ========
 var client_ts_1 = require("./client.js");
 Object.defineProperty(exports, "PerpClient", { enumerable: true, get: function () { return client_ts_1.PerpClient; } });
@@ -95,7 +95,6 @@ Object.defineProperty(exports, "TOKEN_DECIMALS", { enumerable: true, get: functi
 // ======== Utilities ========
 var config_ts_2 = require("../utils/config.js");
 Object.defineProperty(exports, "getMarketTickers", { enumerable: true, get: function () { return config_ts_2.getMarketTickers; } });
-Object.defineProperty(exports, "getCollateralAssets", { enumerable: true, get: function () { return config_ts_2.getCollateralAssets; } });
 var math_ts_1 = require("../utils/math.js");
 Object.defineProperty(exports, "annualizedApyFromRatio", { enumerable: true, get: function () { return math_ts_1.annualizedApyFromRatio; } });
 Object.defineProperty(exports, "annualizeFundingRate", { enumerable: true, get: function () { return math_ts_1.annualizeFundingRate; } });
@@ -134,27 +133,55 @@ __exportStar(require("./user/index.js"), exports);
 __exportStar(require("./tx-builders.js"), exports);
 // ======== Read-only queries ========
 __exportStar(require("./fetch.js"), exports);
-// ======== Oracle utilities (Pyth source + rule aggregation) ========
+// ======== Oracle utilities (sources + rule aggregation + read planes) ========
 var index_ts_1 = require("../oracle/index.js");
 Object.defineProperty(exports, "FetchPolicyError", { enumerable: true, get: function () { return index_ts_1.FetchPolicyError; } });
 Object.defineProperty(exports, "LazerApiKeyMissingError", { enumerable: true, get: function () { return index_ts_1.LazerApiKeyMissingError; } });
-Object.defineProperty(exports, "OracleFeeSourceUnavailableError", { enumerable: true, get: function () { return index_ts_1.OracleFeeSourceUnavailableError; } });
+Object.defineProperty(exports, "LazerNotEntitledError", { enumerable: true, get: function () { return index_ts_1.LazerNotEntitledError; } });
+Object.defineProperty(exports, "OracleTickerUnservedError", { enumerable: true, get: function () { return index_ts_1.OracleTickerUnservedError; } });
+Object.defineProperty(exports, "OracleWeightCoverageError", { enumerable: true, get: function () { return index_ts_1.OracleWeightCoverageError; } });
+Object.defineProperty(exports, "OracleWeightUnreadableError", { enumerable: true, get: function () { return index_ts_1.OracleWeightUnreadableError; } });
 Object.defineProperty(exports, "OracleSourceNotImplementedError", { enumerable: true, get: function () { return index_ts_1.OracleSourceNotImplementedError; } });
-Object.defineProperty(exports, "PythCache", { enumerable: true, get: function () { return index_ts_1.PythCache; } });
 Object.defineProperty(exports, "aggregateTicker", { enumerable: true, get: function () { return index_ts_1.aggregateTicker; } });
 Object.defineProperty(exports, "aggregateTickerWithConstant", { enumerable: true, get: function () { return index_ts_1.aggregateTickerWithConstant; } });
-Object.defineProperty(exports, "aggregateTickerWithPyth", { enumerable: true, get: function () { return index_ts_1.aggregateTickerWithPyth; } });
 Object.defineProperty(exports, "ORACLE_SOURCES", { enumerable: true, get: function () { return index_ts_1.ORACLE_SOURCES; } });
-Object.defineProperty(exports, "buildPythPriceUpdateCalls", { enumerable: true, get: function () { return index_ts_1.buildPythPriceUpdateCalls; } });
-Object.defineProperty(exports, "fetchPriceFeedsUpdateData", { enumerable: true, get: function () { return index_ts_1.fetchPriceFeedsUpdateData; } });
-Object.defineProperty(exports, "isOracleSource", { enumerable: true, get: function () { return index_ts_1.isOracleSource; } });
-Object.defineProperty(exports, "parseOracleSourceList", { enumerable: true, get: function () { return index_ts_1.parseOracleSourceList; } });
-Object.defineProperty(exports, "pythCoreHermesEndpoint", { enumerable: true, get: function () { return index_ts_1.pythCoreHermesEndpoint; } });
-Object.defineProperty(exports, "pythProHermesEndpoint", { enumerable: true, get: function () { return index_ts_1.pythProHermesEndpoint; } });
+Object.defineProperty(exports, "assertOracleWeightCoverage", { enumerable: true, get: function () { return index_ts_1.assertOracleWeightCoverage; } });
+Object.defineProperty(exports, "assertOracleWriteCoverage", { enumerable: true, get: function () { return index_ts_1.assertOracleWriteCoverage; } });
+Object.defineProperty(exports, "fetchPythProHistory", { enumerable: true, get: function () { return index_ts_1.fetchPythProHistory; } });
+Object.defineProperty(exports, "fetchPythSymbolCatalog", { enumerable: true, get: function () { return index_ts_1.fetchPythSymbolCatalog; } });
+Object.defineProperty(exports, "fetchWaterxSignedLeaves", { enumerable: true, get: function () { return index_ts_1.fetchWaterxSignedLeaves; } });
+Object.defineProperty(exports, "fetchWaterxSignedUpdate", { enumerable: true, get: function () { return index_ts_1.fetchWaterxSignedUpdate; } });
+Object.defineProperty(exports, "fetchWaterxUpdateData", { enumerable: true, get: function () { return index_ts_1.fetchWaterxUpdateData; } });
+Object.defineProperty(exports, "getMarketStatus", { enumerable: true, get: function () { return index_ts_1.getMarketStatus; } });
+Object.defineProperty(exports, "isFreshWaterxEntry", { enumerable: true, get: function () { return index_ts_1.isFreshWaterxEntry; } });
+Object.defineProperty(exports, "deriveOracleSources", { enumerable: true, get: function () { return index_ts_1.deriveOracleSources; } });
+Object.defineProperty(exports, "missingOracleCredentials", { enumerable: true, get: function () { return index_ts_1.missingOracleCredentials; } });
+Object.defineProperty(exports, "parsePythSchedule", { enumerable: true, get: function () { return index_ts_1.parsePythSchedule; } });
+Object.defineProperty(exports, "PythScheduleParseError", { enumerable: true, get: function () { return index_ts_1.PythScheduleParseError; } });
+// THE quote-center route ladder (leaves-first, envelope only where there is
+// no leaf route). Both SDK planes go through it, so a consumer running its
+// own prefetch reaches for the same one rather than re-deriving the ladder.
+Object.defineProperty(exports, "pullWaterxQuotes", { enumerable: true, get: function () { return index_ts_1.pullWaterxQuotes; } });
+Object.defineProperty(exports, "readLazerPrices", { enumerable: true, get: function () { return index_ts_1.readLazerPrices; } });
+Object.defineProperty(exports, "readPlanTickers", { enumerable: true, get: function () { return index_ts_1.readPlanTickers; } });
+Object.defineProperty(exports, "readQuoteCenterPrices", { enumerable: true, get: function () { return index_ts_1.readQuoteCenterPrices; } });
 Object.defineProperty(exports, "refreshOraclePrices", { enumerable: true, get: function () { return index_ts_1.refreshOraclePrices; } });
-Object.defineProperty(exports, "resolveHermesReadEndpoint", { enumerable: true, get: function () { return index_ts_1.resolveHermesReadEndpoint; } });
-Object.defineProperty(exports, "updatePythPrices", { enumerable: true, get: function () { return index_ts_1.updatePythPrices; } });
+Object.defineProperty(exports, "resolveOracleReadPlan", { enumerable: true, get: function () { return index_ts_1.resolveOracleReadPlan; } });
+Object.defineProperty(exports, "resolveOracleRule", { enumerable: true, get: function () { return index_ts_1.resolveOracleRule; } });
+// `refreshOraclePrices`' OWN acceptance predicate. Consumers filtering a
+// ticker list before a build must use this rather than re-deriving "some
+// listed source carries it", or they drift from what the build accepts.
+Object.defineProperty(exports, "servableTickers", { enumerable: true, get: function () { return index_ts_1.servableTickers; } });
+Object.defineProperty(exports, "WATERX_MAX_PRICE_AGE_MS", { enumerable: true, get: function () { return index_ts_1.WATERX_MAX_PRICE_AGE_MS; } });
 Object.defineProperty(exports, "waterxEnvelopeOf", { enumerable: true, get: function () { return index_ts_1.waterxEnvelopeOf; } });
+// Leaves are the DEFAULT waterx wire shape, so their accessor + parser belong
+// on the same surface as `waterxEnvelopeOf` (and on the root, which re-exports
+// this file). A prefetch cache written against the envelope-only surface would
+// otherwise get `null` from its only accessor on the normal path and have to
+// discover `@waterx/sdk/oracle` to fix it.
+Object.defineProperty(exports, "waterxLeavesOf", { enumerable: true, get: function () { return index_ts_1.waterxLeavesOf; } });
+Object.defineProperty(exports, "parseSignedLeaves", { enumerable: true, get: function () { return index_ts_1.parseSignedLeaves; } });
+Object.defineProperty(exports, "MERKLE_ROOT_INTENT", { enumerable: true, get: function () { return index_ts_1.MERKLE_ROOT_INTENT; } });
 Object.defineProperty(exports, "waterxQuoteCenterEndpoint", { enumerable: true, get: function () { return index_ts_1.waterxQuoteCenterEndpoint; } });
 // ======== Wormhole / Wormholescan utilities (credit bridge) ========
 var wormhole_ts_1 = require("../account/funding/wormhole.js");
@@ -192,8 +219,6 @@ exports.viewCalls = __importStar(require("../generated/waterx_perp_view/view.js"
 exports.wxaAccountCalls = __importStar(require("../generated/waterx_account/account.js"));
 exports.stakingCalls = __importStar(require("../generated/waterx_staking/waterx_staking.js"));
 exports.oracleCalls = __importStar(require("../generated/waterx_oracle/oracle.js"));
-exports.pythRuleCalls = __importStar(require("../generated/waterx_pyth_rule/pyth_rule.js"));
-exports.pythSponsorRuleCalls = __importStar(require("../generated/pyth_sponsor_rule/pyth_sponsor_rule.js"));
 exports.referralCalls = __importStar(require("../generated/waterx_referral/referral_table.js"));
 exports.nativeCustodyCalls = __importStar(require("../generated/native_custody/custody_vault.js"));
 exports.withdrawalQueueCalls = __importStar(require("../generated/withdrawal_queue/withdrawal_queue.js"));

package/dist/cjs/src/perp/tx-builders/common.d.ts

@@ -1,44 +1,58 @@
 /**
  * Shared scaffolding for the high-level perp `build*Tx` composers:
  * `CommonBuildOpts`, the new-or-reuse PTB helper, the WLP pool-oracle refresh,
- * and the request+execute envelope (optional Pyth-sponsor flow + pre-sweep).
+ * and the request+execute envelope (optional pre-sweep).
  */
 import { Transaction, type TransactionArgument } from "@mysten/sui/transactions";
-import { PythCache, type OracleFeeSource, type UpdateDataProvider } from "../../oracle/index.ts";
+import { type OracleRefreshSummary, type UpdateDataProvider } from "../../oracle/index.ts";
 import type { PerpClient } from "../client.ts";
 export interface CommonBuildOpts {
     /** Append to an existing PTB instead of creating a new one. */
     tx?: Transaction;
-    /** Skip oracle refresh entirely (caller manages freshness). Default: false. */
-    skipOraclePriceRefresh?: boolean;
-    /** Share a `PythCache` across builders to avoid redundant pyth_state reads. */
-    pythCache?: PythCache;
     /**
-     * @deprecated No longer a fee-source decision. `wrapRequestAndExecute` now
-     * opens (and reimburses) the `pyth_sponsor_rule` Fund purely from config
-     * presence — whenever `client.config.packages.pyth_sponsor_rule` is
-     * deployed, the fund is ALWAYS opened, regardless of this flag (see
-     * `OracleFeeSourceUnavailable` in `oracle/pyth.ts`). This closes the gap
-     * where a market whose checklist required `PythSponsorRule`, or a caller
-     * that mis-set this flag, silently drew from `tx.gas` and failed
-     * ON-CHAIN instead of at build time. Use `allowGasFee` for the
-     * non-sponsored case instead. Kept accepted (as a no-op) only so existing
-     * callers keep compiling; will be removed in a future major version.
+     * Skip oracle refresh entirely (caller manages freshness). Default: false.
+     *
+     * This is the SHARED-REFRESH composition lever: a caller batching several
+     * builders into one PTB refreshes once, up front, then passes the same `tx`
+     * to each builder with this flag set —
+     *
+     *   const tx = new Transaction();
+     *   await refreshOraclePrices(tx, client.perp, allTickers);
+     *   await buildIncreasePositionTx(client.perp, { ...a, tx, skipOraclePriceRefresh: true });
+     *   await buildPlaceOrderTx(client.perp, { ...b, tx, skipOraclePriceRefresh: true });
+     *
+     * — one refresh covering `allTickers` (every builder's market + collateral
+     * tickers + the WLP pool tokens) instead of N. This is not just a gas
+     * saving: under `waterx_rule` a repeated per-builder refresh would submit
+     * the same signed timestamp twice per symbol in one PTB, paying full
+     * verification for an on-chain abstain (the F-014 per-symbol replay
+     * high-water mark).
+     *
+     * Sharing one fetched waterx snapshot across CONCURRENT builds is safe on
+     * these paths: every builder here feeds through `collect_*`, where a
+     * replayed per-symbol timestamp ABSTAINS rather than aborting — the chain
+     * already holds a price at least that fresh. `EReplayedSignature` is raised
+     * only by the single-rule `feed_*` entries, which no `build*Tx` uses. The
+     * cost of sharing is a contribution that does not count, not a failed
+     * transaction.
      */
-    useSponsor?: boolean;
+    skipOraclePriceRefresh?: boolean;
     /**
-     * Explicit opt-in to draw the Pyth update fee from `tx.gas` when this
-     * client's config has no `pyth_sponsor_rule` deployed. Ignored whenever a
-     * sponsor fund IS available — the sponsor pool always wins over `tx.gas`
-     * when one can be opened (see `useSponsor`'s deprecation note above).
-     * Required for flows with no `TradingRequest` to reimburse a sponsor fund
-     * against (e.g. `buildMintWlpTx` — see its doc comment). Building an
-     * oracle refresh with neither a sponsor fund nor this flag throws
-     * `OracleFeeSourceUnavailable` instead of silently drawing from `tx.gas`
-     * (Enoki-sponsored transactions reject any `tx.gas` draw). Default:
-     * `false`.
+     * Build even when a ticker this action depends on could not be refreshed.
+     *
+     * `refreshOraclePrices` SKIPS tickers no listed source serves (it is a broad
+     * primitive — losing 29 tickers because the 30th is unconfigured is the wrong
+     * trade). The composers then fail closed on the subset their specific action
+     * actually depends on. This opts out of that check, building against whatever
+     * price the chain already holds.
+     *
+     * Rarely correct. The on-chain guards do NOT cover for it: `mint_wlp` sizes
+     * the payout off `pool.tvl_usd`, and `assert_prices_fresh` only compares each
+     * token's `last_price_refresh_timestamp` against
+     * `price_refresh_threshold_ms` — so a pool asset last refreshed by SOMEONE
+     * ELSE minutes ago passes, and the mint is valued off that stale price.
      */
-    allowGasFee?: boolean;
+    allowUnrefreshedPrices?: boolean;
     /**
      * Pre-sweep parked backing assets (USDC, USDsui, …) at the wxa account's
      * address into USD credit, plus any CREDIT coins/funds at the address into
@@ -73,36 +87,63 @@ interface RequestParams {
     lpType?: string;
 }
 export declare function newTx(opts?: CommonBuildOpts): Transaction;
+/**
+ * Fail the build when a ticker THIS action depends on went unrefreshed.
+ *
+ * The split of responsibility: `refreshOraclePrices` skips (it cannot know
+ * which of its tickers were load-bearing), the composer asserts (it does).
+ */
+export declare function assertTickersRefreshed(client: PerpClient, summary: OracleRefreshSummary, required: string[], opts: CommonBuildOpts | undefined, 
+/** Appended to the error, to say why THESE tickers were load-bearing. */
+why?: string): void;
+/**
+ * Fail the build when ANY WLP pool asset went unpriced — stricter than
+ * {@link assertTickersRefreshed}, and deliberately so.
+ *
+ * `mint_wlp` / `settle_redeem` take `&WlpAum` and size the payout against the
+ * pool's WHOLE `tvl_usd`, so a stale price on any pool asset mis-values the
+ * trade — not just a stale price on the deposit ticker.
+ *
+ * Nothing on chain catches the gap. Two paths, neither of which fails:
+ *   - the asset IS bumped: `update_token_value` calls `oracle::get_price`,
+ *     which aborts `EStalePrice` unless this PTB aggregated it — loud, safe;
+ *   - the asset is NOT bumped (it was skipped, so no leg was emitted): its
+ *     `last_price_refresh_timestamp` keeps whatever a previous transaction
+ *     left, and `assert_prices_fresh` only asks that it be within
+ *     `price_refresh_threshold_ms`. A recent-enough stale price PASSES.
+ *
+ * So the silent case is exactly the skipped one, and the build is the only
+ * place it can be caught.
+ */
+export declare function assertWlpPoolRefreshed(client: PerpClient, summary: OracleRefreshSummary, opts: CommonBuildOpts | undefined): void;
 /**
  * Refresh every WLP pool-token oracle (+ caller-supplied extra tickers) and
  * bump each pool token's `last_price_refresh_timestamp` so the pool's
  * `assert_prices_fresh` passes when the next `mint_wlp` / `request_redeem` /
  * trading `execute` runs in the same PTB.
+ *
+ * Fails closed via {@link assertWlpPoolRefreshed} — see there for why a gap is
+ * otherwise silent rather than an on-chain abort.
  */
-export declare function refreshWlpPoolOracles(tx: Transaction, client: PerpClient, extraTickers: string[], opts: {
-    cache?: PythCache;
-    /** Forwarded to `refreshOraclePrices` — already resolved by the caller (see `OracleFeeSource`). */
-    feeSource?: OracleFeeSource;
+export declare function refreshWlpPoolOracles(tx: Transaction, client: PerpClient, extraTickers: string[], 
+/** The build's options — `lpType`, plus `allowUnrefreshedPrices` / `updateDataProvider`. */
+opts: CommonBuildOpts & {
     lpType?: string;
-    updateDataProvider?: UpdateDataProvider;
-}): Promise<void>;
+}): Promise<OracleRefreshSummary>;
 /**
- * Build the *Request + execute envelope with the config-driven Pyth sponsor flow:
+ * Build the *Request + execute envelope:
  *
  *   [maybeConsolidate(tx)]
- *   [fund = sponsor.request()]
- *   refreshOraclePrices(..., feeSource?)
+ *   refreshOraclePrices(...)
  *   req = buildRequest()
- *   [sponsor.reimburse(fund, req)]
  *   trading::execute(req)
  *
  * Accepted ordering caveat: `maybeConsolidate` runs FIRST and can itself
- * append PTB commands (the consolidation sweep) before the fee-source check
- * inside `refreshOraclePrices` ever runs — so an `OracleFeeSourceUnavailable`
- * throw here is NOT the "zero commands appended" guarantee
- * `refreshOraclePrices` gives its own callers (see its docblock in
- * `aggregate.ts`); `tx` can already carry the sweep. This is the same
- * discard-tx-on-throw contract every `build*Tx` composer already has for
+ * append PTB commands (the consolidation sweep) before the refresh's own
+ * pre-checks run — so a throw out of `refreshOraclePrices` here is NOT the
+ * "zero commands appended" guarantee it gives its own callers (see its
+ * docblock in `aggregate.ts`); `tx` can already carry the sweep. This is the
+ * same discard-tx-on-throw contract every `build*Tx` composer already has for
  * mid-build on-chain-read failures — not a new hole. It matters only for a
  * caller that passed in their OWN `opts.tx` (reusing one `Transaction`
  * across builder calls, e.g. to compose several actions in one PTB); such a
@@ -111,10 +152,7 @@ export declare function refreshWlpPoolOracles(tx: Transaction, client: PerpClien
  */
 export declare function wrapRequestAndExecute(client: PerpClient, tx: Transaction, req: RequestParams & {
     accountId: string;
-}, collateralTicker: string, opts: CommonBuildOpts | undefined, buildRequest: (sponsorFund?: {
-    fund: TransactionArgument;
-    packageId: string;
-}) => TransactionArgument): Promise<void>;
+}, collateralTicker: string, opts: CommonBuildOpts | undefined, buildRequest: () => TransactionArgument): Promise<void>;
 /** Run the async sweep iff `consolidateToUsd !== false`. */
 export declare function maybeConsolidate(client: PerpClient, tx: Transaction, accountId: string, opts: CommonBuildOpts | undefined): Promise<void>;
 export {};