@rainprotocolsdk/sdk 2.0.0 → 2.1.0

package/README.md

@@ -30,7 +30,7 @@ yarn add @rainprotocolsdk/sdk
 ```ts
 import { Rain } from "@rainprotocolsdk/sdk";
 
-const rain = new Rain({ environment: "production" });
+const rain = new Rain();
 ```
 
 ### Constructor Parameters
@@ -825,6 +825,59 @@ const txs = await rain.buildCreateAppealTx({
 
 ---
 
+## buildExtendTimeTx
+
+Builds a **raw EVM transaction** to re-submit an appeal by extending the oracle voting timer on a disputed Rain market.
+
+Internally calls `resolver()` on the market contract to resolve the oracle address, then fetches a signed epoch from the Rain backend, and encodes the `extendTime(epoch, signature)` call targeting the oracle contract.
+
+This function **does not send the transaction** — it only prepares calldata.
+
+### Method Signature
+
+```ts
+buildExtendTimeTx(params: ExtendTimeTxParams): Promise<RawTransaction>
+```
+
+### Parameters
+
+```ts
+interface ExtendTimeTxParams {
+  marketContractAddress: `0x${string}`; // TradeMarket contract address — resolver() is called on it
+  walletAddress: `0x${string}`;         // Smart account address
+  accessToken: string;                   // JWT from Rain auth (login)
+}
+```
+
+### Validations
+
+| Field                   | Type          | Required | Description                                          |
+| ----------------------- | ------------- | -------- | ---------------------------------------------------- |
+| `marketContractAddress` | `0x${string}` | ✅        | Market contract — used to look up the oracle address |
+| `walletAddress`         | `0x${string}` | ✅        | Smart account address of the caller                  |
+| `accessToken`           | `string`      | ✅        | JWT returned from `login()`                          |
+
+### Return Type
+
+```ts
+interface RawTransaction {
+  to: `0x${string}`; // oracle contract address (resolved on-chain)
+  data: `0x${string}`;
+}
+```
+
+### Example
+
+```ts
+const tx = await rain.buildExtendTimeTx({
+  marketContractAddress: "0xMarketContractAddress...",
+  walletAddress: "0x996ea23940f4a01610181D04bdB6F862719b63f0",
+  accessToken: "eyJhbGciOi...",
+});
+```
+
+---
+
 ## RainAA Class (Account Abstraction)
 
 `RainAA` is responsible for:

package/dist/Rain.d.ts

@@ -1,5 +1,5 @@
 import { GetMarketByIdParams, GetMarketsParams, GetUserInvestmentsParams, Market, UserInvestment } from './markets/types.js';
-import { ApproveTxParams, CancelAllOpenOrdersTxParams, CancelOrdersTxParams, ClaimTxParams, CloseMarketTxParams, CreateDisputeTxParams, CreateAppealTxParams, CreateMarketTxParams, EnterLimitOptionTxParams, EnterOptionTxParams, LimitSellOptionTxParams, RawTransaction } from './tx/types.js';
+import { ApproveTxParams, CancelAllOpenOrdersTxParams, CancelOrdersTxParams, ClaimTxParams, CloseMarketTxParams, CreateDisputeTxParams, CreateAppealTxParams, CreateMarketTxParams, EnterLimitOptionTxParams, EnterOptionTxParams, ExtendTimeTxParams, LimitSellOptionTxParams, RawTransaction } from './tx/types.js';
 import { RainCoreConfig, RainEnvironment } from './types.js';
 import { LoginParams, LoginResult } from './auth/types.js';
 export declare class Rain {
@@ -24,5 +24,6 @@ export declare class Rain {
     buildCloseMarketTx(params: CloseMarketTxParams): Promise<RawTransaction[]>;
     buildCreateDisputeTx(params: CreateDisputeTxParams): Promise<RawTransaction[]>;
     buildCreateAppealTx(params: CreateAppealTxParams): Promise<RawTransaction[]>;
+    buildExtendTimeTx(params: ExtendTimeTxParams): Promise<RawTransaction>;
     login(params: LoginParams): Promise<LoginResult>;
 }

package/dist/Rain.js

@@ -10,6 +10,7 @@ import { buildApproveRawTx } from './tx/buildApprovalRawTx.js';
 import { buildCreateMarketRawTx } from './tx/CreateMarket/buildCreateMarketRawTx.js';
 import { ALLOWED_ENVIRONMENTS, ENV_CONFIG, getRandomRpc } from './config/environments.js';
 import { buildClaimRawTx } from './tx/ClaimFunds/buildClaimFundsRawTx.js';
+import { buildExtendTimeRawTx } from './tx/ExtendTime/buildExtendTimeRawTx.js';
 import { loginUser } from './auth/login.js';
 export class Rain {
     environment;
@@ -76,6 +77,9 @@ export class Rain {
     async buildCreateAppealTx(params) {
         return buildCreateAppealRawTx({ ...params, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl, usdtSymbol: this.usdtSymbol });
     }
+    async buildExtendTimeTx(params) {
+        return buildExtendTimeRawTx({ ...params, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl });
+    }
     async login(params) {
         return loginUser({ ...params, apiUrl: this.apiUrl });
     }

package/dist/abi/OracleAbi.d.ts

@@ -0,0 +1,15 @@
+export declare const OracleAbi: readonly [{
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "newEndTime";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly name: "extendTime";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];

package/dist/abi/OracleAbi.js

@@ -0,0 +1,20 @@
+export const OracleAbi = [
+    {
+        "inputs": [
+            {
+                "internalType": "uint256",
+                "name": "newEndTime",
+                "type": "uint256"
+            },
+            {
+                "internalType": "bytes",
+                "name": "signature",
+                "type": "bytes"
+            }
+        ],
+        "name": "extendTime",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    }
+];

package/dist/tx/ExtendTime/buildExtendTimeRawTx.d.ts

@@ -0,0 +1,2 @@
+import { ExtendTimeTxParams, RawTransaction } from "../types.js";
+export declare function buildExtendTimeRawTx(params: ExtendTimeTxParams): Promise<RawTransaction>;

package/dist/tx/ExtendTime/buildExtendTimeRawTx.js

@@ -0,0 +1,46 @@
+import { encodeFunctionData } from "viem";
+import { Contract, JsonRpcProvider } from "ethers";
+import { OracleAbi } from "../../abi/OracleAbi.js";
+import { TradePoolAbi } from "../../abi/TradeMarketsAbi.js";
+async function getOracleAddress(marketContractAddress, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const contract = new Contract(marketContractAddress, TradePoolAbi, provider);
+    const resolver = await contract.resolver();
+    return resolver;
+}
+async function fetchExtendTimeSignature(oracleContractAddress, walletAddress, accessToken, apiUrl) {
+    const res = await fetch(`${apiUrl}/pools/sign-oracles-extend-time?contractAddress=${oracleContractAddress}&walletAddress=${walletAddress}`, { headers: { Authorization: `Bearer ${accessToken}` } });
+    if (!res.ok)
+        throw new Error(`Failed to fetch extend time signature: ${res.status}`);
+    const data = await res.json();
+    if (!data?.epoch || !data?.signature)
+        throw new Error("Invalid response from extend time signature endpoint");
+    return {
+        epoch: BigInt(data.epoch),
+        signature: data.signature,
+    };
+}
+export async function buildExtendTimeRawTx(params) {
+    const { marketContractAddress, walletAddress, accessToken, apiUrl, rpcUrl } = params;
+    if (!apiUrl)
+        throw new Error("Environment is not set properly, api url is missing");
+    if (!rpcUrl)
+        throw new Error("rpcUrl is required");
+    if (!marketContractAddress)
+        throw new Error("marketContractAddress is required");
+    if (!walletAddress)
+        throw new Error("walletAddress is required");
+    if (!accessToken)
+        throw new Error("accessToken is required");
+    const oracleContractAddress = await getOracleAddress(marketContractAddress, rpcUrl);
+    const { epoch, signature } = await fetchExtendTimeSignature(oracleContractAddress, walletAddress, accessToken, apiUrl);
+    return {
+        to: oracleContractAddress,
+        data: encodeFunctionData({
+            abi: OracleAbi,
+            functionName: "extendTime",
+            args: [epoch, signature],
+        }),
+        value: 0n,
+    };
+}

package/dist/tx/types.d.ts

@@ -99,6 +99,13 @@ export interface CancelAllOpenOrdersTxParams {
     accessToken: string;
     apiUrl?: string;
 }
+export interface ExtendTimeTxParams {
+    marketContractAddress: `0x${string}`;
+    walletAddress: `0x${string}`;
+    accessToken: string;
+    apiUrl?: string;
+    rpcUrl?: string;
+}
 export interface GetUserOptionSharesParams {
     options: [{
         choiceIndex: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rainprotocolsdk/sdk",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "type": "module",
     "description": "Rain SDK",
     "main": "dist/index.js",