@chainlink/cre-sdk 1.1.0 → 1.1.2

package/dist/generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen.d.ts

@@ -1,8 +1,8 @@
 import { type Any } from '@bufbuild/protobuf/wkt';
 import { type BalanceAtReply, type BalanceAtRequest, type BalanceAtRequestJson, type CallContractReply, type CallContractRequest, type CallContractRequestJson, type EstimateGasReply, type EstimateGasRequest, type EstimateGasRequestJson, type FilterLogsReply, type FilterLogsRequest, type FilterLogsRequestJson, type FilterLogTriggerRequest, type FilterLogTriggerRequestJson, type GasConfig, type GasConfigJson, type GetTransactionByHashReply, type GetTransactionByHashRequest, type GetTransactionByHashRequestJson, type GetTransactionReceiptReply, type GetTransactionReceiptRequest, type GetTransactionReceiptRequestJson, type HeaderByNumberReply, type HeaderByNumberRequest, type HeaderByNumberRequestJson, type Log, type WriteReportReply, type WriteReportRequest } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
-import { type Runtime } from '../../../../../sdk';
+import type { Runtime } from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
-import { type Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
+import type { Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
 export type WriteCreReportRequest = {
     receiver: Uint8Array;
     report?: Report;

package/dist/generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen.js

@@ -2,10 +2,8 @@ import { create, fromJson } from '@bufbuild/protobuf';
 import { AnySchema, anyPack } from '@bufbuild/protobuf/wkt';
 import { BalanceAtReplySchema, BalanceAtRequestSchema, CallContractReplySchema, CallContractRequestSchema, EstimateGasReplySchema, EstimateGasRequestSchema, FilterLogsReplySchema, FilterLogsRequestSchema, FilterLogTriggerRequestSchema, GasConfigSchema, GetTransactionByHashReplySchema, GetTransactionByHashRequestSchema, GetTransactionReceiptReplySchema, GetTransactionReceiptRequestSchema, HeaderByNumberReplySchema, HeaderByNumberRequestSchema, LogSchema, WriteReportReplySchema, WriteReportRequestSchema, } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
 import { ReportResponseSchema, } from '../../../../../generated/sdk/v1alpha/sdk_pb';
-import {} from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
 import { hexToBytes } from '../../../../../sdk/utils/hex-utils';
-import {} from '../../../../../sdk/utils/triggers/trigger-interface';
 export function x_generatedCodeOnly_wrap_WriteCreReportRequest(input) {
     return {
         receiver: input.receiver,

package/dist/generated-sdk/capabilities/internal/consensus/v1alpha/consensus_sdk_gen.d.ts

@@ -1,6 +1,6 @@
 import { type ReportRequest, type ReportRequestJson, type SimpleConsensusInputs, type SimpleConsensusInputsJson } from '../../../../../generated/sdk/v1alpha/sdk_pb';
 import { type Value } from '../../../../../generated/values/v1/values_pb';
-import { type Runtime } from '../../../../../sdk';
+import type { Runtime } from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
 /**
  * Consensus Capability

package/dist/generated-sdk/capabilities/internal/consensus/v1alpha/consensus_sdk_gen.js

@@ -1,7 +1,6 @@
 import { fromJson } from '@bufbuild/protobuf';
 import { ReportRequestSchema, ReportResponseSchema, SimpleConsensusInputsSchema, } from '../../../../../generated/sdk/v1alpha/sdk_pb';
 import { ValueSchema } from '../../../../../generated/values/v1/values_pb';
-import {} from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
 import { hexToBytes } from '../../../../../sdk/utils/hex-utils';
 /**

package/dist/generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen.d.ts

@@ -1,5 +1,5 @@
 import { type ConfidentialHTTPRequest, type ConfidentialHTTPRequestJson, type HTTPResponse } from '../../../../../generated/capabilities/networking/confidentialhttp/v1alpha/client_pb';
-import { type Runtime } from '../../../../../sdk';
+import type { Runtime } from '../../../../../sdk';
 /**
  * Client Capability
  *

package/dist/generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen.js

@@ -1,6 +1,5 @@
 import { fromJson } from '@bufbuild/protobuf';
 import { ConfidentialHTTPRequestSchema, HTTPResponseSchema, } from '../../../../../generated/capabilities/networking/confidentialhttp/v1alpha/client_pb';
-import {} from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
 import { hexToBytes } from '../../../../../sdk/utils/hex-utils';
 /**

package/dist/generated-sdk/capabilities/networking/http/v1alpha/client_sdk_gen.d.ts

@@ -1,5 +1,5 @@
 import { type Request, type RequestJson, type Response } from '../../../../../generated/capabilities/networking/http/v1alpha/client_pb';
-import { type NodeRuntime, type Runtime } from '../../../../../sdk';
+import type { NodeRuntime, Runtime } from '../../../../../sdk';
 import type { ConsensusAggregation, PrimitiveTypes, UnwrapOptions } from '../../../../../sdk/utils';
 export declare class SendRequester {
     private readonly runtime;

package/dist/generated-sdk/capabilities/networking/http/v1alpha/client_sdk_gen.js

@@ -1,6 +1,5 @@
 import { fromJson } from '@bufbuild/protobuf';
 import { RequestSchema, ResponseSchema, } from '../../../../../generated/capabilities/networking/http/v1alpha/client_pb';
-import {} from '../../../../../sdk';
 import { Report } from '../../../../../sdk/report';
 export class SendRequester {
     runtime;

package/dist/generated-sdk/capabilities/networking/http/v1alpha/http_sdk_gen.d.ts

@@ -1,6 +1,6 @@
 import { type Any } from '@bufbuild/protobuf/wkt';
 import { type Config, type ConfigJson, type Payload } from '../../../../../generated/capabilities/networking/http/v1alpha/trigger_pb';
-import { type Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
+import type { Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
 /**
  * HTTP Capability
  *

package/dist/generated-sdk/capabilities/networking/http/v1alpha/http_sdk_gen.js

@@ -1,7 +1,6 @@
 import { create, fromJson } from '@bufbuild/protobuf';
 import { AnySchema, anyPack } from '@bufbuild/protobuf/wkt';
 import { ConfigSchema, PayloadSchema, } from '../../../../../generated/capabilities/networking/http/v1alpha/trigger_pb';
-import {} from '../../../../../sdk/utils/triggers/trigger-interface';
 /**
  * HTTP Capability
  *

package/dist/generated-sdk/capabilities/scheduler/cron/v1/cron_sdk_gen.d.ts

@@ -1,6 +1,6 @@
 import { type Any } from '@bufbuild/protobuf/wkt';
 import { type Config, type ConfigJson, type Payload } from '../../../../../generated/capabilities/scheduler/cron/v1/trigger_pb';
-import { type Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
+import type { Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
 /**
  * Cron Capability
  *

package/dist/generated-sdk/capabilities/scheduler/cron/v1/cron_sdk_gen.js

@@ -1,7 +1,6 @@
 import { create, fromJson } from '@bufbuild/protobuf';
 import { AnySchema, anyPack } from '@bufbuild/protobuf/wkt';
 import { ConfigSchema, LegacyPayloadSchema, PayloadSchema, } from '../../../../../generated/capabilities/scheduler/cron/v1/trigger_pb';
-import {} from '../../../../../sdk/utils/triggers/trigger-interface';
 /**
  * Cron Capability
  *

package/dist/sdk/test/evm-contract-mock.d.ts

@@ -0,0 +1,68 @@
+import type { GasConfig, WriteReportReply, WriteReportReplyJson } from '../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
+import type { ReportResponse } from '../../generated/sdk/v1alpha/sdk_pb';
+import { type Abi, type AbiFunction, type Address } from 'viem';
+import type { EvmMock } from './generated';
+type ViewFunction = AbiFunction & {
+    stateMutability: 'view' | 'pure';
+};
+type ExtractViewFunctionNames<TAbi extends Abi> = Extract<TAbi[number], ViewFunction>['name'];
+/**
+ * Strict version of {@link WriteReportRequest} where `report` and `gasConfig`
+ * are guaranteed to be present. Used by mock handlers so tests don't need
+ * to check for undefined.
+ */
+export interface WriteReportMockInput {
+    receiver: Uint8Array;
+    report: ReportResponse;
+    gasConfig: GasConfig;
+}
+/**
+ * A contract mock returned by {@link addContractMock}.
+ *
+ * Each view/pure function in the ABI becomes an optional property whose value
+ * is a handler function. When set, calls to that function on the mock EVM
+ * client are automatically routed, decoded, and re-encoded.
+ *
+ * A special `writeReport` property handles write-report calls to this
+ * contract's address. Its handler receives a {@link WriteReportMockInput}
+ * where `report` and `gasConfig` are guaranteed to be present.
+ */
+export type ContractMock<TAbi extends Abi> = {
+    [K in ExtractViewFunctionNames<TAbi>]?: (...args: readonly unknown[]) => unknown;
+} & {
+    writeReport?: (input: WriteReportMockInput) => WriteReportReply | WriteReportReplyJson;
+};
+export interface AddContractMockOptions<TAbi extends Abi> {
+    address: Address;
+    abi: TAbi;
+}
+/**
+ * Registers a typed contract mock on an {@link EvmMock} instance.
+ *
+ * This is the TypeScript equivalent of Go's `evmmock.AddContractMock`.
+ * It intercepts `callContract` and `writeReport` on the provided mock,
+ * routing calls by contract address and ABI method selector.
+ *
+ * Multiple contracts can be mocked on the same `EvmMock` — each call to
+ * `addContractMock` chains with the previous handler.
+ *
+ * @example
+ * ```ts
+ * const evmMock = EvmMock.testInstance(chainSelector);
+ *
+ * const balanceMock = addContractMock(evmMock, {
+ *   address: "0x1234...",
+ *   abi: BalanceReader,
+ * });
+ *
+ * balanceMock.getNativeBalances = (addresses) => {
+ *   return [500000000000000000n];
+ * };
+ * ```
+ *
+ * @param evmMock - The `EvmMock` instance to attach to.
+ * @param options - Contract address and viem-compatible ABI.
+ * @returns A mock object with settable handler properties for each view/pure function.
+ */
+export declare function addContractMock<const TAbi extends Abi>(evmMock: EvmMock, options: AddContractMockOptions<TAbi>): ContractMock<TAbi>;
+export {};

package/dist/sdk/test/evm-contract-mock.js

@@ -0,0 +1,114 @@
+import { decodeFunctionData, encodeFunctionResult, } from 'viem';
+function bytesToHexAddress(bytes) {
+    return `0x${Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('')}`.toLowerCase();
+}
+function bytesToHex(bytes) {
+    return `0x${Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('')}`;
+}
+function hexToUint8Array(hex) {
+    const clean = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < clean.length; i += 2) {
+        bytes[i / 2] = Number.parseInt(clean.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Registers a typed contract mock on an {@link EvmMock} instance.
+ *
+ * This is the TypeScript equivalent of Go's `evmmock.AddContractMock`.
+ * It intercepts `callContract` and `writeReport` on the provided mock,
+ * routing calls by contract address and ABI method selector.
+ *
+ * Multiple contracts can be mocked on the same `EvmMock` — each call to
+ * `addContractMock` chains with the previous handler.
+ *
+ * @example
+ * ```ts
+ * const evmMock = EvmMock.testInstance(chainSelector);
+ *
+ * const balanceMock = addContractMock(evmMock, {
+ *   address: "0x1234...",
+ *   abi: BalanceReader,
+ * });
+ *
+ * balanceMock.getNativeBalances = (addresses) => {
+ *   return [500000000000000000n];
+ * };
+ * ```
+ *
+ * @param evmMock - The `EvmMock` instance to attach to.
+ * @param options - Contract address and viem-compatible ABI.
+ * @returns A mock object with settable handler properties for each view/pure function.
+ */
+export function addContractMock(evmMock, options) {
+    const mock = {};
+    const normalizedAddress = options.address.toLowerCase();
+    const previousCallContract = evmMock.callContract;
+    evmMock.callContract = (req) => {
+        const toBytes = req.call?.to;
+        if (!toBytes || bytesToHexAddress(toBytes) !== normalizedAddress) {
+            if (previousCallContract)
+                return previousCallContract(req);
+            throw new Error(`addContractMock: no mock registered for address ${toBytes ? bytesToHexAddress(toBytes) : '(empty)'}`);
+        }
+        const dataBytes = req.call?.data;
+        if (!dataBytes || dataBytes.length < 4) {
+            throw new Error('addContractMock: call data too short (need at least 4 bytes for selector)');
+        }
+        const callDataHex = bytesToHex(dataBytes);
+        let decoded;
+        try {
+            decoded = decodeFunctionData({
+                abi: options.abi,
+                data: callDataHex,
+            });
+        }
+        catch (e) {
+            if (previousCallContract)
+                return previousCallContract(req);
+            throw new Error(`addContractMock: failed to decode function data for ${options.address}: ${e instanceof Error ? e.message : e}`);
+        }
+        const handler = mock[decoded.functionName];
+        if (typeof handler !== 'function') {
+            throw new Error(`addContractMock: no handler set for ${decoded.functionName} on ${options.address}`);
+        }
+        const result = handler(...(decoded.args ?? []));
+        const encoded = encodeFunctionResult({
+            abi: options.abi,
+            functionName: decoded.functionName,
+            result: result,
+        });
+        return {
+            data: hexToUint8Array(encoded),
+        };
+    };
+    const previousWriteReport = evmMock.writeReport;
+    evmMock.writeReport = (req) => {
+        const receiverBytes = req.receiver;
+        if (!receiverBytes || bytesToHexAddress(receiverBytes) !== normalizedAddress) {
+            if (previousWriteReport)
+                return previousWriteReport(req);
+            throw new Error(`addContractMock: no writeReport mock registered for receiver ${receiverBytes ? bytesToHexAddress(receiverBytes) : '(empty)'}`);
+        }
+        if (typeof mock.writeReport !== 'function') {
+            throw new Error(`addContractMock: no writeReport handler set for ${options.address}`);
+        }
+        if (!req.report) {
+            throw new Error(`addContractMock: writeReport called without report for ${options.address}`);
+        }
+        if (!req.gasConfig) {
+            throw new Error(`addContractMock: writeReport called without gasConfig for ${options.address}`);
+        }
+        return mock.writeReport({
+            receiver: req.receiver,
+            report: req.report,
+            gasConfig: req.gasConfig,
+        });
+    };
+    return mock;
+}

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

@@ -4,4 +4,5 @@
  */
 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 '../testutils/test-runtime';
 export { TestWriter } from '../testutils/test-writer';
+export { type AddContractMockOptions, addContractMock, type ContractMock, type WriteReportMockInput, } from './evm-contract-mock';
 export * from './generated';

package/dist/sdk/test/index.js

@@ -4,4 +4,5 @@
  */
 export { DEFAULT_MAX_RESPONSE_SIZE_BYTES, getTestCapabilityHandler, newTestRuntime, REPORT_METADATA_HEADER_LENGTH, RESPONSE_BUFFER_TOO_SMALL, registerTestCapability, TestRuntime, test, } from '../testutils/test-runtime';
 export { TestWriter } from '../testutils/test-writer';
+export { addContractMock, } from './evm-contract-mock';
 export * from './generated';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.1.0",
+	"version": "1.1.2",
 	"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.1.0",
+		"@chainlink/cre-sdk-javy-plugin": "1.1.1",
 		"@standard-schema/spec": "1.0.0",
 		"viem": "2.34.0",
 		"zod": "3.25.76"