@steerprotocol/data-connector-loader 5.0.0-next.6 → 5.0.0-next.7

package/README.md

@@ -48,6 +48,20 @@ a fresh temporary directory while reusing npm's download cache.
 ## Block-pinned strategy execution (recommended)
 
 Supply a resolved `SmartPoolExecutionContext` to `ExecutionApp.executeWithContext`.
+Strategy entrypoints return the exact string `"continue"` when no action is needed,
+or the decoded JSON result. Their generic `T` describes the complete JSON result
+(an action object or array), and the return type is `Promise<T | "continue">`.
+All other non-JSON output is rejected as `StrategyExecutionError`.
+
+The offline `strategyWasm.integration.test.ts` suite runs retained Liquid Arc and
+Static Stable binaries through the loader, covering both `continue` and JSON
+actions with supplied contexts. It checks binary hashes and runs with `npm test`
+in CI. To run just these cases:
+
+```sh
+npm test -- --runInBand strategyWasm.integration.test.ts
+```
+
 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

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

@@ -41,18 +41,20 @@ export declare class ExecutionApp extends ExecutionBase {
     sentioApiKey: string;
     config: ExecutionAppConfig;
     constructor(config: ExecutionAppConfig);
-    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
+    execute<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
     /**
      * 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>>;
+    executeWithContext<T = unknown>(options: ExecuteWithContextOptions): Promise<T | "continue">;
+    /** T is the complete decoded JSON result. Only the exact sentinel skips JSON decoding. */
+    private parseStrategyResult;
     private parseVaultConfig;
     private validateExecutionContext;
     private redactError;
-    executeStabilityVault<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
-    executeDynamicJobs<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _job: JobDetails, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
+    executeStabilityVault<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
+    executeDynamicJobs<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _job: JobDetails, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
     private getSmartPoolExecutionContext;
     private getPoolCurrentTick;
     private getTickSpacing;

package/lib/esm/execution/executionApp.js

@@ -484,7 +484,7 @@ export class ExecutionApp extends ExecutionBase {
         }, forceDeposit);
         _data = _data.map((element) => JSON.stringify(element));
         const result = await dataConnector.executeBundle(_data);
-        return JSON.parse(result);
+        return this.parseStrategyResult(result);
     }
     /**
      * Executes a strategy against a supplied execution context.
@@ -509,7 +509,7 @@ export class ExecutionApp extends ExecutionBase {
             await dataConnector.loadSync();
             dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
             const result = await dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
-            return JSON.parse(result);
+            return this.parseStrategyResult(result);
         }
         catch (error) {
             if (error instanceof ExecutionContextError)
@@ -517,6 +517,17 @@ export class ExecutionApp extends ExecutionBase {
             throw new StrategyExecutionError(this.redactError(error));
         }
     }
+    /** T is the complete decoded JSON result. Only the exact sentinel skips JSON decoding. */
+    parseStrategyResult(result) {
+        if (result === "continue")
+            return result;
+        try {
+            return JSON.parse(result);
+        }
+        catch (error) {
+            throw new StrategyExecutionError(this.redactError(error));
+        }
+    }
     parseVaultConfig(vaultConfig) {
         try {
             return JSON.parse(vaultConfig);
@@ -601,7 +612,7 @@ export class ExecutionApp extends ExecutionBase {
         }, forceDeposit);
         _data = _data.map((element) => JSON.stringify(element));
         const result = await dataConnector.executeDynamicJobBundle(_data);
-        return JSON.parse(result);
+        return this.parseStrategyResult(result);
     }
     async executeDynamicJobs(_wasmFile, _vaultConfig, _data, _job, rpc, forceDeposit) {
         const dataConnector = new DataConnector({
@@ -625,7 +636,7 @@ export class ExecutionApp extends ExecutionBase {
         }, forceDeposit);
         _data = _data.map((element) => JSON.stringify(element));
         const result = await dataConnector.executeDynamicJobBundle(_data);
-        return JSON.parse(result);
+        return this.parseStrategyResult(result);
     }
     async getSmartPoolExecutionContext(currentExecutionContext, dataConnector, vaultConfig) {
         const smartPoolExecutionContext = {};

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

@@ -7,7 +7,7 @@ export declare class ExecutionBase {
     protected delay(ms: number): Promise<void>;
     protected log(...args: Array<any>): void;
     protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<ExecutionContext>;
-    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess): Promise<Array<T>>;
+    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess): Promise<T | Array<T> | "continue">;
     protected getDataConnectorVersion(dataConnector: DataConnector): Promise<number>;
     getAverageBlockTime(provider: PublicClient, blockCount?: number): Promise<number>;
     getBlockNumberFromAvgBlockTime(provider: PublicClient, targetTimestamp: number, avgBlockTime: number): Promise<number>;

package/lib/execution/executionApp.d.ts

@@ -41,18 +41,20 @@ export declare class ExecutionApp extends ExecutionBase {
     sentioApiKey: string;
     config: ExecutionAppConfig;
     constructor(config: ExecutionAppConfig);
-    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
+    execute<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
     /**
      * 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>>;
+    executeWithContext<T = unknown>(options: ExecuteWithContextOptions): Promise<T | "continue">;
+    /** T is the complete decoded JSON result. Only the exact sentinel skips JSON decoding. */
+    private parseStrategyResult;
     private parseVaultConfig;
     private validateExecutionContext;
     private redactError;
-    executeStabilityVault<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
-    executeDynamicJobs<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _job: JobDetails, rpc?: RpcAccess, forceDeposit?: boolean): Promise<Array<T>>;
+    executeStabilityVault<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
+    executeDynamicJobs<T = unknown>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, _job: JobDetails, rpc?: RpcAccess, forceDeposit?: boolean): Promise<T | "continue">;
     private getSmartPoolExecutionContext;
     private getPoolCurrentTick;
     private getTickSpacing;

