rain-sdk-v2 1.0.2 → 1.0.4

package/README.md

@@ -23,14 +23,21 @@ import { arbitrum } from 'viem/chains';
 
 // Initialize SDK
 const rain = new Rain({
-  environment: 'development', // 'development' | 'stage' | 'production'
+  environment: 'development', // 'development' | 'stage'
   rpcUrl: 'https://arb1.arbitrum.io/rpc', // optional, uses random public RPC if omitted
 });
 
 // Get environment config
 const config = rain.getEnvironmentConfig();
-console.log(config.usdt_token); // USDT contract address
 console.log(config.market_factory_address); // Factory contract
+console.log(config.tokens.usdt.address);    // USDT token address
+console.log(config.tokens.rain.address);    // RAIN token address
+console.log(config.tokens.usdt.decimals);   // 6
+console.log(config.tokens.rain.decimals);   // 18
+
+// Get token config by address
+const tokenInfo = rain.getTokenConfig('0x...');
+console.log(tokenInfo?.decimals, tokenInfo?.symbol);
 ```
 
 ---
@@ -49,7 +56,7 @@ const rain = new Rain(config?: RainCoreConfig);
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `environment` | `'development' \| 'stage' \| 'production'` | `'development'` | Target environment |
+| `environment` | `'development' \| 'stage'` | `'development'` | Target environment |
 | `rpcUrl` | `string` | Random public RPC | Custom Arbitrum RPC URL |
 | `apiUrl` | `string` | From environment | Custom API URL |
 
@@ -130,9 +137,12 @@ interface RawTransaction {
 Creates a new prediction market. Returns approval TX (if needed) + createPool TX.
 
 ```typescript
