otomato-sdk 2.0.480 → 2.0.481

package/dist/src/constants/version.js

@@ -1,4 +1,4 @@
-export const SDK_VERSION = '2.0.480';
+export const SDK_VERSION = '2.0.481';
 export function compareVersions(v1, v2) {
     // Split the version strings into parts
     const v1Parts = v1.split('.').map(Number);

package/dist/src/index.js

@@ -26,3 +26,4 @@ export * from './utils/typeValidator.js';
 export * from './utils/addressBalance.js';
 export * from './utils/externalVariables.js';
 export * from './utils/renderEnum.js';
+export * from './utils/polymarket.js';

package/dist/src/utils/polymarket.js

@@ -0,0 +1,68 @@
+import { ethers } from 'ethers';
+// Polymarket Safe Wallet (browser wallet: MetaMask, Rainbow, Coinbase Wallet, etc.)
+const SAFE_FACTORY = '0xaacFeEa03eb1561C4e67d661e40682Bd20E3541b';
+const SAFE_INIT_CODE_HASH = '0x2bce2127ff07fb632d16c8347c4ebf501f4841168bed00d9e6ef715ddb6fcecf';
+const POLYMARKET_DATA_API_URL = 'https://data-api.polymarket.com';
+/**
+ * Derives the Polymarket Safe wallet address from an EOA using CREATE2.
+ * Used for browser wallet users (MetaMask, Rainbow, Coinbase Wallet, etc.).
+ *
+ * CREATE2: keccak256(0xff ++ factory ++ salt ++ initCodeHash)[12:]
+ * Salt: keccak256(abi.encode(eoaAddress))
+ *
+ * @param eoaAddress - User's externally owned account address
+ * @returns The Polymarket Safe wallet address on Polygon
+ */
+export function derivePolymarketSafeAddress(eoaAddress) {
+    const salt = ethers.keccak256(ethers.AbiCoder.defaultAbiCoder().encode(['address'], [eoaAddress]));
+    return ethers.getCreate2Address(SAFE_FACTORY, salt, SAFE_INIT_CODE_HASH);
+}
+/**
+ * Detects whether the given address is an EOA (from which we derive the Polymarket Safe)
+ * or a Polymarket wallet address provided directly by the user (Magic/email users).
+ *
+ * Detection logic:
+ * 1. Check if the address itself has positions on Polymarket → POLYMARKET_DIRECT
+ * 2. Derive the Safe address and check if it has positions → EOA
+ * 3. No activity on either → default to EOA
+ *
+ * @param address - The address to detect
+ * @returns The address type and the resolved Polymarket wallet address
+ */
+export async function detectAddressType(address) {
+    // Check if this address has positions on Polymarket directly
+    const directPositions = await fetchPolymarketPositions(address);
+    if (directPositions !== null && directPositions.length > 0) {
+        return { type: 'POLYMARKET_DIRECT', polymarketAddress: address };
+    }
+    // Derive the Safe address and check that
+    const derivedSafe = derivePolymarketSafeAddress(address);
+    const derivedPositions = await fetchPolymarketPositions(derivedSafe);
+    if (derivedPositions !== null && derivedPositions.length > 0) {
+        return { type: 'EOA', polymarketAddress: derivedSafe };
+    }
+    // No activity found on either → assume EOA (will be checked again later)
+    return { type: 'EOA', polymarketAddress: derivedSafe };
+}
+/**
+ * Resolves the Polymarket wallet address from any input address.
+ * Handles both EOA (derives Safe) and direct Polymarket addresses.
+ *
+ * @param address - EOA or direct Polymarket address
+ * @returns The Polymarket wallet address to use for API calls
+ */
+export async function resolvePolymarketAddress(address) {
+    const { polymarketAddress } = await detectAddressType(address);
+    return polymarketAddress;
+}
+async function fetchPolymarketPositions(address) {
+    try {
+        const response = await fetch(`${POLYMARKET_DATA_API_URL}/positions?user=${address}`);
+        if (!response.ok)
+            return null;
+        return await response.json();
+    }
+    catch {
+        return null;
+    }
+}

package/dist/types/src/constants/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "2.0.480";
+export declare const SDK_VERSION = "2.0.481";
 export declare function compareVersions(v1: string, v2: string): number;

package/dist/types/src/index.d.ts

@@ -23,3 +23,4 @@ export * from './utils/typeValidator.js';
 export * from './utils/addressBalance.js';
 export * from './utils/externalVariables.js';
 export * from './utils/renderEnum.js';
+export * from './utils/polymarket.js';

package/dist/types/src/utils/polymarket.d.ts

@@ -0,0 +1,36 @@
+export type PolymarketAddressType = 'EOA' | 'POLYMARKET_DIRECT';
+/**
+ * Derives the Polymarket Safe wallet address from an EOA using CREATE2.
+ * Used for browser wallet users (MetaMask, Rainbow, Coinbase Wallet, etc.).
+ *
+ * CREATE2: keccak256(0xff ++ factory ++ salt ++ initCodeHash)[12:]
+ * Salt: keccak256(abi.encode(eoaAddress))
+ *
+ * @param eoaAddress - User's externally owned account address
+ * @returns The Polymarket Safe wallet address on Polygon
+ */
+export declare function derivePolymarketSafeAddress(eoaAddress: string): string;
+/**
+ * Detects whether the given address is an EOA (from which we derive the Polymarket Safe)
+ * or a Polymarket wallet address provided directly by the user (Magic/email users).
+ *
+ * Detection logic:
+ * 1. Check if the address itself has positions on Polymarket → POLYMARKET_DIRECT
+ * 2. Derive the Safe address and check if it has positions → EOA
+ * 3. No activity on either → default to EOA
+ *
+ * @param address - The address to detect
+ * @returns The address type and the resolved Polymarket wallet address
+ */
+export declare function detectAddressType(address: string): Promise<{
+    type: PolymarketAddressType;
+    polymarketAddress: string;
+}>;
+/**
+ * Resolves the Polymarket wallet address from any input address.
+ * Handles both EOA (derives Safe) and direct Polymarket addresses.
+ *
+ * @param address - EOA or direct Polymarket address
+ * @returns The Polymarket wallet address to use for API calls
+ */
+export declare function resolvePolymarketAddress(address: string): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "otomato-sdk",
-  "version": "2.0.480",
+  "version": "2.0.481",
   "description": "An SDK for building and managing automations on Otomato",
   "repository": {
     "type": "git",