@inco/js 0.3.0 → 0.3.2

package/dist/types/lite/attested-compute.d.ts

@@ -1,4 +1,3 @@
-import { type IncoLiteAttestedComputeArgs, incoLiteAttestedCompute } from '../attestedcompute/attested-compute.js';
+import { type IncoLiteAttestedComputeArgs } from '../attestedcompute/attested-compute.js';
 import { type AttestedComputeSupportedOps } from '../attestedcompute/types.js';
-export { incoLiteAttestedCompute };
 export type { AttestedComputeSupportedOps, IncoLiteAttestedComputeArgs };

package/dist/types/lite/attested-decrypt.d.ts

@@ -1,3 +1,2 @@
-import { type IncoLiteAttestedDecryptorArgs, incoLiteAttestedDecryptor } from '../attesteddecrypt/attested-decrypt.js';
-export { incoLiteAttestedDecryptor };
+import { type IncoLiteAttestedDecryptorArgs } from '../attesteddecrypt/attested-decrypt.js';
 export type { IncoLiteAttestedDecryptorArgs };

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

@@ -1,10 +1,15 @@
 import { Account, Chain, Transport, WalletClient } from 'viem';
+import { AllowanceVoucherWithSig } from '../advancedacl/types.js';
+import { AttestedComputeOP } from '../attestedcompute/types.js';
+import { DecryptionAttestation } from '../attesteddecrypt/index.js';
 import { Address, HexString } from '../binary.js';
-import { EciesScheme } from '../encryption/index.js';
+import { EciesScheme, PlaintextOf, SupportedFheType } from '../encryption/index.js';
 import { lightningDeployments } from '../generated/lightning.js';
 import { localNodeLightningConfig } from '../generated/local-node.js';
 import { LocalNodeEnv } from '../local/index.js';
 import type { Reencryptor } from '../reencryption/index.js';
+import { BackoffConfig } from '../retry.js';
+import { Secp256k1Keypair } from './ecies.js';
 type TupleToUnion<T> = T extends readonly unknown[] ? T[number] : never;
 type Deployment = TupleToUnion<typeof lightningDeployments>;
 type DistributedPick<T, K> = T extends any ? Pick<T, Extract<keyof T, K>> : never;
@@ -120,6 +125,94 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * @param walletClient the wallet client to use for signing the reencrypt request.
      */
     getReencryptor(walletClient: WalletClient<Transport, Chain, Account>): Promise<Reencryptor<EciesScheme>>;
