@obolnetwork/obol-sdk 2.10.2 → 2.11.0

package/dist/esm/src/constants.js

@@ -1,6 +1,6 @@
 import pjson from '../package.json';
 import { FORK_MAPPING } from './types';
-import { HOLESKY_MULTICALL_BYTECODE, HOLESKY_OWR_FACTORY_BYTECODE, HOLESKY_SPLITMAIN_BYTECODE, HOODI_MULTICALL_BYTECODE, HOODI_OVM_FACTORY_BYTECODE, HOODI_OWR_FACTORY_BYTECODE, HOODI_SPLIT_V2_FACTORY_BYTECODE, HOODI_SPLITMAIN_BYTECODE, HOODI_WAREHOUSE_BYTECODE, MAINNET_MULTICALL_BYTECODE, MAINNET_OVM_FACTORY_BYTECODE, MAINNET_OWR_FACTORY_BYTECODE, MAINNET_SPLIT_V2_FACTORY_BYTECODE, MAINNET_SPLITMAIN_BYTECODE, MAINNET_WAREHOUSE_BYTECODE, } from './bytecodes';
+import { HOLESKY_MULTICALL3_BYTECODE, HOLESKY_OWR_FACTORY_BYTECODE, HOLESKY_SPLITMAIN_BYTECODE, HOODI_MULTICALL3_BYTECODE, HOODI_OVM_FACTORY_BYTECODE, HOODI_OWR_FACTORY_BYTECODE, HOODI_SPLIT_V2_FACTORY_BYTECODE, HOODI_SPLITMAIN_BYTECODE, HOODI_WAREHOUSE_BYTECODE, MAINNET_MULTICALL3_BYTECODE, MAINNET_OVM_FACTORY_BYTECODE, MAINNET_OWR_FACTORY_BYTECODE, MAINNET_SPLIT_V2_FACTORY_BYTECODE, MAINNET_SPLITMAIN_BYTECODE, MAINNET_WAREHOUSE_BYTECODE, } from './bytecodes';
 import * as dotenv from 'dotenv';
 dotenv.config();
 export const CONFLICT_ERROR_MSG = 'Conflict';
@@ -112,9 +112,9 @@ export const CHAIN_CONFIGURATION = {
             address: '0x2ed6c4B5dA6378c7897AC67Ba9e43102Feb694EE',
             bytecode: MAINNET_SPLITMAIN_BYTECODE,
         },
