feat: Support DynamicMPT (XLS-94)

public/locales/ca-CA/translations.json

@@ -945,5 +945,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

public/locales/en-US/translations.json

@@ -946,5 +946,11 @@
   "registered": "Registered",
   "included": "Included",
   "maintenance_banner.notice": "Scheduled maintenance: {{window}} (~{{duration}} min downtime).",
-  "maintenance_banner.countdown_prefix": "Starts in"
+  "maintenance_banner.countdown_prefix": "Starts in",
+  "can_enable": "Can Enable",
+  "can_enable_flag_tooltip": "The issuer can still enable this capability — it has not been permanently locked",
+  "immutable": "Immutable",
+  "immutable_flag_tooltip": "This capability has been permanently locked by the issuer and cannot be enabled",
+  "immutable_field_tooltip": "This field has been permanently locked by the issuer and cannot be changed",
+  "immutable_flags": "Immutable Flags"
 }

public/locales/es-ES/translations.json

@@ -946,5 +946,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

public/locales/fr-FR/translations.json

@@ -946,5 +946,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

public/locales/ja-JP/translations.json

@@ -946,5 +946,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

public/locales/ko-KR/translations.json

@@ -946,5 +946,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

public/locales/my-MM/translations.json

@@ -946,5 +946,11 @@
   "registered": null,
   "included": null,
   "maintenance_banner.notice": null,
-  "maintenance_banner.countdown_prefix": null
+  "maintenance_banner.countdown_prefix": null,
+  "immutable_flags": null,
+  "can_enable": null,
+  "can_enable_flag_tooltip": null,
+  "immutable": null,
+  "immutable_flag_tooltip": null,
+  "immutable_field_tooltip": null
 }

