Skip To Content

Blockdaemon Documentation

Post Deactivation Intent

The Staking Integration API endpoint described on this page allows you to create a deactivation intent:

POST Create a New Deactivation Intent
Authentication Using API Key as an X-API-Key
Polygon API Usage Example
Polygon API User Journey


POST Create a New Deactivation Intent

https://svc.blockdaemon.com/boss/v1/{protocol}/{network}/deactivation-intents

Creates a new unbond intent that opts out of the delegation program.

The user is getting back both their stake and the earned reward. The reward is sent immediately, but the stake gets locked for the so-called “unbonding period” of 2–3 days (or 80 Polygon checkpoints). Once the period is over, the user should call GET Get Deactivation Intents and POST Create a New Withdrawal Intent to actually get their stake back.

Learn more: Polygon API Usage Example, Polygon API User Journey

Note: You need to authorize your request via an API key provided when signing up for a staking account.

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • polygon/prater

Supported Networks

Here is a full list of supported networks with their path parameters:

Protocol Network Path parameters
Polygon Mainnet polygon/mainnet
Polygon Prater polygon/prater

Example Query
To create a new deactivation intent in the Polygon Prater, use the following:

https://svc.blockdaemon.com/boss/v1/polygon/prater/deactivation-intents

Request Body

In the request body you need to specify the following:

  • amount: The amount of MATIC (in Wei) you want to deactivate
  • wallet_address: The user’s hex-encoded Ethereum account address

Example Request Body

{
    "amount": "1000000000000000000",
    "wallet_address": "0x5c63B71F47dfA807aa6a8705e5cf134f4c3Afd8a"
}

Example Response

The following is a typical response from POST Create a New Deactivation Intent:

{
    "customer_id": "3bcf0d33-cb47",
    "network": "prater",
    "polygon": {
        "amount": "1000000000000000000",
        "to": "0x75605B4F7C52e37b4f37121DC4529b08dFC76b39",
        "unsigned_transaction": "0xc83ec04d0000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "wallet_address": "0x5c63B71F47dfA807aa6a8705e5cf134f4c3Afd8a"
    },
    "protocol": "polygon"
}

Authentication Using API Key as an X-API-Key

When signing up for a staking account, you are provided with an API key.

To authenticate a Staking API request, pass your API key in the X-API-Key header:

curl -X POST \
'https://svc.blockdaemon.com/boss/v1/polygon/prater/deactivation-intents' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"amount": "1000000000000000000", "wallet_address": "0x5c63B71F47dfA807aa6a8705e5cf134f4c3Afd8a"}'

Polygon API Usage Example

In this section you will find a TypeScript example showing how to send a Polygon transaction using the Polygon Staking Integration API:


Polygon API User Journey

In this section you will find a typical user journey for Polygon Staking Integration API:

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.