@inco/js 0.3.0 → 0.3.1

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

@@ -1,10 +1,12 @@
 import { Account, Chain, Transport, WalletClient } from 'viem';
+import { AllowanceVoucherWithSig } from '../advancedacl/types.js';
 import { Address, HexString } from '../binary.js';
-import { EciesScheme } from '../encryption/index.js';
+import { EciesScheme, PlaintextOf } 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 { 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 +122,58 @@ 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 import("../encryption/encryption.js").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 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.1",
   "repository": "https://github.com/Inco-fhevm/inco-monorepo",
   "sideEffects": false,
   "scripts": {