@chainlink/cre-sdk 1.9.0 → 1.10.0

package/dist/sdk/utils/types/no-excess.d.ts

@@ -0,0 +1,32 @@
+/**
+ * NoExcess<T, Shape> rejects any property in T whose key is not present in
+ * Shape, while preserving the values of allowed properties.
+ *
+ * Native TS structural typing only triggers excess-property checks on object
+ * literals at the call site. Once a request object is bound to a variable
+ * its excess keys are tolerated. NoExcess closes that gap by mapping any
+ * unknown key to `never`, which fails to assign at the boundary.
+ *
+ * Recursion stops at:
+ *   - primitives / Uint8Array / Date (`Shape[K]` not an indexable object), and
+ *   - index-signature maps (every string key is "known"; nothing is excess).
+ *
+ * Depth bound is set to 6 to keep the tsc work bounded for nested protos.
+ */
+export type NoExcess<T, Shape, Depth extends number = 6> = Depth extends 0 ? T : T extends object ? Shape extends object ? IsIndexed<Shape> extends true ? T : {
+    [K in keyof T]: K extends keyof Shape ? NoExcess<T[K], NonNullable<Shape[K]>, Prev<Depth>> : never;
+} : T : T;
+type IsIndexed<T> = string extends keyof T ? true : false;
+type Prev<N extends number> = [-1, 0, 1, 2, 3, 4, 5, 6][N];
+/**
+ * Pick the right shape for a capability input.
+ *
+ * Native protobuf messages carry a `$typeName` brand; JSON shapes do not.
+ * If the caller passes a native message we leave it untouched. Otherwise we
+ * apply NoExcess against the JSON shape so unknown keys (a stale `body`
+ * field, a typo, ...) fail at the call boundary.
+ */
+export type CapabilityInput<TInput, Native, Json> = [TInput] extends [{
+    $typeName: string;
+}] ? Native : NoExcess<TInput, Json>;
+export {};

package/dist/sdk/utils/types/no-excess.js

@@ -0,0 +1 @@
+export {};

package/dist/sdk/utils/values/value.js

@@ -1,6 +1,7 @@
 import { create } from '@bufbuild/protobuf';
 import { timestampDate, timestampFromDate } from '@bufbuild/protobuf/wkt';
 import { BigIntSchema, DecimalSchema, ListSchema, MapSchema, ValueSchema, } from '../../../generated/values/v1/values_pb';
+import { assertSafeIntegerNumber } from '../safe-integer';
 export class Int64 {
     // int64 bounds
     static INT64_MIN = -(2n ** 63n);
@@ -18,8 +19,7 @@ export class Int64 {
                 throw new Error('int64 underflow');
             return v;
         }
-        if (!Number.isFinite(v) || !Number.isInteger(v))
-            throw new Error('int64 requires an integer number');
+        assertSafeIntegerNumber(v, 'int64');
         const bi = BigInt(v);
         if (bi > Int64.INT64_MAX)
             throw new Error('int64 overflow');
@@ -66,8 +66,7 @@ export class UInt64 {
                 throw new Error('uint64 underflow');
             return v;
         }
-        if (!Number.isFinite(v) || !Number.isInteger(v))
-            throw new Error('uint64 requires an integer number');
+        assertSafeIntegerNumber(v, 'uint64');
         const bi = BigInt(v);
         if (bi > UInt64.UINT64_MAX)
             throw new Error('uint64 overflow');

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

@@ -1,4 +1,42 @@
 import { Mode } from '../../generated/sdk/v1alpha/sdk_pb';
+import { z } from 'zod';
+export declare const globalHostBindingsSchema: z.ZodObject<{
+    switchModes: z.ZodFunction<z.ZodTuple<[z.ZodNativeEnum<typeof Mode>], z.ZodUnknown>, z.ZodVoid>;
+    log: z.ZodFunction<z.ZodTuple<[z.ZodString], z.ZodUnknown>, z.ZodVoid>;
+    sendResponse: 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>;
+    versionV2: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodVoid>;
+    callCapability: 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>;
+    awaitCapabilities: 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>>]>>;
+    getSecrets: 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.ZodAny>;
+    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>;
+    sleep: z.ZodFunction<z.ZodTuple<[z.ZodNumber], z.ZodUnknown>, z.ZodVoid>;
+}, "strip", z.ZodTypeAny, {
+    callCapability: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
+    awaitCapabilities: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
+    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;
+    sendResponse: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
+    switchModes: (args_0: Mode, ...args: unknown[]) => void;
+    versionV2: (...args: unknown[]) => void;
+    getWasiArgs: (...args: unknown[]) => string;
+    now: (...args: unknown[]) => number;
+    sleep: (args_0: number, ...args: unknown[]) => void;
+}, {
+    callCapability: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
+    awaitCapabilities: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
+    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;
+    sendResponse: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
+    switchModes: (args_0: Mode, ...args: unknown[]) => void;
+    versionV2: (...args: unknown[]) => void;
+    getWasiArgs: (...args: unknown[]) => string;
+    now: (...args: unknown[]) => number;
+    sleep: (args_0: number, ...args: unknown[]) => void;
+}>;
 export declare const hostBindings: {
     callCapability: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, ...args: unknown[]) => number;
     awaitCapabilities: (args_0: Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>, args_1: number, ...args: unknown[]) => Uint8Array<ArrayBufferLike> | Uint8Array<ArrayBuffer>;
