@obolnetwork/obol-sdk 2.9.0 → 2.10.0

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@obolnetwork/obol-sdk",
-    "version": "2.9.0",
+    "version": "2.10.0",
     "description": "A package for creating Distributed Validators using the Obol API.",
     "bugs": {
         "url": "https://github.com/obolnetwork/obol-sdk/issues"

package/dist/cjs/src/ajv.js

@@ -68,7 +68,6 @@ const validateOVMTotalSplitRecipients = (_, data) => {
     return validateTotalPercentage(splitPercentage);
 };
 const validateOVMRequestWithdrawalPayload = (_, data) => {
-    console.log(data, 'hanaaan dataaaa');
     if (!data.pubKeys || !data.amounts) {
         return false;
     }

package/dist/cjs/src/constants.js

@@ -171,6 +171,9 @@ exports.CHAIN_CONFIGURATION = {
             address: '0x5cbA88D55Cec83caD5A105Ad40C8c9aF20bE21d1',
             bytecode: bytecodes_1.MAINNET_SPLIT_V2_FACTORY_BYTECODE,
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
     [types_1.FORK_MAPPING['0x01017000']]: {
         SPLITMAIN_CONTRACT: {
@@ -189,6 +192,9 @@ exports.CHAIN_CONFIGURATION = {
             address: '0x43F641fA70e09f0326ac66b4Ef0C416EaEcBC6f5',
             bytecode: '',
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
     [types_1.FORK_MAPPING['0x10000910']]: {
         SPLITMAIN_CONTRACT: {
@@ -220,6 +226,9 @@ exports.CHAIN_CONFIGURATION = {
             address: '0x5cbA88D55Cec83caD5A105Ad40C8c9aF20bE21d1',
             bytecode: bytecodes_1.HOODI_SPLIT_V2_FACTORY_BYTECODE,
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
 };
 exports.DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT = 1;

package/dist/cjs/src/eoa/eoa.js

@@ -0,0 +1,83 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EOA = void 0;
+const eoaHelpers_1 = require("./eoaHelpers");
+const ajv_1 = require("../ajv");
+const schema_1 = require("../schema");
+const constants_1 = require("../constants");
+/**
+ * EOA can be used for managing EOA (Externally Owned Account) operations like withdrawals.
+ * @class
+ * @internal Access it through Client.eoa.
+ * @example
+ * const obolClient = new Client(config);
+ * await obolClient.eoa.requestWithdrawal(EOAWithdrawalPayload);
+ */
+class EOA {
+    constructor(signer, chainId, provider) {
+        this.signer = signer;
+        this.chainId = chainId;
+        this.provider = provider;
+    }
+    /**
+     * Requests withdrawal from an EOA contract.
+     *
+     * This method allows requesting withdrawal of validator funds.
+     * The withdrawal request includes validator public key and corresponding withdrawal 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 {EOAWithdrawalPayload} payload - Data needed to request withdrawal
+     * @returns {Promise<{txHash: string}>} Transaction hash of the withdrawal request
+     * @throws Will throw an error if the signer is not provided or the request fails
+     *
+     * An example of how to use requestWithdrawal:
+     * ```typescript
+     * const result = await client.eoa.requestWithdrawal({
+     *   pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *   allocation: 32, // 32 ETH
+     *   requiredFee: '1' // in wei
+     * });
+     * console.log('Withdrawal requested:', result.txHash);
+     * ```
+     */
+    requestWithdrawal(payload) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.signer) {
+                throw new Error('Signer is required in requestWithdrawal');
+            }
+            if (!this.provider) {
+                throw new Error('Provider is required in requestWithdrawal');
+            }
+            const chainConfig = constants_1.CHAIN_CONFIGURATION[this.chainId];
+            if (!((_a = chainConfig === null || chainConfig === void 0 ? void 0 : chainConfig.EOA_WITHDRAWAL_CONTRACT) === null || _a === void 0 ? void 0 : _a.address)) {
+                throw new Error(`EOA withdrawal contract is not configured for chain ${this.chainId}`);
+            }
+            const validatedPayload = (0, ajv_1.validatePayload)(payload, schema_1.eoaWithdrawalPayloadSchema);
+            const withdrawalAddress = yield this.signer.getAddress();
+            return yield (0, eoaHelpers_1.submitEOAWithdrawalRequest)({
+                pubkey: validatedPayload.pubkey,
+                allocation: validatedPayload.allocation,
+                withdrawalAddress,
+                withdrawalContractAddress: chainConfig.EOA_WITHDRAWAL_CONTRACT.address,
+                requiredFee: validatedPayload.requiredFee,
+                chainId: this.chainId,
+                signer: this.signer,
+                provider: this.provider,
+            });
+        });
+    }
+}
+exports.EOA = EOA;

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

@@ -0,0 +1,37 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitEOAWithdrawalRequest = void 0;
+const constants_1 = require("../constants");
+/**
+ * Helper function to submit withdrawal request for EOA
+ */
+function submitEOAWithdrawalRequest({ pubkey, allocation, withdrawalAddress, withdrawalContractAddress, requiredFee, chainId, signer, provider, }) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!withdrawalAddress)
+            throw new Error('No withdrawal address provided');
+        if (!allocation)
+            throw new Error('No allocation provided');
+        const amountInGwei = BigInt(Math.floor(Number(allocation) * constants_1.ETHER_TO_GWEI));
+        const data = `0x${pubkey.slice(2)}${amountInGwei.toString(16).padStart(16, '0')}`;
+        const { hash } = yield signer.sendTransaction({
+            to: withdrawalContractAddress,
+            chainId,
+            value: BigInt(requiredFee),
+            data: data,
+        });
+        const txResult = yield provider.getTransactionReceipt(hash);
+        if (!txResult)
+            return { txHash: null };
+        return { txHash: txResult === null || txResult === void 0 ? void 0 : txResult.hash };
+    });
+}
+exports.submitEOAWithdrawalRequest = submitEOAWithdrawalRequest;

