@chainlink/cre-sdk 1.6.0-alpha.4 → 1.6.0-alpha.5

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

@@ -0,0 +1,178 @@
+import { fromJson } from '@bufbuild/protobuf';
+import { anyPack, anyUnpack } from '@bufbuild/protobuf/wkt';
+import { GetAccountInfoWithOptsReplySchema, GetAccountInfoWithOptsRequestSchema, GetBalanceReplySchema, GetBalanceRequestSchema, GetBlockReplySchema, GetBlockRequestSchema, GetFeeForMessageReplySchema, GetFeeForMessageRequestSchema, GetMultipleAccountsWithOptsReplySchema, GetMultipleAccountsWithOptsRequestSchema, 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.
+ * 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 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 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) {
+        const self = this;
+        const qualifiedId = `solana:ChainSelector:${chainSelector}@1.0.0`;
+        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 '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;
+                        if (typeof handler !== 'function')
+                            throw new Error("WriteReport: no implementation provided; set the mock's writeReport property to define the return value.");
+                        const raw = handler(input);
+                        const output = raw && typeof raw.$typeName === 'string'
+                            ? raw
+                            : fromJson(WriteReportReplySchema, raw);
+                        return { response: { case: 'payload', value: anyPack(WriteReportReplySchema, output) } };
+                    }
+                    default:
+                        return { response: { case: 'error', value: `unknown method ${req.method}` } };
+                }
+            });
+        }
+        catch {
+            throw new Error("Capability mocks must be used within the CRE test framework's test() method.");
+        }
+    }
+    /**
+     * Returns the mock instance for this capability and the specified tags.
+     * Multiple calls with the same tag values return the same instance.
+     * Must be called within the test framework's test() method.
+     */
+    static testInstance(chainSelector) {
+        const qualifiedId = `solana:ChainSelector:${chainSelector}@1.0.0`;
+        let instance = __getTestMockInstance(qualifiedId);
+        if (!instance) {
+            instance = new SolanaMock(chainSelector);
+            __setTestMockInstance(qualifiedId, instance);
+        }
+        return instance;
+    }
+}

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

@@ -1,5 +1,7 @@
 /** 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';
 export { BasicTestActionMock } from './capabilities/internal/basicaction/v1/basic_test_action_mock_gen';
 export { ConsensusMock } from './capabilities/internal/consensus/v1alpha/consensus_mock_gen';

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

@@ -1,5 +1,7 @@
 /** 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';
 export { BasicTestActionMock } from './capabilities/internal/basicaction/v1/basic_test_action_mock_gen';
 export { ConsensusMock } from './capabilities/internal/consensus/v1alpha/consensus_mock_gen';

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

@@ -3,6 +3,7 @@
  * 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 { TestWriter } from './test-writer';
@@ -80,5 +81,6 @@ export declare class TestRuntime extends RuntimeImpl<unknown> {
     private readonly state;
     constructor(helpers: RuntimeHelpers, maxResponseSize: bigint, testWriter: TestWriter, state: TestRuntimeState);
     getLogs(): string[];
+    getMetrics(): WorkflowUserMetric[];
     setTimeProvider(timeProvider: () => number): void;
 }

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

@@ -236,6 +236,10 @@ function createTestRuntimeHelpers(registry, secrets, testWriter, state, _maxResp
         log(message) {
             testWriter.log(message);
         },
+        emitMetric(payload) {
+            testWriter.emitMetric(payload);
+            return true;
+        },
     };
 }
 /**
@@ -307,6 +311,9 @@ export class TestRuntime extends RuntimeImpl {
     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/wasm/host-bindings.d.ts

@@ -5,6 +5,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 @@ 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()),
 });
 // Validate global host functions at runtime
 const validateGlobalHostBindings = () => {

package/dist/sdk/wasm/runtime.js

@@ -56,4 +56,7 @@ class WasmRuntimeHelpers {
     log(message) {
         hostBindings.log(message);
     }
+    emitMetric(payload) {
+        return hostBindings.emitMetric(payload) >= 0;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.6.0-alpha.4",
+	"version": "1.6.0-alpha.5",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -60,7 +60,7 @@
 	"dependencies": {
 		"@bufbuild/protobuf": "2.6.3",
 		"@bufbuild/protoc-gen-es": "2.6.3",
-		"@chainlink/cre-sdk-javy-plugin": "1.6.0-alpha.4",
+		"@chainlink/cre-sdk-javy-plugin": "1.6.0-alpha.5",
 		"@standard-schema/spec": "1.0.0",
 		"viem": "2.34.0",
 		"zod": "3.25.76"

package/scripts/src/generate-sdks.ts

@@ -1,5 +1,7 @@
 import { rmSync } from 'node:fs'
+import { file_capabilities_blockchain_aptos_v1alpha_client } from '@cre/generated/capabilities/blockchain/aptos/v1alpha/client_pb'
 import { file_capabilities_blockchain_evm_v1alpha_client } from '@cre/generated/capabilities/blockchain/evm/v1alpha/client_pb'
+import { file_capabilities_blockchain_solana_v1alpha_client } from '@cre/generated/capabilities/blockchain/solana/v1alpha/client_pb'
 import { file_capabilities_internal_actionandtrigger_v1_action_and_trigger } from '@cre/generated/capabilities/internal/actionandtrigger/v1/action_and_trigger_pb'
 import { file_capabilities_internal_basicaction_v1_basic_action } from '@cre/generated/capabilities/internal/basicaction/v1/basic_action_pb'
 import { file_capabilities_internal_basictrigger_v1_basic_trigger } from '@cre/generated/capabilities/internal/basictrigger/v1/basic_trigger_pb'
@@ -63,6 +65,16 @@ export const main = () => {
 		...generateMocks(file_capabilities_blockchain_evm_v1alpha_client, TEST_GENERATED_DIR),
 	)
 
+	generateSdk(file_capabilities_blockchain_aptos_v1alpha_client, './src/generated-sdk')
+	allMockExports.push(
+		...generateMocks(file_capabilities_blockchain_aptos_v1alpha_client, TEST_GENERATED_DIR),
+	)
+
+	generateSdk(file_capabilities_blockchain_solana_v1alpha_client, './src/generated-sdk')
+	allMockExports.push(
+		...generateMocks(file_capabilities_blockchain_solana_v1alpha_client, TEST_GENERATED_DIR),
+	)
+
 	generateSdk(file_capabilities_networking_http_v1alpha_client, './src/generated-sdk')
 	allMockExports.push(
 		...generateMocks(file_capabilities_networking_http_v1alpha_client, TEST_GENERATED_DIR),