TABLE OF CONTENTS
XRP transactions can exhibit a discrepancy where a transaction seemingly fails yet becomes part of the blockchain due to the node's response structure.
Understanding the distinct failure types and associated notifications is required for accurate interpretation and handling of these scenarios within the XRP blockchain ecosystem.
Failure Types in XRP Transactions
XRP transactions encounter two distinctive failure types, leading to differing behaviors within the blockchain.
Failure Type 1: Transaction Broadcast Failure
This type occurs when the transaction fails to broadcast to the network. It's characterized by the node's rejection of the transaction or a failure in the call to the node. Consequently, the transaction does not exist on the XRP blockchain.
Failure Type 2: Transaction Execution Failure
This type occurs when the transaction is accepted and included in the blockchain despite encountering execution failures. This could result from issues such as smart contract (SC) call failures or other logic-related discrepancies.
Understanding XRP Notifications and KMS
KMS_FAILED_TX Notification
This notification triggers when the logic inside the user's Key Management System (KMS) fails to broadcast the transaction (Failure Type 1). It signifies the failure to initiate the transaction and generates an API call to register the failure. However, it's essential to note that this HTTP call might also fail, leaving a log within the user's KMS.
KMS_COMPLETED_TX Notification
Triggered when the broadcast endpoint within the KMS receives a response from the node indicating a successful broadcast (Failure Type 2). Despite this success signal, Failure Type 2 issues can still arise, potentially leading to the transaction being dropped from the mempool and not included in the chain.
ADDRESS_EVENT Notification and others
This notification creates a nuanced situation. For XRP transactions, there exists a design peculiarity where the XRP node responds with an error message (e.g., "Insufficient XRP balance to send") but still includes the transaction in the chain.
Consequently:
- KMS_FAILED_TX Notification will be triggered due to the error in broadcasting but inclusion in the chain.
- ADDRESS_EVENT Notification will also be triggered, despite the apparent failure indication, owing to XRP's design.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article