@inco/js 0.2.17 → 0.3.1

package/dist/types/generated/ts/inco/originchain/v1/query.d.ts

@@ -1,5 +1,5 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { type CallOptions, ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
 import { Params, Report } from "./types";
 export declare const protobufPackage = "inco.originchain.v1";
 /** QueryReportRequest is the request type for the Query/Report RPC method. */
@@ -46,9 +46,9 @@ export declare const QueryService: {
         readonly path: "/inco.originchain.v1.Query/Report";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: QueryReportRequest) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: QueryReportRequest) => Buffer;
         readonly requestDeserialize: (value: Buffer) => QueryReportRequest;
-        readonly responseSerialize: (value: QueryReportResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: QueryReportResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => QueryReportResponse;
     };
     /**
@@ -60,9 +60,9 @@ export declare const QueryService: {
         readonly path: "/inco.originchain.v1.Query/Params";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: QueryParamsRequest) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: QueryParamsRequest) => Buffer;
         readonly requestDeserialize: (value: Buffer) => QueryParamsRequest;
-        readonly responseSerialize: (value: QueryParamsResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: QueryParamsResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => QueryParamsResponse;
     };
 };

package/dist/types/generated/ts/inco/originchain/v1/tx.d.ts

@@ -1,5 +1,5 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { type CallOptions, ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
 import { Params } from "./types";
 export declare const protobufPackage = "inco.originchain.v1";
 /** MsgUpdateParams is the Msg/UpdateParams request type. */
@@ -41,9 +41,9 @@ export declare const MsgService: {
         readonly path: "/inco.originchain.v1.Msg/UpdateParams";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: MsgUpdateParams) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: MsgUpdateParams) => Buffer;
         readonly requestDeserialize: (value: Buffer) => MsgUpdateParams;
-        readonly responseSerialize: (value: MsgUpdateParamsResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: MsgUpdateParamsResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => MsgUpdateParamsResponse;
     };
 };

package/dist/types/generated/ts/inco/preflight/v1/query.d.ts

@@ -1,5 +1,5 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { type CallOptions, ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
 import { InputRegistration, Params } from "./types";
 export declare const protobufPackage = "inco.preflight.v1";
 /** InputRegistrationRequest defines the Query/InputRegistration request type. */
@@ -35,9 +35,9 @@ export declare const QueryService: {
         readonly path: "/inco.preflight.v1.Query/InputRegistration";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: InputRegistrationRequest) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: InputRegistrationRequest) => Buffer;
         readonly requestDeserialize: (value: Buffer) => InputRegistrationRequest;
-        readonly responseSerialize: (value: InputRegistrationResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: InputRegistrationResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => InputRegistrationResponse;
     };
     /** Params returns the parameters of the x/preflight module. */
@@ -45,9 +45,9 @@ export declare const QueryService: {
         readonly path: "/inco.preflight.v1.Query/Params";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: ParamsRequest) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: ParamsRequest) => Buffer;
         readonly requestDeserialize: (value: Buffer) => ParamsRequest;
-        readonly responseSerialize: (value: ParamsResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: ParamsResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => ParamsResponse;
     };
 };

package/dist/types/generated/ts/inco/preflight/v1/tx.d.ts

@@ -1,5 +1,5 @@
 import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { type CallOptions, ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
+import { type CallOptions, type ChannelCredentials, Client, type ClientOptions, type ClientUnaryCall, type handleUnaryCall, type Metadata, type ServiceError, type UntypedServiceImplementation } from "@grpc/grpc-js";
 import { InputContext, Params } from "./types";
 export declare const protobufPackage = "inco.preflight.v1";
 /** MsgRegisterInput the Msg/RegisterInput request type. */
@@ -86,9 +86,9 @@ export declare const MsgService: {
         readonly path: "/inco.preflight.v1.Msg/RegisterInput";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: MsgRegisterInput) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: MsgRegisterInput) => Buffer;
         readonly requestDeserialize: (value: Buffer) => MsgRegisterInput;
