@oddmaki-protocol/sdk 0.1.3 → 0.3.0

package/dist/index.d.mts

@@ -8158,6 +8158,15 @@ declare class VenueModule extends BaseModule {
      * Check if a user can create markets on a venue.
      */
     canCreateMarket(user: `0x${string}`, venueId: bigint): Promise<boolean>;
+    /**
+     * Get the current protocol fee in basis points. Snapshotted per market at creation.
+     */
+    getProtocolFeeBps(): Promise<bigint>;
+    /**
+     * Set the protocol fee in basis points. Owner-only. Max 200 bps (2%).
+     * Only affects markets created after this call (existing markets retain their snapshot).
+     */
+    setProtocolFeeBps(bps: bigint): Promise<`0x${string}`>;
 }
 
 /**
@@ -8293,6 +8302,42 @@ interface SubgraphMarketPriceData {
  * @returns Price as percentage (0-100)
  */
 declare function getOutcomePrice(market: SubgraphMarketPriceData, outcomeIndex: number): number;
+/**
+ * Top-of-book entry from subgraph TopOfBook entity.
+ */
+interface TopOfBookEntry {
+    outcome: string;
+    side: string;
+    topTick: string;
+}
+/**
+ * Input for calculateChancePercent — accepts subgraph market data.
+ */
+interface ChancePercentInput {
+    tickSize: string;
+    status?: string;
+    resolvedOutcome?: number | string | null;
+    lastPriceTick_0?: string | null;
+    lastPriceTick_1?: string | null;
+    lastTradeTimestamp_0?: string | null;
+    lastTradeTimestamp_1?: string | null;
+    topOfBook?: TopOfBookEntry[];
+}
+/**
+ * Calculate the "chance %" for a binary market using a Polymarket-style waterfall:
+ *
+ * 1. **Implied mark price** (midpoint of implied Yes bid/ask) — if spread ≤ $0.10
+ * 2. **Last trade** (most recent trade from either side) — if book empty or spread > $0.10
+ * 3. **50%** — no data
+ *
+ * Implied prices account for cross-outcome liquidity via mint/merge paths:
+ * - No BUY at tick N → implied Yes ASK at (maxTicks - N) via Mint path
+ * - No SELL at tick N → implied Yes BID at (maxTicks - N) via Merge path
+ *
+ * @param market - Subgraph market data with top-of-book and last trade info
+ * @returns Chance percentage (0-100)
+ */
+declare function calculateChancePercent(market: ChancePercentInput): number;
 
 declare class MarketModule extends BaseModule {
     /**
@@ -8618,10 +8663,53 @@ declare class TradeModule extends BaseModule {
         qty: bigint;
         expiry: bigint;
     }): Promise<never>;
+    /**
+     * Execute a market sell order (FOK or FAK)
+     *
+     * @param params.marketId - The market to sell on
+     * @param params.outcomeId - Which outcome to sell (0=YES, 1=NO)
+     * @param params.tokenAmount - Amount of outcome tokens to sell
+     * @param params.minPriceTick - Minimum price tick willing to accept (slippage protection)
+     * @param params.orderType - 0=FOK (Fill-Or-Kill), 1=FAK (Fill-And-Kill)
+     */
+    placeMarketSell(params: {
+        marketId: bigint;
+        outcomeId: bigint;
+        tokenAmount: bigint;
+        minPriceTick: bigint;
+        orderType: number;
+    }): Promise<`0x${string}`>;
+    /**
+     * Execute a market sell order with simple string inputs (recommended for frontends)
+     * @param params.amount - Token amount as decimal string (e.g., "100.5")
+     * @param params.minPrice - Minimum price as decimal string (e.g., "0.70")
+     * @param params.orderType - 'FOK' or 'FAK' (default: 'FAK')
+     */
+    placeMarketSellSimple(params: {
+        marketId: bigint;
+        outcomeId: bigint;
+        amount: string;
+        minPrice: string;
+        orderType?: 'FOK' | 'FAK';
+    }): Promise<`0x${string}`>;
+    /**
+     * Preview a market sell order (simulate transaction)
+     */
+    previewMarketSell(params: {
+        marketId: bigint;
+        outcomeId: bigint;
+        tokenAmount: bigint;
+        minPriceTick: bigint;
+        orderType: number;
+    }): Promise<never>;
     /**
      * Watch for MarketOrderExecuted events
      */
     watchMarketOrder(marketId: bigint, onLogs: (logs: any[]) => void): viem.WatchContractEventReturnType;
+    /**
+     * Watch for MarketSellExecuted events
+     */
+    watchMarketSell(marketId: bigint, onLogs: (logs: any[]) => void): viem.WatchContractEventReturnType;
     /**
      * Check whether any orders are matchable in the given market.
      * Returns a preview of which fill paths have crossing conditions,
@@ -8964,10 +9052,12 @@ declare class PublicModule extends BaseModule {
      */
     mergeAndSortFeed(feedData: any, sortBy?: 'created' | 'volume', limit?: number): Array<any>;
     /**
-     * Calculate probability for a market using last trade price
+     * Calculate probability for a market using mark price waterfall.
      * Returns probability as a decimal string (e.g., "0.65" for 65%)
      *
-     * @param market - Market object from subgraph
+     * Uses Polymarket-style pricing: implied midpoint → last trade → default 50%.
+     *
+     * @param market - Market object from subgraph (with topOfBook and timestamp fields)
      * @returns Probability string or null if no data available
      */
     calculateMarketProbability(market: any): string | null;
@@ -9120,6 +9210,16 @@ declare class UmaModule extends BaseModule {
         outcome: string;
         autoApprove?: boolean;
     }): Promise<`0x${string}`>;
