@chainlink/cre-sdk 1.6.0-alpha.3 → 1.6.0

package/README.md

@@ -516,6 +516,15 @@ This SDK uses [@bufbuild/protobuf](https://www.npmjs.com/package/@bufbuild/proto
 - `buf.gen.yaml` - Code generation configuration using ts-proto
 - Generated files are placed in `src/generated/`
 
+**Opt-in proto allowlist:**
+
+[`buf.gen.yaml`](./buf.gen.yaml) uses an explicit `paths:` allowlist under its `inputs`. Protos added to the `chainlink-protos` submodule are **not** picked up automatically — a new capability must be added to both:
+
+1. [`packages/cre-sdk/buf.gen.yaml`](./buf.gen.yaml) — to generate the raw `*_pb.ts` types.
+2. [`packages/cre-sdk/scripts/src/generate-sdks.ts`](./scripts/src/generate-sdks.ts) — to generate the SDK wrapper classes and mocks.
+
+This prevents leaking in-progress or internal capabilities into the public SDK surface before they are ready.
+
 ### Chain Selectors Generation
 
 Auto-generated TypeScript files for 200+ blockchain networks from the official [Chainlink chain-selectors repository](https://github.com/smartcontractkit/chain-selectors).

package/bin/cre-compile.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 
 import { main as compileWorkflow } from "../scripts/src/compile-workflow";
+import { parseCompileFlags } from "@chainlink/cre-sdk-javy-plugin/scripts/parse-compile-flags";
 import {
   parseCompileCliArgs,
   skipTypeChecksFlag,
@@ -9,26 +10,34 @@ import { WorkflowTypecheckError } from "../scripts/src/typecheck-workflow";
 import { WorkflowRuntimeCompatibilityError } from "../scripts/src/validate-workflow-runtime-compat";
 
 const main = async () => {
+  const cliArgs = process.argv.slice(2);
+  const { creExports, plugin, rest } = parseCompileFlags(cliArgs);
+
   let inputPath: string | undefined;
   let outputPathArg: string | undefined;
   let skipTypeChecks = false;
 
   try {
-    const parsed = parseCompileCliArgs(process.argv.slice(2));
+    const parsed = parseCompileCliArgs(rest);
     inputPath = parsed.inputPath;
     outputPathArg = parsed.outputPath;
     skipTypeChecks = parsed.skipTypeChecks;
   } catch (error) {
     console.error(error instanceof Error ? error.message : error);
     console.error(
-      `Usage: cre-compile <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
+      `Usage: cre-compile [--plugin <path>] [--cre-exports <crate-dir>]... <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
     );
     process.exit(1);
   }
 
+  if (plugin !== null && creExports.length > 0) {
+    console.error("❌ Error: --plugin and --cre-exports are mutually exclusive.");
+    process.exit(1);
+  }
+
   if (!inputPath) {
     console.error(
-      `Usage: cre-compile <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
+      `Usage: cre-compile [--plugin <path>] [--cre-exports <crate-dir>]... <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
     );
     console.error("Examples:");
     console.error("  cre-compile src/standard_tests/secrets/test.ts");
@@ -41,10 +50,13 @@ const main = async () => {
     process.exit(1);
   }
 
-  await compileWorkflow(inputPath, outputPathArg, { skipTypeChecks });
+  await compileWorkflow(inputPath, outputPathArg, {
+    skipTypeChecks,
+    creExports: creExports.length > 0 ? creExports : undefined,
+    plugin,
+  });
 };
 
-// CLI entry point
 main().catch((e) => {
   if (
     e instanceof WorkflowRuntimeCompatibilityError ||

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

@@ -1,9 +1,7 @@
 /**
  * Public API for the CRE SDK.
  */
-import { ClientCapability as AptosClient } from '../../generated-sdk/capabilities/blockchain/aptos/v1alpha/client_sdk_gen';
 import { ClientCapability as EVMClient } from '../../generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen';
-import { ClientCapability as SolanaClient } from '../../generated-sdk/capabilities/blockchain/solana/v1alpha/client_sdk_gen';
 import { ClientCapability as ConfidentialHTTPClient } from '../../generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen';
 import { ClientCapability as HTTPClient } from '../../generated-sdk/capabilities/networking/http/v1alpha/client_sdk_gen';
 import { HTTPCapability } from '../../generated-sdk/capabilities/networking/http/v1alpha/http_sdk_gen';
@@ -14,9 +12,7 @@ import { CronCapability } from '../../generated-sdk/capabilities/scheduler/cron/
 export { type Log as EVMLog, TxStatus, } from '../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
 export type { Payload as HTTPPayload } from '../../generated/capabilities/networking/http/v1alpha/trigger_pb';
 export type { Payload as CronPayload } from '../../generated/capabilities/scheduler/cron/v1/trigger_pb';
-export { ClientCapability as AptosClient, type WriteCreReportRequest as AptosWriteCreReportRequest, type WriteCreReportRequestJson as AptosWriteCreReportRequestJson, } from '../../generated-sdk/capabilities/blockchain/aptos/v1alpha/client_sdk_gen';
 export { ClientCapability as EVMClient, type WriteCreReportRequest, type WriteCreReportRequestJson, } from '../../generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen';
-export { ClientCapability as SolanaClient, type WriteCreReportRequest as SolanaWriteCreReportRequest, type WriteCreReportRequestJson as SolanaWriteCreReportRequestJson, } from '../../generated-sdk/capabilities/blockchain/solana/v1alpha/client_sdk_gen';
 export { ClientCapability as ConfidentialHTTPClient } from '../../generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen';
 export { ClientCapability as HTTPClient, type SendRequester as HTTPSendRequester, } from '../../generated-sdk/capabilities/networking/http/v1alpha/client_sdk_gen';
 export { HTTPCapability } from '../../generated-sdk/capabilities/networking/http/v1alpha/http_sdk_gen';
@@ -30,8 +26,6 @@ export declare const cre: {
         ConfidentialHTTPClient: typeof ConfidentialHTTPClient;
         HTTPClient: typeof HTTPClient;
         EVMClient: typeof EVMClient;
-        AptosClient: typeof AptosClient;
-        SolanaClient: typeof SolanaClient;
     };
     handler: <TRawTriggerOutput extends import("@bufbuild/protobuf").Message<string>, TTriggerOutput, TConfig, TResult>(trigger: import("../utils/triggers/trigger-interface").Trigger<TRawTriggerOutput, TTriggerOutput>, fn: import("../workflow").HandlerFn<TConfig, TTriggerOutput, TResult>) => import("../workflow").HandlerEntry<TConfig, TRawTriggerOutput, TTriggerOutput, TResult>;
 };

package/dist/sdk/cre/index.js

@@ -1,9 +1,7 @@
 /**
  * Public API for the CRE SDK.
  */
-import { ClientCapability as AptosClient } from '../../generated-sdk/capabilities/blockchain/aptos/v1alpha/client_sdk_gen';
 import { ClientCapability as EVMClient } from '../../generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen';
-import { ClientCapability as SolanaClient } from '../../generated-sdk/capabilities/blockchain/solana/v1alpha/client_sdk_gen';
 import { ClientCapability as ConfidentialHTTPClient } from '../../generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen';
 import { ClientCapability as HTTPClient } from '../../generated-sdk/capabilities/networking/http/v1alpha/client_sdk_gen';
 import { HTTPCapability } from '../../generated-sdk/capabilities/networking/http/v1alpha/http_sdk_gen';
@@ -14,12 +12,8 @@ import { handler } from '../workflow';
  * Public exports for the CRE SDK.
  */
 export { TxStatus, } from '../../generated/capabilities/blockchain/evm/v1alpha/client_pb';
-// Aptos Capability
-export { ClientCapability as AptosClient, } from '../../generated-sdk/capabilities/blockchain/aptos/v1alpha/client_sdk_gen';
 // EVM Capability
 export { ClientCapability as EVMClient, } from '../../generated-sdk/capabilities/blockchain/evm/v1alpha/client_sdk_gen';
-// Solana Capability
-export { ClientCapability as SolanaClient, } from '../../generated-sdk/capabilities/blockchain/solana/v1alpha/client_sdk_gen';
 // Confidential HTTP Capability
 export { ClientCapability as ConfidentialHTTPClient } from '../../generated-sdk/capabilities/networking/confidentialhttp/v1alpha/client_sdk_gen';
 // HTTP Capability
@@ -36,8 +30,6 @@ export const cre = {
         ConfidentialHTTPClient,
         HTTPClient,
         EVMClient,
-        AptosClient,
-        SolanaClient,
     },
     handler,
 };

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

@@ -1,7 +1,5 @@
 /** 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,7 +1,5 @@
 /** 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/package.json

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

package/scripts/run-standard-tests.sh

@@ -8,9 +8,9 @@ set -e
 # Create dist test workflow folder
 mkdir -p ./dist/workflows/standard_tests
 
-# Build javy wasm
-if [ ! -f ../cre-sdk-javy-plugin/dist/javy_chainlink_sdk.wasm ]; then
-    echo "Error: javy_chainlink_sdk.wasm not found"
+# Plugin package must be built (initialized plugin is what we ship).
+if [ ! -f ../cre-sdk-javy-plugin/dist/javy-chainlink-sdk.plugin.wasm ]; then
+    echo "Error: javy-chainlink-sdk.plugin.wasm not found (run cre-sdk-javy-plugin build first)"
     exit 1
 fi
 

package/scripts/src/compile-to-wasm.ts

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import path from 'node:path'
+import { parseCompileFlags } from '@chainlink/cre-sdk-javy-plugin/scripts/parse-compile-flags'
 
 function runBun(args: string[]): Promise<void> {
 	return new Promise((resolve, reject) => {
@@ -19,20 +20,29 @@ function runBun(args: string[]): Promise<void> {
 
 const isJsFile = (p: string) => ['.js', '.mjs', '.cjs'].includes(path.extname(p).toLowerCase())
 
-export const main = async (inputFile?: string, outputFile?: string) => {
+export const main = async (
+	inputFile?: string,
+	outputFile?: string,
+	creExportsPaths?: string[],
+	pluginPath?: string | null,
+) => {
 	const cliArgs = process.argv.slice(3)
+	const { creExports: cliCreExports, plugin: cliPlugin, rest: cliRest } = parseCompileFlags(cliArgs)
 
-	// Resolve input/output from params or CLI
-	const inputPath = inputFile ?? cliArgs[0]
-	const outputPathArg = outputFile ?? cliArgs[1]
+	const inputPath = inputFile ?? cliRest[0]
+	const outputPathArg = outputFile ?? cliRest[1]
+	const creExports = creExportsPaths ?? cliCreExports
+	const plugin = pluginPath !== undefined ? pluginPath : cliPlugin
+
+	if (plugin !== null && plugin !== undefined && creExports.length > 0) {
+		console.error('❌ Error: --plugin and --cre-exports are mutually exclusive.')
+		process.exit(1)
+	}
 
 	if (!inputPath) {
 		console.error(
 			'Usage: bun compile:js-to-wasm <path/to/input.(js|mjs|cjs)> [path/to/output.wasm]',
 		)
-		console.error('Examples:')
-		console.error('  bun compile:js-to-wasm ./build/workflows/test.js')
-		console.error('  bun compile:js-to-wasm ./build/workflows/test.mjs ./artifacts/test.wasm')
 		process.exit(1)
 	}
 
@@ -47,31 +57,41 @@ export const main = async (inputFile?: string, outputFile?: string) => {
 		process.exit(1)
 	}
 
-	// Default output = same dir, same basename, .wasm extension
 	const defaultOut = path.join(
 		path.dirname(resolvedInput),
 		path.basename(resolvedInput).replace(/\.(m|c)?js$/i, '.wasm'),
 	)
 	const resolvedOutput = outputPathArg ? path.resolve(outputPathArg) : defaultOut
 
-	// Ensure output directory exists
 	await mkdir(path.dirname(resolvedOutput), { recursive: true })
 
-	console.info(`🔨 Compiling to WASM`)
+	console.info('🔨 Compiling to WASM')
 	console.info(`📁 Input:  ${resolvedInput}`)
 	console.info(`🎯 Output: ${resolvedOutput}`)
 
-	// Prefer the sibling @chainlink/cre-sdk-javy-plugin install (same as monorepo layout).
-	// Bun's shell `$` template can throw EINVAL on some Linux/arm64 Docker setups; use spawn.
-	const scriptDir = import.meta.dir
-	const compilerPath = path.resolve(
-		scriptDir,
-		'../../../cre-sdk-javy-plugin/bin/compile-workflow.ts',
-	)
+	const compileArgs: string[] = []
+	if (plugin != null && plugin !== '') {
+		compileArgs.push('--plugin', path.resolve(plugin))
+	} else {
+		compileArgs.push(...creExports.flatMap((p) => ['--cre-exports', path.resolve(p)]))
+	}
+	compileArgs.push(resolvedInput, resolvedOutput)
+
+	let javyPluginRoot: string
+	if (process.env.CRE_SDK_JAVY_PLUGIN_HOME) {
+		javyPluginRoot = path.resolve(process.env.CRE_SDK_JAVY_PLUGIN_HOME)
+	} else {
+		try {
+			javyPluginRoot = path.dirname(require.resolve('@chainlink/cre-sdk-javy-plugin/package.json'))
+		} catch {
+			javyPluginRoot = path.resolve(import.meta.dir, '../../../cre-sdk-javy-plugin')
+		}
+	}
+	const compilerPath = path.join(javyPluginRoot, 'bin/compile-workflow.ts')
 	if (existsSync(compilerPath)) {
-		await runBun(['--bun', compilerPath, resolvedInput, resolvedOutput])
+		await runBun(['--bun', compilerPath, ...compileArgs])
 	} else {
-		await runBun(['x', 'cre-compile-workflow', resolvedInput, resolvedOutput])
+		await runBun(['x', 'cre-compile-workflow', ...compileArgs])
 	}
 
 	console.info(`✅ Compiled: ${resolvedOutput}`)

package/scripts/src/compile-workflow.ts

@@ -1,17 +1,20 @@
 import { existsSync } from 'node:fs'
 import { mkdir } from 'node:fs/promises'
 import path from 'node:path'
+import { parseCompileFlags } from '@chainlink/cre-sdk-javy-plugin/scripts/parse-compile-flags'
 import { parseCompileCliArgs, skipTypeChecksFlag } from './compile-cli-args'
 import { main as compileToJs } from './compile-to-js'
 import { main as compileToWasm } from './compile-to-wasm'
 
 type CompileWorkflowOptions = {
 	skipTypeChecks?: boolean
+	creExports?: string[]
+	plugin?: string | null
 }
 
 const printUsage = () => {
 	console.error(
-		`Usage: bun compile:workflow <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
+		`Usage: bun compile:workflow [--plugin <path>] [--cre-exports <crate-dir>]... <path/to/workflow.ts> [path/to/output.wasm] [${skipTypeChecksFlag}]`,
 	)
 	console.error('Examples:')
 	console.error('  bun compile:workflow src/standard_tests/secrets/test.ts')
@@ -31,17 +34,25 @@ export const main = async (
 	let parsedInputPath: string | undefined
 	let parsedOutputPath: string | undefined
 	let parsedSkipTypeChecks = false
+	let parsedCreExports: string[] = []
+	let parsedPlugin: string | null = null
 
-	if (inputFile != null || outputWasmFile != null || options?.skipTypeChecks != null) {
+	if (inputFile != null || outputWasmFile != null || options != null) {
 		parsedInputPath = inputFile
 		parsedOutputPath = outputWasmFile
 		parsedSkipTypeChecks = options?.skipTypeChecks ?? false
+		parsedCreExports = options?.creExports ?? []
+		parsedPlugin = options?.plugin !== undefined ? options.plugin : null
 	} else {
 		try {
-			const parsed = parseCompileCliArgs(process.argv.slice(3))
+			const cliArgs = process.argv.slice(3)
+			const { creExports, plugin, rest } = parseCompileFlags(cliArgs)
+			const parsed = parseCompileCliArgs(rest)
 			parsedInputPath = parsed.inputPath
 			parsedOutputPath = parsed.outputPath
 			parsedSkipTypeChecks = parsed.skipTypeChecks
+			parsedCreExports = creExports
+			parsedPlugin = plugin
 		} catch (error) {
 			console.error(error instanceof Error ? error.message : error)
 			printUsage()
@@ -52,6 +63,11 @@ export const main = async (
 	const inputPath = parsedInputPath
 	const outputPathArg = parsedOutputPath
 
+	if (parsedPlugin != null && parsedPlugin !== '' && parsedCreExports.length > 0) {
+		console.error('❌ Error: --plugin and --cre-exports are mutually exclusive.')
+		process.exit(1)
+	}
+
 	if (!inputPath) {
 		printUsage()
 		process.exit(1)
@@ -63,33 +79,36 @@ export const main = async (
 		process.exit(1)
 	}
 
-	// Default final output = same dir, same basename, .wasm
 	const defaultWasmOut = path.join(
 		path.dirname(resolvedInput),
 		path.basename(resolvedInput).replace(/\.[^.]+$/, '.wasm'),
 	)
 	const resolvedWasmOutput = outputPathArg ? path.resolve(outputPathArg) : defaultWasmOut
-
-	// Put the intermediate JS next to the final wasm (so custom outputs stay together)
 	const resolvedJsOutput = resolvedWasmOutput.replace(/\.wasm$/i, '.js')
 
-	// Ensure directories exist (handles both intermediate JS dir and wasm dir)
 	await mkdir(path.dirname(resolvedJsOutput), { recursive: true })
 
-	console.info(`🚀 Compiling workflow`)
-	console.info(`📁 Input:   ${resolvedInput}\n`)
+	console.info('🚀 Compiling workflow')
+	console.info(`📁 Input:   ${resolvedInput}`)
+	console.info(`🧪 JS out:  ${resolvedJsOutput}`)
+	console.info(`🎯 WASM out:${resolvedWasmOutput}\n`)
 	if (parsedSkipTypeChecks) {
 		console.info(`⚠️  Skipping TypeScript checks (${skipTypeChecksFlag})`)
 	}
 
-	// Step 1: TS/JS → JS (bundled)
 	console.info('📦 Step 1: Compiling JS...')
 	await compileToJs(resolvedInput, resolvedJsOutput, { skipTypeChecks: parsedSkipTypeChecks })
 
-	// Step 2: JS → WASM
 	console.info('\n🔨 Step 2: Compiling to WASM...')
-	await compileToWasm(resolvedJsOutput, resolvedWasmOutput)
+	await compileToWasm(resolvedJsOutput, resolvedWasmOutput, parsedCreExports, parsedPlugin)
 
 	console.info(`\n✅ Workflow built: ${resolvedWasmOutput}`)
 	return resolvedWasmOutput
 }
+
+if (import.meta.main) {
+	main().catch((e) => {
+		console.error(e)
+		process.exit(1)
+	})
+}

package/scripts/src/generate-sdks.ts

@@ -1,7 +1,5 @@
 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'
@@ -65,16 +63,6 @@ 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),