/starknetStakingEnterDelegationPool

1 min

POST

Allows users to delegate their STRK tokens to a validator's delegation pool. This function transfers the specified tokens, updates the delegator's record, and integrates them into the validator's pool for staking rewards. The tokens must be pre-approved using starknetStakingApprove before calling this function.

Return: Transaction details for the delegation pool entry operation.

Input Example: starknetStakingEnterDelegationPool(1, "0x0225...DDB7b9", "0x0175...A767", "5000000000000000000", 10000000000, 1000)

Response Example:

{
    "FunctionData": {
        "TransactionId": "c4e7...f8a9",
        "Status": "Pending",
        "DelegatedAmount": "5000000000000000000",
        "RewardAddress": "0x0175...A767",
        "PoolAddress": "0x0225...DDB7b9"
    },
    "Meta": {
        "AccessToken": "8fb6...d09",
        "Destination": "04a2...8eb0",
        "Source": "a6ac...5660",
        "Time": "2024-10-21 12:09:52.442"
    }
}

account_idintegerThe account ID to use for this staking operation.

pool_addressstringThe contract address of the delegation pool associated with a validator.

reward_addressstringThe Starknet address where you wish to receive your staking rewards.

amountstringThe amount of STRK tokens (in fri) you want to delegate to the validator.

gas_priceintegerThe amount to pay for a unit of gas (in fri).

gas_limitintegerThe maximum units of gas to spend for this transaction.

validate_transactionbooleanWhen true, the MPC wallet will access the node to check if the transaction is likely to fail and will block the transaction if it is.

descriptionstringText for describing the transaction in your records. This is not sent to the blockchain.

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

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/starknetStakingEnterDelegationPool?account_id=1&pool_address=0x0225...DDB7b9&reward_address=0x0175...A767&amount=5000000000000000000&gas_price=10000000000&gas_limit=1000&validate_transaction=boolean&description=My%20enter%20delegation%20transaction' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "FunctionData": {
     "AccountId": 1
     },
     "Meta": {
     "FunctionName": "getEthValidatorsSummary",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'