@chainlink/cre-sdk 1.15.0 → 1.17.0-alpha.1

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

@@ -1,16 +0,0 @@
-import { bytesToBase64 } from '../../hex-utils';
-/**
- * Chain-agnostic core for building a `ReportRequest` from raw payload bytes.
- *
- * Per-chain wrappers (`prepareReportRequest` for EVM hex payloads,
- * `prepareSolanaReportRequest` for Solana Borsh payloads) delegate here so
- * there is a single payload-assembly path.
- *
- * @param payload - The raw payload bytes to be signed.
- * @param reportEncoder - The report encoder settings to use.
- * @returns The prepared report request.
- */
-export const prepareReportRequestFromBytes = (payload, reportEncoder) => ({
-    encodedPayload: bytesToBase64(payload),
-    ...reportEncoder,
-});

package/dist/sdk/utils/capabilities/blockchain/solana/solana-helpers.d.ts

@@ -1,101 +0,0 @@
-import type { AccountMetaJson, ComputeConfigJson } from '../../../../../generated/capabilities/blockchain/solana/v1alpha/client_pb';
-import type { ReportRequestJson } from '../../../../../generated/sdk/v1alpha/sdk_pb';
-import { type ReportEncoder } from '../report-helpers';
-/**
- * An account passed to the Solana capability's `remainingAccounts` list.
- * Build instances with {@link solanaAccountMeta}; generated bindings convert
- * to the capability's protobuf JSON shape internally.
- */
-export interface SolanaAccountMeta {
-    publicKey: Uint8Array;
-    isWritable: boolean;
-}
-/**
- * Compute settings for a Solana write-report request. Mirrors the
- * capability's `ComputeConfig` protobuf JSON shape.
- */
-export type SolanaComputeConfig = ComputeConfigJson;
-/**
- * The minimal account shape needed by {@link calculateAccountsHash} —
- * only the public key participates in the hash. Structurally compatible
- * with both {@link SolanaAccountMeta} and the capability's protobuf
- * `AccountMeta`.
- */
-export type SolanaAccountInput = Pick<SolanaAccountMeta, 'publicKey'> & Partial<Pick<SolanaAccountMeta, 'isWritable'>>;
-/**
- * Converts a base58-encoded Solana address to its 32 raw bytes.
- *
- * @param base58Address - The base58-encoded address (validated).
- * @returns The 32-byte public key.
- */
-export declare const solanaAddressToBytes: (base58Address: string) => Uint8Array;
-/**
- * Builds an account entry for the Solana capability's `remainingAccounts` list.
- *
- * @param publicKey - The account's public key, as 32 raw bytes or a base58 string.
- * @param isWritable - Whether the account is writable. Defaults to false.
- * @returns The account meta.
- */
-export declare const solanaAccountMeta: (publicKey: Uint8Array | string, isWritable?: boolean) => SolanaAccountMeta;
-/**
- * Converts {@link SolanaAccountMeta} entries to the capability's protobuf
- * JSON `AccountMeta` shape (base64 public keys), as expected by
- * `SolanaClient.writeReport`. Used by generated bindings.
- */
-export declare const solanaAccountMetasToJson: (accounts: ReadonlyArray<SolanaAccountMeta>) => AccountMetaJson[];
-/**
- * Computes the SHA-256 hash of the concatenated public keys of the given
- * accounts, matching the keystone-forwarder's on-chain account hash
- * verification. Nullish entries are skipped; account order matters.
- *
- * Mirrors Go `bindings.CalculateAccountsHash`.
- *
- * @param accounts - The accounts whose public keys are hashed.
- * @returns The 32-byte account hash.
- */
-export declare const calculateAccountsHash: (accounts: ReadonlyArray<SolanaAccountInput | null | undefined>) => Uint8Array;
-export interface ForwarderReport {
-    /** The 32-byte hash from `calculateAccountsHash`. */
-    accountHash: Uint8Array;
-    /** The Borsh-encoded report payload the receiver's `on_report` deserializes. */
-    payload: Uint8Array;
-}
-/**
- * Borsh-encodes a `ForwarderReport` for the keystone-forwarder:
- * `[32-byte accountHash][u32-LE payload length][payload bytes]`.
- *
- * Mirrors Go `bindings.ForwarderReport.Marshal`.
- *
- * @param report - The account hash and payload to encode.
- * @returns The encoded forwarder report.
- */
-export declare const encodeForwarderReport: (report: ForwarderReport) => Uint8Array;
-/**
- * Returns the Anchor/Borsh encoding of a Vec whose elements are opaque byte
- * payloads: `[u32-LE element count][concatenated element payloads]`.
- * Each element must already be fully serialized for one Vec item on the wire.
- *
- * Mirrors Go's generated `EncodeBorshVecU32`.
- *
- * @param elementPayloads - The pre-encoded Vec elements.
- * @returns The encoded Vec.
- */
-export declare const encodeBorshVecU32: (elementPayloads: ReadonlyArray<Uint8Array>) => Uint8Array;
-/**
- * Default values expected by the Solana capability for report encoding.
- * Mirrors the constants emitted by the Go Solana bindings generator.
- */
-export declare const SOLANA_DEFAULT_REPORT_ENCODER: {
-    encoderName: string;
-    signingAlgo: string;
-    hashingAlgo: string;
-};
-/**
- * Prepares a report request for the Solana capability to pass to `.report()`.
- * Takes raw bytes (typically an encoded `ForwarderReport`), not hex.
- *
- * @param payload - The encoded payload bytes to be signed.
- * @param reportEncoder - The report encoder to use. Defaults to SOLANA_DEFAULT_REPORT_ENCODER.
- * @returns The prepared report request.
- */
-export declare const prepareSolanaReportRequest: (payload: Uint8Array, reportEncoder?: ReportEncoder) => ReportRequestJson;

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

