@primuslabs/fhetransform-sdk 0.4.0

package/dist/jazz/jazz-client.d.ts

@@ -0,0 +1,18 @@
+import { IJazzClient, JazzConfig } from "./jazz-client-i.js";
+import { EncryptParameters, EncryptPayload, EncryptResult } from "./encrypt.js";
+import { GenerateTransportKeyPairResult } from "./key-pair.js";
+import { SignDecryptionPermitParameters, SignedDecryptionPermitResult } from "./permit.js";
+import { PublicDecryptParameters, PublicDecryptPayload, PublicDecryptResult } from "./public-decrypt.js";
+import { UserDecryptParameters, UserDecryptPayload, UserDecryptResult } from "./user-decrypt.js";
+import type { FheTransformSDK } from "../sdk/fhetransform-sdk";
+export declare class JazzClientImpl implements IJazzClient {
+    private readonly config;
+    readonly sdk: FheTransformSDK;
+    constructor(sdk: FheTransformSDK, config: JazzConfig);
+    encryptValue: <T extends EncryptPayload>(parameters: EncryptParameters<T>) => Promise<EncryptResult<T>>;
+    decryptPublicValue: <T extends PublicDecryptPayload>(parameters: PublicDecryptParameters<T>) => Promise<PublicDecryptResult<T>>;
+    generateTransportKeyPair: () => Promise<GenerateTransportKeyPairResult>;
+    signDecryptionPermit: (parameters: SignDecryptionPermitParameters) => Promise<SignedDecryptionPermitResult>;
+    decryptUserValue: <T extends UserDecryptPayload>(parameters: UserDecryptParameters<T>) => Promise<UserDecryptResult<T>>;
+}
+export declare function createJazzClient(sdk: FheTransformSDK, config: JazzConfig): IJazzClient;

package/dist/jazz/jazz-client.js

@@ -0,0 +1,24 @@
+import { encryptValue } from "./encrypt.js";
+import { generateTransportKeyPair } from "./key-pair.js";
+import { signDecryptionPermit } from "./permit.js";
+import { decryptPublicValue } from "./public-decrypt.js";
+import { decryptUserValue } from "./user-decrypt.js";
+export class JazzClientImpl {
+    config;
+    sdk;
+    constructor(sdk, config) {
+        this.config = config;
+        this.sdk = sdk;
+    }
+    // IMPLEMENTS
+    encryptValue = async (parameters) => encryptValue(this, parameters);
+    decryptPublicValue = async (parameters) => decryptPublicValue(this, parameters);
+    generateTransportKeyPair = async () => generateTransportKeyPair(this.sdk);
+    signDecryptionPermit = async (parameters) => signDecryptionPermit(this.sdk, parameters);
+    decryptUserValue = async (parameters) => decryptUserValue(this, parameters);
+}
+export function createJazzClient(sdk, config) {
+    const c = new JazzClientImpl(sdk, config);
+    return c;
+}
+//# sourceMappingURL=jazz-client.js.map

package/dist/jazz/jazz-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jazz-client.js","sourceRoot":"","sources":["../../src/jazz/jazz-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAkC,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAgE,MAAM,aAAa,CAAC;AACjH,OAAO,EAAE,kBAAkB,EAAsE,MAAM,qBAAqB,CAAC;AAC7H,OAAO,EAAE,gBAAgB,EAAgE,MAAM,mBAAmB,CAAC;AAGnH,MAAM,OAAO,cAAc;IAG0B;IAF1C,GAAG,CAAkB;IAE9B,YAAY,GAAoB,EAAmB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QACnE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,aAAa;IACb,YAAY,GAAG,KAAK,EAA4B,UAAgC,EACpD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE9D,kBAAkB,GAAG,KAAK,EAAkC,UAAsC,EAChE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE1E,wBAAwB,GAAG,KAAK,IACU,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChF,oBAAoB,GAAG,KAAK,EAAE,UAA0C,EAChC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAEtF,gBAAgB,GAAG,KAAK,EAAgC,UAAoC,EAC5D,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;CACvE;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAoB,EAAE,MAAkB;IACvE,MAAM,CAAC,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/jazz/key-pair.d.ts

