@steerprotocol/data-connector-loader 3.1.1 → 3.2.2

package/README.md

@@ -1 +1,21 @@
-# Steer Protocol App Loader
+# Steer Protocol App Loader
+
+## Public API
+
+- `ExecutionAppConfig`: Configuration object for `ExecutionApp` (vault, chainId, subgraph URL, pool type flags, API keys, retries).
+- `ExecutionApp`: High-level execution entrypoint for running bundles with a config-based constructor.
+- `DataConnectorExecution`: Executes data connector bundles and handles request/response flow.
+
+## Installation
+
+```bash
+npm install @steerprotocol/data-connector-loader
+# or
+yarn add @steerprotocol/data-connector-loader
+# or
+pnpm add @steerprotocol/data-connector-loader
+```
+
+## ESM Support
+
+This package publishes both CommonJS and ESM entrypoints via `exports`.

package/lib/bundle/bundleBase.d.ts

@@ -1,6 +1,7 @@
-import { WasmModule } from '@steerprotocol/app-loader';
+import type { WasmModule } from '@steerprotocol/app-loader';
 import { ethers } from 'ethers';
-import { EtherRpcConfig, ExecutionContext } from '../types';
+import type { ExecutionAppConfig } from '../execution/executionApp.js';
+import type { EtherRpcConfig, ExecutionContext } from '../types.js';
 export declare class BundleBase {
     module?: WasmModule;
     protected wasmFile: ArrayBuffer | string;
@@ -13,13 +14,17 @@ export declare class BundleBase {
     executionContext?: ExecutionContext & {
         epochTimestamp: number;
     };
-    protected scheduleEpochTimestamp: number | undefined;
-    constructor(wasmFile: string | ArrayBuffer, _config: string, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
+    protected scheduleEpochTimestamp?: number;
+    executionAppConfig: ExecutionAppConfig;
+    constructor(wasmFile: string | ArrayBuffer, _config: string, executionAppConfig: ExecutionAppConfig, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
     load(): Promise<WasmModule>;
     loadSync(): WasmModule;
     execute(response: string): Promise<string>;
+    transform(): Promise<string>;
     executeBundle(data: Array<any>): Promise<string>;
-    setExecutionContextStrategyExecution(executionContext: ExecutionContext): void;
+    executeDynamicJobBundle(data: Array<any>): Promise<string>;
+    reset(): void;
+    setExecutionContextStrategyExecution(executionContext: ExecutionContext, forceDeposit?: boolean): void;
     setExecutionContextDataConnector(executionContext: ExecutionContext): void;
     protected executeModule(response: string): Promise<string>;
     getProvider(config: any): ethers.Provider | undefined;

package/lib/bundle/bundleBase.js

@@ -12,13 +12,42 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BundleBase = void 0;
 const app_loader_1 = require("@steerprotocol/app-loader");
 const ethers_1 = require("ethers");
+const UNSTABLE_RPC_PATTERNS = [/drpc\.org/i];
+function createFallbackRpcProvider(urls) {
+    const seen = new Set();
+    const preferred = [];
+    const deprioritized = [];
+    for (const url of urls) {
+        const trimmed = url.trim();
+        if (trimmed.length === 0 || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        if (UNSTABLE_RPC_PATTERNS.some((pattern) => pattern.test(trimmed))) {
+            deprioritized.push(trimmed);
+        }
+        else {
+            preferred.push(trimmed);
+        }
+    }
+    const prioritized = preferred.length > 0 ? [...preferred, ...deprioritized] : [...preferred, ...deprioritized];
+    if (prioritized.length === 0) {
+        throw new Error('No RPC URLs configured');
+    }
+    const providers = prioritized.map((url) => new ethers_1.ethers.JsonRpcProvider(url));
+    return providers.length === 1 ? providers[0] : new ethers_1.ethers.FallbackProvider(providers);
+}
+function bigIntReplacer(_key, value) {
+    return typeof value === 'bigint' ? value.toString() : value;
+}
 class BundleBase {
-    constructor(wasmFile, _config, identity, etherRpcConfig) {
+    constructor(wasmFile, _config, executionAppConfig, identity, etherRpcConfig) {
         this.wasmFile = wasmFile;
         this.config = _config;
         this.configObj = JSON.parse(_config);
         this.providerIdentity = identity;
         this.etherRpcConfig = etherRpcConfig;
+        this.executionAppConfig = executionAppConfig;
     }
     load() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -29,8 +58,9 @@ class BundleBase {
         });
     }
     loadSync() {
-        if (typeof this.wasmFile === 'string')
+        if (typeof this.wasmFile === 'string') {
             throw new Error('Cannot load module synchronously unless wasmFile is of type ArrayBuffer');
+        }
         this.module = (0, app_loader_1.loadWasmSync)(this.wasmFile, {});
         return this.module;
     }
@@ -55,6 +85,28 @@ class BundleBase {
             return yield this.module.execute(response);
         });
     }
+    // For dynamic job data connector
+    transform() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.executionContext) {
+                throw new Error('Execution context missing');
+            }
+            // If the module is not initialized, try to load it
+            if (!this.module) {
+                try {
+                    yield this.load();
+                }
+                catch (_a) {
+                    throw new Error('Module not initialized');
+                }
+            }
+            // If the module is still not initialized, throw an error
+            if (!this.module)
+                throw new Error('Module not initialized');
+            // Call the main function with the response
+            return yield this.module.transform();
+        });
+    }
     executeBundle(data) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.executionContext) {
@@ -76,7 +128,33 @@ class BundleBase {
             return this.module.execute(...data);
         });
     }
