@steerprotocol/data-connector-loader 4.0.2 → 4.1.0

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,38 @@ pnpm add @steerprotocol/data-connector-loader
 ## ESM Support
 
 This package publishes both CommonJS and ESM entrypoints via `exports`.
+
+## 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.
+
+```ts
+import { ExecutionApp } from '@steerprotocol/data-connector-loader';
+import { getVaultExecutionContext } from '@steerprotocol/sdk';
+
+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({
+  wasmFile: strategyWasmBytes,
+  vaultConfig: JSON.stringify({ vaultAddress, anchorBlockNumber: Number(blockNumber), strategyConfigData: { epochLength: '3600' } }),
+  data: connectorOutputs,
+  executionContext: response.data,
+});
+```
+
+`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`
+(`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

@@ -25,7 +25,14 @@ export declare class BundleBase {
     executeDynamicJobBundle(data: Array<any>): Promise<string>;
     reset(): void;
     setExecutionContextStrategyExecution(executionContext: ExecutionContext, 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;
+    /** Initializes a data connector with an immutable SDK anchor. */
+    setExecutionContextDataConnectorPinned(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.
+     */
+    setExecutionContextStrategyExecutionPinned(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. */
+    setExecutionContextDataConnectorPinned(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

@@ -25,7 +25,14 @@ export declare class BundleBase {
     executeDynamicJobBundle(data: Array<any>): Promise<string>;
     reset(): void;
     setExecutionContextStrategyExecution(executionContext: ExecutionContext, 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;
+    /** Initializes a data connector with an immutable SDK anchor. */
+    setExecutionContextDataConnectorPinned(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.
+     */
+    setExecutionContextStrategyExecutionPinned(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. */
+    setExecutionContextDataConnectorPinned(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 the immutable context resolved by SDK 3.3+.
+     * 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 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,117 @@ export class ExecutionApp extends ExecutionBase {
         const result = await dataConnector.executeBundle(_data);
         return JSON.parse(result);
     }
+    /**
+     * Executes a strategy against the immutable context resolved by SDK 3.3+.
+     * 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 dataConnector = new DataConnector(options.wasmFile, options.vaultConfig, this.config, options.identity, options.etherRpcConfig);
+        try {
+            await dataConnector.loadSync();
+            dataConnector.setExecutionContextStrategyExecutionPinned(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.');
+        }
+    }
+    mapSdkExecutionContext(context, vaultConfig) {
+        if (!context || typeof context !== 'object') {
+            throw new ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'A successful SDK VaultExecutionContext 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) ||
+            !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.');
+        }
+        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) !== 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.');
+        }
+        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.');
+            }
+        }
+        // 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);
+        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/executionDataConnector.d.ts

@@ -1,9 +1,16 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
+import type { VaultExecutionContext } from '@steerprotocol/sdk';
 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: VaultExecutionContext): 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,47 @@ 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 || !/^\d+$/.test(context.blockNumber) || !/^\d+$/.test(context.epochTimestamp)) {
+            throw new Error('INVALID_EXECUTION_CONTEXT: supplied SDK 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) !== 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),
+        };
+        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.setExecutionContextDataConnectorPinned(executionContext);
+            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 +130,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,31 @@
-import type { InterfaceAbi } from 'ethers';
+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';
+    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>;
+    /** Successful, normalized context returned by @steerprotocol/sdk 3.3+. */
+    executionContext: VaultExecutionContext;
+    identity?: ethers.Provider;
+    etherRpcConfig?: EtherRpcConfig;
+    forceDeposit?: boolean;
+}
 export type VaultInput = {
     _id?: string;
     tokenId: string;
@@ -100,6 +127,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.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 the immutable context resolved by SDK 3.3+.
+     * 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 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,120 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             return JSON.parse(result);
         });
     }
+    /**
+     * Executes a strategy against the immutable context resolved by SDK 3.3+.
+     * 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 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);
+                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.');
+        }
+    }
+    mapSdkExecutionContext(context, vaultConfig) {
+        var _a;
+        if (!context || typeof context !== 'object') {
+            throw new types_js_1.ExecutionContextError('INVALID_EXECUTION_CONTEXT', 'A successful SDK VaultExecutionContext 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) ||
+            !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.');
+        }
+        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) !== 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.');
+        }
+        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.');
+            }
+        }
+        // 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);
+        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/executionDataConnector.d.ts

@@ -1,9 +1,16 @@
 import type { DataConnector } from '../bundle/bundleDataConnector.js';
+import type { VaultExecutionContext } from '@steerprotocol/sdk';
 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: VaultExecutionContext): 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,49 @@ 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) {
+        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.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) !== 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),
+            };
+            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.setExecutionContextDataConnectorPinned(executionContext);
+                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 +148,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/types.d.ts

@@ -1,4 +1,31 @@
-import type { InterfaceAbi } from 'ethers';
+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';
+    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>;
+    /** Successful, normalized context returned by @steerprotocol/sdk 3.3+. */
+    executionContext: VaultExecutionContext;
+    identity?: ethers.Provider;
+    etherRpcConfig?: EtherRpcConfig;
+    forceDeposit?: boolean;
+}
 export type VaultInput = {
     _id?: string;
     tokenId: string;
@@ -100,6 +127,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.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.2",
+  "version": "4.1.0",
   "description": "App Loader for Steer Protocol",
   "type": "module",
   "main": "lib/index.js",
@@ -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",
@@ -82,10 +83,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 +90,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.4",
-    "@steerprotocol/sdk": "^2.0.0",
+    "@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",