@cofhe/sdk 0.3.2 → 0.5.0

package/dist/{clientTypes-Y43CKbOz.d.cts → clientTypes-BSbwairE.d.cts}

@@ -1,7 +1,7 @@
-import { WalletClient, PublicClient } from 'viem';
-import { C as CofheChain } from './types-YiAC4gig.cjs';
+import { WalletClient, PublicClient, Hex } from 'viem';
+import { C as CofheChain } from './types-C07FK-cL.cjs';
 import { z } from 'zod';
-import { P as Permit, S as SerializedPermit, C as CreateSelfPermitOptions, m as SelfPermit, d as CreateSharingPermitOptions, n as SharingPermit, I as ImportSharedPermitOptions, R as RecipientPermit, o as PermitHashFields, g as PermitUtils } from './permit-MZ502UBl.cjs';
+import { P as Permit, S as SerializedPermit, C as CreateSelfPermitOptions, m as SelfPermit, d as CreateSharingPermitOptions, n as SharingPermit, I as ImportSharedPermitOptions, R as RecipientPermit, o as PermitHashFields, g as PermitUtils } from './permit-DnVMDT5h.cjs';
 import { StoreApi } from 'zustand/vanilla';
 
 type TfheInitializer = () => Promise<boolean>;
@@ -165,6 +165,24 @@ type EncryptStepCallbackContext = Record<string, any> & {
     duration: number;
 };
 type EncryptStepCallbackFunction = (state: EncryptStep, context?: EncryptStepCallbackContext) => void;
+type DecryptEndpoint = 'decrypt' | 'sealoutput';
+type DecryptPollCallbackContext = {
+    operation: DecryptEndpoint;
+    requestId: string;
+    attemptIndex: number;
+    elapsedMs: number;
+    intervalMs: number;
+    timeoutMs: number;
+};
+type DecryptPollCallbackFunction = (context: DecryptPollCallbackContext) => void;
+/**
+ * Decrypted plaintext value returned by view-decryption helpers.
+ *
+ * This is a scalar JS value (not a wrapper object):
+ * - `boolean` for `FheTypes.Bool`
+ * - checksummed address `string` for `FheTypes.Uint160`
+ * - `bigint` for supported integer utypes
+ */
 type UnsealedItem<U extends FheTypes> = U extends FheTypes.Bool ? boolean : U extends FheTypes.Uint160 ? string : U extends FheUintUTypesType ? bigint : never;
 
 /**
@@ -352,6 +370,7 @@ declare class DecryptForViewBuilder<U extends FheTypes> extends BaseBuilder {
     private utype;
     private permitHash?;
     private permit?;
+    private pollCallback?;
     constructor(params: DecryptForViewBuilderParams<U>);
     /**
      * @param chainId - Chain to decrypt values from. Used to fetch the threshold network URL and use the correct permit.
@@ -385,6 +404,7 @@ declare class DecryptForViewBuilder<U extends FheTypes> extends BaseBuilder {
      */
     setAccount(account: string): DecryptForViewBuilder<U>;
     getAccount(): string | undefined;
