rain-sdk-v2 1.0.0

package/dist/tx/buildEnterOptionRawTx.js

@@ -0,0 +1,25 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { ENTER_OPTION } from "../constants/contractmethods.js";
+export function buildEnterOptionRawTx(params) {
+    const { marketContractAddress, selectedOption, optionSide, buyAmountInWei } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (selectedOption === undefined || selectedOption === null)
+        throw new Error("selectedOption is required");
+    if (optionSide === undefined || optionSide === null)
+        throw new Error("optionSide is required");
+    if (!buyAmountInWei)
+        throw new Error("buyAmountInWei is required");
+    if (buyAmountInWei <= 0n)
+        throw new Error("buyAmountInWei must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: ENTER_OPTION,
+            args: [selectedOption, optionSide, buyAmountInWei],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/buildMergeRawTx.d.ts

@@ -0,0 +1,2 @@
+import { MergeTxParams, RawTransaction } from "./types.js";
+export declare function buildMergeRawTx(params: MergeTxParams): RawTransaction;

package/dist/tx/buildMergeRawTx.js

@@ -0,0 +1,21 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { MERGE } from "../constants/contractmethods.js";
+export function buildMergeRawTx(params) {
+    const { marketContractAddress, option, amount } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    if (!amount || amount <= 0n)
+        throw new Error("amount must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: MERGE,
+            args: [option, amount],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/buildOpenDisputeRawTx.d.ts

@@ -0,0 +1,8 @@
+import { OpenDisputeTxParams, RawTransaction } from "./types.js";
+/**
+ * Build open dispute transactions.
+ * Reads the dispute fee from the contract, builds approval + openDispute.
+ */
+export declare function buildOpenDisputeRawTx(params: OpenDisputeTxParams & {
+    rpcUrl: string;
+}): Promise<RawTransaction[]>;

package/dist/tx/buildOpenDisputeRawTx.js

@@ -0,0 +1,39 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { OPEN_DISPUTE } from "../constants/contractmethods.js";
+import { getDisputeAppealFee } from "../markets/getDisputeFee.js";
+import { getMarketBaseToken } from "../markets/getResolverBondAmount.js";
+import { buildApproveRawTx } from "./buildApprovalRawTx.js";
+/**
+ * Build open dispute transactions.
+ * Reads the dispute fee from the contract, builds approval + openDispute.
+ */
+export async function buildOpenDisputeRawTx(params) {
+    const { marketContractAddress, option, rpcUrl } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    const [disputeFee, baseToken] = await Promise.all([
+        getDisputeAppealFee({ marketContractAddress, option, rpcUrl }),
+        getMarketBaseToken({ marketContractAddress, rpcUrl }),
+    ]);
+    const txs = [];
+    if (disputeFee > 0n) {
+        txs.push(buildApproveRawTx({
+            tokenAddress: baseToken,
+            spender: marketContractAddress,
+            amount: disputeFee,
+        }));
+    }
+    txs.push({
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: OPEN_DISPUTE,
+            args: [option],
+        }),
+        value: 0n,
+    });
+    return txs;
+}

package/dist/tx/buildPlaceOrderRawTx.d.ts

@@ -0,0 +1,3 @@
+import { PlaceBuyOrderTxParams, PlaceSellOrderTxParams, RawTransaction } from "./types.js";
+export declare function buildPlaceBuyOrderRawTx(params: PlaceBuyOrderTxParams): RawTransaction;
+export declare function buildPlaceSellOrderRawTx(params: PlaceSellOrderTxParams): RawTransaction;

package/dist/tx/buildPlaceOrderRawTx.js

@@ -0,0 +1,47 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { PLACE_BUY_ORDER, PLACE_SELL_ORDER } from "../constants/contractmethods.js";
+export function buildPlaceBuyOrderRawTx(params) {
+    const { marketContractAddress, option, optionSide, price, amount } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    if (optionSide === undefined || optionSide === null)
+        throw new Error("optionSide is required");
+    if (!price || price <= 0n)
+        throw new Error("price must be greater than 0");
+    if (!amount || amount <= 0n)
+        throw new Error("amount must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: PLACE_BUY_ORDER,
+            args: [option, optionSide, price, amount],
+        }),
+        value: 0n,
+    };
+}
+export function buildPlaceSellOrderRawTx(params) {
+    const { marketContractAddress, option, optionSide, price, shares } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    if (optionSide === undefined || optionSide === null)
+        throw new Error("optionSide is required");
+    if (!price || price <= 0n)
+        throw new Error("price must be greater than 0");
+    if (!shares || shares <= 0n)
+        throw new Error("shares must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: PLACE_SELL_ORDER,
+            args: [option, optionSide, price, shares],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/buildRemoveLiquidityRawTx.d.ts

@@ -0,0 +1,2 @@
+import { RemoveLiquidityTxParams, RawTransaction } from "./types.js";
+export declare function buildRemoveLiquidityRawTx(params: RemoveLiquidityTxParams): RawTransaction;

package/dist/tx/buildRemoveLiquidityRawTx.js

@@ -0,0 +1,23 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { REMOVE_LIQUIDITY } from "../constants/contractmethods.js";
+export function buildRemoveLiquidityRawTx(params) {
+    const { marketContractAddress, option, lpShares } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    if (!lpShares)
+        throw new Error("lpShares is required");
+    if (lpShares <= 0n)
+        throw new Error("lpShares must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: REMOVE_LIQUIDITY,
+            args: [option, lpShares],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/buildSplitRawTx.d.ts

@@ -0,0 +1,2 @@
+import { SplitTxParams, RawTransaction } from "./types.js";
+export declare function buildSplitRawTx(params: SplitTxParams): RawTransaction;

package/dist/tx/buildSplitRawTx.js

@@ -0,0 +1,21 @@
+import { encodeFunctionData } from "viem";
+import { MarketsAbi } from "../abi/MarketsAbi.js";
+import { SPLIT } from "../constants/contractmethods.js";
+export function buildSplitRawTx(params) {
+    const { marketContractAddress, option, amount } = params;
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (option === undefined || option === null)
+        throw new Error("option is required");
+    if (!amount || amount <= 0n)
+        throw new Error("amount must be greater than 0");
+    return {
+        to: marketContractAddress,
+        data: encodeFunctionData({
+            abi: MarketsAbi,
+            functionName: SPLIT,
+            args: [option, amount],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/types.d.ts

@@ -0,0 +1,117 @@
+export interface RawTransaction {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    value?: bigint;
+}
+export type ApproveTxParams = {
+    tokenAddress: `0x${string}`;
+    spender: `0x${string}`;
+    amount: bigint;
+};
+export declare enum TradingModel {
+    AMM = 0,
+    OrderBook = 1
+}
+export declare enum OptionSide {
+    Yes = 1,
+    No = 2
+}
+export interface EnterOptionTxParams {
+    marketContractAddress: `0x${string}`;
+    selectedOption: bigint;
+    optionSide: OptionSide;
+    buyAmountInWei: bigint;
+}
+export interface PlaceBuyOrderTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    optionSide: OptionSide;
+    price: bigint;
+    amount: bigint;
+}
+export interface PlaceSellOrderTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    optionSide: OptionSide;
+    price: bigint;
+    shares: bigint;
+}
+export interface CancelBuyOrdersTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    optionSides: number[];
+    prices: bigint[];
+    orderIDs: bigint[];
+}
+export interface CancelSellOrdersTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    optionSides: number[];
+    prices: bigint[];
+    orderIDs: bigint[];
+}
+export interface ClaimTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+}
+export interface OpenDisputeTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+}
+export interface ClosePoolAITxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+}
+export interface ClosePoolManualTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    proposedWinner: number;
+}
+export interface ChooseWinnerTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    optionSide: number;
+}
+export interface SplitTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    amount: bigint;
+}
+export interface MergeTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    amount: bigint;
+}
+export interface AddLiquidityTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    totalAmountInWei: bigint;
+}
+export interface RemoveLiquidityTxParams {
+    marketContractAddress: `0x${string}`;
+    option: bigint;
+    lpShares: bigint;
+}
+export interface CreateMarketTxParams {
+    marketQuestion: string;
+    marketOptions: string[];
+    marketTags: string[];
+    marketDescription: string;
+    isPublic: boolean;
+    isPublicPoolResolverAi: boolean;
+    creator: `0x${string}`;
+    startTime: bigint;
+    endTime: bigint;
+    no_of_options: bigint;
+    disputeTimer: number;
+    inputAmountWei: bigint;
+    barValues: number[];
+    baseToken: `0x${string}`;
+    tradingModel?: TradingModel;
+    questionImage?: string;
+    tokenDecimals?: number;
+    factoryContractAddress?: `0x${string}`;
+    oracleFixedFeePerOption?: bigint;
+    apiUrl?: string;
+    rpcUrl?: string;
+}

