@lidofinance/lido-csm-sdk 0.2.0

package/dist/esm/deposit-data-sdk/deposit-data-sdk.js

@@ -0,0 +1,156 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { CsmSDKModule } from '../common/class-primitives/csm-sdk-module.js';
+import { Cache, ErrorHandler, Logger } from '../common/decorators/index.js';
+import { CSM_CONTRACT_NAMES } from '../common/index.js';
+import { compareLowercase, toHexString } from '../common/utils/index.js';
+import { parseDepositData, removeKey } from './parser.js';
+import { ValidationErrorCode, } from './types.js';
+import { validateDepositData, validateDepositDataSync } from './validator.js';
+let DepositDataSDK = (() => {
+    var _a;
+    let _classSuper = CsmSDKModule;
+    let _instanceExtraInitializers = [];
+    let _parseDepositData_decorators;
+    let _removeKey_decorators;
+    let _validateDepositData_decorators;
+    let _validateDepositDataSync_decorators;
+    let _checkUploadedKeys_decorators;
+    let _checkCachedKeys_decorators;
+    return _a = class DepositDataSDK extends _classSuper {
+            /**
+             * Parse deposit data JSON with enhanced error handling
+             */
+            parseDepositData(json) {
+                return parseDepositData(json);
+            }
+            /**
+             * Remove key at specified index with comprehensive validation
+             */
+            removeKey(json, index) {
+                return removeKey(json, index);
+            }
+            /**
+             * Validation of deposit data including signature verification
+             */
+            async validateDepositData(depositData) {
+                const chainId = this.core.chainId;
+                const wc = this.core.getContractAddress(CSM_CONTRACT_NAMES.withdrawalVault);
+                const blockNumber = await this.core.client.getBlockNumber();
+                const errors = await validateDepositData(depositData, {
+                    chainId,
+                    withdrawalCredentials: wc,
+                    currentBlockNumber: Number(blockNumber),
+                });
+                // Extract pubkeys for additional checks
+                const pubkeys = depositData.map((data) => data.pubkey);
+                // Check for cached duplicates
+                const duplicateErrors = this.checkCachedKeys(pubkeys);
+                // Check for previously uploaded keys
+                const uploadedDuplicateErrors = await this.checkUploadedKeys(pubkeys.map(toHexString));
+                // Merge all errors
+                return [...errors, ...duplicateErrors, ...uploadedDuplicateErrors];
+            }
+            /**
+             * Quick synchronous validation without signature verification
+             */
+            validateDepositDataSync(depositData) {
+                const chainId = this.core.chainId;
+                const wc = this.core.getContractAddress(CSM_CONTRACT_NAMES.withdrawalVault);
+                return validateDepositDataSync(depositData, {
+                    chainId,
+                    withdrawalCredentials: wc,
+                });
+            }
+            async checkUploadedKeys(pubkeys) {
+                const keys = await this.bus.get('keysWithStatus')?.getApiKeys(pubkeys);
+                const errors = [];
+                if (!keys)
+                    return errors;
+                pubkeys.forEach((pubkey, index) => {
+                    const isUploaded = keys.find((key) => compareLowercase(key.key, pubkey));
+                    if (isUploaded) {
+                        errors.push({
+                            index,
+                            message: `pubkey was previously submitted`,
+                            field: 'pubkey',
+                            code: ValidationErrorCode.PREVIOUSLY_SUBMITTED,
+                        });
+                    }
+                });
+                return errors;
+            }
+            checkCachedKeys(pubkeys) {
+                const keysCache = this.bus.get('keysCache');
+                const errors = [];
+                if (!keysCache)
+                    return errors;
+                pubkeys.forEach((pubkey, index) => {
+                    if (keysCache.isDuplicate(pubkey)) {
+                        errors.push({
+                            index,
+                            message: `pubkey already exists in cache`,
+                            field: 'pubkey',
+                            code: ValidationErrorCode.DUPLICATE_PUBKEY,
+                        });
+                    }
+                });
+                return errors;
+            }
+            constructor() {
+                super(...arguments);
+                __runInitializers(this, _instanceExtraInitializers);
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _parseDepositData_decorators = [Logger('Utils:')];
+            _removeKey_decorators = [Logger('Utils:')];
+            _validateDepositData_decorators = [Logger('Utils:')];
+            _validateDepositDataSync_decorators = [Logger('Utils:')];
+            _checkUploadedKeys_decorators = [Logger('API:'), ErrorHandler(), Cache(60 * 1000)];
+            _checkCachedKeys_decorators = [Logger('Utils:'), ErrorHandler()];
+            __esDecorate(_a, null, _parseDepositData_decorators, { kind: "method", name: "parseDepositData", static: false, private: false, access: { has: obj => "parseDepositData" in obj, get: obj => obj.parseDepositData }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _removeKey_decorators, { kind: "method", name: "removeKey", static: false, private: false, access: { has: obj => "removeKey" in obj, get: obj => obj.removeKey }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _validateDepositData_decorators, { kind: "method", name: "validateDepositData", static: false, private: false, access: { has: obj => "validateDepositData" in obj, get: obj => obj.validateDepositData }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _validateDepositDataSync_decorators, { kind: "method", name: "validateDepositDataSync", static: false, private: false, access: { has: obj => "validateDepositDataSync" in obj, get: obj => obj.validateDepositDataSync }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _checkUploadedKeys_decorators, { kind: "method", name: "checkUploadedKeys", static: false, private: false, access: { has: obj => "checkUploadedKeys" in obj, get: obj => obj.checkUploadedKeys }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _checkCachedKeys_decorators, { kind: "method", name: "checkCachedKeys", static: false, private: false, access: { has: obj => "checkCachedKeys" in obj, get: obj => obj.checkCachedKeys }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+export { DepositDataSDK };
+//# sourceMappingURL=deposit-data-sdk.js.map

package/dist/esm/deposit-data-sdk/deposit-data-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit-data-sdk.js","sourceRoot":"","sources":["../../../src/deposit-data-sdk/deposit-data-sdk.ts"],"names":[],"mappings":"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"}

package/dist/esm/deposit-data-sdk/index.js

@@ -0,0 +1,3 @@
+export * from './deposit-data-sdk.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/deposit-data-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/deposit-data-sdk/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/esm/deposit-data-sdk/parser.js

@@ -0,0 +1,131 @@
+import { MAX_JSON_LENGTH } from './constants.js';
+/**
+ * Normalizes hex values in JSON by removing '0x' prefixes
+ */
+const normalizeHexInJson = (text) => {
+    return text.replace(/"0x/gm, '"');
+};
+/**
+ * Validates and parses JSON string into DepositData array
+ * This function combines validation and parsing logic
+ */
+const parseAndValidateJson = (data) => {
+    // Check for empty data
+    if (!data || data.trim() === '') {
+        return {
+            depositData: [],
+            error: 'Deposit data should not be empty',
+        };
+    }
+    // Check size limit
+    if (data.length > MAX_JSON_LENGTH) {
+        return {
+            depositData: [],
+            error: `Deposit data is too big (max ${Math.round(MAX_JSON_LENGTH / 1024 / 1024)}MB)`,
+        };
+    }
+    // Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch (error) {
+        return {
+            depositData: [],
+            error: 'Invalid JSON format',
+        };
+    }
+    // Ensure we have an array
+    const depositData = Array.isArray(parsed) ? parsed : [parsed];
+    // Validate array is not empty
+    if (depositData.length === 0) {
+        return {
+            depositData: [],
+            error: 'Should have at least 1 key',
+        };
+    }
+    // Basic validation of each item
+    for (const [index, item] of depositData.entries()) {
+        if (!item || typeof item !== 'object') {
+            return {
+                depositData: [],
+                error: `Item at index ${index} should be an object`,
+            };
+        }
+        // Check for required fields
+        const requiredFields = [
+            'pubkey',
+            'withdrawal_credentials',
+            'amount',
+            'signature',
+            'deposit_message_root',
+            'deposit_data_root',
+            'fork_version',
+        ];
+        for (const field of requiredFields) {
+            if (!(field in item)) {
+                return {
+                    depositData: [],
+                    error: `Item at index ${index} is missing required field: ${field}`,
+                };
+            }
+        }
+    }
+    return { depositData };
+};
+/**
+ * Parse deposit data JSON with comprehensive error handling
+ */
+export const parseDepositData = (jsonDepositData) => {
+    const normalizedJson = normalizeHexInJson(jsonDepositData);
+    const result = parseAndValidateJson(normalizedJson);
+    if (result.error) {
+        return {
+            success: false,
+            error: result.error,
+        };
+    }
+    return {
+        success: true,
+        data: result.depositData,
+    };
+};
+/**
+ * Remove a key at specified index with enhanced error handling
+ */
+export const removeKey = (jsonDepositData, index) => {
+    // Validate index parameter
+    if (!Number.isInteger(index) || index < 0) {
+        return {
+            success: false,
+            error: 'Index must be a non-negative integer',
+        };
+    }
+    // Parse the JSON first
+    const parseResult = parseDepositData(jsonDepositData);
+    if (!parseResult.success || !parseResult.data) {
+        return {
+            success: false,
+            error: parseResult.error || 'Failed to parse deposit data',
+        };
+    }
+    const depositData = parseResult.data;
+    // Validate index is within bounds
+    if (index >= depositData.length) {
+        return {
+            success: false,
+            error: `Index ${index} is out of bounds (array length: ${depositData.length})`,
+        };
+    }
+    // Remove the item
+    const updatedData = Array.from(depositData);
+    updatedData.splice(index, 1);
+    // Return result
+    const json = updatedData.length > 0 ? JSON.stringify(updatedData, null, 2) : '';
+    return {
+        success: true,
+        data: updatedData,
+        json,
+    };
+};
+//# sourceMappingURL=parser.js.map

package/dist/esm/deposit-data-sdk/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/deposit-data-sdk/parser.ts"],"names":[],"mappings":"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"}

package/dist/esm/deposit-data-sdk/signature.js

@@ -0,0 +1,187 @@
+/**
+ * Alternative BLS signature verification implementation for Ethereum deposit data.
+ *
+ * This implementation follows the Ethereum consensus specification closely:
+ * - Proper SSZ serialization using @chainsafe/ssz
+ * - Clear separation of domain computation, signing root, and verification
+ * - Better error handling and type safety
+ * - Compatible with both @chainsafe/bls and bls-eth-wasm
+ *
+ * Reference:
+ * - https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/beacon-chain.md#bls-signatures
+ * - https://github.com/ethereum/consensus-specs/blob/dev/specs/phase0/deposit-contract.md
+ */
+import { ByteVectorType, ContainerType, UintBigintType } from '@chainsafe/ssz';
+import bls from 'bls-eth-wasm';
+import { hexToBytes, toHex } from 'viem';
+import { DOMAIN_DEPOSIT, FIXED_FORK_VERSION } from './constants.js';
+/**
+ * SSZ Types following Ethereum consensus spec
+ */
+/** DepositMessage as per consensus spec */
+const DepositMessageSSZ = new ContainerType({
+    pubkey: new ByteVectorType(48),
+    withdrawal_credentials: new ByteVectorType(32),
+    amount: new UintBigintType(8),
+});
+/** ForkData for computing fork-specific domain */
+const ForkDataSSZ = new ContainerType({
+    current_version: new ByteVectorType(4),
+    genesis_validators_root: new ByteVectorType(32),
+});
+/** SigningData for computing signing root */
+const SigningDataSSZ = new ContainerType({
+    object_root: new ByteVectorType(32),
+    domain: new ByteVectorType(32),
+});
+/**
+ * BLS initialization
+ */
+let blsInitialized = false;
+const ensureBLSInit = async () => {
+    if (!blsInitialized) {
+        await bls.init(bls.BLS12_381);
+        blsInitialized = true;
+    }
+};
+/**
+ * Helper to ensure hex strings have 0x prefix
+ */
+const ensureHex = (value) => {
+    return (value.startsWith('0x') ? value : `0x${value}`);
+};
+/**
+ * Get fork version for the chain
+ * @throws {Error} If fork version is not found
+ */
+const getForkVersion = (chainId) => {
+    const version = FIXED_FORK_VERSION[chainId];
+    if (!version) {
+        throw new Error(`Fork version not found for chain ${chainId}`);
+    }
+    // Fork version is 4 bytes, pad if necessary
+    const hex = version.padStart(8, '0');
+    return hexToBytes(ensureHex(hex));
+};
+/**
+ * Compute fork data root using SSZ
+ *
+ * per consensus spec:
+ * def compute_fork_data_root(current_version: Version, genesis_validators_root: Root) -> Root:
+ *     return hash_tree_root(ForkData(
+ *         current_version=current_version,
+ *         genesis_validators_root=genesis_validators_root,
+ *     ))
+ */
+const computeForkDataRoot = (currentVersion, genesisValidatorsRoot) => {
+    const forkData = {
+        current_version: currentVersion,
+        genesis_validators_root: genesisValidatorsRoot,
+    };
+    return ForkDataSSZ.hashTreeRoot(forkData);
+};
+/**
+ * Compute domain using domain type and fork data root
+ *
+ * per consensus spec:
+ * def compute_domain(domain_type: DomainType, fork_version: Version=None, genesis_validators_root: Root=None) -> Domain:
+ *     if fork_version is None:
+ *         fork_version = config.GENESIS_FORK_VERSION
+ *     if genesis_validators_root is None:
+ *         genesis_validators_root = Root()
+ *     fork_data_root = compute_fork_data_root(fork_version, genesis_validators_root)
+ *     return Domain(domain_type + fork_data_root[:28])
+ */
+const computeDomain = (domainType, forkVersion, genesisValidatorsRoot) => {
+    const forkDataRoot = computeForkDataRoot(forkVersion, genesisValidatorsRoot);
+    // Domain is domain_type (4 bytes) + first 28 bytes of fork_data_root
+    const domain = new Uint8Array(32);
+    domain.set(domainType, 0);
+    domain.set(forkDataRoot.slice(0, 28), 4);
+    return domain;
+};
+/**
+ * Compute signing root from object root and domain
+ *
+ * per consensus spec:
+ * def compute_signing_root(ssz_object: SSZObject, domain: Domain) -> Root:
+ *     return hash_tree_root(SigningData(
+ *         object_root=hash_tree_root(ssz_object),
+ *         domain=domain,
+ *     ))
+ */
+const computeSigningRoot = (objectRoot, domain) => {
+    const signingData = {
+        object_root: objectRoot,
+        domain: domain,
+    };
+    return SigningDataSSZ.hashTreeRoot(signingData);
+};
+/**
+ * Compute deposit message root (hash tree root of DepositMessage)
+ */
+const computeDepositMessageRoot = (message) => {
+    return DepositMessageSSZ.hashTreeRoot(message);
+};
+/**
+ * Verify BLS signature for deposit data following Ethereum consensus spec
+ *
+ * @param data - Deposit data to verify
+ * @param chainId - Chain ID (mainnet or testnet)
+ * @returns Promise<boolean> - True if signature is valid
+ *
+ * @example
+ * const isValid = await verifyDepositSignature(depositData, CHAINS.Mainnet);
+ * if (!isValid) {
+ *   console.error('Invalid signature');
+ * }
+ */
+export const verifyDepositSignature = async (data, chainId) => {
+    try {
+        // Initialize BLS library
+        await ensureBLSInit();
+        // Parse input data
+        const pubkey = hexToBytes(ensureHex(data.pubkey));
+        const signature = hexToBytes(ensureHex(data.signature));
+        const withdrawalCredentials = hexToBytes(ensureHex(data.withdrawal_credentials));
+        const amount = BigInt(data.amount);
+        // Validate input sizes
+        if (pubkey.length !== 48 || signature.length !== 96 || withdrawalCredentials.length !== 32) {
+            return false;
+        }
+        // Build DepositMessage
+        const depositMessage = {
+            pubkey,
+            withdrawal_credentials: withdrawalCredentials,
+            amount,
+        };
+        // Step 1: Compute deposit message root
+        const messageRoot = computeDepositMessageRoot(depositMessage);
+        // Verify deposit_message_root matches
+        const providedMessageRoot = ensureHex(data.deposit_message_root);
+        if (toHex(messageRoot).toLowerCase() !== providedMessageRoot.toLowerCase()) {
+            return false;
+        }
+        // Step 2: Get chain-specific parameters
+        const forkVersion = getForkVersion(chainId);
+        // IMPORTANT: Per Ethereum spec, deposit signatures use ZERO genesis_validators_root
+        // "The sole exception to the mixing-in of the fork version is signatures on deposits"
+        // Reference: staking-deposit-cli uses ZERO_BYTES32 for deposits
+        const genesisValidatorsRoot = new Uint8Array(32); // All zeros
+        // Step 3: Compute domain
+        const domainType = hexToBytes(DOMAIN_DEPOSIT);
+        const domain = computeDomain(domainType, forkVersion, genesisValidatorsRoot);
+        // Step 4: Compute signing root
+        const signingRoot = computeSigningRoot(messageRoot, domain);
+        // Step 5: Verify BLS signature
+        const publicKey = new bls.PublicKey();
+        publicKey.deserialize(pubkey);
+        const sig = new bls.Signature();
+        sig.deserialize(signature);
+        return publicKey.verify(sig, signingRoot);
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=signature.js.map

package/dist/esm/deposit-data-sdk/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../../src/deposit-data-sdk/signature.ts"],"names":[],"mappings":"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"}

package/dist/esm/deposit-data-sdk/types.js

@@ -0,0 +1,16 @@
+export var ValidationErrorCode;
+(function (ValidationErrorCode) {
+    ValidationErrorCode["INVALID_PUBKEY"] = "INVALID_PUBKEY";
+    ValidationErrorCode["INVALID_SIGNATURE"] = "INVALID_SIGNATURE";
+    ValidationErrorCode["INVALID_WITHDRAWAL_CREDENTIALS"] = "INVALID_WITHDRAWAL_CREDENTIALS";
+    ValidationErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    ValidationErrorCode["INVALID_NETWORK"] = "INVALID_NETWORK";
+    ValidationErrorCode["INVALID_FORK_VERSION"] = "INVALID_FORK_VERSION";
+    ValidationErrorCode["INVALID_DEPOSIT_ROOT"] = "INVALID_DEPOSIT_ROOT";
+    ValidationErrorCode["DUPLICATE_PUBKEY"] = "DUPLICATE_PUBKEY";
+    ValidationErrorCode["PREVIOUSLY_SUBMITTED"] = "PREVIOUSLY_SUBMITTED";
+    ValidationErrorCode["INVALID_BLS_SIGNATURE"] = "INVALID_BLS_SIGNATURE";
+    ValidationErrorCode["MISSING_FIELD"] = "MISSING_FIELD";
+    ValidationErrorCode["INVALID_FORMAT"] = "INVALID_FORMAT";
+})(ValidationErrorCode || (ValidationErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/deposit-data-sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/deposit-data-sdk/types.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAN,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC7B,wDAAiC,CAAA;IACjC,8DAAuC,CAAA;IACvC,wFAAiE,CAAA;IACjE,wDAAiC,CAAA;IACjC,0DAAmC,CAAA;IACnC,oEAA6C,CAAA;IAC7C,oEAA6C,CAAA;IAC7C,4DAAqC,CAAA;IACrC,oEAA6C,CAAA;IAC7C,sEAA+C,CAAA;IAC/C,sDAA+B,CAAA;IAC/B,wDAAiC,CAAA;AACnC,CAAC,EAbW,mBAAmB,KAAnB,mBAAmB,QAa9B"}