@@ -1,100 +0,0 @@
-import { bytesToBase64 } from '../../../hex-utils';
-import { sha256 } from '@noble/hashes/sha2.js';
-import { concatBytes } from '@noble/hashes/utils.js';
-import { address, getAddressEncoder } from '@solana/addresses';
-import { prepareReportRequestFromBytes } from '../report-helpers';
-const ACCOUNT_HASH_LENGTH = 32;
-const U32_LENGTH = 4;
-// Stateless address encoder; hoisted so the encoder stack isn't rebuilt per call.
-const ADDRESS_ENCODER = getAddressEncoder();
-/** Encodes a number as a little-endian Borsh u32. */
-const u32LE = (value) => {
-    const bytes = new Uint8Array(U32_LENGTH);
-    new DataView(bytes.buffer).setUint32(0, value, true);
-    return bytes;
-};
-/**
- * Converts a base58-encoded Solana address to its 32 raw bytes.
- *
- * @param base58Address - The base58-encoded address (validated).
- * @returns The 32-byte public key.
- */
-export const solanaAddressToBytes = (base58Address) => new Uint8Array(ADDRESS_ENCODER.encode(address(base58Address)));
-/**
- * Builds an account entry for the Solana capability's `remainingAccounts` list.
- *
- * @param publicKey - The account's public key, as 32 raw bytes or a base58 string.
- * @param isWritable - Whether the account is writable. Defaults to false.
- * @returns The account meta.
- */
-export const solanaAccountMeta = (publicKey, isWritable = false) => ({
-    publicKey: typeof publicKey === 'string' ? solanaAddressToBytes(publicKey) : publicKey,
-    isWritable,
-});
-/**
- * Converts {@link SolanaAccountMeta} entries to the capability's protobuf
- * JSON `AccountMeta` shape (base64 public keys), as expected by
- * `SolanaClient.writeReport`. Used by generated bindings.
- */
-export const solanaAccountMetasToJson = (accounts) => accounts.map((account) => ({
-    publicKey: bytesToBase64(account.publicKey),
-    isWritable: account.isWritable,
-}));
-/**
- * Computes the SHA-256 hash of the concatenated public keys of the given
- * accounts, matching the keystone-forwarder's on-chain account hash
- * verification. Nullish entries are skipped; account order matters.
- *
- * Mirrors Go `bindings.CalculateAccountsHash`.
- *
- * @param accounts - The accounts whose public keys are hashed.
- * @returns The 32-byte account hash.
- */
-export const calculateAccountsHash = (accounts) => {
-    const publicKeys = accounts.filter((acc) => acc != null).map(({ publicKey }) => publicKey);
-    return sha256(concatBytes(...publicKeys));
-};
-/**
- * Borsh-encodes a `ForwarderReport` for the keystone-forwarder:
- * `[32-byte accountHash][u32-LE payload length][payload bytes]`.
- *
- * Mirrors Go `bindings.ForwarderReport.Marshal`.
- *
- * @param report - The account hash and payload to encode.
- * @returns The encoded forwarder report.
- */
-export const encodeForwarderReport = (report) => {
-    if (report.accountHash.length !== ACCOUNT_HASH_LENGTH) {
-        throw new Error(`encodeForwarderReport: accountHash must be exactly ${ACCOUNT_HASH_LENGTH} bytes, got ${report.accountHash.length}`);
-    }
-    return concatBytes(report.accountHash, u32LE(report.payload.length), report.payload);
-};
-/**
- * Returns the Anchor/Borsh encoding of a Vec whose elements are opaque byte
- * payloads: `[u32-LE element count][concatenated element payloads]`.
- * Each element must already be fully serialized for one Vec item on the wire.
- *
- * Mirrors Go's generated `EncodeBorshVecU32`.
- *
- * @param elementPayloads - The pre-encoded Vec elements.
- * @returns The encoded Vec.
- */
-export const encodeBorshVecU32 = (elementPayloads) => concatBytes(u32LE(elementPayloads.length), ...elementPayloads);
-/**
- * Default values expected by the Solana capability for report encoding.
- * Mirrors the constants emitted by the Go Solana bindings generator.
- */
-export const SOLANA_DEFAULT_REPORT_ENCODER = {
-    encoderName: 'solana',
-    signingAlgo: 'ecdsa',
-    hashingAlgo: 'keccak256',
-};
-/**
- * Prepares a report request for the Solana capability to pass to `.report()`.
- * Takes raw bytes (typically an encoded `ForwarderReport`), not hex.
- *
- * @param payload - The encoded payload bytes to be signed.
- * @param reportEncoder - The report encoder to use. Defaults to SOLANA_DEFAULT_REPORT_ENCODER.
- * @returns The prepared report request.
- */
-export const prepareSolanaReportRequest = (payload, reportEncoder = SOLANA_DEFAULT_REPORT_ENCODER) => prepareReportRequestFromBytes(payload, reportEncoder);