@@ -0,0 +1,50 @@
+import { Address, BytesHex } from "../core/primitives.js";
+import { FheTransformSDK } from "../sdk/fhetransform-sdk.js";
+/**
+ * Branded type for TransportKeyPair to ensure type safety.
+ */
+declare const TransportKeyPairBrand: unique symbol;
+/**
+ * Transport key pair for secure communication.
+ *
+ * This key pair is used for transport-level encryption and authentication.
+ * The private key should never be exposed outside of secure storage.
+ */
+export type TransportKeyPair = {
+    /** Private key as hex with 0x prefix (keep secure) */
+    readonly privateKey: BytesHex;
+    /** Public key as hex with 0x prefix (can be shared) */
+    readonly publicKey: BytesHex;
+    /** Brand to prevent accidental type compatibility */
+    readonly [TransportKeyPairBrand]: true;
+};
+/**
+ * Result of generating a transport key pair.
+ */
+export type GenerateTransportKeyPairResult = TransportKeyPair;
+/**
+ * Generates a new transport key pair using the KMS backend.
+ *
+ * This function initializes the KMS module and generates a new key pair.
+ * The generated keys are returned as hex strings with 0x prefix.
+ *
+ * @returns Promise resolving to TransportKeyPair containing private and public keys
+ * @throws Error if KMS initialization or key generation fails
+ */
+export declare function generateTransportKeyPair(sdk: FheTransformSDK): Promise<GenerateTransportKeyPairResult>;
+/**
+ * Gets an existing transport key pair from cache, or generates a new one.
+ *
+ * This function implements a caching strategy:
+ * 1. Checks if the key pair exists in cache and is still valid (TTL)
+ * 2. If expired or missing, generates a new key pair
+ * 3. Saves the new key pair to cache
+ * 4. Returns the key pair
+ *
+ * @param client - The Jazz client instance
+ * @param signerAddress - Address of the signer (used as cache key prefix)
+ * @returns Promise resolving to TransportKeyPair
+ * @throws Error if KMS initialization or key generation fails
+ */
+export declare function getOrCreateKeyPair(sdk: FheTransformSDK, signerAddress: Address): Promise<TransportKeyPair>;
+export {};

package/dist/jazz/key-pair.js

