Subject mappings - account-hash() function
Author: roeschterCreated Sep 21, 2026Updated Sep 28, 2026
Labelsproposal
Proposed change
The following functions should be provided in subject mappings
- {{account-hash()}} //Hash of current account
- {{account-hash()}} //Hash the given account name
- {{account-hash-import()}} //Use the account form the same import section if present
- {{account-hash-leaf-remote()}} //Use the remote account name for the leaf node connection
Use case
Now that $JS.FC and $JS.ACK subjects can be scoped to account-hash() with the js_ack_fc_v2 flag as per ADR-53- , it would be useful to expose the account hash to end users, as it can be useful to on it on accounts on cross account import/export as well as leaf node connections. We suggest to expose the hash function in subject mappings
Structure of new style ACK and FC subjects
$JS.ACK.<domain>.<account hash>.<stream>.<consumer>.<num delivered>.<stream sequence>.<consumer sequence>.<timestamp>.<num pending>
$JS.FC.<domain>.<account hash>.<stream>.<consumer>.<4-char random>Contribution
No response
Submission acknowledgment
- I am a human being writing in my own words and not an AI agent. I will not use an AI agent to communicate on my behalf in this issue, either directly or via copy-paste.
Source: nats-io/nats-server