XRP Ledger Apex is back in Amsterdam

Register Now
Last updated
Edit

XChainModifyBridge

[Source]

(Requires the XChainBridge amendment )

The XChainModifyBridge transaction allows bridge managers to modify the parameters of the bridge. They can only change the SignatureReward and the MinAccountCreateAmount.

This transaction must be sent by the door account and requires the entities that control the witness servers to coordinate and provide the signatures for this transaction. This coordination happens outside the ledger.

Note: You can't modify the signer list for the bridge with this transaction. The signer list is on the door account itself and is changed in the same way signer lists are changed on accounts (via a SignerListSet transaction).

Example XChainModifyBridge JSON

{
  "TransactionType": "XChainModifyBridge",
  "Account": "rhWQzvdmhf5vFS35vtKUSUwNZHGT53qQsg",
  "XChainBridge": {
    "LockingChainDoor": "rhWQzvdmhf5vFS35vtKUSUwNZHGT53qQsg",
    "LockingChainIssue": {
      "currency": "XRP"
    },
    "IssuingChainDoor": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "IssuingChainIssue": {
      "currency": "XRP"
    }
  },
  "SignatureReward": 200,
  "MinAccountCreateAmount": 1000000
}

XChainModifyBridge Fields

FieldJSON TypeInternal TypeRequired?Description
FlagsNumberUInt32YesSpecifies the flags for this transaction.
MinAccountCreateAmountCurrency AmountAmountNoThe minimum amount, in XRP, required for a XChainAccountCreateCommit transaction. If this is not present, the XChainAccountCreateCommit transaction will fail. This field can only be present on XRP-XRP bridges.
SignatureRewardCurrency AmountAmountNoThe signature reward split between the witnesses for submitting attestations.
XChainBridgeXChainBridgeXChain_BridgeYesThe bridge to modify.

XChainBridge Fields

FieldJSON TypeInternal TypeRequired?Description
IssuingChainDoorStringAccountYesThe door account on the issuing chain. For an XRP-XRP bridge, this must be the genesis account (the account that is created when the network is first started, which contains all of the XRP).
IssuingChainIssueIssueIssueYesThe asset that is minted and burned on the issuing chain. For an IOU-IOU bridge, the issuer of the asset must be the door account on the issuing chain, to avoid supply issues.
LockingChainDoorStringAccountYesThe door account on the locking chain.
LockingChainIssueIssueIssueYesThe asset that is locked and unlocked on the locking chain.

Transaction Flags

In addition to the universal transaction flags that are applicable to all transactions, you can specify this flag:

Flag NameFlag ValueDescription
tfClearAccountCreateAmount0x00010000Clears the MinAccountCreateAmount of the bridge.