+    onPoll(callback: DecryptPollCallbackFunction): DecryptForViewBuilder<U>;
     /**
      * Select "use permit" mode (optional).
      *
@@ -486,6 +506,7 @@ declare class DecryptForTxBuilder extends BaseBuilder {
     private permitHash?;
     private permit?;
     private permitSelection;
+    private pollCallback?;
     constructor(params: DecryptForTxBuilderParams);
     /**
      * @param chainId - Chain to decrypt values from. Used to fetch the threshold network URL and use the correct permit.
@@ -521,6 +542,8 @@ declare class DecryptForTxBuilder extends BaseBuilder {
     setAccount(this: DecryptForTxBuilderUnset, account: string): DecryptForTxBuilderUnset;
     setAccount(this: DecryptForTxBuilderSelected, account: string): DecryptForTxBuilderSelected;
     getAccount(): string | undefined;
+    onPoll(this: DecryptForTxBuilderUnset, callback: DecryptPollCallbackFunction): DecryptForTxBuilderUnset;
+    onPoll(this: DecryptForTxBuilderSelected, callback: DecryptPollCallbackFunction): DecryptForTxBuilderSelected;
     /**
      * Select "use permit" mode.
      *
@@ -590,11 +613,10 @@ interface ZkProveWorkerResponse {
     error?: string;
 }
 type ZkProvenCiphertextList = {
-    serialize(): Uint8Array;
+    safe_serialize(serialized_size_limit: bigint): Uint8Array;
 };
 type ZkCompactPkeCrs = {
     free(): void;
-    serialize(compress: boolean): Uint8Array;
     safe_serialize(serialized_size_limit: bigint): Uint8Array;
 };
 type ZkCiphertextListBuilder = {
@@ -892,11 +914,12 @@ declare const permits: {
     getOrCreateSelfPermit: (publicClient: PublicClient, walletClient: WalletClient, chainId?: number, account?: string, options?: CreateSelfPermitOptions) => Promise<Permit>;
     getOrCreateSharingPermit: (publicClient: PublicClient, walletClient: WalletClient, options: CreateSharingPermitOptions, chainId?: number, account?: string) => Promise<Permit>;
     getHash: (permit: PermitHashFields) => string;
+    export: (permit: Permit) => string;
     serialize: (permit: Permit) => SerializedPermit;
     deserialize: (serialized: SerializedPermit) => Permit;
-    getPermit: (chainId: number, account: string, hash: string) => Promise<Permit | undefined>;
-    getPermits: (chainId: number, account: string) => Promise<Record<string, Permit>>;
-    getActivePermit: (chainId: number, account: string) => Promise<Permit | undefined>;
+    getPermit: (chainId: number, account: string, hash: string) => Permit | undefined;
+    getPermits: (chainId: number, account: string) => Record<string, Permit>;
+    getActivePermit: (chainId: number, account: string) => Permit | undefined;
     getActivePermitHash: (chainId: number, account: string) => string | undefined;
     removePermit: (chainId: number, account: string, hash: string) => Promise<void>;
     selectActivePermit: (chainId: number, account: string, hash: string) => void;
@@ -927,6 +950,7 @@ type CofheClient<TConfig extends CofheConfig = CofheConfig> = {
     decryptHandle<U extends FheTypes>(ctHash: bigint | string, utype: U): DecryptForViewBuilder<U>;
     decryptForView<U extends FheTypes>(ctHash: bigint | string, utype: U): DecryptForViewBuilder<U>;
     decryptForTx(ctHash: bigint | string): DecryptForTxBuilderUnset;
+    verifyDecryptResult(handle: bigint | string, cleartext: bigint, signature: Hex): Promise<boolean>;
     permits: CofheClientPermits;
 };
 type CofheClientConnectionState = {
@@ -949,16 +973,17 @@ type CofheClientPermits = {
     createSelf: (options: CreateSelfPermitOptions, clients?: CofheClientPermitsClients) => Promise<SelfPermit>;
     createSharing: (options: CreateSharingPermitOptions, clients?: CofheClientPermitsClients) => Promise<SharingPermit>;
     importShared: (options: ImportSharedPermitOptions | string, clients?: CofheClientPermitsClients) => Promise<RecipientPermit>;
-    getPermit: (hash: string, chainId?: number, account?: string) => Promise<Permit | undefined>;
-    getPermits: (chainId?: number, account?: string) => Promise<Record<string, Permit>>;
-    getActivePermit: (chainId?: number, account?: string) => Promise<Permit | undefined>;
-    getActivePermitHash: (chainId?: number, account?: string) => Promise<string | undefined>;
+    getPermit: (hash: string, chainId?: number, account?: string) => Permit | undefined;
+    getPermits: (chainId?: number, account?: string) => Record<string, Permit>;
+    getActivePermit: (chainId?: number, account?: string) => Permit | undefined;
+    getActivePermitHash: (chainId?: number, account?: string) => string | undefined;
     getOrCreateSelfPermit: (chainId?: number, account?: string, options?: CreateSelfPermitOptions) => Promise<Permit>;
     getOrCreateSharingPermit: (options: CreateSharingPermitOptions, chainId?: number, account?: string) => Promise<Permit>;
     selectActivePermit: (hash: string, chainId?: number, account?: string) => void;
     removePermit: (hash: string, chainId?: number, account?: string) => void;
     removeActivePermit: (chainId?: number, account?: string) => void;
     getHash: typeof PermitUtils.getHash;
+    export: typeof PermitUtils.export;
     serialize: typeof PermitUtils.serialize;
     deserialize: typeof PermitUtils.deserialize;
 };
@@ -971,4 +996,4 @@ type CofheClientParams<TConfig extends CofheConfig> = {
     zkProveWorkerFn?: ZkProveWorkerFunction;
 };
 
-export { type ZkProveWorkerFunction as $, type FheTypeValue as A, type EncryptStepCallbackFunction as B, type CofheInputConfig as C, type EncryptStepCallbackContext as D, type EncryptableItem as E, FheTypes as F, FheUintUTypes as G, FheAllUTypes as H, type IStorage as I, Encryptable as J, isEncryptableItem as K, type LiteralToPrimitive as L, EncryptStep as M, isLastEncryptionStep as N, assertCorrectEncryptedItemInput as O, type Primitive as P, fetchKeys as Q, type FheKeyDeserializer as R, createKeysStore as S, type KeysStorage as T, type UnsealedItem as U, type KeysStore as V, EncryptInputsBuilder as W, DecryptForViewBuilder as X, DecryptForTxBuilder as Y, type DecryptForTxResult as Z, type ZkBuilderAndCrsGenerator as _, type CofheConfig as a, type ZkProveWorkerRequest as a0, type ZkProveWorkerResponse as a1, zkProveWithWorker as a2, type CofheClient as b, type CofheClientConnectionState as c, type CofheClientParams as d, createCofheConfigBase as e, type CofheInternalConfig as f, getCofheConfigItem as g, type CofheClientPermits as h, type EncryptableBool as i, type EncryptableUint8 as j, type EncryptableUint16 as k, type EncryptableUint32 as l, type EncryptableUint64 as m, type EncryptableUint128 as n, type EncryptableAddress as o, type EncryptedNumber as p, type EncryptedItemInput as q, type EncryptedBoolInput as r, type EncryptedUint8Input as s, type EncryptedUint16Input as t, type EncryptedUint32Input as u, type EncryptedUint64Input as v, type EncryptedUint128Input as w, type EncryptedAddressInput as x, type EncryptedItemInputs as y, type EncryptableToEncryptedItemInputMap as z };
+export { DecryptForTxBuilder as $, type FheTypeValue as A, type DecryptPollCallbackContext as B, type CofheInputConfig as C, type DecryptPollCallbackFunction as D, type EncryptableItem as E, FheTypes as F, type DecryptEndpoint as G, type EncryptStepCallbackFunction as H, type IStorage as I, type EncryptStepCallbackContext as J, FheUintUTypes as K, type LiteralToPrimitive as L, FheAllUTypes as M, Encryptable as N, isEncryptableItem as O, type Primitive as P, EncryptStep as Q, isLastEncryptionStep as R, assertCorrectEncryptedItemInput as S, fetchKeys as T, type UnsealedItem as U, type FheKeyDeserializer as V, createKeysStore as W, type KeysStorage as X, type KeysStore as Y, EncryptInputsBuilder as Z, DecryptForViewBuilder as _, type CofheConfig as a, type DecryptForTxResult as a0, type ZkBuilderAndCrsGenerator as a1, type ZkProveWorkerFunction as a2, type ZkProveWorkerRequest as a3, type ZkProveWorkerResponse as a4, zkProveWithWorker as a5, type CofheClient as b, type CofheClientParams as c, type CofheClientConnectionState as d, createCofheConfigBase as e, type CofheInternalConfig as f, getCofheConfigItem as g, type CofheClientPermits as h, type EncryptableBool as i, type EncryptableUint8 as j, type EncryptableUint16 as k, type EncryptableUint32 as l, type EncryptableUint64 as m, type EncryptableUint128 as n, type EncryptableAddress as o, type EncryptedNumber as p, type EncryptedItemInput as q, type EncryptedBoolInput as r, type EncryptedUint8Input as s, type EncryptedUint16Input as t, type EncryptedUint32Input as u, type EncryptedUint64Input as v, type EncryptedUint128Input as w, type EncryptedAddressInput as x, type EncryptedItemInputs as y, type EncryptableToEncryptedItemInputMap as z };

package/dist/{clientTypes-PQha8zes.d.ts → clientTypes-DDmcgZ0a.d.ts}

@@ -1,7 +1,7 @@
-import { WalletClient, PublicClient } from 'viem';
-import { C as CofheChain } from './types-YiAC4gig.js';
+import { WalletClient, PublicClient, Hex } from 'viem';
+import { C as CofheChain } from './types-C07FK-cL.js';
 import { z } from 'zod';
-import { P as Permit, S as SerializedPermit, C as CreateSelfPermitOptions, m as SelfPermit, d as CreateSharingPermitOptions, n as SharingPermit, I as ImportSharedPermitOptions, R as RecipientPermit, o as PermitHashFields, g as PermitUtils } from './permit-MZ502UBl.js';
+import { P as Permit, S as SerializedPermit, C as CreateSelfPermitOptions, m as SelfPermit, d as CreateSharingPermitOptions, n as SharingPermit, I as ImportSharedPermitOptions, R as RecipientPermit, o as PermitHashFields, g as PermitUtils } from './permit-DnVMDT5h.js';
 import { StoreApi } from 'zustand/vanilla';
 
 type TfheInitializer = () => Promise<boolean>;
@@ -165,6 +165,24 @@ type EncryptStepCallbackContext = Record<string, any> & {
     duration: number;
 };
 type EncryptStepCallbackFunction = (state: EncryptStep, context?: EncryptStepCallbackContext) => void;
+type DecryptEndpoint = 'decrypt' | 'sealoutput';
+type DecryptPollCallbackContext = {
+    operation: DecryptEndpoint;
+    requestId: string;
+    attemptIndex: number;
+    elapsedMs: number;
+    intervalMs: number;
+    timeoutMs: number;
+};
+type DecryptPollCallbackFunction = (context: DecryptPollCallbackContext) => void;
+/**
+ * Decrypted plaintext value returned by view-decryption helpers.
+ *
+ * This is a scalar JS value (not a wrapper object):
+ * - `boolean` for `FheTypes.Bool`
+ * - checksummed address `string` for `FheTypes.Uint160`
+ * - `bigint` for supported integer utypes
+ */
 type UnsealedItem<U extends FheTypes> = U extends FheTypes.Bool ? boolean : U extends FheTypes.Uint160 ? string : U extends FheUintUTypesType ? bigint : never;
 
 /**
@@ -352,6 +370,7 @@ declare class DecryptForViewBuilder<U extends FheTypes> extends BaseBuilder {
     private utype;
     private permitHash?;
     private permit?;
+    private pollCallback?;
     constructor(params: DecryptForViewBuilderParams<U>);
     /**
      * @param chainId - Chain to decrypt values from. Used to fetch the threshold network URL and use the correct permit.
@@ -385,6 +404,7 @@ declare class DecryptForViewBuilder<U extends FheTypes> extends BaseBuilder {
      */
     setAccount(account: string): DecryptForViewBuilder<U>;
     getAccount(): string | undefined;