package/dist/cjs/src/index.js

@@ -23,7 +23,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.ObolSplits = exports.Exit = exports.Incentives = void 0;
+exports.Client = exports.EOA = exports.ObolSplits = exports.Exit = exports.Incentives = void 0;
 const uuid_1 = require("uuid");
 const base_js_1 = require("./base.js");
 const constants_js_1 = require("./constants.js");
@@ -36,6 +36,7 @@ const utils_js_1 = require("./utils.js");
 const incentives_js_1 = require("./incentives/incentives.js");
 const exit_js_1 = require("./exits/exit.js");
 const splits_js_1 = require("./splits/splits.js");
+const eoa_js_1 = require("./eoa/eoa.js");
 __exportStar(require("./types.js"), exports);
 __exportStar(require("./services.js"), exports);
 __exportStar(require("./verification/signature-validator.js"), exports);
@@ -47,6 +48,8 @@ var exit_js_2 = require("./exits/exit.js");
 Object.defineProperty(exports, "Exit", { enumerable: true, get: function () { return exit_js_2.Exit; } });
 var splits_js_2 = require("./splits/splits.js");
 Object.defineProperty(exports, "ObolSplits", { enumerable: true, get: function () { return splits_js_2.ObolSplits; } });
+var eoa_js_2 = require("./eoa/eoa.js");
+Object.defineProperty(exports, "EOA", { enumerable: true, get: function () { return eoa_js_2.EOA; } });
 /**
  * Obol sdk Client can be used for creating, managing and activating distributed validators.
  */
