rain-sdk-v2 2.0.2 → 2.0.4

package/README.md

@@ -167,8 +167,9 @@ const txsRain = await rain.buildCreateMarketTx({
   baseToken: config.tokens.rain.address, // RAIN token
 });
 
-// Approval amount = liquidity + (oracleFixedFeePerOption * numberOfOptions)
-// Oracle fee is automatically calculated based on the token's decimals
+// Approval for USDT: liquidity + (oracleFixedFeePerOption * numberOfOptions)
+// Approval for RAIN: liquidity + (numberOfOptions * 20% of liquidity)
+// e.g. 1000 RAIN with 5 options → 1000 + (5 * 200) = 2000 RAIN approval
 ```
 
 | Parameter | Type | Description |
@@ -1068,6 +1069,14 @@ await rain.createDisputeMessage({
 const convo = await rain.getPoolDisputeConvo({ poolId: '...', subPool: '...', limit: 50, offset: 0 }, accessToken);
 ```
 
+### Whitelisted Tokens
+
+```typescript
+// Get token price in USD
+const priceData = await rain.getTokenPrice('0x...'); // token contract address
+// priceData.data = { price: 0.05 } — USD price per token
+```
+
 ---
 
 ## WebSocket Events (Socket.IO)

package/dist/Rain.d.ts