-        MULTICALL_CONTRACT: {
-            address: '0xeefba1e63905ef1d7acba5a8513c70307c1ce441',
-            bytecode: MAINNET_MULTICALL_BYTECODE,
+        MULTICALL3_CONTRACT: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            bytecode: MAINNET_MULTICALL3_BYTECODE,
         },
         OWR_FACTORY_CONTRACT: {
             address: '0x119acd7844cbdd5fc09b1c6a4408f490c8f7f522',
@@ -140,15 +140,18 @@ export const CHAIN_CONFIGURATION = {
         EOA_WITHDRAWAL_CONTRACT: {
             address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
         },
+        BATCH_DEPOSIT_CONTRACT: {
+            address: '0xcD7a6C118Ac8F6544BC5076F2D8Fb86D2C546756',
+        },
     },
     [FORK_MAPPING['0x01017000']]: {
         SPLITMAIN_CONTRACT: {
             address: '0xfC8a305728051367797DADE6Aa0344E0987f5286',
             bytecode: HOLESKY_SPLITMAIN_BYTECODE,
         },
-        MULTICALL_CONTRACT: {
+        MULTICALL3_CONTRACT: {
             address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-            bytecode: HOLESKY_MULTICALL_BYTECODE,
+            bytecode: HOLESKY_MULTICALL3_BYTECODE,
         },
         OWR_FACTORY_CONTRACT: {
             address: '0xc0961353fcc43a99e3041db07ac646720e116256',
@@ -167,9 +170,9 @@ export const CHAIN_CONFIGURATION = {
             address: '0xc05ae267291705ac16F75283572294ed2a91CBc7',
             bytecode: HOODI_SPLITMAIN_BYTECODE,
         },
-        MULTICALL_CONTRACT: {
+        MULTICALL3_CONTRACT: {
             address: '0xcA11bde05977b3631167028862bE2a173976CA11',
-            bytecode: HOODI_MULTICALL_BYTECODE,
+            bytecode: HOODI_MULTICALL3_BYTECODE,
         },
         OWR_FACTORY_CONTRACT: {
             address: '0x9ff0c649d0bf5fe7efa4d72e94bed7302ed5c8d7',
@@ -195,6 +198,9 @@ export const CHAIN_CONFIGURATION = {
         EOA_WITHDRAWAL_CONTRACT: {
             address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
         },
+        BATCH_DEPOSIT_CONTRACT: {
+            address: '0x4c9506eE2fCd962f03022D9d8ebf6f7828abEfaf',
+        },
     },
 };
 export const DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT = 1;

package/dist/esm/src/eoa/eoa.js

@@ -7,9 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { submitEOAWithdrawalRequest } from './eoaHelpers';
+import { submitEOAWithdrawalRequest, submitEOABatchDeposit, } from './eoaHelpers';
 import { validatePayload } from '../ajv';
-import { eoaWithdrawalPayloadSchema } from '../schema';
+import { eoaWithdrawalPayloadSchema, eoaDepositPayloadSchema } from '../schema';
 import { CHAIN_CONFIGURATION } from '../constants';
 /**
  * EOA can be used for managing EOA (Externally Owned Account) operations like withdrawals.
@@ -76,4 +76,52 @@ export class EOA {
             });
         });
     }
+    /**
+     * Deposits to batch deposit contract.
+     *
+     * This method allows depositing multiple validators to the Ethereum beacon chain
+     * using the Pier Two batch deposit contract for gas efficiency.
+     * Each deposit includes validator public key, withdrawal credentials, signature, and amount.
+     *
+     * @remarks
+     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
+     * and not pushed to version control.
+     *
+     * **⚠️ Gas Limit:** Due to EVM constraints, it is recommended to deposit in batches of up to 500 at a time.
+     *
+     * @param {EOADepositPayload} payload - Data needed to deposit to batch contract
+     * @returns {Promise<{txHashes: string[]}>} Array of transaction hashes for all batches
+     * @throws Will throw an error if the signer is not provided, contract is not configured, or the deposit fails
+     *
+     * An example of how to use deposit:
+     * ```typescript
+     * const result = await client.eoa.deposit({
+     *   deposits: [{
+     *     pubKey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *     withdrawalCredentials: '0x1234567890123456789012345678901234567890',
+     *     signature: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *     amount: '32000000000000000000' // 32 ETH in wei
+     *   }]
+     * });
+     * console.log('Deposits completed:', result.txHashes);
+     * ```
+     */
+    deposit(payload) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.signer) {
+                throw new Error('Signer is required in deposit');
+            }
+            const chainConfig = CHAIN_CONFIGURATION[this.chainId];
+            if (!((_a = chainConfig === null || chainConfig === void 0 ? void 0 : chainConfig.BATCH_DEPOSIT_CONTRACT) === null || _a === void 0 ? void 0 : _a.address)) {
+                throw new Error(`Batch deposit contract is not configured for chain ${this.chainId}`);
+            }
+            const validatedPayload = validatePayload(payload, eoaDepositPayloadSchema);
+            return yield submitEOABatchDeposit({
+                deposits: validatedPayload.deposits,
+                batchDepositContractAddress: chainConfig.BATCH_DEPOSIT_CONTRACT.address,
+                signer: this.signer,
+            });
+        });
+    }
 }

package/dist/esm/src/eoa/eoaHelpers.js

@@ -8,6 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { ETHER_TO_GWEI } from '../constants';
+import { Contract } from 'ethers';
+import { BatchDepositContract } from '../abi/BatchDeposit';
 /**
  * Helper function to submit withdrawal request for EOA
  */
@@ -31,3 +33,44 @@ export function submitEOAWithdrawalRequest({ pubkey, allocation, withdrawalAddre
         return { txHash: receipt.hash };
     });
 }
