@interfold/sdk 0.2.0

package/dist/contracts/index.cjs

@@ -0,0 +1,320 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/contracts/index.ts
+var contracts_exports = {};
+__export(contracts_exports, {
+  ContractClient: () => ContractClient,
+  E3Stage: () => E3Stage,
+  FailureReason: () => FailureReason
+});
+module.exports = __toCommonJS(contracts_exports);
+
+// src/contracts/contract-client.ts
+var import_viem2 = require("viem");
+var import_accounts = require("viem/accounts");
+var import_types = require("@interfold/contracts/types");
+
+// src/utils.ts
+var import_viem = require("viem");
+var SDKError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "SDKError";
+  }
+};
+function isValidAddress(address) {
+  return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+
+// src/contracts/contract-client.ts
+var ContractClient = class _ContractClient {
+  publicClient;
+  walletClient;
+  contracts;
+  contractInfo;
+  constructor(config) {
+    const { publicClient, walletClient, contracts } = config;
+    if (!isValidAddress(contracts.interfold)) {
+      throw new SDKError("Invalid Interfold contract address", "INVALID_ADDRESS");
+    }
+    if (!isValidAddress(contracts.ciphernodeRegistry)) {
+      throw new SDKError("Invalid CiphernodeRegistry contract address", "INVALID_ADDRESS");
+    }
+    if (!isValidAddress(contracts.feeToken)) {
+      throw new SDKError("Invalid FeeToken contract address", "INVALID_ADDRESS");
+    }
+    this.publicClient = publicClient;
+    this.walletClient = walletClient;
+    this.contracts = contracts;
+    this.contractInfo = {
+      interfold: {
+        address: contracts.interfold,
+        abi: import_types.Interfold__factory.abi
+      },
+      ciphernodeRegistry: {
+        address: contracts.ciphernodeRegistry,
+        abi: import_types.CiphernodeRegistryOwnable__factory.abi
+      },
+      feeToken: {
+        address: contracts.feeToken,
+        abi: import_types.InterfoldToken__factory.abi
+      }
+    };
+  }
+  static create(options) {
+    const isWebSocket = options.rpcUrl.startsWith("ws://") || options.rpcUrl.startsWith("wss://");
+    const transport = isWebSocket ? (0, import_viem2.webSocket)(options.rpcUrl, {
+      keepAlive: { interval: 3e4 },
+      reconnect: { attempts: 5, delay: 2e3 }
+    }) : (0, import_viem2.http)(options.rpcUrl);
+    const publicClient = (0, import_viem2.createPublicClient)({
+      chain: options.chain,
+      transport
+    });
+    let walletClient;
+    if (options.privateKey) {
+      const account = (0, import_accounts.privateKeyToAccount)(options.privateKey);
+      walletClient = (0, import_viem2.createWalletClient)({
+        account,
+        chain: options.chain,
+        transport
+      });
+    }
+    return new _ContractClient({ publicClient, walletClient, contracts: options.contracts });
+  }
+  getPublicClient() {
+    return this.publicClient;
+  }
+  async approveFeeToken(amount) {
+    if (!this.walletClient) {
+      throw new SDKError("Wallet client required for write operations", "NO_WALLET");
+    }
+    try {
+      const account = this.walletClient.account;
+      if (!account) {
+        throw new SDKError("No account connected", "NO_ACCOUNT");
+      }
+      const { request } = await this.publicClient.simulateContract({
+        address: this.contracts.feeToken,
+        abi: import_types.InterfoldToken__factory.abi,
+        functionName: "approve",
+        args: [this.contracts.interfold, amount],
+        account
+      });
+      return await this.walletClient.writeContract(request);
+    } catch (error) {
+      throw new SDKError(`Failed to approve fee token: ${error}`, "APPROVE_FEE_TOKEN_FAILED");
+    }
+  }
+  async requestE3(params) {
+    if (!this.walletClient) {
+      throw new SDKError("Wallet client required for write operations", "NO_WALLET");
+    }
+    try {
+      const account = this.walletClient.account;
+      if (!account) {
+        throw new SDKError("No account connected", "NO_ACCOUNT");
+      }
+      const { request } = await this.publicClient.simulateContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "request",
+        args: [
+          {
+            committeeSize: params.committeeSize,
+            inputWindow: params.inputWindow,
+            e3Program: params.e3Program,
+            paramSet: params.paramSet,
+            computeProviderParams: params.computeProviderParams,
+            customParams: params.customParams || "0x",
+            proofAggregationEnabled: params.proofAggregationEnabled ?? true
+          }
+        ],
+        account,
+        gas: params.gasLimit
+      });
+      return await this.walletClient.writeContract(request);
+    } catch (error) {
+      throw new SDKError(`Failed to request E3: ${error}`, "REQUEST_E3_FAILED");
+    }
+  }
+  async publishCiphertextOutput(e3Id, ciphertextOutput, proof, gasLimit) {
+    if (!this.walletClient) {
+      throw new SDKError("Wallet client required for write operations", "NO_WALLET");
+    }
+    try {
+      const account = this.walletClient.account;
+      if (!account) {
+        throw new SDKError("No account connected", "NO_ACCOUNT");
+      }
+      const { request } = await this.publicClient.simulateContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "publishCiphertextOutput",
+        args: [e3Id, ciphertextOutput, proof],
+        account,
+        gas: gasLimit
+      });
+      return await this.walletClient.writeContract(request);
+    } catch (error) {
+      throw new SDKError(`Failed to publish ciphertext output: ${error}`, "PUBLISH_CIPHERTEXT_OUTPUT_FAILED");
+    }
+  }
+  async getE3(e3Id) {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "getE3",
+        args: [e3Id]
+      });
+      return result;
+    } catch (error) {
+      throw new SDKError(`Failed to get E3: ${error}`, "GET_E3_FAILED");
+    }
+  }
+  async getE3Quote(requestParams) {
+    try {
+      return this.publicClient.readContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "getE3Quote",
+        args: [
+          {
+            committeeSize: requestParams.committeeSize,
+            inputWindow: requestParams.inputWindow,
+            e3Program: requestParams.e3Program,
+            paramSet: requestParams.paramSet,
+            computeProviderParams: requestParams.computeProviderParams,
+            customParams: requestParams.customParams || "0x",
+            proofAggregationEnabled: requestParams.proofAggregationEnabled ?? true
+          }
+        ]
+      });
+    } catch (error) {
+      throw new SDKError(`Failed to get E3 quote: ${error}`, "GET_E3_QUOTE_FAILED");
+    }
+  }
+  async getFailureReason(e3Id) {
+    try {
+      return this.publicClient.readContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "getFailureReason",
+        args: [e3Id]
+      });
+    } catch (error) {
+      throw new SDKError(`Failed to get failure reason: ${error}`, "GET_FAILURE_REASON_FAILED");
+    }
+  }
+  async getE3PublicKey(e3Id) {
+    try {
+      const result = await this.publicClient.readContract({
+        address: this.contracts.ciphernodeRegistry,
+        abi: import_types.CiphernodeRegistryOwnable__factory.abi,
+        functionName: "committeePublicKey",
+        args: [e3Id]
+      });
+      return result;
+    } catch (error) {
+      throw new SDKError(`Failed to get E3 public key: ${error}`, "GET_E3_PUBLIC_KEY_FAILED");
+    }
+  }
+  async getE3Stage(e3Id) {
+    try {
+      return this.publicClient.readContract({
+        address: this.contracts.interfold,
+        abi: import_types.Interfold__factory.abi,
+        functionName: "getE3Stage",
+        args: [e3Id]
+      });
+    } catch (error) {
+      throw new SDKError(`Failed to get E3 stage: ${error}`, "GET_E3_STAGE_FAILED");
+    }
+  }
+  async estimateGas(functionName, args, contractAddress, abi, value) {
+    if (!this.walletClient) {
+      throw new SDKError("Wallet client required for gas estimation", "NO_WALLET");
+    }
+    try {
+      const account = this.walletClient.account;
+      if (!account) {
+        throw new SDKError("No account connected", "NO_ACCOUNT");
+      }
+      const estimateParams = {
+        address: contractAddress,
+        abi,
+        functionName,
+        args,
+        account,
+        ...value !== void 0 && { value }
+      };
+      return await this.publicClient.estimateContractGas(estimateParams);
+    } catch (error) {
+      throw new SDKError(`Failed to estimate gas: ${error}`, "GAS_ESTIMATION_FAILED");
+    }
+  }
+  async waitForTransaction(hash) {
+    try {
+      return await this.publicClient.waitForTransactionReceipt({
+        hash,
+        confirmations: 1
+      });
+    } catch (error) {
+      throw new SDKError(`Failed to wait for transaction: ${error}`, "TRANSACTION_WAIT_FAILED");
+    }
+  }
+};
+
+// src/contracts/types.ts
+var E3Stage = /* @__PURE__ */ ((E3Stage2) => {
+  E3Stage2[E3Stage2["None"] = 0] = "None";
+  E3Stage2[E3Stage2["Requested"] = 1] = "Requested";
+  E3Stage2[E3Stage2["CommitteeFinalized"] = 2] = "CommitteeFinalized";
+  E3Stage2[E3Stage2["KeyPublished"] = 3] = "KeyPublished";
+  E3Stage2[E3Stage2["CiphertextReady"] = 4] = "CiphertextReady";
+  E3Stage2[E3Stage2["Complete"] = 5] = "Complete";
+  E3Stage2[E3Stage2["Failed"] = 6] = "Failed";
+  return E3Stage2;
+})(E3Stage || {});
+var FailureReason = /* @__PURE__ */ ((FailureReason2) => {
+  FailureReason2[FailureReason2["None"] = 0] = "None";
+  FailureReason2[FailureReason2["CommitteeFormationTimeout"] = 1] = "CommitteeFormationTimeout";
+  FailureReason2[FailureReason2["InsufficientCommitteeMembers"] = 2] = "InsufficientCommitteeMembers";
+  FailureReason2[FailureReason2["DKGTimeout"] = 3] = "DKGTimeout";
+  FailureReason2[FailureReason2["DKGInvalidShares"] = 4] = "DKGInvalidShares";
+  FailureReason2[FailureReason2["NoInputsReceived"] = 5] = "NoInputsReceived";
+  FailureReason2[FailureReason2["ComputeTimeout"] = 6] = "ComputeTimeout";
+  FailureReason2[FailureReason2["ComputeProviderExpired"] = 7] = "ComputeProviderExpired";
+  FailureReason2[FailureReason2["ComputeProviderFailed"] = 8] = "ComputeProviderFailed";
+  FailureReason2[FailureReason2["RequesterCancelled"] = 9] = "RequesterCancelled";
+  FailureReason2[FailureReason2["DecryptionTimeout"] = 10] = "DecryptionTimeout";
+  FailureReason2[FailureReason2["DecryptionInvalidShares"] = 11] = "DecryptionInvalidShares";
+  FailureReason2[FailureReason2["VerificationFailed"] = 12] = "VerificationFailed";
+  return FailureReason2;
+})(FailureReason || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContractClient,
+  E3Stage,
+  FailureReason
+});
+//# sourceMappingURL=index.cjs.map