+const config = rain.getEnvironmentConfig();
+
+// Create market with USDT (6 decimals)
 const txs = await rain.buildCreateMarketTx({
   marketQuestion: 'Will ETH reach $5000 by end of 2025?',
-  marketOptions: ['Yes', 'No', 'Maybe'],
+  marketOptions: ['Yes', 'No'],
   marketTags: ['crypto'],
   marketDescription: 'Prediction on ETH price target',
   isPublic: true,
@@ -140,21 +150,29 @@ const txs = await rain.buildCreateMarketTx({
   creator: '0x...', // smart account or EOA address
   startTime: BigInt(Math.floor(Date.now() / 1000) + 120), // 2 min from now
   endTime: BigInt(Math.floor(Date.now() / 1000) + 86400), // 24h from now
-  no_of_options: 3n,
+  no_of_options: 2n,
   disputeTimer: 60, // seconds (set by SDK from environment)
-  inputAmountWei: parseUnits('10', 6), // 10 USDT initial liquidity
-  barValues: [33.33, 33.33, 33.34], // probability distribution (0-100, sums to 100)
-  baseToken: config.usdt_token, // USDT address
+  inputAmountWei: parseUnits('10', 6), // 10 USDT
+  barValues: [50, 50], // probability distribution (0-100, sums to 100)
+  baseToken: config.tokens.usdt.address, // USDT
   tradingModel: TradingModel.AMM, // AMM = 0, OrderBook = 1
 });
 
+// Create market with RAIN token (18 decimals)
+const txsRain = await rain.buildCreateMarketTx({
+  ...params,
+  inputAmountWei: parseUnits('10', 18), // 10 RAIN
+  baseToken: config.tokens.rain.address, // RAIN token
+});
+
 // Approval amount = liquidity + (oracleFixedFeePerOption * numberOfOptions)
+// Oracle fee is automatically calculated based on the token's decimals
 ```
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `marketQuestion` | `string` | The market question |
-| `marketOptions` | `string[]` | Option labels (3-26 options) |
+| `marketOptions` | `string[]` | Option labels (2-26 options) |
 | `marketTags` | `string[]` | Tags (1-3) |
 | `marketDescription` | `string` | Description |
 | `isPublic` | `boolean` | Public market |
@@ -408,7 +426,7 @@ Build an ERC20 approve transaction.
 
 ```typescript
 const tx = rain.buildApprovalTx({
-  tokenAddress: config.usdt_token,
+  tokenAddress: config.tokens.usdt.address,
   spender: '0x...', // market contract address
   amount: parseUnits('100', 6), // 100 USDT
 });
@@ -424,7 +442,7 @@ Check current ERC20 allowance.
 
 ```typescript
 const allowance = await rain.getTokenAllowance({
-  tokenAddress: config.usdt_token,
+  tokenAddress: config.tokens.usdt.address,
   owner: '0x...', // your address
   spender: '0x...', // market contract
 });
@@ -534,9 +552,22 @@ const result = await rain.checkOrderExists({
 
 Wallet-based login to the Rain backend.
 
+#### `signLoginMessage(walletClient, walletAddress)`
+
+Signs the lowercased wallet address using `personal_sign`. This signature is required for login.
+
+```typescript
+import { signLoginMessage } from 'rain-sdk-v2';
+
+const walletClient = createWalletClient({ chain: arbitrum, transport: custom(window.ethereum) });
+const signature = await signLoginMessage(walletClient, '0x...' as `0x${string}`);
+```
+
+#### `login(params)`
+
 ```typescript
 const result = await rain.login({
-  signature: '0x...', // personal_sign of lowercased wallet address
+  signature, // from signLoginMessage
   walletAddress: '0x...', // EOA address
   smartWalletAddress: '0x...', // Smart account address
   referredBy: 'CODE', // optional referral code
@@ -564,10 +595,17 @@ Returns:
 | `apiUrl` | Backend API URL |
 | `market_factory_address` | Factory contract address |
 | `dispute_initial_timer` | Dispute timer in seconds |
-| `oracle_fixed_fee_per_option` | Oracle fee per option in base token wei |
-| `usdt_symbol` | USDT token symbol |
-| `usdt_token` | USDT token address |
-| `rain_token` | RAIN token address |
+| `tokens.usdt` | USDT token config (`address`, `symbol`, `decimals`, `oracle_fixed_fee_per_option`) |
+| `tokens.rain` | RAIN token config (`address`, `symbol`, `decimals`, `oracle_fixed_fee_per_option`) |
+
+### `getTokenConfig(tokenAddress)`
+
+Looks up token configuration by contract address. Returns `TokenConfig` or `null`.
+
+```typescript
+const tokenInfo = rain.getTokenConfig('0x...');
+// { address, symbol, decimals, oracle_fixed_fee_per_option }
+```
 
 ---
 
@@ -595,11 +633,28 @@ enum OptionSide {
 
 ## Environments
 
-| Environment | API | Factory |
-|-------------|-----|---------|
-| `development` | `https://dev-api.rain.one` | `0xBD99...0adE` |
-| `stage` | `https://stg-api.rain.one` | `0xD490...96BE` |
-| `production` | `https://prod-api.rain.one` | `0xA864...F264` |
+| Environment | API | Factory | USDT | RAIN |
+|-------------|-----|---------|------|------|
+| `development` | `https://dev2-api.rain.one` | `0xBD99...0adE` | 6 decimals | 18 decimals |
+| `stage` | `https://stg2-api.rain.one` | `0x4b93...2884` | 6 decimals | 18 decimals |
+
+### Supported Tokens
+
+Each environment includes token configs for both **USDT** (6 decimals) and **RAIN** (18 decimals). The SDK automatically handles decimal conversions for oracle fees and minimum liquidity validation based on the token used.
+
+```typescript
+const config = rain.getEnvironmentConfig();
+
+// USDT
+config.tokens.usdt.address   // Token contract address
+config.tokens.usdt.decimals  // 6
+config.tokens.usdt.symbol    // "USDTm" (dev) or "USD₮0" (stage)
+
+// RAIN
+config.tokens.rain.address   // Token contract address
+config.tokens.rain.decimals  // 18
+config.tokens.rain.symbol    // "RAIN"
+```
 
 ---
 

package/dist/Rain.d.ts

@@ -8,9 +8,12 @@ export declare class Rain {
     private readonly marketFactory;
     private readonly apiUrl;
     private readonly distute_initial_timer;
-    private readonly oracleFixedFeePerOption;
     private readonly rpcUrl?;
     constructor(config?: RainCoreConfig);
+    /**
+     * Get token config by address. Returns decimals, symbol, and oracle fee.
+     */
+    getTokenConfig(tokenAddress: `0x${string}`): import("./config/environments.js").TokenConfig | null;
     buildApprovalTx(params: ApproveTxParams): RawTransaction;
     buildCreateMarketTx(params: CreateMarketTxParams): Promise<RawTransaction[]>;
     buildEnterOptionTx(params: EnterOptionTxParams): RawTransaction;
@@ -89,10 +92,18 @@ export declare class Rain {
         readonly apiUrl: "https://dev2-api.rain.one";
         readonly market_factory_address: `0x${string}`;
         readonly dispute_initial_timer: number;
-        readonly oracle_fixed_fee_per_option: 1000000n;
-        readonly usdt_symbol: "USDTm";
-        readonly usdt_token: `0x${string}`;
-        readonly rain_token: `0x${string}`;
+        readonly tokens: {
+            readonly usdt: import("./config/environments.js").TokenConfig;
+            readonly rain: import("./config/environments.js").TokenConfig;
+        };
+    } | {
+        readonly apiUrl: "https://stg2-api.rain.one";
+        readonly market_factory_address: `0x${string}`;
+        readonly dispute_initial_timer: number;
+        readonly tokens: {
+            readonly usdt: import("./config/environments.js").TokenConfig;
+            readonly rain: import("./config/environments.js").TokenConfig;
+        };
     };
     private cfg;
     findUserByWalletAddress(params: {

package/dist/Rain.js

@@ -36,7 +36,6 @@ export class Rain {
     marketFactory;
     apiUrl;
     distute_initial_timer;
-    oracleFixedFeePerOption;
     rpcUrl;
     constructor(config = {}) {
         const { environment = "development", rpcUrl, apiUrl } = config;
@@ -52,13 +51,28 @@ export class Rain {
         this.marketFactory = envConfig.market_factory_address;
         this.apiUrl = apiUrl ?? envConfig.apiUrl;
         this.distute_initial_timer = envConfig.dispute_initial_timer;
-        this.oracleFixedFeePerOption = envConfig.oracle_fixed_fee_per_option;
+    }
+    /**
+     * Get token config by address. Returns decimals, symbol, and oracle fee.
+     */
+    getTokenConfig(tokenAddress) {
+        const envConfig = ENV_CONFIG[this.environment];
+        const tokens = envConfig.tokens;
+        for (const key of Object.keys(tokens)) {
+            if (tokens[key].address.toLowerCase() === tokenAddress.toLowerCase()) {
+                return tokens[key];
+            }
+        }
+        return null;
     }
     buildApprovalTx(params) {
         return buildApproveRawTx(params);
     }
     buildCreateMarketTx(params) {
-        return buildCreateMarketRawTx({ ...params, factoryContractAddress: this.marketFactory, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl, disputeTimer: this.distute_initial_timer, oracleFixedFeePerOption: this.oracleFixedFeePerOption });
+        const tokenConfig = this.getTokenConfig(params.baseToken);
+        const oracleFixedFeePerOption = tokenConfig?.oracle_fixed_fee_per_option ?? 1000000n;
+        const tokenDecimals = params.tokenDecimals ?? tokenConfig?.decimals ?? 6;
+        return buildCreateMarketRawTx({ ...params, tokenDecimals, factoryContractAddress: this.marketFactory, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl, disputeTimer: this.distute_initial_timer, oracleFixedFeePerOption });
     }
     buildEnterOptionTx(params) {
         return buildEnterOptionRawTx(params);

package/dist/auth/signMessage.d.ts

@@ -0,0 +1,6 @@
+import { WalletClient } from 'viem';
+/**
+ * Signs the lowercased wallet address using personal_sign.
+ * This signature is required for the Rain login API.
+ */
+export declare function signLoginMessage(walletClient: WalletClient, walletAddress: `0x${string}`): Promise<string>;

package/dist/auth/signMessage.js

@@ -0,0 +1,12 @@
+/**
+ * Signs the lowercased wallet address using personal_sign.
+ * This signature is required for the Rain login API.
+ */
+export async function signLoginMessage(walletClient, walletAddress) {
+    const message = walletAddress.toLowerCase();
+    const signature = await walletClient.signMessage({
+        account: walletAddress,
+        message,
+    });
+    return signature;
+}

package/dist/config/environments.d.ts

@@ -1,15 +1,30 @@
-export declare const ALLOWED_ENVIRONMENTS: readonly ["development"];
+export declare const ALLOWED_ENVIRONMENTS: readonly ["development", "stage"];
 export declare const DEFAULT_RPCS: string[];
 export declare function getRandomRpc(): string;
 export declare const USDT_SYMBOL_DEV = "USDTm";
+export interface TokenConfig {
+    address: `0x${string}`;
+    symbol: string;
+    decimals: number;
+    oracle_fixed_fee_per_option: bigint;
+}
 export declare const ENV_CONFIG: {
     readonly development: {
         readonly apiUrl: "https://dev2-api.rain.one";
         readonly market_factory_address: `0x${string}`;
         readonly dispute_initial_timer: number;
-        readonly oracle_fixed_fee_per_option: 1000000n;
-        readonly usdt_symbol: "USDTm";
-        readonly usdt_token: `0x${string}`;
-        readonly rain_token: `0x${string}`;
+        readonly tokens: {
+            readonly usdt: TokenConfig;
+            readonly rain: TokenConfig;
+        };
+    };
+    readonly stage: {
+        readonly apiUrl: "https://stg2-api.rain.one";
+        readonly market_factory_address: `0x${string}`;
+        readonly dispute_initial_timer: number;
+        readonly tokens: {
+            readonly usdt: TokenConfig;
+            readonly rain: TokenConfig;
+        };
     };
 };

package/dist/config/environments.js

@@ -1,4 +1,4 @@
-export const ALLOWED_ENVIRONMENTS = ["development"];
+export const ALLOWED_ENVIRONMENTS = ["development", "stage"];
 export const DEFAULT_RPCS = [
     "https://arb1.arbitrum.io/rpc",
     "https://arbitrum-one.publicnode.com",
@@ -9,26 +9,45 @@ export function getRandomRpc() {
     return DEFAULT_RPCS[index];
 }
 export const USDT_SYMBOL_DEV = "USDTm";
-// export const USDT_SYMBOL_PROD = "USD₮0";
 export const ENV_CONFIG = {
     development: {
         apiUrl: "https://dev2-api.rain.one",
         market_factory_address: "0xBD99441C4116b85dFecA2d6521EC0e2Eb62F0adE",
         dispute_initial_timer: 1 * 60,
-        oracle_fixed_fee_per_option: 1000000n, // $1 per option (6 decimals)
-        usdt_symbol: USDT_SYMBOL_DEV,
-        usdt_token: "0xCa4f77A38d8552Dd1D5E44e890173921B67725F4",
-        rain_token: "0x25118290e6A5f4139381D072181157035864099d",
+        tokens: {
+            usdt: {
+                address: "0xCa4f77A38d8552Dd1D5E44e890173921B67725F4",
+                symbol: USDT_SYMBOL_DEV,
+                decimals: 6,
+                oracle_fixed_fee_per_option: 1000000n, // $1 in 6 decimals
+            },
+            rain: {
+                address: "0x25118290e6A5f4139381D072181157035864099d",
+                symbol: "RAIN",
+                decimals: 18,
+                oracle_fixed_fee_per_option: 1000000000000000000n, // $1 in 18 decimals
+            },
+        },
+    },
+    stage: {
+        apiUrl: "https://stg2-api.rain.one",
+        market_factory_address: "0x4b936AB5114F3DFa2A010117Afeb47F746842884",
+        dispute_initial_timer: 1 * 60,
+        tokens: {
+            usdt: {
+                address: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+                symbol: "USD₮0",
+                decimals: 6,
+                oracle_fixed_fee_per_option: 1000000n,
+            },
+            rain: {
+                address: "0x43976a124e6834b541840Ce741243dAD3dd538DA",
+                symbol: "RAIN",
+                decimals: 18,
+                oracle_fixed_fee_per_option: 1000000000000000000n,
+            },
+        },
     },
-    // stage: {
-    //     apiUrl: "https://stg-api.rain.one",
-    //     market_factory_address: "0xD4900CA167228365806FBA4cB21f7EAe8b6d96BE" as `0x${string}`,
-    //     dispute_initial_timer: 1 * 60,
-    //     oracle_fixed_fee_per_option: 1_000_000n, // $1 per option (6 decimals)
-    //     usdt_symbol: USDT_SYMBOL_PROD,
-    //     usdt_token: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9" as `0x${string}`,
-    //     rain_token: "0x43976a124e6834b541840Ce741243dAD3dd538DA" as `0x${string}`,
-    // },
     // production: {
     //     apiUrl: "https://prod-api.rain.one",
     //     market_factory_address: "0xA8640B62D755e42C9ed6A86d0fc65CE09e31F264" as `0x${string}`,

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export * from './types.js';
 export { TradingModel, OptionSide } from './tx/types.js';
 export type { CreateMarketTxParams, EnterOptionTxParams, AddLiquidityTxParams, RemoveLiquidityTxParams, SplitTxParams, MergeTxParams, ClosePoolAITxParams, ClosePoolManualTxParams, ChooseWinnerTxParams, PlaceBuyOrderTxParams, PlaceSellOrderTxParams, OpenDisputeTxParams, ClaimTxParams, CancelBuyOrdersTxParams, CancelSellOrdersTxParams, RawTransaction, ApproveTxParams } from './tx/types.js';
 export type { LoginParams, LoginResult } from './auth/types.js';
+export { signLoginMessage } from './auth/signMessage.js';
+export type { TokenConfig } from './config/environments.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/index.js

@@ -2,5 +2,6 @@ export { Rain } from './Rain.js';
 export { RainAA } from './RainAA.js';
 export * from './types.js';
 export { TradingModel, OptionSide } from './tx/types.js';
+export { signLoginMessage } from './auth/signMessage.js';
 export * from './api/index.js';
 export { RainSocket } from './socket/RainSocket.js';

package/dist/tx/CreateMarket/createMarketValidation.js

@@ -11,8 +11,8 @@ export function validateCreateMarketParams(params) {
         throw new Error("question is required");
     if (!marketDescription)
         throw new Error("description is required");
-    if (!Array.isArray(marketOptions) || marketOptions.length < 3 || marketOptions.length > 26) {
-        throw new Error("options must be between 3 and 26");
+    if (!Array.isArray(marketOptions) || marketOptions.length < 2 || marketOptions.length > 26) {
+        throw new Error("options must be between 2 and 26");
     }
     if (marketOptions.some(opt => !opt?.toString().trim())) {
         throw new Error("options cannot contain empty values");
@@ -39,8 +39,10 @@ export function validateCreateMarketParams(params) {
         throw new Error("factoryContractAddress is required");
     const decimals = tokenDecimals ?? 6;
     const oneTokenInWei = 10n ** BigInt(decimals);
-    if (inputAmountWei < oneTokenInWei * 10n) {
-        throw new Error("Market cannot be opened: inputAmountWei must be at least $10");
+    // $0.1 minimum for dev/stage, validation for production handled separately
+    const minAmount = oneTokenInWei / 10n; // 0.1 token
+    if (inputAmountWei < minAmount) {
+        throw new Error("Market cannot be opened: inputAmountWei must be at least $0.1");
     }
     if (startTime >= endTime)
         throw new Error("startTime must be earlier than endTime");

package/dist/types.d.ts

@@ -7,7 +7,7 @@ export interface RainConfig {
     chain: Chain;
     rpcUrl?: string;
 }
-export type RainEnvironment = "development";
+export type RainEnvironment = "development" | "stage";
 export interface RainCoreConfig {
     environment?: RainEnvironment;
     rpcUrl?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rain-sdk-v2",
-    "version": "1.0.2",
+    "version": "1.0.4",
     "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",