Xahau/xahaud 2025.5.1-release+1762

on GitHub

Feature: Touch

This amendment ensures all accounts involved in a transaction (all transactional stakeholders) are forced to appear in its metadata by incrementing a "touch counter" even if nothing else on the account was changed. This is named for the unix file utility touch. This provides better audit consistency and ease of programming automated tools.

Feature: Remarks

The Remarks amendment allow key-value pairs (similar to hook state) to be stored by object owners on those objects. This is akin to flipping over a document and hand-writing a note on it. Remarks can be anything and mean different things to different parties. Remarks can also be set to immutable. Remarks follow an object through a changes of ownership and can be used to achieve novel use cases like dynamic NFTs and simplify some otherwise very complicated hook state operations.

{
  "TransactionType": "SetRemarks",
  "ObjectID": "<32 byte hex keylet here>",
  "Remarks": [  // this array is a delta allowing adding or removing entries
    {
      "RemarkName": "<hex up to 256 bytes>",
      "RemarkValue": "<hex up to 256 bytes, or empty to delete the key at this entry>",
      "Flags": 1, // immutable if 1, mutable if 0
    }, ... // more entries as desired up to 32 remarks per object.
}

Most object types can have remarks attached to them by the obvious owner, including Account Root, Offer, Escrow, Ticket, Paychan, Check, URIToken, etc.

Feature: HookCanEmit

This amendment adds a new field to HookSet objects: HookCanEmit is syntactically identical to the HookOn field, except that it controls which transaction types the Hook is allowed to emit rather than which transaction types trigger the hook. Note that it uses the same active-low semantics as HookOn with SetHook being active high. However if the field is absent it's taken to be that the Hook may emit any transaction including SetHook.

Feature: Catalogue

This is a non-amendment feature which allows full history to be saved into solidly compressed "catalogue files" and then subsequently loaded on other machines.

{
  "command":"catalogue_create",
  "output_file":"/root/cat.12650000.12950000.hashed",
  "min_ledger": 12650000,
  "max_ledger":12950000,
  "compression_level":9
}

{
  "command":"catalogue_load",
  "input_file":"/root/cat.3"
}

{
  "command":"catalogue_status"
}

Fixes: fixRewardClaimFlags, other non-amendment fixes.

Fix for invalid flags on certain transactions. Various minor fixes for consistency and RPC performance.