@inco/js 0.8.0-devnet-2 → 0.8.0-devnet-3

package/dist/types/generated/es/inco/covalidator/compute/v1/server_pb.d.ts

@@ -3,6 +3,7 @@ import type { CryptogramWithProof, InputCryptogram, StoredCryptogram } from "./t
 import type { DecryptionAttestation } from "../../../kms/lite/v1/kms_service_pb";
 import type { ACLProof, SupportedScalarBinaryOp } from "../../../kms/lite/v1/types_pb";
 import type { RATlsServer } from "../../../sealingfetcher/v1/sealingfetcher_pb";
+import type { StartHeliosRequest } from "../../../helioswrapper/v1/helioswrapper_pb";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file inco/covalidator/compute/v1/server.proto.
@@ -567,6 +568,12 @@ export type ConfigureRequest = Message<"inco.covalidator.compute.v1.ConfigureReq
      * @generated from field: repeated inco.sealingfetcher.v1.RATlsServer sealing_providers = 1;
      */
     sealingProviders: RATlsServer[];
+    /**
+     * Provide Helios-specific configuration to start the Helios from compute service.
+     *
+     * @generated from field: inco.helioswrapper.v1.StartHeliosRequest helios_config = 2;
+     */
+    heliosConfig?: StartHeliosRequest;
 };
 /**
  * Describes the message inco.covalidator.compute.v1.ConfigureRequest.
@@ -585,6 +592,12 @@ export type ConfigureResponse = Message<"inco.covalidator.compute.v1.ConfigureRe
      * @generated from field: bool success = 1;
      */
     success: boolean;
+    /**
+     * True if the compute service has successfully started the Helios light client.
+     *
+     * @generated from field: bool helios_started = 2;
+     */
+    heliosStarted: boolean;
 };
 /**
  * Describes the message inco.covalidator.compute.v1.ConfigureResponse.

package/dist/types/generated/es/inco/helioswrapper/v1/helioswrapper_pb.d.ts

@@ -0,0 +1,77 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file inco/helioswrapper/v1/helioswrapper.proto.
+ */
+export declare const file_inco_helioswrapper_v1_helioswrapper: GenFile;
+/**
+ * StartHeliosRequest contains the parameters needed for starting a Helios light client.
+ *
+ * @generated from message inco.helioswrapper.v1.StartHeliosRequest
+ */
+export type StartHeliosRequest = Message<"inco.helioswrapper.v1.StartHeliosRequest"> & {
+    /**
+     * The execution rpc to use. This doesn't need to be a trusted RPC endpoint for integrity, but needs to be one for liveness.
+     *
+     * @generated from field: string execution_rpc = 1;
+     */
+    executionRpc: string;
+    /**
+     * The consensus rpc to use. This doesn't need to be a trusted RPC endpoint for integrity, but needs to be one for liveness. Defaults to Nimbus for sepolia testnet and defaults to "https://www.lightclientdata.org" for mainnet.
+     *
+     * @generated from field: optional string consensus_rpc = 2;
+     */
+    consensusRpc?: string;
+    /**
+     * The latest hex encoded checkpoint. This should be a trusted checkpoint that is no greater than ~2 weeks old.
+     * If you are unsure what checkpoint to use, you can skip this option and set either `load_external_fallback` or `fallback` values (described below) to fetch a checkpoint. Though this is not recommended and less secure.
+     *
+     * @generated from field: optional string checkpoint = 3;
+     */
+    checkpoint?: string;
+    /**
+     * A checkpoint fallback is used if no checkpoint is provided or the given checkpoint is too old.
+     * This is expected to be a trusted checkpoint sync api endpoint.
+     *
+     * @generated from field: optional string fallback = 4;
+     */
+    fallback?: string;
+};
+/**
+ * Describes the message inco.helioswrapper.v1.StartHeliosRequest.
+ * Use `create(StartHeliosRequestSchema)` to create a new message.
+ */
+export declare const StartHeliosRequestSchema: GenMessage<StartHeliosRequest>;
+/**
+ * StartHeliosResponse contains a success flag indicating whether the Helios client was started successfully or not.
+ *
+ * @generated from message inco.helioswrapper.v1.StartHeliosResponse
+ */
+export type StartHeliosResponse = Message<"inco.helioswrapper.v1.StartHeliosResponse"> & {
+    /**
+     * @generated from field: bool success = 1;
+     */
+    success: boolean;
+};
+/**
+ * Describes the message inco.helioswrapper.v1.StartHeliosResponse.
+ * Use `create(StartHeliosResponseSchema)` to create a new message.
+ */
+export declare const StartHeliosResponseSchema: GenMessage<StartHeliosResponse>;
+/**
+ * HeliosWrapperService contains a single method for starting a Helios light client.
+ *
+ * @generated from service inco.helioswrapper.v1.HeliosWrapperService
+ */
+export declare const HeliosWrapperService: GenService<{
+    /**
+     * StartHelios starts the Helios light client with the given url parameters.
+     *
+     * @generated from rpc inco.helioswrapper.v1.HeliosWrapperService.StartHelios
+     */
+    startHelios: {
+        methodKind: "unary";
+        input: typeof StartHeliosRequestSchema;
+        output: typeof StartHeliosResponseSchema;
+    };
+}>;

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

