@chainlink/cre-sdk 1.16.0 → 1.17.0-alpha.2

package/dist/sdk/utils/capabilities/blockchain/solana/solana-helpers.js

@@ -98,3 +98,79 @@ export const SOLANA_DEFAULT_REPORT_ENCODER = {
  * @returns The prepared report request.
  */
 export const prepareSolanaReportRequest = (payload, reportEncoder = SOLANA_DEFAULT_REPORT_ENCODER) => prepareReportRequestFromBytes(payload, reportEncoder);
+const U64_LENGTH = 8;
+const U64_SIGN_BIT = 1n << 63n;
+const UTF8_ENCODER = new TextEncoder();
+/** Encodes a bigint as a big-endian u64, wrapping modulo 2^64 (two's complement). */
+const u64BE = (value) => {
+    const bytes = new Uint8Array(U64_LENGTH);
+    new DataView(bytes.buffer).setBigUint64(0, BigInt.asUintN(64, value), false);
+    return bytes;
+};
+/**
+ * Encodes a filter value for use in a `SubkeyConfig` `ValueComparator`,
+ * matching the byte representation the Solana log-trigger capability indexes.
+ *
+ * Encodings (mirrors Go `bindings.PrepareSubkeyValue`):
+ * - `Uint8Array` — used as-is (public keys, fixed byte arrays, `bytes` fields)
+ * - `string` — UTF-8 bytes
+ * - `bigint` / integer `number` — 8-byte big-endian two's complement
+ *
+ * For `f32`/`f64` event fields use {@link prepareSubkeyFloatValue}; passing a
+ * non-integer `number` here throws.
+ *
+ * @param value - The filter value to encode.
+ * @returns The encoded comparator value bytes.
+ */
+export const prepareSubkeyValue = (value) => {
+    if (value instanceof Uint8Array) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return UTF8_ENCODER.encode(value);
+    }
+    if (typeof value === 'bigint') {
+        return u64BE(value);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isInteger(value)) {
+            throw new Error('prepareSubkeyValue: non-integer number; use prepareSubkeyFloatValue for f32/f64 values');
+        }
+        return u64BE(BigInt(value));
+    }
+    throw new Error(`prepareSubkeyValue: unsupported subkey value type ${typeof value}`);
+};
+/**
+ * Encodes an `f32`/`f64` filter value into the 8-byte big-endian
+ * representation the Solana log-trigger capability indexes.
+ *
+ * Byte-compatible with Go `bindings.EncodeIndexedValue` for floats: positive
+ * values map to `float64bits + 2^63`, others to `2^63 - float64bits`
+ * (modulo 2^64). Ordering is preserved among values of the same sign.
+ *
+ * @param value - The float filter value to encode.
+ * @returns The encoded comparator value bytes.
+ */
+export const prepareSubkeyFloatValue = (value) => {
+    const view = new DataView(new ArrayBuffer(U64_LENGTH));
+    view.setFloat64(0, value, false);
+    const bits = view.getBigUint64(0, false);
+    return u64BE(value > 0 ? bits + U64_SIGN_BIT : U64_SIGN_BIT - bits);
+};
+/** Method name Anchor uses for `emit_cpi!` self-invocations. */
+const ANCHOR_CPI_METHOD_NAME = 'anchor:event';
+const ANCHOR_CPI_METHOD_NAME_B64 = bytesToBase64(UTF8_ENCODER.encode(ANCHOR_CPI_METHOD_NAME));
+/**
+ * Builds the `CPIFilterConfig` for log triggers on events emitted via
+ * Anchor's `emit_cpi!`: destination is the program itself, method is
+ * `anchor:event`.
+ *
+ * Mirrors Go `bindings.AnchorCPILogTriggerConfig`.
+ *
+ * @param programId - The program's public key, as 32 raw bytes or a base58 string.
+ * @returns The CPI filter config in protobuf JSON shape.
+ */
+export const anchorCPILogTriggerConfig = (programId) => ({
+    destAddress: bytesToBase64(typeof programId === 'string' ? solanaAddressToBytes(programId) : programId),
+    methodName: ANCHOR_CPI_METHOD_NAME_B64,
+});

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

@@ -6,6 +6,7 @@ export * from './chain-selectors';
 export * from './decode-json';
 export * from './hex-utils';
 export * from './safe-json-stringify';
+export * from './triggers/trigger-interface';
 export * from './values/consensus_aggregators';
 export * from './values/serializer_types';
 export * from './values/value';

package/dist/sdk/utils/index.js

@@ -5,6 +5,7 @@ export * from './chain-selectors';
 export * from './decode-json';
 export * from './hex-utils';
 export * from './safe-json-stringify';
+export * from './triggers/trigger-interface';
 export * from './values/consensus_aggregators';
 export * from './values/serializer_types';
 export * from './values/value';

package/dist/sdk/utils/triggers/trigger-interface.d.ts

@@ -19,3 +19,10 @@ export interface Trigger<TRawTriggerOutput extends Message<string>, TTriggerOutp
     /** Transform the raw trigger output to the adapted type */
     adapt(rawOutput: TRawTriggerOutput): TTriggerOutput;
 }
+/**
+ * Wraps a trigger with an extra output transformation, delegating everything
+ * else to the wrapped trigger. The TypeScript analog of Go bindings embedding
+ * `cre.Trigger` and overriding only `Adapt` — generated bindings use this to
+ * decode raw trigger outputs into typed data.
+ */
+export declare const adaptTrigger: <TRaw extends Message<string>, TIn, TOut>(trigger: Trigger<TRaw, TIn>, adapt: (output: TIn) => TOut) => Trigger<TRaw, TOut>;

package/dist/sdk/utils/triggers/trigger-interface.js

@@ -1 +1,13 @@
-export {};
+/**
+ * Wraps a trigger with an extra output transformation, delegating everything
+ * else to the wrapped trigger. The TypeScript analog of Go bindings embedding
+ * `cre.Trigger` and overriding only `Adapt` — generated bindings use this to
+ * decode raw trigger outputs into typed data.
+ */
+export const adaptTrigger = (trigger, adapt) => ({
+    capabilityId: () => trigger.capabilityId(),
+    method: () => trigger.method(),
+    outputSchema: () => trigger.outputSchema(),
+    configAsAny: () => trigger.configAsAny(),
+    adapt: (rawOutput) => adapt(trigger.adapt(rawOutput)),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chainlink/cre-sdk",
-	"version": "1.16.0",
+	"version": "1.17.0-alpha.2",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -73,7 +73,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#3e718d1c9910b2952c50befe378b0fe8707e6647",
+		"chain-selectors": "https://github.com/smartcontractkit/chain-selectors.git#7d1e9798b28404818eba5246383c0688c4ee0e1f",
 		"fast-glob": "3.3.3",
 		"ts-proto": "2.7.5",
 		"typescript": "5.9.3",