@oddmaki-protocol/sdk 1.12.1 → 1.13.0

package/dist/index.d.mts

@@ -17651,6 +17651,116 @@ declare function parseMetadata<T extends {
     version: number;
 }>(json: string): T | null;
 
+/**
+ * Fee-aware pricing helpers.
+ *
+ * The matching engine's mint-to-fill / merge-to-fill paths require bids/asks to
+ * cover 1.0 PLUS total fees (protocol + venue + operator). Normal fills also
+ * require taker buyers to bid at ask × (1 + totalFeeBps/10_000) for the full
+ * quantity to fill (otherwise qty is reduced to whatever the taker's deposit
+ * actually covers).
+ *
+ * These helpers compute the limit price a UI should pre-fill / display so that
+ * an order placed at the displayed tick will actually cross now.
+ */
+declare const BPS_DENOMINATOR = 10000n;
+/** Operator fee is a protocol constant, not stored per-market. */
+declare const OPERATOR_FEE_BPS = 10n;
+interface MarketFeeBps {
+    protocolFeeBps: bigint;
+    venueFeeBps: bigint;
+    /** Defaults to {@link OPERATOR_FEE_BPS} when omitted. */
+    operatorFeeBps?: bigint;
+}
+declare function getTotalFeeBps(fees: MarketFeeBps): bigint;
+interface FeeAwarePriceResult {
+    tick: bigint;
+    /** Decimal price string (e.g. "0.48"). */
+    price: string;
+    /** Which settlement path produced this crossing tick. */
+    path: 'normal' | 'mint' | 'merge';
+}
+/**
+ * Minimum BUY limit price that will fully cross right now.
+ *
+ * Considers both:
+ *  - Normal fill against same-outcome ask: limit ≥ ask × (1 + feeBps/10_000)
+ *  - Mint fill against opposite-outcome bid: limit + oppositeBid ≥ 1 × (1 + feeBps/10_000)
+ *
+ * Returns the cheaper of the two (rounded up to the nearest tick), or `null`
+ * when there is no crossable liquidity at any feasible price.
+ */
+declare function minBuyTickToCross(params: {
+    sameOutcomeAskTick: bigint | null;
+    oppositeOutcomeBidTick: bigint | null;
+    tickSize: bigint;
+    feeBps: bigint;
+}): FeeAwarePriceResult | null;
+/**
+ * Maximum SELL limit price that will fully cross right now.
+ *
+ * Considers both:
+ *  - Normal fill against same-outcome bid: limit ≤ sameOutcomeBid
+ *    (no fee adjustment — fees come out of seller's proceeds, not the limit)
+ *  - Merge fill against opposite-outcome ask: limit + oppositeAsk ≤ 1 × (1 - feeBps/10_000)
+ *
+ * Returns the higher of the two (the most favourable sell limit that still
+ * crosses), or `null` when no crossable liquidity exists.
+ */
+declare function maxSellTickToCross(params: {
+    sameOutcomeBidTick: bigint | null;
+    oppositeOutcomeAskTick: bigint | null;
+    tickSize: bigint;
+    feeBps: bigint;
+}): FeeAwarePriceResult | null;
+/**
+ * Bump a BUY taker's limit to cover total fees on a normal fill.
+ *
+ * The matching engine reduces a taker BUY's qty whenever
+ * `limit < ask × (1 + totalFeeBps/10_000)`. For a market BUY UI that already
+ * applies a slippage % on top of best ask, callers typically want to *also*
+ * include the fee bump so the user never silently partial-fills.
+ */
+declare function applyTakerFeeBuffer(askTick: bigint, feeBps: bigint, tickSize: bigint): bigint;
+/**
+ * Estimate of a BUY's economics, in human-readable units.
+ *
+ * `pricePerShare` is expected to be the **fee-inclusive effective price** the
+ * user actually pays per share (i.e. raw ask × (1 + totalFeeBps/10_000) for a
+ * normal-fill taker, or the limit tick for a passive maker order). All other
+ * fields fall out of that.
+ */
+interface BuyOutcomeEstimate {
+    /** Shares acquired. */
+    shares: number;
+    /** Total spent (cost basis). */
+    cost: number;
+    /** Total dollars received if the outcome wins (= shares, since each pays $1). */
+    payout: number;
+    /** Profit if the outcome wins (payout − cost). Polymarket's "To Win". */
+    profit: number;
+    /** Effective average price per share (the input). */
+    avgPrice: number;
+}
+/** Estimate from a known shares quantity and per-share price. */
+declare function estimateBuyFromShares(shares: number, pricePerShare: number): BuyOutcomeEstimate;
+/** Estimate from a dollar amount and a fee-inclusive avg price per share. */
+declare function estimateBuyFromAmount(amount: number, pricePerShare: number): BuyOutcomeEstimate;
+/**
+ * Estimate of a SELL's net proceeds.
+ *
+ * `pricePerShare` should be the **fee-inclusive net** the seller receives per
+ * share (i.e. raw bid × (1 − totalFeeBps/10_000) when the seller is the taker).
+ */
+interface SellOutcomeEstimate {
+    shares: number;
+    /** Effective net price per share. */
+    avgPrice: number;
+    /** Dollars the seller receives (= shares × avgPrice). */
+    proceeds: number;
+}
+declare function estimateSellFromShares(shares: number, pricePerShare: number): SellOutcomeEstimate;
+
 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_TRADER_VENUE_CLOSED_POSITIONS, GET_TRADER_VENUE_FILLS, GET_TRADER_VENUE_POSITIONS, GET_TRADER_VENUE_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, GET_VENUE_LEADERBOARD, 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 };
