@primuslabs/fhetransform-sdk 0.4.0

package/dist/runtime/node.js

@@ -0,0 +1,95 @@
+/**
+ * Node.js-specific implementations for KMS, cache, and file operations.
+ * These functions are designed to run exclusively in Node.js environments.
+ */
+import { logger } from "../core/logger.js";
+/**
+ * Creates a filesystem driver for Node.js cache storage using unstorage.
+ *
+ * @param options - Cache configuration options
+ * @param options.baseDir - Base directory for cache files (default: "./.cache")
+ * @returns A filesystem storage driver instance
+ * @throws Error if the unstorage driver module fails to load
+ */
+export async function createCacheDriver(options = {}) {
+    // Enter method
+    const baseDir = options.baseDir || "./.cache";
+    logger.debug('[createCacheDriver] Creating filesystem cache driver (Node.js)', {
+        baseDir,
+    });
+    try {
+        // Dynamically import the unstorage fs driver
+        logger.trace('[createCacheDriver] Importing unstorage/drivers/fs');
+        const { default: fsDriver } = await import("unstorage/drivers/fs");
+        // Create and return the driver instance
+        const driver = fsDriver({
+            base: baseDir,
+        });
+        logger.debug('[createCacheDriver] Cache driver created successfully', {
+            baseDir,
+            driverType: 'fs',
+        });
+        return driver;
+    }
+    catch (error) {
+        // Log error with context
+        logger.error('[createCacheDriver] Failed to create cache driver (Node.js)', {
+            baseDir,
+            error: error.message,
+            code: error.code,
+            stack: error.stack,
+        });
+        throw error;
+    }
+}
+/**
+ * Get the database base name with a colon suffix for key scoping
+ * @returns The empty string
+ */
+export function getDbBaseNameScope() {
+    return "";
+}
+// ============================================================================
+// Local File Operations
+// ============================================================================
+/**
+ * Reads a local file from the filesystem in Node.js environments.
+ * Uses the built-in `fs/promises` module for async file reading.
+ *
+ * @param path - The file system path to the local file
+ * @returns Promise resolving to Uint8Array containing the file data
+ * @throws Error if the file cannot be read or fs module fails to load
+ */
+export async function readLocalFile(path) {
+    // Enter method
+    logger.debug('[readLocalFile] Reading local file (Node.js)', {
+        path,
+    });
+    try {
+        // Dynamically import Node.js fs/promises module
+        logger.trace('[readLocalFile] Importing fs/promises module');
+        const fs = await import('fs/promises');
+        // Read file from disk
+        logger.trace('[readLocalFile] Reading file from filesystem', {
+            path,
+        });
+        const buffer = await fs.readFile(path);
+        const data = new Uint8Array(buffer);
+        logger.debug('[readLocalFile] File read successfully (Node.js)', {
+            path,
+            size: data.length,
+        });
+        return data;
+    }
+    catch (error) {
+        // Log error with full context
+        logger.error('[readLocalFile] Failed to read file (Node.js)', {
+            path,
+            error: error.message,
+            code: error.code,
+            stack: error.stack,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/runtime/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/runtime/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAgB3C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IACtE,eAAe;IACf,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,gEAAgE,EAAE;QAC7E,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,6CAA6C;QAC7C,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACnE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEnE,wCAAwC;QACxC,MAAM,MAAM,GAAG,QAAQ,CAAC;YACtB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE;YACpE,OAAO;YACP,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,yBAAyB;QACzB,MAAM,CAAC,KAAK,CAAC,6DAA6D,EAAE;YAC1E,OAAO;YACP,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,eAAe;IACf,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE;QAC3D,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAEvC,sBAAsB;QACtB,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE;YAC3D,IAAI;SACL,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAEpC,MAAM,CAAC,KAAK,CAAC,kDAAkD,EAAE;YAC/D,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,8BAA8B;QAC9B,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE;YAC5D,IAAI;YACJ,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/sdk/fhetransform-sdk-b.d.ts

@@ -0,0 +1,102 @@
+import { ethers } from 'ethers';
+import { SystemContractInfo } from '../core/system-contract-info.js';
+import { Auth } from '../core/auth.js';
+import { Address } from '../core/primitives.js';
+import { ErrorParser } from '../core/tx-error-parser.js';
+import { FheTransformSDKEventListener } from '../core/event.js';
+import { CacheManager } from "../core/cache-manager.js";
+import { SignerAddressInfo } from '../core/signer-address-info.js';
+/**
+ * Configuration options for the FHE Transform SDK.
+ */
+export type FheTransformConfig = {
+    /** Ethereum provider for blockchain interaction. Optional if signer has provider or env RPC_URL is set. */
+    provider?: ethers.Provider;
+    /** Ethereum signer for transaction signing. In browser, MetaMask will be auto-detected if not provided. */
+    signer?: ethers.Signer;
+    /** Jazz API URL for FHE operations. Defaults to `constants.DEFAULT_JAZZ_URL`. (Falls back to env JAZZ_URL in Node.js) */
+    jazzUrl?: string;
+    /** Authentication configuration for Jazz API. */
+    jazzAuth?: Auth;
+    /** TTL (seconds) for transport key pairs. Defaults to `constants.DEFAULT_TRANSPORT_KEY_PAIR_TTL_SECONDS`. */
+    transportKeyPairTTL?: number;
+    /** TTL (days) for permits. Defaults to `constants.DEFAULT_PERMIT_TTL_DAYS`. */
+    permitTTL?: number;
+    /** Enable mock mode for testing. */
+    mock?: boolean;
+    onEvent?: FheTransformSDKEventListener;
+};
+/**
+ * Base SDK for FHE Transform operations.
+ * Provides core functionality including provider/signer management,
+ * error parsing, and chain configuration.
+ */
+export declare class FheTransformSDKBase {
+    #private;
+    readonly config: FheTransformConfig;
+    readonly errorParser: ErrorParser;
+    readonly cacheManager: CacheManager;
+    protected readonly onEvent: FheTransformSDKEventListener;
+    private readonly handleAccountsChangedBound;
+    private readonly handleDisconnectBound;
+    private readonly handleChainChangedBound;
+    constructor(config: FheTransformConfig);
+    /**
+     * Checks if the SDK is running in mock mode.
+     * @returns True if mock mode is enabled.
+     */
+    isMock(): boolean;
+    /** Lazy-loaded provider. Use this for read operations. */
+    requireProvider: () => Promise<ethers.Provider>;
+    /** Lazy-loaded signer. Returns null if no signer is available. */
+    protected getSigner: () => Promise<ethers.Signer | null>;
+    /**
+     * Gets a signer or throws if none is available.
+     * @throws If no signer is available.
+     * @returns The signer instance.
+     */
+    requireSigner: () => Promise<ethers.Signer>;
+    /**
+     * Gets the connected wallet address.
+     * @throws If no signer is available.
+     * @returns The wallet address.
+     */
+    requireWalletAddress: () => Promise<Address>;
+    /**
+     * Initializes a MetaMask signer in the browser.
+     * Requests account access and returns the connected signer.
+     *
+     * @returns MetaMask signer instance
+     * @throws If MetaMask is not installed or the user rejects access
+     */
+    private initMetaMaskSigner;
+    private handleAccountsChanged;
+    private handleDisconnect;
+    private handleChainChanged;
+    private invalidateCache;
+    cleanup(): void;
+    private _chainId;
+    /**
+     * Gets the current chain ID.
+     * @returns The chain ID as a bigint.
+     */
+    getChainID(): Promise<bigint>;
+    /**
+     * Gets the Jazz URL from config or environment.
+     * @throws If no Jazz URL is available.
+     * @returns The Jazz URL.
+     */
+    requireJazzUrl(): string;
+    /**
+     * Gets system contract information for the current chain.
+     * @returns System contract addresses and configuration.
+     */
+    getSystemContractInfo(): Promise<SystemContractInfo>;
+    /**
+     * Asynchronously retrieves the signer address information for the current blockchain network.
+     *
+     * @returns A Promise that resolves to the SignerAddressInfo for the current chain.
+     * @throws {Error} If the chain ID cannot be retrieved or is not supported.
+     */
+    getSignerAddressInfo(): Promise<SignerAddressInfo>;
+}

package/dist/sdk/fhetransform-sdk-b.js

@@ -0,0 +1,294 @@
+import { ethers } from 'ethers';
+import { logger } from '../core/logger.js';
+import { assertIsValidUrl, getEnv, lazy } from '../core/utils.js';
+import { getSystemContractInfo } from '../core/system-contract-info.js';
+import { ErrorParser } from '../core/tx-error-parser.js';
+import { ciphertextVerificationAbi } from '../abis/ciphertext_verification.abi.js';
+import { spaceBridgeConfigAbi } from '../abis/space_bridge_config.abi.js';
+import { ciphertextDigestsAbi } from '../abis/ciphertext_digests.abi.js';
+import { alphatrionRewardAbi } from '../abis/alphatrion_reward.abi.js';
+import { fheExecutorAbi } from '../abis/fhe_executor.abi.js';
+import { decryptionAbi } from '../abis/decryption.abi.js';
+import { erc20Abi } from '../abis/erc20.abi.js';
+import { DB_BASE_NAME, DEFAULT_JAZZ_URL } from '../core/constants.js';
+import { CacheManager } from "../core/cache-manager.js";
+import { FheErrorCode } from "../core/errors/error-codes.js";
+import { FheError } from "../core/errors/fhe-error.js";
+import { getSignerAddressInfo } from '../core/signer-address-info.js';
+// ============================================
+// SDK Base Class
+// ============================================
+/**
+ * Base SDK for FHE Transform operations.
+ * Provides core functionality including provider/signer management,
+ * error parsing, and chain configuration.
+ */
+export class FheTransformSDKBase {
+    config;
+    errorParser;
+    cacheManager;
+    onEvent;
+    // Bound MetaMask listeners. The same references are used for both add and
+    // remove so `cleanup()` can actually detach them.
+    handleAccountsChangedBound = this.handleAccountsChanged.bind(this);
+    handleDisconnectBound = this.handleDisconnect.bind(this);
+    handleChainChangedBound = this.handleChainChanged.bind(this);
+    constructor(config) {
+        logger.debug('FheTransformSDK config', {
+            mock: config.mock,
+            jazzUrl: config.jazzUrl ? 'provided' : undefined,
+            hasSigner: !!config.signer,
+            hasProvider: !!config.provider,
+            hasOnEvent: !!config.onEvent,
+            transportKeyPairTTL: config.transportKeyPairTTL,
+            permitTTL: config.permitTTL,
+        });
+        this.config = config;
+        this.onEvent = config.onEvent ?? function () { };
+        this.cacheManager = new CacheManager({
+            dbName: 'primus', // Database name
+            storeName: 'keys', // Store name for key-value pairs
+            baseName: DB_BASE_NAME, // Base name for cache files
+            baseDir: `./.cache/${DB_BASE_NAME}`, // Cache directory path
+        });
+        this.errorParser = new ErrorParser()
+            .addAbi(ciphertextVerificationAbi)
+            .addAbi(spaceBridgeConfigAbi)
+            .addAbi(ciphertextDigestsAbi)
+            .addAbi(alphatrionRewardAbi)
+            .addAbi(fheExecutorAbi)
+            .addAbi(decryptionAbi)
+            .addAbi(erc20Abi);
+    }
+    /**
+     * Checks if the SDK is running in mock mode.
+     * @returns True if mock mode is enabled.
+     */
+    isMock() {
+        return this.config.mock ?? false;
+    }
+    // ============================================
+    // Provider Management
+    // ============================================
+    /**
+     * Internal provider resolver. Attempts to get a provider from:
+     * 1. Config provider
+     * 2. Config signer's provider
+     * 3. Browser environment (MetaMask)
+     * 4. Environment variables (RPC_URL or FHE_RPC_URL)
+     */
+    #requireProvider = async () => {
+        logger.debug('Requiring provider');
+        // 1. Use provided provider
+        if (this.config.provider) {
+            logger.debug('Using provided provider');
+            return this.config.provider;
+        }
+        // 2. Use signer's provider
+        if (this.config.signer?.provider) {
+            logger.debug('Using signer.provider');
+            return this.config.signer.provider;
+        }
+        // 3. Browser: use MetaMask signer
+        if (typeof window !== 'undefined') {
+            const signer = await this.getSigner();
+            if (!signer?.provider) {
+                throw new FheError({ code: FheErrorCode.MissingProvider, message: 'Provider is required. Ensure MetaMask is connected or provide a signer with provider.' });
+            }
+            return signer.provider;
+        }
+        // 4. Node.js: use RPC URL from env
+        const rpcUrl = getEnv('RPC_URL') ?? getEnv('FHE_RPC_URL');
+        if (!rpcUrl) {
+            throw new FheError({ code: FheErrorCode.MissingProvider, message: 'RPC_URL or FHE_RPC_URL is required. Set it in your environment.' });
+        }
+        return new ethers.JsonRpcProvider(rpcUrl);
+    };
+    /** Lazy-loaded provider. Use this for read operations. */
+    requireProvider = lazy(this.#requireProvider);
+    // ============================================
+    // Signer Management
+    // ============================================
+    /**
+     * Internal signer resolver. Attempts to get a signer from:
+     * 1. Config signer
+     * 2. Browser environment (MetaMask)
+     * 3. Private key from environment (Node.js only)
+     */
+    #getSigner = async () => {
+        logger.debug('Getting signer');
+        // 1. Use provided signer (highest priority)
+        if (this.config.signer) {
+            logger.debug('Using provided signer');
+            return this.config.signer;
+        }
+        // 2. Browser: use MetaMask
+        if (typeof window !== 'undefined') {
+            logger.debug('Initializing MetaMask signer');
+            return this.initMetaMaskSigner();
+        }
+        // 3. Node.js: use private key from env
+        if (typeof process !== 'undefined') {
+            const privateKey = getEnv('PRIVATE_KEY');
+            if (privateKey) {
+                logger.debug('Using private key from environment');
+                const provider = await this.requireProvider();
+                return new ethers.Wallet(privateKey, provider);
+            }
+        }
+        logger.warn('No signer available. Provide a signer in config or set PRIVATE_KEY in environment.');
+        return null;
+    };
+    /** Lazy-loaded signer. Returns null if no signer is available. */
+    getSigner = lazy(this.#getSigner);
+    /**
+     * Gets a signer or throws if none is available.
+     * @throws If no signer is available.
+     * @returns The signer instance.
+     */
+    requireSigner = async () => {
+        logger.debug('Requiring signer');
+        const signer = await this.getSigner();
+        if (!signer) {
+            throw new FheError({ code: FheErrorCode.MissingSigner, message: 'Signer is required but not available. Provide a signer in config or set PRIVATE_KEY in environment.' });
+        }
+        return signer;
+    };
+    /**
+     * Gets the connected wallet address.
+     * @throws If no signer is available.
+     * @returns The wallet address.
+     */
+    requireWalletAddress = async () => {
+        logger.debug('Requiring wallet address');
+        const signer = await this.requireSigner();
+        return (await signer.getAddress());
+    };
+    // ============================================
+    // MetaMask Integration
+    // ============================================
+    /**
+     * Initializes a MetaMask signer in the browser.
+     * Requests account access and returns the connected signer.
+     *
+     * @returns MetaMask signer instance
+     * @throws If MetaMask is not installed or the user rejects access
+     */
+    async initMetaMaskSigner() {
+        const metamaskProvider = window?.ethereum;
+        if (!metamaskProvider) {
+            throw new FheError({
+                code: FheErrorCode.MissingSigner,
+                message: 'MetaMask provider not found. Please install MetaMask or provide a signer in the config.',
+            });
+        }
+        this.cleanup();
+        logger.info('Requesting MetaMask accounts...');
+        await metamaskProvider.request({ method: 'eth_requestAccounts' });
+        const browserProvider = new ethers.BrowserProvider(metamaskProvider);
+        const signer = await browserProvider.getSigner();
+        const address = await signer.getAddress();
+        metamaskProvider.on('accountsChanged', this.handleAccountsChangedBound);
+        metamaskProvider.on('disconnect', this.handleDisconnectBound);
+        metamaskProvider.on('chainChanged', this.handleChainChangedBound);
+        logger.info(`MetaMask connected: ${address}`);
+        return signer;
+    }
+    handleAccountsChanged(accounts) {
+        if (accounts.length === 0) {
+            logger.warn("Wallet logout");
+        }
+        else {
+            logger.info("Wallet switched");
+        }
+        this.invalidateCache();
+    }
+    handleDisconnect() {
+        logger.warn("Wallet disconnected");
+        this.invalidateCache();
+    }
+    handleChainChanged(chainId) {
+        logger.warn(`Chain switched to ${chainId}`);
+        this.invalidateCache();
+    }
+    invalidateCache() {
+        this._chainId = null;
+        this.getSigner = lazy(this.#getSigner);
+        this.requireProvider = lazy(this.#requireProvider);
+    }
+    cleanup() {
+        const metamaskProvider = window?.ethereum;
+        if (metamaskProvider) {
+            logger.debug("cleanup");
+            metamaskProvider.removeListener('accountsChanged', this.handleAccountsChangedBound);
+            metamaskProvider.removeListener('disconnect', this.handleDisconnectBound);
+            metamaskProvider.removeListener('chainChanged', this.handleChainChangedBound);
+        }
+    }
+    // ============================================
+    // Chain & System Info
+    // ============================================
+    _chainId = null;
+    /**
+     * Gets the current chain ID.
+     * @returns The chain ID as a bigint.
+     */
+    async getChainID() {
+        if (this._chainId === null) {
+            const provider = await this.requireProvider();
+            this._chainId = (await provider.getNetwork()).chainId;
+        }
+        return this._chainId;
+    }
+    /**
+     * Gets the Jazz URL from config or environment.
+     * @throws If no Jazz URL is available.
+     * @returns The Jazz URL.
+     */
+    requireJazzUrl() {
+        // Use explicitly provided config URL if available
+        if (this.config.jazzUrl) {
+            logger.debug('Using provided jazzUrl:', this.config.jazzUrl);
+            assertIsValidUrl(this.config.jazzUrl);
+            return this.config.jazzUrl;
+        }
+        // In Node.js, environment variables take precedence over the built-in default
+        if (typeof window === 'undefined') {
+            const jazzUrl = getEnv('JAZZ_URL') ?? getEnv('FHE_JAZZ_URL');
+            if (jazzUrl && jazzUrl !== "") {
+                logger.debug('Using env jazzUrl:', jazzUrl);
+                assertIsValidUrl(jazzUrl);
+                return jazzUrl;
+            }
+        }
+        // Fall back to the built-in default URL if defined
+        if (DEFAULT_JAZZ_URL !== "") {
+            logger.debug('Using default jazzUrl:', DEFAULT_JAZZ_URL);
+            assertIsValidUrl(DEFAULT_JAZZ_URL);
+            return DEFAULT_JAZZ_URL;
+        }
+        throw new FheError({
+            code: FheErrorCode.MissingJazzUrl,
+            message: 'jazzUrl is required. Provide it in config or set JAZZ_URL or FHE_JAZZ_URL environment variable.',
+        });
+    }
+    /**
+     * Gets system contract information for the current chain.
+     * @returns System contract addresses and configuration.
+     */
+    async getSystemContractInfo() {
+        const chainId = await this.getChainID();
+        return getSystemContractInfo(chainId);
+    }
+    /**
+     * Asynchronously retrieves the signer address information for the current blockchain network.
+     *
+     * @returns A Promise that resolves to the SignerAddressInfo for the current chain.
+     * @throws {Error} If the chain ID cannot be retrieved or is not supported.
+     */
+    async getSignerAddressInfo() {
+        const chainId = await this.getChainID();
+        return getSignerAddressInfo(chainId);
+    }
+}
+//# sourceMappingURL=fhetransform-sdk-b.js.map

package/dist/sdk/fhetransform-sdk-b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fhetransform-sdk-b.js","sourceRoot":"","sources":["../../src/sdk/fhetransform-sdk-b.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAsB,MAAM,iCAAiC,CAAC;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAqB,MAAM,gCAAgC,CAAC;AA4BzF,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACrB,MAAM,CAAqB;IAC3B,WAAW,CAAc;IACzB,YAAY,CAAe;IACjB,OAAO,CAA+B;IAEzD,0EAA0E;IAC1E,kDAAkD;IACjC,0BAA0B,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,uBAAuB,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9E,YAAY,MAA0B;QACpC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YAChD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;YAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;YAC5B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;QAEjD,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC;YACnC,MAAM,EAAE,QAAQ,EAAsB,gBAAgB;YACtD,SAAS,EAAE,MAAM,EAAqB,iCAAiC;YACvE,QAAQ,EAAE,YAAY,EAAgB,4BAA4B;YAClE,OAAO,EAAE,YAAY,YAAY,EAAE,EAAG,uBAAuB;SAC9D,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,EAAE;aACjC,MAAM,CAAC,yBAAyB,CAAC;aACjC,MAAM,CAAC,oBAAoB,CAAC;aAC5B,MAAM,CAAC,oBAAoB,CAAC;aAC5B,MAAM,CAAC,mBAAmB,CAAC;aAC3B,MAAM,CAAC,cAAc,CAAC;aACtB,MAAM,CAAC,aAAa,CAAC;aACrB,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;IACnC,CAAC;IAED,+CAA+C;IAC/C,sBAAsB;IACtB,+CAA+C;IAE/C;;;;;;OAMG;IACH,gBAAgB,GAAG,KAAK,IAA8B,EAAE;QACtD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAEnC,2BAA2B;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC9B,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,CAAC;QAED,kCAAkC;QAClC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACtB,MAAM,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,uFAAuF,EAAE,CAAC,CAAC;YAC/J,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,eAAe,EAAE,OAAO,EAAE,iEAAiE,EAAE,CAAC,CAAC;QACzI,CAAC;QAED,OAAO,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,0DAA0D;IAC1D,eAAe,GAAmC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE9E,+CAA+C;IAC/C,oBAAoB;IACpB,+CAA+C;IAE/C;;;;;OAKG;IACH,UAAU,GAAG,KAAK,IAAmC,EAAE;QACrD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE/B,4CAA4C;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5B,CAAC;QAED,2BAA2B;QAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnC,CAAC;QAED,uCAAuC;QACvC,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YACzC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9C,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,kEAAkE;IACxD,SAAS,GAAwC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjF;;;;OAIG;IACH,aAAa,GAAG,KAAK,IAA4B,EAAE;QACjD,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,qGAAqG,EAAE,CAAC,CAAC;QAC3K,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF;;;;OAIG;IACH,oBAAoB,GAAG,KAAK,IAAsB,EAAE;QAClD,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAY,CAAC;IAChD,CAAC,CAAC;IAEF,+CAA+C;IAC/C,uBAAuB;IACvB,+CAA+C;IAE/C;;;;;;OAMG;IACK,KAAK,CAAC,kBAAkB;QAC9B,MAAM,gBAAgB,GAAI,MAAc,EAAE,QAAQ,CAAC;QACnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAAC;gBACjB,IAAI,EAAE,YAAY,CAAC,aAAa;gBAChC,OAAO,EAAE,yFAAyF;aACnG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/C,MAAM,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAElE,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAE1C,gBAAgB,CAAC,EAAE,CAAC,iBAAiB,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACxE,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9D,gBAAgB,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAElE,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,qBAAqB,CAAC,QAAkB;QAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAEO,gBAAgB;QACtB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAEO,kBAAkB,CAAC,OAAwB;QACjD,MAAM,CAAC,IAAI,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,MAAM,gBAAgB,GAAI,MAAc,EAAE,QAAQ,CAAC;QACnD,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxB,gBAAgB,CAAC,cAAc,CAAC,iBAAiB,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACpF,gBAAgB,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC1E,gBAAgB,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,sBAAsB;IACtB,+CAA+C;IAEvC,QAAQ,GAAkB,IAAI,CAAC;IAEvC;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,kDAAkD;QAClD,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7D,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;QAED,8EAA8E;QAC9E,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC;YAC7D,IAAI,OAAO,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;gBAC5C,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,IAAI,gBAAgB,KAAK,EAAE,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAAC;YACzD,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YACnC,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,YAAY,CAAC,cAAc;YACjC,OAAO,EAAE,iGAAiG;SAC3G,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,qBAAqB;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/sdk/fhetransform-sdk.d.ts

@@ -0,0 +1,87 @@
+import { Token } from '../contract/token.js';
+import { ConvertToken } from '../contract/convert-token.js';
+import { EncryptParameters, EncryptPayload, EncryptResult } from '../jazz/encrypt.js';
+import { UserDecryptParameters, UserDecryptPayload, UserDecryptResult } from '../jazz/user-decrypt.js';
+import { PublicDecryptParameters, PublicDecryptPayload, PublicDecryptResult } from '../jazz/public-decrypt.js';
+import { Address } from '../core/primitives.js';
+import { FheTransformConfig, FheTransformSDKBase } from './fhetransform-sdk-b.js';
+import { FheFeeEstimate } from '../core/estimate.js';
+import { FheTransformSDKEventInput } from '../core/event.js';
+import { PermitService } from './permit-service.js';
+/**
+ * Main SDK class for FHE Transform operations.
+ * Provides access to token contracts, encryption, and decryption services.
+ */
+export declare class FheTransformSDK extends FheTransformSDKBase {
+    private readonly jazz;
+    readonly permitService: PermitService;
+    private readonly jazzService;
+    /**
+     * Creates a new FHE Transform SDK instance.
+     * @param config - Configuration options for the SDK.
+     */
+    constructor(config: FheTransformConfig);
+    init(): Promise<void>;
+    initSync(): void;
+    /**
+     * Emits a structured SDK event into the unified SDK event stream.
+     *
+     * Listener exceptions are caught and logged so that a misbehaving subscriber
+     * can never corrupt SDK operations.
+     *
+     * Application code should subscribe via the `onEvent` config option, never
+     * call this directly.
+     *
+     * @param input - The event input data (type, payload, etc.)
+     * @param dappAddress - Optional dapp contract address associated with the event
+     *
+     * @remarks
+     * - This method is internal and should not be called directly by application code
+     * - Events are enriched with a timestamp before emission
+     * - Any errors in the event listener are caught and logged as warnings
+     * - The SDK operation continues unaffected even if the listener throws
+     *
+     * @internal
+     */
+    emitEvent(input: FheTransformSDKEventInput, dappAddress?: Address): void;
+    /**
+     * Encrypts values for use in confidential contracts.
+     * @param parameters - Encryption parameters containing payloads to encrypt.
+     * @returns Encrypted values matching the input structure.
+     */
+    encrypt<T extends EncryptPayload>(parameters: EncryptParameters<T>): Promise<EncryptResult<T>>;
+    /**
+     * Decrypts values that have been made publicly decryptable.
+     * @param parameters - Public decryption parameters.
+     * @returns Decrypted values with proof for verification.
+     */
+    publicDecrypt<T extends PublicDecryptPayload>(parameters: PublicDecryptParameters<T>): Promise<PublicDecryptResult<T>>;
+    /**
+     * Decrypts values using the user's private key.
+     * @param parameters - User decryption parameters.
+     * @returns Decrypted values.
+     */
+    userDecrypt<T extends UserDecryptPayload>(parameters: UserDecryptParameters<T>): Promise<UserDecryptResult<T>>;
+    /**
+     * Creates a Token instance for interacting with a confidential token contract.
+     * @param address - The token contract address.
+     * @returns A Token instance.
+     */
+    createToken(address: Address): Token;
+    /**
+     * Creates a ConvertToken instance for interacting with a token converter contract.
+     * Supports shielding (ERC-20 → confidential) and unshielding (confidential → ERC-20).
+     * @param address - The converter contract address.
+     * @returns A ConvertToken instance.
+     */
+    createConvertToken(address: Address): ConvertToken;
+    /**
+     * Estimates the FHE operation fee for a specific contract function call.
+     *
+     * @param contractAddress - The address of the target contract
+     * @param functionName - The name of the function to estimate fees for
+     * @param chainId - The blockchain chain ID
+     * @returns A promise resolving to the FHE fee estimate
+     */
+    estimateFheFee(contractAddress: string, functionName: string, chainId: bigint): Promise<FheFeeEstimate>;
+}