@@ -70,6 +73,7 @@ class Client extends base_js_1.Base {
         this.incentives = new incentives_js_1.Incentives(this.signer, this.chainId, this.request.bind(this), this.provider);
         this.exit = new exit_js_1.Exit(this.chainId, this.provider);
         this.splits = new splits_js_1.ObolSplits(this.signer, this.chainId, this.provider);
+        this.eoa = new eoa_js_1.EOA(this.signer, this.chainId, this.provider);
     }
     /**
      * Accepts Obol terms and conditions to be able to create or update data.

package/dist/cjs/src/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ovmRequestWithdrawalPayloadSchema = exports.ovmTotalSplitPayloadSchema = exports.ovmRewardsSplitPayloadSchema = exports.ovmBaseSplitPayload = exports.rewardsSplitterPayloadSchema = exports.totalSplitterPayloadSchema = exports.definitionSchema = exports.operatorPayloadSchema = void 0;
+exports.eoaWithdrawalPayloadSchema = exports.ovmRequestWithdrawalPayloadSchema = exports.ovmTotalSplitPayloadSchema = exports.ovmRewardsSplitPayloadSchema = exports.ovmBaseSplitPayload = exports.rewardsSplitterPayloadSchema = exports.totalSplitterPayloadSchema = exports.definitionSchema = exports.operatorPayloadSchema = void 0;
 const ethers_1 = require("ethers");
 const constants_1 = require("./constants");
 const ajv_1 = require("./ajv");
@@ -212,6 +212,10 @@ exports.ovmTotalSplitPayloadSchema = {
 exports.ovmRequestWithdrawalPayloadSchema = {
     type: 'object',
     properties: {
+        withdrawalFees: {
+            type: 'string',
+            pattern: '^[0-9]+$',
+        },
         ovmAddress: {
             type: 'string',
             pattern: '^0x[a-fA-F0-9]{40}$',
@@ -234,5 +238,23 @@ exports.ovmRequestWithdrawalPayloadSchema = {
         },
     },
     validateOVMRequestWithdrawalPayload: true,
-    required: ['ovmAddress', 'pubKeys', 'amounts'],
+    required: ['ovmAddress', 'pubKeys', 'amounts', 'withdrawalFees'],
+};
+exports.eoaWithdrawalPayloadSchema = {
+    type: 'object',
+    properties: {
+        pubkey: {
+            type: 'string',
+            pattern: '^0x[a-fA-F0-9]{96}$', // 48 bytes = 96 hex chars + 0x prefix
+        },
+        allocation: {
+            type: 'number',
+            minimum: 0,
+        },
+        requiredFee: {
+            type: 'string',
+            pattern: '^[0-9]+$',
+        },
+    },
+    required: ['pubkey', 'allocation', 'requiredFee'],
 };

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

@@ -410,7 +410,7 @@ const deployOVMContract = ({ OVMOwnerAddress, principalRecipient, rewardRecipien
             throw new Error(`OVM Factory not configured for chain ${chainId}`);
         }
         const ovmFactoryContract = new ethers_1.Contract(chainConfig.OVM_FACTORY_CONTRACT.address, OVMFactory_1.OVMFactoryContract.abi, signer);
-        const tx = yield ovmFactoryContract.createObolValidatorManager(OVMOwnerAddress, principalRecipient, rewardRecipient, principalThreshold);
+        const tx = yield ovmFactoryContract.createObolValidatorManager(OVMOwnerAddress, principalRecipient, rewardRecipient, principalThreshold * constants_1.ETHER_TO_GWEI);
         const receipt = yield tx.wait();
         // Extract OVM address from logs
         const ovmAddressLog = (_3 = receipt === null || receipt === void 0 ? void 0 : receipt.logs[1]) === null || _3 === void 0 ? void 0 : _3.topics[1];
@@ -455,7 +455,7 @@ const deployOVMAndSplitV2 = ({ ovmArgs, rewardRecipients, isRewardsSplitterDeplo
             });
         }
         // Create OVM call data
-        const ovmTxData = encodeCreateOVMTxData(ovmArgs.OVMOwnerAddress, ovmArgs.principalRecipient, ovmArgs.rewardRecipient, ovmArgs.principalThreshold);
+        const ovmTxData = encodeCreateOVMTxData(ovmArgs.OVMOwnerAddress, ovmArgs.principalRecipient, ovmArgs.rewardRecipient, ovmArgs.principalThreshold * constants_1.ETHER_TO_GWEI);
         executeCalls.push({
             target: chainConfig.OVM_FACTORY_CONTRACT.address,
             callData: ovmTxData,
@@ -507,13 +507,15 @@ const getChainConfig = (chainId) => {
  * @param signer - The signer to use for the transaction
  * @returns Promise that resolves to the transaction hash
  */