+    /**
+     * Get the effective bond for a market, accounting for UMA's minimum bond.
+     * The contract uses max(requiredBond, oo.getMinimumBond(currency)).
+     */
+    getEffectiveBond(marketId: bigint): Promise<{
+        requiredBond: bigint;
+        minimumBond: bigint;
+        effectiveBond: bigint;
+        currency: Address;
+    }>;
     /**
      * Settle an assertion after the liveness period
      */
@@ -9733,14 +9833,27 @@ declare const DEFAULT_CHAIN: {
  */
 /**
  * Fee Constants
- * Fixed protocol-level fee tiers (not configurable per-market)
+ * Protocol fee is configurable on-chain (0-200 bps) and snapshotted per market at creation.
+ * These are the default values set at deployment.
  */
 declare const PROTOCOL_FEES: {
-    /** Protocol fee: 20 bps (0.20%) */
-    readonly PROTOCOL_FEE_BPS: 20n;
+    /** Protocol fee: 50 bps (0.50%) — configurable via ProtocolFacet.setProtocolFeeBps() */
+    readonly PROTOCOL_FEE_BPS: 50n;
     /** Operator fee: 10 bps (0.10%) for match operators */
     readonly OPERATOR_FEE_BPS: 10n;
 };
+/**
+ * Recommended UMA Oracle defaults for USDC venues (6 decimals).
+ * Based on Polymarket's production configuration.
+ */
+declare const UMA_DEFAULTS: {
+    /** Recommended reward: 5 USDC. Incentivizes third-party resolution. */
+    readonly REWARD_USDC: 5000000n;
+    /** Recommended minimum bond: 750 USDC. Matches Polymarket's production bond. */
+    readonly MIN_BOND_USDC: 750000000n;
+    /** Default liveness period: 2 hours (7200 seconds). */
+    readonly LIVENESS: 7200n;
+};
 
 var VenueFacet = [
 	{
@@ -10303,6 +10416,12 @@ var VenueFacet = [
 		inputs: [
 		]
 	},
+	{
+		type: "error",
+		name: "InvalidUmaMinBond",
+		inputs: [
+		]
+	},
 	{
 		type: "error",
 		name: "InvalidVenueFee",
@@ -10625,6 +10744,11 @@ var MarketsFacet = [
 						name: "creatorFeeBps",
 						type: "uint256",
 						internalType: "uint256"
+					},
+					{
+						name: "protocolFeeBps",
+						type: "uint256",
+						internalType: "uint256"
 					}
 				]
 			}
@@ -11760,6 +11884,25 @@ var MatchingFacet = [
 		],
 		anonymous: false
 	},
+	{
+		type: "event",
+		name: "OrderAutoCancelled",
+		inputs: [
+			{
+				name: "orderId",
+				type: "uint256",
+				indexed: true,
+				internalType: "uint256"
+			},
+			{
+				name: "refundedCollateral",
+				type: "uint256",
+				indexed: false,
+				internalType: "uint256"
+			}
+		],
+		anonymous: false
+	},
 	{
 		type: "event",
 		name: "OrderDeleted",
@@ -12521,6 +12664,11 @@ var MarketGroupFacet = [
 						name: "liveness",
 						type: "uint64",
 						internalType: "uint64"
+					},
+					{
+						name: "reward",
+						type: "uint256",
+						internalType: "uint256"
 					}
 				]
 			}
@@ -12667,6 +12815,12 @@ var MarketGroupFacet = [
 				type: "bytes32[]",
 				indexed: false,
 				internalType: "bytes32[]"
+			},
+			{
+				name: "reward",
+				type: "uint256",
+				indexed: false,
+				internalType: "uint256"
 			}
 		],
 		anonymous: false
