Dynamic MPT Reference

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

The Dynamic MPT amendment does not create any new data types, but it modifies several transactions and the MPTokenIssuance ledger entry.

• Transactions:
  • MPTokenIssuanceCreate - The new MutableFlags field specifies which fields or flags are mutable after issuance.
  • MPTokenIssuanceSet - Several new fields let you update mutable metadata and transfer fees, and enable MPT issuance flags that were declared mutable.
• Ledger Entries:
  • MPTokenIssuance - The new MutableFlags field stores mutability settings.

(Requires the DynamicMPT amendment )

MPTokenIssuanceCreate Transaction Changes

To allow future changes to specific fields or flags of a token, issuers must clearly specify which ones should be mutable when creating the MPTokenIssuance object.

Example JSON

This example creates an MPT issuance with mutable metadata:

{
  "TransactionType": "MPTokenIssuanceCreate",
  "Account": "rNFta7UKwcoiCpxEYbhH2v92numE3cceB6",
  "AssetScale": 4,
  "TransferFee": 0,
  "MaximumAmount": "50000000",
  "MutableFlags": 65536, // tmfMPTCanMutateMetadata
  "MPTokenMetadata": "464F4F",
  "Fee": "12",
  "Flags": 122,
  "Sequence": 99536574
}

MPTokenIssuanceCreate Fields

MPTokenIssuanceCreate transactions can include the following new field:

MPTokenIssuanceCreate Mutable Flags

The following flags are stored in the MutableFlags field, which is separate from the Flags field of the MPTokenIssuanceCreate transaction. MPT issuance flags that are declared mutable are one-way: they can be enabled after issuance via MPTokenIssuanceSet, but once enabled they cannot be disabled. Mutable fields (MPTokenMetadata and TransferFee) can always be modified.

Error Cases

The following failure conditions have been added to the MPTokenIssuanceCreate transaction:

MPTokenIssuanceSet Transaction Changes

When updating mutable fields, issuers can change the field value to any allowed value. When enabling MPT issuance flags that were declared mutable, issuers can only enable them; mutable flags are one-way and cannot be disabled by MPTokenIssuanceSet once enabled.

Example JSON

This example updates the MPT metadata:

{
  "TransactionType": "MPTokenIssuanceSet",
  "Account": "rNFta7UKwcoiCpxEYbhH2v92numE3cceB6",
  "MPTokenIssuanceID": "05EECEBE97A7D635DE2393068691A015FED5A89AD203F5AA",
  "MPTokenMetadata": "575C5C", // Updated metadata from `464F4F` to `575C5C`
  "Fee": "10",
  "Flags": 1,
  "Sequence": 99536577
}

MPTokenIssuanceSet Fields

MPTokenIssuanceSet transactions can include the following new fields:

MPTokenIssuanceSet Mutable Flags

The following flags are stored in the MutableFlags field, which is separate from the Flags field of the MPTokenIssuanceSet transaction. All of these flags are one-way: each one only enables an MPT issuance flag that was declared mutable at creation. Once enabled, the underlying MPT issuance flag cannot be disabled by MPTokenIssuanceSet.

Transfer Fee Rules

The ability to modify the TransferFee depends on two flags:

• lsfMPTCanTransfer: must already be enabled to allow any non-zero TransferFee. Note that this flag can be enabled through tmfMPTSetCanTransfer if lsmfMPTCanEnableCanTransfer is set. Once enabled, it cannot be disabled.
• lsmfMPTCanMutateTransferFee: must be enabled at creation of the MPT issuance to allow any modification of the TransferFee field.

The following table describes how setting a zero or non-zero transfer fee through the MPTokenIssuanceSet transaction behaves, based on the existing state of the MPTokenIssuance object on-ledger. The first two columns represent the ledger state (lsfMPTCanTransfer and lsmfMPTCanMutateTransferFee), while the third column represents the TransferFee value being set in the transaction.

Error Cases

The following failure conditions have been added to the MPTokenIssuanceSet transaction:

MPTokenIssuance Entry Changes

MPTokenIssuance ledger entries can include the following new field:

MPTokenIssuance Mutable Flags

The following flags are stored in the MutableFlags field, which is separate from the Flags field of the MPTokenIssuance ledger entry:

Amendment Information