@oddmaki-protocol/sdk 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -9264,6 +9264,27 @@ declare class UmaModule extends BaseModule {
      * Settle an assertion after the liveness period
      */
     settleAssertion(assertionId: `0x${string}`): Promise<`0x${string}`>;
+    /**
+     * Get the UMA Optimistic Oracle V3 address for the active Diamond.
+     */
+    getUmaOracleAddress(): Promise<Address>;
+    /**
+     * Dispute an active assertion directly on the UMA Optimistic Oracle V3.
+     *
+     * The dispute escalates the assertion to UMA's DVM, which arbitrates the
+     * outcome via tokenholder vote. The disputer must post a bond equal to the
+     * asserter's bond — the winner is reimbursed and receives a share of the
+     * loser's bond.
+     *
+     * @param params.assertionId - The active assertionId to dispute
+     * @param params.autoApprove - Approve the bond currency to the oracle if needed (default: true)
+     *
+     * @returns Transaction hash
+     */
+    disputeAssertion(params: {
+        assertionId: `0x${string}`;
+        autoApprove?: boolean;
+    }): Promise<`0x${string}`>;
     /**
      * Report resolution after UMA settlement
      */
@@ -9328,6 +9349,8 @@ declare class UmaModule extends BaseModule {
         canSettle: boolean;
         disputer: `0x${string}`;
         isDisputed: boolean;
+        currency: Address;
+        bond: bigint;
     }>;
     /**
      * Get comprehensive market status for UMA resolution
@@ -9619,6 +9642,11 @@ declare const CONTRACT_ADDRESSES: {
         readonly subgraph: "https://api.studio.thegraph.com/query/1716020/oddmaki-base/version/latest";
     };
 };
+declare const SUBGRAPH_IDS: {
+    readonly 8453: "CxoYVjELrNCMLopAmVshnfVAie7yH6QZyCSKD3r41XSQ";
+    readonly 84532: "DCnd3ozSyvYxRg7kmZYiDWGBiJCe6QHwu8M93jMN1Q3b";
+};
+declare function buildSubgraphGatewayUrl(chainId: number, apiKey: string): string | undefined;
 declare const DEFAULT_CHAIN: {
     blockExplorers: {
         readonly default: {
@@ -17245,6 +17273,25 @@ 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"
 	}
 ];
 
@@ -17386,4 +17433,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_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, 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, 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_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 };

package/dist/index.d.ts

@@ -9264,6 +9264,27 @@ declare class UmaModule extends BaseModule {
      * Settle an assertion after the liveness period
      */
     settleAssertion(assertionId: `0x${string}`): Promise<`0x${string}`>;
+    /**
+     * Get the UMA Optimistic Oracle V3 address for the active Diamond.
+     */
+    getUmaOracleAddress(): Promise<Address>;
+    /**
+     * Dispute an active assertion directly on the UMA Optimistic Oracle V3.
+     *
+     * The dispute escalates the assertion to UMA's DVM, which arbitrates the
+     * outcome via tokenholder vote. The disputer must post a bond equal to the
+     * asserter's bond — the winner is reimbursed and receives a share of the
+     * loser's bond.
+     *
+     * @param params.assertionId - The active assertionId to dispute
+     * @param params.autoApprove - Approve the bond currency to the oracle if needed (default: true)
+     *
+     * @returns Transaction hash
+     */
+    disputeAssertion(params: {
+        assertionId: `0x${string}`;
+        autoApprove?: boolean;
+    }): Promise<`0x${string}`>;
     /**
      * Report resolution after UMA settlement
      */
@@ -9328,6 +9349,8 @@ declare class UmaModule extends BaseModule {
         canSettle: boolean;
         disputer: `0x${string}`;
         isDisputed: boolean;
+        currency: Address;
+        bond: bigint;
     }>;
     /**
      * Get comprehensive market status for UMA resolution
@@ -9619,6 +9642,11 @@ declare const CONTRACT_ADDRESSES: {
         readonly subgraph: "https://api.studio.thegraph.com/query/1716020/oddmaki-base/version/latest";
     };
 };
+declare const SUBGRAPH_IDS: {
+    readonly 8453: "CxoYVjELrNCMLopAmVshnfVAie7yH6QZyCSKD3r41XSQ";
+    readonly 84532: "DCnd3ozSyvYxRg7kmZYiDWGBiJCe6QHwu8M93jMN1Q3b";
+};
+declare function buildSubgraphGatewayUrl(chainId: number, apiKey: string): string | undefined;
 declare const DEFAULT_CHAIN: {
     blockExplorers: {
         readonly default: {
@@ -17245,6 +17273,25 @@ 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"
 	}
 ];
 
@@ -17386,4 +17433,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_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, 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, 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_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 };

package/dist/index.js

@@ -19,6 +19,14 @@ var CONTRACT_ADDRESSES = {
     subgraph: "https://api.studio.thegraph.com/query/1716020/oddmaki-base/version/latest"
   }
 };
+var SUBGRAPH_IDS = {
+  [chains.base.id]: "CxoYVjELrNCMLopAmVshnfVAie7yH6QZyCSKD3r41XSQ",
+  [chains.baseSepolia.id]: "DCnd3ozSyvYxRg7kmZYiDWGBiJCe6QHwu8M93jMN1Q3b"
+};
+function buildSubgraphGatewayUrl(chainId, apiKey) {
+  const id = SUBGRAPH_IDS[chainId];
+  return id ? `https://gateway.thegraph.com/api/${apiKey}/subgraphs/id/${id}` : void 0;
+}
 var DEFAULT_CHAIN = chains.base;
 var SubgraphClient = class {
   constructor(endpoint) {
@@ -7113,6 +7121,24 @@ var UmaOracle_default = [
     ],
     outputs: [],
     stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "disputeAssertion",
+    inputs: [
+      {
+        name: "assertionId",
+        type: "bytes32",
+        internalType: "bytes32"
+      },
+      {
+        name: "disputer",
+        type: "address",
+        internalType: "address"
+      }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
   }
 ];
 
@@ -10491,6 +10517,97 @@ var UmaModule = class extends BaseModule {
     });
     return wallet.writeContract(request);
   }
+  /**
+   * Get the UMA Optimistic Oracle V3 address for the active Diamond.
+   */
+  async getUmaOracleAddress() {
+    return await this.publicClient.readContract({
+      address: this.config.diamondAddress,
+      abi: ProtocolFacet_default,
+      functionName: "getUmaOracle"
+    });
+  }
+  /**
+   * Dispute an active assertion directly on the UMA Optimistic Oracle V3.
+   *
+   * The dispute escalates the assertion to UMA's DVM, which arbitrates the
+   * outcome via tokenholder vote. The disputer must post a bond equal to the
+   * asserter's bond — the winner is reimbursed and receives a share of the
+   * loser's bond.
+   *
+   * @param params.assertionId - The active assertionId to dispute
+   * @param params.autoApprove - Approve the bond currency to the oracle if needed (default: true)
+   *
+   * @returns Transaction hash
+   */
+  async disputeAssertion(params) {
+    const wallet = this.walletClient;
+    const account = await this.getSignerAccount();
+    const accountAddress = await this.getSignerAddress();
+    const autoApprove = params.autoApprove ?? true;
+    const oracleAddress = await this.getUmaOracleAddress();
+    const assertion = await this.publicClient.readContract({
+      address: oracleAddress,
+      abi: UmaOracle_default,
+      functionName: "getAssertion",
+      args: [params.assertionId]
+    });
+    const currency = assertion.currency;
+    const bondAmount = BigInt(assertion.bond);
+    if (assertion.disputer !== "0x0000000000000000000000000000000000000000") {
+      throw new Error("Assertion has already been disputed");
+    }
+    if (assertion.settled) {
+      throw new Error("Assertion is already settled");
+    }
+    const currentTime = Math.floor(Date.now() / 1e3);
+    if (currentTime >= Number(assertion.expirationTime)) {
+      throw new Error("Liveness period has expired \u2014 assertion can no longer be disputed");
+    }
+    const currentAllowance = await this.publicClient.readContract({
+      address: currency,
+      abi: viem.erc20Abi,
+      functionName: "allowance",
+      args: [accountAddress, oracleAddress]
+    });
+    if (currentAllowance < bondAmount && autoApprove) {
+      const approveHash = await wallet.writeContract({
+        address: currency,
+        abi: viem.erc20Abi,
+        functionName: "approve",
+        args: [oracleAddress, bondAmount],
+        account,
+        chain: this.config.chain
+      });
+      await this.publicClient.waitForTransactionReceipt({
+        hash: approveHash,
+        confirmations: 2
+      });
+    } else if (currentAllowance < bondAmount) {
+      throw new Error(
+        `Insufficient bond currency allowance for oracle. Required: ${bondAmount.toString()}, Current: ${currentAllowance.toString()}.`
+      );
+    }
+    const balance = await this.publicClient.readContract({
+      address: currency,
+      abi: viem.erc20Abi,
+      functionName: "balanceOf",
+      args: [accountAddress]
+    });
+    if (balance < bondAmount) {
+      throw new Error(
+        `Insufficient bond currency balance. Required: ${bondAmount.toString()}, Have: ${balance.toString()}`
+      );
+    }
+    const { request } = await this.publicClient.simulateContract({
+      address: oracleAddress,
+      abi: UmaOracle_default,
+      functionName: "disputeAssertion",
+      args: [params.assertionId, accountAddress],
+      account
+    });
+    return wallet.writeContract(request);
+  }
   /**
    * Report resolution after UMA settlement
    */
@@ -10706,7 +10823,9 @@ var UmaModule = class extends BaseModule {
       expirationTime,
       canSettle: currentTime >= expirationTime,
       disputer: assertion.disputer,
-      isDisputed: assertion.disputer !== "0x0000000000000000000000000000000000000000"
+      isDisputed: assertion.disputer !== "0x0000000000000000000000000000000000000000",
+      currency: assertion.currency,
+      bond: BigInt(assertion.bond)
     };
   }
   /**
@@ -11458,6 +11577,7 @@ exports.ProtocolFacetABI = ProtocolFacet_default;
 exports.PublicModule = PublicModule;
 exports.PythResolutionFacetABI = PythResolutionFacet_default;
 exports.ResolutionFacetABI = ResolutionFacet_default;
+exports.SUBGRAPH_IDS = SUBGRAPH_IDS;
 exports.SubgraphClient = SubgraphClient;
 exports.TICK_SIZE_FINE = TICK_SIZE_FINE;
 exports.TICK_SIZE_STANDARD = TICK_SIZE_STANDARD;
@@ -11472,6 +11592,7 @@ exports.VaultFacetABI = VaultFacet_default;
 exports.VenueFacetABI = VenueFacet_default;
 exports.VenueModule = VenueModule;
 exports.WhitelistAccessControlABI = WhitelistAccessControl_default;
+exports.buildSubgraphGatewayUrl = buildSubgraphGatewayUrl;
 exports.calculateChancePercent = calculateChancePercent;
 exports.clearDecimalsCache = clearDecimalsCache;
 exports.createExpiry = createExpiry;