+/**
+ * Helper function to submit batch deposit request for EOA
+ */
+export function submitEOABatchDeposit({ deposits, batchDepositContractAddress, signer, }) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!deposits || deposits.length === 0) {
+            throw new Error('No deposits provided');
+        }
+        // Create contract instance
+        const batchDepositContract = new Contract(batchDepositContractAddress, BatchDepositContract.abi, signer);
+        const BATCH_SIZE = 500;
+        const txHashes = [];
+        try {
+            // Process deposits in batches of 500
+            for (let i = 0; i < deposits.length; i += BATCH_SIZE) {
+                const batchDeposits = deposits.slice(i, i + BATCH_SIZE);
+                // Calculate total value needed for this batch
+                const totalValue = batchDeposits.reduce((sum, deposit) => sum + BigInt(deposit.amount), BigInt(0));
+                // Prepare deposit data for this batch
+                const depositData = batchDeposits.map(deposit => ({
+                    pubKey: deposit.pubKey,
+                    withdrawalCredentials: deposit.withdrawalCredentials,
+                    signature: deposit.signature,
+                    amount: BigInt(deposit.amount),
+                }));
+                // Execute batch deposit for this batch
+                const tx = yield batchDepositContract.batchDeposit(depositData, {
+                    value: totalValue,
+                });
+                const receipt = yield tx.wait();
+                if (receipt === null || receipt === void 0 ? void 0 : receipt.hash) {
+                    txHashes.push(receipt.hash);
+                }
+            }
+            return { txHashes };
+        }
+        catch (error) {
+            throw new Error("Failed to submit batch deposit'}");
+        }
+    });
+}

package/dist/esm/src/index.js

@@ -135,9 +135,9 @@ export class Client extends Base {
                 throw new Error(`SPLITMAIN_CONTRACT is not configured for chain ${this.chainId}`);
             }
             const checkSplitMainAddress = yield isContractAvailable(chainConfig.SPLITMAIN_CONTRACT.address, this.signer.provider, chainConfig.SPLITMAIN_CONTRACT.bytecode);
-            const checkMulticallAddress = yield isContractAvailable(chainConfig.MULTICALL_CONTRACT.address, this.signer.provider, chainConfig.MULTICALL_CONTRACT.bytecode);
+            const checkMulticall3Address = yield isContractAvailable(chainConfig.MULTICALL3_CONTRACT.address, this.signer.provider, chainConfig.MULTICALL3_CONTRACT.bytecode);
             const checkOWRFactoryAddress = yield isContractAvailable(chainConfig.OWR_FACTORY_CONTRACT.address, this.signer.provider, chainConfig.OWR_FACTORY_CONTRACT.bytecode);
-            if (!checkMulticallAddress ||
+            if (!checkMulticall3Address ||
                 !checkSplitMainAddress ||
                 !checkOWRFactoryAddress) {
                 throw new Error(`Something isn not working as expected, check this issue with obol-sdk team on ${OBOL_SDK_EMAIL}`);

package/dist/esm/src/schema.js

@@ -255,3 +255,85 @@ export const eoaWithdrawalPayloadSchema = {
     },
     required: ['pubkey', 'allocation', 'requiredFee'],
 };
+export const ovmDepositPayloadSchema = {
+    type: 'object',
+    properties: {
+        ovmAddress: {
+            type: 'string',
+            pattern: '^0x[a-fA-F0-9]{40}$',
+        },
+        deposits: {
+            type: 'array',
+            minItems: 1,
+            items: {
+                type: 'object',
+                properties: {
+                    pubkey: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{96}$',
+                    },
+                    withdrawal_credentials: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{64}$',
+                        description: '32 bytes withdrawal credentials',
+                    },
+                    signature: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{192}$',
+                        description: '96 bytes signature (190 hex chars + 0x prefix)',
+                    },
+                    deposit_data_root: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{64}$', // 32 bytes = 64 hex chars + 0x prefix
+                    },
+                    amount: {
+                        type: 'string',
+                        pattern: '^[0-9]+$',
+                    },
+                },
+                required: [
+                    'pubkey',
+                    'withdrawal_credentials',
+                    'signature',
+                    'deposit_data_root',
+                    'amount',
+                ],
+            },
+        },
+    },
+    required: ['ovmAddress', 'deposits'],
+};
+export const eoaDepositPayloadSchema = {
+    type: 'object',
+    properties: {
+        deposits: {
+            type: 'array',
+            minItems: 1,
+            items: {
+                type: 'object',
+                properties: {
+                    pubKey: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{96}$',
+                    },
+                    withdrawalCredentials: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{64}$',
+                        description: '32 bytes withdrawal credentials',
+                    },
+                    signature: {
+                        type: 'string',
+                        pattern: '^0x[a-fA-F0-9]{192}$',
+                        description: '96 bytes signature (190 hex chars + 0x prefix)',
+                    },
+                    amount: {
+                        type: 'string',
+                        pattern: '^[0-9]+$',
+                    },
+                },
+                required: ['pubKey', 'withdrawalCredentials', 'signature', 'amount'],
+            },
+        },
+    },
+    required: ['deposits'],
+};

