@chainlink/cre-sdk 0.0.3-alpha → 0.0.5-alpha

package/README.md

@@ -1,19 +1,77 @@
 # @chainlink/cre-sdk
 
-The Chainlink Runtime Environment (CRE) SDK for TypeScript enables developers to build decentralized workflows that combine off-chain computation with on-chain execution. Create workflows that fetch data from APIs, interact with smart contracts, and coordinate complex multi-step operations across blockchain networks.
+The Chainlink Runtime Environment (CRE) SDK for TypeScript enables developers to write decentralized [Chainlink Runtime Environment Workflows](https://docs.chain.link/cre/) in Typescript.
+
+## Table of Contents
+
+- [How to use this SDK](#how-to-use-this-sdk)
+- [Examples](#examples)
+- [Simulate locally with CRE CLI](#simulate-locally-with-cre-cli)
+- [Installation](#installation)
+- [Core Concepts](#core-concepts)
+  - [Workflows](#workflows)
+  - [Runtime Modes](#runtime-modes)
+- [Available Capabilities](#available-capabilities)
+  - [Scheduling](#scheduling)
+  - [HTTP Operations](#http-operations)
+  - [Blockchain Interactions](#blockchain-interactions)
+- [Configuration & Type Safety](#configuration--type-safety)
+- [Consensus & Aggregation](#consensus--aggregation)
+- [Utility Functions](#utility-functions)
+  - [Hex Utilities](#hex-utilities)
+  - [Chain Selectors](#chain-selectors)
+- [Example Workflows](#example-workflows)
+  - [1. Simple Scheduled Task](#1-simple-scheduled-task)
+  - [2. API Data Aggregation](#2-api-data-aggregation)
+  - [3. On-Chain Data Integration](#3-on-chain-data-integration)
+- [API Reference](#api-reference)
+  - [Core Functions](#core-functions)
+  - [Capabilities](#capabilities)
+  - [Utilities](#utilities)
+- [Building from Source](#building-from-source)
+  - [Protobuf Generation](#protobuf-generation)
+  - [Chain Selectors Generation](#chain-selectors-generation)
+- [Requirements](#requirements)
+- [License](#license)
+
+## How to use this SDK
+
+This package exposes the APIs you use to write CRE Workflows in TypeScript, and then compile them to WASM.
+
+This package must be used along with the [CRE CLI tool](https://github.com/smartcontractkit/cre-cli) to deploy your WASM-compiled workflows.
+
+## Prerequisites
+
+1. the [bun runtime](https://bun.com/). The wasm compilation currently is only supported by the bun runtime which has near-complete NodeJS compatibility.
+
+2. the [CRE CLI tool](https://github.com/smartcontractkit/cre-cli) installed.
+
+## Getting Started
+
+We recommend you consult the [getting started docs](https://docs.chain.link/cre/getting-started/cli-installation) and install the CRE CLI.
+
+Then run `cre init`, name your project and choose TypeScript as the language to define your workflows in.
 
 ## Examples
 
-Ready to clone repo with example workflows and cre-sdk set up: [cre-sdk-examples](https://github.com/smartcontractkit/cre-sdk-typescript/tree/main/packages/cre-sdk-examples).
+This TypeScript CRE SDK also includes some reference examples - [cre-sdk-examples](https://github.com/smartcontractkit/cre-sdk-typescript/tree/main/packages/cre-sdk-examples). These can be copied and pasted into your project as needed.
+
+⚠️ Note however that these are refence TypeScript workflows and may require some additional steps (having the CRE CLI installed, running `bunx cre-setup` from inside a workflow example directory, etc) to get them to work within this repo.
+
+**We recommend you setup your project using the CRE CLI and then copy and paste these examples into your project**
 
 ## Simulate locally with CRE CLI
 
-You can run and debug your TypeScript workflows locally using the CRE CLI simulation:
+You can run and debug your TypeScript workflows locally using [the CRE CLI's](https://github.com/smartcontractkit/cre-cli) simulation functionality.
+
+Make sure you `cd` into the directory that contain's your workflow's TypeScript file and the associated `config.json`. Then:
 
 ```bash
-cre workflow simulate --target local-simulation --config config.json your-workflow-file.ts
+cre workflow simulate --target local-simulation --config config.json index.ts
 ```
 
+When simulating workflows that write to the blockchain, remember to pass extra flag `--broadcast` to broadcast the transactions to the blockchain.
+
 See the CLI docs for additional flags (e.g. config file, secrets, HTTP payloads, EVM log params).
 
 ## Installation
@@ -22,33 +80,6 @@ See the CLI docs for additional flags (e.g. config file, secrets, HTTP payloads,
 bun add @chainlink/cre-sdk
 ```
 
-## Quick Start
-
-```typescript
-import { cre, Runner, type Runtime } from "@chainlink/cre-sdk";
-
-type Config = { schedule: string };
-
-const onCronTrigger = (runtime: Runtime<Config>) => {
-  runtime.log("Hello, CRE!");
-  return "Hello, CRE!";
-};
-
-const initWorkflow = (config: Config) => {
-  const cron = new cre.capabilities.CronCapability();
-  return [
-    cre.handler(cron.trigger({ schedule: config.schedule }), onCronTrigger),
-  ];
-};
-
-export async function main() {
-  const runner = await Runner.newRunner<Config>();
-  await runner.run(initWorkflow);
-}
-
-main();
-```
-
 ## Core Concepts
 
 ### Workflows
@@ -56,7 +87,7 @@ main();
 Workflows are the fundamental building blocks of CRE applications. They define how your application responds to triggers and what actions to take. Each workflow consists of:
 
 - **Triggers**: Events that initiate workflow execution (cron schedules, HTTP requests, etc.)
-- **Handlers**: Functions that process trigger events and execute your business logic
+- **Handlers**: Functions that process trigger events and execute your business logic as provided in a callback function.
 - **Capabilities**: Built-in services for interacting with external systems
 
 ### Runtime Modes
@@ -183,7 +214,11 @@ const onCronTrigger = async (runtime: Runtime<Config>) => {
 
 ## Configuration & Type Safety
 
-Use Zod schemas for type-safe configuration:
+You, the developer, must declare config files in config.json files, co-located with your TypeScript workflow definition.
+
+Use Zod schemas for type-safe configuration.
+
+Here's an example of zod usage for the config specified in `../cre-sdk-examples/src/workflows/on-chain/config.json`
 
 ```typescript
 import { z } from "zod";
@@ -231,10 +266,17 @@ const aggregatedValue = await runtime.runInNodeMode(
 
 ### Hex Utilities
 
+CRE capabilities (like EVM client) expect data in base64 format for serialization. You may need to convert a hex string to base64 format for CRE protocol communication.
+
+Or you may need to convert binary data back to hex format for blockchain operations. This can be Useful for decoding responses from CRE capabilities and transforming data for libraries like viem (which expect hex format)
+
 ```typescript
 import { hexToBase64, bytesToHex } from "@chainlink/cre-sdk";
 
+// Example: "0x1234567890abcdef" → "EjRWeJCrze8="
 const base64Data = hexToBase64("0x1234567890abcdef");
+
+// Example: Uint8Array([18, 52, 86...]) → "0x1234567890abcdef"
 const hexData = bytesToHex(buffer);
 ```
 
@@ -253,36 +295,13 @@ const ethereumSepolia = getNetwork({
 
 ## Example Workflows
 
-### 1. Simple Scheduled Task
-
-```typescript
-import { cre, Runner, type Runtime } from "@chainlink/cre-sdk";
-
-type Config = { schedule: string };
-
-const onCronTrigger = (runtime: Runtime<Config>) => {
-  runtime.log("Workflow executed!");
-  return "Task completed";
-};
+### 1. Simple Cron-scheduled task
 
-const initWorkflow = (config: Config) => {
-  const cron = new cre.capabilities.CronCapability();
-  return [
-    cre.handler(cron.trigger({ schedule: config.schedule }), onCronTrigger),
-  ];
-};
-
-export async function main() {
-  const runner = await Runner.newRunner<Config>();
-  await runner.run(initWorkflow);
-}
-
-main();
-```
+See the [hello-world](https://github.com/smartcontractkit/cre-sdk-typescript/tree/main/packages/cre-sdk-examples/src/hello-world) example for a simple example that runs a cron-based operation on CRE at intervals you define in the `config.js` file.
 
 ### 2. API Data Aggregation
 
-See the [http-fetch example](https://github.com/smartcontractkit/cre-sdk-typescript/tree/main/packages/cre-sdk-examples/src/workflows/http-fetch) for a complete implementation that fetches data from external APIs with consensus aggregation.
+See the [http-fetch example](https://github.com/smartcontractkit/cre-sdk-typescript/tree/main/packages/cre-sdk-examples/src/workflows/http-fetch) for a complete implementation that fetches data from external APIs, with Chainlink CRE consensus aggregation applied.
 
 ### 3. On-Chain Data Integration
 

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

@@ -1,7 +1,22 @@
 import { type Any, type Empty } 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 GetTransactionByHashReply, type GetTransactionByHashRequest, type GetTransactionByHashRequestJson, type GetTransactionReceiptReply, type GetTransactionReceiptRequest, type GetTransactionReceiptRequestJson, type HeaderByNumberReply, type HeaderByNumberRequest, type HeaderByNumberRequestJson, type Log, type RegisterLogTrackingRequest, type RegisterLogTrackingRequestJson, type UnregisterLogTrackingRequest, type UnregisterLogTrackingRequestJson, type WriteReportReply, type WriteReportRequest, type WriteReportRequestJson } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
-import type { Runtime } from '../../../../../sdk/runtime';
+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 RegisterLogTrackingRequest, type RegisterLogTrackingRequestJson, type UnregisterLogTrackingRequest, type UnregisterLogTrackingRequestJson, type WriteReportReply, type WriteReportRequest } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
+import { type Runtime } from '../../../../../sdk';
+import { Report } from '../../../../../sdk/report';
 import { type Trigger } from '../../../../../sdk/utils/triggers/trigger-interface';
+export type WriteCreReportRequest = {
+    receiver: Uint8Array;
+    report?: Report;
+    gasConfig?: GasConfig;
+    $report: true;
+};
+export type WriteCreReportRequestJson = {
+    receiver: string;
+    report?: Report;
+    gasConfig?: GasConfigJson;
+};
+export declare function x_generatedCodeOnly_wrap_WriteCreReportRequest(input: WriteReportRequest): WriteCreReportRequest;
+export declare function createWriteCreReportRequest(input: WriteCreReportRequestJson): WriteCreReportRequest;
+export declare function x_generatedCodeOnly_unwrap_WriteCreReportRequest(input: WriteCreReportRequest): WriteReportRequest;
 /**
  * Client Capability
  *
@@ -60,7 +75,7 @@ export declare class ClientCapability {
         result: () => Empty;
     };
     logTrigger(config: FilterLogTriggerRequestJson): ClientLogTrigger;
-    writeReport(runtime: Runtime<unknown>, input: WriteReportRequest | WriteReportRequestJson): {
+    writeReport(runtime: Runtime<unknown>, input: WriteCreReportRequest | WriteCreReportRequestJson): {
         result: () => WriteReportReply;
     };
 }

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

@@ -1,7 +1,34 @@
 import { create, fromJson } from '@bufbuild/protobuf';
 import { AnySchema, anyPack, EmptySchema } from '@bufbuild/protobuf/wkt';
-import { BalanceAtReplySchema, BalanceAtRequestSchema, CallContractReplySchema, CallContractRequestSchema, EstimateGasReplySchema, EstimateGasRequestSchema, FilterLogsReplySchema, FilterLogsRequestSchema, FilterLogTriggerRequestSchema, GetTransactionByHashReplySchema, GetTransactionByHashRequestSchema, GetTransactionReceiptReplySchema, GetTransactionReceiptRequestSchema, HeaderByNumberReplySchema, HeaderByNumberRequestSchema, LogSchema, RegisterLogTrackingRequestSchema, UnregisterLogTrackingRequestSchema, WriteReportReplySchema, WriteReportRequestSchema, } from '../../../../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
+import { BalanceAtReplySchema, BalanceAtRequestSchema, CallContractReplySchema, CallContractRequestSchema, EstimateGasReplySchema, EstimateGasRequestSchema, FilterLogsReplySchema, FilterLogsRequestSchema, FilterLogTriggerRequestSchema, GasConfigSchema, GetTransactionByHashReplySchema, GetTransactionByHashRequestSchema, GetTransactionReceiptReplySchema, GetTransactionReceiptRequestSchema, HeaderByNumberReplySchema, HeaderByNumberRequestSchema, LogSchema, RegisterLogTrackingRequestSchema, UnregisterLogTrackingRequestSchema, 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,
+        report: input.report !== undefined ? new Report(input.report) : undefined,
+        gasConfig: input.gasConfig,
+        $report: true,
+    };
+}
+export function createWriteCreReportRequest(input) {
+    return {
+        receiver: hexToBytes(input.receiver),
+        report: input.report,
+        gasConfig: input.gasConfig !== undefined ? fromJson(GasConfigSchema, input.gasConfig) : undefined,
+        $report: true,
+    };
+}
+export function x_generatedCodeOnly_unwrap_WriteCreReportRequest(input) {
+    return create(WriteReportRequestSchema, {
+        receiver: input.receiver,
+        report: input.report !== undefined ? input.report.x_generatedCodeOnly_unwrap() : undefined,
+        gasConfig: input.gasConfig,
+    });
+}
 /**
  * Client Capability
  *
@@ -35,9 +62,16 @@ export class ClientCapability {
         this.chainSelector = chainSelector;
     }
     callContract(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(CallContractRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(CallContractRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -51,14 +85,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     filterLogs(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(FilterLogsRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(FilterLogsRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -72,14 +114,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     balanceAt(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(BalanceAtRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(BalanceAtRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -93,14 +143,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     estimateGas(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(EstimateGasRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(EstimateGasRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -114,14 +172,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     getTransactionByHash(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(GetTransactionByHashRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(GetTransactionByHashRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -135,14 +201,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     getTransactionReceipt(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(GetTransactionReceiptRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(GetTransactionReceiptRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -156,14 +230,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     headerByNumber(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(HeaderByNumberRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(HeaderByNumberRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -177,14 +259,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     registerLogTracking(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(RegisterLogTrackingRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(RegisterLogTrackingRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -198,14 +288,22 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     unregisterLogTracking(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(UnregisterLogTrackingRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(UnregisterLogTrackingRequestSchema, input);
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -219,7 +317,8 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
@@ -231,9 +330,17 @@ export class ClientCapability {
         return new ClientLogTrigger(config, capabilityId, 'LogTrigger');
     }
     writeReport(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(WriteReportRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        // Check if it's a wrapped type by looking for the $report property
+        if (input.$report) {
+            // It's a wrapped type, unwrap it
+            payload = x_generatedCodeOnly_unwrap_WriteCreReportRequest(input);
+        }
+        else {
+            // It's wrapped JSON, convert using create function
+            payload = x_generatedCodeOnly_unwrap_WriteCreReportRequest(createWriteCreReportRequest(input));
+        }
         // Include chainSelector in capability ID for routing when specified
         const capabilityId = this.chainSelector
             ? `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.chainSelector}@${ClientCapability.CAPABILITY_VERSION}`
@@ -247,7 +354,8 @@ export class ClientCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }

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

@@ -1,6 +1,7 @@
-import { type ReportRequest, type ReportRequestJson, type ReportResponse, type SimpleConsensusInputs, type SimpleConsensusInputsJson } from '../../../../../generated/sdk/v1alpha/sdk_pb';
+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/runtime';
+import { type Runtime } from '../../../../../sdk';
+import { Report } from '../../../../../sdk/report';
 /**
  * Consensus Capability
  *
@@ -17,6 +18,6 @@ export declare class ConsensusCapability {
         result: () => Value;
     };
     report(runtime: Runtime<unknown>, input: ReportRequest | ReportRequestJson): {
-        result: () => ReportResponse;
+        result: () => Report;
     };
 }

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

@@ -1,6 +1,9 @@
 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';
 /**
  * Consensus Capability
  *
@@ -14,9 +17,16 @@ export class ConsensusCapability {
     static CAPABILITY_NAME = 'consensus';
     static CAPABILITY_VERSION = '1.0.0-alpha';
     simple(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(SimpleConsensusInputsSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(SimpleConsensusInputsSchema, input);
+        }
         const capabilityId = ConsensusCapability.CAPABILITY_ID;
         const capabilityResponse = runtime.callCapability({
             capabilityId,
@@ -27,14 +37,22 @@ export class ConsensusCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return result;
             },
         };
     }
     report(runtime, input) {
-        const payload = input.$typeName
-            ? input
-            : fromJson(ReportRequestSchema, input);
+        // Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+        let payload;
+        if (input.$typeName) {
+            // It's the original protobuf type
+            payload = input;
+        }
+        else {
+            // It's regular JSON, convert using fromJson
+            payload = fromJson(ReportRequestSchema, input);
+        }
         const capabilityId = ConsensusCapability.CAPABILITY_ID;
         const capabilityResponse = runtime.callCapability({
             capabilityId,
@@ -45,7 +63,8 @@ export class ConsensusCapability {
         });
         return {
             result: () => {
-                return capabilityResponse.result();
+                const result = capabilityResponse.result();
+                return new Report(result);
             },
         };
     }

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, Runtime } from '../../../../../sdk/runtime';
+import { type NodeRuntime, type Runtime } from '../../../../../sdk';
 import type { ConsensusAggregation, PrimitiveTypes, UnwrapOptions } from '../../../../../sdk/utils';
 export declare class SendRequester {
     private readonly runtime;