@inco/lightning-js 0.0.0-bootstrap.0

package/dist/cjs/generated/local-node.d.ts

@@ -0,0 +1,50 @@
+export declare const localNodeLightningConfig: {
+    readonly mainnet: {
+        readonly executorAddress: "0x4b9911b0191B0b6a6eA8F2Ed562e20Cff5AC8624";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0xDD166476574D64D54A8d65810478007eDccc1d1d"];
+        readonly hostChainRpcUrls: readonly ["http://localhost:8545"];
+        readonly senderPrivateKey: "0x7f2a092a3ecab2e11400fc235b8d3d6b76fb7ec14c71b64baf5a6885a36c1b3a";
+    };
+    readonly demonet: {
+        readonly executorAddress: "0xad9Af2e804FbF14d69391167F1FCDf918A3980fb";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0x9cDbDc8E83F84B9D6d3c19356B8C590f0CE1F549"];
+        readonly hostChainRpcUrls: readonly ["http://localhost:8545"];
+        readonly senderPrivateKey: "0x8e6681c7870f0adc53511b6f38515a5b0f4e3a3fa62a62505f58c61e64c92497";
+    };
+    readonly testnet: {
+        readonly executorAddress: "0xe9CB49A5b16C6D4a093E5900AA8b450FD40541B6";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0x8A853ACC000D50bfb59e1D04635959957e28Db38"];
+        readonly hostChainRpcUrls: readonly ["http://localhost:8545"];
+        readonly senderPrivateKey: "0x835c46722a63e5132eaf24d0a1dad8689d43b85bdcc0e592c23e55fa603895d7";
+    };
+    readonly devnet: {
+        readonly executorAddress: "0xB3C06f0Ed967a7E366ba31C67927DDf93d7c1154";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0x29C5a8C17d8c0A2B2036365EA6908291A35dDadF"];
+        readonly hostChainRpcUrls: readonly ["http://localhost:8545"];
+        readonly senderPrivateKey: "0xbea2b6c911de6a581e7e5fab9da94edbb00c5ddba7ab1645c100b012997c842e";
+    };
+    readonly alphanet: {
+        readonly executorAddress: "0xc0d693DeEF0A91CE39208676b6da09B822abd199";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0x8E873085348a3406A07907E5d1465B9824bA07cd"];
+        readonly hostChainRpcUrls: readonly ["http://localhost:8545"];
+        readonly senderPrivateKey: "0x279c172cf3638a79642daa5f7666c600befde318550d7579cf96280920e318b6";
+    };
+    readonly scratch: {
+        readonly executorAddress: "0xb390b23b8fa1761a85035E7C135bf93713d1d4d1";
+        readonly chainId: 31337;
+        readonly covalidatorUrls: readonly ["http://localhost:50055"];
+        readonly signers: readonly ["0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"];
+        readonly hostChainRpcUrls: readonly ["http://127.0.0.1:8567"];
+        readonly senderPrivateKey: "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+    };
+};

package/dist/cjs/generated/local-node.js

@@ -0,0 +1,107 @@
+"use strict";
+// ============================================================================
+// WARNING: LOCAL DEVELOPMENT ONLY - DO NOT USE IN PRODUCTION
+// ============================================================================
+//
+// This file contains TEST KEYS that are publicly known and have no value.
+//
+// SECURITY NOTICE: All URLs in this configuration use HTTP (unencrypted).
+// This is acceptable ONLY for localhost connections where traffic never
+// leaves the local machine.
+//
+// DO NOT modify these URLs to point to non-localhost addresses without
+// switching to HTTPS. Using HTTP with remote hosts exposes sensitive data
+// (including private keys and transaction data) to network interception.
+//
+// For production or any non-local environment, use the appropriate
+// network configuration files which enforce HTTPS for all remote connections.
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localNodeLightningConfig = void 0;
+exports.localNodeLightningConfig = {
+    "mainnet": {
+        "executorAddress": "0x4b9911b0191B0b6a6eA8F2Ed562e20Cff5AC8624",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0xDD166476574D64D54A8d65810478007eDccc1d1d"
+        ],
+        "hostChainRpcUrls": [
+            "http://localhost:8545"
+        ],
+        "senderPrivateKey": "0x7f2a092a3ecab2e11400fc235b8d3d6b76fb7ec14c71b64baf5a6885a36c1b3a"
+    },
+    "demonet": {
+        "executorAddress": "0xad9Af2e804FbF14d69391167F1FCDf918A3980fb",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0x9cDbDc8E83F84B9D6d3c19356B8C590f0CE1F549"
+        ],
+        "hostChainRpcUrls": [
+            "http://localhost:8545"
+        ],
+        "senderPrivateKey": "0x8e6681c7870f0adc53511b6f38515a5b0f4e3a3fa62a62505f58c61e64c92497"
+    },
+    "testnet": {
+        "executorAddress": "0xe9CB49A5b16C6D4a093E5900AA8b450FD40541B6",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0x8A853ACC000D50bfb59e1D04635959957e28Db38"
+        ],
+        "hostChainRpcUrls": [
+            "http://localhost:8545"
+        ],
+        "senderPrivateKey": "0x835c46722a63e5132eaf24d0a1dad8689d43b85bdcc0e592c23e55fa603895d7"
+    },
+    "devnet": {
+        "executorAddress": "0xB3C06f0Ed967a7E366ba31C67927DDf93d7c1154",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0x29C5a8C17d8c0A2B2036365EA6908291A35dDadF"
+        ],
+        "hostChainRpcUrls": [
+            "http://localhost:8545"
+        ],
+        "senderPrivateKey": "0xbea2b6c911de6a581e7e5fab9da94edbb00c5ddba7ab1645c100b012997c842e"
+    },
+    "alphanet": {
+        "executorAddress": "0xc0d693DeEF0A91CE39208676b6da09B822abd199",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0x8E873085348a3406A07907E5d1465B9824bA07cd"
+        ],
+        "hostChainRpcUrls": [
+            "http://localhost:8545"
+        ],
+        "senderPrivateKey": "0x279c172cf3638a79642daa5f7666c600befde318550d7579cf96280920e318b6"
+    },
+    "scratch": {
+        "executorAddress": "0xb390b23b8fa1761a85035E7C135bf93713d1d4d1",
+        "chainId": 31337,
+        "covalidatorUrls": [
+            "http://localhost:50055"
+        ],
+        "signers": [
+            "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
+        ],
+        "hostChainRpcUrls": [
+            "http://127.0.0.1:8567"
+        ],
+        "senderPrivateKey": "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9jYWwtbm9kZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9nZW5lcmF0ZWQvbG9jYWwtbm9kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsK0VBQStFO0FBQy9FLDZEQUE2RDtBQUM3RCwrRUFBK0U7QUFDL0UsRUFBRTtBQUNGLDBFQUEwRTtBQUMxRSxFQUFFO0FBQ0YsMEVBQTBFO0FBQzFFLHdFQUF3RTtBQUN4RSw0QkFBNEI7QUFDNUIsRUFBRTtBQUNGLHVFQUF1RTtBQUN2RSwwRUFBMEU7QUFDMUUseUVBQXlFO0FBQ3pFLEVBQUU7QUFDRixtRUFBbUU7QUFDbkUsOEVBQThFO0FBQzlFLCtFQUErRTs7O0FBRWxFLFFBQUEsd0JBQXdCLEdBQUc7SUFDdEMsU0FBUyxFQUFFO1FBQ1QsaUJBQWlCLEVBQUUsNENBQTRDO1FBQy9ELFNBQVMsRUFBRSxLQUFLO1FBQ2hCLGlCQUFpQixFQUFFO1lBQ2pCLHdCQUF3QjtTQUN6QjtRQUNELFNBQVMsRUFBRTtZQUNULDRDQUE0QztTQUM3QztRQUNELGtCQUFrQixFQUFFO1lBQ2xCLHVCQUF1QjtTQUN4QjtRQUNELGtCQUFrQixFQUFFLG9FQUFvRTtLQUN6RjtJQUNELFNBQVMsRUFBRTtRQUNULGlCQUFpQixFQUFFLDRDQUE0QztRQUMvRCxTQUFTLEVBQUUsS0FBSztRQUNoQixpQkFBaUIsRUFBRTtZQUNqQix3QkFBd0I7U0FDekI7UUFDRCxTQUFTLEVBQUU7WUFDVCw0Q0FBNEM7U0FDN0M7UUFDRCxrQkFBa0IsRUFBRTtZQUNsQix1QkFBdUI7U0FDeEI7UUFDRCxrQkFBa0IsRUFBRSxvRUFBb0U7S0FDekY7SUFDRCxTQUFTLEVBQUU7UUFDVCxpQkFBaUIsRUFBRSw0Q0FBNEM7UUFDL0QsU0FBUyxFQUFFLEtBQUs7UUFDaEIsaUJBQWlCLEVBQUU7WUFDakIsd0JBQXdCO1NBQ3pCO1FBQ0QsU0FBUyxFQUFFO1lBQ1QsNENBQTRDO1NBQzdDO1FBQ0Qsa0JBQWtCLEVBQUU7WUFDbEIsdUJBQXVCO1NBQ3hCO1FBQ0Qsa0JBQWtCLEVBQUUsb0VBQW9FO0tBQ3pGO0lBQ0QsUUFBUSxFQUFFO1FBQ1IsaUJBQWlCLEVBQUUsNENBQTRDO1FBQy9ELFNBQVMsRUFBRSxLQUFLO1FBQ2hCLGlCQUFpQixFQUFFO1lBQ2pCLHdCQUF3QjtTQUN6QjtRQUNELFNBQVMsRUFBRTtZQUNULDRDQUE0QztTQUM3QztRQUNELGtCQUFrQixFQUFFO1lBQ2xCLHVCQUF1QjtTQUN4QjtRQUNELGtCQUFrQixFQUFFLG9FQUFvRTtLQUN6RjtJQUNELFVBQVUsRUFBRTtRQUNWLGlCQUFpQixFQUFFLDRDQUE0QztRQUMvRCxTQUFTLEVBQUUsS0FBSztRQUNoQixpQkFBaUIsRUFBRTtZQUNqQix3QkFBd0I7U0FDekI7UUFDRCxTQUFTLEVBQUU7WUFDVCw0Q0FBNEM7U0FDN0M7UUFDRCxrQkFBa0IsRUFBRTtZQUNsQix1QkFBdUI7U0FDeEI7UUFDRCxrQkFBa0IsRUFBRSxvRUFBb0U7S0FDekY7SUFDRCxTQUFTLEVBQUU7UUFDVCxpQkFBaUIsRUFBRSw0Q0FBNEM7UUFDL0QsU0FBUyxFQUFFLEtBQUs7UUFDaEIsaUJBQWlCLEVBQUU7WUFDakIsd0JBQXdCO1NBQ3pCO1FBQ0QsU0FBUyxFQUFFO1lBQ1QsNENBQTRDO1NBQzdDO1FBQ0Qsa0JBQWtCLEVBQUU7WUFDbEIsdUJBQXVCO1NBQ3hCO1FBQ0Qsa0JBQWtCLEVBQUUsb0VBQW9FO0tBQ3pGO0NBQ08sQ0FBQyJ9

package/dist/cjs/handle.d.ts

@@ -0,0 +1,123 @@
+import { Schema } from 'effect';
+import { HexString } from './binary.js';
+/** Current handle version byte, appended as the last byte of every handle. */
+export declare const HANDLE_VERSION = 0;
+/**
+ * Domain separators for handle derivation. Must be kept in sync with Solidity
+ * (contracts/lightning/src/Types.sol) and Go (pkg/hostchain/handle.go). Prefixing every
+ * keccak256 preimage with a unique constant string makes cross-derivation-path
+ * collision resistance structural rather than incidental.
+ */
+export declare const SEP_INPUT_HANDLE = "inco/handle/input-handle";
+export declare const SEP_INPUT_CONTEXT = "inco/handle/input-context";
+export declare const SEP_OP_RESULT = "inco/handle/op-result";
+export declare const SEP_ELIST_OP_RESULT = "inco/handle/elist-result";
+export declare const BYTE_ELIST_ELEMENT_TYPE_INDEX = 29;
+/**
+ * Map of ENCRYPTION type names to their integer identifiers.
+ *
+ * Keys provide a semantic interpretation over the underlying integral type.
+ * For example, `ebool` interprets a `uint16` as a boolean, `ebytes64` interprets
+ * a `uint512` as a 64-byte array, etc.
+ */
+export declare const handleTypes: Readonly<{
+    ebool: 0;
+    euint4: 1;
+    euint8: 2;
+    euint16: 3;
+    euint32: 4;
+    euint64: 5;
+    euint128: 6;
+    euint160: 7;
+    euint256: 8;
+    ebytes64: 9;
+    ebytes128: 10;
+    ebytes256: 11;
+}>;
+/** Schema that validates a string is one of the known ENCRYPTION type names (e.g. `"ebool"`, `"euint256"`). */
+export declare const HandleTypeName: Schema.SchemaClass<"ebool" | "euint4" | "euint8" | "euint16" | "euint32" | "euint64" | "euint128" | "euint160" | "euint256" | "ebytes64" | "ebytes128" | "ebytes256", "ebool" | "euint4" | "euint8" | "euint16" | "euint32" | "euint64" | "euint128" | "euint160" | "euint256" | "ebytes64" | "ebytes128" | "ebytes256", never>;
+/** A valid ENCRYPTION type name string (e.g. `"ebool"`, `"euint32"`, `"ebytes64"`). */
+export type HandleTypeName = typeof HandleTypeName.Type;
+/** The typeof {@link handleTypes} — mapping from ENCRYPTION type names to integer IDs. */
+export type HandleTypes = typeof handleTypes;
+/** Integer identifier of an ENCRYPTION type (0–11), corresponding to a {@link HandleTypeName}. */
+export type TeeType = HandleTypes[keyof HandleTypes];
+/**
+ * Type guard that checks whether a number is a valid {@link TeeType} identifier.
+ * @param value - The number to check.
+ * @returns `true` if `value` is a known ENCRYPTION type integer (0–11).
+ */
+export declare function isTeeType(value: number): value is TeeType;
+/** Schema for the context required to compute a deterministic ENCRYPTION handle. */
+export declare const InputContext: Schema.Struct<{
+    hostChainId: typeof Schema.BigInt;
+    aclAddress: Schema.TemplateLiteral<`0x${string}`>;
+    userAddress: Schema.TemplateLiteral<`0x${string}`>;
+    contractAddress: Schema.TemplateLiteral<`0x${string}`>;
+    version: typeof Schema.Number;
+    inputType: typeof Schema.Number;
+}>;
+/** Context fields (chain ID, ACL address, user/contract addresses, version, on-chain inputType) used to derive a deterministic handle. */
+export type InputContext = typeof InputContext.Type;
+/**
+ * A 32-byte hex string representing an ENCRYPTION ciphertext handle.
+ *
+ * Format: `keccak_hash[0:29] || index_handle || handle_type || handle_version`
+ *
+ * @see pkg/hostchain/handle.md for the handle format spec.
+ */
+export type Handle = HexString;
+/**
+ * Expected length of a handle in bytes.
+ * Handle format: 29 bytes hash + 1 byte index + 1 byte type + 1 byte version = 32 bytes
+ */
+export declare const HANDLE_LENGTH_BYTES = 32;
+/**
+ * Validates handle integrity by checking format, length, and version.
+ * Matches the validation in Go's HandleFromBytes (pkg/hostchain/handle.go).
+ * @param handle - The handle to validate
+ * @throws Error if handle is malformed (wrong format, length, or unsupported version)
+ */
+export declare function validateHandle(handle: HexString): void;
+/**
+ * Extracts the {@link TeeType} from byte 30 of a validated handle.
+ * @param handle - A 32-byte hex handle string.
+ * @returns The ENCRYPTION type identifier stored in the handle.
+ * @throws If the handle is malformed or contains an invalid ENCRYPTION type.
+ * @see pkg/hostchain/handle.md for the handle format spec.
+ */
+export declare function getHandleType(handle: HexString): TeeType;
+/**
+ * Extracts the elist element {@link TeeType} from byte 29 of a validated handle.
+ * @param handle - A 32-byte hex handle string for an elist.
+ * @returns The ENCRYPTION type identifier of the elist elements.
+ * @throws If the handle is malformed or contains an invalid ENCRYPTION type at byte 29.
+ */
+export declare function getEListElementType(handle: HexString): TeeType;
+/**
+ * Computes the final handle for an input based on the ciphertext and the input context, matches the handle generation
+ * in Go and Solidity.
+ *
+ * @param ciphertext Note this is different from the input which has the external handle prepended
+ * @param indexHandle
+ * @param handleType
+ * @param handleVersion
+ * @param context
+ */
+export declare function computeHandle({ ciphertext, indexHandle, handleType, handleVersion, context, }: {
+    ciphertext: Uint8Array;
+    indexHandle: number;
+    handleType: TeeType;
+    handleVersion: number;
+    context: InputContext;
+}): Buffer;
+/**
+ * Computes the Keccak-256 hash of an ABI-packed {@link InputContext}.
+ *
+ * The context is packed as: `"evm/" || SEP_INPUT_CONTEXT || HANDLE_VERSION || inputType ||
+ *   chainId || aclAddress || userAddress || contractAddress || version`.
+ *
+ * @param context - The input context to hash.
+ * @returns A 32-byte `Buffer` containing the Keccak-256 digest.
+ */
+export declare function hashInputContext(context: InputContext): Buffer;

package/dist/cjs/handle.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HANDLE_LENGTH_BYTES = exports.InputContext = exports.HandleTypeName = exports.handleTypes = exports.BYTE_ELIST_ELEMENT_TYPE_INDEX = exports.SEP_ELIST_OP_RESULT = exports.SEP_OP_RESULT = exports.SEP_INPUT_CONTEXT = exports.SEP_INPUT_HANDLE = exports.HANDLE_VERSION = void 0;
+exports.isTeeType = isTeeType;
+exports.validateHandle = validateHandle;
+exports.getHandleType = getHandleType;
+exports.getEListElementType = getEListElementType;
+exports.computeHandle = computeHandle;
+exports.hashInputContext = hashInputContext;
+const effect_1 = require("effect");
+const sha3_1 = require("sha3");
+const viem_1 = require("viem");
+const binary_js_1 = require("./binary.js");
+/** Current handle version byte, appended as the last byte of every handle. */
+exports.HANDLE_VERSION = 0;
+/**
+ * Domain separators for handle derivation. Must be kept in sync with Solidity
+ * (contracts/lightning/src/Types.sol) and Go (pkg/hostchain/handle.go). Prefixing every
+ * keccak256 preimage with a unique constant string makes cross-derivation-path
+ * collision resistance structural rather than incidental.
+ */
+exports.SEP_INPUT_HANDLE = 'inco/handle/input-handle';
+exports.SEP_INPUT_CONTEXT = 'inco/handle/input-context';
+exports.SEP_OP_RESULT = 'inco/handle/op-result';
+exports.SEP_ELIST_OP_RESULT = 'inco/handle/elist-result';
+// The index of the byte in the handle where elist element type is stored
+exports.BYTE_ELIST_ELEMENT_TYPE_INDEX = 29;
+/**
+ * Map of ENCRYPTION type names to their integer identifiers.
+ *
+ * Keys provide a semantic interpretation over the underlying integral type.
+ * For example, `ebool` interprets a `uint16` as a boolean, `ebytes64` interprets
+ * a `uint512` as a 64-byte array, etc.
+ */
+exports.handleTypes = Object.freeze({
+    ebool: 0,
+    euint4: 1,
+    euint8: 2,
+    euint16: 3,
+    euint32: 4,
+    euint64: 5,
+    euint128: 6,
+    euint160: 7,
+    euint256: 8,
+    ebytes64: 9,
+    ebytes128: 10,
+    ebytes256: 11,
+});
+const handleNames = Object.keys(exports.handleTypes);
+/** Schema that validates a string is one of the known ENCRYPTION type names (e.g. `"ebool"`, `"euint256"`). */
+exports.HandleTypeName = effect_1.Schema.Literal(...handleNames);
+/**
+ * Type guard that checks whether a number is a valid {@link TeeType} identifier.
+ * @param value - The number to check.
+ * @returns `true` if `value` is a known ENCRYPTION type integer (0–11).
+ */
+function isTeeType(value) {
+    return Object.values(exports.handleTypes).includes(value);
+}
+/** Schema for the context required to compute a deterministic ENCRYPTION handle. */
+exports.InputContext = effect_1.Schema.Struct({
+    hostChainId: effect_1.Schema.BigInt,
+    aclAddress: binary_js_1.HexString,
+    userAddress: binary_js_1.HexString,
+    contractAddress: binary_js_1.HexString,
+    version: effect_1.Schema.Number,
+    inputType: effect_1.Schema.Number,
+});
+/**
+ * Expected length of a handle in bytes.
+ * Handle format: 29 bytes hash + 1 byte index + 1 byte type + 1 byte version = 32 bytes
+ */
+exports.HANDLE_LENGTH_BYTES = 32;
+/**
+ * Validates handle integrity by checking format, length, and version.
+ * Matches the validation in Go's HandleFromBytes (pkg/hostchain/handle.go).
+ * @param handle - The handle to validate
+ * @throws Error if handle is malformed (wrong format, length, or unsupported version)
+ */
+function validateHandle(handle) {
+    // Check format: must start with 0x prefix and have correct length
+    if (!handle.startsWith('0x') ||
+        handle.length !== 2 + 2 * exports.HANDLE_LENGTH_BYTES) {
+        throw new Error(`Invalid handle format: must be a ${exports.HANDLE_LENGTH_BYTES}-byte hex string with 0x prefix`);
+    }
+    const handleBytes = (0, viem_1.hexToBytes)(handle);
+    // Validate handle version (byte 31 must match HANDLE_VERSION)
+    const handleVersion = handleBytes[31];
+    if (handleVersion !== exports.HANDLE_VERSION) {
+        throw new Error(`Unsupported handle version: expected ${exports.HANDLE_VERSION}, got ${handleVersion} for handle ${handle}`);
+    }
+}
+/**
+ * Extracts the {@link TeeType} from byte 30 of a validated handle.
+ * @param handle - A 32-byte hex handle string.
+ * @returns The ENCRYPTION type identifier stored in the handle.
+ * @throws If the handle is malformed or contains an invalid ENCRYPTION type.
+ * @see pkg/hostchain/handle.md for the handle format spec.
+ */
+function getHandleType(handle) {
+    // Validate handle integrity before extracting type
+    validateHandle(handle);
+    const handleBytes = (0, viem_1.hexToBytes)(handle);
+    const handleType = handleBytes[30];
+    if (!isTeeType(handleType)) {
+        throw new Error(`Invalid handle type ${handleType} for handle ${handle}`);
+    }
+    return handleType;
+}
+/**
+ * Extracts the elist element {@link TeeType} from byte 29 of a validated handle.
+ * @param handle - A 32-byte hex handle string for an elist.
+ * @returns The ENCRYPTION type identifier of the elist elements.
+ * @throws If the handle is malformed or contains an invalid ENCRYPTION type at byte 29.
+ */
+function getEListElementType(handle) {
+    validateHandle(handle);
+    const handleBytes = (0, viem_1.hexToBytes)(handle);
+    const elementType = handleBytes[exports.BYTE_ELIST_ELEMENT_TYPE_INDEX];
+    if (!isTeeType(elementType)) {
+        throw new Error(`Invalid elist element type ${elementType} for handle ${handle}`);
+    }
+    return elementType;
+}
+// Handle format reference (kept in sync with Solidity in contracts/lightning/src and Go in pkg/hostchain/handle.go):
+/// @dev handle format for user inputs:    keccak256(keccak256(CiphertextList) || index_handle)[0:29] || index_handle || handle_type || handle_version
+/// @dev handle format for op results:     keccak256(keccak256(rawCiphertextList) || index_handle)[0:30] || handle_type || handle_version
+/// @dev CiphertextList layout: 1 byte (= N) for handles_list size, N bytes for handles_types (1 per handle), followed by the original raw ciphertext list
+/**
+ * Computes the final handle for an input based on the ciphertext and the input context, matches the handle generation
+ * in Go and Solidity.
+ *
+ * @param ciphertext Note this is different from the input which has the external handle prepended
+ * @param indexHandle
+ * @param handleType
+ * @param handleVersion
+ * @param context
+ */
+function computeHandle({ ciphertext, indexHandle, handleType, handleVersion, context, }) {
+    assertUint8(indexHandle);
+    assertUint8(handleType);
+    assertUint8(handleVersion);
+    if (handleVersion !== exports.HANDLE_VERSION) {
+        throw new Error(`Unsupported handle version: expected ${exports.HANDLE_VERSION}, got ${handleVersion}`);
+    }
+    const packed = (0, viem_1.encodePacked)([
+        'string',
+        'uint8',
+        'uint8',
+        'uint32',
+        'bytes',
+        'uint8',
+        'string',
+        'uint256',
+        'address',
+        'address',
+        'address',
+        'uint16',
+    ], [
+        exports.SEP_INPUT_HANDLE,
+        handleVersion,
+        handleType,
+        ciphertext.length,
+        (0, viem_1.toHex)(ciphertext),
+        indexHandle,
+        // Note: The x/hostchain spec requires the chain ID to be prefixed with 'evm/' for EVM chains
+        'evm/',
+        context.hostChainId,
+        context.aclAddress,
+        context.userAddress,
+        context.contractAddress,
+        context.version,
+    ]);
+    const hash = new sha3_1.Keccak(256).update(Buffer.from((0, viem_1.hexToBytes)(packed))).digest();
+    const handle = Buffer.alloc(32);
+    hash.copy(handle, 0, 0, 29);
+    handle.writeUInt8(indexHandle, 29);
+    handle.writeUInt8(handleType, 30);
+    handle.writeUInt8(handleVersion, 31);
+    return handle;
+}
+/**
+ * Computes the Keccak-256 hash of an ABI-packed {@link InputContext}.
+ *
+ * The context is packed as: `"evm/" || SEP_INPUT_CONTEXT || HANDLE_VERSION || inputType ||
+ *   chainId || aclAddress || userAddress || contractAddress || version`.
+ *
+ * @param context - The input context to hash.
+ * @returns A 32-byte `Buffer` containing the Keccak-256 digest.
+ */
+function hashInputContext(context) {
+    const packed = (0, viem_1.encodePacked)([
+        'string',
+        'string',
+        'uint8',
+        'uint8',
+        'uint256',
+        'address',
+        'address',
+        'address',
+        'uint16',
+    ], [
+        // Note: The x/hostchain spec requires the chain ID to be prefixed with 'evm/' for EVM chains
+        'evm/',
+        exports.SEP_INPUT_CONTEXT,
+        exports.HANDLE_VERSION,
+        context.inputType,
+        context.hostChainId,
+        context.aclAddress,
+        context.userAddress,
+        context.contractAddress,
+        context.version,
+    ]);
+    return new sha3_1.Keccak(256).update(Buffer.from((0, viem_1.hexToBytes)(packed))).digest();
+}
+function assertUint8(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 255) {
+        throw new Error(`Invalid uint8 value: ${value}`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFuZGxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2hhbmRsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUE4REEsOEJBRUM7QUF1Q0Qsd0NBb0JDO0FBU0Qsc0NBVUM7QUFRRCxrREFXQztBQWlCRCxzQ0EyREM7QUFXRCw0Q0EyQkM7QUFuUkQsbUNBQWdDO0FBQ2hDLCtCQUE4QjtBQUM5QiwrQkFBdUQ7QUFDdkQsMkNBQXdDO0FBRXhDLDhFQUE4RTtBQUNqRSxRQUFBLGNBQWMsR0FBRyxDQUFDLENBQUM7QUFFaEM7Ozs7O0dBS0c7QUFDVSxRQUFBLGdCQUFnQixHQUFHLDBCQUEwQixDQUFDO0FBQzlDLFFBQUEsaUJBQWlCLEdBQUcsMkJBQTJCLENBQUM7QUFDaEQsUUFBQSxhQUFhLEdBQUcsdUJBQXVCLENBQUM7QUFDeEMsUUFBQSxtQkFBbUIsR0FBRywwQkFBMEIsQ0FBQztBQUM5RCx5RUFBeUU7QUFDNUQsUUFBQSw2QkFBNkIsR0FBRyxFQUFFLENBQUM7QUFFaEQ7Ozs7OztHQU1HO0FBQ1UsUUFBQSxXQUFXLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUN2QyxLQUFLLEVBQUUsQ0FBQztJQUNSLE1BQU0sRUFBRSxDQUFDO0lBQ1QsTUFBTSxFQUFFLENBQUM7SUFDVCxPQUFPLEVBQUUsQ0FBQztJQUNWLE9BQU8sRUFBRSxDQUFDO0lBQ1YsT0FBTyxFQUFFLENBQUM7SUFDVixRQUFRLEVBQUUsQ0FBQztJQUNYLFFBQVEsRUFBRSxDQUFDO0lBQ1gsUUFBUSxFQUFFLENBQUM7SUFDWCxRQUFRLEVBQUUsQ0FBQztJQUNYLFNBQVMsRUFBRSxFQUFFO0lBQ2IsU0FBUyxFQUFFLEVBQUU7Q0FDZCxDQUFDLENBQUM7QUFFSCxNQUFNLFdBQVcsR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLG1CQUFXLENBQWlDLENBQUM7QUFFN0UsK0dBQStHO0FBQ2xHLFFBQUEsY0FBYyxHQUFHLGVBQU0sQ0FBQyxPQUFPLENBQUMsR0FB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

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export * from './binary.js';
+export * from './chain.js';
+export { HANDLE_LENGTH_BYTES, HANDLE_VERSION, HandleTypeName, InputContext, getHandleType, handleTypes, isTeeType, validateHandle, type Handle, type HandleTypes, type TeeType, } from './handle.js';
+export * from './schema.js';
+export * from './viem.js';

package/dist/cjs/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateHandle = exports.isTeeType = exports.handleTypes = exports.getHandleType = exports.InputContext = exports.HandleTypeName = exports.HANDLE_VERSION = exports.HANDLE_LENGTH_BYTES = void 0;
+__exportStar(require("./binary.js"), exports);
+__exportStar(require("./chain.js"), exports);
+var handle_js_1 = require("./handle.js");
+Object.defineProperty(exports, "HANDLE_LENGTH_BYTES", { enumerable: true, get: function () { return handle_js_1.HANDLE_LENGTH_BYTES; } });
+Object.defineProperty(exports, "HANDLE_VERSION", { enumerable: true, get: function () { return handle_js_1.HANDLE_VERSION; } });
+Object.defineProperty(exports, "HandleTypeName", { enumerable: true, get: function () { return handle_js_1.HandleTypeName; } });
+Object.defineProperty(exports, "InputContext", { enumerable: true, get: function () { return handle_js_1.InputContext; } });
+Object.defineProperty(exports, "getHandleType", { enumerable: true, get: function () { return handle_js_1.getHandleType; } });
+Object.defineProperty(exports, "handleTypes", { enumerable: true, get: function () { return handle_js_1.handleTypes; } });
+Object.defineProperty(exports, "isTeeType", { enumerable: true, get: function () { return handle_js_1.isTeeType; } });
+Object.defineProperty(exports, "validateHandle", { enumerable: true, get: function () { return handle_js_1.validateHandle; } });
+__exportStar(require("./schema.js"), exports);
+__exportStar(require("./viem.js"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSw4Q0FBNEI7QUFDNUIsNkNBQTJCO0FBQzNCLHlDQVlxQjtBQVhuQixnSEFBQSxtQkFBbUIsT0FBQTtBQUNuQiwyR0FBQSxjQUFjLE9BQUE7QUFDZCwyR0FBQSxjQUFjLE9BQUE7QUFDZCx5R0FBQSxZQUFZLE9BQUE7QUFDWiwwR0FBQSxhQUFhLE9BQUE7QUFDYix3R0FBQSxXQUFXLE9BQUE7QUFDWCxzR0FBQSxTQUFTLE9BQUE7QUFDVCwyR0FBQSxjQUFjLE9BQUE7QUFLaEIsOENBQTRCO0FBQzVCLDRDQUEwQiJ9

package/dist/cjs/kms/client.d.ts

@@ -0,0 +1,12 @@
+import { type Client } from '@connectrpc/connect';
+import type { Address } from 'viem';
+import type { SupportedChain } from '../chain.js';
+import { KmsService } from '../generated/es/inco/kms/lite/v1/kms_service_pb.js';
+export declare const TEST_DEFAULT_COVALIDATOR_SIGNER: Address;
+export type KmsClient = Client<typeof KmsService> & {
+    signerAddress: Address;
+};
+export declare function getKmsClient(kmsConnectRpcEndpointOrClient: string | KmsClient, signerAddress: Address): KmsClient;
+export declare function defaultCovalidatorGrpc(chain: SupportedChain): string;
+export declare function lightningDevnetCovalidatorGrpc(chain: SupportedChain): string;
+export declare function lightningTestnetCovalidatorGrpc(chain: SupportedChain): string;

package/dist/cjs/kms/client.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_DEFAULT_COVALIDATOR_SIGNER = void 0;
+exports.getKmsClient = getKmsClient;
+exports.defaultCovalidatorGrpc = defaultCovalidatorGrpc;
+exports.lightningDevnetCovalidatorGrpc = lightningDevnetCovalidatorGrpc;
+exports.lightningTestnetCovalidatorGrpc = lightningTestnetCovalidatorGrpc;
+const connect_1 = require("@connectrpc/connect");
+const connect_web_1 = require("@connectrpc/connect-web");
+const kms_service_pb_js_1 = require("../generated/es/inco/kms/lite/v1/kms_service_pb.js");
+// anvil zeroth address, while there is only one signer,
+// this does not matter, as we use these addresses for signer ordering
+// [WARNING] This is the default signer for the Inco Lightning public testnet.
+exports.TEST_DEFAULT_COVALIDATOR_SIGNER = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266';
+// Helper function to get a KMS client from a string or a Client instance.
+function getKmsClient(kmsConnectRpcEndpointOrClient, signerAddress) {
+    if (typeof kmsConnectRpcEndpointOrClient === 'string') {
+        const transport = (0, connect_web_1.createConnectTransport)({
+            baseUrl: kmsConnectRpcEndpointOrClient,
+        });
+        const client = (0, connect_1.createClient)(kms_service_pb_js_1.KmsService, transport);
+        return Object.assign(client, { signerAddress });
+    }
+    return Object.assign(kmsConnectRpcEndpointOrClient, { signerAddress });
+}
+// Helper function to return the default gRPC endpoint for the covalidator.
+// Currently, this returns the covalidator for the Inco Lightning public testnet.
+function defaultCovalidatorGrpc(chain) {
+    return lightningTestnetCovalidatorGrpc(chain);
+}
+// Helper function to get the devnet gRPC endpoint for the Inco Lightning covalidator.
+function lightningDevnetCovalidatorGrpc(chain) {
+    return getCovalidatorGrpcHelper(chain, 'devnet', 'lightning');
+}
+// Helper function to get the testnet gRPC endpoint for the Inco Lightning covalidator.
+function lightningTestnetCovalidatorGrpc(chain) {
+    return getCovalidatorGrpcHelper(chain, 'testnet', 'lightning');
+}
+// Convert camelCase to dash-case.
+function camelToDashCase(str) {
+    return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+}
+// Small helper, as our GCP covalidator URLs are in a specific format.
+function getCovalidatorGrpcHelper(chain, network, cluster) {
+    return `https://grpc.${camelToDashCase(chain.name)}.${cluster}.${network}.inco.org`;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2ttcy9jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBZUEsb0NBYUM7QUFJRCx3REFFQztBQUdELHdFQUVDO0FBR0QsMEVBRUM7QUE1Q0QsaURBQWdFO0FBQ2hFLHlEQUFpRTtBQUdqRSwwRkFBZ0Y7QUFFaEYsd0RBQXdEO0FBQ3hELHNFQUFzRTtBQUN0RSw4RUFBOEU7QUFDakUsUUFBQSwrQkFBK0IsR0FDMUMsNENBQTRDLENBQUM7QUFJL0MsMEVBQTBFO0FBQzFFLFNBQWdCLFlBQVksQ0FDMUIsNkJBQWlELEVBQ2pELGFBQXNCO0lBRXRCLElBQUksT0FBTyw2QkFBNkIsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUN0RCxNQUFNLFNBQVMsR0FBRyxJQUFBLG9DQUFzQixFQUFDO1lBQ3ZDLE9BQU8sRUFBRSw2QkFBNkI7U0FDdkMsQ0FBQyxDQUFDO1FBQ0gsTUFBTSxNQUFNLEdBQUcsSUFBQSxzQkFBWSxFQUFDLDhCQUFVLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDbkQsT0FBTyxNQUFNLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxFQUFFLGFBQWEsRUFBRSxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQUVELE9BQU8sTUFBTSxDQUFDLE1BQU0sQ0FBQyw2QkFBNkIsRUFBRSxFQUFFLGFBQWEsRUFBRSxDQUFDLENBQUM7QUFDekUsQ0FBQztBQUVELDJFQUEyRTtBQUMzRSxpRkFBaUY7QUFDakYsU0FBZ0Isc0JBQXNCLENBQUMsS0FBcUI7SUFDMUQsT0FBTywrQkFBK0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUNoRCxDQUFDO0FBRUQsc0ZBQXNGO0FBQ3RGLFNBQWdCLDhCQUE4QixDQUFDLEtBQXFCO0lBQ2xFLE9BQU8sd0JBQXdCLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxXQUFXLENBQUMsQ0FBQztBQUNoRSxDQUFDO0FBRUQsdUZBQXVGO0FBQ3ZGLFNBQWdCLCtCQUErQixDQUFDLEtBQXFCO0lBQ25FLE9BQU8sd0JBQXdCLENBQUMsS0FBSyxFQUFFLFNBQVMsRUFBRSxXQUFXLENBQUMsQ0FBQztBQUNqRSxDQUFDO0FBRUQsa0NBQWtDO0FBQ2xDLFNBQVMsZUFBZSxDQUFDLEdBQVc7SUFDbEMsT0FBTyxHQUFHLENBQUMsT0FBTyxDQUFDLGlCQUFpQixFQUFFLE9BQU8sQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFDO0FBQy9ELENBQUM7QUFFRCxzRUFBc0U7QUFDdEUsU0FBUyx3QkFBd0IsQ0FDL0IsS0FBcUIsRUFDckIsT0FBNkIsRUFDN0IsT0FBb0I7SUFFcEIsT0FBTyxnQkFBZ0IsZUFBZSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxPQUFPLElBQUksT0FBTyxXQUFXLENBQUM7QUFDdEYsQ0FBQyJ9