+    onPoll(callback: DecryptPollCallbackFunction): DecryptForViewBuilder<U>;
     /**
      * Select "use permit" mode (optional).
      *
@@ -486,6 +506,7 @@ declare class DecryptForTxBuilder extends BaseBuilder {
     private permitHash?;
     private permit?;
     private permitSelection;
+    private pollCallback?;
     constructor(params: DecryptForTxBuilderParams);
     /**
      * @param chainId - Chain to decrypt values from. Used to fetch the threshold network URL and use the correct permit.
@@ -521,6 +542,8 @@ declare class DecryptForTxBuilder extends BaseBuilder {
     setAccount(this: DecryptForTxBuilderUnset, account: string): DecryptForTxBuilderUnset;
     setAccount(this: DecryptForTxBuilderSelected, account: string): DecryptForTxBuilderSelected;
     getAccount(): string | undefined;
+    onPoll(this: DecryptForTxBuilderUnset, callback: DecryptPollCallbackFunction): DecryptForTxBuilderUnset;
+    onPoll(this: DecryptForTxBuilderSelected, callback: DecryptPollCallbackFunction): DecryptForTxBuilderSelected;
     /**
      * Select "use permit" mode.
      *
@@ -590,11 +613,10 @@ interface ZkProveWorkerResponse {
     error?: string;
 }
 type ZkProvenCiphertextList = {
-    serialize(): Uint8Array;
+    safe_serialize(serialized_size_limit: bigint): Uint8Array;
 };
 type ZkCompactPkeCrs = {
     free(): void;
-    serialize(compress: boolean): Uint8Array;
     safe_serialize(serialized_size_limit: bigint): Uint8Array;
 };
 type ZkCiphertextListBuilder = {
@@ -892,11 +914,12 @@ declare const permits: {
     getOrCreateSelfPermit: (publicClient: PublicClient, walletClient: WalletClient, chainId?: number, account?: string, options?: CreateSelfPermitOptions) => Promise<Permit>;
     getOrCreateSharingPermit: (publicClient: PublicClient, walletClient: WalletClient, options: CreateSharingPermitOptions, chainId?: number, account?: string) => Promise<Permit>;
     getHash: (permit: PermitHashFields) => string;
+    export: (permit: Permit) => string;
     serialize: (permit: Permit) => SerializedPermit;
     deserialize: (serialized: SerializedPermit) => Permit;
-    getPermit: (chainId: number, account: string, hash: string) => Promise<Permit | undefined>;
-    getPermits: (chainId: number, account: string) => Promise<Record<string, Permit>>;
-    getActivePermit: (chainId: number, account: string) => Promise<Permit | undefined>;
+    getPermit: (chainId: number, account: string, hash: string) => Permit | undefined;
+    getPermits: (chainId: number, account: string) => Record<string, Permit>;
+    getActivePermit: (chainId: number, account: string) => Permit | undefined;
     getActivePermitHash: (chainId: number, account: string) => string | undefined;
     removePermit: (chainId: number, account: string, hash: string) => Promise<void>;
     selectActivePermit: (chainId: number, account: string, hash: string) => void;
@@ -927,6 +950,7 @@ type CofheClient<TConfig extends CofheConfig = CofheConfig> = {
     decryptHandle<U extends FheTypes>(ctHash: bigint | string, utype: U): DecryptForViewBuilder<U>;
     decryptForView<U extends FheTypes>(ctHash: bigint | string, utype: U): DecryptForViewBuilder<U>;
     decryptForTx(ctHash: bigint | string): DecryptForTxBuilderUnset;
+    verifyDecryptResult(handle: bigint | string, cleartext: bigint, signature: Hex): Promise<boolean>;
     permits: CofheClientPermits;
 };
 type CofheClientConnectionState = {
@@ -949,16 +973,17 @@ type CofheClientPermits = {
     createSelf: (options: CreateSelfPermitOptions, clients?: CofheClientPermitsClients) => Promise<SelfPermit>;
     createSharing: (options: CreateSharingPermitOptions, clients?: CofheClientPermitsClients) => Promise<SharingPermit>;
     importShared: (options: ImportSharedPermitOptions | string, clients?: CofheClientPermitsClients) => Promise<RecipientPermit>;
-    getPermit: (hash: string, chainId?: number, account?: string) => Promise<Permit | undefined>;
-    getPermits: (chainId?: number, account?: string) => Promise<Record<string, Permit>>;
-    getActivePermit: (chainId?: number, account?: string) => Promise<Permit | undefined>;
-    getActivePermitHash: (chainId?: number, account?: string) => Promise<string | undefined>;
+    getPermit: (hash: string, chainId?: number, account?: string) => Permit | undefined;
+    getPermits: (chainId?: number, account?: string) => Record<string, Permit>;
+    getActivePermit: (chainId?: number, account?: string) => Permit | undefined;
+    getActivePermitHash: (chainId?: number, account?: string) => string | undefined;
     getOrCreateSelfPermit: (chainId?: number, account?: string, options?: CreateSelfPermitOptions) => Promise<Permit>;
     getOrCreateSharingPermit: (options: CreateSharingPermitOptions, chainId?: number, account?: string) => Promise<Permit>;
     selectActivePermit: (hash: string, chainId?: number, account?: string) => void;
     removePermit: (hash: string, chainId?: number, account?: string) => void;
     removeActivePermit: (chainId?: number, account?: string) => void;
     getHash: typeof PermitUtils.getHash;
+    export: typeof PermitUtils.export;
     serialize: typeof PermitUtils.serialize;
     deserialize: typeof PermitUtils.deserialize;
 };
@@ -971,4 +996,4 @@ type CofheClientParams<TConfig extends CofheConfig> = {
     zkProveWorkerFn?: ZkProveWorkerFunction;
 };
 
-export { type ZkProveWorkerFunction as $, type FheTypeValue as A, type EncryptStepCallbackFunction as B, type CofheInputConfig as C, type EncryptStepCallbackContext as D, type EncryptableItem as E, FheTypes as F, FheUintUTypes as G, FheAllUTypes as H, type IStorage as I, Encryptable as J, isEncryptableItem as K, type LiteralToPrimitive as L, EncryptStep as M, isLastEncryptionStep as N, assertCorrectEncryptedItemInput as O, type Primitive as P, fetchKeys as Q, type FheKeyDeserializer as R, createKeysStore as S, type KeysStorage as T, type UnsealedItem as U, type KeysStore as V, EncryptInputsBuilder as W, DecryptForViewBuilder as X, DecryptForTxBuilder as Y, type DecryptForTxResult as Z, type ZkBuilderAndCrsGenerator as _, type CofheConfig as a, type ZkProveWorkerRequest as a0, type ZkProveWorkerResponse as a1, zkProveWithWorker as a2, type CofheClient as b, type CofheClientConnectionState as c, type CofheClientParams as d, createCofheConfigBase as e, type CofheInternalConfig as f, getCofheConfigItem as g, type CofheClientPermits as h, type EncryptableBool as i, type EncryptableUint8 as j, type EncryptableUint16 as k, type EncryptableUint32 as l, type EncryptableUint64 as m, type EncryptableUint128 as n, type EncryptableAddress as o, type EncryptedNumber as p, type EncryptedItemInput as q, type EncryptedBoolInput as r, type EncryptedUint8Input as s, type EncryptedUint16Input as t, type EncryptedUint32Input as u, type EncryptedUint64Input as v, type EncryptedUint128Input as w, type EncryptedAddressInput as x, type EncryptedItemInputs as y, type EncryptableToEncryptedItemInputMap as z };
+export { DecryptForTxBuilder as $, type FheTypeValue as A, type DecryptPollCallbackContext as B, type CofheInputConfig as C, type DecryptPollCallbackFunction as D, type EncryptableItem as E, FheTypes as F, type DecryptEndpoint as G, type EncryptStepCallbackFunction as H, type IStorage as I, type EncryptStepCallbackContext as J, FheUintUTypes as K, type LiteralToPrimitive as L, FheAllUTypes as M, Encryptable as N, isEncryptableItem as O, type Primitive as P, EncryptStep as Q, isLastEncryptionStep as R, assertCorrectEncryptedItemInput as S, fetchKeys as T, type UnsealedItem as U, type FheKeyDeserializer as V, createKeysStore as W, type KeysStorage as X, type KeysStore as Y, EncryptInputsBuilder as Z, DecryptForViewBuilder as _, type CofheConfig as a, type DecryptForTxResult as a0, type ZkBuilderAndCrsGenerator as a1, type ZkProveWorkerFunction as a2, type ZkProveWorkerRequest as a3, type ZkProveWorkerResponse as a4, zkProveWithWorker as a5, type CofheClient as b, type CofheClientParams as c, type CofheClientConnectionState as d, createCofheConfigBase as e, type CofheInternalConfig as f, getCofheConfigItem as g, type CofheClientPermits as h, type EncryptableBool as i, type EncryptableUint8 as j, type EncryptableUint16 as k, type EncryptableUint32 as l, type EncryptableUint64 as m, type EncryptableUint128 as n, type EncryptableAddress as o, type EncryptedNumber as p, type EncryptedItemInput as q, type EncryptedBoolInput as r, type EncryptedUint8Input as s, type EncryptedUint16Input as t, type EncryptedUint32Input as u, type EncryptedUint64Input as v, type EncryptedUint128Input as w, type EncryptedAddressInput as x, type EncryptedItemInputs as y, type EncryptableToEncryptedItemInputMap as z };