Support for Dynamic MPTs (XLS-94D)

.ci-config/rippled.cfg

@@ -193,6 +193,7 @@ Batch
 PermissionedDEX
 TokenEscrow
 SingleAssetVault
+DynamicMPT
 
 # This section can be used to simulate various FeeSettings scenarios for rippled node in standalone mode
 [voting]

.github/workflows/nodejs.yml

@@ -122,8 +122,11 @@ jobs:
           fetch-depth: 0
 
       - name: Run docker in background
+        id: run-docker
         run: |
           docker run --detach --rm -p 6006:6006 --volume "${{ github.workspace }}/.ci-config/":"/etc/opt/ripple/" --name rippled-service --health-cmd="rippled server_info || exit 1" --health-interval=5s --health-retries=10 --health-timeout=2s --env GITHUB_ACTIONS=true --env CI=true --entrypoint bash ${{ env.RIPPLED_DOCKER_IMAGE }} -c "rippled -a"
+          CONTAINER_ID=$(docker ps -aqf "name=rippled-service")
+          echo "docker-container-id=$CONTAINER_ID" >> $GITHUB_OUTPUT
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
@@ -154,6 +157,17 @@ jobs:
 
       - run: npm run build
 
+      - name: Check if Docker container is running
+        id: check-docker-container
+        run: |
+          if ! docker ps | grep -q rippled-service; then
+            echo "INFO: Currently running docker containers:"
+            docker ps
+            echo "ERROR: rippled-service Docker container is not running"
+            exit 1
+          fi
+          docker inspect ${{ steps.run-docker.outputs.docker-container-id }}
+
       - name: Run integration test
         run: npm run test:integration
 
@@ -181,8 +195,11 @@ jobs:
           node-version: ${{ matrix.node-version }}
 
       - name: Run docker in background
+        id: run-docker
         run: |
           docker run --detach --rm -p 6006:6006 --volume "${{ github.workspace }}/.ci-config/":"/etc/opt/ripple/" --name rippled-service --health-cmd="rippled server_info || exit 1" --health-interval=5s --health-retries=10 --health-timeout=2s --env GITHUB_ACTIONS=true --env CI=true --entrypoint bash ${{ env.RIPPLED_DOCKER_IMAGE }} -c "rippled -a"
+          CONTAINER_ID=$(docker ps -aqf "name=rippled-service")
+          echo "docker-container-id=$CONTAINER_ID" >> $GITHUB_OUTPUT
 
       - name: Setup npm version 10
         run: |
@@ -208,6 +225,17 @@ jobs:
 
       - run: npm run build
 
+      - name: Check if Docker container is running
+        id: check-docker-container
+        run: |
+          if ! docker ps | grep -q rippled-service; then
+            echo "INFO: Currently running docker containers:"
+            docker ps
+            echo "ERROR: rippled-service Docker container is not running"
+            exit 1
+          fi
+          docker inspect ${{ steps.run-docker.outputs.docker-container-id }}
+
       - name: Run integration test
         run: npm run test:browser
 

packages/ripple-binary-codec/src/enums/definitions.json

@@ -680,6 +680,16 @@
         "type": "UInt32"
       }
     ],
