Overview and setup for Blockdaemon Polygon Staking API.
MATIC Upgraded to POL
As of September 4th, 2024, POL will replace MATIC as the gas and staking token on Polygon PoS (Proof of Stake) and Polygon zkEVM.
Here’s what you need to know:
- MATIC Stakers: No action is required. All staked MATIC will be converted to POL.
- MATIC Holders on the Polygon PoS network: No action is required. Your tokens will be automatically migrated 1:1 to POL.
- MATIC Holders on the Ethereum network or Polygon zkEVM: You’ll need to migrate your tokens. For more details, please refer to the migration guide here.
- To stake POL: You'll need to sign the bootstrap transaction. If you want to stake or unstake MATIC without migrating to POL, call the Staking API with
MATIC
as the token type.
The Polygon Staking API offers an end-to-end staking solution that eliminates the need to run Ethereum or Polygon nodes. Your only requirement is transaction signing, adding minimal additional dependencies to your technological stack.
Our advanced bookkeeping and transaction lifecycle tracking prevent conflicts within your organization's sub-teams during ongoing deactivation and withdrawal operations.
Supported Networks
The Staking API supports the following Polygon networks:
- Mainnet
- Goerli/Prater
How to Use the Polygon Staking API
1. How to Bootstrap
Use the Post Bootstrapping Intent endpoint to set up your wallet for Polygon delegation. This returns an unsigned transaction that you need to sign and broadcast. This step must be completed before any delegation transactions.
2. How to Delegate
Use the Post Stake Intent endpoint to transfer POL tokens from your wallet to Polygon’s staking program. This generates an unsigned transaction that you must sign and broadcast.
3. How to Withdraw Rewards
When you have over 1 POL in rewards, use the Post Rewards Withdrawal Intent endpoint. This endpoint generates an unsigned transaction to withdraw rewards. The entire reward is sent to the Polygon contract, no specific amount is passed.
4. How to Restake Rewards
For rewards over 1 POL, use the Post Rewards Restake Intent endpoint. This endpoint combines withdrawal and restaking into a single transaction and delegating rewards to the same validator. The entire reward is restaked, and no specific amount is passed.
5. How to Unbond and Unstake
➡️ Step 1
Create an unbond intent using the Deactivation Intent endpoint. This returns an unsigned transaction that you need to sign and broadcast. Unbonding does not release funds immediately, but it takes about 80 checkpoints (2-3 days). During this period, validators and delegators must wait before withdrawing their funds.
➡️ Step 2
Wait for around 80 checkpoints, which typically takes 2-3 days. During this time, you can call the Lists Deactivation Intents endpoint as many times as you want to find out the following details:
- How many ongoing unbonding requests are there?
- IDs of these requests (nonces).
- How many checkpoints each unbonding request still has to wait for?
➡️ Step 3
After the withdrawal period, use the Withdrawal Intent endpoint to receive an unsigned transaction. Sign and broadcast it to transfer your staked POL tokens back to your wallet.
Info:
Unbond and unstake transactions must match on a one-to-one basis. There cannot be a successful unstake without a successful unbond preceding it.
👋 Need Help?
Contact us through email or our support page for any issues, bugs, or assistance you may need.