scripts/showcase-dynamic-mpt.mjs

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+/**
+ * showcase-dynamic-mpt.mjs
+ *
+ * Submits four DynamicMPT transactions to a local rippled standalone and prints
+ * Explorer URLs to review each UI surface:
+ *   1. MPTokenIssuanceCreate — all mutable (no ImmutableFlags)
+ *   2. MPTokenIssuanceCreate — with ImmutableFlags set
+ *   3. MPTokenIssuanceSet   — enable capabilities via tfMPTSetCan* Flags
+ *   4. MPTokenIssuanceSet   — update TransferFee + lock flags via ImmutableFlags
+ *
+ * Usage:
+ *   node scripts/showcase-dynamic-mpt.mjs
+ *   EXPLORER=http://localhost:3001/localhost node scripts/showcase-dynamic-mpt.mjs
+ */
+
+const ENDPOINT = process.env.RIPPLED ?? 'http://localhost:5005'
+const GENESIS_ACCOUNT = 'rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh'
+const GENESIS_SECRET = 'snoPBrXtMeMyMHUVTgbuqAfg1SUTb'
+const EXPLORER = process.env.EXPLORER ?? 'http://localhost:3001/localhost'
+
+// ── RPC helpers ───────────────────────────────────────────────────────────────
+
+async function rpc(method, params = {}) {
+  const res = await fetch(ENDPOINT, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ method, params: [params] }),
+  })
+  if (!res.ok) throw new Error(`HTTP ${res.status}`)
+  const { result } = await res.json()
+  if (result.error) throw new Error(`${result.error}: ${result.error_message ?? ''}`)
+  return result
+}
+
+async function submit(txJson) {
+  const result = await rpc('submit', { tx_json: txJson, secret: GENESIS_SECRET })
+  const eng = result.engine_result
+  if (eng !== 'tesSUCCESS' && eng !== 'terQUEUED') {
+    throw new Error(`${eng}: ${result.engine_result_message}`)
+  }
+  return result.tx_json.hash
+}
+
+async function advanceLedger() {
+  await rpc('ledger_accept')
+}
+
+async function getValidatedTx(hash) {
+  // retry a few times in case the ledger hasn't closed yet
+  for (let i = 0; i < 5; i++) {
+    try {
+      const result = await rpc('tx', { transaction: hash })
+      if (result.validated) return result
+    } catch (_) {}
+    await new Promise(r => setTimeout(r, 200))
+  }
+  throw new Error(`tx ${hash} not validated after retries`)
+}
+
+// ── XLS-0089 MPT metadata schemas ────────────────────────────────────────────
+// Short key names per spec: t=ticker, n=name, d=desc, i=icon, ac=asset_class,
+// as=asset_subclass (required for ac=rwa), in=issuer_name, us=uris, ai=additional_info
+
+// Issuance A: DeFi token, all capabilities still mutable at creation.
+const METADATA_A = {
+  t: 'DYNX',
+  n: 'DynToken Flex',
+  d: 'A DeFi token demonstrating DynamicMPT — all capabilities mutable at creation. The issuer can still enable escrow, trade, clawback, and more via MPTokenIssuanceSet.',
+  i: 'https://example.org/dynx/icon.png',
+  ac: 'defi',
+  in: 'XRPL Foundation',
+}
+
+// Issuance B: RWA (treasury) token with CanLock, RequireAuth, and Metadata
+// permanently locked at issuance via ImmutableFlags.
+const METADATA_B = {
+  t: 'RTBIL',
+  n: 'T-Bill Yield Token',
+  d: 'Yield-bearing token backed by U.S. Treasuries. CanLock, RequireAuth, and Metadata are permanently immutable — set once at issuance and can never be changed.',
+  i: 'https://example.org/rtbil/icon.png',
+  ac: 'rwa',
+  as: 'treasury',
+  in: 'XRPL Foundation',
+  us: [
+    { u: 'https://example.org/rtbil', c: 'website', t: 'Product Page' },
+  ],
+  ai: { interest_rate: '5.00%', maturity_date: '2027-06-30' },
+}
+
+// TX4 update to Issuance A: new metadata after locking CanTrade, CanTransfer,
+// and TransferFee — reflects the permanent change in the description.
+const METADATA_A_UPDATED = {
+  t: 'DYNX',
+  n: 'DynToken Flex',
+  d: 'Updated via MPTokenIssuanceSet: TransferFee raised to 0.075%. CanTrade, CanTransfer, and TransferFee are now permanently immutable.',
+  i: 'https://example.org/dynx/icon.png',
+  ac: 'defi',
+  in: 'XRPL Foundation',
+  us: [
+    { u: 'https://example.org/dynx', c: 'website', t: 'Product Page' },
+  ],
+}
+
+function toHex(obj) {
+  const json = typeof obj === 'string' ? obj : JSON.stringify(obj)
+  return Buffer.from(json, 'utf8').toString('hex').toUpperCase()
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+async function main() {
+  console.log(`Connecting to ${ENDPOINT} …`)
+  const { info } = await rpc('server_info')
+  console.log(`  rippled ${info.build_version}  network_id=${info.network_id}\n`)
+
+  const { account_data } = await rpc('account_info', {
+    account: GENESIS_ACCOUNT,
+    ledger_index: 'current',
+  })
+  let seq = account_data.Sequence
+  console.log(`  Genesis account: ${GENESIS_ACCOUNT}  seq=${seq}\n`)
+
+  const results = {}
+
+  // ── TX 1: Create — all mutable (no ImmutableFlags) ──────────────────────────
+  // Flags: tfMPTCanTransfer (0x20)
+  // Metadata: XLS-0089 JSON (ac=defi), all capabilities mutable.
+  // Shows: Create Simple with NO "Immutable Flags" row.
+  // Settings: 7 "Can Enable" badges on unlocked disabled caps;
+  //           Metadata + TransferFee field rows visible with no badge.
+  console.log('TX1  MPTokenIssuanceCreate — all mutable (DYNX / DeFi)')
+  const hash1 = await submit({
+    TransactionType: 'MPTokenIssuanceCreate',
+    Account: GENESIS_ACCOUNT,
+    Sequence: seq++,
+    Fee: '200',
+    Flags: 0x00000020,           // tfMPTCanTransfer
+    AssetScale: 6,
+    MaximumAmount: '1000000000000',
+    TransferFee: 100,            // 0.010% — still mutable
+    MPTokenMetadata: toHex(METADATA_A),
+  })
+  await advanceLedger()
+  const tx1 = await getValidatedTx(hash1)
+  const issuanceIdA = tx1.meta?.mpt_issuance_id ?? '?'
+  results.tx1 = { hash: hash1, issuanceId: issuanceIdA }
+  console.log(`  hash       : ${hash1}`)
+  console.log(`  issuance ID: ${issuanceIdA}\n`)
+
+  // ── TX 2: Create — with ImmutableFlags ──────────────────────────────────────
+  // Flags: tfMPTCanTransfer (0x20) | tfMPTRequireAuth (0x04)
+  // ImmutableFlags: tifMPTCanLock(0x2) + tifMPTRequireAuth(0x4) + tifMPTMetadata(0x10000)
+  //               = 0x10006 = 65542
+  // Metadata: XLS-0089 JSON (ac=rwa, as=treasury), with URIs and ai fields.
+  // Shows: Create Simple "Immutable Flags" row listing tifMPTCanLock,
+  //        tifMPTRequireAuth, tifMPTMetadata; metadata renders as JSON in Detail.
+  // Settings: CanLock + RequireAuth → "Immutable" badge;
+  //           Metadata field row → "Immutable" badge; TransferFee row mutable.
+  console.log('TX2  MPTokenIssuanceCreate — with ImmutableFlags (RTBIL / RWA treasury)')
+  const hash2 = await submit({
+    TransactionType: 'MPTokenIssuanceCreate',
+    Account: GENESIS_ACCOUNT,
+    Sequence: seq++,
+    Fee: '200',
+    Flags: 0x00000024,           // tfMPTCanTransfer | tfMPTRequireAuth
+    AssetScale: 2,
+    MaximumAmount: '9223372036854775807',
+    TransferFee: 500,            // 0.500%
+    MPTokenMetadata: toHex(METADATA_B),
+    ImmutableFlags: 0x00010006,  // tifMPTCanLock + tifMPTRequireAuth + tifMPTMetadata
+  })
+  await advanceLedger()
+  const tx2 = await getValidatedTx(hash2)
+  const issuanceIdB = tx2.meta?.mpt_issuance_id ?? '?'
+  results.tx2 = { hash: hash2, issuanceId: issuanceIdB }
+  console.log(`  hash       : ${hash2}`)
+  console.log(`  issuance ID: ${issuanceIdB}\n`)
+
+  // ── TX 3: Set — enable capabilities via tfMPTSetCan* Flags ──────────────────
+  // Flags: tfMPTSetCanEscrow(0x10) | tfMPTSetCanTrade(0x20) = 0x30
+  // Shows: Set Simple with NO ImmutableFlags row; the tfMPTSetCan* bits appear
+  //        automatically in the Detail tab via TX_FLAGS.MPTokenIssuanceSet.
+  console.log('TX3  MPTokenIssuanceSet — enable CanEscrow + CanTrade on Issuance A')
+  const hash3 = await submit({
+    TransactionType: 'MPTokenIssuanceSet',
+    Account: GENESIS_ACCOUNT,
+    Sequence: seq++,
+    Fee: '200',
+    MPTokenIssuanceID: issuanceIdA,
+    Flags: 0x00000030,           // tfMPTSetCanEscrow | tfMPTSetCanTrade
+  })
+  await advanceLedger()
+  results.tx3 = { hash: hash3 }
+  console.log(`  hash: ${hash3}\n`)
+
+  // ── TX 4: Set — update TransferFee + metadata + lock via ImmutableFlags ──────
+  // ImmutableFlags: tifMPTCanTrade(0x10) + tifMPTCanTransfer(0x20) + tifMPTTransferFee(0x20000)
+  //               = 0x20030 = 131120
+  // Metadata: updated XLS-0089 JSON reflecting the new locked state.
+  // Shows: Set Simple with TransferFee row (0.075%), Metadata row (JSON rendered),
+  //        and "Immutable Flags" row listing tifMPTCanTrade, tifMPTCanTransfer,
+  //        tifMPTTransferFee.
+  console.log('TX4  MPTokenIssuanceSet — update metadata + TransferFee + lock via ImmutableFlags on Issuance A')
+  const hash4 = await submit({
+    TransactionType: 'MPTokenIssuanceSet',
+    Account: GENESIS_ACCOUNT,
+    Sequence: seq++,
+    Fee: '200',
+    MPTokenIssuanceID: issuanceIdA,
+    TransferFee: 750,            // update: 0.010% → 0.075%
+    MPTokenMetadata: toHex(METADATA_A_UPDATED),
+    ImmutableFlags: 0x00020030,  // tifMPTCanTrade + tifMPTCanTransfer + tifMPTTransferFee
+  })
+  await advanceLedger()
+  results.tx4 = { hash: hash4 }
+  console.log(`  hash: ${hash4}\n`)
+
+  // ── Summary ──────────────────────────────────────────────────────────────────
+  console.log('═══════════════════════════════════════════════════════════════════')
+  console.log('  EXPLORER URLS')
+  console.log('═══════════════════════════════════════════════════════════════════\n')
+
+  console.log('── MPTokenIssuanceCreate / Simple view ─────────────────────────────')
+  console.log('  TX1  DYNX — no ImmutableFlags ("Immutable Flags" row absent)')
+  console.log(`  ${EXPLORER}/transactions/${results.tx1.hash}/simple`)
+  console.log()
+  console.log('  TX2  RTBIL — ImmutableFlags=0x10006 (tifMPTCanLock, tifMPTRequireAuth, tifMPTMetadata)')
+  console.log(`  ${EXPLORER}/transactions/${results.tx2.hash}/simple`)
+  console.log()
+
+  console.log('── MPTokenIssuanceSet / Simple view ────────────────────────────────')
+  console.log('  TX3  tfMPTSetCanEscrow + tfMPTSetCanTrade (see Detail tab for flag decode)')
+  console.log(`  ${EXPLORER}/transactions/${results.tx3.hash}/simple`)
+  console.log()
+  console.log('  TX4  TransferFee + Metadata (JSON) + ImmutableFlags rows')
+  console.log(`  ${EXPLORER}/transactions/${results.tx4.hash}/simple`)
+  console.log()
+
+  console.log('── MPT token Settings page ─────────────────────────────────────────')
+  console.log('  Issuance A  DYNX — "Can Enable" on unlocked caps; CanTrade+CanTransfer+TransferFee → "Immutable"')
+  console.log(`  ${EXPLORER}/token/mpt/${results.tx1.issuanceId}`)
+  console.log()
+  console.log('  Issuance B  RTBIL — CanLock+RequireAuth+Metadata → "Immutable"; TransferFee still mutable')
+  console.log(`  ${EXPLORER}/token/mpt/${results.tx2.issuanceId}`)
+  console.log()
+  console.log('═══════════════════════════════════════════════════════════════════')
+}
+
+main().catch(err => {
+  console.error('\nFatal:', err.message)
+  process.exit(1)
+})