package/dist/esm/src/splits/splitHelpers.js

@@ -11,9 +11,9 @@ import { Contract, Interface, parseEther, ZeroAddress } from 'ethers';
 import { OWRContract, OWRFactoryContract } from '../abi/OWR';
 import { OVMFactoryContract, OVMContract } from '../abi/OVMFactory';
 import { splitMainEthereumAbi } from '../abi/SplitMain';
-import { MultiCallContract } from '../abi/Multicall';
 import { CHAIN_CONFIGURATION, ETHER_TO_GWEI } from '../constants';
 import { splitV2FactoryAbi } from '../abi/splitV2FactoryAbi';
+import { MultiCall3Contract } from '../abi/Multicall3';
 const splitMainContractInterface = new Interface(splitMainEthereumAbi);
 const owrFactoryContractInterface = new Interface(OWRFactoryContract.abi);
 const ovmFactoryContractInterface = new Interface(OVMFactoryContract.abi);
@@ -125,7 +125,7 @@ export const handleDeployOWRAndSplitter = ({ signer, isSplitterDeployed, predict
                 splitterAddress = result.splitterAddress;
             }
             catch (error) {
-                throw new Error(`Failed to deploy both splitter and OWR contracts: ${(_e = error.message) !== null && _e !== void 0 ? _e : 'Multicall contract deployment failed'}`);
+                throw new Error(`Failed to deploy both splitter and OWR contracts: ${(_e = error.message) !== null && _e !== void 0 ? _e : 'Multicall3 contract deployment failed'}`);
             }
             return {
                 withdrawal_address: owrAddress,
@@ -242,7 +242,7 @@ export const deploySplitterAndOWRContracts = ({ owrArgs, splitterArgs, signer, c
         target: getChainConfig(chainId).OWR_FACTORY_CONTRACT.address,
         callData: owrTxData,
     });
-    const executeMultiCalls = yield multicall(executeCalls, signer, chainId);
+    const executeMultiCalls = yield multicall3(executeCalls, signer, chainId);
     const splitAddressData = (_s = executeMultiCalls === null || executeMultiCalls === void 0 ? void 0 : executeMultiCalls.logs[0]) === null || _s === void 0 ? void 0 : _s.topics[1];
     const formattedSplitterAddress = '0x' + (splitAddressData === null || splitAddressData === void 0 ? void 0 : splitAddressData.slice(26, 66));
     const owrAddressData = (_t = executeMultiCalls === null || executeMultiCalls === void 0 ? void 0 : executeMultiCalls.logs[1]) === null || _t === void 0 ? void 0 : _t.topics[1];
@@ -282,39 +282,39 @@ export const getOWRTranches = ({ owrAddress, signer, }) => __awaiter(void 0, voi
         throw new Error(`Unexpected error in getOWRTranches: ${(_v = error.message) !== null && _v !== void 0 ? _v : 'Unknown error while fetching OWR tranche data'}`);
     }
 });
