@steerprotocol/data-connector-loader 4.0.3 → 5.0.0-next.1

package/README.md

@@ -2,7 +2,7 @@
 
 ## Public API
 
-- `ExecutionAppConfig`: Configuration object for `ExecutionApp` (vault, chainId, subgraph URL, pool type flags, API keys, retries).
+- `ExecutionAppConfig`: Configuration object for `ExecutionApp`. The legacy `poolType` flags are retained for compatibility only.
 - `ExecutionApp`: High-level execution entrypoint for running bundles with a config-based constructor.
 - `DataConnectorExecution`: Executes data connector bundles and handles request/response flow.
 
@@ -21,3 +21,52 @@ pnpm add @steerprotocol/data-connector-loader
 ## ESM Support
 
 This package publishes both CommonJS and ESM entrypoints via `exports`.
+
+## Prereleases
+
+The `next` branch publishes prereleases under the npm `next` tag after CI passes.
+The release workflow can also be run manually on `next` with `dry_run` enabled.
+Versions are calculated from Git tags and conventional commits; a breaking
+change must be marked as such for the first prerelease of a new major version.
+The npm package must authorize `next-publish.yml` as a trusted publisher before
+that workflow can publish.
+
+## Block-pinned strategy execution (recommended)
+
+Supply a resolved `SmartPoolExecutionContext` to `ExecutionApp.executeWithContext`.
+For connectors, pass an `ExecutionContext` to `DataConnectorExecution.executeWithContext`.
+`SmartPoolExecutionContext` extends `ExecutionContext`, so the same resolved
+context can be used for both. Both contexts include the chain ID for comparison
+against the execution configuration. This path does not resolve vault or pool
+state or infer the block or execution time.
+
+```ts
+import { DataConnectorExecution, ExecutionApp } from '@steerprotocol/data-connector-loader';
+
+// context is a previously resolved SmartPoolExecutionContext.
+const vaultConfig = JSON.stringify({
+  vaultAddress: context.vaultAddress,
+  anchorBlockNumber: context.blockNumber,
+  strategyConfigData: { epochLength: String(context.epochLength) },
+});
+const connectorOutputs = await new DataConnectorExecution(connectors).executeWithContext(vaultConfig, context);
+const actions = await new ExecutionApp(executionAppConfig).executeWithContext({
+  wasmFile: strategyWasmBytes,
+  vaultConfig,
+  data: connectorOutputs,
+  executionContext: context,
+});
+```
+
+Contexts must have matching vault, chain, block and epoch length values. Block
+and timestamp fields are safe integer numbers, with `executionTimestamp` in
+milliseconds and `epochTimestamp` in seconds. Positions use `startTick`,
+`endTick`, and `weight`; totals remain decimal strings. The former stable SDK
+`VaultExecutionContext` shape is not accepted by these entry points.
+Callers migrating from that shape must supply the resolved chain ID and use
+`SmartPoolExecutionContext` for strategies or `ExecutionContext` for connectors.
+Errors are `ExecutionContextError`
+(`INVALID_EXECUTION_CONTEXT` or `EXECUTION_CONTEXT_MISMATCH`) and
+`StrategyExecutionError` (`STRATEGY_EXECUTION_ERROR`); neither is retryable
+until its input or strategy failure is corrected. External connector HTTP data
+remains external and unpinned.

package/lib/bundle/bundleBase.d.ts

@@ -1,7 +1,7 @@
 import type { WasmModule } from '@steerprotocol/app-loader';
 import { ethers } from 'ethers';
 import type { ExecutionAppConfig } from '../execution/executionApp.js';
