@chainlink/cre-sdk 1.16.0 → 1.17.0-alpha.1

package/dist/sdk/test/generated/capabilities/blockchain/solana/v1alpha/solana_mock_gen.d.ts

@@ -1,10 +1,28 @@
-import { type WriteReportReply, type WriteReportReplyJson, type WriteReportRequest } from '../../../../../../../generated/capabilities/blockchain/solana/v1alpha/client_pb';
+import { type GetAccountInfoWithOptsReply, type GetAccountInfoWithOptsReplyJson, type GetAccountInfoWithOptsRequest, type GetBalanceReply, type GetBalanceReplyJson, type GetBalanceRequest, type GetBlockReply, type GetBlockReplyJson, type GetBlockRequest, type GetFeeForMessageReply, type GetFeeForMessageReplyJson, type GetFeeForMessageRequest, type GetMultipleAccountsWithOptsReply, type GetMultipleAccountsWithOptsReplyJson, type GetMultipleAccountsWithOptsRequest, type GetProgramAccountsReply, type GetProgramAccountsReplyJson, type GetProgramAccountsRequest, type GetSignatureStatusesReply, type GetSignatureStatusesReplyJson, type GetSignatureStatusesRequest, type GetSlotHeightReply, type GetSlotHeightReplyJson, type GetSlotHeightRequest, type GetTransactionReply, type GetTransactionReplyJson, type GetTransactionRequest, type WriteReportReply, type WriteReportReplyJson, type WriteReportRequest } from '../../../../../../../generated/capabilities/blockchain/solana/v1alpha/client_pb';
 /**
  * Mock for ClientCapability. Use testInstance() to obtain an instance; do not construct directly.
  * Set per-method properties (e.g. performAction) to define return values. If a method is invoked without a handler set, an error is thrown.
  */
 export declare class SolanaMock {
     static readonly CAPABILITY_ID = "solana@1.0.0";
+    /** Set to define the return value for GetAccountInfoWithOpts. May return a plain object (GetAccountInfoWithOptsReplyJson) or the message type. */
+    getAccountInfoWithOpts?: (input: GetAccountInfoWithOptsRequest) => GetAccountInfoWithOptsReply | GetAccountInfoWithOptsReplyJson;
+    /** Set to define the return value for GetBalance. May return a plain object (GetBalanceReplyJson) or the message type. */
+    getBalance?: (input: GetBalanceRequest) => GetBalanceReply | GetBalanceReplyJson;
+    /** Set to define the return value for GetBlock. May return a plain object (GetBlockReplyJson) or the message type. */
+    getBlock?: (input: GetBlockRequest) => GetBlockReply | GetBlockReplyJson;
+    /** Set to define the return value for GetFeeForMessage. May return a plain object (GetFeeForMessageReplyJson) or the message type. */
+    getFeeForMessage?: (input: GetFeeForMessageRequest) => GetFeeForMessageReply | GetFeeForMessageReplyJson;
+    /** Set to define the return value for GetMultipleAccountsWithOpts. May return a plain object (GetMultipleAccountsWithOptsReplyJson) or the message type. */
+    getMultipleAccountsWithOpts?: (input: GetMultipleAccountsWithOptsRequest) => GetMultipleAccountsWithOptsReply | GetMultipleAccountsWithOptsReplyJson;
+    /** Set to define the return value for GetProgramAccounts. May return a plain object (GetProgramAccountsReplyJson) or the message type. */
+    getProgramAccounts?: (input: GetProgramAccountsRequest) => GetProgramAccountsReply | GetProgramAccountsReplyJson;
+    /** Set to define the return value for GetSignatureStatuses. May return a plain object (GetSignatureStatusesReplyJson) or the message type. */
+    getSignatureStatuses?: (input: GetSignatureStatusesRequest) => GetSignatureStatusesReply | GetSignatureStatusesReplyJson;
+    /** Set to define the return value for GetSlotHeight. May return a plain object (GetSlotHeightReplyJson) or the message type. */
+    getSlotHeight?: (input: GetSlotHeightRequest) => GetSlotHeightReply | GetSlotHeightReplyJson;
+    /** Set to define the return value for GetTransaction. May return a plain object (GetTransactionReplyJson) or the message type. */
+    getTransaction?: (input: GetTransactionRequest) => GetTransactionReply | GetTransactionReplyJson;
     /** Set to define the return value for WriteReport. May return a plain object (WriteReportReplyJson) or the message type. */
     writeReport?: (input: WriteReportRequest) => WriteReportReply | WriteReportReplyJson;
     private constructor();

package/dist/sdk/test/generated/capabilities/blockchain/solana/v1alpha/solana_mock_gen.js

@@ -1,6 +1,6 @@
 import { fromJson } from '@bufbuild/protobuf';
 import { anyPack, anyUnpack } from '@bufbuild/protobuf/wkt';
-import { WriteReportReplySchema, WriteReportRequestSchema, } from '../../../../../../../generated/capabilities/blockchain/solana/v1alpha/client_pb';
+import { GetAccountInfoWithOptsReplySchema, GetAccountInfoWithOptsRequestSchema, GetBalanceReplySchema, GetBalanceRequestSchema, GetBlockReplySchema, GetBlockRequestSchema, GetFeeForMessageReplySchema, GetFeeForMessageRequestSchema, GetMultipleAccountsWithOptsReplySchema, GetMultipleAccountsWithOptsRequestSchema, GetProgramAccountsReplySchema, GetProgramAccountsRequestSchema, GetSignatureStatusesReplySchema, GetSignatureStatusesRequestSchema, GetSlotHeightReplySchema, GetSlotHeightRequestSchema, GetTransactionReplySchema, GetTransactionRequestSchema, WriteReportReplySchema, WriteReportRequestSchema, } from '../../../../../../../generated/capabilities/blockchain/solana/v1alpha/client_pb';
 import { __getTestMockInstance, __setTestMockInstance, registerTestCapability, } from '../../../../../../testutils/test-runtime';
 /**
  * Mock for ClientCapability. Use testInstance() to obtain an instance; do not construct directly.
@@ -8,6 +8,24 @@ import { __getTestMockInstance, __setTestMockInstance, registerTestCapability, }
  */
 export class SolanaMock {
     static CAPABILITY_ID = 'solana@1.0.0';
+    /** Set to define the return value for GetAccountInfoWithOpts. May return a plain object (GetAccountInfoWithOptsReplyJson) or the message type. */
+    getAccountInfoWithOpts;
+    /** Set to define the return value for GetBalance. May return a plain object (GetBalanceReplyJson) or the message type. */
+    getBalance;
+    /** Set to define the return value for GetBlock. May return a plain object (GetBlockReplyJson) or the message type. */
+    getBlock;
+    /** Set to define the return value for GetFeeForMessage. May return a plain object (GetFeeForMessageReplyJson) or the message type. */
+    getFeeForMessage;
+    /** Set to define the return value for GetMultipleAccountsWithOpts. May return a plain object (GetMultipleAccountsWithOptsReplyJson) or the message type. */
+    getMultipleAccountsWithOpts;
+    /** Set to define the return value for GetProgramAccounts. May return a plain object (GetProgramAccountsReplyJson) or the message type. */
+    getProgramAccounts;
+    /** Set to define the return value for GetSignatureStatuses. May return a plain object (GetSignatureStatusesReplyJson) or the message type. */
+    getSignatureStatuses;
+    /** Set to define the return value for GetSlotHeight. May return a plain object (GetSlotHeightReplyJson) or the message type. */
+    getSlotHeight;
+    /** Set to define the return value for GetTransaction. May return a plain object (GetTransactionReplyJson) or the message type. */
+    getTransaction;
     /** Set to define the return value for WriteReport. May return a plain object (WriteReportReplyJson) or the message type. */
     writeReport;
     constructor(chainSelector) {
@@ -16,6 +34,128 @@ export class SolanaMock {
         try {
             registerTestCapability(qualifiedId, (req) => {
                 switch (req.method) {
+                    case 'GetAccountInfoWithOpts': {
+                        const input = anyUnpack(req.payload, GetAccountInfoWithOptsRequestSchema);
+                        const handler = self.getAccountInfoWithOpts;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetAccountInfoWithOpts: no implementation provided; set the mock's getAccountInfoWithOpts property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetAccountInfoWithOptsReplySchema, raw);
+                        return {
+                            response: {
+                                case: 'payload',
+                                value: anyPack(GetAccountInfoWithOptsReplySchema, output),
+                            },
+                        };
+                    }
+                    case 'GetBalance': {
+                        const input = anyUnpack(req.payload, GetBalanceRequestSchema);
+                        const handler = self.getBalance;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetBalance: no implementation provided; set the mock's getBalance property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetBalanceReplySchema, raw);
+                        return { response: { case: 'payload', value: anyPack(GetBalanceReplySchema, output) } };
+                    }
+                    case 'GetBlock': {
+                        const input = anyUnpack(req.payload, GetBlockRequestSchema);
+                        const handler = self.getBlock;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetBlock: no implementation provided; set the mock's getBlock property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetBlockReplySchema, raw);
+                        return { response: { case: 'payload', value: anyPack(GetBlockReplySchema, output) } };
+                    }
+                    case 'GetFeeForMessage': {
+                        const input = anyUnpack(req.payload, GetFeeForMessageRequestSchema);
+                        const handler = self.getFeeForMessage;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetFeeForMessage: no implementation provided; set the mock's getFeeForMessage property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetFeeForMessageReplySchema, raw);
+                        return {
+                            response: { case: 'payload', value: anyPack(GetFeeForMessageReplySchema, output) },
+                        };
+                    }
+                    case 'GetMultipleAccountsWithOpts': {
+                        const input = anyUnpack(req.payload, GetMultipleAccountsWithOptsRequestSchema);
+                        const handler = self.getMultipleAccountsWithOpts;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetMultipleAccountsWithOpts: no implementation provided; set the mock's getMultipleAccountsWithOpts property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetMultipleAccountsWithOptsReplySchema, raw);
+                        return {
+                            response: {
+                                case: 'payload',
+                                value: anyPack(GetMultipleAccountsWithOptsReplySchema, output),
+                            },
+                        };
+                    }
+                    case 'GetProgramAccounts': {
+                        const input = anyUnpack(req.payload, GetProgramAccountsRequestSchema);
+                        const handler = self.getProgramAccounts;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetProgramAccounts: no implementation provided; set the mock's getProgramAccounts property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetProgramAccountsReplySchema, raw);
+                        return {
+                            response: { case: 'payload', value: anyPack(GetProgramAccountsReplySchema, output) },
+                        };
+                    }
+                    case 'GetSignatureStatuses': {
+                        const input = anyUnpack(req.payload, GetSignatureStatusesRequestSchema);
+                        const handler = self.getSignatureStatuses;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetSignatureStatuses: no implementation provided; set the mock's getSignatureStatuses property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetSignatureStatusesReplySchema, raw);
+                        return {
+                            response: {
+                                case: 'payload',
+                                value: anyPack(GetSignatureStatusesReplySchema, output),
+                            },
+                        };
+                    }
+                    case 'GetSlotHeight': {
+                        const input = anyUnpack(req.payload, GetSlotHeightRequestSchema);
+                        const handler = self.getSlotHeight;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetSlotHeight: no implementation provided; set the mock's getSlotHeight property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetSlotHeightReplySchema, raw);
+                        return {
+                            response: { case: 'payload', value: anyPack(GetSlotHeightReplySchema, output) },
+                        };
+                    }
+                    case 'GetTransaction': {
+                        const input = anyUnpack(req.payload, GetTransactionRequestSchema);
+                        const handler = self.getTransaction;
+                        if (typeof handler !== 'function')
+                            throw new Error("GetTransaction: no implementation provided; set the mock's getTransaction property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(GetTransactionReplySchema, raw);
+                        return {
+                            response: { case: 'payload', value: anyPack(GetTransactionReplySchema, output) },
+                        };
+                    }
                     case 'WriteReport': {
                         const input = anyUnpack(req.payload, WriteReportRequestSchema);
                         const handler = self.writeReport;

package/dist/sdk/test/generated/index.d.ts

@@ -1,4 +1,5 @@
 /** Auto-generated barrel of capability mocks. Do not edit. */
+export { AptosMock } from './capabilities/blockchain/aptos/v1alpha/aptos_mock_gen';
 export { EvmMock } from './capabilities/blockchain/evm/v1alpha/evm_mock_gen';
 export { SolanaMock } from './capabilities/blockchain/solana/v1alpha/solana_mock_gen';
 export { BasicTestActionTriggerMock } from './capabilities/internal/actionandtrigger/v1/basic_test_action_trigger_mock_gen';

package/dist/sdk/test/generated/index.js

@@ -1,4 +1,5 @@
 /** Auto-generated barrel of capability mocks. Do not edit. */
+export { AptosMock } from './capabilities/blockchain/aptos/v1alpha/aptos_mock_gen';
 export { EvmMock } from './capabilities/blockchain/evm/v1alpha/evm_mock_gen';
 export { SolanaMock } from './capabilities/blockchain/solana/v1alpha/solana_mock_gen';
 export { BasicTestActionTriggerMock } from './capabilities/internal/actionandtrigger/v1/basic_test_action_trigger_mock_gen';

package/dist/sdk/test/index.d.ts

@@ -6,4 +6,3 @@ export { type CapabilityHandler, DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabil
 export { TestWriter } from '../testutils/test-writer';
 export { type AddContractMockOptions, addContractMock, type ContractMock, type WriteReportMockInput, } from './evm-contract-mock';
 export * from './generated';
-export { type AddSolanaContractMockOptions, addSolanaContractMock, type SolanaContractMock, type SolanaWriteReportMockInput, } from './solana-contract-mock';

package/dist/sdk/test/index.js

@@ -6,4 +6,3 @@ export { DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, newTestRunti
 export { TestWriter } from '../testutils/test-writer';
 export { addContractMock, } from './evm-contract-mock';
 export * from './generated';
-export { addSolanaContractMock, } from './solana-contract-mock';

package/dist/sdk/testutils/index.d.ts

@@ -2,5 +2,5 @@
  * Test-only utilities for the CRE SDK runtime. Not part of the public API.
  * Use for unit testing runtime logic without the WASM execution environment.
  */
-export { type CapabilityHandler, DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, type NewTestRuntimeOptions, newTestRuntime, REPORT_METADATA_HEADER_LENGTH, RESPONSE_BUFFER_TOO_SMALL, registerTestCapability, type Secrets, TestRuntime, type TestRuntimeState, test, } from './test-runtime';
+export { type CapabilityHandler, DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, type NewTestRuntimeOptions, newTestRuntime, REPORT_METADATA_HEADER_LENGTH, RESPONSE_BUFFER_TOO_SMALL, registerTestCapability, type Secrets, TestRuntime, type TestRuntimeState, TestTeeRuntime, test, } from './test-runtime';
 export { TestWriter } from './test-writer';

package/dist/sdk/testutils/index.js

@@ -2,5 +2,5 @@
  * Test-only utilities for the CRE SDK runtime. Not part of the public API.
  * Use for unit testing runtime logic without the WASM execution environment.
  */
-export { DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, newTestRuntime, REPORT_METADATA_HEADER_LENGTH, RESPONSE_BUFFER_TOO_SMALL, registerTestCapability, TestRuntime, test, } from './test-runtime';
+export { DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, newTestRuntime, REPORT_METADATA_HEADER_LENGTH, RESPONSE_BUFFER_TOO_SMALL, registerTestCapability, TestRuntime, TestTeeRuntime, test, } from './test-runtime';
 export { TestWriter } from './test-writer';

package/dist/sdk/testutils/test-runtime.d.ts

@@ -3,8 +3,9 @@
  * Registry is scoped per test via AsyncLocalStorage; use testWithRuntime to run tests with a registry.
  */
 import type { Any } from '@bufbuild/protobuf/wkt';
+import type { WorkflowUserMetric } from '../../generated/workflows/v2/workflow_user_metric_pb';
 import type { RuntimeHelpers } from '../impl/runtime-impl';
-import { RuntimeImpl } from '../impl/runtime-impl';
+import { RuntimeImpl, TeeRuntimeImpl } from '../impl/runtime-impl';
 import { TestWriter } from './test-writer';
 /** Error message when response exceeds max size. Used by the harness when its await implements the size check. */
 export declare const RESPONSE_BUFFER_TOO_SMALL = "response buffer too small";
@@ -70,15 +71,27 @@ export declare function test(title: string, fn: () => void | Promise<void>): voi
 /**
  * Creates a test runtime. This must be called from within a test in this package.
  */
-export declare function newTestRuntime(secrets?: Secrets | null, options?: NewTestRuntimeOptions): TestRuntime;
+export declare function newTestRuntime<T = unknown>(secrets?: Secrets | null, options?: NewTestRuntimeOptions, config?: T | undefined): TestRuntime<T>;
 /**
  * TestRuntime is a Runtime implementation for unit tests. Extends RuntimeImpl; construct via newTestRuntime.
  * Adds getLogs() and setTimeProvider(). Registry is accessed via getTestCapabilityHandler when inside testWithRuntime.
  */
-export declare class TestRuntime extends RuntimeImpl<unknown> {
+export declare class TestRuntime<T> extends RuntimeImpl<T> {
     private readonly testWriter;
     private readonly state;
-    constructor(helpers: RuntimeHelpers, maxResponseSize: bigint, testWriter: TestWriter, state: TestRuntimeState);
+    constructor(helpers: RuntimeHelpers, maxResponseSize: bigint, testWriter: TestWriter, state: TestRuntimeState, config?: T | undefined);
     getLogs(): string[];
     setTimeProvider(timeProvider: () => number): void;
 }
+/**
+ * TestTeeRuntime is a TeeRuntime implementation for unit tests. Extends TeeRuntimeImpl; construct via newTestTEERuntime.
+ * Adds getLogs() and setTimeProvider(). Registry is accessed via getTestCapabilityHandler when inside testWithRuntime.
+ */
+export declare class TestTeeRuntime<T> extends TeeRuntimeImpl<T> {
+    private readonly testWriter;
+    private readonly state;
+    constructor(helpers: RuntimeHelpers, maxResponseSize: bigint, testWriter: TestWriter, state: TestRuntimeState, config: T);
+    getLogs(): string[];
+    getMetrics(): WorkflowUserMetric[];
+    setTimeProvider(timeProvider: () => number): void;
+}

package/dist/sdk/testutils/test-runtime.js

@@ -8,7 +8,7 @@ import { create, toBinary } from '@bufbuild/protobuf';
 import { anyPack, anyUnpack } from '@bufbuild/protobuf/wkt';
 import { AttributedSignatureSchema, AwaitCapabilitiesResponseSchema, AwaitSecretsResponseSchema, CapabilityResponseSchema, ReportRequestSchema, ReportResponseSchema, SecretErrorSchema, SecretResponseSchema, SecretResponsesSchema, SecretSchema, SimpleConsensusInputsSchema, } from '../../generated/sdk/v1alpha/sdk_pb';
 import { ValueSchema } from '../../generated/values/v1/values_pb';
-import { RuntimeImpl } from '../impl/runtime-impl';
+import { RuntimeImpl, TeeRuntimeImpl } from '../impl/runtime-impl';
 import { TestWriter } from './test-writer';
 /** Error message when response exceeds max size. Used by the harness when its await implements the size check. */
 export const RESPONSE_BUFFER_TOO_SMALL = 'response buffer too small';
@@ -239,6 +239,10 @@ function createTestRuntimeHelpers(registry, secrets, testWriter, state, _maxResp
         log(message) {
             testWriter.log(message);
         },
+        emitMetric(payload) {
+            testWriter.emitMetric(payload);
+            return true;
+        },
     };
 }
 /**
@@ -258,7 +262,7 @@ export function test(title, fn) {
 /**
  * Creates a test runtime. This must be called from within a test in this package.
  */
-export function newTestRuntime(secrets, options = {}) {
+export function newTestRuntime(secrets, options = {}, config = undefined) {
     const secretsMap = secrets ?? new Map();
     const testWriter = new TestWriter();
     const registry = registryStorage.getStore() ?? new Registry();
@@ -297,7 +301,7 @@ export function newTestRuntime(secrets, options = {}) {
     }
     const maxResponseSize = BigInt(configuredMaxResponseSize);
     const helpers = createTestRuntimeHelpers(registry, secretsMap, testWriter, state, maxResponseSize);
-    return new TestRuntime(helpers, maxResponseSize, testWriter, state);
+    return new TestRuntime(helpers, maxResponseSize, testWriter, state, config);
 }
 /**
  * TestRuntime is a Runtime implementation for unit tests. Extends RuntimeImpl; construct via newTestRuntime.
@@ -306,14 +310,36 @@ export function newTestRuntime(secrets, options = {}) {
 export class TestRuntime extends RuntimeImpl {
     testWriter;
     state;
-    constructor(helpers, maxResponseSize, testWriter, state) {
-        super({}, 0, helpers, maxResponseSize);
+    constructor(helpers, maxResponseSize, testWriter, state, config = undefined) {
+        super(config ?? {}, 0, helpers, maxResponseSize);
+        this.testWriter = testWriter;
+        this.state = state;
+    }
+    getLogs() {
+        return this.testWriter.getLogs();
+    }
+    setTimeProvider(timeProvider) {
+        this.state.timeProvider = timeProvider;
+    }
+}
+/**
+ * TestTeeRuntime is a TeeRuntime implementation for unit tests. Extends TeeRuntimeImpl; construct via newTestTEERuntime.
+ * Adds getLogs() and setTimeProvider(). Registry is accessed via getTestCapabilityHandler when inside testWithRuntime.
+ */
+export class TestTeeRuntime extends TeeRuntimeImpl {
+    testWriter;
+    state;
+    constructor(helpers, maxResponseSize, testWriter, state, config) {
+        super(config, 0, helpers, maxResponseSize);
         this.testWriter = testWriter;
         this.state = state;
     }
     getLogs() {
         return this.testWriter.getLogs();
     }
+    getMetrics() {
+        return this.testWriter.getMetrics();
+    }
     setTimeProvider(timeProvider) {
         this.state.timeProvider = timeProvider;
     }

package/dist/sdk/testutils/test-writer.d.ts

@@ -1,13 +1,19 @@
+import { type WorkflowUserMetric } from '../../generated/workflows/v2/workflow_user_metric_pb';
 /**
  * In-memory log sink for tests. Captures messages so tests can assert on log output.
  * Equivalent to Go's cre/testutils/test_writer.go.
  */
 export declare class TestWriter {
     private logs;
+    private metrics;
     /** Appends a message to the captured log buffer. */
     log(message: string): void;
     /** Returns a copy of all captured log messages in order. */
     getLogs(): string[];
-    /** Clears the captured log buffer. */
+    /** Captures a serialized WorkflowUserMetric payload. */
+    emitMetric(payload: Uint8Array): void;
+    /** Returns captured metric payloads decoded as `WorkflowUserMetric` protos. */
+    getMetrics(): WorkflowUserMetric[];
+    /** Clears captured logs and metrics. */
     clear(): void;
 }

package/dist/sdk/testutils/test-writer.js

@@ -1,9 +1,12 @@
+import { fromBinary } from '@bufbuild/protobuf';
+import { WorkflowUserMetricSchema, } from '../../generated/workflows/v2/workflow_user_metric_pb';
 /**
  * In-memory log sink for tests. Captures messages so tests can assert on log output.
  * Equivalent to Go's cre/testutils/test_writer.go.
  */
 export class TestWriter {
     logs = [];
+    metrics = [];
     /** Appends a message to the captured log buffer. */
     log(message) {
         this.logs.push(message);
@@ -12,8 +15,17 @@ export class TestWriter {
     getLogs() {
         return [...this.logs];
     }
-    /** Clears the captured log buffer. */
+    /** Captures a serialized WorkflowUserMetric payload. */
+    emitMetric(payload) {
+        this.metrics.push(payload);
+    }
+    /** Returns captured metric payloads decoded as `WorkflowUserMetric` protos. */
+    getMetrics() {
+        return this.metrics.map((bytes) => fromBinary(WorkflowUserMetricSchema, bytes));
+    }
+    /** Clears captured logs and metrics. */
     clear() {
         this.logs = [];
+        this.metrics = [];
     }
 }

package/dist/sdk/types/global.d.ts

@@ -45,6 +45,14 @@ declare global {
 	 */
 	function log(message: string): void
 
+	/**
+	 * Emits a user metric to the host. The payload is a protobuf-encoded
+	 * `workflows.v2.WorkflowUserMetric` message.
+	 * @param payload - protobuf-encoded WorkflowUserMetric bytes
+	 * @returns 0 on success, negative on error (rate-limited, oversized, invalid name, etc.)
+	 */
+	function emitMetric(payload: Uint8Array): number
+
 	/**
 	 * Sends a response back to the host
 	 * @param response - bytes response

package/dist/sdk/utils/capabilities/blockchain/{evm/evm-helpers.d.ts → blockchain-helpers.d.ts}

@@ -1,8 +1,7 @@
-import type { CallMsgJson, FilterLogTriggerRequestJson } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
-import type { ReportRequestJson } from '../../../../../generated/sdk/v1alpha/sdk_pb';
-import { type BigInt as GeneratedBigInt } from '../../../../../generated/values/v1/values_pb';
+import type { CallMsgJson, FilterLogTriggerRequestJson } from '../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
+import type { ReportRequestJson } from '../../../../generated/sdk/v1alpha/sdk_pb';
+import { type BigInt as GeneratedBigInt } from '../../../../generated/values/v1/values_pb';
 import type { Address, Hex } from 'viem';
-import { type ReportEncoder } from '../report-helpers';
 /**
  * Protobuf BigInt structure returned by SDK methods (e.g., headerByNumber).
  * Uses Pick to extract just the data fields from the generated type.
@@ -21,7 +20,7 @@ export type ProtoBigInt = Pick<GeneratedBigInt, 'absVal' | 'sign'>;
  * @param n - The native bigint, number, or string value.
  * @returns The protobuf BigInt JSON representation.
  */
-export declare const bigintToProtoBigInt: (n: number | bigint | string) => import("../../../../../generated/values/v1/values_pb").BigIntJson;
+export declare const bigintToProtoBigInt: (n: number | bigint | string) => import("../../../../generated/values/v1/values_pb").BigIntJson;
 /**
  * Converts a protobuf BigInt to a native JS bigint.
  * Use this when extracting bigint values from SDK responses.
@@ -42,7 +41,7 @@ export declare const protoBigIntToBigint: (pb: ProtoBigInt) => bigint;
  * @param n - The block number.
  * @returns The protobuf BigInt JSON representation.
  */
-export declare const blockNumber: (n: number | bigint | string) => import("../../../../../generated/values/v1/values_pb").BigIntJson;
+export declare const blockNumber: (n: number | bigint | string) => import("../../../../generated/values/v1/values_pb").BigIntJson;
 /**
  * EVM Capability Helper.
  *
@@ -107,7 +106,7 @@ export declare const EVM_DEFAULT_REPORT_ENCODER: {
  * @param reportEncoder - The report encoder to be used. Defaults to EVM_DEFAULT_REPORT_ENCODER.
  * @returns The prepared report request.
  */
-export declare const prepareReportRequest: (hexEncodedPayload: Hex, reportEncoder?: ReportEncoder) => ReportRequestJson;
+export declare const prepareReportRequest: (hexEncodedPayload: Hex, reportEncoder?: Omit<ReportRequestJson, "encodedPayload">) => ReportRequestJson;
 export interface LogTriggerConfigOptions {
     /** EVM addresses to monitor — hex strings with 0x prefix (20 bytes each) */
     addresses: Hex[];

package/dist/sdk/utils/capabilities/blockchain/{evm/evm-helpers.js → blockchain-helpers.js}

@@ -1,9 +1,8 @@
 import { create, toJson } from '@bufbuild/protobuf';
-import { BigIntSchema } from '../../../../../generated/values/v1/values_pb';
-import { EVMClient } from '../../../../cre';
-import { bigintToBytes, bytesToBigint, hexToBase64, hexToBytes } from '../../../hex-utils';
-import { assertSafeIntegerNumber } from '../../../safe-integer';
-import { prepareReportRequestFromBytes } from '../report-helpers';
+import { BigIntSchema } from '../../../../generated/values/v1/values_pb';
+import { EVMClient } from '../../../cre';
+import { bigintToBytes, bytesToBigint, hexToBase64, hexToBytes } from '../../hex-utils';
+import { assertSafeIntegerNumber } from '../../safe-integer';
 /**
  * Converts a native JS bigint to a protobuf BigInt JSON representation.
  * Use this when passing bigint values to SDK methods.
@@ -127,7 +126,10 @@ export const EVM_DEFAULT_REPORT_ENCODER = {
  * @param reportEncoder - The report encoder to be used. Defaults to EVM_DEFAULT_REPORT_ENCODER.
  * @returns The prepared report request.
  */
-export const prepareReportRequest = (hexEncodedPayload, reportEncoder = EVM_DEFAULT_REPORT_ENCODER) => prepareReportRequestFromBytes(hexToBytes(hexEncodedPayload), reportEncoder);
+export const prepareReportRequest = (hexEncodedPayload, reportEncoder = EVM_DEFAULT_REPORT_ENCODER) => ({
+    encodedPayload: hexToBase64(hexEncodedPayload),
+    ...reportEncoder,
+});
 /**
  * Validates a hex string and checks that the decoded bytes have the expected length.
  */

package/dist/sdk/utils/hex-utils.d.ts

@@ -13,12 +13,6 @@ export declare const hexToBytes: (hexStr: string) => Uint8Array;
  * Convert Uint8Array to hex string with 0x prefix
  */
 export declare const bytesToHex: (bytes: Uint8Array) => Hex;
-/**
- * Encode raw bytes as base64 string
- * @param bytes
- * @returns
- */
-export declare const bytesToBase64: (bytes: Uint8Array) => string;
 /**
  * Encode hex as base64 string
  * @param hex

package/dist/sdk/utils/hex-utils.js

@@ -28,14 +28,6 @@ export const bytesToHex = (bytes) => {
         .map((b) => b.toString(16).padStart(2, '0'))
         .join('')}`;
 };
-/**
- * Encode raw bytes as base64 string
- * @param bytes
- * @returns
- */
-export const bytesToBase64 = (bytes) => {
-    return Buffer.from(bytes).toString('base64');
-};
 /**
  * Encode hex as base64 string
  * @param hex

package/dist/sdk/utils/index.d.ts

@@ -1,6 +1,4 @@
-export * from './capabilities/blockchain/evm/evm-helpers';
-export type { ReportEncoder } from './capabilities/blockchain/report-helpers';
-export * from './capabilities/blockchain/solana/solana-helpers';
+export * from './capabilities/blockchain/blockchain-helpers';
 export * from './capabilities/http/http-helpers';
 export * from './chain-selectors';
 export * from './decode-json';

package/dist/sdk/utils/index.js

@@ -1,5 +1,4 @@
-export * from './capabilities/blockchain/evm/evm-helpers';
-export * from './capabilities/blockchain/solana/solana-helpers';
+export * from './capabilities/blockchain/blockchain-helpers';
 export * from './capabilities/http/http-helpers';
 export * from './chain-selectors';
 export * from './decode-json';

package/dist/sdk/wasm/host-bindings.d.ts

@@ -11,6 +11,7 @@ export declare const globalHostBindingsSchema: z.ZodObject<{
     awaitSecrets: z.ZodFunction<z.ZodTuple<[z.ZodUnion<[z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>]>, z.ZodNumber], z.ZodUnknown>, z.ZodUnion<[z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>]>>;
     getWasiArgs: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodString>;
     now: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodNumber>;
+    emitMetric: z.ZodFunction<z.ZodTuple<[z.ZodUnion<[z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>, z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>]>], z.ZodUnknown>, z.ZodNumber>;
     sleep: z.ZodFunction<z.ZodTuple<[z.ZodNumber], z.ZodUnknown>, z.ZodVoid>;
 }, "strip", z.ZodTypeAny, {
     callCapability: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
@@ -18,6 +19,7 @@ export declare const globalHostBindingsSchema: z.ZodObject<{
     getSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => any;
     awaitSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
     log: (args_0: string, ...args: unknown[]) => void;
+    emitMetric: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     sendResponse: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     switchModes: (args_0: Mode, ...args: unknown[]) => void;
     versionV2: (...args: unknown[]) => void;
@@ -30,6 +32,7 @@ export declare const globalHostBindingsSchema: z.ZodObject<{
     getSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => any;
     awaitSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
     log: (args_0: string, ...args: unknown[]) => void;
+    emitMetric: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     sendResponse: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     switchModes: (args_0: Mode, ...args: unknown[]) => void;
     versionV2: (...args: unknown[]) => void;
@@ -43,6 +46,7 @@ export declare const hostBindings: {
     getSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => any;
     awaitSecrets: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
     log: (args_0: string, ...args: unknown[]) => void;
+    emitMetric: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     sendResponse: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     switchModes: (args_0: Mode, ...args: unknown[]) => void;
     versionV2: (...args: unknown[]) => void;

package/dist/sdk/wasm/host-bindings.js

@@ -27,6 +27,10 @@ export const globalHostBindingsSchema = z.object({
         .returns(z.union([z.instanceof(Uint8Array), z.custom()])),
     getWasiArgs: z.function().args().returns(z.string()),
     now: z.function().args().returns(z.number()),
+    emitMetric: z
+        .function()
+        .args(z.union([z.instanceof(Uint8Array), z.custom()]))
+        .returns(z.number()),
     sleep: z.function().args(z.number()).returns(z.void()),
 });
 // Validate global host functions at runtime

package/dist/sdk/wasm/runner.d.ts

@@ -2,13 +2,19 @@ import { type ExecuteRequest, type ExecutionResult } from '../../generated/sdk/v
 import { type ConfigHandlerParams } from '../utils/config';
 import type { SecretsProvider, Workflow } from '../workflow';
 import { Runtime } from './runtime';
-export declare class Runner<TConfig> {
+declare class RunnerBase<TConfig> {
     private readonly config;
     private readonly request;
-    private constructor();
-    static newRunner<TConfig, TIntermediateConfig = TConfig>(configHandlerParams?: ConfigHandlerParams<TConfig, TIntermediateConfig>): Promise<Runner<TConfig>>;
+    protected constructor(config: TConfig, request: ExecuteRequest);
+    protected static newRunnerHelper<TConfig, TIntermediateConfig, TRunner>(newRunner: (config: TConfig, request: ExecuteRequest) => TRunner, configHandlerParams?: ConfigHandlerParams<TConfig, TIntermediateConfig>): Promise<TRunner>;
     private static getRequest;
     run(initFn: (config: TConfig, secretsProvider: SecretsProvider) => Promise<Workflow<TConfig>> | Workflow<TConfig>): Promise<void>;
-    handleExecutionPhase<TConfig>(req: ExecuteRequest, workflow: Workflow<TConfig>, runtime: Runtime<TConfig>): Promise<ExecutionResult>;
+    handleExecutionPhase(req: ExecuteRequest, workflow: Workflow<TConfig>, runtime: Runtime<TConfig>): Promise<ExecutionResult>;
+    handlePreHookPhase(req: ExecuteRequest, workflow: Workflow<TConfig>): ExecutionResult;
     handleSubscribePhase(req: ExecuteRequest, workflow: Workflow<TConfig>): ExecutionResult;
 }
+export declare class Runner<TConfig> extends RunnerBase<TConfig> {
+    private constructor();
+    static newRunner<TConfig, TIntermediateConfig = TConfig>(configHandlerParams?: ConfigHandlerParams<TConfig, TIntermediateConfig>): Promise<Runner<TConfig>>;
+}
+export {};