@inco/js 0.1.9

package/dist/generated/es/inco/fhe/v1/types_pb.d.ts

@@ -0,0 +1,419 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file inco/fhe/v1/types.proto.
+ */
+export declare const file_inco_fhe_v1_types: GenFile;
+/**
+ * TypedCiphertext represents a ciphertext with its type and handle.
+ * This type is inspired from Zama's TypedCiphertext:
+ * ref: https://github.com/zama-ai/kms-core/blob/fcc54ba0933e6190d8e8091ef495bcf437c06f6a/core/grpc/proto/kms.v1.proto#L180-L187
+ *
+ * The encryption and format of the encrypted plaintext must be specified at the site of its use.
+ *
+ * @generated from message inco.fhe.v1.TypedCiphertext
+ */
+export type TypedCiphertext = Message<"inco.fhe.v1.TypedCiphertext"> & {
+    /**
+     * The actual ciphertext to decrypt, taken directly from the fhevm.
+     *
+     * @generated from field: bytes ciphertext = 1;
+     */
+    ciphertext: Uint8Array;
+    /**
+     * The type of plaintext encrypted.
+     *
+     * @generated from field: inco.fhe.v1.FheType fhe_type = 2;
+     */
+    fheType: FheType;
+    /**
+     * The handle of the ciphertext.
+     * TODO scalar declaration.
+     *
+     * @generated from field: string handle = 3;
+     */
+    handle: string;
+};
+/**
+ * Describes the message inco.fhe.v1.TypedCiphertext.
+ * Use `create(TypedCiphertextSchema)` to create a new message.
+ */
+export declare const TypedCiphertextSchema: GenMessage<TypedCiphertext>;
+/**
+ * Covalidator represents a covalidator that can vote on the CA Root.
+ *
+ * @generated from message inco.fhe.v1.Covalidator
+ */
+export type Covalidator = Message<"inco.fhe.v1.Covalidator"> & {
+    /**
+     * inco_address is the Cosmos bech32 address of the covalidator.
+     *
+     * @generated from field: string inco_address = 1;
+     */
+    incoAddress: string;
+    /**
+     * grpc_url is the gRPC endpoint of the covalidator, in the format
+     * "host:port".
+     *
+     * @generated from field: string grpc_url = 2;
+     */
+    grpcUrl: string;
+};
+/**
+ * Describes the message inco.fhe.v1.Covalidator.
+ * Use `create(CovalidatorSchema)` to create a new message.
+ */
+export declare const CovalidatorSchema: GenMessage<Covalidator>;
+/**
+ * KeysetInfo represents information on how to retrieve the keyset from the KMS.
+ *
+ * @generated from message inco.fhe.v1.KeysetInfo
+ */
+export type KeysetInfo = Message<"inco.fhe.v1.KeysetInfo"> & {
+    /**
+     * id is the unique identifier of the keyset. It is a 20-byte hash
+     * represented as a hex string with no prefix.
+     * More specification of the keyset ID can be found in Zama's
+     * documentation:
+     * https://github.com/zama-ai/kms-core/blob/v0.9.0-rc3/config/dev/README.md#kms-key-id
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * kms_grpc_url is the gRPC endpoint of the KMS that manages the keyset, in
+     * the format "host:port". They keyset can be retrieved via the
+     * inco.kms.*.v1.KmsService#Key RPC method.
+     *
+     * @generated from field: string kms_grpc_url = 2;
+     */
+    kmsGrpcUrl: string;
+};
+/**
+ * Describes the message inco.fhe.v1.KeysetInfo.
+ * Use `create(KeysetInfoSchema)` to create a new message.
+ */
+export declare const KeysetInfoSchema: GenMessage<KeysetInfo>;
+/**
+ * FheEnv represents the environment in which the FHE keys are used, which is
+ * composed of a host chain and a keyset.
+ *
+ * @generated from message inco.fhe.v1.FheEnv
+ */
+export type FheEnv = Message<"inco.fhe.v1.FheEnv"> & {
+    /**
+     * host_chain_id is the chain ID of the host chain. See the x/hostchain module
+     * for a specification of the chain ID.
+     *
+     * @generated from field: string host_chain_id = 1;
+     */
+    hostChainId: string;
+    /**
+     * keyset_id is the unique identifier of the keyset.
+     *
+     * @generated from field: string keyset_id = 2;
+     */
+    keysetId: string;
+    /**
+     * authorization is the authorization configuration for the FHE environment.
+     *
+     * @generated from oneof inco.fhe.v1.FheEnv.authorization
+     */
+    authorization: {
+        /**
+         * zama_access_control is the access control configuration for Zama's ACL.
+         *
+         * @generated from field: inco.fhe.v1.ZamaAccessControl zama_access_control = 10;
+         */
+        value: ZamaAccessControl;
+        case: "zamaAccessControl";
+    } | {
+        /**
+         * inco_lite_access_control is the access control configuration for IncoLite.
+         *
+         * @generated from field: inco.fhe.v1.IncoLiteAccessControl inco_lite_access_control = 11;
+         */
+        value: IncoLiteAccessControl;
+        case: "incoLiteAccessControl";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message inco.fhe.v1.FheEnv.
+ * Use `create(FheEnvSchema)` to create a new message.
+ */
+export declare const FheEnvSchema: GenMessage<FheEnv>;
+/**
+ * ZamaAccessControl represents the access control configuration used by Zama.
+ * It is characterized by having separate storage slots for decryption,
+ * reencryption, and delegated reencryption.
+ *
+ * @generated from message inco.fhe.v1.ZamaAccessControl
+ */
+export type ZamaAccessControl = Message<"inco.fhe.v1.ZamaAccessControl"> & {
+    /**
+     * acl_address is the host chain address of the ACL contract to use for
+     * verifying the ACL proof. For EVM chains it's a non-prefixed hex string.
+     *
+     * @generated from field: string acl_address = 1;
+     */
+    aclAddress: string;
+    /**
+     * decryption_storage_index is the storage slot of the ACL contract to use for
+     * verifying decyrption. It is usually called `allowedForDecryption` in the
+     * ACL.sol contract. It is encoded as a non-prefixed hex string.
+     *
+     * The Solidity type at this storage is expected to be:
+     * mapping(uint256 => bool)
+     *
+     * @generated from field: string decryption_storage_index = 2;
+     */
+    decryptionStorageIndex: string;
+    /**
+     * reencryption_storage_index is the storage slot of the ACL contract to use
+     * for verifying reencryption. It is usually called `persistedAllowedPairs`
+     * in the ACL.sol contract. It is encoded as a non-prefixed hex string.
+     *
+     * The Solidity type at this storage is expected to be:
+     * mapping(uint256 handle => mapping(address account => bool isAllowed))
+     *
+     * @generated from field: string reencryption_storage_index = 3;
+     */
+    reencryptionStorageIndex: string;
+    /**
+     * delegations_storage slot is the storage slot of the ACL contract to use
+     * for verifying reencryptions using delegations. It is usually called
+     * `delegates` in the ACL.sol contract. It is encoded as a non-prefixed hex
+     * string.
+     *
+     * The Solidity type at this storage is expected to be:
+     * mapping(address account => mapping(address delegatee => mapping(address
+     * contractAddress => bool isDelegate)))
+     *
+     * @generated from field: string delegations_storage_index = 4;
+     */
+    delegationsStorageIndex: string;
+};
+/**
+ * Describes the message inco.fhe.v1.ZamaAccessControl.
+ * Use `create(ZamaAccessControlSchema)` to create a new message.
+ */
+export declare const ZamaAccessControlSchema: GenMessage<ZamaAccessControl>;
+/**
+ * IncoLiteAccessControl represents the access control configuration used by
+ * IncoLite, which is empty.
+ *
+ * @generated from message inco.fhe.v1.IncoLiteAccessControl
+ */
+export type IncoLiteAccessControl = Message<"inco.fhe.v1.IncoLiteAccessControl"> & {};
+/**
+ * Describes the message inco.fhe.v1.IncoLiteAccessControl.
+ * Use `create(IncoLiteAccessControlSchema)` to create a new message.
+ */
+export declare const IncoLiteAccessControlSchema: GenMessage<IncoLiteAccessControl>;
+/**
+ * CARoot represents the CA Root that is voted on by the covalidators.
+ *
+ * @generated from message inco.fhe.v1.CARoot
+ */
+export type CARoot = Message<"inco.fhe.v1.CARoot"> & {
+    /**
+     * hash is the CA Root hash that was voted on.
+     *
+     * @generated from field: bytes hash = 1;
+     */
+    hash: Uint8Array;
+};
+/**
+ * Describes the message inco.fhe.v1.CARoot.
+ * Use `create(CARootSchema)` to create a new message.
+ */
+export declare const CARootSchema: GenMessage<CARoot>;
+/**
+ * FheEnvBlock represents a specific host chain block in a specific FHE environment.
+ *
+ * @generated from message inco.fhe.v1.FheEnvBlock
+ */
+export type FheEnvBlock = Message<"inco.fhe.v1.FheEnvBlock"> & {
+    /**
+     * host_chain_id is the chain ID of the host chain. See the x/hostchain module
+     * for a specification of the chain ID.
+     *
+     * @generated from field: string host_chain_id = 1;
+     */
+    hostChainId: string;
+    /**
+     * keyset_id is the unique identifier of the keyset.
+     *
+     * @generated from field: string keyset_id = 2;
+     */
+    keysetId: string;
+    /**
+     * block_hash is the block hash of the host chain.
+     * The hash is 0x-prefixed hex bytes.
+     * TODO scalar declaration.
+     *
+     * @generated from field: string block_hash = 3;
+     */
+    blockHash: string;
+    /**
+     * block_height is the block height of the block.
+     *
+     * @generated from field: uint64 block_height = 4;
+     */
+    blockHeight: bigint;
+};
+/**
+ * Describes the message inco.fhe.v1.FheEnvBlock.
+ * Use `create(FheEnvBlockSchema)` to create a new message.
+ */
+export declare const FheEnvBlockSchema: GenMessage<FheEnvBlock>;
+/**
+ * BlockTopo represents the topology information for a host chain block.
+ *
+ * @generated from message inco.fhe.v1.BlockTopo
+ */
+export type BlockTopo = Message<"inco.fhe.v1.BlockTopo"> & {
+    /**
+     * parent_hash is the block hash of this block's parent, or empty if unknown.
+     * If present, the parent block's height must be height-1.
+     * The hash is 0x-prefixed hex bytes.
+     * TODO scalar declaration.
+     *
+     * @generated from field: string parent_hash = 1;
+     */
+    parentHash: string;
+};
+/**
+ * Describes the message inco.fhe.v1.BlockTopo.
+ * Use `create(BlockTopoSchema)` to create a new message.
+ */
+export declare const BlockTopoSchema: GenMessage<BlockTopo>;
+/**
+ * BlockTopoStore represents the topology information for a host chain block,
+ * optimized for storage.
+ *
+ * @generated from message inco.fhe.v1.BlockTopoStore
+ */
+export type BlockTopoStore = Message<"inco.fhe.v1.BlockTopoStore"> & {
+    /**
+     * parent_hash is the block hash of this block's parent, or empty if unknown.
+     * If present, the parent block's height must be height-1.
+     *
+     * @generated from field: bytes parent_hash = 1;
+     */
+    parentHash: Uint8Array;
+};
+/**
+ * Describes the message inco.fhe.v1.BlockTopoStore.
+ * Use `create(BlockTopoStoreSchema)` to create a new message.
+ */
+export declare const BlockTopoStoreSchema: GenMessage<BlockTopoStore>;
+/**
+ * HandleBinding is the information bound to a ciphertext handle through covalidator consensus.
+ *
+ * @generated from message inco.fhe.v1.HandleBinding
+ */
+export type HandleBinding = Message<"inco.fhe.v1.HandleBinding"> & {
+    /**
+     * ciphertext_hash is the TODO-Algorithm-TODO hash of the ciphertext.
+     *
+     * @generated from field: bytes ciphertext_hash = 1;
+     */
+    ciphertextHash: Uint8Array;
+};
+/**
+ * Describes the message inco.fhe.v1.HandleBinding.
+ * Use `create(HandleBindingSchema)` to create a new message.
+ */
+export declare const HandleBindingSchema: GenMessage<HandleBinding>;
+/**
+ * HandleBindingEntry is a handle together with its HandleBinding.
+ *
+ * @generated from message inco.fhe.v1.HandleBindingEntry
+ */
+export type HandleBindingEntry = Message<"inco.fhe.v1.HandleBindingEntry"> & {
+    /**
+     * handle is the ciphertext handle for this entry.
+     * The handle is 0x-prefixed hex bytes.
+     * TODO scalar declaration.
+     *
+     * @generated from field: string handle = 1;
+     */
+    handle: string;
+    /**
+     * binding is the HandleBinding for the handle.
+     *
+     * @generated from field: inco.fhe.v1.HandleBinding binding = 2;
+     */
+    binding?: HandleBinding;
+};
+/**
+ * Describes the message inco.fhe.v1.HandleBindingEntry.
+ * Use `create(HandleBindingEntrySchema)` to create a new message.
+ */
+export declare const HandleBindingEntrySchema: GenMessage<HandleBindingEntry>;
+/**
+ * FheType represents the type of the plaintext encrypted in either in the FHE
+ * or the TEE ciphertext.
+ * For compatibility with Zama's FheType, we use the same values.
+ * ref: https://github.com/zama-ai/kms-core/blob/fcc54ba0933e6190d8e8091ef495bcf437c06f6a/core/grpc/proto/kms.v1.proto#L32
+ *
+ * @generated from enum inco.fhe.v1.FheType
+ */
+export declare enum FheType {
+    /**
+     * @generated from enum value: FHE_TYPE_EBOOL = 0;
+     */
+    EBOOL = 0,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT4 = 1;
+     */
+    EUINT4 = 1,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT8 = 2;
+     */
+    EUINT8 = 2,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT16 = 3;
+     */
+    EUINT16 = 3,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT32 = 4;
+     */
+    EUINT32 = 4,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT64 = 5;
+     */
+    EUINT64 = 5,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT128 = 6;
+     */
+    EUINT128 = 6,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT160 = 7;
+     */
+    EUINT160 = 7,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT256 = 8;
+     */
+    EUINT256 = 8,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT512 = 9;
+     */
+    EUINT512 = 9,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT1024 = 10;
+     */
+    EUINT1024 = 10,
+    /**
+     * @generated from enum value: FHE_TYPE_EUINT2048 = 11;
+     */
+    EUINT2048 = 11
+}
+/**
+ * Describes the enum inco.fhe.v1.FheType.
+ */
+export declare const FheTypeSchema: GenEnum<FheType>;

package/dist/generated/es/inco/kms/lite/v1/kms_service_pb.d.ts

@@ -0,0 +1,181 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { TypedCiphertext } from "../../../fhe/v1/types_pb";
+import type { ECIESKeyset, HandleWithProof } from "./types_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file inco/kms/lite/v1/kms_service.proto.
+ */
+export declare const file_inco_kms_lite_v1_kms_service: GenFile;
+/**
+ * KeyRequest is the request type for the KmsService/Keys RPC method.
+ *
+ * @generated from message inco.kms.lite.v1.KeyRequest
+ */
+export type KeyRequest = Message<"inco.kms.lite.v1.KeyRequest"> & {};
+/**
+ * Describes the message inco.kms.lite.v1.KeyRequest.
+ * Use `create(KeyRequestSchema)` to create a new message.
+ */
+export declare const KeyRequestSchema: GenMessage<KeyRequest>;
+/**
+ * KeyResponse is the response type for the KmsService/Keys RPC method.
+ *
+ * @generated from message inco.kms.lite.v1.KeyResponse
+ */
+export type KeyResponse = Message<"inco.kms.lite.v1.KeyResponse"> & {
+    /**
+     * keyset is the keyset for the IncoLite KMS.
+     *
+     * @generated from field: inco.kms.lite.v1.ECIESKeyset keyset = 1;
+     */
+    keyset?: ECIESKeyset;
+    /**
+     * signing_address is the Ethereum EOA signing address of the KMS, encoded
+     * as a 0x-prefixed hex string.
+     * TODO scalar annotation.
+     *
+     * @generated from field: string signing_address = 2;
+     */
+    signingAddress: string;
+};
+/**
+ * Describes the message inco.kms.lite.v1.KeyResponse.
+ * Use `create(KeyResponseSchema)` to create a new message.
+ */
+export declare const KeyResponseSchema: GenMessage<KeyResponse>;
+/**
+ * ReencryptRequest is the request type for the KmsService/Reencrypt RPC method.
+ *
+ * @generated from message inco.kms.lite.v1.ReencryptRequest
+ */
+export type ReencryptRequest = Message<"inco.kms.lite.v1.ReencryptRequest"> & {
+    /**
+     * user_address is the Ethereum address of the user who requested the
+     * reencryption, prefixed with 0x.
+     *
+     * @generated from field: string user_address = 1;
+     */
+    userAddress: string;
+    /**
+     * ephemeral_pub_key is the encoding of the user's public ephemeral
+     * encryption key (secp256k1), generated by the user for this reencryption
+     * request. It is encoded in its 33-byte compressed format.
+     *
+     * @generated from field: bytes ephemeral_pub_key = 2;
+     */
+    ephemeralPubKey: Uint8Array;
+    /**
+     * eip712_signature is an EIP-712 signature of the following EIP-712 typed data by
+     * `user_address` (note that we only give a JSON representation for the sake of
+     * readability, but the actual signed data is defined in the EIP-712 spec):
+     *
+     * ```json
+     * {
+     *   "types": {
+     *     "EIP712Domain": [
+     *       { "name": "name", "type": "string" },
+     *       { "name": "version", "type": "string" },
+     *       { "name": "chainId", "type": "uint256" }
+     *     ],
+     *     "ReencryptionRequest": [
+     *       { "name": "publicKey", "type": "bytes" }
+     *     ]
+     *   },
+     *   "primaryType": "ReencryptionRequest",
+     *   "domain": {
+     *     "name": "IncoReencryption",
+     *     "version": "0.1.0",
+     *     "chainId": "<host_chain_id>",
+     *     "verifyingContract": "<acl_address>",
+     *     "salt": "0x0000000000000000000000000000000000000000000000000000000000000000"
+     *   },
+     *   "message": {
+     *     "publicKey": "<ephemeral_pub_key>"
+     *   }
+     * }
+     * ```
+     *
+     * @generated from field: bytes eip712_signature = 3;
+     */
+    eip712Signature: Uint8Array;
+    /**
+     * handles_with_proofs is the list of handles of the ciphertexts to reencrypt,
+     * along with the ACL proof that the user has access to the ciphertext.
+     *
+     * @generated from field: repeated inco.kms.lite.v1.HandleWithProof handles_with_proofs = 4;
+     */
+    handlesWithProofs: HandleWithProof[];
+};
+/**
+ * Describes the message inco.kms.lite.v1.ReencryptRequest.
+ * Use `create(ReencryptRequestSchema)` to create a new message.
+ */
+export declare const ReencryptRequestSchema: GenMessage<ReencryptRequest>;
+/**
+ * ReencryptResponse is the response type for the KmsService/Reencrypt RPC method.
+ *
+ * @generated from message inco.kms.lite.v1.ReencryptResponse
+ */
+export type ReencryptResponse = Message<"inco.kms.lite.v1.ReencryptResponse"> & {
+    /**
+     * payload is the reencryption response payload.
+     *
+     * @generated from field: inco.kms.lite.v1.ReencryptionResponsePayload payload = 1;
+     */
+    payload?: ReencryptionResponsePayload;
+};
+/**
+ * Describes the message inco.kms.lite.v1.ReencryptResponse.
+ * Use `create(ReencryptResponseSchema)` to create a new message.
+ */
+export declare const ReencryptResponseSchema: GenMessage<ReencryptResponse>;
+/**
+ * ReencryptionResponsePayload is the payload of the ReencryptResponse,
+ * separated out because it is signed by the KMS using its signing key.
+ *
+ * @generated from message inco.kms.lite.v1.ReencryptionResponsePayload
+ */
+export type ReencryptionResponsePayload = Message<"inco.kms.lite.v1.ReencryptionResponsePayload"> & {
+    /**
+     * user_ciphertexts is the list of ciphertexts that were reencrypted to the
+     * user's public key. Each ciphertext at index `i` corresponds to the ciphertext
+     * at index `i` in the `ReencryptRequest`.
+     *
+     * @generated from field: repeated inco.fhe.v1.TypedCiphertext user_ciphertexts = 1;
+     */
+    userCiphertexts: TypedCiphertext[];
+};
+/**
+ * Describes the message inco.kms.lite.v1.ReencryptionResponsePayload.
+ * Use `create(ReencryptionResponsePayloadSchema)` to create a new message.
+ */
+export declare const ReencryptionResponsePayloadSchema: GenMessage<ReencryptionResponsePayload>;
+/**
+ * KmsService is the service for the IncoLite KMS, which will run
+ * inside the TEE.
+ *
+ * @generated from service inco.kms.lite.v1.KmsService
+ */
+export declare const KmsService: GenService<{
+    /**
+     * Key returns the public keys exposed by the KMS.
+     *
+     * @generated from rpc inco.kms.lite.v1.KmsService.Key
+     */
+    key: {
+        methodKind: "unary";
+        input: typeof KeyRequestSchema;
+        output: typeof KeyResponseSchema;
+    };
+    /**
+     * Reencrypt reencrypts a ciphertext using the ephemeral public key of the
+     * user.
+     *
+     * @generated from rpc inco.kms.lite.v1.KmsService.Reencrypt
+     */
+    reencrypt: {
+        methodKind: "unary";
+        input: typeof ReencryptRequestSchema;
+        output: typeof ReencryptResponseSchema;
+    };
+}>;