@@ -0,0 +1,166 @@
+import { bytesToHex } from "../core/bytes.js";
+import { kms_enc_keygen, kms_init } from "../core/kms.js";
+import { logger } from "../core/logger.js";
+import { DEFAULT_TRANSPORT_KEY_PAIR_TTL_SECONDS } from "../core/constants.js";
+import { FheErrorCode } from "../core/errors/error-codes.js";
+import { FheError } from "../core/errors/fhe-error.js";
+// ============================================================================
+// Key Pair Generation
+// ============================================================================
+/**
+ * Generates a new transport key pair using the KMS backend.
+ *
+ * This function initializes the KMS module and generates a new key pair.
+ * The generated keys are returned as hex strings with 0x prefix.
+ *
+ * @returns Promise resolving to TransportKeyPair containing private and public keys
+ * @throws Error if KMS initialization or key generation fails
+ */
+export async function generateTransportKeyPair(sdk) {
+    // ============================================================================
+    // Step 1: Initialize KMS
+    // ============================================================================
+    logger.trace('[generateTransportKeyPair] Initializing KMS module');
+    await kms_init();
+    // ============================================================================
+    // Step 2: Generate Key Pair
+    // ============================================================================
+    logger.debug('[generateTransportKeyPair] Generating new key pair');
+    const [sk, pk] = kms_enc_keygen();
+    if (!sk || !pk) {
+        throw new FheError({ code: FheErrorCode.EncryptionFailed, message: "KMS key generation returned no keys" });
+    }
+    logger.debug('[generateTransportKeyPair] Key pair generated', {
+        skLength: sk.length,
+        pkLength: pk.length,
+    });
+    // ============================================================================
+    // Step 3: Convert to Hex
+    // ============================================================================
+    const privateKey = bytesToHex(sk);
+    const publicKey = bytesToHex(pk);
+    logger.debug('[generateTransportKeyPair] Key pair generated successfully', {
+        privateKeyLength: privateKey.length,
+        publicKeyLength: publicKey.length,
+    });
+    return {
+        privateKey: privateKey,
+        publicKey: publicKey,
+    };
+}
+// ============================================================================
+// Key Pair Management with Caching
+// ============================================================================
+/**
+ * Gets an existing transport key pair from cache, or generates a new one.
+ *
+ * This function implements a caching strategy:
+ * 1. Checks if the key pair exists in cache and is still valid (TTL)
+ * 2. If expired or missing, generates a new key pair
+ * 3. Saves the new key pair to cache
+ * 4. Returns the key pair
+ *
+ * @param client - The Jazz client instance
+ * @param signerAddress - Address of the signer (used as cache key prefix)
+ * @returns Promise resolving to TransportKeyPair
+ * @throws Error if KMS initialization or key generation fails
+ */
+export async function getOrCreateKeyPair(sdk, signerAddress) {
+    // Enter method
+    logger.debug('[getOrCreateKeyPair] Enter', {
+        signerAddress,
+        hasClient: !!sdk,
+    });
+    // ============================================================================
+    // Step 1: Build Cache Keys
+    // ============================================================================
+    const KEY_PAIR_PREFIX = signerAddress;
+    const KEY_PAIR_SK_PATH = `keypair:${KEY_PAIR_PREFIX}_sk`;
+    const KEY_PAIR_PK_PATH = `keypair:${KEY_PAIR_PREFIX}_pk`;
+    // Get TTL from config or use default
+    const KEY_PAIR_TTL_SECONDS = sdk.config.transportKeyPairTTL ??
+        DEFAULT_TRANSPORT_KEY_PAIR_TTL_SECONDS;
+    logger.debug('[getOrCreateKeyPair] Cache configuration', {
+        skPath: KEY_PAIR_SK_PATH,
+        pkPath: KEY_PAIR_PK_PATH,
+        ttlSeconds: KEY_PAIR_TTL_SECONDS,
+    });
+    // ============================================================================
+    // Step 2: Check Cache Expiration
+    // ============================================================================
+    const [shouldRefreshSk, shouldRefreshPk] = await Promise.all([
+        sdk.cacheManager.shouldRefresh(KEY_PAIR_SK_PATH, KEY_PAIR_TTL_SECONDS),
+        sdk.cacheManager.shouldRefresh(KEY_PAIR_PK_PATH, KEY_PAIR_TTL_SECONDS),
+    ]);
+    logger.debug('[getOrCreateKeyPair] Cache status', {
+        skExpired: shouldRefreshSk,
+        pkExpired: shouldRefreshPk,
+        needsRefresh: shouldRefreshSk || shouldRefreshPk,
+    });
+    // ============================================================================
+    // Step 3: Initialize KMS
+    // ============================================================================
+    // TODO: Move kms_init() inside the KMS API wrapper
+    logger.trace('[getOrCreateKeyPair] Initializing KMS module');
+    await kms_init();
+    // ============================================================================
+    // Step 4: Generate or Load Key Pair
+    // ============================================================================
+    let sk;
+    let pk;
+    const needsRefresh = shouldRefreshSk || shouldRefreshPk;
+    if (needsRefresh) {
+        logger.debug('[getOrCreateKeyPair] Generating new key pair', {
+            reason: shouldRefreshSk && shouldRefreshPk ? 'both expired' :
+                shouldRefreshSk ? 'private key expired' : 'public key expired',
+        });
+        // Generate new key pair
+        [sk, pk] = kms_enc_keygen();
+        if (!sk || !pk) {
+            throw new FheError({ code: FheErrorCode.EncryptionFailed, message: "KMS key generation returned no keys" });
+        }
+        logger.debug('[getOrCreateKeyPair] Key pair generated', {
+            skLength: sk.length,
+            pkLength: pk.length,
+        });
+        // Save to cache
+        await Promise.all([
+            sdk.cacheManager.save(KEY_PAIR_SK_PATH, sk),
+            sdk.cacheManager.save(KEY_PAIR_PK_PATH, pk),
+        ]);
+        logger.debug('[getOrCreateKeyPair] Key pair saved to cache', {
+            skPath: KEY_PAIR_SK_PATH,
+            pkPath: KEY_PAIR_PK_PATH,
+        });
+    }
+    else {
+        logger.debug('[getOrCreateKeyPair] Loading key pair from cache');
+        // Load from cache
+        [sk, pk] = await Promise.all([
+            sdk.cacheManager.load(KEY_PAIR_SK_PATH),
+            sdk.cacheManager.load(KEY_PAIR_PK_PATH),
+        ]);
+        if (!sk || !pk) {
+            logger.error('[getOrCreateKeyPair] Cache load failed', {
+                hasSk: !!sk,
+                hasPk: !!pk,
+            });
+            throw new FheError({ code: FheErrorCode.KeyPairNotFound, message: 'Failed to load key pair from cache' });
+        }
+        logger.debug('[getOrCreateKeyPair] Key pair loaded from cache', {
+            skLength: sk.length,
+            pkLength: pk.length,
+        });
+    }
+    // ============================================================================
+    // Step 5: Convert to Hex and Return
+    // ============================================================================
+    const privateKey = bytesToHex(sk);
+    const publicKey = bytesToHex(pk);
+    logger.debug('[getOrCreateKeyPair] Key pair ready', { signerAddress, fromCache: !needsRefresh });
+    return {
+        privateKey: privateKey,
+        publicKey: publicKey,
+    };
+}
+//# sourceMappingURL=key-pair.js.map