+export { AccessControlFacet as AccessControlFacetABI, AccessControlModule, BPS_DENOMINATOR, BatchOrdersFacet as BatchOrdersFacetABI, type BuyOutcomeEstimate, CONTRACT_ADDRESSES, type ChancePercentInput, ConditionalTokens as ConditionalTokensABI, DEFAULT_CHAIN, ERC20 as ERC20ABI, type FeeAwarePriceResult, 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_TRADER_VENUE_CLOSED_POSITIONS, GET_TRADER_VENUE_FILLS, GET_TRADER_VENUE_POSITIONS, GET_TRADER_VENUE_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, GET_VENUE_LEADERBOARD, LimitOrdersFacet as LimitOrdersFacetABI, type MarketFeeBps, 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, OPERATOR_FEE_BPS, 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, type SellOutcomeEstimate, 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, applyTakerFeeBuffer, buildSubgraphGatewayUrl, calculateChancePercent, clearDecimalsCache, createExpiry, createOddMakiClient, estimateBuyFromAmount, estimateBuyFromShares, estimateSellFromShares, formatAmount, formatAncillaryData, formatTimestamp, getCachedTokenDecimals, getOutcomePrice, getTokenDecimals, getTotalFeeBps, isValidTickSize, maxSellTickToCross, minBuyTickToCross, parseAmount, parseAncillaryData, parseMetadata, parseTokenAmount, priceToTick, resolveIPFSUri, tickToPercentage, tickToPrice, version };

package/dist/index.d.ts

@@ -17651,6 +17651,116 @@ declare function parseMetadata<T extends {
     version: number;
 }>(json: string): T | null;
 