package/dist/contracts/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/index.ts","../../src/contracts/contract-client.ts","../../src/utils.ts","../../src/contracts/types.ts"],"sourcesContent":["// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\n\nexport { ContractClient } from './contract-client'\nexport type { ContractClientConfig } from './contract-client'\nexport type { ContractAddresses, E3, E3RequestParams } from './types'\nexport { E3Stage, FailureReason } from './types'\n","// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\n\nimport {\n  type Abi,\n  type Chain,\n  type Hash,\n  type PublicClient,\n  type TransactionReceipt,\n  type WalletClient,\n  createPublicClient,\n  createWalletClient,\n  http,\n  webSocket,\n} from 'viem'\nimport { privateKeyToAccount } from 'viem/accounts'\n\nimport { CiphernodeRegistryOwnable__factory, Interfold__factory, InterfoldToken__factory } from '@interfold/contracts/types'\nimport type { ContractAddresses, E3, E3RequestParams, E3Stage, FailureReason } from './types'\nimport { SDKError, isValidAddress } from '../utils'\n\nexport interface ContractClientConfig {\n  publicClient: PublicClient\n  walletClient?: WalletClient\n  contracts: ContractAddresses\n}\n\nexport class ContractClient {\n  private publicClient: PublicClient\n  private walletClient?: WalletClient\n  private contracts: ContractAddresses\n  private contractInfo: {\n    interfold: { address: `0x${string}`; abi: Abi }\n    ciphernodeRegistry: { address: `0x${string}`; abi: Abi }\n    feeToken: { address: `0x${string}`; abi: Abi }\n  }\n\n  constructor(config: ContractClientConfig) {\n    const { publicClient, walletClient, contracts } = config\n\n    if (!isValidAddress(contracts.interfold)) {\n      throw new SDKError('Invalid Interfold contract address', 'INVALID_ADDRESS')\n    }\n    if (!isValidAddress(contracts.ciphernodeRegistry)) {\n      throw new SDKError('Invalid CiphernodeRegistry contract address', 'INVALID_ADDRESS')\n    }\n    if (!isValidAddress(contracts.feeToken)) {\n      throw new SDKError('Invalid FeeToken contract address', 'INVALID_ADDRESS')\n    }\n\n    this.publicClient = publicClient\n    this.walletClient = walletClient\n    this.contracts = contracts\n\n    this.contractInfo = {\n      interfold: {\n        address: contracts.interfold,\n        abi: Interfold__factory.abi,\n      },\n      ciphernodeRegistry: {\n        address: contracts.ciphernodeRegistry,\n        abi: CiphernodeRegistryOwnable__factory.abi,\n      },\n      feeToken: {\n        address: contracts.feeToken,\n        abi: InterfoldToken__factory.abi,\n      },\n    }\n  }\n\n  public static create(options: {\n    rpcUrl: string\n    contracts: ContractAddresses\n    privateKey?: `0x${string}`\n    chain: Chain\n  }): ContractClient {\n    const isWebSocket = options.rpcUrl.startsWith('ws://') || options.rpcUrl.startsWith('wss://')\n    const transport = isWebSocket\n      ? webSocket(options.rpcUrl, {\n          keepAlive: { interval: 30_000 },\n          reconnect: { attempts: 5, delay: 2_000 },\n        })\n      : http(options.rpcUrl)\n\n    const publicClient = createPublicClient({\n      chain: options.chain,\n      transport,\n    }) as PublicClient\n\n    let walletClient: WalletClient | undefined\n    if (options.privateKey) {\n      const account = privateKeyToAccount(options.privateKey)\n      walletClient = createWalletClient({\n        account,\n        chain: options.chain,\n        transport,\n      })\n    }\n\n    return new ContractClient({ publicClient, walletClient, contracts: options.contracts })\n  }\n\n  public getPublicClient(): PublicClient {\n    return this.publicClient\n  }\n\n  public async approveFeeToken(amount: bigint): Promise<Hash> {\n    if (!this.walletClient) {\n      throw new SDKError('Wallet client required for write operations', 'NO_WALLET')\n    }\n\n    try {\n      const account = this.walletClient.account\n      if (!account) {\n        throw new SDKError('No account connected', 'NO_ACCOUNT')\n      }\n\n      const { request } = await this.publicClient.simulateContract({\n        address: this.contracts.feeToken,\n        abi: InterfoldToken__factory.abi,\n        functionName: 'approve',\n        args: [this.contracts.interfold, amount],\n        account,\n      })\n\n      return await this.walletClient.writeContract(request)\n    } catch (error) {\n      throw new SDKError(`Failed to approve fee token: ${error}`, 'APPROVE_FEE_TOKEN_FAILED')\n    }\n  }\n\n  public async requestE3(params: E3RequestParams): Promise<Hash> {\n    if (!this.walletClient) {\n      throw new SDKError('Wallet client required for write operations', 'NO_WALLET')\n    }\n\n    try {\n      const account = this.walletClient.account\n      if (!account) {\n        throw new SDKError('No account connected', 'NO_ACCOUNT')\n      }\n\n      const { request } = await this.publicClient.simulateContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'request',\n        args: [\n          {\n            committeeSize: params.committeeSize,\n            inputWindow: params.inputWindow,\n            e3Program: params.e3Program,\n            paramSet: params.paramSet,\n            computeProviderParams: params.computeProviderParams,\n            customParams: params.customParams || '0x',\n            proofAggregationEnabled: params.proofAggregationEnabled ?? true,\n          },\n        ],\n        account,\n        gas: params.gasLimit,\n      })\n\n      return await this.walletClient.writeContract(request)\n    } catch (error) {\n      throw new SDKError(`Failed to request E3: ${error}`, 'REQUEST_E3_FAILED')\n    }\n  }\n\n  public async publishCiphertextOutput(\n    e3Id: bigint,\n    ciphertextOutput: `0x${string}`,\n    proof: `0x${string}`,\n    gasLimit?: bigint,\n  ): Promise<Hash> {\n    if (!this.walletClient) {\n      throw new SDKError('Wallet client required for write operations', 'NO_WALLET')\n    }\n\n    try {\n      const account = this.walletClient.account\n      if (!account) {\n        throw new SDKError('No account connected', 'NO_ACCOUNT')\n      }\n\n      const { request } = await this.publicClient.simulateContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'publishCiphertextOutput',\n        args: [e3Id, ciphertextOutput, proof],\n        account,\n        gas: gasLimit,\n      })\n\n      return await this.walletClient.writeContract(request)\n    } catch (error) {\n      throw new SDKError(`Failed to publish ciphertext output: ${error}`, 'PUBLISH_CIPHERTEXT_OUTPUT_FAILED')\n    }\n  }\n\n  public async getE3(e3Id: bigint): Promise<E3> {\n    try {\n      const result: E3 = await this.publicClient.readContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'getE3',\n        args: [e3Id],\n      })\n\n      return result\n    } catch (error) {\n      throw new SDKError(`Failed to get E3: ${error}`, 'GET_E3_FAILED')\n    }\n  }\n\n  public async getE3Quote(requestParams: E3RequestParams): Promise<bigint> {\n    try {\n      return this.publicClient.readContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'getE3Quote',\n        args: [\n          {\n            committeeSize: requestParams.committeeSize,\n            inputWindow: requestParams.inputWindow,\n            e3Program: requestParams.e3Program,\n            paramSet: requestParams.paramSet,\n            computeProviderParams: requestParams.computeProviderParams,\n            customParams: requestParams.customParams || '0x',\n            proofAggregationEnabled: requestParams.proofAggregationEnabled ?? true,\n          },\n        ],\n      })\n    } catch (error) {\n      throw new SDKError(`Failed to get E3 quote: ${error}`, 'GET_E3_QUOTE_FAILED')\n    }\n  }\n\n  public async getFailureReason(e3Id: bigint): Promise<FailureReason> {\n    try {\n      return this.publicClient.readContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'getFailureReason',\n        args: [e3Id],\n      })\n    } catch (error) {\n      throw new SDKError(`Failed to get failure reason: ${error}`, 'GET_FAILURE_REASON_FAILED')\n    }\n  }\n\n  public async getE3PublicKey(e3Id: bigint): Promise<`0x${string}`> {\n    try {\n      const result: `0x${string}` = await this.publicClient.readContract({\n        address: this.contracts.ciphernodeRegistry,\n        abi: CiphernodeRegistryOwnable__factory.abi,\n        functionName: 'committeePublicKey',\n        args: [e3Id],\n      })\n\n      return result\n    } catch (error) {\n      throw new SDKError(`Failed to get E3 public key: ${error}`, 'GET_E3_PUBLIC_KEY_FAILED')\n    }\n  }\n\n  public async getE3Stage(e3Id: bigint): Promise<E3Stage> {\n    try {\n      return this.publicClient.readContract({\n        address: this.contracts.interfold,\n        abi: Interfold__factory.abi,\n        functionName: 'getE3Stage',\n        args: [e3Id],\n      })\n    } catch (error) {\n      throw new SDKError(`Failed to get E3 stage: ${error}`, 'GET_E3_STAGE_FAILED')\n    }\n  }\n\n  public async estimateGas(\n    functionName: string,\n    args: readonly unknown[],\n    contractAddress: `0x${string}`,\n    abi: Abi,\n    value?: bigint,\n  ): Promise<bigint> {\n    if (!this.walletClient) {\n      throw new SDKError('Wallet client required for gas estimation', 'NO_WALLET')\n    }\n\n    try {\n      const account = this.walletClient.account\n      if (!account) {\n        throw new SDKError('No account connected', 'NO_ACCOUNT')\n      }\n\n      const estimateParams = {\n        address: contractAddress,\n        abi,\n        functionName,\n        args,\n        account,\n        ...(value !== undefined && { value }),\n      }\n\n      return await this.publicClient.estimateContractGas(estimateParams)\n    } catch (error) {\n      throw new SDKError(`Failed to estimate gas: ${error}`, 'GAS_ESTIMATION_FAILED')\n    }\n  }\n\n  public async waitForTransaction(hash: Hash): Promise<TransactionReceipt> {\n    try {\n      return await this.publicClient.waitForTransactionReceipt({\n        hash,\n        confirmations: 1,\n      })\n    } catch (error) {\n      throw new SDKError(`Failed to wait for transaction: ${error}`, 'TRANSACTION_WAIT_FAILED')\n    }\n  }\n}\n","// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\n\nimport { type Address, type Hash, type Log, PublicClient, encodeAbiParameters } from 'viem'\nimport type { BfvParams } from './types'\n\nexport class SDKError extends Error {\n  constructor(\n    message: string,\n    public readonly code?: string,\n  ) {\n    super(message)\n    this.name = 'SDKError'\n  }\n}\n\nexport function isValidAddress(address: string): address is Address {\n  return /^0x[a-fA-F0-9]{40}$/.test(address)\n}\n\nexport function isValidHash(hash: string): hash is Hash {\n  return /^0x[a-fA-F0-9]{64}$/.test(hash)\n}\n\nexport function formatEventName(contractName: string, eventName: string): string {\n  return `${contractName}.${eventName}`\n}\n\nexport function parseEventData<T>(log: Log): T {\n  return log.data as unknown as T\n}\n\n/**\n * Sleep for a specified number of milliseconds\n */\nexport const sleep = (ms: number): Promise<void> => {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nexport function formatBigInt(value: bigint): string {\n  return value.toString()\n}\n\nexport function parseBigInt(value: string): bigint {\n  return BigInt(value)\n}\n\nexport function generateEventId(log: Log): string {\n  return `${log.blockHash}-${log.logIndex}`\n}\n\n/**\n * Get the current timestamp in seconds\n * from onchain\n * @param publicClient - The public client to use\n */\nexport async function getCurrentTimestamp(publicClient: PublicClient): Promise<bigint> {\n  const block = await publicClient.getBlock()\n  return block.timestamp\n}\n\n// Compute provider parameters structure\nexport interface ComputeProviderParams {\n  name: string\n  parallel: boolean\n  batch_size: number\n}\n\n// Default compute provider configuration\nexport const DEFAULT_COMPUTE_PROVIDER_PARAMS: ComputeProviderParams = {\n  name: 'risc0',\n  parallel: false,\n  batch_size: 2,\n}\n\n// Default E3 configuration (`committeeSize` is `IInterfold.CommitteeSize`, not circuit N_PARTIES).\nexport const DEFAULT_E3_CONFIG = {\n  committeeSize: 0, // CommitteeSize.Micro\n  duration: 1800, // 30 minutes in seconds\n  payment_amount: '0', // 0 ETH in wei\n} as const\n\n/**\n * Encode BFV parameters for the smart contract\n * BFV (Brakerski-Fan-Vercauteren) is a type of fully homomorphic encryption\n */\nexport function encodeBfvParams(params: BfvParams): `0x${string}` {\n  const { degree, plaintextModulus, moduli, error1Variance } = params\n\n  if (error1Variance === undefined) {\n    throw new SDKError(\n      'error1Variance is required in ProtocolParams. All BFV parameter sets must specify error1_variance.',\n      'MISSING_ERROR1_VARIANCE',\n    )\n  }\n\n  return encodeAbiParameters(\n    [\n      {\n        name: 'bfvParams',\n        type: 'tuple',\n        components: [\n          { name: 'degree', type: 'uint256' },\n          { name: 'plaintext_modulus', type: 'uint256' },\n          { name: 'moduli', type: 'uint256[]' },\n          { name: 'error1_variance', type: 'string' },\n        ],\n      },\n    ],\n    [\n      {\n        degree: BigInt(degree),\n        plaintext_modulus: BigInt(plaintextModulus),\n        moduli: [...moduli],\n        error1_variance: error1Variance,\n      },\n    ],\n  )\n}\n\n/**\n * Encode compute provider parameters for the smart contract'\n * If mock is true, the compute provider parameters will return 32 bytes of 0x00\n */\nexport function encodeComputeProviderParams(params: ComputeProviderParams, mock: boolean = false): `0x${string}` {\n  if (mock) {\n    return `0x${'00'.repeat(32)}` as `0x${string}`\n  }\n\n  const jsonString = JSON.stringify(params)\n  const encoder = new TextEncoder()\n  const bytes = encoder.encode(jsonString)\n\n  return `0x${Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')}`\n}\n\n/**\n * Encode custom parameters for the smart contract.\n */\nexport function encodeCustomParams(params: Record<string, unknown>): `0x${string}` {\n  const jsonString = JSON.stringify(params)\n  const encoder = new TextEncoder()\n  const bytes = encoder.encode(jsonString)\n\n  return `0x${Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')}`\n}\n\n// inputWindow[0] is always larger than now and dkg deadline\nexport const inputWindowStartBuffer = 15n\n\n/**\n * Calculate start window for E3 request\n * @dev This function can be used for testing purposes, or for E3s which need to start as soon as possible.\n * @param publicClient - The public client to use\n * @param duration - The duration of the input window in seconds\n * @param startBuffer - Buffer in seconds added to current timestamp for input window start\n */\nexport async function calculateInputWindow(\n  publicClient: PublicClient,\n  duration: number = DEFAULT_E3_CONFIG.duration,\n  startBuffer: bigint = inputWindowStartBuffer,\n): Promise<[bigint, bigint]> {\n  const now = await getCurrentTimestamp(publicClient)\n  return [BigInt(now) + startBuffer, BigInt(now) + startBuffer + BigInt(duration)]\n}\n\n/**\n * Decode plaintextOutput bytes to get the actual result number\n */\nexport function decodePlaintextOutput(plaintextOutput: string): number | null {\n  try {\n    // Remove '0x' prefix if present\n    const hex = plaintextOutput.startsWith('0x') ? plaintextOutput.slice(2) : plaintextOutput\n\n    // Convert hex to bytes\n    const bytes = new Uint8Array(hex.match(/.{1,2}/g)?.map((byte) => parseInt(byte, 16)) || [])\n\n    if (bytes.length < 8) {\n      console.warn('Plaintext output too short for u64 decoding')\n      return null\n    }\n\n    // Decode first u64 (8 bytes) as little-endian\n    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n    const result = view.getBigUint64(0, true) // true for little-endian\n\n    return Number(result)\n  } catch (error) {\n    console.error('Failed to decode plaintext output:', error)\n    return null\n  }\n}\n\n// Helper function to convert proof bytes to field elements\nexport function proofToFields(proof: Uint8Array): string[] {\n  const fields: string[] = []\n  for (let i = 0; i < proof.length; i += 32) {\n    const chunk = proof.slice(i, i + 32)\n    fields.push('0x' + Buffer.from(chunk).toString('hex'))\n  }\n  return fields\n}\n","// SPDX-License-Identifier: LGPL-3.0-only\n//\n// This file is provided WITHOUT ANY WARRANTY;\n// without even the implied warranty of MERCHANTABILITY\n// or FITNESS FOR A PARTICULAR PURPOSE.\n\nexport interface ContractAddresses {\n  interfold: `0x${string}`\n  ciphernodeRegistry: `0x${string}`\n  feeToken: `0x${string}`\n}\n\nexport enum CommitteeSize {\n  Micro = 0,\n  Small = 1,\n  Medium = 2,\n  Large = 3,\n}\n\nexport enum ParamSet {\n  Insecure512 = 0,\n  Secure8192 = 1,\n}\n\nexport interface E3 {\n  seed: bigint\n  committeeSize: number\n  requestBlock: bigint\n  inputWindow: readonly [bigint, bigint]\n  encryptionSchemeId: string\n  e3Program: string\n  paramSet: number\n  decryptionVerifier: string\n  committeePublicKey: string\n  ciphertextOutput: string\n  plaintextOutput: string\n}\n\nexport interface RequestParams {\n  gasLimit?: bigint\n}\n\nexport interface E3RequestParams extends RequestParams {\n  committeeSize: number\n  inputWindow: readonly [bigint, bigint]\n  e3Program: `0x${string}`\n  paramSet: number\n  computeProviderParams: `0x${string}`\n  customParams?: `0x${string}`\n  /** When true, ciphernodes generate wrapper/fold proofs for DKG proof aggregation.\n   *  When false, proof aggregation is skipped for faster computation. Defaults to true. */\n  proofAggregationEnabled?: boolean\n}\n\nexport enum E3Stage {\n  None,\n  Requested,\n  CommitteeFinalized,\n  KeyPublished,\n  CiphertextReady,\n  Complete,\n  Failed,\n}\n\nexport enum FailureReason {\n  None,\n  CommitteeFormationTimeout,\n  InsufficientCommitteeMembers,\n  DKGTimeout,\n  DKGInvalidShares,\n  NoInputsReceived,\n  ComputeTimeout,\n  ComputeProviderExpired,\n  ComputeProviderFailed,\n  RequesterCancelled,\n  DecryptionTimeout,\n  DecryptionInvalidShares,\n  VerificationFailed,\n}\n"],"mappings":"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","names":["import_viem","E3Stage","FailureReason"]}