package/dist/jazz/key-pair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-pair.js","sourceRoot":"","sources":["../../src/jazz/key-pair.ts"],"names":[],"mappings":"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"}

package/dist/jazz/mock/fake.d.ts

@@ -0,0 +1,3 @@
+import { HandleLike } from "../../core/fhe-type.js";
+import { BytesHex } from "../../core/primitives.js";
+export declare function fakeAbiEncodeClearValues(ctHandles: HandleLike[]): BytesHex;

package/dist/jazz/mock/fake.js

@@ -0,0 +1,23 @@
+import { ethers } from "ethers";
+import { getHandleAbiType } from "../../core/handle.js";
+import { logger } from "../../core/logger.js";
+export function fakeAbiEncodeClearValues(ctHandles) {
+    const clearTypes = [];
+    const clearTexts = [];
+    for (let i = 0; i < ctHandles.length; i++) {
+        const handle = ctHandles[i];
+        const abiType = getHandleAbiType(handle);
+        clearTypes.push(abiType);
+        if (abiType == "bool") {
+            clearTexts.push(1);
+        }
+        else {
+            clearTexts.push((i + 1) * 3);
+        }
+    }
+    const abiCoder = ethers.AbiCoder.defaultAbiCoder();
+    const abiEncodeClearValues = abiCoder.encode(clearTypes, clearTexts);
+    logger.debug('[fakeAbiEncodeClearValues] Encoded values', { abiEncodeClearValues });
+    return abiEncodeClearValues;
+}
+//# sourceMappingURL=fake.js.map

package/dist/jazz/mock/fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.js","sourceRoot":"","sources":["../../../src/jazz/mock/fake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,MAAM,UAAU,wBAAwB,CAAC,SAAuB;IAC9D,MAAM,UAAU,GAAG,EAAE,CAAA;IACrB,MAAM,UAAU,GAAG,EAAE,CAAA;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;IACnD,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAa,CAAC;IACjF,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAEpF,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/jazz/mock/fetch-input-proof.d.ts

@@ -0,0 +1,4 @@
+import { IJazzClient } from "../jazz-client-i.js";
+import { FetchInputProofParameters, FetchInputProofResult } from "../types/input-proof.js";
+import { EncryptPayloadItem } from "../encrypt.js";
+export declare function fetchInputProof(client: IJazzClient, parameters: FetchInputProofParameters, payloads: EncryptPayloadItem[]): Promise<FetchInputProofResult>;

package/dist/jazz/mock/fetch-input-proof.js