+    /**
+     * Grants a session key allowance voucher for secure reencryption operations.
+     *
+     * This method creates a signed allowance voucher that authorizes a specific requester address
+     * to perform reencryption operations using session keys. The voucher includes an expiration time
+     * and can optionally specify a custom session verifier contract address.
+     *
+     * @param walletClient - The wallet client used for signing the allowance voucher
+     * @param granteeAddress - The address of the entity requesting the session key allowance
+     * @param expiresAt - The timestamp when the allowance voucher expires (as a bigint)
+     * @param sessionVerifierAddress - Optional custom session verifier contract address. If not provided, uses the executor address
+     * @returns A promise that resolves to an AllowanceVoucherWithSig containing the signed allowance voucher
+     *
+     * @example
+     * ```typescript
+     * const voucher = await lightning.grantSessionKeyAllowanceVoucher(
+     *   walletClient,
+     *   "0x1234...",
+     *   BigInt(Date.now() + 3600000), // 1 hour from now
+     *   "0x5678..." // optional custom verifier
+     * );
+     * ```
+     */
+    grantSessionKeyAllowanceVoucher(walletClient: WalletClient<Transport, Chain, Account>, granteeAddress: string, expiresAt: Date, sessionVerifierAddress: string): Promise<AllowanceVoucherWithSig>;
+    /**
+     * Creates a session key reencryptor for secure data reencryption operations.
+     *
+     * This method returns a reencryptor instance that can be used to perform reencryption
+     * operations using session keys. The reencryptor is configured with the provided
+     * allowance voucher and ephemeral keypair for secure communication.
+     *
+     * @param allowanceVoucherWithSig - The signed allowance voucher obtained from grantSessionKeyAllowanceVoucher
+     * @param ephemeralKeypair - The ephemeral keypair used for secure communication with the KMS make sure it has allowance to voucher
+     * @returns A reencryptor instance configured for session key operations
+     *
+     * @example
+     * ```typescript
+     * const reencryptor = await lightning.getSessionKeyRencryptor(voucher, ephemeralKeypair);
+     * const decryptedValue = await reencryptor({handle: resultHandle});
+     * ```
+     */
+    getSessionKeyRencryptor(allowanceVoucherWithSig: AllowanceVoucherWithSig, ephemeralKeypair: Secp256k1Keypair): Promise<(<T_1 extends SupportedFheType>({ handle }: import("../reencryption/types.js").ReencryptFnArgs<EciesScheme, T_1>) => Promise<PlaintextOf<1, 0 | 5 | 7 | 8>>)>;
+    /**
+     * Updates the active session nonce for the given wallet client.
+     *
+     * This method updates the active session nonce for the given wallet client.
+     * It nullifies all the previous shared addresses accessing the voucher.
+     *
+     * @param walletClient - The wallet client used for updating the session nonce
+     * @returns The transaction hash of the updateActiveVouchersSessionNonce transaction
+     */
+    updateActiveVouchersSessionNonce(walletClient: WalletClient<Transport, Chain, Account>): Promise<HexString>;
+    /**
+     * Get an attested decryptor for the given wallet client.
+     *
+     * @param walletClient - The wallet client used for signing the attested decrypt request
+     * @param handles - The handles to decrypt
+     * @param backoffConfig - The backoff configuration for the attested decrypt request
+     * @returns The decryption attestations
+     *
+     * @example
+     * ```typescript
+     * const response = await lightning.attestedDecrypt(walletClient, [handle1, handle2]);
+     * const { plaintext, covalidatorSignature } = response[0];
+     * ```
+     */
+    attestedDecrypt(walletClient: WalletClient<Transport, Chain, Account>, handles: HexString[], backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
+    /**
+     * Get an attested compute for the given wallet client.
+     *
+     * @param walletClient - The wallet client used for signing the attested compute request
+     * @param lhsHandle - The handle to compute
+     * @param op - The operation to perform
+     * @param rhsPlaintext - The plaintext to compute with
+     * @param backoffConfig - The backoff configuration for the attested compute request
+     * @returns The decryption attestation
+     *
+     * @example
+     * ```typescript
+     * import { AttestedComputeSupportedOps } from '../lite/attested-compute.js';
+     * const lhsHandle = '0x...';
+     * const rhsPlaintext = 1337n;
+     * const op = AttestedComputeSupportedOps.Eq;
+     * const response = await lightning.attestedCompute(walletClient, lhsHandle, op, rhsPlaintext);
+     * const { plaintext, covalidatorSignature, handle } = response;
+     * ```
+     */
+    attestedCompute(walletClient: WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
     /**
      * Get the GRPC endpoint for the covalidator that services this deployment.
      */

package/dist/types/local/local-node.d.ts

@@ -15,7 +15,7 @@ export declare const LocalNodeEnv: Schema.Struct<{
     COVALIDATOR_INCO_EXECUTOR_ADDR: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
     COVALIDATOR_DECRYPTION_HANDLER_ADDR: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
     COVALIDATOR_HOST_CHAIN_ID: Schema.optional<typeof Schema.String>;
-    COVALIDATOR_GRPC_SERVER_ADDRESS: Schema.optional<typeof Schema.String>;
+    COVALIDATOR_URL: Schema.optional<typeof Schema.String>;
     COVALIDATOR_HOST_CHAIN_RPC_URL: Schema.optional<typeof Schema.String>;
 }>;
 export type LocalNodeEnv = typeof LocalNodeEnv.Type;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inco/js",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "repository": "https://github.com/Inco-fhevm/inco-monorepo",
   "sideEffects": false,
   "scripts": {