@@ -15,9 +15,11 @@ export declare class Rain {
      */
     getTokenConfig(tokenAddress: `0x${string}`): import("./config/environments.js").TokenConfig | null;
     buildApprovalTx(params: ApproveTxParams): RawTransaction;
-    getCreateMarketFees(tokenAddress: `0x${string}`): Promise<{
+    getCreateMarketFees(tokenAddress: `0x${string}`, inputAmountWei: bigint): Promise<{
         oracleFeePerOption: bigint;
         liquidityFeeBps: bigint;
+        useBufferApproval: boolean;
+        perOptionBuffer: bigint;
     }>;
     buildCreateMarketTx(params: CreateMarketTxParams): Promise<RawTransaction[]>;
     buildEnterOptionTx(params: EnterOptionTxParams & {
@@ -256,4 +258,5 @@ export declare class Rain {
     getFollowers(params: FollowListParams, accessToken?: string): Promise<import("./api/types.js").ApiResponse<unknown>>;
     getFollowing(params: FollowListParams, accessToken?: string): Promise<import("./api/types.js").ApiResponse<unknown>>;
     getFollowStats(params: FollowStatsParams, accessToken?: string): Promise<import("./api/types.js").ApiResponse<unknown>>;
+    getTokenPrice(tokenAddress: string): Promise<import("./api/types.js").ApiResponse<unknown>>;
 }

package/dist/Rain.js

@@ -33,13 +33,13 @@ import * as notificationsApi from './api/notifications.js';
 import * as rainBurnApi from './api/rainBurn.js';
 import * as disputeApi from './api/dispute.js';
 import * as followApi from './api/follow.js';
+import * as whitelistedTokensApi from './api/whitelistedTokens.js';
 const erc20AllowanceAbi = parseAbi(['function allowance(address owner, address spender) view returns (uint256)']);
 const factoryViewAbi = parseAbi([
     'function oracleFixedFee() view returns (uint256)',
     'function liquidityFee() view returns (uint256)',
     'function baseToken() view returns (address)',
 ]);
-const erc20DecimalsAbi = parseAbi(['function decimals() view returns (uint8)']);
 export class Rain {
     environment;
     marketFactory;
@@ -77,7 +77,7 @@ export class Rain {
     buildApprovalTx(params) {
         return buildApproveRawTx(params);
     }
-    async getCreateMarketFees(tokenAddress) {
+    async getCreateMarketFees(tokenAddress, inputAmountWei) {
         const pc = createPublicClient({ chain: arbitrum, transport: http(this.rpcUrl) });
         const [oracleFeeRaw, liquidityFeeBps, factoryBaseToken] = await Promise.all([
             pc.readContract({ address: this.marketFactory, abi: factoryViewAbi, functionName: 'oracleFixedFee' }),
@@ -85,18 +85,19 @@ export class Rain {
             pc.readContract({ address: this.marketFactory, abi: factoryViewAbi, functionName: 'baseToken' }),
         ]);
         if (tokenAddress.toLowerCase() === factoryBaseToken.toLowerCase()) {
-            return { oracleFeePerOption: oracleFeeRaw, liquidityFeeBps: liquidityFeeBps };
+            return { oracleFeePerOption: oracleFeeRaw, liquidityFeeBps: liquidityFeeBps, useBufferApproval: false, perOptionBuffer: 0n };
         }
-        const baseTokenDecimals = await pc.readContract({ address: factoryBaseToken, abi: erc20DecimalsAbi, functionName: 'decimals' });
-        const tokenConfig = this.getTokenConfig(tokenAddress);
-        const tokenDecimals = BigInt(tokenConfig?.decimals ?? 18);
-        const oracleFeePerOption = oracleFeeRaw * (10n ** (tokenDecimals - BigInt(baseTokenDecimals)));
-        return { oracleFeePerOption, liquidityFeeBps: liquidityFeeBps };
+        // For non-base tokens (e.g. RAIN): approval = initialLiquidity + (numberOfOptions * 20% of initialLiquidity)
+        const perOptionBuffer = inputAmountWei * 20n / 100n;
+        return { oracleFeePerOption: 0n, liquidityFeeBps: liquidityFeeBps, useBufferApproval: true, perOptionBuffer };
     }
     async buildCreateMarketTx(params) {
         const tokenConfig = this.getTokenConfig(params.baseToken);
         const tokenDecimals = params.tokenDecimals ?? tokenConfig?.decimals ?? 6;
-        const { oracleFeePerOption, liquidityFeeBps } = await this.getCreateMarketFees(params.baseToken);
+        const { oracleFeePerOption, liquidityFeeBps, useBufferApproval, perOptionBuffer } = await this.getCreateMarketFees(params.baseToken, params.inputAmountWei);
+        if (useBufferApproval) {
+            return buildCreateMarketRawTx({ ...params, tokenDecimals, factoryContractAddress: this.marketFactory, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl, disputeTimer: this.distute_initial_timer, oracleFixedFeePerOption: perOptionBuffer });
+        }
         const liquidityFeeAmount = params.inputAmountWei * liquidityFeeBps / 10000n;
         const totalOracleFee = oracleFeePerOption * BigInt(params.no_of_options) + liquidityFeeAmount;
         return buildCreateMarketRawTx({ ...params, tokenDecimals, factoryContractAddress: this.marketFactory, apiUrl: this.apiUrl, rpcUrl: this.rpcUrl, disputeTimer: this.distute_initial_timer, oracleFixedFeePerOption: totalOracleFee / BigInt(params.no_of_options) + 1n });
@@ -448,4 +449,8 @@ export class Rain {
     async getFollowStats(params, accessToken) {
         return followApi.getFollowStats(params, this.cfg(accessToken));
     }
+    // ─── Whitelisted Tokens ─────────────────────────────────────────────────────
+    async getTokenPrice(tokenAddress) {
+        return whitelistedTokensApi.getTokenPrice(tokenAddress, this.cfg());
+    }
 }

package/dist/api/index.d.ts

@@ -12,3 +12,4 @@ export * from './notifications.js';
 export * from './rainBurn.js';
 export * from './dispute.js';
 export * from './follow.js';
+export * from './whitelistedTokens.js';

package/dist/api/index.js

@@ -12,3 +12,4 @@ export * from './notifications.js';
 export * from './rainBurn.js';
 export * from './dispute.js';
 export * from './follow.js';
+export * from './whitelistedTokens.js';

package/dist/api/whitelistedTokens.d.ts

@@ -0,0 +1,2 @@
+import { ApiConfig, ApiResponse } from './types.js';
+export declare function getTokenPrice(tokenAddress: string, config: ApiConfig): Promise<ApiResponse>;

package/dist/api/whitelistedTokens.js

@@ -0,0 +1,8 @@
+import { buildHeaders, handleResponse } from './helpers.js';
+export async function getTokenPrice(tokenAddress, config) {
+    const res = await fetch(`${config.apiUrl}/whitelisted-tokens/get-token-price?tokenAddress=${encodeURIComponent(tokenAddress)}`, {
+        method: 'GET',
+        headers: buildHeaders(config),
+    });
+    return handleResponse(res);
+}

package/package.json

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