+/**
+ * Fee-aware pricing helpers.
+ *
+ * The matching engine's mint-to-fill / merge-to-fill paths require bids/asks to
+ * cover 1.0 PLUS total fees (protocol + venue + operator). Normal fills also
+ * require taker buyers to bid at ask × (1 + totalFeeBps/10_000) for the full
+ * quantity to fill (otherwise qty is reduced to whatever the taker's deposit
+ * actually covers).
+ *
+ * These helpers compute the limit price a UI should pre-fill / display so that
+ * an order placed at the displayed tick will actually cross now.
+ */
+declare const BPS_DENOMINATOR = 10000n;
+/** Operator fee is a protocol constant, not stored per-market. */
+declare const OPERATOR_FEE_BPS = 10n;
+interface MarketFeeBps {
+    protocolFeeBps: bigint;
+    venueFeeBps: bigint;
+    /** Defaults to {@link OPERATOR_FEE_BPS} when omitted. */
+    operatorFeeBps?: bigint;
+}
+declare function getTotalFeeBps(fees: MarketFeeBps): bigint;
+interface FeeAwarePriceResult {
+    tick: bigint;
+    /** Decimal price string (e.g. "0.48"). */
+    price: string;
+    /** Which settlement path produced this crossing tick. */
+    path: 'normal' | 'mint' | 'merge';
+}
+/**
+ * Minimum BUY limit price that will fully cross right now.
+ *
+ * Considers both:
+ *  - Normal fill against same-outcome ask: limit ≥ ask × (1 + feeBps/10_000)
+ *  - Mint fill against opposite-outcome bid: limit + oppositeBid ≥ 1 × (1 + feeBps/10_000)
+ *
+ * Returns the cheaper of the two (rounded up to the nearest tick), or `null`
+ * when there is no crossable liquidity at any feasible price.
+ */
+declare function minBuyTickToCross(params: {
+    sameOutcomeAskTick: bigint | null;
+    oppositeOutcomeBidTick: bigint | null;
+    tickSize: bigint;
+    feeBps: bigint;
+}): FeeAwarePriceResult | null;
+/**
+ * Maximum SELL limit price that will fully cross right now.
+ *
+ * Considers both:
+ *  - Normal fill against same-outcome bid: limit ≤ sameOutcomeBid
+ *    (no fee adjustment — fees come out of seller's proceeds, not the limit)
+ *  - Merge fill against opposite-outcome ask: limit + oppositeAsk ≤ 1 × (1 - feeBps/10_000)
+ *
+ * Returns the higher of the two (the most favourable sell limit that still
+ * crosses), or `null` when no crossable liquidity exists.
+ */
+declare function maxSellTickToCross(params: {
+    sameOutcomeBidTick: bigint | null;
+    oppositeOutcomeAskTick: bigint | null;
+    tickSize: bigint;
+    feeBps: bigint;
+}): FeeAwarePriceResult | null;
+/**
+ * Bump a BUY taker's limit to cover total fees on a normal fill.
+ *
+ * The matching engine reduces a taker BUY's qty whenever
+ * `limit < ask × (1 + totalFeeBps/10_000)`. For a market BUY UI that already
+ * applies a slippage % on top of best ask, callers typically want to *also*
+ * include the fee bump so the user never silently partial-fills.
+ */
+declare function applyTakerFeeBuffer(askTick: bigint, feeBps: bigint, tickSize: bigint): bigint;
+/**
+ * Estimate of a BUY's economics, in human-readable units.
+ *
+ * `pricePerShare` is expected to be the **fee-inclusive effective price** the
+ * user actually pays per share (i.e. raw ask × (1 + totalFeeBps/10_000) for a
+ * normal-fill taker, or the limit tick for a passive maker order). All other
+ * fields fall out of that.
+ */
+interface BuyOutcomeEstimate {
+    /** Shares acquired. */
+    shares: number;
+    /** Total spent (cost basis). */
+    cost: number;
+    /** Total dollars received if the outcome wins (= shares, since each pays $1). */
+    payout: number;
+    /** Profit if the outcome wins (payout − cost). Polymarket's "To Win". */
+    profit: number;
+    /** Effective average price per share (the input). */
+    avgPrice: number;
+}
+/** Estimate from a known shares quantity and per-share price. */
+declare function estimateBuyFromShares(shares: number, pricePerShare: number): BuyOutcomeEstimate;
+/** Estimate from a dollar amount and a fee-inclusive avg price per share. */
+declare function estimateBuyFromAmount(amount: number, pricePerShare: number): BuyOutcomeEstimate;
+/**
+ * Estimate of a SELL's net proceeds.
+ *
+ * `pricePerShare` should be the **fee-inclusive net** the seller receives per
+ * share (i.e. raw bid × (1 − totalFeeBps/10_000) when the seller is the taker).
+ */
+interface SellOutcomeEstimate {
+    shares: number;
+    /** Effective net price per share. */
+    avgPrice: number;
+    /** Dollars the seller receives (= shares × avgPrice). */
+    proceeds: number;
+}
+declare function estimateSellFromShares(shares: number, pricePerShare: number): SellOutcomeEstimate;
+
 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_TRADER_VENUE_CLOSED_POSITIONS, GET_TRADER_VENUE_FILLS, GET_TRADER_VENUE_POSITIONS, GET_TRADER_VENUE_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, GET_VENUE_LEADERBOARD, 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 };