@@ -10,4 +48,5 @@ export declare const hostBindings: {
     versionV2: (...args: unknown[]) => void;
     getWasiArgs: (...args: unknown[]) => string;
     now: (...args: unknown[]) => number;
+    sleep: (args_0: number, ...args: unknown[]) => void;
 };

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

@@ -1,7 +1,7 @@
 import { Mode } from '../../generated/sdk/v1alpha/sdk_pb';
 import { z } from 'zod';
 // Zod schema for validating global host functions
-const globalHostBindingsSchema = z.object({
+export const globalHostBindingsSchema = z.object({
     switchModes: z.function().args(z.nativeEnum(Mode)).returns(z.void()),
     log: z.function().args(z.string()).returns(z.void()),
     sendResponse: z
@@ -27,6 +27,7 @@ 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()),
+    sleep: z.function().args(z.number()).returns(z.void()),
 });
 // Validate global host functions at runtime
 const validateGlobalHostBindings = () => {

package/dist/sdk/wasm/runtime.js

@@ -25,6 +25,9 @@ class WasmRuntimeHelpers {
     now() {
         return hostBindings.now();
     }
+    sleep(ms) {
+        hostBindings.sleep(ms);
+    }
     static getInstance() {
         if (!WasmRuntimeHelpers.instance) {
             WasmRuntimeHelpers.instance = new WasmRuntimeHelpers();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.9.0",
+	"version": "1.10.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -55,12 +55,13 @@
 		"prepublishOnly": "bun typecheck && bun check && bun test && bun test:standard",
 		"test": "bun test",
 		"test:standard": "./scripts/run-standard-tests.sh",
-		"typecheck": "tsc -p tsconfig.json --noEmit"
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"update-api-baseline": "bun run compile:build && cat dist/index.d.ts dist/pb.d.ts dist/sdk/index.d.ts dist/sdk/runtime.d.ts dist/sdk/workflow.d.ts dist/sdk/errors.d.ts dist/sdk/report.d.ts dist/sdk/test/index.d.ts > api-baseline.d.ts"
 	},
 	"dependencies": {
 		"@bufbuild/protobuf": "2.6.3",
 		"@bufbuild/protoc-gen-es": "2.6.3",
-		"@chainlink/cre-sdk-javy-plugin": "1.6.0",
+		"@chainlink/cre-sdk-javy-plugin": "1.7.0",
 		"@standard-schema/spec": "1.0.0",
 		"viem": "2.34.0",
 		"zod": "3.25.76"

package/scripts/src/generate-sdks.ts

@@ -1,5 +1,6 @@
 import { rmSync } from 'node:fs'
 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 +64,11 @@ export const main = () => {
 		...generateMocks(file_capabilities_blockchain_evm_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),