Merge pull request #277 from smartcontractkit/chore-sync-with-main-22-06-26

Chore sync with main 22 06 26

Author: yashnevatia

README.md

@@ -270,23 +270,23 @@ bun generate:sdk          # Generate all SDK types and code
 
 The [`breaking-changes`](./.github/workflows/breaking-changes.yml) workflow blocks PRs that alter any of the three protected contracts. If your change is intentional, update the relevant baseline before pushing:
 
-| Contract | What triggers the failure | How to update |
-|---|---|---|
-| Proto fields | Field deleted, renamed, renumbered, or type changed | No baseline file — CI runs `buf breaking` on `submodules/chainlink-protos` (`cre` module) against the submodule commit pinned on `main` |
-| TypeScript public API | An exported type/interface was removed or changed | Run `bun run update-api-baseline` inside `packages/cre-sdk` and commit `api-baseline.d.ts` |
-| JS host binding names | A binding was added, removed, or renamed in `host-bindings.ts` | Run `bun test --update-snapshots` inside `packages/cre-sdk` and commit the updated `__snapshots__` file |
-| Rust host imports | An `extern "C"` import was added or removed in `lib.rs` | Re-run the sed extraction (see `breaking-changes.yml`) and commit `host-imports-baseline.txt` |
+| Contract              | What triggers the failure                                      | How to update                                                                                                                           |
+| --------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| Proto fields          | Field deleted, renamed, renumbered, or type changed            | No baseline file — CI runs `buf breaking` on `submodules/chainlink-protos` (`cre` module) against the submodule commit pinned on `main` |
+| TypeScript public API | An exported type/interface was removed or changed              | Run `bun run update-api-baseline` inside `packages/cre-sdk` and commit `api-baseline.d.ts`                                              |
+| JS host binding names | A binding was added, removed, or renamed in `host-bindings.ts` | Run `bun test --update-snapshots` inside `packages/cre-sdk` and commit the updated `__snapshots__` file                                 |
+| Rust host imports     | An `extern "C"` import was added or removed in `lib.rs`        | Re-run the sed extraction (see `breaking-changes.yml`) and commit `host-imports-baseline.txt`                                           |
 
 #### CI override labels
 
 When a change is **intentionally** breaking and cannot be fixed by updating a baseline (e.g. a coordinated proto break before `main` catches up), a **maintainer** adds the matching label on the PR (this re-runs the workflow):
 
-| Label | Skips |
-|-------|--------|
-| `breaking-change:proto` | `proto-breaking` (`buf breaking`) |
-| `breaking-change:typescript-api` | `ts-api-surface` |
-| `breaking-change:host-bindings` | `host-bindings` |
-| `breaking-change:approved` | All three jobs |
+| Label                            | Skips                             |
+| -------------------------------- | --------------------------------- |
+| `breaking-change:proto`          | `proto-breaking` (`buf breaking`) |
+| `breaking-change:typescript-api` | `ts-api-surface`                  |
+| `breaking-change:host-bindings`  | `host-bindings`                   |
+| `breaking-change:approved`       | All three jobs                    |
 
 Labels are an audit trail in the PR timeline, not a substitute for review. Prefer updating baselines (`api-baseline.d.ts`, snapshots, `host-imports-baseline.txt`) when the new contract is the new source of truth. For proto breaks, coordinate the `chainlink-protos` submodule bump and document migration notes in the PR.
 

bun.lock