+export { AccessControlFacet as AccessControlFacetABI, AccessControlModule, BPS_DENOMINATOR, BatchOrdersFacet as BatchOrdersFacetABI, type BuyOutcomeEstimate, CONTRACT_ADDRESSES, type ChancePercentInput, ConditionalTokens as ConditionalTokensABI, DEFAULT_CHAIN, ERC20 as ERC20ABI, type FeeAwarePriceResult, 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_TRADER_VENUE_CLOSED_POSITIONS, GET_TRADER_VENUE_FILLS, GET_TRADER_VENUE_POSITIONS, GET_TRADER_VENUE_PROFILE, GET_TRADES, GET_UNIFIED_MARKET_FEED, GET_UNIFIED_MARKET_FEED_BY_VOLUME, GET_USER, GET_VENUES, GET_VENUE_LEADERBOARD, LimitOrdersFacet as LimitOrdersFacetABI, type MarketFeeBps, 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, OPERATOR_FEE_BPS, 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, type SellOutcomeEstimate, 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, applyTakerFeeBuffer, buildSubgraphGatewayUrl, calculateChancePercent, clearDecimalsCache, createExpiry, createOddMakiClient, estimateBuyFromAmount, estimateBuyFromShares, estimateSellFromShares, formatAmount, formatAncillaryData, formatTimestamp, getCachedTokenDecimals, getOutcomePrice, getTokenDecimals, getTotalFeeBps, isValidTickSize, maxSellTickToCross, minBuyTickToCross, parseAmount, parseAncillaryData, parseMetadata, parseTokenAmount, priceToTick, resolveIPFSUri, tickToPercentage, tickToPrice, version };

package/dist/index.js

@@ -12290,6 +12290,104 @@ function parseMetadata(json) {
   }
 }
 
+// src/utils/feeAwarePricing.ts
+var BPS_DENOMINATOR = 10000n;
+var OPERATOR_FEE_BPS = 10n;
+function getTotalFeeBps(fees) {
+  return fees.protocolFeeBps + fees.venueFeeBps + (fees.operatorFeeBps ?? OPERATOR_FEE_BPS);
+}
+function ceilDiv(numerator, denominator) {
+  return (numerator + denominator - 1n) / denominator;
+}
+function fullPriceTicks(tickSize) {
+  return 10n ** 18n / tickSize;
+}
+function minBuyTickToCross(params) {
+  const fullTicks = fullPriceTicks(params.tickSize);
+  const minTotalTicks = ceilDiv(fullTicks * (BPS_DENOMINATOR + params.feeBps), BPS_DENOMINATOR);
+  let best = null;
+  if (params.sameOutcomeAskTick && params.sameOutcomeAskTick > 0n) {
+    const tick = ceilDiv(
+      params.sameOutcomeAskTick * (BPS_DENOMINATOR + params.feeBps),
+      BPS_DENOMINATOR
+    );
+    if (tick > 0n && tick <= fullTicks) {
+      best = { tick, price: tickToPrice(tick, params.tickSize), path: "normal" };
+    }
+  }
+  if (params.oppositeOutcomeBidTick && params.oppositeOutcomeBidTick > 0n) {
+    if (params.oppositeOutcomeBidTick < minTotalTicks) {
+      const tick = minTotalTicks - params.oppositeOutcomeBidTick;
+      if (tick > 0n && tick <= fullTicks) {
+        if (!best || tick < best.tick) {
+          best = { tick, price: tickToPrice(tick, params.tickSize), path: "mint" };
+        }
+      }
+    }
+  }
+  return best;
+}
+function maxSellTickToCross(params) {
+  const fullTicks = fullPriceTicks(params.tickSize);
+  const maxMergeTotalTicks = fullTicks * (BPS_DENOMINATOR - params.feeBps) / BPS_DENOMINATOR;
+  let best = null;
+  if (params.sameOutcomeBidTick && params.sameOutcomeBidTick > 0n) {
+    const tick = params.sameOutcomeBidTick;
+    best = { tick, price: tickToPrice(tick, params.tickSize), path: "normal" };
+  }
+  if (params.oppositeOutcomeAskTick && params.oppositeOutcomeAskTick > 0n) {
+    if (maxMergeTotalTicks > params.oppositeOutcomeAskTick) {
+      const tick = maxMergeTotalTicks - params.oppositeOutcomeAskTick;
+      if (tick > 0n && (!best || tick > best.tick)) {
+        best = { tick, price: tickToPrice(tick, params.tickSize), path: "merge" };
+      }
+    }
+  }
+  return best;
+}
+function applyTakerFeeBuffer(askTick, feeBps, tickSize) {
+  const fullTicks = fullPriceTicks(tickSize);
+  const tick = ceilDiv(askTick * (BPS_DENOMINATOR + feeBps), BPS_DENOMINATOR);
+  return tick > fullTicks ? fullTicks : tick;
+}
+function estimateBuyFromShares(shares, pricePerShare) {
+  const safeShares = Math.max(0, Number.isFinite(shares) ? shares : 0);
+  const safePrice = Math.max(0, Number.isFinite(pricePerShare) ? pricePerShare : 0);
+  const cost = safeShares * safePrice;
+  const payout = safeShares;
+  return {
+    shares: safeShares,
+    cost,
+    payout,
+    profit: payout - cost,
+    avgPrice: safePrice
+  };
+}
+function estimateBuyFromAmount(amount, pricePerShare) {
+  const safeAmount = Math.max(0, Number.isFinite(amount) ? amount : 0);
+  const safePrice = Math.max(0, Number.isFinite(pricePerShare) ? pricePerShare : 0);
+  if (safePrice <= 0) {
+    return { shares: 0, cost: safeAmount, payout: 0, profit: -safeAmount, avgPrice: 0 };
+  }
+  const shares = safeAmount / safePrice;
+  return {
+    shares,
+    cost: safeAmount,
+    payout: shares,
+    profit: shares - safeAmount,
+    avgPrice: safePrice
+  };
+}
+function estimateSellFromShares(shares, pricePerShare) {
+  const safeShares = Math.max(0, Number.isFinite(shares) ? shares : 0);
+  const safePrice = Math.max(0, Number.isFinite(pricePerShare) ? pricePerShare : 0);
+  return {
+    shares: safeShares,
+    avgPrice: safePrice,
+    proceeds: safeShares * safePrice
+  };
+}
+
 // src/index.ts
 var version = "0.1.0";
 
