rain-sdk-v2 2.1.4 → 2.1.5

package/README.md

@@ -661,6 +661,96 @@ const payouts = await rain.getDynamicPayout({
 // payouts = [yesPayoutWei, noPayoutWei]
 ```
 
+### `getResolverBondAmount(params): Promise<bigint>`
+
+Get the bond amount (in base-token wei) a resolver must post to propose a resolution for an option.
+
+```typescript
+const bond = await rain.getResolverBondAmount({
+  marketContractAddress: '0x...',
+  option: 1n, // 1-based option index
+});
+```
+
+### `getDisputeAppealFee(params): Promise<bigint>`
+
+Get the fee (in base-token wei) required to open a dispute or appeal on an option.
+
+```typescript
+const fee = await rain.getDisputeAppealFee({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+```
+
+### `optionResolverBond(params): Promise<bigint>`
+
+Get the resolver bond currently posted on an option (0n if no resolution has been proposed).
+
+```typescript
+const bond = await rain.optionResolverBond({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+```
+
+### `optionResolutionProposer(params): Promise<`0x${string}`>`
+
+Get the address that proposed the resolution for an option (zero address if none).
+
+```typescript
+const proposer = await rain.optionResolutionProposer({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+```
+
+### `isOptionDisputed(params): Promise<boolean>`
+
+Check whether an option's resolution has been disputed.
+
+```typescript
+const disputed = await rain.isOptionDisputed({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+```
+
+### `isOptionAppealed(params): Promise<boolean>`
+
+Check whether an option's dispute resolution has been appealed.
+
+```typescript
+const appealed = await rain.isOptionAppealed({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+```
+
+### `optionDispute(params): Promise<OptionDisputeInfo>`
+
+Get the dispute details for an option: fee paid, the winner claimed by the disputer, the disputer address, and the dispute resolver.
+
+```typescript
+const dispute = await rain.optionDispute({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+// { disputeFee: bigint, disputedWinner: bigint, disputer: '0x...', disputeResolver: '0x...' }
+```
+
+### `optionAppeal(params): Promise<OptionAppealInfo>`
+
+Get the appeal details for an option: fee paid, the winner claimed by the appellant, the disputer address, and the appeal resolver.
+
+```typescript
+const appeal = await rain.optionAppeal({
+  marketContractAddress: '0x...',
+  option: 1n,
+});
+// { disputeFee: bigint, disputedWinner: bigint, disputer: '0x...', appealResolver: '0x...' }
+```
+
 ### `getUserActiveBuyOrders(params): Promise<bigint>`
 
 Get count of user's active buy orders.

package/dist/Rain.d.ts

@@ -4,6 +4,7 @@ import { ExtendTimeTxParams } from './tx/buildExtendTimeRawTx.js';
 import { RainCoreConfig, RainEnvironment } from './types.js';
 import { LoginParams, LoginResult } from './auth/types.js';
 import { SellProceedsResult } from './markets/getSellProceeds.js';
+import { OptionDisputeInfo, OptionAppealInfo } from './markets/getDisputeState.js';
 import { EntrySharesResult } from './markets/getEntryShares.js';
 import type { UserProfileUpdateParams, UserHistoryParams, CreateCommentParams, CommentsListingParams, UpdateCommentParams, CommentCountParams, PublicPoolsParams, PrivatePoolsParams, PoolListingByCreatorParams, VerifyAccessCodeParams, PoolTotalParticipantsParams, SearchPoolParams, RelatedPoolsParams, UpdateStreamingParams, UpdatePoolResolutionTimeParams, FindPoolFallbackParams, SignOraclesExtendTimeParams, TrendingTagsParams, UserTotalInvestmentParams, OptionsTotalVolumeParams, PoolActivityParams, TopHoldersParams, UserInvestedPoolsParams, InvestmentVolumeGraphParams, UserPnlGraphParams, TopWinnersLosersParams, PnlByPoolIdParams, UserPositionsParams, OpenPositionsParams, UserSharePositionsParams, SearchInvestedPoolsParams, PriceDataParams, AddReviewParams, GetUserOrdersParams, OrderBookParams, GetUserOrderByPoolIdParams, OrdersListingByPoolParams, AddUserPointsParams, UserOnboardingParams, PointsGraphParams, GetNotificationsParams, MarkNotificationAsReadParams, CreateDisputeMessageParams, GetPoolDisputeConvoParams, FollowToggleParams, FollowCheckParams, FollowListParams, FollowStatsParams, RainBurnPerPoolParams, ToggleBookmarkParams, GetBookmarksParams, CheckBookmarkParams, LeaderboardParams, LeaderboardSearchParams, TraderRecentTradesParams } from './api/types.js';
 export declare class Rain {
@@ -58,6 +59,38 @@ export declare class Rain {
     getDisputeWindow(params: {
         marketContractAddress: `0x${string}`;
     }): Promise<bigint>;
+    getResolverBondAmount(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<bigint>;
+    getDisputeAppealFee(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<bigint>;
+    optionResolverBond(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<bigint>;
+    optionResolutionProposer(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<`0x${string}`>;
+    isOptionDisputed(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<boolean>;
+    isOptionAppealed(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<boolean>;
+    optionDispute(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<OptionDisputeInfo>;
+    optionAppeal(params: {
+        marketContractAddress: `0x${string}`;
+        option: bigint;
+    }): Promise<OptionAppealInfo>;
     getEntryShares(params: {
         marketContractAddress: `0x${string}`;
         option: bigint;

package/dist/Rain.js

@@ -24,6 +24,9 @@ import { getSellProceeds } from './markets/getSellProceeds.js';
 import { getUserSharesInEscrow } from './markets/getUserSharesInEscrow.js';
 import { getOptionClaimed } from './markets/getOptionClaimed.js';
 import { getDisputeWindow } from './markets/getDisputeWindow.js';
+import { getResolverBondAmount } from './markets/getResolverBondAmount.js';
+import { getDisputeAppealFee } from './markets/getDisputeFee.js';
+import { optionResolverBond, optionResolutionProposer, isOptionDisputed, isOptionAppealed, optionDispute, optionAppeal } from './markets/getDisputeState.js';
 import { getEntryShares } from './markets/getEntryShares.js';
 import { createPublicClient, http, parseAbi } from 'viem';
 import { arbitrum } from 'viem/chains';
@@ -137,6 +140,30 @@ export class Rain {
     async getDisputeWindow(params) {
         return getDisputeWindow({ ...params, rpcUrl: this.rpcUrl });
     }
+    async getResolverBondAmount(params) {
+        return getResolverBondAmount({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async getDisputeAppealFee(params) {
+        return getDisputeAppealFee({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async optionResolverBond(params) {
+        return optionResolverBond({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async optionResolutionProposer(params) {
+        return optionResolutionProposer({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async isOptionDisputed(params) {
+        return isOptionDisputed({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async isOptionAppealed(params) {
+        return isOptionAppealed({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async optionDispute(params) {
+        return optionDispute({ ...params, rpcUrl: this.rpcUrl });
+    }
+    async optionAppeal(params) {
+        return optionAppeal({ ...params, rpcUrl: this.rpcUrl });
+    }
     async getEntryShares(params) {
         return getEntryShares({ ...params, rpcUrl: this.rpcUrl });
     }

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { signLoginMessage } from './auth/signMessage.js';
 export type { ExtendTimeTxParams } from './tx/buildExtendTimeRawTx.js';
 export type { CalculateWinnerTxParams } from './tx/buildCalculateWinnerRawTx.js';
 export type { TokenConfig } from './config/environments.js';
+export type { OptionDisputeInfo, OptionAppealInfo } from './markets/getDisputeState.js';
 export * from './api/index.js';
 export { RainSocket } from './socket/RainSocket.js';
 export type { RainSocketEvent, EnterOptionEventData, ExitOptionEventData, LiquidityEventData, SplitEventData, MergeEventData, RemoveLiquidityEventData, SyncPriceEventData, OrderCreatedEventData, OrderCancelledEventData, OrderFilledEventData, PoolClosedEventData, PoolEventData, WinnerEventData, DisputeOpenedEventData, OracleCreatedEventData, AppealOpenedEventData, DisputeWinnerEventData, AppealWinnerEventData, ClaimRewardEventData, DisputeRefundEventData } from './socket/RainSocket.js';

package/dist/markets/getDisputeState.d.ts

@@ -0,0 +1,24 @@
+export interface OptionDisputeInfo {
+    disputeFee: bigint;
+    disputedWinner: bigint;
+    disputer: `0x${string}`;
+    disputeResolver: `0x${string}`;
+}
+export interface OptionAppealInfo {
+    disputeFee: bigint;
+    disputedWinner: bigint;
+    disputer: `0x${string}`;
+    appealResolver: `0x${string}`;
+}
+interface OptionReadParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    rpcUrl: string;
+}
+export declare function optionResolverBond(params: OptionReadParams): Promise<bigint>;
+export declare function optionResolutionProposer(params: OptionReadParams): Promise<`0x${string}`>;
+export declare function isOptionDisputed(params: OptionReadParams): Promise<boolean>;
+export declare function isOptionAppealed(params: OptionReadParams): Promise<boolean>;
+export declare function optionDispute(params: OptionReadParams): Promise<OptionDisputeInfo>;
+export declare function optionAppeal(params: OptionReadParams): Promise<OptionAppealInfo>;
+export {};

package/dist/markets/getDisputeState.js

@@ -0,0 +1,69 @@
+import { createPublicClient, http } from 'viem';
+import { arbitrum } from 'viem/chains';
+import { MarketsAbi } from '../abi/MarketsAbi.js';
+function client(rpcUrl) {
+    return createPublicClient({
+        chain: arbitrum,
+        transport: http(rpcUrl),
+    });
+}
+export async function optionResolverBond(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const bond = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'optionResolverBond',
+        args: [option],
+    });
+    return bond;
+}
+export async function optionResolutionProposer(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const proposer = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'optionResolutionProposer',
+        args: [option],
+    });
+    return proposer;
+}
+export async function isOptionDisputed(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const disputed = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'isOptionDisputed',
+        args: [option],
+    });
+    return disputed;
+}
+export async function isOptionAppealed(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const appealed = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'isOptionAppealed',
+        args: [option],
+    });
+    return appealed;
+}
+export async function optionDispute(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const [disputeFee, disputedWinner, disputer, disputeResolver] = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'optionDispute',
+        args: [option],
+    });
+    return { disputeFee, disputedWinner, disputer, disputeResolver };
+}
+export async function optionAppeal(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    const [disputeFee, disputedWinner, disputer, appealResolver] = await client(rpcUrl).readContract({
+        address: marketContractAddress,
+        abi: MarketsAbi,
+        functionName: 'optionAppeal',
+        args: [option],
+    });
+    return { disputeFee, disputedWinner, disputer, appealResolver };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rain-sdk-v2",
-    "version": "2.1.4",
+    "version": "2.1.5",
     "type": "module",
     "description": "Rain SDK V2 — TypeScript SDK for Rain prediction markets on Arbitrum. Market creation, trading, liquidity, order book, split/merge, dispute, and smart account support.",
     "main": "dist/index.js",