@steerprotocol/data-connector-loader 4.1.0 → 5.0.0-next.2

package/README.md

@@ -22,36 +22,50 @@ pnpm add @steerprotocol/data-connector-loader
 
 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)
 
-Resolve the vault context with `@steerprotocol/sdk` 3.3+ and pass its successful
-`VaultExecutionContext` straight to `executeWithContext`. This path makes no
-pool, vault, subgraph, latest-block, average-block-time, or wall-clock reads.
-Uniswap v3-compatible, Algebra Integral, Aerodrome CL, and normalized Uniswap
-v4 contexts are supported. PoolShark remains unsupported by the SDK context API.
+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 { ExecutionApp } from '@steerprotocol/data-connector-loader';
-import { getVaultExecutionContext } from '@steerprotocol/sdk';
+import { DataConnectorExecution, ExecutionApp } from '@steerprotocol/data-connector-loader';
 
-const response = await getVaultExecutionContext({ publicClient, vaultAddress, blockNumber, epochTimestamp });
-if (!response.success || !response.data) throw new Error(response.error ?? 'Context resolution failed');
-
-const app = new ExecutionApp(legacyCompatibleConfig);
-const actions = await app.executeWithContext({
+// 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: JSON.stringify({ vaultAddress, anchorBlockNumber: Number(blockNumber), strategyConfigData: { epochLength: '3600' } }),
+  vaultConfig,
   data: connectorOutputs,
-  executionContext: response.data,
+  executionContext: context,
 });
 ```
 
-`vaultConfig` must include `vaultAddress`, `anchorBlockNumber`, and
-`strategyConfigData.epochLength`. Positions are translated at the WASM boundary
-from SDK `lowerTick`/`upperTick`/`relativeWeight` to
-`startTick`/`endTick`/`weight`; totals remain decimal strings. If SDK reports no
-last execution, WASM receives `lastExecutionTime: 0` (deterministic, no
-wall-clock fallback). Errors are `ExecutionContextError`
+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

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,15 +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;
+    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.
      */
-    setExecutionContextStrategyExecutionPinned(executionContext: ExecutionContext, forceDeposit?: boolean): void;
-    setExecutionContextDataConnector(executionContext: ExecutionContext): void;
+    initializeStrategyWithContext(executionContext: ExecutionContext, forceDeposit?: boolean): void;
+    setExecutionContextDataConnector(executionContext: LegacyExecutionContext): void;
     /** Initializes a data connector with an immutable SDK anchor. */
-    setExecutionContextDataConnectorPinned(executionContext: ExecutionContext): void;
+    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

@@ -177,7 +177,7 @@ class BundleBase {
      * Initializes a strategy from an already resolved SDK context. Unlike the
      * legacy setter this deliberately does not derive a timestamp or block.
      */
-    setExecutionContextStrategyExecutionPinned(executionContext, forceDeposit) {
+    initializeStrategyWithContext(executionContext, forceDeposit) {
         var _a;
         this.executionContext = executionContext;
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
@@ -199,7 +199,7 @@ class BundleBase {
         (_a = this.module) === null || _a === void 0 ? void 0 : _a.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     /** Initializes a data connector with an immutable SDK anchor. */
-    setExecutionContextDataConnectorPinned(executionContext) {
+    initializeDataConnectorWithContext(executionContext) {
         var _a;
         this.executionContext = executionContext;
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;

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,15 +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;
+    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.
      */
-    setExecutionContextStrategyExecutionPinned(executionContext: ExecutionContext, forceDeposit?: boolean): void;
-    setExecutionContextDataConnector(executionContext: ExecutionContext): void;
+    initializeStrategyWithContext(executionContext: ExecutionContext, forceDeposit?: boolean): void;
+    setExecutionContextDataConnector(executionContext: LegacyExecutionContext): void;
     /** Initializes a data connector with an immutable SDK anchor. */
-    setExecutionContextDataConnectorPinned(executionContext: ExecutionContext): void;
+    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

@@ -154,7 +154,7 @@ export class BundleBase {
      * Initializes a strategy from an already resolved SDK context. Unlike the
      * legacy setter this deliberately does not derive a timestamp or block.
      */
-    setExecutionContextStrategyExecutionPinned(executionContext, forceDeposit) {
+    initializeStrategyWithContext(executionContext, forceDeposit) {
         this.executionContext = executionContext;
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
         const completeConfig = { ...JSON.parse(this.config), ...executionContext };
@@ -174,7 +174,7 @@ export class BundleBase {
         this.module?.initialize(JSON.stringify(completeConfig, bigIntReplacer));
     }
     /** Initializes a data connector with an immutable SDK anchor. */
-    setExecutionContextDataConnectorPinned(executionContext) {
+    initializeDataConnectorWithContext(executionContext) {
         this.executionContext = executionContext;
         this.scheduleEpochTimestamp = executionContext.epochTimestamp;
         const completeConfig = { ...JSON.parse(this.config), executionContext };

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

@@ -44,13 +44,13 @@ export declare class ExecutionApp extends ExecutionBase {
     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 the immutable context resolved by SDK 3.3+.
+     * 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 mapSdkExecutionContext;
+    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>>;

package/lib/esm/execution/executionApp.js

@@ -486,17 +486,18 @@ export class ExecutionApp extends ExecutionBase {
         return JSON.parse(result);
     }
     /**
-     * Executes a strategy against the immutable context resolved by SDK 3.3+.
+     * 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 = this.mapSdkExecutionContext(options.executionContext, 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.setExecutionContextStrategyExecutionPinned(executionContext, options.forceDeposit);
+            dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
             const result = await dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
             return JSON.parse(result);
         }
@@ -514,34 +515,32 @@ export class ExecutionApp extends ExecutionBase {
             throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig must be valid JSON.');
         }
     }
-    mapSdkExecutionContext(context, vaultConfig) {
+    validateExecutionContext(context, vaultConfig) {
         if (!context || typeof context !== 'object') {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'A successful SDK VaultExecutionContext is required.');
+            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'An execution context is required.');
         }
-        const requiredStringFields = [
-            'blockNumber',
-            'epochTimestamp',
-            'vaultAddress',
-            'totalAmount0',
-            'totalAmount1',
-        ];
-        for (const field of requiredStringFields) {
-            if (typeof context[field] !== 'string' || context[field].length === 0) {
-                throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', `SDK execution context has invalid ${field}.`);
-            }
-        }
-        if (!Number.isInteger(context.chainId) ||
+        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)) {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has invalid chain or pool state.');
-        }
-        if (!Array.isArray(context.positions) ||
-            !/^\d+$/.test(context.blockNumber) ||
-            !/^\d+$/.test(context.epochTimestamp)) {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has malformed anchor fields.');
-        }
-        if (!/^\d+$/.test(context.totalAmount0) || !/^\d+$/.test(context.totalAmount1)) {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context totals must be decimal strings.');
+            !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) ||
@@ -552,43 +551,21 @@ export class ExecutionApp extends ExecutionBase {
             (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) !== context.blockNumber) {
+        if (vaultConfig.anchorBlockNumber !== undefined &&
+            String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
             throw new ExecutionContextError('EXECUTION_CONTEXT_MISMATCH', 'Supplied context block does not match anchorBlockNumber.');
         }
-        const epochLength = Number(vaultConfig.strategyConfigData?.epochLength);
-        if (!Number.isFinite(epochLength)) {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig.strategyConfigData.epochLength is required.');
+        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 (!Number.isInteger(position.lowerTick) ||
-                !Number.isInteger(position.upperTick) ||
-                !Number.isFinite(position.relativeWeight)) {
-                throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context contains an invalid position.');
+            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.');
             }
         }
-        // Null is deterministic: WASM receives zero elapsed seconds, never wall-clock time.
-        const lastExecutionTime = context.lastExecutionTimeSeconds === null ? 0 : Number(context.lastExecutionTimeSeconds);
-        if (!Number.isFinite(lastExecutionTime) || lastExecutionTime < 0) {
-            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has invalid lastExecutionTimeSeconds.');
-        }
-        return {
-            executionTimestamp: Number(context.epochTimestamp) * 1000,
-            epochTimestamp: Number(context.epochTimestamp),
-            epochLength,
-            vaultAddress: context.vaultAddress,
-            blockTime: 0,
-            blockNumber: Number(context.blockNumber),
-            currentTick: context.currentTick,
-            tickSpacing: context.tickSpacing,
-            positions: context.positions.map(({ lowerTick, upperTick, relativeWeight }) => ({
-                startTick: lowerTick,
-                endTick: upperTick,
-                weight: relativeWeight,
-            })),
-            totalAmount0: context.totalAmount0,
-            totalAmount1: context.totalAmount1,
-            lastExecutionTime,
-        };
     }
     redactError(error) {
         const message = error instanceof Error ? error.message : String(error);

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,5 +1,5 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
-import type { VaultExecutionContext } from '@steerprotocol/sdk';
+import { type ExecutionContext } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export declare class DataConnectorExecution extends ExecutionBase {
     private dataConnectors;
@@ -10,7 +10,7 @@ export declare class DataConnectorExecution extends ExecutionBase {
      * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
      * intentionally not represented as block-pinned data.
      */
-    executeWithContext<T>(_vaultConfig: string, context: VaultExecutionContext): Promise<Array<T>>;
+    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

@@ -55,8 +55,20 @@ export class DataConnectorExecution extends ExecutionBase {
      */
     async executeWithContext(_vaultConfig, context) {
         const vaultConfig = JSON.parse(_vaultConfig);
-        if (!context || !/^\d+$/.test(context.blockNumber) || !/^\d+$/.test(context.epochTimestamp)) {
-            throw new Error('INVALID_EXECUTION_CONTEXT: supplied SDK execution context is malformed.');
+        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.');
@@ -65,17 +77,13 @@ export class DataConnectorExecution extends ExecutionBase {
         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) !== context.blockNumber) {
+        if (vaultConfig.anchorBlockNumber !== undefined &&
+            String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
             throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context block does not match anchorBlockNumber.');
         }
-        const executionContext = {
-            executionTimestamp: Number(context.epochTimestamp) * 1000,
-            epochTimestamp: Number(context.epochTimestamp),
-            epochLength: Number(vaultConfig.strategyConfigData.epochLength),
-            vaultAddress: context.vaultAddress,
-            blockTime: 0,
-            blockNumber: Number(context.blockNumber),
-        };
+        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) {
@@ -83,7 +91,7 @@ export class DataConnectorExecution extends ExecutionBase {
             }
             if (!dataConnector.module)
                 await dataConnector.load();
-            dataConnector.setExecutionContextDataConnectorPinned(executionContext);
+            dataConnector.initializeDataConnectorWithContext(context);
             await dataConnector.execute();
             transformationData.push(JSON.parse(await dataConnector.transform()));
         }

package/lib/esm/types.d.ts

@@ -1,5 +1,4 @@
 import type { ethers, InterfaceAbi } from 'ethers';
-import type { VaultExecutionContext } from '@steerprotocol/sdk';
 /** 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';
@@ -20,8 +19,8 @@ export interface ExecuteWithContextOptions {
     wasmFile: string | ArrayBuffer;
     vaultConfig: string;
     data: Array<unknown>;
-    /** Successful, normalized context returned by @steerprotocol/sdk 3.3+. */
-    executionContext: VaultExecutionContext;
+    /** Resolved strategy execution context. */
+    executionContext: SmartPoolExecutionContext;
     identity?: ethers.Provider;
     etherRpcConfig?: EtherRpcConfig;
     forceDeposit?: boolean;
@@ -77,6 +76,7 @@ export interface ConfigData {
     [key: string]: string | number;
 }
 export interface ExecutionContext {
+    chainId: number;
     executionTimestamp: number;
     epochLength: number;
     vaultAddress: string;
@@ -84,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;

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/execution/executionApp.d.ts

@@ -44,13 +44,13 @@ export declare class ExecutionApp extends ExecutionBase {
     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 the immutable context resolved by SDK 3.3+.
+     * 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 mapSdkExecutionContext;
+    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>>;

package/lib/execution/executionApp.js

@@ -498,18 +498,19 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
         });
     }
     /**
-     * Executes a strategy against the immutable context resolved by SDK 3.3+.
+     * 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 = this.mapSdkExecutionContext(options.executionContext, 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.setExecutionContextStrategyExecutionPinned(executionContext, options.forceDeposit);
+                dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
                 const result = yield dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
                 return JSON.parse(result);
             }
@@ -528,35 +529,33 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig must be valid JSON.');
         }
     }
-    mapSdkExecutionContext(context, vaultConfig) {
+    validateExecutionContext(context, vaultConfig) {
         var _a;
         if (!context || typeof context !== 'object') {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'A successful SDK VaultExecutionContext is required.');
+            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'An execution context is required.');
         }
-        const requiredStringFields = [
-            'blockNumber',
-            'epochTimestamp',
-            'vaultAddress',
-            'totalAmount0',
-            'totalAmount1',
-        ];
-        for (const field of requiredStringFields) {
-            if (typeof context[field] !== 'string' || context[field].length === 0) {
-                throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', `SDK execution context has invalid ${field}.`);
-            }
-        }
-        if (!Number.isInteger(context.chainId) ||
+        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)) {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has invalid chain or pool state.');
-        }
-        if (!Array.isArray(context.positions) ||
-            !/^\d+$/.test(context.blockNumber) ||
-            !/^\d+$/.test(context.epochTimestamp)) {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has malformed anchor fields.');
-        }
-        if (!/^\d+$/.test(context.totalAmount0) || !/^\d+$/.test(context.totalAmount1)) {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context totals must be decimal strings.');
+            !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) ||
@@ -567,43 +566,21 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             (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) !== context.blockNumber) {
+        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.');
         }
-        const epochLength = Number((_a = vaultConfig.strategyConfigData) === null || _a === void 0 ? void 0 : _a.epochLength);
-        if (!Number.isFinite(epochLength)) {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'vaultConfig.strategyConfigData.epochLength is required.');
+        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 (!Number.isInteger(position.lowerTick) ||
-                !Number.isInteger(position.upperTick) ||
-                !Number.isFinite(position.relativeWeight)) {
-                throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context contains an invalid position.');
+            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.');
             }
         }
-        // Null is deterministic: WASM receives zero elapsed seconds, never wall-clock time.
-        const lastExecutionTime = context.lastExecutionTimeSeconds === null ? 0 : Number(context.lastExecutionTimeSeconds);
-        if (!Number.isFinite(lastExecutionTime) || lastExecutionTime < 0) {
-            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'SDK execution context has invalid lastExecutionTimeSeconds.');
-        }
-        return {
-            executionTimestamp: Number(context.epochTimestamp) * 1000,
-            epochTimestamp: Number(context.epochTimestamp),
-            epochLength,
-            vaultAddress: context.vaultAddress,
-            blockTime: 0,
-            blockNumber: Number(context.blockNumber),
-            currentTick: context.currentTick,
-            tickSpacing: context.tickSpacing,
-            positions: context.positions.map(({ lowerTick, upperTick, relativeWeight }) => ({
-                startTick: lowerTick,
-                endTick: upperTick,
-                weight: relativeWeight,
-            })),
-            totalAmount0: context.totalAmount0,
-            totalAmount1: context.totalAmount1,
-            lastExecutionTime,
-        };
     }
     redactError(error) {
         const message = error instanceof Error ? error.message : String(error);

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,5 +1,5 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
-import type { VaultExecutionContext } from '@steerprotocol/sdk';
+import { type ExecutionContext } from '../types.js';
 import { ExecutionBase } from './executionBase.js';
 export declare class DataConnectorExecution extends ExecutionBase {
     private dataConnectors;
@@ -10,7 +10,7 @@ export declare class DataConnectorExecution extends ExecutionBase {
      * Chain reads receive its exact blockNumber; HTTP and subgraph responses are
      * intentionally not represented as block-pinned data.
      */
-    executeWithContext<T>(_vaultConfig: string, context: VaultExecutionContext): Promise<Array<T>>;
+    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

@@ -68,10 +68,23 @@ class DataConnectorExecution extends executionBase_js_1.ExecutionBase {
      * 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 || !/^\d+$/.test(context.blockNumber) || !/^\d+$/.test(context.epochTimestamp)) {
-                throw new Error('INVALID_EXECUTION_CONTEXT: supplied SDK execution context is malformed.');
+            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.');
@@ -80,17 +93,13 @@ class DataConnectorExecution extends executionBase_js_1.ExecutionBase {
             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) !== context.blockNumber) {
+            if (vaultConfig.anchorBlockNumber !== undefined &&
+                String(vaultConfig.anchorBlockNumber) !== String(context.blockNumber)) {
                 throw new Error('EXECUTION_CONTEXT_MISMATCH: supplied context block does not match anchorBlockNumber.');
             }
-            const executionContext = {
-                executionTimestamp: Number(context.epochTimestamp) * 1000,
-                epochTimestamp: Number(context.epochTimestamp),
-                epochLength: Number(vaultConfig.strategyConfigData.epochLength),
-                vaultAddress: context.vaultAddress,
-                blockTime: 0,
-                blockNumber: Number(context.blockNumber),
-            };
+            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) {
@@ -98,7 +107,7 @@ class DataConnectorExecution extends executionBase_js_1.ExecutionBase {
                 }
                 if (!dataConnector.module)
                     yield dataConnector.load();
-                dataConnector.setExecutionContextDataConnectorPinned(executionContext);
+                dataConnector.initializeDataConnectorWithContext(context);
                 yield dataConnector.execute();
                 transformationData.push(JSON.parse(yield dataConnector.transform()));
             }

package/lib/package.json

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

package/lib/types.d.ts

@@ -1,5 +1,4 @@
 import type { ethers, InterfaceAbi } from 'ethers';
-import type { VaultExecutionContext } from '@steerprotocol/sdk';
 /** 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';
@@ -20,8 +19,8 @@ export interface ExecuteWithContextOptions {
     wasmFile: string | ArrayBuffer;
     vaultConfig: string;
     data: Array<unknown>;
-    /** Successful, normalized context returned by @steerprotocol/sdk 3.3+. */
-    executionContext: VaultExecutionContext;
+    /** Resolved strategy execution context. */
+    executionContext: SmartPoolExecutionContext;
     identity?: ethers.Provider;
     etherRpcConfig?: EtherRpcConfig;
     forceDeposit?: boolean;
@@ -77,6 +76,7 @@ export interface ConfigData {
     [key: string]: string | number;
 }
 export interface ExecutionContext {
+    chainId: number;
     executionTimestamp: number;
     epochLength: number;
     vaultAddress: string;
@@ -84,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;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerprotocol/data-connector-loader",
-  "version": "4.1.0",
+  "version": "5.0.0-next.2",
   "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",
@@ -54,7 +54,12 @@
   "homepage": "https://github.com/SteerProtocol/data-connector-loader#readme",
   "release": {
     "branches": [
-      "main"
+      "main",
+      {
+        "name": "next",
+        "prerelease": "next",
+        "channel": "next"
+      }
     ],
     "plugins": [
       [
@@ -97,7 +102,6 @@
   ],
   "dependencies": {
     "@steerprotocol/app-loader": "^3.0.6",
-    "@steerprotocol/sdk": "^3.3.0",
     "@steerprotocol/strategy-utils": "^3.1.2",
     "axios": "^1.3.4",
     "ethers": "^6.16.0",