@@ -1,7 +1,7 @@
 {
 	"name": "@chainlink/cre-sdk-examples",
 	"private": true,
-	"version": "1.11.0",
+	"version": "1.13.0",
 	"type": "module",
 	"author": "Ernest Nowacki",
 	"license": "BUSL-1.1",

packages/cre-sdk-examples/package.json

@@ -8,6 +8,7 @@ export * as CRON_TRIGGER_PB from '@cre/generated/capabilities/scheduler/cron/v1/
 export * as SDK_PB from '@cre/generated/sdk/v1alpha/sdk_pb';
 export * as VALUES_PB from '@cre/generated/values/v1/values_pb';
 export * as BUFBUILD_TYPES from '@cre/sdk/types/bufbuild-types';
+export * from '../capabilities/errors';
 export * from './cre';
 export * from './don-info';
 export * from './errors';
@@ -23,10 +24,11 @@ export * from './workflow';
 import type { Message } from '@bufbuild/protobuf';
 import type { GenMessage } from '@bufbuild/protobuf/codegenv2';
 import type { ReportRequest, ReportRequestJson } from '@cre/generated/sdk/v1alpha/sdk_pb';
+import type { MetricType } from '@cre/sdk/impl/runtime-impl';
 import type { Report } from '@cre/sdk/report';
 import type { ConsensusAggregation, PrimitiveTypes, UnwrapOptions } from '@cre/sdk/utils';
 import type { SecretsProvider } from '.';
-export type { ReportRequest, ReportRequestJson };
+export type { ReportRequest, ReportRequestJson, MetricType };
 export type CallCapabilityParams<I extends Message, O extends Message> = {
     capabilityId: string;
     method: string;
@@ -45,13 +47,34 @@ export interface BaseRuntime<C> {
     };
     now(): Date;
     log(message: string): void;
+    emitMetric(name: string, value: number, type: MetricType, labels?: Record<string, string>): boolean;
 }
 /**
  * Runtime for Node mode execution.
  */
 export interface NodeRuntime<C> extends BaseRuntime<C> {
     readonly _isNodeRuntime: true;
 }
+/**
+ * Runtime for Tee mode execution.
+ */
+export interface TeeRuntime<C> extends BaseRuntime<C>, SecretsProvider {
+    /**
+     * Generates a report from the DON.
+     * Data requestsed throught this method will be routed outside of the TEE.
+     *
+     * @param input - Report request to generate a report from the DON
+     * @returns Report generated from the DON
+     */
+    reportFromDon(input: ReportRequest | ReportRequestJson): {
+        result: () => Report;
+    };
+    /**
+     * Returns the runtime that makes requests to the CRE DONs.
+     * Requests made through this runtime will therefore be routed outside of the TEE
+     */
+    usingTheDons(): Runtime<C>;
+}
 /**
  * Runtime for DON mode execution.
  */
@@ -72,23 +95,29 @@ export interface Runtime<C> extends BaseRuntime<C>, SecretsProvider {
     };
 }
 import type { Message } from '@bufbuild/protobuf';
-import type { Secret, SecretRequest, SecretRequestJson } from '@cre/generated/sdk/v1alpha/sdk_pb';
-import { type Runtime } from '@cre/sdk/runtime';
+import type { Requirements, Secret, SecretRequest, SecretRequestJson } from '@cre/generated/sdk/v1alpha/sdk_pb';
+import type { Runtime, TeeRuntime } from '@cre/sdk/runtime';
 import type { Trigger } from '@cre/sdk/utils/triggers/trigger-interface';
 import type { CreSerializable } from './utils';