@@ -157,6 +157,33 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * ```
      */
     grantSessionKeyAllowanceVoucher(walletClient: WalletClient<Transport, Chain, Account>, granteeAddress: string, expiresAt: Date, sessionVerifierAddress: string): Promise<AllowanceVoucherWithSig>;
+    /**
+     * Grants a session key allowance voucher using a custom session verifier contract.
+     *
+     * This method creates a signed allowance voucher that authorizes reencryption operations
+     * using a custom session verifier. Unlike `grantSessionKeyAllowanceVoucher`, this method
+     * allows specifying custom `sharerArgData` for use with custom verifier contracts that
+     * require additional authorization parameters.
+     *
+     * @param walletClient - The wallet client used for signing the allowance voucher
+     * @param sessionVerifierAddress - The address of the custom session verifier contract
+     * @param sharerArgData - Custom encoded arguments for the session verifier's `canUseSession` function
+     * @returns A promise that resolves to an AllowanceVoucherWithSig containing the signed allowance voucher
+     *
+     * @example
+     * ```typescript
+     * const sharerArgData = encodeAbiParameters(
+     *   [{ type: 'address' }, { type: 'uint256' }],
+     *   [granteeAddress, expiresAt]
+     * );
+     * const voucher = await lightning.grantCustomSessionKeyAllowanceVoucher(
+     *   walletClient,
+     *   "0x5678...", // custom verifier address
+     *   sharerArgData
+     * );
+     * ```
+     */
+    grantCustomSessionKeyAllowanceVoucher(walletClient: WalletClient<Transport, Chain, Account>, sessionVerifierAddress: string, sharerArgData: HexString): Promise<AllowanceVoucherWithSig>;
     /**
      * Updates the active session nonce for the given wallet client.
      *
@@ -230,9 +257,9 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * );
      * ```
      */
-    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>>>;
+    attestedDecryptWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, handles: HexString[], requesterArgData?: 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, requesterArgData?: HexString, 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, requesterArgData?: HexString, backoffConfig?: Partial<BackoffConfig>): Promise<Array<DecryptionAttestation<EciesScheme, SupportedFheType>>>;
     /**
      * Get an attested compute for the given wallet client.
      *
@@ -323,9 +350,9 @@ export declare class Lightning<T extends DeploymentSlice = DeploymentSlice> {
      * console.log(decrypted.plaintext.value);
      * ```
      */
-    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>>;
+    attestedComputeWithVoucher(ephemeralKeypair: Secp256k1Keypair, allowanceVoucherWithSig: AllowanceVoucherWithSig, ethClient: PublicClient<Transport, Chain> | WalletClient<Transport, Chain, Account>, lhsHandle: HexString, op: AttestedComputeOP, rhsPlaintext: bigint | boolean, requesterArgData?: HexString, 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, requesterArgData?: HexString, 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, requesterArgData?: HexString, backoffConfig?: Partial<BackoffConfig>): Promise<DecryptionAttestation<EciesScheme, SupportedFheType>>;
     /**
      * Get an decryption of publicly revealed handles.
      *

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

@@ -3,13 +3,13 @@ export declare const LocalNodeEnv: Schema.Struct<{
     DEPLOYER_ADDRESS: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
     STATE_DUMP: typeof Schema.String;
     EXECUTOR_ADDRESS: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
-    NETWORK_PUBKEY: Schema.TemplateLiteral<`0x${string}`>;
+    NETWORK_PUBKEY: Schema.optional<Schema.TemplateLiteral<`0x${string}`>>;
     SENDER_ADDRESS: Schema.brand<Schema.filter<Schema.TemplateLiteral<`0x${string}`>>, "Address">;
     SENDER_PRIVATE_KEY: Schema.TemplateLiteral<`0x${string}`>;
     EIP712_SIGNER_ADDRESS: Schema.optional<Schema.TemplateLiteral<`0x${string}`>>;
     PEPPER: typeof Schema.String;
-    COVALIDATOR_NETWORK_PRIVATE_KEY: Schema.TemplateLiteral<`0x${string}`>;
-    COVALIDATOR_EIP712_PRIVATE_SIGNING_KEY: Schema.TemplateLiteral<`0x${string}`>;
+    COVALIDATOR_NETWORK_PRIVATE_KEY: Schema.optional<Schema.TemplateLiteral<`0x${string}`>>;
+    COVALIDATOR_EIP712_PRIVATE_SIGNING_KEY: Schema.optional<Schema.TemplateLiteral<`0x${string}`>>;
     COVALIDATOR_INCO_EXECUTOR_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>;

package/package.json

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