@inco/js 0.7.1 → 0.7.3

package/dist/types/lite/lightning.d.ts

@@ -205,6 +205,7 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      *
      * @param ephemeralKeypair Session keypair matching the voucher grantee.
      * @param allowanceVoucherWithSig Signed allowance voucher.
+     * @param ethClient - A public eth client or eth wallet client used for signing the attested decrypt request
      * @param handles Handles to decrypt.
      * @param options Optional reencryption/backoff configuration.
      *
@@ -213,6 +214,7 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * const attestations = await lightning.attestedDecryptWithVoucher(
      *   ephemeralKeypair,
      *   voucher,
+     *   ethClient,
      *   [handle],
      * );
      * ```
@@ -222,14 +224,15 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * const encrypted = await lightning.attestedDecryptWithVoucher(
      *   ephemeralKeypair,
      *   voucher,
+     *   ethClient,
      *   [handle],
      *   { reencryptPubKey: delegateKeypair.encodePublicKey() },
      * );
      * ```
      */
-    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, handles: HexString[], backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
-    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, handles: HexString[], reencryptPubKey: Uint8Array, backoffConfig?: Partial<BackoffConfig>): Promise<Array<EncryptedDecryptionAttestation<EciesScheme, SupportedFheType>>>;
-    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, handles: HexString[], reencryptPubKey: Uint8Array, reencryptKeypair: Secp256k1Keypair, backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
+    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, handles: HexString[], backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
+    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, handles: HexString[], reencryptPubKey: Uint8Array, backoffConfig?: Partial<BackoffConfig>): Promise<Array<EncryptedDecryptionAttestation<EciesScheme, SupportedFheType>>>;
+    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, handles: HexString[], reencryptPubKey: Uint8Array, reencryptKeypair: Secp256k1Keypair, backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
     /**
      * Get an attested compute for the given wallet client.
      *
@@ -240,7 +243,7 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * @param backoffConfig - The backoff configuration for the attested compute request
      * @returns The decryption attestation
      *
-     * @example
+     * @example Plaintext result
      * ```typescript
      * import { AttestedComputeSupportedOps } from '../lite/attested-compute.js';
      * const lhsHandle = '0x...';
@@ -249,23 +252,80 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * const response = await lightning.attestedCompute(walletClient, lhsHandle, op, rhsPlaintext);
      * const { plaintext, covalidatorSignature, handle } = response;
      * ```
+     *
+     * @example Reencrypt for a delegate
+     * ```ts
+     * const encrypted = await lightning.attestedCompute(
+     *   walletClient,
+     *   lhsHandle,
+     *   op,
+     *   rhsPlaintext,
+     *   delegatePubKey,
+     * );
+     * console.log(encrypted.encryptedPlaintext.ciphertext.value);
+     * ```
+     *
+     * @example Reencrypt and decrypt locally
+     * ```ts
+     * const decrypted = await lightning.attestedCompute(
+     *   walletClient,
+     *   lhsHandle,
+     *   op,
+     *   rhsPlaintext,
+     *   keypair.encodePublicKey(),
+     *   keypair,
+     * );
+     * console.log(decrypted.plaintext.value);
+     * ```
      */
     attestedCompute(walletClient: WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
+    attestedCompute(walletClient: WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, reencryptPubKey: Uint8Array, backoffConfig?: Partial<BackoffConfig>): Promise<EncryptedDecryptionAttestation<EciesScheme, SupportedFheType>>;
+    attestedCompute(walletClient: WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, reencryptPubKey: Uint8Array, reencryptKeypair: Secp256k1Keypair, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
     /**
      * Performs attested compute via a voucher-backed session key.
      *
-     * @example
+     * @example Plaintext result
      * ```ts
      * const attestation = await lightning.attestedComputeWithVoucher(
      *   ephemeralKeypair,
      *   voucher,
+     *   ethClient,
+     *   lhsHandle,
+     *   AttestedComputeSupportedOps.Eq,
+     *   true,
+     * );
+     * ```
+     *
+     * @example Reencrypt for a delegate
+     * ```ts
+     * const encrypted = await lightning.attestedComputeWithVoucher(
+     *   ephemeralKeypair,
+     *   voucher,
+     *   lhsHandle,
+     *   AttestedComputeSupportedOps.Eq,
+     *   true,
+     *   delegatePubKey,
+     * );
+     * console.log(encrypted.encryptedPlaintext.ciphertext.value);
+     * ```
+     *
+     * @example Reencrypt and decrypt locally
+     * ```ts
+     * const decrypted = await lightning.attestedComputeWithVoucher(
+     *   ephemeralKeypair,
+     *   voucher,
      *   lhsHandle,
      *   AttestedComputeSupportedOps.Eq,
      *   true,
+     *   keypair.encodePublicKey(),
+     *   keypair,
      * );
+     * console.log(decrypted.plaintext.value);
      * ```
      */
-    attestedComputeWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
+    attestedComputeWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
+    attestedComputeWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, reencryptPubKey: Uint8Array, backoffConfig?: Partial<BackoffConfig>): Promise<EncryptedDecryptionAttestation<EciesScheme, SupportedFheType>>;
+    attestedComputeWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, reencryptPubKey: Uint8Array, reencryptKeypair: Secp256k1Keypair, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
     /**
      * Get an decryption of publicly revealed handles.
      *
@@ -275,7 +335,7 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      *
      * @example
      * ```typescript
-     * const response = await lightning.attestedReveal([handle1, handle2]);
+     * const response = await lightning.attestedReveal([handle1, handle2], ethClient);
      * const { plaintext, covalidatorSignature } = response[0];
      * ```
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inco/js",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "repository": "https://github.com/Inco-fhevm/inco-monorepo",
   "license": "Apache-2.0",
   "sideEffects": false,