/stakingEthWithGalaxy

1 min

POST

Creates Galaxy validators and stakes an individual transaction or can batch up to 100 transactions in one process and function call. The withdrawal type of Pre or Post Pectra fork must also be set. All Pre Pectra fork transactions must be 32 ETH. While Post Pectra fork transactions require a minimum of 32 ETH, and can be any value that is a multiple of 1 ETH, up to 2048 ETH. Withdrawal credentials are set to the MPC main Ethereum address in uMPC-only mode, or the cold Ethereum address if the Impenetrable Vault is installed.

There is a dynamic wait time before stakes appear on-chain. See Validator Queue for the current entry queue state. Return: JSON object containing staking details.

Input example:

            stakingEthWithGalaxy(
                   account_id=1,
                   gas_price=1000000000,
                   gas_limit=100000,
                   max_priority_fee=1030899,
                   amounts=[32000000000000000000,35000000000000000000,63000000000000000000, 2048000000000000000000],
                   withdrawal_type=EthWithdrawalCredentialsType.PostPectraFork,
                   customer_id="cust123",
                   region="EU",
                   validate_transaction=True
               )

-------------------- Response --------------------
{
    "FunctionData": {
        "StakingRefId": "6a5f...160",
        "ValidatorPublicKeys": [
            "0x8c...3c45"
        ]
    },
    "Meta": {
        "AccessToken": "627...fe",
        "Destination": "0453...49d56",
        "Source": "fc581...442f3",
        "Time": "2025-02-10 13:05:23.729"
    }
}

-------------------- Error Reference --------------------

Error Type	Error Code	Reason / Description
Python Assertion	–	Amount cannot be zero.
Python Assertion	–	The provided amount is not a valid multiple of 32 ETH (32,000,000,000,000,000,000 wei).
Backend Response	1000	Galaxy request failed. The response includes the error returned by Galaxy.

account_idintegerThe user defined GK8 account ID that holds the ETH for staking. The ETH is deposited from this account’s uMPC address to the Galaxy validator(s) account, and withdrawn from this account to the Impenetrable Vault address. The range is limited to the number of user defined accounts.

gas_priceintegerThe gas price to transfer with, in Wei. In London fork currencies, this is the maximum fee to pay per gas unit.

gas_limitintegerThe gas limit to transfer, in gas units. Must be at least <code>21001</code>.

max_priority_feeintegerThe maximum priority fee to tip the validator.

amountsarrayThe amount of ETH to stake, in Wei. Must be a minimum of <code>"32000000000000000000"</code> Wei (32 ETH), a multiple of "1000000000000000000" Wei, and can be a maximum of "2048000000000000000000" Wei which can be used for up to 100 stakes at a time.

customer_idstring(Optional) A unique identifier assigned internally to group validators under a specific customer. This ID can be used to organize validators and to reference the group in future queries.

regionstring(Optional) The geographic area for the validator machines. Must be either <code>"US"</code>, <code>"KR"</code> or <code>"EU"</code>. Defaults to <code>"EU"</code>.

validate_transactionbooleanIf <code>True</code>, this validates that the stake transaction succeeded or provides failure reasons if the stake is unsuccessful. Setting as “False” disables the validation process and saves time but does not provide failure details. Defaults to <code>True</code>.

withdrawal_typestringThe withdrawal credential type of the validator(s) to be created. This value is an ENUM either EthWithdrawalCredentialsType.PostPectraFork (can stake between 32 and 2048 ETH per transaction) or EthWithdrawalCredentialsType.PrePectraFork (can only stake 32 ETH per transaction). EthWithdrawalCredentialsType.PostPectraFork supports larger validator balances, compounding rewards, partial withdrawals, and validator consolidation, while EthWithdrawalCredentialsType.PrePectraFork offers a cheaper, more straightforward secure setup where withdrawals go directly to a fixed Ethereum address.

specificFromAddressstringThe specific deposit address to send from. Cannot be used if the account is defined as an Omnibus account.

acceptstringGenerated from available response content types

200success

curl --request POST \
     --url '/stakingEthWithGalaxy?account_id=1&gas_price=1&gas_limit=21500&max_priority_fee=1&amounts=array&customer_id=string&region=string&validate_transaction=true&withdrawal_type=EthWithdrawalCredentialsType.PostPectraFork&specificFromAddress=3Qnv1fyqhSaptkxJrC9ruNfpSCB1Srmkg3' \
     --header 'accept: application/json'