sdk-triggerx 0.1.38 → 0.1.40

package/dist/api/jobs.js

@@ -226,6 +226,8 @@ async function createJob(client, params) {
         return (0, errors_1.createErrorResponse)(new errors_1.NetworkError('Failed to get network information', { originalError: err }), 'Network error');
     }
     const chainIdStr = network?.chainId ? network.chainId.toString() : undefined;
+    // Wait for remote addresses if fetch is in-flight
+    await (0, config_1.ensureAddressesLoaded)();
     const { jobRegistry, safeModule, safeFactory, multisendCallOnly } = (0, config_1.getChainAddresses)(chainIdStr);
     const JOB_REGISTRY_ADDRESS = jobRegistry;
     if (!JOB_REGISTRY_ADDRESS) {

package/dist/api/safeWallet.js

@@ -17,6 +17,8 @@ async function createSafeWallet(signer) {
     if (!network?.chainId)
         throw new Error('Could not get chainId from signer provider');
     const chainId = network.chainId.toString();
+    // Wait for remote addresses if fetch is in-flight
+    await (0, config_1.ensureAddressesLoaded)();
     const { safeFactory } = (0, config_1.getChainAddresses)(chainId);
     if (!safeFactory)
         throw new Error(`SafeFactory not configured for chain ${chainId}`);

package/dist/client.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TriggerXClient = void 0;
 const axios_1 = __importDefault(require("axios"));
+const config_1 = require("./config");
 class TriggerXClient {
     constructor(apiKey, config) {
         this.apiKey = apiKey; // Initialize the apiKey
@@ -16,6 +17,8 @@ class TriggerXClient {
             timeout: 120000, // 120 second timeout
             ...config,
         });
+        // Kick off remote address fetch (non-blocking)
+        (0, config_1.initAddresses)();
     }
     // Method to get the API key
     getApiKey() {

package/dist/config.d.ts

@@ -3,7 +3,7 @@ export interface SDKConfig {
     apiKey: string;
     apiUrl: string;
 }
-export declare const CONTRACT_ADDRESSES_BY_CHAIN: Record<string, {
+export interface ChainAddresses {
     gasRegistry: string;
     jobRegistry: string;
     safeFactory?: string;
@@ -11,7 +11,19 @@ export declare const CONTRACT_ADDRESSES_BY_CHAIN: Record<string, {
     safeSingleton?: string;
     multisendCallOnly?: string;
     rpcUrl?: string;
-}>;
+}
+/**
+ * Initialize remote address loading (non-blocking).
+ * Call this early (e.g., when TriggerXClient is created) so addresses
+ * are ready by the time they're needed.
+ */
+export declare function initAddresses(): void;
+/**
+ * Await remote addresses if fetch is in-flight.
+ * Use this in async code paths before reading addresses.
+ */
+export declare function ensureAddressesLoaded(): Promise<void>;
+export declare const CONTRACT_ADDRESSES_BY_CHAIN: Record<string, ChainAddresses>;
 export declare function getConfig(): SDKConfig;
 /**
  * Get RPC provider for a given chain ID using SDK-configured RPC URLs
@@ -20,6 +32,10 @@ export declare function getConfig(): SDKConfig;
  * @returns ethers.JsonRpcProvider instance or null if chain not supported
  */
 export declare function getRpcProvider(chainId: string | number | undefined): ethers.JsonRpcProvider | null;
+/**
+ * Get contract addresses for a given chain.
+ * Priority: remote (GitHub deployments) > hardcoded fallback
+ */
 export declare function getChainAddresses(chainId: string | number | undefined): {
     gasRegistry: string;
     jobRegistry: string;

package/dist/config.js

@@ -1,31 +1,51 @@
 "use strict";
-// import dotenv from 'dotenv';
-// dotenv.config();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONTRACT_ADDRESSES_BY_CHAIN = void 0;
+exports.initAddresses = initAddresses;
+exports.ensureAddressesLoaded = ensureAddressesLoaded;
 exports.getConfig = getConfig;
 exports.getRpcProvider = getRpcProvider;
 exports.getChainAddresses = getChainAddresses;
 const ethers_1 = require("ethers");
-// Contract addresses per chain
-// Keyed by chainId as string to avoid bigint conversions throughout the SDK
-exports.CONTRACT_ADDRESSES_BY_CHAIN = {
-    // TESTNET CONFIGURATIONS
-    // OP Sepolia (11155420) - Optimism Sepolia Testnet
+const axios_1 = __importDefault(require("axios"));
+// ============================================================
+// REMOTE ADDRESS SOURCES (triggerx-contracts deployments folder)
+// ============================================================
+const DEPLOYMENT_URLS = {
+    testnet: 'https://raw.githubusercontent.com/trigg3rX/triggerx-contracts/refs/heads/dev/deployments/testnet.json',
+    mainnet: 'https://raw.githubusercontent.com/trigg3rX/triggerx-contracts/refs/heads/dev/deployments/mainnet.json',
+};
+// ============================================================
+// STATIC CONFIG (not part of contract deployments)
+// These values don't change with contract upgrades
+// ============================================================
+const STATIC_CONFIG = {
+    '11155420': { rpcUrl: 'https://sepolia.optimism.io', multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2' },
+    '11155111': { rpcUrl: 'https://rpc.sepolia.org', multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2' },
+    '421614': { rpcUrl: 'https://sepolia-rollup.arbitrum.io/rpc', multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2' },
+    '84532': { rpcUrl: 'https://sepolia.base.org', multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2' },
+    '42161': { rpcUrl: 'https://arb1.arbitrum.io/rpc', multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2' },
+};
+// ============================================================
+// HARDCODED FALLBACK ADDRESSES (used if GitHub fetch fails)
+// ============================================================
+const FALLBACK_ADDRESSES = {
     '11155420': {
         gasRegistry: '0x248E9f1B99F1AC8068254233D1F271ed0e0903D6',
         jobRegistry: '0x476ACc7949a95e31144cC84b8F6BC7abF0967E4b',
         safeFactory: '0x04359eDC46Cd6C6BD7F6359512984222BE10F8Be',
-        safeModule: '0x71BB931AfBE9a10a1030bAc1dc24fe45a2960b7a',
+        safeModule: '0xe90B66CDC6d3Da2F97cc4AA9e2ea24EA9EEd4cDB',
         multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2',
         rpcUrl: 'https://sepolia.optimism.io',
     },
-    // Ethereum Sepolia (11155111) - Ethereum Sepolia Testnet
     '11155111': {
         gasRegistry: '0x248E9f1B99F1AC8068254233D1F271ed0e0903D6',
         jobRegistry: '0x476ACc7949a95e31144cC84b8F6BC7abF0967E4b',
         safeFactory: '0xdf76E2A796a206D877086c717979054544B1D9Bc',
-        safeModule: '0x71BB931AfBE9a10a1030bAc1dc24fe45a2960b7a',
+        safeModule: '0xe90B66CDC6d3Da2F97cc4AA9e2ea24EA9EEd4cDB',
         multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2',
         rpcUrl: 'https://rpc.sepolia.org',
     },
@@ -34,17 +54,16 @@ exports.CONTRACT_ADDRESSES_BY_CHAIN = {
         gasRegistry: '0x248E9f1B99F1AC8068254233D1F271ed0e0903D6',
         jobRegistry: '0x476ACc7949a95e31144cC84b8F6BC7abF0967E4b',
         safeFactory: '0x04359eDC46Cd6C6BD7F6359512984222BE10F8Be',
-        safeModule: '0x71BB931AfBE9a10a1030bAc1dc24fe45a2960b7a',
+        safeModule: '0xe90B66CDC6d3Da2F97cc4AA9e2ea24EA9EEd4cDB',
         multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2',
         rpcUrl: 'https://sepolia-rollup.arbitrum.io/rpc',
-        // safeSingleton can be provided per deployment (Safe or SafeL2)
     },
     // Base Sepolia (84532) - Base Sepolia Testnet
     '84532': {
         gasRegistry: '0x248E9f1B99F1AC8068254233D1F271ed0e0903D6',
         jobRegistry: '0x476ACc7949a95e31144cC84b8F6BC7abF0967E4b',
         safeFactory: '0x04359eDC46Cd6C6BD7F6359512984222BE10F8Be',
-        safeModule: '0x71BB931AfBE9a10a1030bAc1dc24fe45a2960b7a',
+        safeModule: '0xe90B66CDC6d3Da2F97cc4AA9e2ea24EA9EEd4cDB',
         multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2',
         rpcUrl: 'https://sepolia.base.org',
     },
@@ -58,8 +77,145 @@ exports.CONTRACT_ADDRESSES_BY_CHAIN = {
         multisendCallOnly: '0x9641d764fc13c8B624c04430C7356C1C7C8102e2',
         rpcUrl: 'https://arb1.arbitrum.io/rpc',
     },
-    // Default/fallbacks can be extended as needed for other networks
 };
+// ============================================================
+// DEPLOYMENT JSON PARSING
+// ============================================================
+/**
+ * Extract proxy address from a deployment entry.
+ * Handles both formats: plain string or { proxy, implementation } object.
+ */
+function getProxyAddress(entry) {
+    if (!entry)
+        return '';
+    if (typeof entry === 'string')
+        return entry;
+    if (typeof entry === 'object' && entry.proxy)
+        return entry.proxy;
+    return '';
+}
+/**
+ * Parse a single chain's deployment data into ChainAddresses.
+ * Merges with static config (rpcUrl, multisendCallOnly) if available.
+ */
+function parseChainDeployment(chainId, deployment) {
+    const staticCfg = STATIC_CONFIG[chainId];
+    return {
+        gasRegistry: getProxyAddress(deployment.TriggerGasRegistry),
+        jobRegistry: getProxyAddress(deployment.JobRegistry),
+        safeFactory: getProxyAddress(deployment.TriggerXSafeFactory),
+        safeModule: getProxyAddress(deployment.TriggerXSafeModule),
+        multisendCallOnly: staticCfg?.multisendCallOnly || '',
+        rpcUrl: staticCfg?.rpcUrl || '',
+    };
+}
+/**
+ * Parse testnet.json format: { "chainId": { ...contracts } }
+ */
+function parseTestnetDeployments(data) {
+    const result = {};
+    for (const chainId of Object.keys(data)) {
+        // Skip non-chain keys
+        if (!/^\d+$/.test(chainId))
+            continue;
+        result[chainId] = parseChainDeployment(chainId, data[chainId]);
+    }
+    return result;
+}
+/**
+ * Parse mainnet.json format: { L1: { chainId, ...contracts }, L2s: [{ chainId, ...contracts }] }
+ */
+function parseMainnetDeployments(data) {
+    const result = {};
+    // Parse L1 (if it has contracts we need)
+    if (data.L1 && data.L1.chainId) {
+        const chainId = String(data.L1.chainId);
+        result[chainId] = parseChainDeployment(chainId, data.L1);
+    }
+    // Parse L2s array
+    if (Array.isArray(data.L2s)) {
+        for (const l2 of data.L2s) {
+            if (l2.chainId) {
+                const chainId = String(l2.chainId);
+                result[chainId] = parseChainDeployment(chainId, l2);
+            }
+        }
+    }
+    return result;
+}
+// ============================================================
+// REMOTE ADDRESS FETCHING
+// ============================================================
+// Cache for fetched addresses — fetched once per SDK session
+let _remoteAddresses = null;
+let _fetchPromise = null;
+let _fetchFailed = false;
+/**
+ * Fetch deployment addresses from GitHub raw content (triggerx-contracts repo).
+ * Fetches both testnet.json and mainnet.json in parallel, merges results.
+ * Called once, then cached for the SDK session lifetime.
+ */
+async function fetchRemoteAddresses() {
+    try {
+        const [testnetRes, mainnetRes] = await Promise.allSettled([
+            axios_1.default.get(DEPLOYMENT_URLS.testnet, { timeout: 5000 }),
+            axios_1.default.get(DEPLOYMENT_URLS.mainnet, { timeout: 5000 }),
+        ]);
+        const merged = {};
+        // Parse testnet
+        if (testnetRes.status === 'fulfilled' && testnetRes.value.data) {
+            const testnetAddresses = parseTestnetDeployments(testnetRes.value.data);
+            Object.assign(merged, testnetAddresses);
+        }
+        // Parse mainnet
+        if (mainnetRes.status === 'fulfilled' && mainnetRes.value.data) {
+            const mainnetAddresses = parseMainnetDeployments(mainnetRes.value.data);
+            Object.assign(merged, mainnetAddresses);
+        }
+        // Only succeed if we got at least one chain
+        if (Object.keys(merged).length > 0) {
+            return merged;
+        }
+        return null;
+    }
+    catch {
+        // Silent fail — will use hardcoded fallbacks
+        return null;
+    }
+}
+/**
+ * Initialize remote address loading (non-blocking).
+ * Call this early (e.g., when TriggerXClient is created) so addresses
+ * are ready by the time they're needed.
+ */
+function initAddresses() {
+    if (!_fetchPromise && !_remoteAddresses && !_fetchFailed) {
+        _fetchPromise = fetchRemoteAddresses().then((result) => {
+            if (result) {
+                _remoteAddresses = result;
+            }
+            else {
+                _fetchFailed = true;
+            }
+            _fetchPromise = null;
+            return result;
+        });
+    }
+}
+/**
+ * Await remote addresses if fetch is in-flight.
+ * Use this in async code paths before reading addresses.
+ */
+async function ensureAddressesLoaded() {
+    if (_fetchPromise) {
+        await _fetchPromise;
+    }
+}
+// Keep the old export name for backward compatibility
+exports.CONTRACT_ADDRESSES_BY_CHAIN = FALLBACK_ADDRESSES;
+// ============================================================
+// PUBLIC API
+// ============================================================
 function getConfig() {
     return {
         apiKey: '',
@@ -77,30 +233,45 @@ function getRpcProvider(chainId) {
     if (!rpcUrl) {
         return null;
     }
-    // Convert chainId to number for network configuration
     const chainIdNum = chainId ? Number(chainId) : undefined;
     if (!chainIdNum) {
-        // If no chainId, create provider without network (will auto-detect)
         return new ethers_1.ethers.JsonRpcProvider(rpcUrl);
     }
     // Create a Network object with the chainId to explicitly set the network
     // This prevents the provider from trying to auto-detect the network,
     // which can cause timeouts when the RPC is slow or unresponsive
     const network = ethers_1.ethers.Network.from(chainIdNum);
-    // Create provider with explicit network to skip network detection
-    // This prevents timeout issues when RPC is slow or unresponsive
     return new ethers_1.ethers.JsonRpcProvider(rpcUrl, network);
 }
+/**
+ * Get contract addresses for a given chain.
+ * Priority: remote (GitHub deployments) > hardcoded fallback
+ */
 function getChainAddresses(chainId) {
     const chainKey = String(chainId ?? '');
-    const mapped = exports.CONTRACT_ADDRESSES_BY_CHAIN[chainKey];
+    // Prefer remote addresses if available, fallback to hardcoded
+    const remote = _remoteAddresses?.[chainKey];
+    const fallback = FALLBACK_ADDRESSES[chainKey];
+    // If remote is available, merge with fallback for fields remote doesn't have (rpcUrl, multisendCallOnly)
+    if (remote) {
+        return {
+            gasRegistry: remote.gasRegistry || fallback?.gasRegistry || '',
+            jobRegistry: remote.jobRegistry || fallback?.jobRegistry || '',
+            safeFactory: remote.safeFactory || fallback?.safeFactory || '',
+            safeModule: remote.safeModule || fallback?.safeModule || '',
+            safeSingleton: remote.safeSingleton || fallback?.safeSingleton || '',
+            multisendCallOnly: remote.multisendCallOnly || fallback?.multisendCallOnly || '',
+            rpcUrl: remote.rpcUrl || fallback?.rpcUrl || '',
+        };
+    }
+    // Pure fallback
     return {
-        gasRegistry: mapped ? mapped.gasRegistry : '',
-        jobRegistry: mapped ? mapped.jobRegistry : '',
-        safeFactory: mapped ? mapped.safeFactory : '',
-        safeModule: mapped ? mapped.safeModule : '',
-        safeSingleton: mapped ? mapped.safeSingleton : '',
-        multisendCallOnly: mapped ? mapped.multisendCallOnly : '',
-        rpcUrl: mapped ? mapped.rpcUrl : '',
+        gasRegistry: fallback ? fallback.gasRegistry : '',
+        jobRegistry: fallback ? fallback.jobRegistry : '',
+        safeFactory: fallback ? fallback.safeFactory : '',
+        safeModule: fallback ? fallback.safeModule : '',
+        safeSingleton: fallback ? fallback.safeSingleton : '',
+        multisendCallOnly: fallback ? fallback.multisendCallOnly : '',
+        rpcUrl: fallback ? fallback.rpcUrl : '',
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdk-triggerx",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "SDK for interacting with the TriggerX backend and smart contracts.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",