Skip to main content
The 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

  1. 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
ColumnDescription
checkpoint_timestampTimestamp of when the checkpoint was created
stake_activation_epochThe epoch number when the stake was originally activated
unstaking_epochThe epoch number where the IOTA unstake request will be released
senderAddress of the sender
staker_addressAddress of the staker
validator_addressAddress of the validator
pool_idID of the staking pool
principal_amount_strAmount of IOTA unstaked (string format for precision)
principal_amountAmount of IOTA unstaked (float format)
reward_amount_strAmount of rewards received (string format for precision)
reward_amountAmount of rewards received (float format)
checkpoint_sequenceSequence number of the checkpoint
checkpoint_digestDigest of the checkpoint
transaction_block_digestDigest of the transaction block
transaction_moduleModule of the transaction
event_seqSequence number of the event
package_idID of the package
unique_idUnique ID of the withdrawal
_created_atTimestamp when the record was created
_updated_atTimestamp when the record was last updated