@@ -0,0 +1,63 @@
+import { ethers } from "ethers";
+import { makeHandle } from "../../core/handle.js";
+import { logger } from "../../core/logger.js";
+const inputProofAbi = [
+    {
+        type: 'function',
+        name: 'inputProofMock',
+        inputs: [
+            {
+                name: 'ctHandles',
+                type: 'bytes32[]',
+                internalType: 'bytes32[]',
+            },
+            { name: 'userAddress', type: 'address', internalType: 'address' },
+            {
+                name: 'contractAddress',
+                type: 'address',
+                internalType: 'address',
+            },
+            { name: 'extraData', type: 'bytes', internalType: 'bytes' },
+        ],
+        outputs: [
+            { name: 'digest', type: 'bytes32', internalType: 'bytes32' },
+            { name: 'signers', type: 'address[]', internalType: 'address[]' },
+            { name: 'threshold', type: 'uint256', internalType: 'uint256' },
+        ],
+        stateMutability: 'view',
+    },
+];
+export async function fetchInputProof(client, parameters, payloads) {
+    const { options, payload } = parameters;
+    const sysContractInfo = await client.sdk.getSystemContractInfo();
+    const chainId = payload.zkProof.chainId;
+    const extraData = "0x00";
+    const handles = [];
+    for (const item of payloads) {
+        const handle = makeHandle(Number(chainId), item.fheType);
+        handles.push(handle);
+    }
+    const provider = await client.sdk.requireProvider();
+    const contract = new ethers.Contract(sysContractInfo.ciphertextVerificationAddress, inputProofAbi, provider);
+    const res = await contract.inputProofMock(handles, payload.zkProof.userAddress, payload.zkProof.contractAddress, extraData);
+    logger.debug('[fetchInputProof] inputProofMock result', res);
+    const digest = res[0];
+    const alphatrionEip712Signatures = [];
+    {
+        const privateKey = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+        const signingKey = new ethers.SigningKey(privateKey);
+        const signature = signingKey.sign(digest);
+        logger.debug('[fetchInputProof] Signature generated:', signature);
+        const compact = ethers.Signature.from(signature).serialized;
+        logger.debug('[fetchInputProof] Compact signature generated', compact);
+        alphatrionEip712Signatures.push(compact);
+    }
+    const result = {
+        handles,
+        alphatrionEip712Signatures,
+        extraData,
+    };
+    logger.debug('[fetchInputProof] Mock result built', { result });
+    return result;
+}
+//# sourceMappingURL=fetch-input-proof.js.map

package/dist/jazz/mock/fetch-input-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-input-proof.js","sourceRoot":"","sources":["../../../src/jazz/mock/fetch-input-proof.ts"],"names":[],"mappings":"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"}

package/dist/jazz/mock/fetch-key-url.d.ts

@@ -0,0 +1,3 @@
+import { IJazzClient } from "../jazz-client-i.js";
+import { FetchKeyUrlParameters, FetchKeyUrlResult } from "../types/key-url.js";
+export declare function fetchKeyUrl(client: IJazzClient, parameters: FetchKeyUrlParameters): Promise<FetchKeyUrlResult>;

package/dist/jazz/mock/fetch-key-url.js

@@ -0,0 +1,15 @@
+export async function fetchKeyUrl(client, parameters) {
+    const keyUrlResult = {
+        publicKeySource: {
+            id: "mock-pk-id",
+            url: "_pk_mcl_snark1.bin", // local file
+        },
+        crsSource: {
+            id: "mock-crs-id",
+            url: "_crs_mcl_snark1.bin", // local file
+            capacity: 2048,
+        },
+    };
+    return keyUrlResult;
+}
+//# sourceMappingURL=fetch-key-url.js.map

package/dist/jazz/mock/fetch-key-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-key-url.js","sourceRoot":"","sources":["../../../src/jazz/mock/fetch-key-url.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAmB,EACnB,UAAiC;IAGjC,MAAM,YAAY,GAAqB;QACrC,eAAe,EAAE;YACf,EAAE,EAAE,YAAY;YAChB,GAAG,EAAE,oBAAoB,EAAE,aAAa;SACzC;QACD,SAAS,EAAE;YACT,EAAE,EAAE,aAAa;YACjB,GAAG,EAAE,qBAAqB,EAAE,aAAa;YACzC,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/jazz/mock/fetch-public-decrypt.d.ts

