/starknetStakingIncreaseAllowance

1 min

POST

Augments the existing allowance granted to a staking contract or delegation pool, enabling the contract to transfer additional STRK tokens on behalf of the user. This function is essential when a user intends to increase their stake or delegation without altering the previously approved amount, providing a safer alternative to setting a new total allowance.

Return: Transaction details for the allowance increase operation.

Input Example: starknetStakingIncreaseAllowance(1, "0x0225...DDB7b9", "2000000000000000000", 10000000000, 1000)

Response Example:

{
    "FunctionData": {
        "TransactionId": "b3d6...e5f7",
        "Status": "Pending",
        "GasUsed": "48000",
        "AdditionalAllowance": "2000000000000000000",
        "NewTotalAllowance": "7000000000000000000"
    },
    "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.

amountstringThe additional amount of STRK tokens (in fri) to approve for delegation 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 '/starknetStakingIncreaseAllowance?account_id=1&pool_address=0x0225...DDB7b9&amount=2000000000000000000&gas_price=10000000000&gas_limit=1000&validate_transaction=boolean&description=My%20increase%20allowance%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"
     }
     }'