Skip to main content
For Polkadot signing instructions, refer to the transaction signing section.

Extended metadata

All Polkadot endpoints generating staking transactions now support an optional boolean parameter extended. When it is set to true, the response includes additional metadata, which can be required for offline transaction signing and external processing.

Examples

Example request with extended: true to /api/v1/polkadot/{network}/staking/bond:
Example response:
  • unsignedTransaction in the hexadecimal format.
  • unsignedTransactionSerialized — unsigned serialized transaction containing all the data.
  • unsignedTransactionPayload — only raw payload of the unsigned transaction in the hexadecimal format.
  • unsignedTransactionObject — full decoded transaction structure with all the fields and metadata:
    • blockHash— hash of the checkpoint block in which the transaction was included.
    • eraPeriod — validity period of the transaction, representing the number of blocks following after the checkpoint for which the transaction is valid.
    • currentEra — current staking era of the transaction.
    • genesisHash — hash of the genesis block.
    • metadataRpc — serialized metadata used for offline decoding and transaction signing.
    • method is the list of data fields containing information on the method called to construct a transaction.
    • nonce — nonce of the transaction.
    • specVersion — current version of the chain specification for the runtime.
    • transactionVersion — current version of the transaction format.
    • tip — optional fee used to increase the transaction priority.
  • stashAccountAddress — main stash account address which keeps tokens for bonding.
  • rewardDestinationType — rewards destination type:
    • staked — rewards will be sent to the stash account and added to the current bond (compounding rewards).
    • stash — rewards will be sent to the stash account as a transferrable balance (not compounding rewards).
    • account — rewards will be sent to any account specified as a transferrable balance.
  • rewardDestination — rewards destination account address.
  • amount — amount of tokens to bond. DOT is used for the main network, KSM for Kusama, and WND for Westend.
  • createdAt — timestamp of the transaction in the ISO 8601 format.

Supported endpoints

The extended parameter is available for the following endpoints:

Offline transaction signing

To sign the transaction offline, follow these steps:
  1. Prepare the unsignedTransactionSerialized object.
  2. Sign the transaction in your preferred way of signing. Example (for westend network):