+    [
+      "MutableFlags",
+      {
+        "isSerialized": true,
+        "isSigningField": true,
+        "isVLEncoded": false,
+        "nth": 53,
+        "type": "UInt32"
+      }
+    ],
     [
       "IndexNext",
       {

packages/xrpl/HISTORY.md

@@ -4,6 +4,9 @@ Subscribe to [the **xrpl-announce** mailing list](https://groups.google.com/g/xr
 
 ## Unreleased
 
+### Added
+* Support for `Dynamic MPT` (XLS-94D)
+
 ### Fixed
 * Fix incorrect type checking in `validateVaultCreate` that prevented vault creation with MPT as an asset.
 

packages/xrpl/src/models/ledger/LedgerEntry.ts

@@ -10,6 +10,7 @@ import DirectoryNode from './DirectoryNode'
 import Escrow from './Escrow'
 import FeeSettings from './FeeSettings'
 import LedgerHashes from './LedgerHashes'
+import { MPTokenIssuance } from './MPTokenIssuance'
 import NegativeUNL from './NegativeUNL'
 import Offer from './Offer'
 import Oracle from './Oracle'
@@ -46,6 +47,7 @@ type LedgerEntry =
   | Vault
   | XChainOwnedClaimID
   | XChainOwnedCreateAccountClaimID
+  | MPTokenIssuance
 
 type LedgerEntryFilter =
   | 'account'

packages/xrpl/src/models/ledger/MPTokenIssuance.ts

@@ -11,4 +11,92 @@ export interface MPTokenIssuance extends BaseLedgerEntry, HasPreviousTxnID {
   MPTokenMetadata?: string
   OwnerNode?: string
   LockedAmount?: string
+  DomainID?: string
+  MutableFlags: number
+}
+
+export interface MPTokenIssuanceFlagsInterface {
+  lsfMPTLocked?: boolean
+  lsfMPTCanLock?: boolean
+  lsfMPTRequireAuth?: boolean
+  lsfMPTCanEscrow?: boolean
+  lsfMPTCanTrade?: boolean
+  lsfMPTCanTransfer?: boolean
+  lsfMPTCanClawback?: boolean
+
+  /**
+   * Indicates flag lsfMPTCanLock can be changed
+   */
+  lsmfMPTCanMutateCanLock?: boolean
+  /**
+   * Indicates flag lsfMPTRequireAuth can be changed
+   */
+  lsmfMPTCanMutateRequireAuth?: boolean
+  /**
+   * Indicates flag lsfMPTCanEscrow can be changed
+   */
+  lsmfMPTCanMutateCanEscrow?: boolean
+  /**
+   * Indicates flag lsfMPTCanTrade can be changed
+   */
+  lsmfMPTCanMutateCanTrade?: boolean
+  /**
+   * Indicates flag lsfMPTCanTransfer can be changed
+   */
+  lsmfMPTCanMutateCanTransfer?: boolean
+  /**
+   * Indicates flag lsfMPTCanClawback can be changed
+   */
+  lsmfMPTCanMutateCanClawback?: boolean
+  /**
+   * Allows field MPTokenMetadata to be modified
+   */
+  lsmfMPTCanMutateMetadata?: boolean
+  /**
+   * Allows field TransferFee to be modified
+   */
+  lsmfMPTCanMutateTransferFee?: boolean
+}
+
+export enum MPTokenIssuanceFlags {
+  lsfMPTLocked = 0x00000001,
+  lsfMPTCanLock = 0x00000002,
+  lsfMPTRequireAuth = 0x00000004,
+  lsfMPTCanEscrow = 0x00000008,
+  lsfMPTCanTrade = 0x00000010,
+  lsfMPTCanTransfer = 0x00000020,
+  lsfMPTCanClawback = 0x00000040,
+
+  /**
+   * Indicates flag lsfMPTCanLock can be changed
+   */
+  lsmfMPTCanMutateCanLock = 0x00000002,
+  /**
+   * Indicates flag lsfMPTRequireAuth can be changed
+   */
+  lsmfMPTCanMutateRequireAuth = 0x00000004,
+  /**
+   * Indicates flag lsfMPTCanEscrow can be changed
+   */
+  lsmfMPTCanMutateCanEscrow = 0x00000008,
+  /**
+   * Indicates flag lsfMPTCanTrade can be changed
+   */
+  lsmfMPTCanMutateCanTrade = 0x00000010,
+  /**
+   * Indicates flag lsfMPTCanTransfer can be changed
+   */
+  lsmfMPTCanMutateCanTransfer = 0x00000020,
+  /**
+   * Indicates flag lsfMPTCanClawback can be changed
+   */
+  lsmfMPTCanMutateCanClawback = 0x00000040,
+  /**
+   * Allows field MPTokenMetadata to be modified
+   */
+  lsmfMPTCanMutateMetadata = 0x00010000,
+  /**
+   * Allows field TransferFee to be modified
+   */
+  lsmfMPTCanMutateTransferFee = 0x00020000,
 }