-const requestWithdrawalFromOVM = ({ ovmAddress, pubKeys, amounts, signer, }) => __awaiter(void 0, void 0, void 0, function* () {
+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));
         const ovmContract = new ethers_1.Contract(ovmAddress, OVMFactory_1.OVMContract.abi, signer);
-        const tx = yield ovmContract.requestWithdrawal(pubKeys, bigintAmounts);
+        const tx = yield ovmContract.requestWithdrawal(pubKeys, bigintAmounts, {
+            value: BigInt(withdrawalFees),
+        });
         const receipt = yield tx.wait();
         return { txHash: receipt.hash };
     }

package/dist/cjs/src/splits/splits.js

@@ -314,6 +314,7 @@ class ObolSplits {
                 ovmAddress: validatedPayload.ovmAddress,
                 pubKeys: validatedPayload.pubKeys,
                 amounts: validatedPayload.amounts,
+                withdrawalFees: validatedPayload.withdrawalFees,
                 signer: this.signer,
             });
         });

package/dist/cjs/test/client/ajv.spec.js

@@ -274,6 +274,7 @@ describe('ovmRequestWithdrawalPayloadSchema', () => {
             '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
         ],
         amounts: ['32000000000'],
+        withdrawalFees: '1',
     };
     it('should throw error when OVM address is missing', () => {
         const payload = {
@@ -288,14 +289,32 @@ describe('ovmRequestWithdrawalPayloadSchema', () => {
             pubKeys: validPayload.pubKeys,
             amounts: validPayload.amounts,
         };
-        expect(() => (0, ajv_1.validatePayload)(payload, schema_1.ovmRequestWithdrawalPayloadSchema)).toThrow('Validation failed: /ovmAddress must match pattern');
+        expect(() => (0, ajv_1.validatePayload)(payload, schema_1.ovmRequestWithdrawalPayloadSchema)).toThrow('Validation failed:  must have required property \'withdrawalFees\', /ovmAddress must match pattern "^0x[a-fA-F0-9]{40}$"');
     });
     it('should throw error when number of public keys does not match number of amounts', () => {
         const payload = {
             ovmAddress: validPayload.ovmAddress,
             pubKeys: validPayload.pubKeys,
             amounts: ['32000000000', '16000000000'], // 2 amounts, 1 pubKey
+            withdrawalFees: validPayload.withdrawalFees,
         };
         expect(() => (0, ajv_1.validatePayload)(payload, schema_1.ovmRequestWithdrawalPayloadSchema)).toThrow('Validation failed:  must pass "validateOVMRequestWithdrawalPayload" keyword validation');
     });
+    it('should throw error when withdrawalFees is missing', () => {
+        const payload = {
+            ovmAddress: validPayload.ovmAddress,
+            pubKeys: validPayload.pubKeys,
+            amounts: validPayload.amounts,
+        };
+        expect(() => (0, ajv_1.validatePayload)(payload, schema_1.ovmRequestWithdrawalPayloadSchema)).toThrow("Validation failed:  must have required property 'withdrawalFees'");
+    });
+    it('should throw error when withdrawalFees is invalid', () => {
+        const payload = {
+            ovmAddress: validPayload.ovmAddress,
+            pubKeys: validPayload.pubKeys,
+            amounts: validPayload.amounts,
+            withdrawalFees: 'invalid',
+        };
+        expect(() => (0, ajv_1.validatePayload)(payload, schema_1.ovmRequestWithdrawalPayloadSchema)).toThrow('Validation failed: /withdrawalFees must match pattern "^[0-9]+$"');
+    });
 });

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