package/dist/tx/types.js

@@ -0,0 +1,10 @@
+export var TradingModel;
+(function (TradingModel) {
+    TradingModel[TradingModel["AMM"] = 0] = "AMM";
+    TradingModel[TradingModel["OrderBook"] = 1] = "OrderBook";
+})(TradingModel || (TradingModel = {}));
+export var OptionSide;
+(function (OptionSide) {
+    OptionSide[OptionSide["Yes"] = 1] = "Yes";
+    OptionSide[OptionSide["No"] = 2] = "No";
+})(OptionSide || (OptionSide = {}));

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+import { WalletClient } from 'viem';
+import { Chain } from 'viem/chains';
+export interface RainConfig {
+    walletClient: WalletClient;
+    alchemyApiKey?: string;
+    paymasterPolicyId?: string;
+    chain: Chain;
+    rpcUrl?: string;
+}
+export type RainEnvironment = "development";
+export interface RainCoreConfig {
+    environment?: RainEnvironment;
+    rpcUrl?: string;
+    apiUrl?: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/helpers.d.ts

@@ -0,0 +1,4 @@
+import { CreateMarketTxParams } from "../tx/types.js";
+export declare const convertToWeiEthers: (value: string | bigint, decimals: number) => bigint;
+export declare function isRpcValid(rpcUrl: string | undefined): Promise<boolean>;
+export declare function getUserAllowance(params: CreateMarketTxParams): Promise<number>;

package/dist/utils/helpers.js

@@ -0,0 +1,28 @@
+import { ethers, JsonRpcProvider, Contract } from "ethers";
+import { ERC20Abi } from "../abi/ERC20Abi.js";
+export const convertToWeiEthers = (value, decimals) => {
+    return ethers.parseUnits(value.toString(), decimals);
+};
+export async function isRpcValid(rpcUrl) {
+    if (!rpcUrl)
+        return false;
+    const provider = new JsonRpcProvider(rpcUrl);
+    try {
+        await provider.getNetwork();
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+export async function getUserAllowance(params) {
+    const { factoryContractAddress, baseToken, creator, rpcUrl } = params;
+    const isRpcWorking = await isRpcValid(rpcUrl);
+    if (!rpcUrl || !isRpcWorking) {
+        throw new Error("Provided RPC URL is not valid or not working");
+    }
+    const provider = new JsonRpcProvider(rpcUrl);
+    const ERC20ApprovalContract = new Contract(baseToken, ERC20Abi, provider);
+    const userAllowance = await ERC20ApprovalContract.allowance(creator, factoryContractAddress);
+    return userAllowance;
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "rain-sdk-v2",
+    "version": "1.0.0",
+    "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",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc -w",
+        "prepublishOnly": "npm run build"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/UsamaShafique/rain-sdk-v2.git"
+    },
+    "keywords": [
+        "web3",
+        "account-abstraction",
+        "smart-account",
+        "rain",
+        "viem",
+        "alchemy"
+    ],
+    "author": "Rain Protocol",
+    "license": "MIT",
+    "peerDependencies": {
+        "@account-kit/infra": "^4.48.0",
+        "@account-kit/wallet-client": "^0.1.0-alpha.10",
+        "@alchemy/aa-alchemy": "^3.0.0",
+        "@alchemy/aa-core": "^3.0.0",
+        "viem": "^2.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@account-kit/infra": {
+            "optional": true
+        },
+        "@account-kit/wallet-client": {
+            "optional": true
+        },
+        "@alchemy/aa-alchemy": {
+            "optional": true
+        },
+        "@alchemy/aa-core": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "ethers": "^6.16.0",
+        "socket.io-client": "^4.8.3"
+    },
+    "devDependencies": {
+        "typescript": "^5.9.3",
+        "viem": "^2.48.8"
+    }
+}