package/lib/execution/executionApp.js

@@ -495,7 +495,7 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             dataConnector.setExecutionContextStrategyExecution(Object.assign(Object.assign({}, executionContext), smartPoolExecutionContext), forceDeposit);
             _data = _data.map((element) => JSON.stringify(element));
             const result = yield dataConnector.executeBundle(_data);
-            return JSON.parse(result);
+            return this.parseStrategyResult(result);
         });
     }
     /**
@@ -517,7 +517,7 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
                 yield dataConnector.loadSync();
                 dataConnector.initializeStrategyWithContext(executionContext, options.forceDeposit);
                 const result = yield dataConnector.executeBundle(options.data.map((item) => JSON.stringify(item)));
-                return JSON.parse(result);
+                return this.parseStrategyResult(result);
             }
             catch (error) {
                 if (error instanceof types_js_1.ExecutionContextError)
@@ -526,6 +526,17 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             }
         });
     }
+    /** T is the complete decoded JSON result. Only the exact sentinel skips JSON decoding. */
+    parseStrategyResult(result) {
+        if (result === "continue")
+            return result;
+        try {
+            return JSON.parse(result);
+        }
+        catch (error) {
+            throw new types_js_1.StrategyExecutionError(this.redactError(error));
+        }
+    }
     parseVaultConfig(vaultConfig) {
         try {
             return JSON.parse(vaultConfig);
@@ -609,7 +620,7 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             dataConnector.setExecutionContextStrategyExecution(Object.assign(Object.assign({}, executionContext), dynamicJobExecutionContext), forceDeposit);
             _data = _data.map((element) => JSON.stringify(element));
             const result = yield dataConnector.executeDynamicJobBundle(_data);
-            return JSON.parse(result);
+            return this.parseStrategyResult(result);
         });
     }
     executeDynamicJobs(_wasmFile, _vaultConfig, _data, _job, rpc, forceDeposit) {
@@ -632,7 +643,7 @@ class ExecutionApp extends executionBase_js_1.ExecutionBase {
             dataConnector.setExecutionContextStrategyExecution(Object.assign(Object.assign({}, executionContext), dynamicJobExecutionContext), forceDeposit);
             _data = _data.map((element) => JSON.stringify(element));
             const result = yield dataConnector.executeDynamicJobBundle(_data);
-            return JSON.parse(result);
+            return this.parseStrategyResult(result);
         });
     }
     getSmartPoolExecutionContext(currentExecutionContext, dataConnector, vaultConfig) {

package/lib/execution/executionBase.d.ts

@@ -7,7 +7,7 @@ export declare class ExecutionBase {
     protected delay(ms: number): Promise<void>;
     protected log(...args: Array<any>): void;
     protected getExecutionContext(dataConnector: DataConnector, vaultConfig: VaultConfigPayload): Promise<ExecutionContext>;
-    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess): Promise<Array<T>>;
+    execute<T>(_wasmFile: string | ArrayBuffer, _vaultConfig: string, _data: Array<any>, rpc?: RpcAccess): Promise<T | Array<T> | "continue">;
     protected getDataConnectorVersion(dataConnector: DataConnector): Promise<number>;
     getAverageBlockTime(provider: PublicClient, blockCount?: number): Promise<number>;
     getBlockNumberFromAvgBlockTime(provider: PublicClient, targetTimestamp: number, avgBlockTime: number): Promise<number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerprotocol/data-connector-loader",
-  "version": "5.0.0-next.6",
+  "version": "5.0.0-next.7",
   "description": "App Loader for Steer Protocol",
   "type": "module",
   "main": "lib/index.js",