Skip to main content

Find the metadata of a given block.

GET 
/api/core/v3/blocks/:blockId/metadata

Find the metadata of a given block.

Request​

Path Parameters

    blockId stringrequired

    Identifier of the block.

    Example: 0x2de585533d9c9684747e49f70e5e620a4e6c3fd1c7d8b73520c198c7def29a050200000000000000

Responses​

Successful operation.

Schema
    blockId stringrequired

    The identifier of the block. Hex-encoded with 0x prefix.

    blockState stringrequired

    Possible values: [pending, confirmed, finalized, rejected, failed]

    If pending, the block is stored but not confirmed. If confirmed, the block is confirmed with the first level of knowledge. If finalized, the block is included and cannot be reverted anymore. If rejected, the block is rejected by the node, and user should reissue payload if it contains one. If failed, the block is not successfully issued due to failure reason.

    blockFailureReason integer

    Possible values: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 255]

    Values:

    • 1 - denotes that the block is too old to issue.
    • 2 - denotes that the block's parents are too old.
    • 3 - denotes that one of block's parents does not exist.
    • 4 - denotes that one of block's parents is invalid.
    • 5 - denotes that the issuer account could not be found.
    • 6 - denotes that the block version is invalid to retrieve the corresponding protocol information.
    • 7 - denotes that the Mana cost could not be calculated.
    • 8 - denotes that the issuer account burned insufficient Mana for the block.
    • 9 - denotes that the account is invalid, e.g. the account has negative Block Issuance Credits, or the account has expired.
    • 10 - denotes that the signature is invalid.
    • 11 - denotes that the block is dropped due to congestion.
    • 12 - denotes that the payload is invalid.
    • 255 - denotes that the block is invalid.
    transactionMetadata TransactionMetadataResponse

    The metadata of the transactions in the block.

    transactionId stringrequired

    The identifier of the transaction. Hex-encoded with 0x prefix.

    transactionState stringrequired

    Possible values: [pending, accepted, confirmed, finalized, failed]

    If 'pending', the transaction is not included yet. If 'accepted', the transaction is included. If 'confirmed' means transaction is included and its included block is confirmed. If 'finalized' means transaction is included, its included block is finalized and cannot be reverted anymore. If 'failed' means transaction is issued but failed due to the transaction failure reason.

    transactionFailureReason integer

    Possible values: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 255]

    Values:

    • 1 - denotes that the referenced UTXO was already spent.
    • 2 - denotes that the transaction is conflicting with another transaction. Conflicting specifically means a double spend situation that both transaction pass all validation rules, eventually losing one(s) should have this reason.
    • 3 - denotes that the referenced UTXO is invalid.
    • 4 - denotes that the transaction is invalid.
    • 5 - denotes that the sum of the inputs and output base token amount does not match.
    • 6 - denotes that the unlock block signature is invalid.
    • 7 - denotes that the configured timelock is not yet expired.
    • 8 - denotes that the given native tokens are invalid.
    • 9 - denotes that the return amount in a transaction is not fulfilled by the output side.
    • 10 - denotes that the input unlock is invalid.
    • 11 - denotes that an output contains a Sender with an ident (address) which is not unlocked.
    • 12 - denotes that the chain state transition is invalid.
    • 13 - denotes that the referenced input is created after transaction issuing time.
    • 14 - denotes that the mana amount is invalid.
    • 15 - denotes that the Block Issuance Credits Input is invalid.
    • 16 - denotes that Reward Context Input is invalid.
    • 17 - denotes that Commitment Context Input is invalid.
    • 18 - denotes that Staking Feature is not provided in account output when claiming rewards.
    • 19 - denotes that fail to claim staking reward.
    • 20 - denotes that fail to claim delegation reward.
    • 21 - denotes that the burning of native tokens was not allowed in the transaction capabilities.
    • 22 - denotes that the burning of mana was not allowed in the transaction capabilities.
    • 23 - denotes that the destruction of accounts was not allowed in the transaction capabilities.
    • 24 - denotes that the destruction of anchors was not allowed in the transaction capabilities.
    • 25 - denotes that the destruction of foundries was not allowed in the transaction capabilities.
    • 26 - denotes that the destruction of nfts was not allowed in the transaction capabilities.
    • 255 - denotes that the semantic validation failed.
Loading...