-export type HandlerFn<TConfig, TTriggerOutput, TResult> = (runtime: Runtime<TConfig>, triggerOutput: TTriggerOutput) => Promise<CreSerializable<TResult>> | CreSerializable<TResult>;
-export interface HandlerEntry<TConfig, TRawTriggerOutput extends Message<string>, TTriggerOutput, TResult> {
+export type { AnyTeeConstraint, NitroBinding, NitroRegion, OneOfTees, Region, TeeBinding, TeeConstraint, } from './tee-constraints';
+export { buildTeeRequirements, NITRO_REGIONS, REGIONS, teeConstraintSchema, } from './tee-constraints';
+import type { TeeConstraint } from './tee-constraints';
+export type HandlerFn<TConfig, TTriggerOutput, TResult, TRuntime = Runtime<TConfig>> = (runtime: TRuntime, triggerOutput: TTriggerOutput) => Promise<CreSerializable<TResult>> | CreSerializable<TResult>;
+export interface HandlerEntry<TConfig, TRawTriggerOutput extends Message<string>, TTriggerOutput, TResult, TRuntime = Runtime<TConfig>> {
     trigger: Trigger<TRawTriggerOutput, TTriggerOutput>;
-    fn: HandlerFn<TConfig, TTriggerOutput, TResult>;
+    fn: HandlerFn<TConfig, TTriggerOutput, TResult, TRuntime>;
+    requirements?: Requirements;
 }
-export type Workflow<TConfig> = ReadonlyArray<HandlerEntry<TConfig, any, any, any>>;
-export declare const handler: <TRawTriggerOutput extends Message<string>, TTriggerOutput, TConfig, TResult>(trigger: Trigger<TRawTriggerOutput, TTriggerOutput>, fn: HandlerFn<TConfig, TTriggerOutput, TResult>) => HandlerEntry<TConfig, TRawTriggerOutput, TTriggerOutput, TResult>;
+export type Workflow<TConfig> = ReadonlyArray<HandlerEntry<TConfig, any, any, any, any>>;
+export declare const handler: <TRawTriggerOutput extends Message<string>, TTriggerOutput, TConfig, TResult, TRuntime = Runtime<TConfig>>(trigger: Trigger<TRawTriggerOutput, TTriggerOutput>, fn: HandlerFn<TConfig, TTriggerOutput, TResult, TRuntime>) => HandlerEntry<TConfig, TRawTriggerOutput, TTriggerOutput, TResult, TRuntime>;
+export declare const handlerInTee: <TRawTriggerOutput extends Message<string>, TTriggerOutput, TConfig, TResult>(trigger: Trigger<TRawTriggerOutput, TTriggerOutput>, fn: HandlerFn<TConfig, TTriggerOutput, TResult, TeeRuntime<TConfig>>, tees: TeeConstraint) => HandlerEntry<TConfig, TRawTriggerOutput, TTriggerOutput, TResult, TeeRuntime<TConfig>>;
 export type SecretsProvider = {
     getSecret(request: SecretRequest | SecretRequestJson): {
         result: () => Secret;
     };
 };
 import type { SecretRequest } from '@cre/generated/sdk/v1alpha/sdk_pb';
+export { CapabilityError as CapabilityRuntimeError } from './utils/capabilities/capability-error';
 export declare class DonModeError extends Error {
     constructor();
 }

packages/cre-sdk/api-baseline.d.ts

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.11.0",
+	"version": "1.13.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -70,7 +70,7 @@
 		"@biomejs/biome": "2.3.14",
 		"@bufbuild/buf": "1.56.0",
 		"@types/bun": "1.3.8",
-		"chain-selectors": "https://github.com/smartcontractkit/chain-selectors.git#116ebbce88b36d4e76a03c12b3437ed33a5f9860",
+		"chain-selectors": "https://github.com/smartcontractkit/chain-selectors.git#c6379b1272aa41e6977f60799c82a49465a14b3f",
 		"fast-glob": "3.3.3",
 		"ts-proto": "2.7.5",
 		"typescript": "5.9.3",

packages/cre-sdk/package.json

@@ -172,6 +172,7 @@ export class ClientCapability {
 		'polygon-mainnet': 4051577828743386545n,
 		'polygon-testnet-amoy': 16281711391670634445n,
 		'private-testnet-andesite': 6915682381028791124n,
+		'private-testnet-pumice': 1564738277398880633n,
 		'private-testnet-rhyolite': 604447335222770945n,
 		'sonic-mainnet': 1673871237479749969n,
 		'sonic-testnet': 1763698235108410440n,

packages/cre-sdk/src/generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen.ts

@@ -35,6 +35,11 @@ import {
 	type GetMultipleAccountsWithOptsRequest,
 	type GetMultipleAccountsWithOptsRequestJson,
 	GetMultipleAccountsWithOptsRequestSchema,
+	type GetProgramAccountsReply,
+	GetProgramAccountsReplySchema,
+	type GetProgramAccountsRequest,
+	type GetProgramAccountsRequestJson,
+	GetProgramAccountsRequestSchema,
 	type GetSignatureStatusesReply,
 	GetSignatureStatusesReplySchema,
 	type GetSignatureStatusesRequest,
@@ -139,6 +144,7 @@ export class ClientCapability {
 	/** Available ChainSelector values */
 	static readonly SUPPORTED_CHAIN_SELECTORS = {
 		'solana-devnet': 16423721717087811551n,
+		'solana-mainnet': 124615329519749607n,
 	} as const
 
 	constructor(private readonly ChainSelector: bigint) {}
@@ -361,6 +367,48 @@ export class ClientCapability {
 		}
 	}
 
+	getProgramAccounts<TInput>(
+		runtime: Runtime<unknown>,
+		input: CapabilityInput<TInput, GetProgramAccountsRequest, GetProgramAccountsRequestJson>,
+	): { result: () => GetProgramAccountsReply }
+	getProgramAccounts(
+		runtime: Runtime<unknown>,
+		input: GetProgramAccountsRequest | GetProgramAccountsRequestJson,
+	): { result: () => GetProgramAccountsReply } {
+		// Handle input conversion - unwrap if it's a wrapped type, convert from JSON if needed
+		let payload: GetProgramAccountsRequest
+
+		if ((input as unknown as { $typeName?: string }).$typeName) {
+			// It's the original protobuf type
+			payload = input as GetProgramAccountsRequest
+		} else {
+			// It's regular JSON, convert using fromJson
+			payload = fromJson(GetProgramAccountsRequestSchema, input as GetProgramAccountsRequestJson)
+		}
+
+		// Include all labels in capability ID for routing when specified
+		const capabilityId = `${ClientCapability.CAPABILITY_NAME}:ChainSelector:${this.ChainSelector}@${ClientCapability.CAPABILITY_VERSION}`
+
+		const capabilityResponse = runtime.callCapability<
+			GetProgramAccountsRequest,
+			GetProgramAccountsReply
+		>({
+			capabilityId,
+			method: 'GetProgramAccounts',
+			payload,
+			inputSchema: GetProgramAccountsRequestSchema,
+			outputSchema: GetProgramAccountsReplySchema,
+		})
+
+		return {
+			result: () => {
+				const result = capabilityResponse.result()
+
+				return result
+			},
+		}
+	}
+
 	getSignatureStatuses<TInput>(
 		runtime: Runtime<unknown>,
 		input: CapabilityInput<TInput, GetSignatureStatusesRequest, GetSignatureStatusesRequestJson>,