Burn 2 Mint (B2M)
Burn2Mint is a low-level inter-chain primitive and is intended for enterprise users to self-supply their own liquidity as needed for their own purposes.
Since the ZeroB2M amendment has been voted in at Xahau, Burn 2 Mint (B2M) is no longer available to mint new assets. B2M is still available, but just for key synchonisation or to activate an account based (for which the information & procedures below are still relevant)
https://xahscan.com/amendment/7CA0426E7F411D39BB014E57CD9E08F61DE1750F0D41FCD428D9FB80BB7596B0
Burn2Mint Technical Manual (Xahau Testnet)
This process is deliberately non-trivial and not designed for end users. Mistakes result in a burn not being able to turn into a mint.
This is a warning that will appear on the production version of this document. You may disregard it because you are burning free testnet XRP in this instance.
Burn2Mint is a low-level inter-chain primitive intended for enterprise users to self-supply their liquidity as needed for their purposes. Running your own nodes and performing this operation yourself on your nodes means you and you alone bear responsibility for the outcome of the procedure.
The generation & collection of XPOPs fundamentally relies on collecting validation messages on the overlay network, which are ephemeral by nature. If your nodes are not reliably connected, or if your hardware, network connection, or operating system fails at the wrong point in time, then the XPOP for a Burn Transaction might not be generated or might not be generated correctly. This can lead to loss of funds as the Burn Transaction's XPOP was not captured in time, and it’s possible the validation messages are lost forever, making a Mint Transaction impossible despite a successful Burn Transaction.
If you are not comfortable with taking these technical risks or do not understand what you are doing, or are not an enterprise user, then please source your liquidity via other friendly alternatives.
Setup
To perform B2M, two XRPL protocol nodes should be operated by the user:
Obtain xPOP from burn
Run this (e.g., using Docker Compose; see repo Docs) https://github.com/Xahau/Validation-Ledger-Tx-Store-to-xPOP
The service listens for XRPL validation messages, closed ledgers, and transactions.
It stores this data in an organized file system.
It is essential for generating xPOPs, as XRPL validation messages are ephemeral; without storing them, a transaction burn can't be turned into a mint.
How it Works:
A watcher connects to multiple XRPL nodes and listens for specific data.
The captured data is then saved, organized, and used to generate xPOPs
Simply fetch the xPOP now from:
http[s]://{your-host}:{your-port}/xpop/{tx-hash}
You can easily fetch/create xPOPs from a node using the repo above using this NPM package:
Mint
In this test scenario, you will connect directly to the Xahau. You do not need to run your own node. In the production scenario, you will need to run a Mint node, which is just a stock node for the target network. This is because public nodes will probably opt out of accepting Import transactions due to legal risk.
Connect to wss://xahau-test.net
Or download download/run: https://github.com/Xahau/Xahau-Testnet-Docker
Sample (nodejs)
This example creates a testnet account, burns 10 XRP & then imports this on Xahau Testnet, using the xPOP fetched using the tools mentioned above.
Technical Summary of B2M's procedure
New Transaction Type: Import
Import
Xahau Testnet (network_id=21338) introduces a new transaction type called Import, which accepts an XPOP from the Ripple testnet chain (network_id=1) and provides for a “burn-to-mint” unidirectional value transfer and key / account synchronization.
Burn Transaction
A Burn Transaction is a transaction that burns XRP on a source XRPL chain, which would be used as proof (XPOP) to mint on a destination XRPL chain.
The following are supported transaction types:
AccountSet
SetRegularKey
SignerListSet.
Tickets are not accepted in any Burn Transactions and would lead to a Burn Transaction being invalid for minting. To protect against spam, transactions must be validated with a real, natural sequence number.
Note that other transaction types are not currently supported and cannot be used to mint on Xahau Testnet. (However, this may change).
All three transaction types can be used for minting. This means the Fee burned by the Burn Transaction is subsequently minted on Xahau Testnet after a successful Import
.
If SetRegularKey
or SignerListSet
is used, then key synchronization occurs according to the standard rules of the transaction type. If AccountSet
it is used, then no key synchronization occurs on the destination XRPL chain (Xahau Testnet).
A field called OperationLimit must be present on the Burn Transaction to be the destination chain’s Network ID. This field is to prevent replay attacks on other B2M-integrated chains.
The Burn Transaction may be used for Minting if it has either a tesSUCCESS transaction code or any of the tec transaction codes. Meaning if the fee was burnt, then the transaction can be used for minting. However, key synchronization only occurs when the Burn Transaction result was tesSUCCESS.
Example Burn Transaction:
XPOP Collection
Before submitting the Burn Transaction, ensure your Burn Node is synchronized with the testnet chain (Network ID: 1
).
After checking your Burn Node's state, submit the signed Burn Transaction to the Burn Node.
The Burn Node watches closed ledgers for transactions containing the OperationLimit field and uses collected validation messages to generate an XPOP (Proof Of Burn). These are written to a file under the directory specified in [xpop_dir] stanza in the Burn Node’s rippled.cfg
.
Wait for the ledger to close, then browse through the xpop_dir for the Burn Transaction's XPOP according to its TXID. The file contains a JSON document, which is the XPOP that you'll be relaying to the destination XRPL chain (HooksV3).
Take the raw contents of this file and encode it as HEX. This will become the contents of the *Blob field in the Import
transaction.
Mint Transaction
Your binary codec will be missing the necessary fields to construct the Import
(Mint) transaction. If you are using ripple-binary-codec, you can update its definitions.json
file in the following way:
Change directory into
node_modules
Run
find . | grep 'dist/enums/definitions.json'
to locate the relevant file to updateConnect to wss://hooks-testnet-v3.xrpl-labs.com
Request:
{"command":"server_definitions"}
Dump the contents of the
"result"
key intodefinitions.json
from step 2.
The Import
transaction type takes only one non-common field Blob.. This must contain the HEX-encoded XPOP from the XPOP Collection phase.
You can do this with
cat xpopjsonfile | xxd -p | tr -d '\n'
The Account
and SigningPubKey
field (or Signers array) must match exactly between the Burn Transaction and the Mint Transaction. Users can only mint to the same account, which they burned from.
If the Account
field specifies an account that does not yet exist on Xahau Testnet, and it will be created. In this case, use 0 for the Sequence
field on the Mint Transaction. If the account already exists on Xahau Testnet, then use the next available Sequence number on the account on Xahau Testnet.
Example Import:
IMPORTANT: The Mint Transaction must be signed exactly the same way and by the same account as the Burn Transaction!
Encode and sign the transaction appropriately, yielding a signed transaction blob (hex).
If you are not running your own Mint node:
Connect to wss://xahau-testn.et
Submit the transaction to the node:
Or, if you are running your own Mint node:
Ensure the Mint Node is running and synchronised to Network ID 21338.
Use the
submit
RPC call to submit the Mint Transaction.You can do this from command line using
./hooksv3d submit <hex here>
Considerations
If the Account is to be created on Xahau Testnet but the keying for the account is unclear from the context of the Burn Transaction, then the Account is created in a blackholed mode. It can be subsequently rekeyed using either keying transaction type.
If the Burn Transaction is either a SignerListSet
or a SetRegularKey
transaction, then provided it had a tesSUCCESS transaction result on the source XRPL chain (testnet), that same keying operation is now applied to that same account on the destination XRPL chain (Xahau Testnet).
During testing, Accounts on Xahau Testnet can be deleted, however, on the production Hooks-enabled chain, they will not be able to be deleted.
Accounts on Xahau Testnet have an optional ImportSequence field in the AccountRoot. If Import has ever been used on that account on Xahau Testnet, this field is present and is populated with the most recently imported Burn Transaction’s Sequence number. This is to prevent replay attacks, but it also means that you should never submit your Burn2Mints out of sequence, otherwise the skipped transactions will never be accepted for Minting.
Last updated