-    setExecutionContextStrategyExecution(executionContext) {
+    executeDynamicJobBundle(data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.executionContext) {
+                throw new Error('Execution context missing');
+            }
+            // If the module is not initialized, try to load it
+            if (!this.module) {
+                try {
+                    yield this.load();
+                }
+                catch (_a) {
+                    throw new Error('Module not initialized');
+                }
+            }
+            // If the module is still not initialized, throw an error
+            if (!this.module)
+                throw new Error('Module not initialized');
+            // Call the main function with the response
+            return this.module.execute(...data);
+        });
+    }
+    reset() {
+        if (this.module && this.module['reset']) {
+            this.module.reset();
+        }
+    }
+    setExecutionContextStrategyExecution(executionContext, forceDeposit) {
         var _a;
         // Determine the timestamp for epoch
         const timestamp = this.subtractDate(executionContext.executionTimestamp, Number(executionContext.epochLength)).getTime();
@@ -85,8 +163,10 @@ class BundleBase {
         this.executionContext = Object.assign(Object.assign({}, executionContext), { epochTimestamp: timestampInSecs });
         const completeConfig = Object.assign(Object.assign({}, JSON.parse(this.config)), this.executionContext);
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
-        console.log('Complete execution config : ', completeConfig);
-        (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig));
+        if (completeConfig.triggerStyle && forceDeposit === true) {
+            completeConfig.triggerStyle = 'None';
+        }
+        (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     setExecutionContextDataConnector(executionContext) {
         var _a;
@@ -97,8 +177,7 @@ class BundleBase {
         this.executionContext = Object.assign(Object.assign({}, executionContext), { epochTimestamp: timestampInSecs });
         const completeConfig = Object.assign(Object.assign({}, JSON.parse(this.config)), { executionContext: this.executionContext });
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
-        console.log('Complete execution config : ', completeConfig);
-        (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig));
+        (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     executeModule(response) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -112,8 +191,8 @@ class BundleBase {
     // The chainId is first checked in the data connector config, and if not found
     // it is checked in the request config. If the chainId is found in either of
     // these places, the provider is returned from the etherRpcConfig object
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getProvider(config) {
+        var _a;
         let chainId;
         // check if chainId is configured in data connector config
         if (this.configObj.chainId) {
@@ -124,8 +203,8 @@ class BundleBase {
             chainId = config.chainId;
         }
         if (chainId && this.etherRpcConfig && this.etherRpcConfig[chainId]) {
-            const provider = new ethers_1.ethers.JsonRpcProvider(this.etherRpcConfig[chainId].url);
-            return provider;
+            const rpcConfig = this.etherRpcConfig[chainId];
+            return createFallbackRpcProvider((_a = rpcConfig.urls) !== null && _a !== void 0 ? _a : [rpcConfig.url]);
         }
         else {
             return this.providerIdentity;

package/lib/bundle/bundleDataConnector.d.ts

@@ -1,8 +1,9 @@
-import { ethers } from 'ethers';
-import { EtherRpcConfig, ViewConfig } from '../types';
-import { BundleBase } from './bundleBase';
+import type { ethers } from 'ethers';
+import type { ExecutionAppConfig } from '../execution/executionApp.js';
+import type { EtherRpcConfig, ViewConfig } from '../types.js';
+import { BundleBase } from './bundleBase.js';
 export declare class DataConnector extends BundleBase {
-    constructor(wasmFile: string | ArrayBuffer, _config: string, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
+    constructor(wasmFile: string | ArrayBuffer, _config: string, executionAppConfig: ExecutionAppConfig, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
     getRpcUrl(config: any): string | undefined;
     view(config: ViewConfig): Promise<string>;
 }

package/lib/bundle/bundleDataConnector.js

@@ -11,13 +11,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataConnector = void 0;
 const ethers_1 = require("ethers");
-const consts_1 = require("../utils/consts");
-const utils_1 = require("../utils/utils");
-const bundleBase_1 = require("./bundleBase");
-class DataConnector extends bundleBase_1.BundleBase {
+const consts_js_1 = require("../utils/consts.js");
+const utils_js_1 = require("../utils/utils.js");
+const bundleBase_js_1 = require("./bundleBase.js");
+class DataConnector extends bundleBase_js_1.BundleBase {
     // Identity should come from the node's IdentityManager.wallet
-    constructor(wasmFile, _config, identity, etherRpcConfig) {
-        super(wasmFile, _config, identity, etherRpcConfig);
+    constructor(wasmFile, _config, executionAppConfig, identity, etherRpcConfig) {
+        super(wasmFile, _config, executionAppConfig, identity, etherRpcConfig);
     }
     // get rpc url from configuration
     getRpcUrl(config) {
@@ -38,7 +38,6 @@ class DataConnector extends bundleBase_1.BundleBase {
         }
     }
     // Makes contract instance and calls, returns stringified result
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     view(config) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
@@ -46,13 +45,12 @@ class DataConnector extends bundleBase_1.BundleBase {
             if (!provider)
                 throw new Error('Provider not initialized');
             const contract = new ethers_1.Contract(config.address, config.abi, provider);
-            // For formatting the parameters if needed
             const paramsArray = config.arguments;
             let result;
-            if (consts_1.CENTRALIZE_CONTRACT_INTERACTION_CHAINS.indexOf(this.configObj.chainId.toString()) === -1) {
+            if (consts_js_1.CENTRALIZE_CONTRACT_INTERACTION_CHAINS.indexOf(this.configObj.chainId.toString()) === -1) {
                 result = yield contract[config.method](...paramsArray, {
                     blockTag: (_a = this.executionContext) === null || _a === void 0 ? void 0 : _a.blockNumber,
-                }); //@note uncomment for deterministic blocks
+                });
             }
             else {
                 const viewContractConfig = {
@@ -63,7 +61,7 @@ class DataConnector extends bundleBase_1.BundleBase {
                     method: config.method,
                     rpcUrl: this.getRpcUrl(config),
                 };
-                result = yield (0, utils_1.callWithRetry)(viewContractConfig);
+                result = yield (0, utils_js_1.callWithRetry)(viewContractConfig);
             }
             // This gets stringified before calling main
             return result;

package/lib/esm/bundle/bundleBase.d.ts

@@ -1,6 +1,7 @@
-import { WasmModule } from '@steerprotocol/app-loader';
+import type { WasmModule } from '@steerprotocol/app-loader';
 import { ethers } from 'ethers';
-import { EtherRpcConfig, ExecutionContext } from '../types';
+import type { ExecutionAppConfig } from '../execution/executionApp.js';
+import type { EtherRpcConfig, ExecutionContext } from '../types.js';
 export declare class BundleBase {
     module?: WasmModule;
     protected wasmFile: ArrayBuffer | string;
@@ -13,13 +14,17 @@ export declare class BundleBase {
     executionContext?: ExecutionContext & {
         epochTimestamp: number;
     };
-    protected scheduleEpochTimestamp: number | undefined;
-    constructor(wasmFile: string | ArrayBuffer, _config: string, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
+    protected scheduleEpochTimestamp?: number;
+    executionAppConfig: ExecutionAppConfig;
+    constructor(wasmFile: string | ArrayBuffer, _config: string, executionAppConfig: ExecutionAppConfig, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
     load(): Promise<WasmModule>;
     loadSync(): WasmModule;
     execute(response: string): Promise<string>;
+    transform(): Promise<string>;
     executeBundle(data: Array<any>): Promise<string>;
-    setExecutionContextStrategyExecution(executionContext: ExecutionContext): void;
+    executeDynamicJobBundle(data: Array<any>): Promise<string>;
+    reset(): void;
+    setExecutionContextStrategyExecution(executionContext: ExecutionContext, forceDeposit?: boolean): void;
     setExecutionContextDataConnector(executionContext: ExecutionContext): void;
     protected executeModule(response: string): Promise<string>;
     getProvider(config: any): ethers.Provider | undefined;

package/lib/esm/bundle/bundleBase.js

@@ -1,12 +1,41 @@
 import { loadWasm, loadWasmSync } from '@steerprotocol/app-loader';
 import { ethers } from 'ethers';
+const UNSTABLE_RPC_PATTERNS = [/drpc\.org/i];
+function createFallbackRpcProvider(urls) {
+    const seen = new Set();
+    const preferred = [];
+    const deprioritized = [];
+    for (const url of urls) {
+        const trimmed = url.trim();
+        if (trimmed.length === 0 || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        if (UNSTABLE_RPC_PATTERNS.some((pattern) => pattern.test(trimmed))) {
+            deprioritized.push(trimmed);
+        }
+        else {
+            preferred.push(trimmed);
+        }
+    }
+    const prioritized = preferred.length > 0 ? [...preferred, ...deprioritized] : [...preferred, ...deprioritized];
+    if (prioritized.length === 0) {
+        throw new Error('No RPC URLs configured');
+    }
+    const providers = prioritized.map((url) => new ethers.JsonRpcProvider(url));
+    return providers.length === 1 ? providers[0] : new ethers.FallbackProvider(providers);
+}
+function bigIntReplacer(_key, value) {
+    return typeof value === 'bigint' ? value.toString() : value;
+}
 export class BundleBase {
-    constructor(wasmFile, _config, identity, etherRpcConfig) {
+    constructor(wasmFile, _config, executionAppConfig, identity, etherRpcConfig) {
         this.wasmFile = wasmFile;
         this.config = _config;
         this.configObj = JSON.parse(_config);
         this.providerIdentity = identity;
         this.etherRpcConfig = etherRpcConfig;
+        this.executionAppConfig = executionAppConfig;
     }
     async load() {
         const instance = await loadWasm(this.wasmFile, {});
@@ -15,8 +44,9 @@ export class BundleBase {
         return this.module;
     }
     loadSync() {
-        if (typeof this.wasmFile === 'string')
+        if (typeof this.wasmFile === 'string') {
             throw new Error('Cannot load module synchronously unless wasmFile is of type ArrayBuffer');
+        }
         this.module = loadWasmSync(this.wasmFile, {});
         return this.module;
     }
@@ -39,6 +69,26 @@ export class BundleBase {
         // Call the main function with the response
         return await this.module.execute(response);
     }
+    // For dynamic job data connector
+    async transform() {
+        if (!this.executionContext) {
+            throw new Error('Execution context missing');
+        }
+        // If the module is not initialized, try to load it
+        if (!this.module) {
+            try {
+                await this.load();
+            }
+            catch {
+                throw new Error('Module not initialized');
+            }
+        }
+        // If the module is still not initialized, throw an error
+        if (!this.module)
+            throw new Error('Module not initialized');
+        // Call the main function with the response
+        return await this.module.transform();
+    }
     async executeBundle(data) {
         if (!this.executionContext) {
             throw new Error('Execution context missing');
@@ -58,7 +108,31 @@ export class BundleBase {
         // Call the main function with the response
         return this.module.execute(...data);
     }
-    setExecutionContextStrategyExecution(executionContext) {
+    async executeDynamicJobBundle(data) {
+        if (!this.executionContext) {
+            throw new Error('Execution context missing');
+        }
+        // If the module is not initialized, try to load it
+        if (!this.module) {
+            try {
+                await this.load();
+            }
+            catch {
+                throw new Error('Module not initialized');
+            }
+        }
+        // If the module is still not initialized, throw an error
+        if (!this.module)
+            throw new Error('Module not initialized');
+        // Call the main function with the response
+        return this.module.execute(...data);
+    }
+    reset() {
+        if (this.module && this.module['reset']) {
+            this.module.reset();
+        }
+    }
+    setExecutionContextStrategyExecution(executionContext, forceDeposit) {
         // Determine the timestamp for epoch
         const timestamp = this.subtractDate(executionContext.executionTimestamp, Number(executionContext.epochLength)).getTime();
         // Divide milliseconds data to seconds for transformation bundle
@@ -66,8 +140,10 @@ export class BundleBase {
         this.executionContext = { ...executionContext, epochTimestamp: timestampInSecs };
         const completeConfig = { ...JSON.parse(this.config), ...this.executionContext };
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
-        console.log('Complete execution config : ', completeConfig);
-        this.module?.initialize(JSON.stringify(completeConfig));
+        if (completeConfig.triggerStyle && forceDeposit === true) {
+            completeConfig.triggerStyle = 'None';
+        }
+        this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     setExecutionContextDataConnector(executionContext) {
         // Determine the timestamp for epoch
@@ -77,8 +153,7 @@ export class BundleBase {
         this.executionContext = { ...executionContext, epochTimestamp: timestampInSecs };
         const completeConfig = { ...JSON.parse(this.config), executionContext: this.executionContext };
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
-        console.log('Complete execution config : ', completeConfig);
-        this.module?.initialize(JSON.stringify(completeConfig));
+        this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     async executeModule(response) {
         if (!this.module) {
@@ -90,7 +165,6 @@ export class BundleBase {
     // The chainId is first checked in the data connector config, and if not found
     // it is checked in the request config. If the chainId is found in either of
     // these places, the provider is returned from the etherRpcConfig object
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getProvider(config) {
         let chainId;
         // check if chainId is configured in data connector config
@@ -102,8 +176,8 @@ export class BundleBase {
             chainId = config.chainId;
         }
         if (chainId && this.etherRpcConfig && this.etherRpcConfig[chainId]) {
-            const provider = new ethers.JsonRpcProvider(this.etherRpcConfig[chainId].url);
-            return provider;
+            const rpcConfig = this.etherRpcConfig[chainId];
+            return createFallbackRpcProvider(rpcConfig.urls ?? [rpcConfig.url]);
         }
         else {
             return this.providerIdentity;

package/lib/esm/bundle/bundleDataConnector.d.ts

@@ -1,8 +1,9 @@
-import { ethers } from 'ethers';
-import { EtherRpcConfig, ViewConfig } from '../types';
-import { BundleBase } from './bundleBase';
+import type { ethers } from 'ethers';
+import type { ExecutionAppConfig } from '../execution/executionApp.js';
+import type { EtherRpcConfig, ViewConfig } from '../types.js';
+import { BundleBase } from './bundleBase.js';
 export declare class DataConnector extends BundleBase {
-    constructor(wasmFile: string | ArrayBuffer, _config: string, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
+    constructor(wasmFile: string | ArrayBuffer, _config: string, executionAppConfig: ExecutionAppConfig, identity?: ethers.Provider, etherRpcConfig?: EtherRpcConfig);
     getRpcUrl(config: any): string | undefined;
     view(config: ViewConfig): Promise<string>;
 }

package/lib/esm/bundle/bundleDataConnector.js

@@ -1,11 +1,11 @@
 import { Contract } from 'ethers';
-import { CENTRALIZE_CONTRACT_INTERACTION_CHAINS } from '../utils/consts';
-import { callWithRetry } from '../utils/utils';
-import { BundleBase } from './bundleBase';
+import { CENTRALIZE_CONTRACT_INTERACTION_CHAINS } from '../utils/consts.js';
+import { callWithRetry } from '../utils/utils.js';
+import { BundleBase } from './bundleBase.js';
 export class DataConnector extends BundleBase {
     // Identity should come from the node's IdentityManager.wallet
-    constructor(wasmFile, _config, identity, etherRpcConfig) {
-        super(wasmFile, _config, identity, etherRpcConfig);
+    constructor(wasmFile, _config, executionAppConfig, identity, etherRpcConfig) {
+        super(wasmFile, _config, executionAppConfig, identity, etherRpcConfig);
     }
     // get rpc url from configuration
     getRpcUrl(config) {
@@ -26,19 +26,17 @@ export class DataConnector extends BundleBase {
         }
     }
     // Makes contract instance and calls, returns stringified result
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async view(config) {
         const provider = this.getProvider(config);
         if (!provider)
             throw new Error('Provider not initialized');
         const contract = new Contract(config.address, config.abi, provider);
-        // For formatting the parameters if needed
         const paramsArray = config.arguments;
         let result;
         if (CENTRALIZE_CONTRACT_INTERACTION_CHAINS.indexOf(this.configObj.chainId.toString()) === -1) {
             result = await contract[config.method](...paramsArray, {
                 blockTag: this.executionContext?.blockNumber,
-            }); //@note uncomment for deterministic blocks
+            });
         }
         else {
             const viewContractConfig = {

package/lib/esm/execution/executionApp.d.ts

@@ -1,17 +1,62 @@
-import { ethers } from 'ethers';
-import { EtherRpcConfig } from '../types';
-import { ExecutionBase } from './executionBase';
-export declare class ExecutionApp extends ExecutionBase {
+import type { ethers } from 'ethers';
+import type { EtherRpcConfig, JobDetails } from '../types.js';
+import { ExecutionBase } from './executionBase.js';
+export interface ExecutionAppConfig {
+    /** Vault address used for execution context and subgraph queries. */
+    vault: string;
+    /** Chain ID used to resolve RPC configuration and on-chain reads. */
+    chainId: number;
+    /** Subgraph endpoint used for protocol data queries. */
     steerSubgraph: string;
+    poolType: {
+        /** Set true when the pool uses Algebra v1 semantics. */
+        isAlgebraPool: boolean;
+        /** Set true when the pool uses Algebra Integral semantics. */
+        isAlgebraIntegralPool: boolean;
+        /** Set true when the pool uses directional pool semantics. */
+        isDirectionalPool: boolean;
+        /** Set true when the pool uses PoolShark semantics. */
+        isPoolSharkPool: boolean;
+        /** Set true when the pool uses Aerodrome semantics. */
+        isAerodromePool: boolean;
+    };
+    apiKeys: {
+        /** API key for The Graph Studio / gateway endpoints. */
+        subgraphStudioKey: string;
+        /** API key for Sentio endpoints, if applicable. */
+        sentioApiKey: string;
+    };
+    /** Maximum number of retries for execution operations. */
+    maxRetries?: number;
+}
+export declare class ExecutionApp extends ExecutionBase {
     vault: string;
+    steerSubgraph: string;
+    chainId: number;
     isAlgebraPool: boolean;
+    isAlgebraIntegralPool: boolean;
     isDirectionalPool: boolean;
-    chainId: number;
-    constructor(vault: string, steerSubgraph: string, isAlgebraPool: boolean, isDirectionalPool: boolean, chainId: number, maxRetries?: number);
-    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig): Promise<Array<T>>;
+    isPoolSharkPool: boolean;
+    isAerodromePool: boolean;
+    subgraphStudioKey: string;
+    sentioApiKey: string;
+    config: ExecutionAppConfig;
+    constructor(config: ExecutionAppConfig);
+    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig, forceDeposit?: boolean): Promise<Array<T>>;
+    executeStabilityVault<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig, forceDeposit?: boolean): Promise<Array<T>>;
+    executeDynamicJobs<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _job: JobDetails, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig, forceDeposit?: boolean): Promise<Array<T>>;
     private getSmartPoolExecutionContext;
     private getPoolCurrentTick;
+    private getTickSpacing;
+    /**
+     * Converts a value to string, handling both native bigint and serialized bigint objects
+     * from the centralized API
+     */
+    private convertToString;
+    private getTotalAmounts;
     private getVaultPoolAddress;
     private getSlot0;
+    private getSlot0Aerodrome;
+    private getGlobalStateAbi;
     private getGlobalState;
 }