@@ -0,0 +1,3 @@
+import { IJazzClient } from "../jazz-client-i.js";
+import { FetchPublicDecryptParameters, FetchPublicDecryptResult } from "../types/public-decrypt.js";
+export declare function fetchPublicDecrypt(client: IJazzClient, parameters: FetchPublicDecryptParameters): Promise<FetchPublicDecryptResult>;

package/dist/jazz/mock/fetch-public-decrypt.js

@@ -0,0 +1,81 @@
+import { ethers } from "ethers";
+import { fakeAbiEncodeClearValues } from "./fake.js";
+import { logger } from "../../core/logger.js";
+const publicDecryptAbi = [
+    {
+        "inputs": [
+            {
+                "internalType": "bytes32[]",
+                "name": "handles",
+                "type": "bytes32[]"
+            },
+            {
+                "internalType": "bytes",
+                "name": "decryptedResult",
+                "type": "bytes"
+            }
+        ],
+        "name": "publicDecryptMock",
+        "outputs": [
+            {
+                "internalType": "bytes32",
+                "name": "digest",
+                "type": "bytes32"
+            },
+            {
+                "internalType": "address[]",
+                "name": "signers",
+                "type": "address[]"
+            },
+            {
+                "internalType": "uint256",
+                "name": "threshold",
+                "type": "uint256"
+            },
+            {
+                "internalType": "bytes",
+                "name": "extraData",
+                "type": "bytes"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    }
+];
+export async function fetchPublicDecrypt(client, parameters) {
+    const { options, payload } = parameters;
+    const sysContractInfo = await client.sdk.getSystemContractInfo();
+    const ctHandles = payload.orderedHandles;
+    const abiEncodeClearValues = fakeAbiEncodeClearValues([...ctHandles]);
+    const decryptedResult = abiEncodeClearValues;
+    // {
+    //   logger.debug("Clear txt", clearTexts)
+    //   logger.debug("Encoded:", encoded);
+    //   const decoded = abiCoder.decode(clearTypes, encoded);
+    //   logger.debug("Decoded:", decoded);
+    // }
+    const provider = await client.sdk.requireProvider();
+    const contract = new ethers.Contract(sysContractInfo.decryptionContractAddress, publicDecryptAbi, provider);
+    const res = await contract.publicDecryptMock(ctHandles, decryptedResult);
+    logger.debug('[fetchPublicDecrypt] publicDecryptMock result', { res });
+    const digest = res[0];
+    const signersAddress = res[1];
+    const kmsPublicDecryptEIP712Signatures = [];
+    {
+        const privateKey = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+        const signingKey = new ethers.SigningKey(privateKey);
+        const signature = signingKey.sign(digest);
+        logger.debug('[fetchPublicDecrypt] Signature generated', signature);
+        const compact = ethers.Signature.from(signature).serialized;
+        logger.debug('[fetchPublicDecrypt] Compact signature generated', compact);
+        kmsPublicDecryptEIP712Signatures.push(compact);
+    }
+    const result = {
+        orderedAbiEncodedClearValues: decryptedResult,
+        kmsPublicDecryptEIP712Signatures,
+        extraData: res[3],
+    };
+    logger.debug('[fetchPublicDecrypt] Mock result built', { result });
+    return result;
+}
+//# sourceMappingURL=fetch-public-decrypt.js.map

package/dist/jazz/mock/fetch-public-decrypt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-public-decrypt.js","sourceRoot":"","sources":["../../../src/jazz/mock/fetch-public-decrypt.ts"],"names":[],"mappings":"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"}

package/dist/jazz/mock/fetch-user-decrypt.d.ts

@@ -0,0 +1,4 @@
+import { IJazzClient } from "../jazz-client-i.js";
+import { FetchUserDecryptParameters, FetchUserDecryptResult } from "../types/user-decrypt.js";
+import { TransportKeyPair } from "../key-pair.js";
+export declare function fetchUserDecrypt(client: IJazzClient, parameters: FetchUserDecryptParameters, keypair: TransportKeyPair): Promise<FetchUserDecryptResult>;