-        readonly responseSerialize: (value: MsgRegisterInputResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: MsgRegisterInputResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => MsgRegisterInputResponse;
     };
     /**
@@ -99,9 +99,9 @@ export declare const MsgService: {
         readonly path: "/inco.preflight.v1.Msg/RegisterFallback";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: MsgRegisterFallback) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: MsgRegisterFallback) => Buffer;
         readonly requestDeserialize: (value: Buffer) => MsgRegisterFallback;
-        readonly responseSerialize: (value: MsgRegisterFallbackResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: MsgRegisterFallbackResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => MsgRegisterFallbackResponse;
     };
     /**
@@ -113,9 +113,9 @@ export declare const MsgService: {
         readonly path: "/inco.preflight.v1.Msg/UpdateParams";
         readonly requestStream: false;
         readonly responseStream: false;
-        readonly requestSerialize: (value: MsgUpdateParams) => Buffer<ArrayBuffer>;
+        readonly requestSerialize: (value: MsgUpdateParams) => Buffer;
         readonly requestDeserialize: (value: Buffer) => MsgUpdateParams;
-        readonly responseSerialize: (value: MsgUpdateParamsResponse) => Buffer<ArrayBuffer>;
+        readonly responseSerialize: (value: MsgUpdateParamsResponse) => Buffer;
         readonly responseDeserialize: (value: Buffer) => MsgUpdateParamsResponse;
     };
 };

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

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

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;
@@ -12,7 +14,7 @@ export type DeploymentByName = DistributedPick<Deployment, 'name' | 'chainId'>;
 export type DeploymentByExecutor = DistributedPick<Deployment, 'executorAddress' | 'chainId'>;
 export type DeploymentId = DeploymentByName | DeploymentByExecutor;
 export type Pepper = Deployment['pepper'];
-export type LocalNodePepper = Pepper & keyof typeof localNodeLightningConfig;
+export type LocalNodePepper = keyof typeof localNodeLightningConfig;
 export type ChainId = Deployment['chainId'];
 export type SupportedNativeType = boolean | bigint | number;
 export type EncryptionContext = {
@@ -29,8 +31,10 @@ export type CustomConfig = {
     eciesPublicKey: string;
     chainId: number;
     covalidatorUrl: string;
+    hostChainRpcUrl?: string;
     senderPrivateKey?: HexString;
 };
+export type CustomDeployment = DeploymentSlice & CustomConfig;
 /**
  * The Lightning class provides a convenient way to interact with the Inco Lightning contract by binding to a specific
  * deployment.
@@ -64,7 +68,13 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * corresponding Pepper.
      *
      */
-    static localNode(env?: LocalNodeEnv | LocalNodePepper): Lightning<DeploymentSlice & CustomConfig>;
+    static localNode(env?: LocalNodeEnv | LocalNodePepper): Lightning<CustomDeployment>;
+    /**
+     * Get a Lightning instance bound to a local node from a file containing a LocalNodeEnv environment .
+     *
+     * @param filePath the path to the file containing the environment variables in dotenv format
+     */
+    static localNodeFromEnv(filePath?: string): Promise<Lightning<CustomDeployment>>;
     /**
      * Get a Lightning deployment by name or executor address on a particular chain.
      *
@@ -112,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

@@ -14,6 +14,9 @@ export declare const LocalNodeEnv: Schema.Struct<{
     COVALIDATOR_ACL_ADDR: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
     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_URL: Schema.optional<typeof Schema.String>;
+    COVALIDATOR_HOST_CHAIN_RPC_URL: Schema.optional<typeof Schema.String>;
 }>;
 export type LocalNodeEnv = typeof LocalNodeEnv.Type;
-export declare function parseLocalEnv(envFileContents: string | Buffer): LocalNodeEnv;
+export declare function parseLocalEnv(envFileOrObj?: string | Buffer): LocalNodeEnv;