@@ -0,0 +1,87 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const eoa_1 = require("../../src/eoa/eoa");
+const eoaHelpers_1 = require("../../src/eoa/eoaHelpers");
+// Mock the helper function
+jest.mock('../../src/eoa/eoaHelpers', () => ({
+    submitEOAWithdrawalRequest: jest.fn(),
+}));
+describe('EOA', () => {
+    let eoa;
+    let mockSigner;
+    let mockProvider;
+    beforeEach(() => {
+        // Clear all mocks before each test
+        jest.clearAllMocks();
+        mockSigner = {
+            getAddress: jest
+                .fn()
+                .mockResolvedValue('0x1234567890123456789012345678901234567890'),
+        };
+        mockProvider = {
+            getNetwork: jest.fn().mockResolvedValue({ chainId: 1 }),
+        };
+        eoa = new eoa_1.EOA(mockSigner, 1, mockProvider);
+    });
+    describe('requestWithdrawal', () => {
+        it('should successfully request withdrawal', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockPayload = {
+                pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                allocation: 32,
+                requiredFee: '1',
+            };
+            const mockResult = {
+                txHash: '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
+            };
+            eoaHelpers_1.submitEOAWithdrawalRequest.mockResolvedValue(mockResult);
+            const result = yield eoa.requestWithdrawal(mockPayload);
+            expect(eoaHelpers_1.submitEOAWithdrawalRequest).toHaveBeenCalledWith({
+                pubkey: mockPayload.pubkey,
+                allocation: mockPayload.allocation,
+                withdrawalAddress: '0x1234567890123456789012345678901234567890',
+                withdrawalContractAddress: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+                requiredFee: mockPayload.requiredFee,
+                chainId: 1,
+                signer: mockSigner,
+                provider: mockProvider,
+            });
+            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_1.EOA(undefined, 1, mockProvider);
+            const mockPayload = {
+                pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                allocation: 32,
+                requiredFee: '1',
+            };
+            yield expect(eoaWithoutSigner.requestWithdrawal(mockPayload)).rejects.toThrow('Signer is required in requestWithdrawal');
+        }));
+        it('should throw error when provider is not provided', () => __awaiter(void 0, void 0, void 0, function* () {
+            const eoaWithoutProvider = new eoa_1.EOA(mockSigner, 1, null);
+            const mockPayload = {
+                pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                allocation: 32,
+                requiredFee: '1',
+            };
+            yield expect(eoaWithoutProvider.requestWithdrawal(mockPayload)).rejects.toThrow('Provider is required in requestWithdrawal');
+        }));
+        it('should throw error when EOA withdrawal contract is not configured for chain', () => __awaiter(void 0, void 0, void 0, function* () {
+            const eoaUnsupportedChain = new eoa_1.EOA(mockSigner, 999, mockProvider);
+            const mockPayload = {
+                pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+                allocation: 32,
+                requiredFee: '1',
+            };
+            yield expect(eoaUnsupportedChain.requestWithdrawal(mockPayload)).rejects.toThrow('EOA withdrawal contract is not configured for chain 999');
+        }));
+    });
+});

package/dist/cjs/test/splits/splits.spec.js

@@ -246,6 +246,7 @@ describe('ObolSplits', () => {
                 ovmAddress: mockOVMAddress,
                 pubKeys: mockPubKeys,
                 amounts: mockAmounts,
+                withdrawalFees: '1',
             });
             expect(result).toEqual({
                 txHash: '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
@@ -254,6 +255,7 @@ describe('ObolSplits', () => {
                 ovmAddress: mockOVMAddress,
                 pubKeys: mockPubKeys,
                 amounts: mockAmounts,
+                withdrawalFees: '1',
                 signer: mockSigner,
             });
         }));
