Lifecycle
Xumm's transaction lifecycle is a sequence of steps that ensures secure and efficient transaction processing on the XRP Ledger.
Last updated
Was this helpful?
Xumm's transaction lifecycle is a sequence of steps that ensures secure and efficient transaction processing on the XRP Ledger.
Last updated
Was this helpful?
Here's a comprehensive guide to understanding and implementing Xumm's transaction lifecycle:
Start by composing the transaction you want to be signed in JSON format, as per the . You can include all except "Account" and "Sequence", which will be automatically filled by Xumm.
Therefore, any JSON value you'd use to sign and send to an XRPL node can be sent to the Xumm SDK/API, with the (signing) account fields being added/filled being the only major difference.
All fields and values in the JSON transaction template sent to the Xumm SDK/API are passed on as-is, except for the following:
Account: If this field is part of the transaction template, it will be completely ignored, as the Account will be automatically filled based on the account the end user uses to sign the transaction with in the Xumm app.
Sequence: Based on the account used to sign by the end user in the Xumm app, the Sequence will be automatically filled by Xumm.
LastLedgerSequence: If a valid ledger index is entered in the LastLedgerSequence field, it will be passed on unchanged to the Xumm app. However, if a value < 32570 is entered, the Xumm app will automatically calculate the {current ledger index} + the given amount of ledgers, where {current ledger index} is based on the most recent closed ledger index at the moment the end user taps the button to accept & sign the sign request.
Configure Payload Options: Configure the payload options to customize the transaction request. Refer to the for detailed information on the available options.
If you are using a backend flow, you can optionally include a user token. This token is specific to the user and can be used for personalized transactions.
Submit the payload to Xumm through the Xumm SDK or API. You can also use alternative language SDKs for this step. This initiates the transaction signing process.
The client, a mobile app, xApp, or desktop application, will interact with the payload. Implement logic to handle this interaction and guide the user through the signing process.
The user will either sign or reject the transaction. Your application should be ready to handle both outcomes and take appropriate action.
After resolution, retrieve the payload results to understand the outcome of the transaction. You can use WebHooks, and WebSockets or verify through the SDK/API.
Understanding and implementing Xumm's transaction lifecycle is crucial for creating secure and efficient transactions on the XRP Ledger through the Xumm platform.
Finally, verify the transaction on the XRP Ledger. You can use libraries like or for on-ledger verification. Ensure to check for delivered_amount and other relevant fields.