iota.staking.withdrawals model tracks all staking withdrawals made from validators on the IOTA network.
Understanding Unstaking
When users unstake their IOTA, they return their pool tokens and receive both their original principal and accumulated rewards. The unstaking process in IOTA has a waiting period before funds are released.Unstaking Process
- User initiates an unstaking request
- The request is processed at the end of the current epoch
- The user receives their principal amount plus rewards
- The rewards are calculated based on the pool token exchange rate at the time of unstaking
Principal vs. Rewards
The withdrawal data separates the original staked amount (principal) from the earned rewards, allowing for clear tracking of staking returns.Table Columns
Unique Key:unique_id
| Column | Description |
|---|---|
| checkpoint_timestamp | Timestamp of when the checkpoint was created |
| stake_activation_epoch | The epoch number when the stake was originally activated |
| unstaking_epoch | The epoch number where the IOTA unstake request will be released |
| sender | Address of the sender |
| staker_address | Address of the staker |
| validator_address | Address of the validator |
| pool_id | ID of the staking pool |
| principal_amount_str | Amount of IOTA unstaked (string format for precision) |
| principal_amount | Amount of IOTA unstaked (float format) |
| reward_amount_str | Amount of rewards received (string format for precision) |
| reward_amount | Amount of rewards received (float format) |
| checkpoint_sequence | Sequence number of the checkpoint |
| checkpoint_digest | Digest of the checkpoint |
| transaction_block_digest | Digest of the transaction block |
| transaction_module | Module of the transaction |
| event_seq | Sequence number of the event |
| package_id | ID of the package |
| unique_id | Unique ID of the withdrawal |
| _created_at | Timestamp when the record was created |
| _updated_at | Timestamp when the record was last updated |