@@ -263,6 +265,7 @@ describe('ObolSplits', () => {
                 ovmAddress: mockOVMAddress,
                 pubKeys: mockPubKeys,
                 amounts: mockAmounts,
+                withdrawalFees: '1',
             })).rejects.toThrow('Signer is required in requestWithdrawal');
         }));
         // it('should throw error when amount is below minimum (1,000,000 gwei)', async () => {
@@ -290,6 +293,7 @@ describe('ObolSplits', () => {
                 ovmAddress: mockOVMAddress,
                 pubKeys: multiplePubKeys,
                 amounts: multipleAmounts,
+                withdrawalFees: '1',
             });
             expect(result).toEqual({
                 txHash: '0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
@@ -298,6 +302,7 @@ describe('ObolSplits', () => {
                 ovmAddress: mockOVMAddress,
                 pubKeys: multiplePubKeys,
                 amounts: multipleAmounts,
+                withdrawalFees: '1',
                 signer: mockSigner,
             });
         }));

package/dist/esm/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@obolnetwork/obol-sdk",
-    "version": "2.9.0",
+    "version": "2.10.0",
     "description": "A package for creating Distributed Validators using the Obol API.",
     "bugs": {
         "url": "https://github.com/obolnetwork/obol-sdk/issues"

package/dist/esm/src/ajv.js

@@ -62,7 +62,6 @@ const validateOVMTotalSplitRecipients = (_, data) => {
     return validateTotalPercentage(splitPercentage);
 };
 const validateOVMRequestWithdrawalPayload = (_, data) => {
-    console.log(data, 'hanaaan dataaaa');
     if (!data.pubKeys || !data.amounts) {
         return false;
     }

package/dist/esm/src/constants.js

@@ -137,6 +137,9 @@ export const CHAIN_CONFIGURATION = {
             address: '0x5cbA88D55Cec83caD5A105Ad40C8c9aF20bE21d1',
             bytecode: MAINNET_SPLIT_V2_FACTORY_BYTECODE,
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
     [FORK_MAPPING['0x01017000']]: {
         SPLITMAIN_CONTRACT: {
@@ -155,6 +158,9 @@ export const CHAIN_CONFIGURATION = {
             address: '0x43F641fA70e09f0326ac66b4Ef0C416EaEcBC6f5',
             bytecode: '',
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
     [FORK_MAPPING['0x10000910']]: {
         SPLITMAIN_CONTRACT: {
@@ -186,6 +192,9 @@ export const CHAIN_CONFIGURATION = {
             address: '0x5cbA88D55Cec83caD5A105Ad40C8c9aF20bE21d1',
             bytecode: HOODI_SPLIT_V2_FACTORY_BYTECODE,
         },
+        EOA_WITHDRAWAL_CONTRACT: {
+            address: '0x00000961Ef480Eb55e80D19ad83579A64c007002',
+        },
     },
 };
 export const DEFAULT_RETROACTIVE_FUNDING_REWARDS_ONLY_SPLIT = 1;

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

@@ -0,0 +1,79 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { submitEOAWithdrawalRequest } from './eoaHelpers';
+import { validatePayload } from '../ajv';
+import { eoaWithdrawalPayloadSchema } from '../schema';
+import { CHAIN_CONFIGURATION } from '../constants';
+/**
+ * EOA can be used for managing EOA (Externally Owned Account) operations like withdrawals.
+ * @class
+ * @internal Access it through Client.eoa.
+ * @example
+ * const obolClient = new Client(config);
+ * await obolClient.eoa.requestWithdrawal(EOAWithdrawalPayload);
+ */
+export class EOA {
+    constructor(signer, chainId, provider) {
+        this.signer = signer;
+        this.chainId = chainId;
+        this.provider = provider;
+    }
+    /**
+     * Requests withdrawal from an EOA contract.
+     *
+     * This method allows requesting withdrawal of validator funds.
+     * The withdrawal request includes validator public key and corresponding withdrawal 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 {EOAWithdrawalPayload} payload - Data needed to request withdrawal
+     * @returns {Promise<{txHash: string}>} Transaction hash of the withdrawal request
+     * @throws Will throw an error if the signer is not provided or the request fails
+     *
+     * An example of how to use requestWithdrawal:
+     * ```typescript
+     * const result = await client.eoa.requestWithdrawal({
+     *   pubkey: '0x123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456',
+     *   allocation: 32, // 32 ETH
+     *   requiredFee: '1' // in wei
+     * });
+     * console.log('Withdrawal requested:', result.txHash);
+     * ```
+     */
+    requestWithdrawal(payload) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.signer) {
+                throw new Error('Signer is required in requestWithdrawal');
+            }
+            if (!this.provider) {
+                throw new Error('Provider is required in requestWithdrawal');
+            }
+            const chainConfig = CHAIN_CONFIGURATION[this.chainId];
+            if (!((_a = chainConfig === null || chainConfig === void 0 ? void 0 : chainConfig.EOA_WITHDRAWAL_CONTRACT) === null || _a === void 0 ? void 0 : _a.address)) {
+                throw new Error(`EOA withdrawal contract is not configured for chain ${this.chainId}`);
+            }
+            const validatedPayload = validatePayload(payload, eoaWithdrawalPayloadSchema);
+            const withdrawalAddress = yield this.signer.getAddress();
+            return yield submitEOAWithdrawalRequest({
+                pubkey: validatedPayload.pubkey,
+                allocation: validatedPayload.allocation,
+                withdrawalAddress,
+                withdrawalContractAddress: chainConfig.EOA_WITHDRAWAL_CONTRACT.address,
+                requiredFee: validatedPayload.requiredFee,
+                chainId: this.chainId,
+                signer: this.signer,
+                provider: this.provider,
+            });
+        });
+    }
+}

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

@@ -0,0 +1,33 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ETHER_TO_GWEI } from '../constants';
+/**
+ * Helper function to submit withdrawal request for EOA
+ */
+export function submitEOAWithdrawalRequest({ pubkey, allocation, withdrawalAddress, withdrawalContractAddress, requiredFee, chainId, signer, provider, }) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!withdrawalAddress)
+            throw new Error('No withdrawal address provided');
+        if (!allocation)
+            throw new Error('No allocation provided');
+        const amountInGwei = BigInt(Math.floor(Number(allocation) * ETHER_TO_GWEI));
+        const data = `0x${pubkey.slice(2)}${amountInGwei.toString(16).padStart(16, '0')}`;
+        const { hash } = yield signer.sendTransaction({
+            to: withdrawalContractAddress,
+            chainId,
+            value: BigInt(requiredFee),
+            data: data,
+        });
+        const txResult = yield provider.getTransactionReceipt(hash);
+        if (!txResult)
+            return { txHash: null };
+        return { txHash: txResult === null || txResult === void 0 ? void 0 : txResult.hash };
+    });
+}

package/dist/esm/src/index.js

@@ -19,6 +19,7 @@ import { isContractAvailable } from './utils.js';
 import { Incentives } from './incentives/incentives.js';
 import { Exit } from './exits/exit.js';
 import { ObolSplits } from './splits/splits.js';
+import { EOA } from './eoa/eoa.js';
 export * from './types.js';
 export * from './services.js';
 export * from './verification/signature-validator.js';
@@ -27,6 +28,7 @@ export * from './constants.js';
 export { Incentives } from './incentives/incentives.js';
 export { Exit } from './exits/exit.js';
 export { ObolSplits } from './splits/splits.js';
+export { EOA } from './eoa/eoa.js';
 /**
  * Obol sdk Client can be used for creating, managing and activating distributed validators.
  */
@@ -50,6 +52,7 @@ export class Client extends Base {
         this.incentives = new Incentives(this.signer, this.chainId, this.request.bind(this), this.provider);
         this.exit = new Exit(this.chainId, this.provider);
         this.splits = new ObolSplits(this.signer, this.chainId, this.provider);
+        this.eoa = new EOA(this.signer, this.chainId, this.provider);
     }
     /**
      * Accepts Obol terms and conditions to be able to create or update data.