package/dist/contracts/index.d.ts

@@ -0,0 +1,34 @@
+import { PublicClient, WalletClient, Chain, Hash, Abi, TransactionReceipt } from 'viem';
+import { C as ContractAddresses, a as E3RequestParams, E as E3, F as FailureReason, b as E3Stage } from '../types-C9WZ1Khd.js';
+
+interface ContractClientConfig {
+    publicClient: PublicClient;
+    walletClient?: WalletClient;
+    contracts: ContractAddresses;
+}
+declare class ContractClient {
+    private publicClient;
+    private walletClient?;
+    private contracts;
+    private contractInfo;
+    constructor(config: ContractClientConfig);
+    static create(options: {
+        rpcUrl: string;
+        contracts: ContractAddresses;
+        privateKey?: `0x${string}`;
+        chain: Chain;
+    }): ContractClient;
+    getPublicClient(): PublicClient;
+    approveFeeToken(amount: bigint): Promise<Hash>;
+    requestE3(params: E3RequestParams): Promise<Hash>;
+    publishCiphertextOutput(e3Id: bigint, ciphertextOutput: `0x${string}`, proof: `0x${string}`, gasLimit?: bigint): Promise<Hash>;
+    getE3(e3Id: bigint): Promise<E3>;
+    getE3Quote(requestParams: E3RequestParams): Promise<bigint>;
+    getFailureReason(e3Id: bigint): Promise<FailureReason>;
+    getE3PublicKey(e3Id: bigint): Promise<`0x${string}`>;
+    getE3Stage(e3Id: bigint): Promise<E3Stage>;
+    estimateGas(functionName: string, args: readonly unknown[], contractAddress: `0x${string}`, abi: Abi, value?: bigint): Promise<bigint>;
+    waitForTransaction(hash: Hash): Promise<TransactionReceipt>;
+}
+
+export { ContractAddresses, ContractClient, type ContractClientConfig, E3, E3RequestParams, E3Stage, FailureReason };