-import type { EtherRpcConfig, ExecutionContext } from '../types.js';
+import type { EtherRpcConfig, ExecutionContext, LegacyExecutionContext } from '../types.js';
 export declare class BundleBase {
     module?: WasmModule;
     protected wasmFile: ArrayBuffer | string;
@@ -11,7 +11,7 @@ export declare class BundleBase {
     };
     protected etherRpcConfig?: EtherRpcConfig;
     protected providerIdentity?: ethers.Provider;
-    executionContext?: ExecutionContext & {
+    executionContext?: LegacyExecutionContext & {
         epochTimestamp: number;
     };
     protected scheduleEpochTimestamp?: number;
@@ -24,8 +24,15 @@ export declare class BundleBase {
     executeBundle(data: Array<any>): Promise<string>;
     executeDynamicJobBundle(data: Array<any>): Promise<string>;
     reset(): void;
-    setExecutionContextStrategyExecution(executionContext: ExecutionContext, forceDeposit?: boolean): void;
-    setExecutionContextDataConnector(executionContext: ExecutionContext): void;
+    setExecutionContextStrategyExecution(executionContext: LegacyExecutionContext, forceDeposit?: boolean): void;
+    /**
+     * Initializes a strategy from an already resolved SDK context. Unlike the
+     * legacy setter this deliberately does not derive a timestamp or block.
+     */
+    initializeStrategyWithContext(executionContext: ExecutionContext, forceDeposit?: boolean): void;
+    setExecutionContextDataConnector(executionContext: LegacyExecutionContext): void;
+    /** Initializes a data connector with an immutable SDK anchor. */
+    initializeDataConnectorWithContext(executionContext: ExecutionContext): void;
     protected executeModule(response: string): Promise<string | null>;
     protected executeModuleWithResult(...params: Array<number | string | ArrayBuffer | null>): Promise<string | null>;
     getProvider(config: any): ethers.Provider | undefined;

package/lib/bundle/bundleBase.js

@@ -173,6 +173,20 @@ class BundleBase {
         }
         (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
+    /**
+     * Initializes a strategy from an already resolved SDK context. Unlike the
+     * legacy setter this deliberately does not derive a timestamp or block.
+     */
+    initializeStrategyWithContext(executionContext, forceDeposit) {
+        var _a;
+        this.executionContext = executionContext;
+        this.scheduleEpochTimestamp = executionContext.epochTimestamp;
+        const completeConfig = Object.assign(Object.assign({}, JSON.parse(this.config)), executionContext);
+        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;
         // Determine the timestamp for epoch
@@ -184,6 +198,14 @@ class BundleBase {
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
         (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
+    /** Initializes a data connector with an immutable SDK anchor. */
+    initializeDataConnectorWithContext(executionContext) {
+        var _a;
+        this.executionContext = executionContext;
+        this.scheduleEpochTimestamp = executionContext.epochTimestamp;
+        const completeConfig = Object.assign(Object.assign({}, JSON.parse(this.config)), { executionContext });
+        (_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* () {
             if (!this.module) {

package/lib/bundle/bundleDataConnector.js

@@ -39,7 +39,7 @@ class DataConnector extends bundleBase_js_1.BundleBase {
     }
     // Makes contract instance and calls, returns stringified result
     view(config) {
-        var _a;
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const provider = this.getProvider(config);
             if (!provider)
@@ -55,6 +55,7 @@ class DataConnector extends bundleBase_js_1.BundleBase {
             else {
                 const viewContractConfig = {
                     epochTimestamp: this.scheduleEpochTimestamp,
+                    blockNumber: (_b = this.executionContext) === null || _b === void 0 ? void 0 : _b.blockNumber,
                     address: this.configObj.address || config.address,
                     abi: config.abi,
                     arguments: paramsArray,

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

@@ -1,7 +1,7 @@
 import type { WasmModule } from '@steerprotocol/app-loader';
 import { ethers } from 'ethers';
 import type { ExecutionAppConfig } from '../execution/executionApp.js';
-import type { EtherRpcConfig, ExecutionContext } from '../types.js';
+import type { EtherRpcConfig, ExecutionContext, LegacyExecutionContext } from '../types.js';
 export declare class BundleBase {
     module?: WasmModule;
     protected wasmFile: ArrayBuffer | string;
@@ -11,7 +11,7 @@ export declare class BundleBase {
     };
     protected etherRpcConfig?: EtherRpcConfig;
     protected providerIdentity?: ethers.Provider;
-    executionContext?: ExecutionContext & {
+    executionContext?: LegacyExecutionContext & {
         epochTimestamp: number;
     };
     protected scheduleEpochTimestamp?: number;
@@ -24,8 +24,15 @@ export declare class BundleBase {
     executeBundle(data: Array<any>): Promise<string>;
     executeDynamicJobBundle(data: Array<any>): Promise<string>;
     reset(): void;
-    setExecutionContextStrategyExecution(executionContext: ExecutionContext, forceDeposit?: boolean): void;
-    setExecutionContextDataConnector(executionContext: ExecutionContext): void;
+    setExecutionContextStrategyExecution(executionContext: LegacyExecutionContext, forceDeposit?: boolean): void;
+    /**
+     * Initializes a strategy from an already resolved SDK context. Unlike the
+     * legacy setter this deliberately does not derive a timestamp or block.
+     */
+    initializeStrategyWithContext(executionContext: ExecutionContext, forceDeposit?: boolean): void;
+    setExecutionContextDataConnector(executionContext: LegacyExecutionContext): void;
+    /** Initializes a data connector with an immutable SDK anchor. */
+    initializeDataConnectorWithContext(executionContext: ExecutionContext): void;
     protected executeModule(response: string): Promise<string | null>;
     protected executeModuleWithResult(...params: Array<number | string | ArrayBuffer | null>): Promise<string | null>;
     getProvider(config: any): ethers.Provider | undefined;

package/lib/esm/bundle/bundleBase.js

@@ -150,6 +150,19 @@ export class BundleBase {
         }
         this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
+    /**
+     * Initializes a strategy from an already resolved SDK context. Unlike the
+     * legacy setter this deliberately does not derive a timestamp or block.
+     */
+    initializeStrategyWithContext(executionContext, forceDeposit) {
+        this.executionContext = executionContext;
+        this.scheduleEpochTimestamp = executionContext.epochTimestamp;
+        const completeConfig = { ...JSON.parse(this.config), ...executionContext };
+        if (completeConfig.triggerStyle && forceDeposit === true) {
+            completeConfig.triggerStyle = 'None';
+        }
+        this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
+    }
     setExecutionContextDataConnector(executionContext) {
         // Determine the timestamp for epoch
         const timestamp = this.subtractDate(executionContext.executionTimestamp, Number(executionContext.epochLength)).getTime();
@@ -160,6 +173,13 @@ export class BundleBase {
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
         this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
+    /** Initializes a data connector with an immutable SDK anchor. */
+    initializeDataConnectorWithContext(executionContext) {
+        this.executionContext = executionContext;
+        this.scheduleEpochTimestamp = executionContext.epochTimestamp;
+        const completeConfig = { ...JSON.parse(this.config), executionContext };
+        this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
+    }
     async executeModule(response) {
         if (!this.module) {
             throw new Error('Module not initialized');

package/lib/esm/bundle/bundleDataConnector.js

@@ -41,6 +41,7 @@ export class DataConnector extends BundleBase {
         else {
             const viewContractConfig = {
                 epochTimestamp: this.scheduleEpochTimestamp,
+                blockNumber: this.executionContext?.blockNumber,
                 address: this.configObj.address || config.address,
                 abi: config.abi,
                 arguments: paramsArray,

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

@@ -1,5 +1,5 @@
 import type { ethers } from 'ethers';
-import type { EtherRpcConfig, JobDetails } from '../types.js';
+import type { EtherRpcConfig, ExecuteWithContextOptions, JobDetails } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export interface ExecutionAppConfig {
     /** Vault address used for execution context and subgraph queries. */
@@ -43,6 +43,15 @@ export declare class ExecutionApp extends ExecutionBase {
     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>>;
+    /**
+     * Executes a strategy against a supplied execution context.
+     * This is the recommended API for new consumers. It intentionally bypasses
+     * all legacy vault, pool, subgraph, clock, and block-estimation reads.
+     */
+    executeWithContext<T>(options: ExecuteWithContextOptions): Promise<Array<T>>;
+    private parseVaultConfig;
+    private validateExecutionContext;
+    private redactError;
     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;

package/lib/esm/execution/executionApp.js

@@ -1,4 +1,5 @@
 import { DataConnector } from '../bundle/bundleDataConnector.js';
+import { ExecutionContextError, StrategyExecutionError } from '../types.js';
 import { fetchData, readContract } from '../utils/utils.js';
 import { ExecutionBase } from './executionBase.js';
 export class ExecutionApp extends ExecutionBase {
@@ -484,6 +485,94 @@ export class ExecutionApp extends ExecutionBase {
         const result = await dataConnector.executeBundle(_data);
         return JSON.parse(result);
     }
+    /**
+     * Executes a strategy against a supplied execution context.
+     * This is the recommended API for new consumers. It intentionally bypasses
+     * all legacy vault, pool, subgraph, clock, and block-estimation reads.
+     */
+    async executeWithContext(options) {
+        const vaultConfig = this.parseVaultConfig(options.vaultConfig);
+        const executionContext = options.executionContext;
+        this.validateExecutionContext(executionContext, vaultConfig);
+        const dataConnector = new DataConnector(options.wasmFile, options.vaultConfig, this.config, options.identity, options.etherRpcConfig);
+        try {
+            await dataConnector.loadSync();
+            dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
+            const result = await dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
+            return JSON.parse(result);
+        }
+        catch (error) {
+            if (error instanceof ExecutionContextError)
+                throw error;
+            throw new StrategyExecutionError(this.redactError(error));
+        }
+    }
+    parseVaultConfig(vaultConfig) {
+        try {
+            return JSON.parse(vaultConfig);
+        }
+        catch {
+            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig must be valid JSON.');
+        }
+    }
+    validateExecutionContext(context, vaultConfig) {
+        if (!context || typeof context !== 'object') {
+            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'An execution context is required.');
+        }
+        if (!Number.isSafeInteger(context.chainId) ||
+            !Number.isSafeInteger(context.blockNumber) ||
+            context.blockNumber < 0 ||
+            !Number.isSafeInteger(context.epochTimestamp) ||
+            context.epochTimestamp < 0 ||
+            !Number.isSafeInteger(context.executionTimestamp) ||
+            context.executionTimestamp < 0 ||
+            context.executionTimestamp !== context.epochTimestamp * 1000 ||
+            !Number.isFinite(context.epochLength) ||
+            !Number.isFinite(context.blockTime) ||
+            !Number.isInteger(context.currentTick) ||
+            !Number.isInteger(context.tickSpacing) ||
+            typeof context.vaultAddress !== 'string' ||
+            context.vaultAddress.length === 0 ||
+            typeof context.totalAmount0 !== 'string' ||
+            !/^\d+$/.test(context.totalAmount0) ||
+            typeof context.totalAmount1 !== 'string' ||
+            !/^\d+$/.test(context.totalAmount1) ||
+            !Array.isArray(context.positions) ||
+            !Number.isFinite(context.lastExecutionTime) ||
+            context.lastExecutionTime < 0) {
+            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'Execution context is malformed.');
+        }
+        const sameAddress = (left, right) => left?.toLowerCase() === right?.toLowerCase();
+        if (!sameAddress(this.vault, context.vaultAddress) ||
+            !sameAddress(vaultConfig.vaultAddress, context.vaultAddress)) {
+            throw new ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context vault does not match the execution request.');
+        }
+        if (this.chainId !== context.chainId ||
+            (vaultConfig.chainId !== undefined && Number(vaultConfig.chainId) !== context.chainId)) {
+            throw new ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context chain does not match the execution request.');
+        }
+        if (vaultConfig.anchorBlockNumber !== undefined &&
+            String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
+            throw new ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context block does not match anchorBlockNumber.');
+        }
+        if (Number(vaultConfig.strategyConfigData?.epochLength) !== context.epochLength) {
+            throw new ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context epoch length does not match vaultConfig.');
+        }
+        for (const position of context.positions) {
+            if (!position ||
+                !Number.isInteger(position.startTick) ||
+                !Number.isInteger(position.endTick) ||
+                !Number.isFinite(position.weight)) {
+                throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'Execution context contains an invalid position.');
+            }
+        }
+    }
+    redactError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return message
+            .replace(/https?:\/\/[^\s@/]+(?::[^\s@/]+)?@/gi, 'https://[REDACTED]@')
+            .replace(/([?&](?:key|token|api[_-]?key|password)=)[^&\s]+/gi, '$1[REDACTED]');
+    }
     async executeStabilityVault(_wasmFile, _vaultConfig, _data, _identity, _etherRpcConfig, forceDeposit) {
         const dataConnector = new DataConnector(_wasmFile, _vaultConfig, this.config, _identity, _etherRpcConfig);
         await dataConnector.loadSync();

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

@@ -1,12 +1,12 @@
 import type { ethers } from 'ethers';
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
-import type { EtherRpcConfig, ExecutionContext, VaultConfigPayload } from '../types.js';
+import type { EtherRpcConfig, LegacyExecutionContext, VaultConfigPayload } from '../types.js';
 export declare class ExecutionBase {
     maxRetries: number;
     constructor(maxRetries?: number);
     protected delay(ms: number): Promise<void>;
     protected log(...args: Array<any>): void;
-    protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<ExecutionContext>;
+    protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<LegacyExecutionContext>;
     execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig): Promise<Array<T>>;
     protected getDataConnectorVersion(dataConnector: DataConnector): Promise<number>;
     getAverageBlockTime(provider: ethers.Provider, blockCount?: number): Promise<number>;

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

@@ -1,9 +1,16 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
+import { type ExecutionContext } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export declare class DataConnectorExecution extends ExecutionBase {
     private dataConnectors;
     constructor(dataConnectors: Array<DataConnector>, maxRetries?: number);
     execute<T>(_vaultConfig: string): Promise<Array<T>>;
+    /**
+     * Runs connectors using the same immutable SDK anchor as strategy execution.
+     * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
+     * intentionally not represented as block-pinned data.
+     */
+    executeWithContext<T>(_vaultConfig: string, context: ExecutionContext): Promise<Array<T>>;
     private executeV2Bundle;
     executeDynamicJob<T>(_vaultConfig: string): Promise<Array<T>>;
     private handleRequestResponse;

package/lib/esm/execution/executionDataConnector.js

@@ -1,3 +1,4 @@
+import { DataConnectorTransportError } from '../types.js';
 import { PluginManager } from '../utils/pluginManager.js';
 import { changeUrlIfOld } from '../utils/replace-old-subgraphs.js';
 import { extendOHLCV, fetchData } from '../utils/utils.js';
@@ -47,6 +48,55 @@ export class DataConnectorExecution extends ExecutionBase {
         }
         return transformationData;
     }
+    /**
+     * Runs connectors using the same immutable SDK anchor as strategy execution.
+     * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
+     * intentionally not represented as block-pinned data.
+     */
+    async executeWithContext(_vaultConfig, context) {
+        const vaultConfig = JSON.parse(_vaultConfig);
+        if (!context ||
+            !Number.isSafeInteger(context.chainId) ||
+            !Number.isSafeInteger(context.blockNumber) ||
+            context.blockNumber < 0 ||
+            !Number.isSafeInteger(context.epochTimestamp) ||
+            context.epochTimestamp < 0 ||
+            !Number.isSafeInteger(context.executionTimestamp) ||
+            context.executionTimestamp < 0 ||
+            context.executionTimestamp !== context.epochTimestamp * 1000 ||
+            !Number.isFinite(context.epochLength) ||
+            !Number.isFinite(context.blockTime) ||
+            typeof context.vaultAddress !== 'string' ||
+            context.vaultAddress.length === 0) {
+            throw new Error('INVALID_EXECUTION_CONTEXT: supplied execution context is malformed.');
+        }
+        if (context.vaultAddress.toLowerCase() !== vaultConfig.vaultAddress.toLowerCase()) {
+            throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context vault does not match vaultConfig.vaultAddress.');
+        }
+        const requestChainId = vaultConfig.chainId;
+        if (requestChainId !== undefined && requestChainId !== context.chainId) {
+            throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context chain does not match vaultConfig.chainId.');
+        }
+        if (vaultConfig.anchorBlockNumber !== undefined &&
+            String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
+            throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context block does not match anchorBlockNumber.');
+        }
+        if (Number(vaultConfig.strategyConfigData?.epochLength) !== context.epochLength) {
+            throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context epoch length does not match vaultConfig.');
+        }
+        const transformationData = [];
+        for (const dataConnector of this.dataConnectors) {
+            if (dataConnector.executionAppConfig.chainId !== context.chainId) {
+                throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context chain does not match connector configuration.');
+            }
+            if (!dataConnector.module)
+                await dataConnector.load();
+            dataConnector.initializeDataConnectorWithContext(context);
+            await dataConnector.execute();
+            transformationData.push(JSON.parse(await dataConnector.transform()));
+        }
+        return transformationData;
+    }
     async executeV2Bundle(dataConnector, vaultConfig) {
         const executionContext = await this.getExecutionContext(dataConnector, vaultConfig);
         dataConnector.setExecutionContextDataConnector(executionContext);
@@ -88,7 +138,13 @@ export class DataConnectorExecution extends ExecutionBase {
                         ...(url?.includes('sentio') ? { 'api-key': dataConnector.executionAppConfig.apiKeys.sentioApiKey } : {}),
                     };
                     await this.delay(1000);
-                    response = await fetchData(parsedRequest, 0);
+                    try {
+                        response = await fetchData(parsedRequest, 0);
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        throw new DataConnectorTransportError(message.replace(/https?:\/\/[^\s@/]+(?::[^\s@/]+)?@/gi, 'https://[REDACTED]@'));
+                    }
                 }
                 const nextRequest = await dataConnector.execute(JSON.stringify(response));
                 if (nextRequest === null) {

package/lib/esm/index.d.ts

@@ -1,7 +1,8 @@
 import { DataConnector } from './bundle/bundleDataConnector.js';
 import { ExecutionApp, type ExecutionAppConfig } from './execution/executionApp.js';
 import { DataConnectorExecution } from './execution/executionDataConnector.js';
-import type { VaultConfigPayload } from './types.js';
+import type { ExecuteWithContextOptions, VaultConfigPayload } from './types.js';
 export type * from './types.js';
 export { DataConnector, DataConnectorExecution, ExecutionApp };
-export type { ExecutionAppConfig, VaultConfigPayload };
+export { DataConnectorTransportError, ExecutionContextError, StrategyExecutionError } from './types.js';
+export type { ExecuteWithContextOptions, ExecutionAppConfig, VaultConfigPayload };

package/lib/esm/index.js

@@ -2,3 +2,4 @@ import { DataConnector } from './bundle/bundleDataConnector.js';
 import { ExecutionApp } from './execution/executionApp.js';
 import { DataConnectorExecution } from './execution/executionDataConnector.js';
 export { DataConnector, DataConnectorExecution, ExecutionApp };
+export { DataConnectorTransportError, ExecutionContextError, StrategyExecutionError } from './types.js';

package/lib/esm/types.d.ts

@@ -1,4 +1,30 @@
-import type { InterfaceAbi } from 'ethers';
+import type { ethers, InterfaceAbi } from 'ethers';
+/** Error raised before a strategy is invoked when its supplied SDK anchor is unusable. */
+export declare class ExecutionContextError extends Error {
+    readonly code: 'INVALID_EXECUTION_CONTEXT' | 'EXECUTION_CONTEXT_MISMATCH';
+    constructor(code: ExecutionContextError['code'], message: string);
+}
+/** Error classification for failures in a connector transport request. */
+export declare class DataConnectorTransportError extends Error {
+    readonly code = "DATA_CONNECTOR_TRANSPORT_ERROR";
+    constructor(message: string);
+}
+/** Error classification for a WASM strategy failure. */
+export declare class StrategyExecutionError extends Error {
+    readonly code = "STRATEGY_EXECUTION_ERROR";
+    constructor(message: string);
+}
+/** Options for the block-pinned SDK execution path. */
+export interface ExecuteWithContextOptions {
+    wasmFile: string | ArrayBuffer;
+    vaultConfig: string;
+    data: Array<unknown>;
+    /** Resolved strategy execution context. */
+    executionContext: SmartPoolExecutionContext;
+    identity?: ethers.Provider;
+    etherRpcConfig?: EtherRpcConfig;
+    forceDeposit?: boolean;
+}
 export type VaultInput = {
     _id?: string;
     tokenId: string;
@@ -50,6 +76,7 @@ export interface ConfigData {
     [key: string]: string | number;
 }
 export interface ExecutionContext {
+    chainId: number;
     executionTimestamp: number;
     epochLength: number;
     vaultAddress: string;
@@ -57,6 +84,8 @@ export interface ExecutionContext {
     blockNumber: number;
     epochTimestamp: number;
 }
+/** Context produced by legacy execution paths, which may not have a chain binding. */
+export type LegacyExecutionContext = Omit<ExecutionContext, 'chainId'> & Partial<Pick<ExecutionContext, 'chainId'>>;
 export interface Position {
     startTick: number;
     endTick: number;
@@ -100,6 +129,7 @@ export interface Slot0 {
 }
 export type ViewContractConfig = {
     epochTimestamp?: number;
+    blockNumber?: number;
     address: string;
     abi: any;
     arguments: Array<any>;

package/lib/esm/types.js

@@ -1 +1,24 @@
-export {};
+/** Error raised before a strategy is invoked when its supplied SDK anchor is unusable. */
+export class ExecutionContextError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'ExecutionContextError';
+        this.code = code;
+    }
+}
+/** Error classification for failures in a connector transport request. */
+export class DataConnectorTransportError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'DATA_CONNECTOR_TRANSPORT_ERROR';
+        this.name = 'DataConnectorTransportError';
+    }
+}
+/** Error classification for a WASM strategy failure. */
+export class StrategyExecutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'STRATEGY_EXECUTION_ERROR';
+        this.name = 'StrategyExecutionError';
+    }
+}

package/lib/esm/utils/utils.d.ts

@@ -1,13 +1,13 @@
 import type { Candle } from '@steerprotocol/app-loader';
 import type { AxiosRequestConfig } from 'axios';
 import { type Provider } from 'ethers';
-import type { ExecutionContext, ViewContractConfig } from '../types.js';
+import type { LegacyExecutionContext, ViewContractConfig } from '../types.js';
 export declare const extendOHLCV: (rawData: Array<Candle>, period: number, endTimestamp: number) => Array<Candle>;
 export declare function fetchData(request: AxiosRequestConfig, attempts: number): Promise<any>;
 export declare function readContract({ abi, address, chainId, contractArguments, currentExecutionContext, functionName, provider, rpc, }: {
     address: string;
     abi: any;
-    currentExecutionContext: ExecutionContext;
+    currentExecutionContext: LegacyExecutionContext;
     functionName: string;
     provider: Provider;
     rpc: string;

package/lib/esm/utils/utils.js

@@ -83,6 +83,7 @@ export async function readContract({ abi, address, chainId, contractArguments =
         console.log('Calling the centralized view');
         const viewContractConfig = {
             epochTimestamp: currentExecutionContext.epochTimestamp,
+            blockNumber: currentExecutionContext.blockNumber,
             address,
             abi,
             arguments: paramsArray,

package/lib/execution/executionApp.d.ts

@@ -1,5 +1,5 @@
 import type { ethers } from 'ethers';
-import type { EtherRpcConfig, JobDetails } from '../types.js';
+import type { EtherRpcConfig, ExecuteWithContextOptions, JobDetails } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export interface ExecutionAppConfig {
     /** Vault address used for execution context and subgraph queries. */
@@ -43,6 +43,15 @@ export declare class ExecutionApp extends ExecutionBase {
     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>>;
+    /**
+     * Executes a strategy against a supplied execution context.
+     * This is the recommended API for new consumers. It intentionally bypasses
+     * all legacy vault, pool, subgraph, clock, and block-estimation reads.
+     */
+    executeWithContext<T>(options: ExecuteWithContextOptions): Promise<Array<T>>;
+    private parseVaultConfig;
+    private validateExecutionContext;
+    private redactError;
     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;

package/lib/execution/executionApp.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExecutionApp = void 0;
 const bundleDataConnector_js_1 = require("../bundle/bundleDataConnector.js");
+const types_js_1 = require("../types.js");
 const utils_js_1 = require("../utils/utils.js");
 const executionBase_js_1 = require("./executionBase.js");
 class ExecutionApp extends executionBase_js_1.ExecutionBase {
@@ -496,6 +497,97 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             return JSON.parse(result);
         });
     }
+    /**
+     * Executes a strategy against a supplied execution context.
+     * This is the recommended API for new consumers. It intentionally bypasses
+     * all legacy vault, pool, subgraph, clock, and block-estimation reads.
+     */
+    executeWithContext(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const vaultConfig = this.parseVaultConfig(options.vaultConfig);
+            const executionContext = options.executionContext;
+            this.validateExecutionContext(executionContext, vaultConfig);
+            const dataConnector = new bundleDataConnector_js_1.DataConnector(options.wasmFile, options.vaultConfig, this.config, options.identity, options.etherRpcConfig);
+            try {
+                yield dataConnector.loadSync();
+                dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
+                const result = yield dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
+                return JSON.parse(result);
+            }
+            catch (error) {
+                if (error instanceof types_js_1.ExecutionContextError)
+                    throw error;
+                throw new types_js_1.StrategyExecutionError(this.redactError(error));
+            }
+        });
+    }
+    parseVaultConfig(vaultConfig) {
+        try {
+            return JSON.parse(vaultConfig);
+        }
+        catch (_a) {
+            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig must be valid JSON.');
+        }
+    }
+    validateExecutionContext(context, vaultConfig) {
+        var _a;
+        if (!context || typeof context !== 'object') {
+            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'An execution context is required.');
+        }
+        if (!Number.isSafeInteger(context.chainId) ||
+            !Number.isSafeInteger(context.blockNumber) ||
+            context.blockNumber < 0 ||
+            !Number.isSafeInteger(context.epochTimestamp) ||
+            context.epochTimestamp < 0 ||
+            !Number.isSafeInteger(context.executionTimestamp) ||
+            context.executionTimestamp < 0 ||
+            context.executionTimestamp !== context.epochTimestamp * 1000 ||
+            !Number.isFinite(context.epochLength) ||
+            !Number.isFinite(context.blockTime) ||
+            !Number.isInteger(context.currentTick) ||
+            !Number.isInteger(context.tickSpacing) ||
+            typeof context.vaultAddress !== 'string' ||
+            context.vaultAddress.length === 0 ||
+            typeof context.totalAmount0 !== 'string' ||
+            !/^\d+$/.test(context.totalAmount0) ||
+            typeof context.totalAmount1 !== 'string' ||
+            !/^\d+$/.test(context.totalAmount1) ||
+            !Array.isArray(context.positions) ||
+            !Number.isFinite(context.lastExecutionTime) ||
+            context.lastExecutionTime < 0) {
+            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'Execution context is malformed.');
+        }
+        const sameAddress = (left, right) => (left === null || left === void 0 ? void 0 : left.toLowerCase()) === (right === null || right === void 0 ? void 0 : right.toLowerCase());
+        if (!sameAddress(this.vault, context.vaultAddress) ||
+            !sameAddress(vaultConfig.vaultAddress, context.vaultAddress)) {
+            throw new types_js_1.ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context vault does not match the execution request.');
+        }
+        if (this.chainId !== context.chainId ||
+            (vaultConfig.chainId !== undefined && Number(vaultConfig.chainId) !== context.chainId)) {
+            throw new types_js_1.ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context chain does not match the execution request.');
+        }
+        if (vaultConfig.anchorBlockNumber !== undefined &&
+            String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
+            throw new types_js_1.ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context block does not match anchorBlockNumber.');
+        }
+        if (Number((_a = vaultConfig.strategyConfigData) === null || _a === void 0 ? void 0 : _a.epochLength) !== context.epochLength) {
+            throw new types_js_1.ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context epoch length does not match vaultConfig.');
+        }
+        for (const position of context.positions) {
+            if (!position ||
+                !Number.isInteger(position.startTick) ||
+                !Number.isInteger(position.endTick) ||
+                !Number.isFinite(position.weight)) {
+                throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'Execution context contains an invalid position.');
+            }
+        }
+    }
+    redactError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return message
+            .replace(/https?:\/\/[^\s@/]+(?::[^\s@/]+)?@/gi, 'https://[REDACTED]@')
+            .replace(/([?&](?:key|token|api[_-]?key|password)=)[^&\s]+/gi, '$1[REDACTED]');
+    }
     executeStabilityVault(_wasmFile, _vaultConfig, _data, _identity, _etherRpcConfig, forceDeposit) {
         return __awaiter(this, void 0, void 0, function* () {
             const dataConnector = new bundleDataConnector_js_1.DataConnector(_wasmFile, _vaultConfig, this.config, _identity, _etherRpcConfig);

package/lib/execution/executionBase.d.ts

@@ -1,12 +1,12 @@
 import type { ethers } from 'ethers';
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
-import type { EtherRpcConfig, ExecutionContext, VaultConfigPayload } from '../types.js';
+import type { EtherRpcConfig, LegacyExecutionContext, VaultConfigPayload } from '../types.js';
 export declare class ExecutionBase {
     maxRetries: number;
     constructor(maxRetries?: number);
     protected delay(ms: number): Promise<void>;
     protected log(...args: Array<any>): void;
-    protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<ExecutionContext>;
+    protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<LegacyExecutionContext>;
     execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _identity?: ethers.Provider, _etherRpcConfig?: EtherRpcConfig): Promise<Array<T>>;
     protected getDataConnectorVersion(dataConnector: DataConnector): Promise<number>;
     getAverageBlockTime(provider: ethers.Provider, blockCount?: number): Promise<number>;

package/lib/execution/executionDataConnector.d.ts

@@ -1,9 +1,16 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
+import { type ExecutionContext } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export declare class DataConnectorExecution extends ExecutionBase {
     private dataConnectors;
     constructor(dataConnectors: Array<DataConnector>, maxRetries?: number);
     execute<T>(_vaultConfig: string): Promise<Array<T>>;
+    /**
+     * Runs connectors using the same immutable SDK anchor as strategy execution.
+     * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
+     * intentionally not represented as block-pinned data.
+     */
+    executeWithContext<T>(_vaultConfig: string, context: ExecutionContext): Promise<Array<T>>;
     private executeV2Bundle;
     executeDynamicJob<T>(_vaultConfig: string): Promise<Array<T>>;
     private handleRequestResponse;

package/lib/execution/executionDataConnector.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataConnectorExecution = void 0;
+const types_js_1 = require("../types.js");
 const pluginManager_js_1 = require("../utils/pluginManager.js");
 const replace_old_subgraphs_js_1 = require("../utils/replace-old-subgraphs.js");
 const utils_js_1 = require("../utils/utils.js");
@@ -61,6 +62,58 @@ class DataConnectorExecution extends executionBase_js_1.ExecutionBase {
             return transformationData;
         });
     }
+    /**
+     * Runs connectors using the same immutable SDK anchor as strategy execution.
+     * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
+     * intentionally not represented as block-pinned data.
+     */
+    executeWithContext(_vaultConfig, context) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const vaultConfig = JSON.parse(_vaultConfig);
+            if (!context ||
+                !Number.isSafeInteger(context.chainId) ||
+                !Number.isSafeInteger(context.blockNumber) ||
+                context.blockNumber < 0 ||
+                !Number.isSafeInteger(context.epochTimestamp) ||
+                context.epochTimestamp < 0 ||
+                !Number.isSafeInteger(context.executionTimestamp) ||
+                context.executionTimestamp < 0 ||
+                context.executionTimestamp !== context.epochTimestamp * 1000 ||
+                !Number.isFinite(context.epochLength) ||
+                !Number.isFinite(context.blockTime) ||
+                typeof context.vaultAddress !== 'string' ||
+                context.vaultAddress.length === 0) {
+                throw new Error('INVALID_EXECUTION_CONTEXT: supplied execution context is malformed.');
+            }
+            if (context.vaultAddress.toLowerCase() !== vaultConfig.vaultAddress.toLowerCase()) {
+                throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context vault does not match vaultConfig.vaultAddress.');
+            }
+            const requestChainId = vaultConfig.chainId;
+            if (requestChainId !== undefined && requestChainId !== context.chainId) {
+                throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context chain does not match vaultConfig.chainId.');
+            }
+            if (vaultConfig.anchorBlockNumber !== undefined &&
+                String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
+                throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context block does not match anchorBlockNumber.');
+            }
+            if (Number((_a = vaultConfig.strategyConfigData) === null || _a === void 0 ? void 0 : _a.epochLength) !== context.epochLength) {
+                throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context epoch length does not match vaultConfig.');
+            }
+            const transformationData = [];
+            for (const dataConnector of this.dataConnectors) {
+                if (dataConnector.executionAppConfig.chainId !== context.chainId) {
+                    throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context chain does not match connector configuration.');
+                }
+                if (!dataConnector.module)
+                    yield dataConnector.load();
+                dataConnector.initializeDataConnectorWithContext(context);
+                yield dataConnector.execute();
+                transformationData.push(JSON.parse(yield dataConnector.transform()));
+            }
+            return transformationData;
+        });
+    }
     executeV2Bundle(dataConnector, vaultConfig) {
         return __awaiter(this, void 0, void 0, function* () {
             const executionContext = yield this.getExecutionContext(dataConnector, vaultConfig);
@@ -104,7 +157,13 @@ class DataConnectorExecution extends executionBase_js_1.ExecutionBase {
                         parsedRequest.url = url;
                         parsedRequest.headers = Object.assign({ 'Content-Type': url && !url.includes('subgraph-proxy-server') ? 'application/json' : 'text/plain;charset=UTF-8' }, ((url === null || url === void 0 ? void 0 : url.includes('sentio')) ? { 'api-key': dataConnector.executionAppConfig.apiKeys.sentioApiKey } : {}));
                         yield this.delay(1000);
-                        response = yield (0, utils_js_1.fetchData)(parsedRequest, 0);
+                        try {
+                            response = yield (0, utils_js_1.fetchData)(parsedRequest, 0);
+                        }
+                        catch (error) {
+                            const message = error instanceof Error ? error.message : String(error);
+                            throw new types_js_1.DataConnectorTransportError(message.replace(/https?:\/\/[^\s@/]+(?::[^\s@/]+)?@/gi, 'https://[REDACTED]@'));
+                        }
                     }
                     const nextRequest = yield dataConnector.execute(JSON.stringify(response));
                     if (nextRequest === null) {

package/lib/index.d.ts

@@ -1,7 +1,8 @@
 import { DataConnector } from './bundle/bundleDataConnector.js';
 import { ExecutionApp, type ExecutionAppConfig } from './execution/executionApp.js';
 import { DataConnectorExecution } from './execution/executionDataConnector.js';
-import type { VaultConfigPayload } from './types.js';
+import type { ExecuteWithContextOptions, VaultConfigPayload } from './types.js';
 export type * from './types.js';
 export { DataConnector, DataConnectorExecution, ExecutionApp };
-export type { ExecutionAppConfig, VaultConfigPayload };
+export { DataConnectorTransportError, ExecutionContextError, StrategyExecutionError } from './types.js';
+export type { ExecuteWithContextOptions, ExecutionAppConfig, VaultConfigPayload };

package/lib/index.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExecutionApp = exports.DataConnectorExecution = exports.DataConnector = void 0;
+exports.StrategyExecutionError = exports.ExecutionContextError = exports.DataConnectorTransportError = exports.ExecutionApp = exports.DataConnectorExecution = exports.DataConnector = void 0;
 const bundleDataConnector_js_1 = require("./bundle/bundleDataConnector.js");
 Object.defineProperty(exports, "DataConnector", { enumerable: true, get: function () { return bundleDataConnector_js_1.DataConnector; } });
 const executionApp_js_1 = require("./execution/executionApp.js");
 Object.defineProperty(exports, "ExecutionApp", { enumerable: true, get: function () { return executionApp_js_1.ExecutionApp; } });
 const executionDataConnector_js_1 = require("./execution/executionDataConnector.js");
 Object.defineProperty(exports, "DataConnectorExecution", { enumerable: true, get: function () { return executionDataConnector_js_1.DataConnectorExecution; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "DataConnectorTransportError", { enumerable: true, get: function () { return types_js_1.DataConnectorTransportError; } });
+Object.defineProperty(exports, "ExecutionContextError", { enumerable: true, get: function () { return types_js_1.ExecutionContextError; } });
+Object.defineProperty(exports, "StrategyExecutionError", { enumerable: true, get: function () { return types_js_1.StrategyExecutionError; } });

package/lib/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/lib/types.d.ts

@@ -1,4 +1,30 @@
-import type { InterfaceAbi } from 'ethers';
+import type { ethers, InterfaceAbi } from 'ethers';
+/** Error raised before a strategy is invoked when its supplied SDK anchor is unusable. */
+export declare class ExecutionContextError extends Error {
+    readonly code: 'INVALID_EXECUTION_CONTEXT' | 'EXECUTION_CONTEXT_MISMATCH';
+    constructor(code: ExecutionContextError['code'], message: string);
+}
+/** Error classification for failures in a connector transport request. */
+export declare class DataConnectorTransportError extends Error {
+    readonly code = "DATA_CONNECTOR_TRANSPORT_ERROR";
+    constructor(message: string);
+}
+/** Error classification for a WASM strategy failure. */
+export declare class StrategyExecutionError extends Error {
+    readonly code = "STRATEGY_EXECUTION_ERROR";
+    constructor(message: string);
+}
+/** Options for the block-pinned SDK execution path. */
+export interface ExecuteWithContextOptions {
+    wasmFile: string | ArrayBuffer;
+    vaultConfig: string;
+    data: Array<unknown>;
+    /** Resolved strategy execution context. */
+    executionContext: SmartPoolExecutionContext;
+    identity?: ethers.Provider;
+    etherRpcConfig?: EtherRpcConfig;
+    forceDeposit?: boolean;
+}
 export type VaultInput = {
     _id?: string;
     tokenId: string;
@@ -50,6 +76,7 @@ export interface ConfigData {
     [key: string]: string | number;
 }
 export interface ExecutionContext {
+    chainId: number;
     executionTimestamp: number;
     epochLength: number;
     vaultAddress: string;
@@ -57,6 +84,8 @@ export interface ExecutionContext {
     blockNumber: number;
     epochTimestamp: number;
 }
+/** Context produced by legacy execution paths, which may not have a chain binding. */
+export type LegacyExecutionContext = Omit<ExecutionContext, 'chainId'> & Partial<Pick<ExecutionContext, 'chainId'>>;
 export interface Position {
     startTick: number;
     endTick: number;
@@ -100,6 +129,7 @@ export interface Slot0 {
 }
 export type ViewContractConfig = {
     epochTimestamp?: number;
+    blockNumber?: number;
     address: string;
     abi: any;
     arguments: Array<any>;

package/lib/types.js

@@ -1,2 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StrategyExecutionError = exports.DataConnectorTransportError = exports.ExecutionContextError = void 0;
+/** Error raised before a strategy is invoked when its supplied SDK anchor is unusable. */
+class ExecutionContextError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'ExecutionContextError';
+        this.code = code;
+    }
+}
+exports.ExecutionContextError = ExecutionContextError;
+/** Error classification for failures in a connector transport request. */
+class DataConnectorTransportError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'DATA_CONNECTOR_TRANSPORT_ERROR';
+        this.name = 'DataConnectorTransportError';
+    }
+}
+exports.DataConnectorTransportError = DataConnectorTransportError;
+/** Error classification for a WASM strategy failure. */
+class StrategyExecutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'STRATEGY_EXECUTION_ERROR';
+        this.name = 'StrategyExecutionError';
+    }
+}
+exports.StrategyExecutionError = StrategyExecutionError;

package/lib/utils/utils.d.ts

@@ -1,13 +1,13 @@
 import type { Candle } from '@steerprotocol/app-loader';
 import type { AxiosRequestConfig } from 'axios';
 import { type Provider } from 'ethers';
-import type { ExecutionContext, ViewContractConfig } from '../types.js';
+import type { LegacyExecutionContext, ViewContractConfig } from '../types.js';
 export declare const extendOHLCV: (rawData: Array<Candle>, period: number, endTimestamp: number) => Array<Candle>;
 export declare function fetchData(request: AxiosRequestConfig, attempts: number): Promise<any>;
 export declare function readContract({ abi, address, chainId, contractArguments, currentExecutionContext, functionName, provider, rpc, }: {
     address: string;
     abi: any;
-    currentExecutionContext: ExecutionContext;
+    currentExecutionContext: LegacyExecutionContext;
     functionName: string;
     provider: Provider;
     rpc: string;

package/lib/utils/utils.js

@@ -105,6 +105,7 @@ function readContract({ abi, address, chainId, contractArguments = [], currentEx
             console.log('Calling the centralized view');
             const viewContractConfig = {
                 epochTimestamp: currentExecutionContext.epochTimestamp,
+                blockNumber: currentExecutionContext.blockNumber,
                 address,
                 abi,
                 arguments: paramsArray,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerprotocol/data-connector-loader",
-  "version": "4.0.3",
+  "version": "5.0.0-next.1",
   "description": "App Loader for Steer Protocol",
   "type": "module",
   "main": "lib/index.js",
@@ -16,7 +16,7 @@
   },
   "scripts": {
     "build": "npm run build:cjs && npm run build:esm",
-    "build:cjs": "tsc -p tsconfig.json",
+    "build:cjs": "tsc -p tsconfig.json && echo '{\"type\": \"commonjs\"}' > lib/package.json",
     "build:esm": "tsc -p tsconfig.esm.json && echo '{\"type\": \"module\"}' > lib/esm/package.json",
     "format": "prettier --write \"src/**/*.(js|ts)\"",
     "lint": "eslint src --ext .js,.ts",
@@ -24,6 +24,7 @@
     "lint:fix": "eslint src --fix --ext .js,.ts",
     "test": "jest --config jest.config.cjs",
     "pack:local": "npm pack",
+    "test:packed-consumer": "node scripts/packed-consumer-smoke.cjs",
     "publish:test": "node scripts/publish-test.cjs",
     "prepare": "husky && npm run build",
     "prepublishOnly": "npm test && npm run lint",
@@ -53,7 +54,12 @@
   "homepage": "https://github.com/SteerProtocol/data-connector-loader#readme",
   "release": {
     "branches": [
-      "main"
+      "main",
+      {
+        "name": "next",
+        "prerelease": "next",
+        "channel": "next"
+      }
     ],
     "plugins": [
       [
@@ -82,10 +88,6 @@
     "@types/jest": "29.2.4",
     "@typescript-eslint/eslint-plugin": "5.46.0",
     "@typescript-eslint/parser": "5.47.1",
-    "@uniswap/sdk-core": "^7.10.0",
-    "@uniswap/v2-sdk": "^4.16.0",
-    "@uniswap/v3-sdk": "^3.26.0",
-    "date-fns": "^2.29.3",
     "eslint": "8.30.0",
     "eslint-plugin-jest": "27.1.7",
     "husky": "^9.1.7",
@@ -93,15 +95,14 @@
     "prettier": "2.8.1",
     "semantic-release": "^25.0.3",
     "ts-jest": "29.0.3",
-    "typescript": "5.0.4",
-    "viem": "^2.42.1"
+    "typescript": "5.0.4"
   },
   "files": [
     "lib/**/*"
   ],
   "dependencies": {
     "@steerprotocol/app-loader": "^3.0.6",
-    "@steerprotocol/sdk": "^2.0.0",
+    "@steerprotocol/sdk": "^3.3.0",
     "@steerprotocol/strategy-utils": "^3.1.2",
     "axios": "^1.3.4",
     "ethers": "^6.16.0",