-export const multicall = (calls, signer, chainId) => __awaiter(void 0, void 0, void 0, function* () {
+export const multicall3 = (calls, signer, chainId) => __awaiter(void 0, void 0, void 0, function* () {
     var _w, _x, _y;
     try {
         const chainConfig = getChainConfig(chainId);
-        const multicallAddress = chainConfig.MULTICALL_CONTRACT.address;
-        const multiCallContractInstance = new Contract(multicallAddress, MultiCallContract.abi, signer);
+        const multicall3Address = chainConfig.MULTICALL3_CONTRACT.address;
+        const multiCall3ContractInstance = new Contract(multicall3Address, MultiCall3Contract.abi, signer);
         let tx;
         try {
-            tx = yield multiCallContractInstance.aggregate(calls);
+            tx = yield multiCall3ContractInstance.aggregate(calls);
         }
         catch (error) {
-            throw new Error(`Failed to submit multicall transaction: ${(_w = error.message) !== null && _w !== void 0 ? _w : 'Transaction submission failed'}`);
+            throw new Error(`Failed to submit multicall3 transaction: ${(_w = error.message) !== null && _w !== void 0 ? _w : 'Transaction submission failed'}`);
         }
         let receipt;
         try {
             receipt = yield tx.wait();
         }
         catch (error) {
-            throw new Error(`Multicall transaction failed or was reverted: ${(_x = error.message) !== null && _x !== void 0 ? _x : 'Transaction execution failed'}`);
+            throw new Error(`Multicall3 transaction failed or was reverted: ${(_x = error.message) !== null && _x !== void 0 ? _x : 'Transaction execution failed'}`);
         }
         if (!receipt) {
-            throw new Error('Multicall transaction succeeded but no receipt was returned');
+            throw new Error('Multicall3 transaction succeeded but no receipt was returned');
         }
         return receipt;
     }
     catch (error) {
         // Re-throw if it's already our custom error
         if (error.message.includes('Failed to') ||
-            error.message.includes('Multicall transaction')) {
+            error.message.includes('Multicall3 transaction')) {
             throw error;
         }
         // Handle unexpected errors
-        throw new Error(`Unexpected error in multicall: ${(_y = error.message) !== null && _y !== void 0 ? _y : 'Unknown error during multicall execution'}`);
+        throw new Error(`Unexpected error in multicall3: ${(_y = error.message) !== null && _y !== void 0 ? _y : 'Unknown error during multicall3 execution'}`);
     }
 });
 const encodeCreateSplitTxData = (accounts, percentAllocations, distributorFee, controller) => {
@@ -446,8 +446,8 @@ export const deployOVMAndSplitV2 = ({ ovmArgs, rewardRecipients, isRewardsSplitt
             target: chainConfig.OVM_FACTORY_CONTRACT.address,
             callData: ovmTxData,
         });
-        // Execute multicall
-        const executeMultiCalls = yield multicall(executeCalls, signer, chainId);
+        // Execute multicall3
+        const executeMultiCalls = yield multicall3(executeCalls, signer, chainId);
         // Extract addresses from events
         let ovmAddress;
         const logsCount = ((_7 = executeMultiCalls === null || executeMultiCalls === void 0 ? void 0 : executeMultiCalls.logs) === null || _7 === void 0 ? void 0 : _7.length) || 0;
@@ -461,7 +461,7 @@ export const deployOVMAndSplitV2 = ({ ovmArgs, rewardRecipients, isRewardsSplitt
             ovmAddress = '0x' + ((_13 = (_12 = executeMultiCalls === null || executeMultiCalls === void 0 ? void 0 : executeMultiCalls.logs[7]) === null || _12 === void 0 ? void 0 : _12.topics[1]) === null || _13 === void 0 ? void 0 : _13.slice(26, 66));
         }
         if (!ovmAddress) {
-            throw new Error('Failed to extract contract addresses from multicall events');
+            throw new Error('Failed to extract contract addresses from multicall3 events');
         }
         return ovmAddress;
     }
@@ -493,7 +493,6 @@ const getChainConfig = (chainId) => {
  * @returns Promise that resolves to the transaction hash
  */
 export const requestWithdrawalFromOVM = ({ ovmAddress, pubKeys, amounts, withdrawalFees, signer, }) => __awaiter(void 0, void 0, void 0, function* () {
-    var _15;
     try {
         // Convert string amounts to bigint
         const bigintAmounts = amounts.map(amount => BigInt(amount));
@@ -505,6 +504,51 @@ export const requestWithdrawalFromOVM = ({ ovmAddress, pubKeys, amounts, withdra
         return { txHash: receipt.hash };
     }
     catch (error) {
-        throw new Error(`Failed to request withdrawal from OVM: ${(_15 = error.message) !== null && _15 !== void 0 ? _15 : 'Request withdrawal failed'}`);
+        const errorMessage = error instanceof Error ? error.message : 'Request withdrawal failed';
+        throw new Error(`Failed to request withdrawal from OVM: ${errorMessage}`);
+    }
+});
+/**
+ * Deposits to OVM contract using multicall3 for batch operations
+ * @param ovmAddress - The address of the OVM contract
+ * @param deposits - Array of deposit objects with all required parameters
+ * @param signer - The signer to use for the transaction
+ * @returns Promise that resolves to an array of transaction hashes
+ */
+export const depositWithMulticall3 = ({ ovmAddress, deposits, signer, chainId, }) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const ovmContract = new Contract(ovmAddress, OVMContract.abi, signer);
+        const chainConfig = getChainConfig(chainId);
+        const multicall3Address = chainConfig.MULTICALL3_CONTRACT.address;
+        const multiCall3ContractInstance = new Contract(multicall3Address, MultiCall3Contract.abi, signer);
+        const BATCH_SIZE = 500;
+        const txHashes = [];
+        // Process deposits in batches of 500
+        for (let i = 0; i < deposits.length; i += BATCH_SIZE) {
+            const batchDeposits = deposits.slice(i, i + BATCH_SIZE);
+            // Use Multicall3 aggregate3Value (payable per-call)
+            const callsWithValue = batchDeposits.map(deposit => ({
+                target: ovmAddress,
+                allowFailure: false,
+                callData: ovmContract.interface.encodeFunctionData('deposit', [
+                    deposit.pubkey,
+                    deposit.withdrawal_credentials,
+                    deposit.signature,
+                    deposit.deposit_data_root,
+                ]),
+                value: BigInt(deposit.amount),
+            }));
+            const totalBatchValue = callsWithValue.reduce((sum, c) => sum + c.value, BigInt(0));
+            const tx = yield multiCall3ContractInstance.aggregate3Value(callsWithValue, { value: totalBatchValue });
+            const receipt = yield tx.wait();
+            if (receipt === null || receipt === void 0 ? void 0 : receipt.hash) {
+                txHashes.push(receipt.hash);
+            }
+        }
+        return { txHashes };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Deposit failed';
+        throw new Error(`Failed to deposit to OVM with multicall3: ${errorMessage}`);
     }
 });

package/dist/esm/src/splits/splits.js

@@ -7,9 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { formatRecipientsForSplitV2, predictSplitV2Address, isSplitV2Deployed, deployOVMContract, deployOVMAndSplitV2, requestWithdrawalFromOVM, } from './splitHelpers';
+import { formatRecipientsForSplitV2, predictSplitV2Address, isSplitV2Deployed, deployOVMContract, deployOVMAndSplitV2, requestWithdrawalFromOVM, depositWithMulticall3, } from './splitHelpers';
 import { CHAIN_CONFIGURATION, SPLITS_V2_SALT, DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT, isChainSupportedForSplitters, } from '../constants';
-import { ovmRewardsSplitPayloadSchema, ovmTotalSplitPayloadSchema, ovmRequestWithdrawalPayloadSchema, } from '../schema';
+import { ovmRewardsSplitPayloadSchema, ovmTotalSplitPayloadSchema, ovmRequestWithdrawalPayloadSchema, ovmDepositPayloadSchema, } from '../schema';
 import { validatePayload } from '../ajv';
 import { isContractAvailable } from '../utils';
 /**
@@ -62,21 +62,21 @@ export class ObolSplits {
             }
             const ovmFactoryConfig = chainConfig.OVM_FACTORY_CONTRACT;
             const splitV2FactoryConfig = chainConfig.SPLIT_V2_FACTORY_CONTRACT;
-            const multiCallConfig = chainConfig.MULTICALL_CONTRACT;
+            const multiCall3Config = chainConfig.MULTICALL3_CONTRACT;
             if (!(ovmFactoryConfig === null || ovmFactoryConfig === void 0 ? void 0 : ovmFactoryConfig.address) ||
                 !(ovmFactoryConfig === null || ovmFactoryConfig === void 0 ? void 0 : ovmFactoryConfig.bytecode) ||
                 !(splitV2FactoryConfig === null || splitV2FactoryConfig === void 0 ? void 0 : splitV2FactoryConfig.address) ||
                 !(splitV2FactoryConfig === null || splitV2FactoryConfig === void 0 ? void 0 : splitV2FactoryConfig.bytecode) ||
-                !(multiCallConfig === null || multiCallConfig === void 0 ? void 0 : multiCallConfig.address) ||
-                !(multiCallConfig === null || multiCallConfig === void 0 ? void 0 : multiCallConfig.bytecode)) {
+                !(multiCall3Config === null || multiCall3Config === void 0 ? void 0 : multiCall3Config.address) ||
+                !(multiCall3Config === null || multiCall3Config === void 0 ? void 0 : multiCall3Config.bytecode)) {
                 throw new Error(`Contracts configuration is incomplete for chain ${this.chainId}`);
             }
             const checkOVMFactoryContract = yield isContractAvailable(ovmFactoryConfig.address, this.provider, ovmFactoryConfig.bytecode);
             const checkSplitV2FactoryContract = yield isContractAvailable(splitV2FactoryConfig.address, this.provider, splitV2FactoryConfig.bytecode);
-            const checkMultiCallContract = yield isContractAvailable(multiCallConfig.address, this.provider, multiCallConfig.bytecode);
+            const checkMultiCall3Contract = yield isContractAvailable(multiCall3Config.address, this.provider, multiCall3Config.bytecode);
             if (!checkOVMFactoryContract ||
                 !checkSplitV2FactoryContract ||
-                !checkMultiCallContract) {
+                !checkMultiCall3Contract) {
                 throw new Error(`Splitter contract is not deployed or available on chain ${this.chainId}`);
             }
             const retroActiveFundingRecipient = {
@@ -178,21 +178,21 @@ export class ObolSplits {
             }
             const ovmFactoryConfig = chainConfig.OVM_FACTORY_CONTRACT;
             const splitV2FactoryConfig = chainConfig.SPLIT_V2_FACTORY_CONTRACT;
-            const multiCallConfig = chainConfig.MULTICALL_CONTRACT;
+            const multiCall3Config = chainConfig.MULTICALL3_CONTRACT;
             if (!(ovmFactoryConfig === null || ovmFactoryConfig === void 0 ? void 0 : ovmFactoryConfig.address) ||
                 !(ovmFactoryConfig === null || ovmFactoryConfig === void 0 ? void 0 : ovmFactoryConfig.bytecode) ||
                 !(splitV2FactoryConfig === null || splitV2FactoryConfig === void 0 ? void 0 : splitV2FactoryConfig.address) ||
                 !(splitV2FactoryConfig === null || splitV2FactoryConfig === void 0 ? void 0 : splitV2FactoryConfig.bytecode) ||
-                !(multiCallConfig === null || multiCallConfig === void 0 ? void 0 : multiCallConfig.address) ||
-                !(multiCallConfig === null || multiCallConfig === void 0 ? void 0 : multiCallConfig.bytecode)) {
+                !(multiCall3Config === null || multiCall3Config === void 0 ? void 0 : multiCall3Config.address) ||
+                !(multiCall3Config === null || multiCall3Config === void 0 ? void 0 : multiCall3Config.bytecode)) {
                 throw new Error(`Contracts configuration is incomplete for chain ${this.chainId}`);
             }
             const checkOVMFactoryContract = yield isContractAvailable(ovmFactoryConfig.address, this.provider, ovmFactoryConfig.bytecode);
             const checkSplitV2FactoryContract = yield isContractAvailable(splitV2FactoryConfig.address, this.provider, splitV2FactoryConfig.bytecode);
-            const checkMultiCallContract = yield isContractAvailable(multiCallConfig.address, this.provider, multiCallConfig.bytecode);
+            const checkMultiCall3Contract = yield isContractAvailable(multiCall3Config.address, this.provider, multiCall3Config.bytecode);
             if (!checkOVMFactoryContract ||
                 !checkSplitV2FactoryContract ||
-                !checkMultiCallContract) {
+                !checkMultiCall3Contract) {
                 throw new Error(`Splitter contract is not deployed or available on chain ${this.chainId}`);
             }
             const retroActiveFundingRecipient = {
@@ -252,7 +252,7 @@ export class ObolSplits {
                 };
             }
             else {
-                // Use multicall to deploy any contracts that aren't deployed
+                // Use multicall3 to deploy any contracts that aren't deployed
                 const ovmAddress = yield deployOVMAndSplitV2({
                     ovmArgs: {
                         OVMOwnerAddress: validatedPayload.OVMOwnerAddress,
@@ -316,4 +316,47 @@ export class ObolSplits {
             });
         });
     }
+    /**
+     * Deposits to OVM contract using multicall3 for batch operations.
+     *
+     * This method allows depositing to an OVM contract using multicall3 for efficient batch processing.
+     * Each deposit includes validator public key, withdrawal credentials, signature, deposit data root, and amount.
+     *
+     * @remarks
+     * **⚠️ Important:**  If you're storing the private key in an `.env` file, ensure it is securely managed
+     * and not pushed to version control.
+     *
+     * @param {OVMDepositPayload} payload - Data needed to deposit to OVM
+     * @returns {Promise<{txHashes: string[]}>} Array of transaction hashes for all batches
+     * @throws Will throw an error if the signer is not provided, OVM address is invalid, or the deposit fails
+     *
+     * An example of how to use deposit:
+     * ```typescript
+     * const result = await client.splits.deposit({
+     *   ovmAddress: '0x1234567890123456789012345678901234567890',
+     *   deposits: [{
+     *     pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *     withdrawal_credentials: '0x1234567890123456789012345678901234567890',
+     *     signature: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *     deposit_data_root: '0x1234567890123456789012345678901234567890123456789012345678901234',
+     *     amount: '32000000000000000000' // 32 ETH in wei
+     *   }]
+     * });
+     * console.log('Deposits completed:', result.txHashes);
+     * ```
+     */
+    deposit(payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.signer) {
+                throw new Error('Signer is required in deposit');
+            }
+            const validatedPayload = validatePayload(payload, ovmDepositPayloadSchema);
+            return yield depositWithMulticall3({
+                ovmAddress: validatedPayload.ovmAddress,
+                deposits: validatedPayload.deposits,
+                signer: this.signer,
+                chainId: this.chainId,
+            });
+        });
+    }
 }

