Generate unsigned ETH staking transaction

post

https://api.contributiondao.com/api/v1.0/ethereum/transactions/stake

Generates an unsigned Ethereum transaction for creating new validators.
This endpoint is designed for custodian services to retrieve the necessary transaction details (payload),
review them, and sign the transaction offline using their secure key management system.

The generated transaction will deposit 32 ETH per validator.

Important Note on Rewards & Fees:
The distribution of rewards is calculated based on clientBasisPoints and referrerBasisPoints.

The sum of clientBasisPoints + referrerBasisPoints must not exceed 10,000 (100%).
Any remaining percentage (10,000 - client - referrer) will be allocated to ContributionDAO as a service fee.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

accountId

string

required

The UUID of the account initiating the stake.

walletAddress

string

required

The Ethereum source address (funding wallet).
Crucial Role: This address will also be set as the Withdrawal Credentials.
It is the only address authorized to:

Receive Consensus Layer rewards.
Receive the principal amount upon full withdrawal.
Sign the 'Exit Validator' message.

feeRecipientAddress

string

(Optional) The address designated to receive immediate Execution Layer rewards (MEV & Priority Tips).

If this field is left empty or not provided, They will be sent to the walletAddress only when the user performs an Exit Validator operation or manually claims rewards.

validatorCount

integer

required

≥ 1

The number of validators to create (requires 32 ETH per validator).

clientBasisPoints

integer

The percentage of rewards allocated to the client (user), expressed in basis points (100 bps = 1%).

Allocation Rule: The sum of clientBasisPoints and referrerBasisPoints must be ≤ 10,000.
ContributionDAO Fee: If Sum < 10,000, the difference (10,000 - Sum) goes to CDAO.

referrerBasisPoints

integer

The percentage of rewards allocated to the referrer, expressed in basis points.

Allocation Rule: The sum of clientBasisPoints and referrerBasisPoints must be ≤ 10,000.

referrerRecipientAddress

string

Defaults to 0x0000000000000000000000000000000000000000

The Ethereum address designated to receive the referrer's share of execution rewards.

Constraint: This address MUST be different from the funding walletAddress. Self-referral is not allowed.
If left empty or set to the zero address, no referral split is applied.

Responses

401

Access token or App Id is missing or invalid

200Transaction generated successfully