@@ -13287,6 +13441,11 @@ var ResolutionFacet = [
 						name: "settled",
 						type: "bool",
 						internalType: "bool"
+					},
+					{
+						name: "asserter",
+						type: "address",
+						internalType: "address"
 					}
 				]
 			}
@@ -13477,6 +13636,31 @@ var ResolutionFacet = [
 		],
 		anonymous: false
 	},
+	{
+		type: "event",
+		name: "RewardPaid",
+		inputs: [
+			{
+				name: "assertionId",
+				type: "bytes32",
+				indexed: true,
+				internalType: "bytes32"
+			},
+			{
+				name: "asserter",
+				type: "address",
+				indexed: true,
+				internalType: "address"
+			},
+			{
+				name: "reward",
+				type: "uint256",
+				indexed: false,
+				internalType: "uint256"
+			}
+		],
+		anonymous: false
+	},
 	{
 		type: "error",
 		name: "ApproveFailed",
@@ -13537,6 +13721,12 @@ var ResolutionFacet = [
 		inputs: [
 		]
 	},
+	{
+		type: "error",
+		name: "TransferFailed",
+		inputs: [
+		]
+	},
 	{
 		type: "error",
 		name: "TransferFromFailed",
@@ -13852,6 +14042,20 @@ var NegRiskFacet = [
 ];
 
 var ProtocolFacet = [
+	{
+		type: "function",
+		name: "getProtocolFeeBps",
+		inputs: [
+		],
+		outputs: [
+			{
+				name: "",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		stateMutability: "view"
+	},
 	{
 		type: "function",
 		name: "getProtocolPaused",
@@ -13974,6 +14178,20 @@ var ProtocolFacet = [
 		],
 		stateMutability: "nonpayable"
 	},
+	{
+		type: "function",
+		name: "setProtocolFeeBps",
+		inputs: [
+			{
+				name: "bps",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		outputs: [
+		],
+		stateMutability: "nonpayable"
+	},
 	{
 		type: "function",
 		name: "setProtocolTreasury",
@@ -14154,6 +14372,19 @@ var ProtocolFacet = [
 		],
 		anonymous: false
 	},
+	{
+		type: "event",
+		name: "ProtocolFeeBpsUpdated",
+		inputs: [
+			{
+				name: "bps",
+				type: "uint256",
+				indexed: false,
+				internalType: "uint256"
+			}
+		],
+		anonymous: false
+	},
 	{
 		type: "event",
 		name: "ProtocolPausedEvent",
@@ -15918,6 +16149,30 @@ var WhitelistAccessControl = [
 ];
 
 var ConditionalTokens = [
+	{
+		type: "function",
+		name: "balanceOf",
+		inputs: [
+			{
+				name: "account",
+				type: "address",
+				internalType: "address"
+			},
+			{
+				name: "id",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		outputs: [
+			{
+				name: "",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		stateMutability: "view"
+	},
 	{
 		type: "function",
 		name: "getCollectionId",
@@ -15940,7 +16195,7 @@ var ConditionalTokens = [
 		],
 		outputs: [
 			{
-				name: "",
+				name: "collectionId",
 				type: "bytes32",
 				internalType: "bytes32"
 			}
@@ -15969,7 +16224,7 @@ var ConditionalTokens = [
 		],
 		outputs: [
 			{
-				name: "",
+				name: "conditionId",
 				type: "bytes32",
 				internalType: "bytes32"
 			}
@@ -15988,13 +16243,37 @@ var ConditionalTokens = [
 		],
 		outputs: [
 			{
-				name: "",
+				name: "outcomeSlotCount",
 				type: "uint256",
 				internalType: "uint256"
 			}
 		],
 		stateMutability: "view"
 	},
+	{
+		type: "function",
+		name: "getPositionId",
+		inputs: [
+			{
+				name: "collateralToken",
+				type: "address",
+				internalType: "contract IERC20"
+			},
+			{
+				name: "collectionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			}
+		],
+		outputs: [
+			{
+				name: "positionId",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		stateMutability: "pure"
+	},
 	{
 		type: "function",
 		name: "mergePositions",
@@ -16029,6 +16308,49 @@ var ConditionalTokens = [
 		],
 		stateMutability: "nonpayable"
 	},
+	{
+		type: "function",
+		name: "payoutDenominator",
+		inputs: [
+			{
+				name: "conditionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			}
+		],
+		outputs: [
+			{
+				name: "",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		stateMutability: "view"
+	},
+	{
+		type: "function",
+		name: "payoutNumerators",
+		inputs: [
+			{
+				name: "conditionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			},
+			{
+				name: "index",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		outputs: [
+			{
+				name: "",
+				type: "uint256",
+				internalType: "uint256"
+			}
+		],
+		stateMutability: "view"
+	},
 	{
 		type: "function",
 		name: "prepareCondition",
@@ -16053,6 +16375,35 @@ var ConditionalTokens = [
 		],
 		stateMutability: "nonpayable"
 	},
+	{
+		type: "function",
+		name: "redeemPositions",
+		inputs: [
+			{
+				name: "collateralToken",
+				type: "address",
+				internalType: "contract IERC20"
+			},
+			{
+				name: "parentCollectionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			},
+			{
+				name: "conditionId",
+				type: "bytes32",
+				internalType: "bytes32"
+			},
+			{
+				name: "indexSets",
+				type: "uint256[]",
+				internalType: "uint256[]"
+			}
+		],
+		outputs: [
+		],
+		stateMutability: "nonpayable"
+	},
 	{
 		type: "function",
 		name: "reportPayouts",
@@ -16113,14 +16464,19 @@ var ERC20 = [
 		type: "constructor",
 		inputs: [
 			{
-				name: "name_",
+				name: "_name",
 				type: "string",
 				internalType: "string"
 			},
 			{
-				name: "symbol_",
+				name: "_symbol",
 				type: "string",
 				internalType: "string"
+			},
+			{
+				name: "_decimals",
+				type: "uint8",
+				internalType: "uint8"
 			}
 		],
 		stateMutability: "nonpayable"
@@ -16130,12 +16486,12 @@ var ERC20 = [
 		name: "allowance",
 		inputs: [
 			{
-				name: "owner",
+				name: "",
 				type: "address",
 				internalType: "address"
 			},
 			{
-				name: "spender",
+				name: "",
 				type: "address",
 				internalType: "address"
 			}
@@ -16178,7 +16534,7 @@ var ERC20 = [
 		name: "balanceOf",
 		inputs: [
 			{
-				name: "account",
+				name: "",
 				type: "address",
 				internalType: "address"
 			}
@@ -16208,49 +16564,20 @@ var ERC20 = [
 	},
 	{
 		type: "function",
-		name: "decreaseAllowance",
+		name: "mint",
 		inputs: [
 			{
-				name: "spender",
-				type: "address",
-				internalType: "address"
-			},
-			{
-				name: "subtractedValue",
-				type: "uint256",
-				internalType: "uint256"
-			}
-		],
-		outputs: [
-			{
-				name: "",
-				type: "bool",
-				internalType: "bool"
-			}
-		],
-		stateMutability: "nonpayable"
-	},
-	{
-		type: "function",
-		name: "increaseAllowance",
-		inputs: [
-			{
-				name: "spender",
+				name: "to",
 				type: "address",
 				internalType: "address"
 			},
 			{
-				name: "addedValue",
+				name: "amount",
 				type: "uint256",
 				internalType: "uint256"
 			}
 		],
 		outputs: [
-			{
-				name: "",
-				type: "bool",
-				internalType: "bool"
-			}
 		],
 		stateMutability: "nonpayable"
 	},
@@ -16539,4 +16866,4 @@ declare function parseMetadata<T extends {
 
 declare const version = "0.1.0";
 
-export { AccessControlFacet as AccessControlFacetABI, AccessControlModule, BatchOrdersFacet as BatchOrdersFacetABI, CONTRACT_ADDRESSES, 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_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, 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, ResolutionFacet as ResolutionFacetABI, SubgraphClient, type SubgraphMarketPriceData, TICK_SIZE_FINE, TICK_SIZE_STANDARD, TagsFacet as TagsFacetABI, TokenModule, TradeModule, UmaModule, VALID_TICK_SIZES, VaultFacet as VaultFacetABI, VenueFacet as VenueFacetABI, type VenueMetadata, VenueModule, WhitelistAccessControl as WhitelistAccessControlABI, 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_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, 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, ResolutionFacet as ResolutionFacetABI, SubgraphClient, type SubgraphMarketPriceData, TICK_SIZE_FINE, TICK_SIZE_STANDARD, TagsFacet as TagsFacetABI, TokenModule, type TopOfBookEntry, TradeModule, UMA_DEFAULTS, UmaModule, VALID_TICK_SIZES, VaultFacet as VaultFacetABI, VenueFacet as VenueFacetABI, type VenueMetadata, VenueModule, WhitelistAccessControl as WhitelistAccessControlABI, calculateChancePercent, clearDecimalsCache, createExpiry, createOddMakiClient, formatAmount, formatAncillaryData, formatTimestamp, getCachedTokenDecimals, getOutcomePrice, getTokenDecimals, isValidTickSize, parseAmount, parseAncillaryData, parseMetadata, parseTokenAmount, priceToTick, resolveIPFSUri, tickToPercentage, tickToPrice, version };