@@ -12307,6 +12405,7 @@ Object.defineProperty(exports, "gql", {
 });
 exports.AccessControlFacetABI = AccessControlFacet_default;
 exports.AccessControlModule = AccessControlModule;
+exports.BPS_DENOMINATOR = BPS_DENOMINATOR;
 exports.BatchOrdersFacetABI = BatchOrdersFacet_default;
 exports.CONTRACT_ADDRESSES = CONTRACT_ADDRESSES;
 exports.ConditionalTokensABI = ConditionalTokens_default;
@@ -12356,6 +12455,7 @@ exports.MarketsFacetABI = MarketsFacet_default;
 exports.MatchingFacetABI = MatchingFacet_default;
 exports.MetadataFacetABI = MetadataFacet_default;
 exports.NegRiskFacetABI = NegRiskFacet_default;
+exports.OPERATOR_FEE_BPS = OPERATOR_FEE_BPS;
 exports.OddMakiClient = OddMakiClient;
 exports.OrderBookFacetABI = OrderBookFacet_default;
 exports.PROTOCOL_FEES = PROTOCOL_FEES;
@@ -12380,18 +12480,25 @@ exports.VaultFacetABI = VaultFacet_default;
 exports.VenueFacetABI = VenueFacet_default;
 exports.VenueModule = VenueModule;
 exports.WhitelistAccessControlABI = WhitelistAccessControl_default;
+exports.applyTakerFeeBuffer = applyTakerFeeBuffer;
 exports.buildSubgraphGatewayUrl = buildSubgraphGatewayUrl;
 exports.calculateChancePercent = calculateChancePercent;
 exports.clearDecimalsCache = clearDecimalsCache;
 exports.createExpiry = createExpiry;
 exports.createOddMakiClient = createOddMakiClient;
+exports.estimateBuyFromAmount = estimateBuyFromAmount;
+exports.estimateBuyFromShares = estimateBuyFromShares;
+exports.estimateSellFromShares = estimateSellFromShares;
 exports.formatAmount = formatAmount;
 exports.formatAncillaryData = formatAncillaryData;
 exports.formatTimestamp = formatTimestamp;
 exports.getCachedTokenDecimals = getCachedTokenDecimals;
 exports.getOutcomePrice = getOutcomePrice;
 exports.getTokenDecimals = getTokenDecimals;
+exports.getTotalFeeBps = getTotalFeeBps;
 exports.isValidTickSize = isValidTickSize;
+exports.maxSellTickToCross = maxSellTickToCross;
+exports.minBuyTickToCross = minBuyTickToCross;
 exports.parseAmount = parseAmount;
 exports.parseAncillaryData = parseAncillaryData;
 exports.parseMetadata = parseMetadata;