@steerprotocol/data-connector-loader 3.1.1 → 3.2.1

package/README.md

@@ -1 +1,30 @@
-# 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 test-data-connector-loader
+# or
+yarn add test-data-connector-loader
+# or
+pnpm add test-data-connector-loader
+```
+
+The package includes an automatic postinstall script that fixes ESM/CJS interoperability issues with dependencies. No additional configuration is needed.
+
+## ESM Support
+
+This package is an ESM module (`"type": "module"`). It automatically fixes ESM compatibility issues in its dependencies during installation.
+
+If you encounter import errors after installation, you can manually run the fix script:
+
+```bash
+npm run postinstall
+```
+
+For more details about the ESM fixes, see [docs/esm-fixes.md](docs/esm-fixes.md).

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

@@ -11,14 +11,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BundleBase = void 0;
 const app_loader_1 = require("@steerprotocol/app-loader");
-const ethers_1 = require("ethers");
+const providerUtils_js_1 = require("../utils/providerUtils.js");
+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 +33,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 +60,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 +103,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 +138,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 +152,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 +166,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 +178,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 (0, providerUtils_js_1.createFallbackRpcProvider)((_a = rpcConfig.urls) !== null && _a !== void 0 ? _a : [rpcConfig.url]);
         }
         else {
             return this.providerIdentity;

package/lib/bundle/bundleDataConnector.d.ts

@@ -1,8 +1,15 @@
-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>;
+    /**
+     * Attempts to decode raw return data when the declared ABI doesn't match the actual
+     * contract output. Tries removing trailing outputs one-by-one until decoding succeeds.
+     * This handles pool variants that omit optional fields (e.g. feeProtocol in slot0).
+     */
+    private decodeFallback;
 }

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,25 @@ 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) {
-                result = yield contract[config.method](...paramsArray, {
-                    blockTag: (_a = this.executionContext) === null || _a === void 0 ? void 0 : _a.blockNumber,
-                }); //@note uncomment for deterministic blocks
+            if (consts_js_1.CENTRALIZE_CONTRACT_INTERACTION_CHAINS.indexOf(this.configObj.chainId.toString()) === -1) {
+                try {
+                    result = yield contract[config.method](...paramsArray, {
+                        blockTag: (_a = this.executionContext) === null || _a === void 0 ? void 0 : _a.blockNumber,
+                    });
+                }
+                catch (err) {
+                    // Some pool variants return fewer ABI outputs than the standard spec (e.g. Aerodrome/
+                    // Velodrome slot0 has 6 fields instead of 7 — no feeProtocol). When ethers fails to
+                    // decode the raw return data, fall back to decoding with progressively fewer outputs.
+                    if ((err === null || err === void 0 ? void 0 : err.code) === 'BAD_DATA' && (err === null || err === void 0 ? void 0 : err.value)) {
+                        result = this.decodeFallback(err.value, config);
+                    }
+                    else {
+                        throw err;
+                    }
+                }
             }
             else {
                 const viewContractConfig = {
@@ -63,11 +74,36 @@ 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;
         });
     }
+    /**
+     * Attempts to decode raw return data when the declared ABI doesn't match the actual
+     * contract output. Tries removing trailing outputs one-by-one until decoding succeeds.
+     * This handles pool variants that omit optional fields (e.g. feeProtocol in slot0).
+     */
+    decodeFallback(rawData, config) {
+        var _a;
+        const iface = new ethers_1.Interface(config.abi);
+        const fragment = iface.getFunction(config.method);
+        if (!((_a = fragment === null || fragment === void 0 ? void 0 : fragment.outputs) === null || _a === void 0 ? void 0 : _a.length)) {
+            throw new Error(`Cannot find outputs for method "${config.method}" in ABI`);
+        }
+        const coder = ethers_1.AbiCoder.defaultAbiCoder();
+        for (let numOutputs = fragment.outputs.length - 1; numOutputs >= 1; numOutputs--) {
+            try {
+                const types = fragment.outputs.slice(0, numOutputs).map((o) => o.format());
+                const decoded = coder.decode(types, rawData);
+                return decoded;
+            }
+            catch (_b) {
+                // try with one fewer output
+            }
+        }
+        throw new Error(`Could not decode result data for method "${config.method}" — no matching ABI shape found`);
+    }
 }
 exports.DataConnector = DataConnector;

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,16 @@
 import { loadWasm, loadWasmSync } from '@steerprotocol/app-loader';
-import { ethers } from 'ethers';
+import { createFallbackRpcProvider } from '../utils/providerUtils.js';
+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 +19,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 +44,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 +83,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 +115,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 +128,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 +140,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 +151,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,15 @@
-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>;
+    /**
+     * Attempts to decode raw return data when the declared ABI doesn't match the actual
+     * contract output. Tries removing trailing outputs one-by-one until decoding succeeds.
+     * This handles pool variants that omit optional fields (e.g. feeProtocol in slot0).
+     */
+    private decodeFallback;
 }

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 { AbiCoder, Contract, Interface } from 'ethers';
+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,30 @@ 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
+            try {
+                result = await contract[config.method](...paramsArray, {
+                    blockTag: this.executionContext?.blockNumber,
+                });
+            }
+            catch (err) {
+                // Some pool variants return fewer ABI outputs than the standard spec (e.g. Aerodrome/
+                // Velodrome slot0 has 6 fields instead of 7 — no feeProtocol). When ethers fails to
+                // decode the raw return data, fall back to decoding with progressively fewer outputs.
+                if (err?.code === 'BAD_DATA' && err?.value) {
+                    result = this.decodeFallback(err.value, config);
+                }
+                else {
+                    throw err;
+                }
+            }
         }
         else {
             const viewContractConfig = {
@@ -54,4 +65,28 @@ export class DataConnector extends BundleBase {
         // This gets stringified before calling main
         return result;
     }
+    /**
+     * Attempts to decode raw return data when the declared ABI doesn't match the actual
+     * contract output. Tries removing trailing outputs one-by-one until decoding succeeds.
+     * This handles pool variants that omit optional fields (e.g. feeProtocol in slot0).
+     */
+    decodeFallback(rawData, config) {
+        const iface = new Interface(config.abi);
+        const fragment = iface.getFunction(config.method);
+        if (!fragment?.outputs?.length) {
+            throw new Error(`Cannot find outputs for method "${config.method}" in ABI`);
+        }
+        const coder = AbiCoder.defaultAbiCoder();
+        for (let numOutputs = fragment.outputs.length - 1; numOutputs >= 1; numOutputs--) {
+            try {
+                const types = fragment.outputs.slice(0, numOutputs).map((o) => o.format());
+                const decoded = coder.decode(types, rawData);
+                return decoded;
+            }
+            catch {
+                // try with one fewer output
+            }
+        }
+        throw new Error(`Could not decode result data for method "${config.method}" — no matching ABI shape found`);
+    }
 }

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;
 }