@oddmaki-protocol/sdk 1.9.0 → 1.10.0

package/dist/index.d.mts

@@ -9529,15 +9529,24 @@ interface PriceMarketData {
     finalPrice: bigint;
     resolutionWindow: bigint;
     resolved: boolean;
+    /**
+     * Reference price for resolution.
+     * - Explicit-strike markets: set at creation, never changes.
+     * - Deferred Up/Down markets: 0 at creation, populated at resolution with the
+     *   open price captured from the earliest Hermes VAA in
+     *   `[openTime, openTime + resolutionWindow]`.
+     */
     strikePrice: bigint;
     /**
-     * Pyth VAA publishTime for the opening-price capture (seconds since epoch).
-     * 0 for strike markets (no opening price is captured).
+     * Pyth VAA publishTime of the open-price capture (seconds since epoch).
+     * - Explicit-strike markets: always 0 (no open price is captured).
+     * - Deferred Up/Down markets: 0 until resolution, then set to the open VAA's
+     *   publishTime.
      */
     openPriceTime: bigint;
 }
 /**
- * Latest Pyth price update data plus the signed VAA's publishTime.
+ * Latest Pyth price update plus the signed VAA's publishTime.
  * `fetchedAt` is the SDK-local unix timestamp (seconds) at fetch time.
  */
 interface PythUpdate {
@@ -9545,31 +9554,66 @@ interface PythUpdate {
     publishTime: bigint;
     fetchedAt: bigint;
 }
+/**
+ * Projected open price for a deferred Up/Down market that hasn't resolved yet.
+ * Derived from the same Hermes VAA the on-chain resolver will pick.
+ */
+interface ProjectedOpenPrice {
+    /** Price extracted from the open-window Hermes VAA (Pyth feed-native units). */
+    price: bigint;
+    /** publishTime of the VAA (seconds since epoch). */
+    publishTime: bigint;
+    /** Pyth's price exponent for the feed (e.g. -8). Convenience for UI formatting. */
+    expo: number;
+    /**
+     * `true` once `block.timestamp >= openTime + resolutionWindow` — past that point
+     * every client querying Hermes the same way agrees on the same VAA and the
+     * on-chain strike at resolution will equal this exact `price`. Before that,
+     * the value is a best-effort projection that could shift slightly as Hermes
+     * publishes new VAAs inside the window.
+     */
+    canonical: boolean;
+    /** The market's openTime this projection corresponds to. */
+    openTime: bigint;
+}
 declare class PriceMarketModule extends BaseModule {
     /**
-     * Create a Pyth-powered price market
+     * Create a Pyth-powered price market. Three shapes via one entry point:
+     *
+     * - **Immediate Up/Down** (`strikePrice = 0`, `openTime = 0` or omitted):
+     *   `openTime` is set to `block.timestamp` at creation; open price is
+     *   captured at resolution from the earliest Hermes VAA in
+     *   `[openTime, openTime + resolutionWindow]`.
+     *
+     * - **Scheduled Up/Down** (`strikePrice = 0`, `openTime > now`):
+     *   Market exists from creation and is tradable. At `openTime` the open
+     *   price window begins; capture happens at resolution as above.
      *
-     * When strikePrice > 0, creates a strike market resolved against
-     * the explicit target price. No Pyth update data or ETH is needed.
-     * When strikePrice is 0 or omitted, captures the current Pyth price
-     * and uses it as the reference (standard Up/Down market).
+     * - **Explicit strike** (`strikePrice > 0`): Above/Below market resolved
+     *   against the caller-supplied target. `openTime` is ignored and stored
+     *   as `block.timestamp`; no open-price capture occurs at resolution.
+     *
+     * Creation never touches Pyth — no VAA submission, no Pyth fee. The
+     * resolver pays Pyth fees later when calling {@link resolvePyth}.
      *
      * @param params.venueId - The venue to create the market in
      * @param params.pythFeedId - Pyth price feed ID (e.g., ETH/USD)
-     * @param params.strikePrice - Target price in feed's exponent scale (0 = use current price)
-     * @param params.closeTime - Absolute close timestamp (must be 300–86400s from now)
+     * @param params.strikePrice - Target price (0 = capture open at resolution)
+     * @param params.openTime - When the market opens (0 = immediate / now)
+     * @param params.closeTime - Absolute close timestamp (must be > effective openTime)
      * @param params.outcomes - Market outcome labels (e.g., ["Up", "Down"] or ["Above", "Below"])
-     * @param params.tickSize - Price increment for the orderbook
+     * @param params.tickSize - Price increment for the orderbook (1e15 or 1e16)
      * @param params.collateralToken - ERC20 collateral token address
-     * @param params.question - Market question for UMA ancillary data (fallback)
+     * @param params.question - Market question for ancillary data
      * @param params.liveness - UMA challenge period in seconds (0 = default)
      * @param params.tags - Optional tags for the market
-     * @param params.resolutionWindow - Pyth timestamp tolerance in seconds (0 = default 60s)
+     * @param params.resolutionWindow - Pyth timestamp tolerance in seconds (0 = default 60s, max 300s)
      */
     createPyth(params: {
         venueId: bigint;
         pythFeedId: `0x${string}`;
         strikePrice?: bigint;
+        openTime?: bigint;
         closeTime: bigint;
         outcomes?: string[];
         tickSize: bigint;
@@ -9580,11 +9624,14 @@ declare class PriceMarketModule extends BaseModule {
         resolutionWindow?: bigint;
     }): Promise<`0x${string}`>;
     /**
-     * Resolve a price market using Pyth closing price
+     * Resolve a price market using Pyth.
      *
-     * Anyone can call this after the market's closeTime has passed.
-     * Fetches the historical Pyth price at closeTime and submits it.
-     * Works for both standard price markets and strike markets.
+     * Anyone can call this after `closeTime`. For deferred Up/Down markets
+     * (`strikePrice == 0`), the SDK fetches **two** Hermes VAAs — one for the
+     * open window, one for the close window — and submits them together so the
+     * on-chain facet can capture the open price and compare against the close
+     * in a single transaction. For explicit-strike markets only the close VAA
+     * is fetched.
      */
     resolvePyth(marketId: bigint): Promise<`0x${string}`>;
     /**
@@ -9592,7 +9639,7 @@ declare class PriceMarketModule extends BaseModule {
      */
     isPriceMarket(marketId: bigint): Promise<boolean>;
     /**
-     * Check if a price market can be resolved
+     * Check if a price market can be resolved (closeTime reached and not yet resolved).
      */
     canResolve(marketId: bigint): Promise<boolean>;
     /**
@@ -9607,46 +9654,29 @@ declare class PriceMarketModule extends BaseModule {
      * Set the Pyth oracle contract address. Diamond owner only.
      */
     setPythContract(pythContract: Address): Promise<`0x${string}`>;
-    /**
-     * Get the effective opening-price staleness window in seconds.
-     *
-     * A submitted VAA's `publishTime` must fall within
-     * `[block.timestamp - openMaxStaleness, block.timestamp + OPEN_FUTURE_SKEW]`
-     * at `createPriceMarketPyth` time. Defaults to 300s when unset on-chain.
-     */
-    getOpenMaxStaleness(): Promise<bigint>;
-    /**
-     * Set the opening-price staleness window (seconds). Diamond owner only.
-     * Pass 0 to fall back to the built-in default.
-     */
-    setOpenMaxStaleness(openMaxStaleness: bigint): Promise<`0x${string}`>;
     /**
      * Shared pre-flight checks: creation fee allowance, ancillary data, tags
      */
     private _prepareCreationCommon;
-    /**
-     * Fetch Pyth update data and compute the required ETH value (for Up/Down markets)
-     */
-    private _preparePythUpdate;
     private formatAncillaryData;
     /**
-     * Fetch latest Pyth price update from Hermes — bytes plus the VAA's publishTime.
+     * Fetch the latest Pyth price update from Hermes — the bytes plus the
+     * VAA's publishTime.
      *
-     * Use this (or {@link fetchFreshPythUpdate}) instead of re-rolling Hermes
-     * calls when building `createPriceMarketPyth` transactions. The on-chain
-     * staleness window defaults to 300s — if the user takes longer than that
-     * to sign, the VAA will be rejected.
+     * Useful for UI projected-strike display: callers can render the current
+     * Pyth price (and its publishTime) before a deferred market's open window
+     * closes, then switch to the on-chain strike once resolution happens.
      */
     fetchPythLatestUpdate(feedId: `0x${string}`): Promise<PythUpdate>;
     /**
-     * Return a Pyth update that is fresh enough to pass the on-chain staleness check.
+     * Return a Pyth update that is fresh enough for client-side projected-strike
+     * display.
      *
-     * If `cached` is provided and still within `maxAgeSeconds`, it is returned as-is.
-     * Otherwise Hermes is re-queried; if the newly fetched VAA is also older than
-     * `maxAgeSeconds` (e.g. feed is quiet), it retries up to `maxAttempts`.
+     * If `cached` is provided and still within `maxAgeSeconds`, returns it
+     * unchanged. Otherwise re-queries Hermes; if the new VAA is also stale
+     * (quiet feed), retries up to `maxAttempts`.
      *
-     * Defaults: `maxAgeSeconds = 120` (leaves ~180s headroom under the 300s default
-     * on-chain window), `maxAttempts = 3`.
+     * Defaults: `maxAgeSeconds = 120`, `maxAttempts = 3`.
      */
     fetchFreshPythUpdate(feedId: `0x${string}`, options?: {
         maxAgeSeconds?: number;
@@ -9654,11 +9684,30 @@ declare class PriceMarketModule extends BaseModule {
         cached?: PythUpdate;
     }): Promise<PythUpdate>;
     /**
-     * Fetch latest Pyth price update data from Hermes API (raw bytes only).
+     * Resolve the projected open price for a deferred Up/Down market — what the
+     * UI should display as the "strike" between `openTime` and resolution.
+     *
+     * For deferred markets, the on-chain `strikePrice` is 0 until the resolver
+     * fires {@link resolvePyth}. This helper replicates the same rule the
+     * contract will use ("earliest in-window Hermes VAA in
+     * `[openTime, openTime + resolutionWindow]`") by querying Hermes at
+     * `openTime`, so the value rendered in the UI matches what the on-chain
+     * strike will be once resolution lands.
+     *
+     * Returns `null` when the projection isn't applicable:
+     * - The market is already resolved — caller should read `pm.strikePrice` directly.
+     * - The market is explicit-strike (`pm.strikePrice > 0`) — same, read from chain.
+     * - The market hasn't reached `openTime` yet — no VAA exists; UI should show
+     *   "strike set at HH:MM" or similar pending state.
+     *
+     * `result.canonical === true` means the open window has fully elapsed and the
+     * value will not change. Before that, render the price with a "pending" hint.
      */
-    private fetchPythUpdateData;
+    fetchProjectedOpenPrice(marketId: bigint): Promise<ProjectedOpenPrice | null>;
     /**
-     * Fetch historical Pyth price update data at a specific timestamp
+     * Fetch historical Pyth price update data at a specific timestamp.
+     * Used internally by {@link resolvePyth} to fetch open-window and
+     * close-window VAAs.
      */
     private fetchPythHistoricalData;
 }
@@ -15354,6 +15403,11 @@ var PythResolutionFacet = [
 				type: "int64",
 				internalType: "int64"
 			},
+			{
+				name: "openTime",
+				type: "uint256",
+				internalType: "uint256"
+			},
 			{
 				name: "closeTime",
 				type: "uint256",
@@ -15393,11 +15447,6 @@ var PythResolutionFacet = [
 				name: "resolutionWindow",
 				type: "uint256",
 				internalType: "uint256"
-			},
-			{
-				name: "pythUpdateData",
-				type: "bytes[]",
-				internalType: "bytes[]"
 			}
 		],
 		outputs: [
@@ -15407,21 +15456,7 @@ var PythResolutionFacet = [
 				internalType: "uint256"
 			}
 		],
-		stateMutability: "payable"
-	},
-	{
-		type: "function",
-		name: "getOpenMaxStaleness",
-		inputs: [
-		],
-		outputs: [
-			{
-				name: "",
-				type: "uint256",
-				internalType: "uint256"
-			}
-		],
-		stateMutability: "view"
+		stateMutability: "nonpayable"
 	},
 	{
 		type: "function",
@@ -15439,36 +15474,36 @@ var PythResolutionFacet = [
 	},
 	{
 		type: "function",
-		name: "resolvePriceMarketPyth",
+		name: "markPriceMarketInvalid",
 		inputs: [
 			{
 				name: "marketId",
 				type: "uint256",
 				internalType: "uint256"
-			},
-			{
-				name: "pythUpdateData",
-				type: "bytes[]",
-				internalType: "bytes[]"
 			}
 		],
 		outputs: [
 		],
-		stateMutability: "payable"
+		stateMutability: "nonpayable"
 	},
 	{
 		type: "function",
-		name: "setOpenMaxStaleness",
+		name: "resolvePriceMarketPyth",
 		inputs: [
 			{
-				name: "openMaxStaleness",
+				name: "marketId",
 				type: "uint256",
 				internalType: "uint256"
+			},
+			{
+				name: "pythUpdateData",
+				type: "bytes[]",
+				internalType: "bytes[]"
 			}
 		],
 		outputs: [
 		],
-		stateMutability: "nonpayable"
+		stateMutability: "payable"
 	},
 	{
 		type: "function",
@@ -15607,19 +15642,6 @@ var PythResolutionFacet = [
 		],
 		anonymous: false
 	},
-	{
-		type: "event",
-		name: "OpenMaxStalenessUpdated",
-		inputs: [
-			{
-				name: "openMaxStaleness",
-				type: "uint256",
-				indexed: false,
-				internalType: "uint256"
-			}
-		],
-		anonymous: false
-	},
 	{
 		type: "event",
 		name: "PriceMarketCreatedPyth",
@@ -15675,6 +15697,25 @@ var PythResolutionFacet = [
 		],
 		anonymous: false
 	},
+	{
+		type: "event",
+		name: "PriceMarketInvalidated",
+		inputs: [
+			{
+				name: "marketId",
+				type: "uint256",
+				indexed: true,
+				internalType: "uint256"
+			},
+			{
+				name: "caller",
+				type: "address",
+				indexed: true,
+				internalType: "address"
+			}
+		],
+		anonymous: false
+	},
 	{
 		type: "event",
 		name: "PriceMarketResolvedPyth",
@@ -15697,6 +15738,12 @@ var PythResolutionFacet = [
 				indexed: false,
 				internalType: "int64"
 			},
+			{
+				name: "openPriceTime",
+				type: "uint256",
+				indexed: false,
+				internalType: "uint256"
+			},
 			{
 				name: "outcome",
 				type: "string",
@@ -15740,19 +15787,19 @@ var PythResolutionFacet = [
 	},
 	{
 		type: "error",
-		name: "CloseTimeNotReached",
+		name: "AssertionInProgress",
 		inputs: [
 		]
 	},
 	{
 		type: "error",
-		name: "CloseTimeTooFar",
+		name: "CloseTimeNotAfterOpenTime",
 		inputs: [
 		]
 	},
 	{
 		type: "error",
-		name: "CloseTimeTooSoon",
+		name: "CloseTimeNotReached",
 		inputs: [
 		]
 	},
@@ -15790,6 +15837,12 @@ var PythResolutionFacet = [
 			}
 		]
 	},
+	{
+		type: "error",
+		name: "GracePeriodNotElapsed",
+		inputs: [
+		]
+	},
 	{
 		type: "error",
 		name: "InsufficientPythFee",
@@ -15820,6 +15873,12 @@ var PythResolutionFacet = [
 		inputs: [
 		]
 	},
+	{
+		type: "error",
+		name: "InvalidOpenTime",
+		inputs: [
+		]
+	},
 	{
 		type: "error",
 		name: "InvalidOutcomesLength",
@@ -15840,7 +15899,13 @@ var PythResolutionFacet = [
 	},
 	{
 		type: "error",
-		name: "NoValidPriceUpdate",
+		name: "NoClosePriceInWindow",
+		inputs: [
+		]
+	},
+	{
+		type: "error",
+		name: "NoOpenPriceInWindow",
 		inputs: [
 		]
 	},
@@ -16910,6 +16975,25 @@ var ERC20 = [
 		],
 		stateMutability: "view"
 	},
+	{
+		type: "function",
+		name: "mint",
+		inputs: [
+			{
+				name: "to",
+				type: "address",
+				internalType: "address"
+			},
+			{
+				name: "amount",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		outputs: [
+		],
+		stateMutability: "nonpayable"
+	},
 	{
 		type: "function",
 		name: "name",
@@ -17131,6 +17215,25 @@ var UmaOracle = [
 		],
 		stateMutability: "view"
 	},
+	{
+		type: "function",
+		name: "disputeAssertion",
+		inputs: [
+			{
+				name: "assertionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			},
+			{
+				name: "disputer",
+				type: "address",
+				internalType: "address"
+			}
+		],
+		outputs: [
+		],
+		stateMutability: "nonpayable"
+	},
 	{
 		type: "function",
 		name: "getAssertion",
@@ -17309,25 +17412,6 @@ var UmaOracle = [
 		outputs: [
 		],
 		stateMutability: "nonpayable"
-	},
-	{
-		type: "function",
-		name: "disputeAssertion",
-		inputs: [
-			{
-				name: "assertionId",
-				type: "bytes32",
-				internalType: "bytes32"
-			},
-			{
-				name: "disputer",
-				type: "address",
-				internalType: "address"
-			}
-		],
-		outputs: [
-		],
-		stateMutability: "nonpayable"
 	}
 ];
 
@@ -17474,4 +17558,4 @@ declare function parseMetadata<T extends {
 
 declare const version = "0.1.0";
 
-export { AccessControlFacet as AccessControlFacetABI, AccessControlModule, BatchOrdersFacet as BatchOrdersFacetABI, CONTRACT_ADDRESSES, type ChancePercentInput, ConditionalTokens as ConditionalTokensABI, DEFAULT_CHAIN, ERC20 as ERC20ABI, FeedProvider, GET_ALL_MARKETS_FEED, GET_ALL_MARKETS_FEED_BY_VOLUME, GET_CHART_TRADES, GET_CHART_TRADES_ALL, GET_GROUP_MARKETS, GET_LEADERBOARD, GET_MARKET, GET_MARKETS, GET_MARKETS_WITH_PRICING, GET_MARKET_GROUP, GET_MARKET_GROUPS, GET_MARKET_GROUP_ITEM, GET_MARKET_TOP_HOLDERS, GET_ORDERS, GET_PRICE_MARKET_SERIES, GET_PROTOCOL_STATS, GET_QUESTION, GET_QUESTIONS, GET_RECENT_MARKETS, GET_RECENT_TRADES, GET_TOP_OF_BOOK, GET_TRADER_CLOSED_POSITIONS, GET_TRADER_FILLS, GET_TRADER_POSITIONS, GET_TRADER_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, LimitOrdersFacet as LimitOrdersFacetABI, MarketGroupFacet as MarketGroupFacetABI, type MarketMetadata, MarketModule, MarketOrdersFacet as MarketOrdersFacetABI, type MarketQuestion, type MarketStatus, MarketsFacet as MarketsFacetABI, MatchingFacet as MatchingFacetABI, MetadataFacet as MetadataFacetABI, NegRiskFacet as NegRiskFacetABI, OddMakiClient, type OddMakiClientConfig, type OddMakiConfig, OrderBookFacet as OrderBookFacetABI, PROTOCOL_FEES, type PriceMarketData, PriceMarketFacet as PriceMarketFacetABI, PriceMarketModule, ProtocolFacet as ProtocolFacetABI, PublicModule, PythResolutionFacet as PythResolutionFacetABI, type PythUpdate, ResolutionFacet as ResolutionFacetABI, SUBGRAPH_IDS, SubgraphClient, type SubgraphMarketPriceData, TICK_SIZE_FINE, TICK_SIZE_STANDARD, TagsFacet as TagsFacetABI, TokenModule, type TopOfBookEntry, TradeModule, UMA_DEFAULTS, UmaModule, UmaOracle as UmaOracleABI, VALID_TICK_SIZES, VaultFacet as VaultFacetABI, VenueFacet as VenueFacetABI, type VenueMetadata, VenueModule, WhitelistAccessControl as WhitelistAccessControlABI, buildSubgraphGatewayUrl, calculateChancePercent, clearDecimalsCache, createExpiry, createOddMakiClient, formatAmount, formatAncillaryData, formatTimestamp, getCachedTokenDecimals, getOutcomePrice, getTokenDecimals, isValidTickSize, parseAmount, parseAncillaryData, parseMetadata, parseTokenAmount, priceToTick, resolveIPFSUri, tickToPercentage, tickToPrice, version };
+export { AccessControlFacet as AccessControlFacetABI, AccessControlModule, BatchOrdersFacet as BatchOrdersFacetABI, CONTRACT_ADDRESSES, type ChancePercentInput, ConditionalTokens as ConditionalTokensABI, DEFAULT_CHAIN, ERC20 as ERC20ABI, FeedProvider, GET_ALL_MARKETS_FEED, GET_ALL_MARKETS_FEED_BY_VOLUME, GET_CHART_TRADES, GET_CHART_TRADES_ALL, GET_GROUP_MARKETS, GET_LEADERBOARD, GET_MARKET, GET_MARKETS, GET_MARKETS_WITH_PRICING, GET_MARKET_GROUP, GET_MARKET_GROUPS, GET_MARKET_GROUP_ITEM, GET_MARKET_TOP_HOLDERS, GET_ORDERS, GET_PRICE_MARKET_SERIES, GET_PROTOCOL_STATS, GET_QUESTION, GET_QUESTIONS, GET_RECENT_MARKETS, GET_RECENT_TRADES, GET_TOP_OF_BOOK, GET_TRADER_CLOSED_POSITIONS, GET_TRADER_FILLS, GET_TRADER_POSITIONS, GET_TRADER_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, LimitOrdersFacet as LimitOrdersFacetABI, MarketGroupFacet as MarketGroupFacetABI, type MarketMetadata, MarketModule, MarketOrdersFacet as MarketOrdersFacetABI, type MarketQuestion, type MarketStatus, MarketsFacet as MarketsFacetABI, MatchingFacet as MatchingFacetABI, MetadataFacet as MetadataFacetABI, NegRiskFacet as NegRiskFacetABI, OddMakiClient, type OddMakiClientConfig, type OddMakiConfig, OrderBookFacet as OrderBookFacetABI, PROTOCOL_FEES, type PriceMarketData, PriceMarketFacet as PriceMarketFacetABI, PriceMarketModule, type ProjectedOpenPrice, ProtocolFacet as ProtocolFacetABI, PublicModule, PythResolutionFacet as PythResolutionFacetABI, type PythUpdate, ResolutionFacet as ResolutionFacetABI, SUBGRAPH_IDS, SubgraphClient, type SubgraphMarketPriceData, TICK_SIZE_FINE, TICK_SIZE_STANDARD, TagsFacet as TagsFacetABI, TokenModule, type TopOfBookEntry, TradeModule, UMA_DEFAULTS, UmaModule, UmaOracle as UmaOracleABI, VALID_TICK_SIZES, VaultFacet as VaultFacetABI, VenueFacet as VenueFacetABI, type VenueMetadata, VenueModule, WhitelistAccessControl as WhitelistAccessControlABI, buildSubgraphGatewayUrl, calculateChancePercent, clearDecimalsCache, createExpiry, createOddMakiClient, formatAmount, formatAncillaryData, formatTimestamp, getCachedTokenDecimals, getOutcomePrice, getTokenDecimals, isValidTickSize, parseAmount, parseAncillaryData, parseMetadata, parseTokenAmount, priceToTick, resolveIPFSUri, tickToPercentage, tickToPrice, version };