package/dist/esm/test/eoa/eoa.spec.js

@@ -8,10 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { EOA } from '../../src/eoa/eoa';
-import { submitEOAWithdrawalRequest } from '../../src/eoa/eoaHelpers';
+import { submitEOAWithdrawalRequest, submitEOABatchDeposit, } from '../../src/eoa/eoaHelpers';
 // Mock the helper function
 jest.mock('../../src/eoa/eoaHelpers', () => ({
     submitEOAWithdrawalRequest: jest.fn(),
+    submitEOABatchDeposit: jest.fn(),
 }));
 describe('EOA', () => {
     let eoa;
@@ -93,4 +94,78 @@ describe('EOA', () => {
             expect(result).toEqual(mockResult);
         }));
     });
+    describe('deposit', () => {
+        const mockDeposits = [
+            {
+                pubKey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                withdrawalCredentials: '0x1234567890123456789012345678901234567890123456789012345678901234',
+                signature: '0x121234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012000000000000000000',
+                amount: '32000000000000000000', // 32 ETH in wei
+            },
+        ];
+        it('should successfully deposit to batch contract', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockPayload = {
+                deposits: mockDeposits,
+            };
+            const mockResult = {
+                txHashes: [
+                    '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
+                ],
+            };
+            submitEOABatchDeposit.mockResolvedValue(mockResult);
+            const result = yield eoa.deposit(mockPayload);
+            expect(submitEOABatchDeposit).toHaveBeenCalledWith({
+                deposits: mockDeposits,
+                batchDepositContractAddress: '0xcD7a6C118Ac8F6544BC5076F2D8Fb86D2C546756',
+                signer: mockSigner,
+            });
+            expect(result).toEqual(mockResult);
+        }));
+        it('should throw error when signer is not provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const eoaWithoutSigner = new EOA(undefined, 1, mockProvider);
+            const mockPayload = {
+                deposits: mockDeposits,
+            };
+            yield expect(eoaWithoutSigner.deposit(mockPayload)).rejects.toThrow('Signer is required in deposit');
+        }));
+        it('should throw error when batch deposit contract is not configured for chain', () => __awaiter(void 0, void 0, void 0, function* () {
+            const eoaUnsupportedChain = new EOA(mockSigner, 999, mockProvider);
+            const mockPayload = {
+                deposits: mockDeposits,
+            };
+            yield expect(eoaUnsupportedChain.deposit(mockPayload)).rejects.toThrow('Batch deposit contract is not configured for chain 999');
+        }));
+        it('should handle multiple deposits', () => __awaiter(void 0, void 0, void 0, function* () {
+            const multipleDeposits = [
+                {
+                    pubKey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                    withdrawalCredentials: '0x1234567890123456789012345678901234567890123456789012345678901234',
+                    signature: '0x121234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012000000000000000000',
+                    amount: '32000000000000000000',
+                },
+                {
+                    pubKey: '0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdcd',
+                    withdrawalCredentials: '0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd',
+                    signature: '0x121234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012000000000000000000',
+                    amount: '16000000000000000000',
+                },
+            ];
+            const mockPayload = {
+                deposits: multipleDeposits,
+            };
+            const mockResult = {
+                txHashes: [
+                    '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
+                ],
+            };
+            submitEOABatchDeposit.mockResolvedValue(mockResult);
+            const result = yield eoa.deposit(mockPayload);
+            expect(submitEOABatchDeposit).toHaveBeenCalledWith({
+                deposits: multipleDeposits,
+                batchDepositContractAddress: '0xcD7a6C118Ac8F6544BC5076F2D8Fb86D2C546756',
+                signer: mockSigner,
+            });
+            expect(result).toEqual(mockResult);
+        }));
+    });
 });