Namespaces
Prevent state clobbering by using the correct namespace
Last updated
Was this helpful?
Prevent state clobbering by using the correct namespace
Last updated
Was this helpful?
To avoid two or more Hooks installed on the same account unintentionally clobbering each-other's , a 32 byte namespace must be provided when creating or installing each Hook.
The namespace may be any arbitrary 32 byte value the developer chooses. Provided the namespace is unique in the Hook chain no state clobbering will occur.
We strongly recommended using SHA256 over the developer's working name for the Hook. SHA256 is one of the two hashing algorithms used in the derivation of Xahau addresses (from an account master key), and, as such, it should be readily available to the developer.
The HookNamespace field is supplied as a 32 byte hex blob inside each Hook object in a Hooks array when .
The configured Namespace a Hook operates under alters the its is stored under. Therefore two Hooks under two different Namespaces installed on the same Xahau account may use the same state key to refer to different state objects. Conversely, two different Hooks using the same Namespace on the same Xahau account can access and modify eachother's state objects using the same state keys.
In javascript, importing the ripple-address-codec yields access to SHA256.
(It is also possible to use crypto.subtle in browser, or crypto.createHash in node to access this hash algorithm.)
The first user to defines a HookNamespace which becomes the Default Namespace for that Hook. This means any subsequent users who will receive this originally set Namespace by default.
The subsequent user may specify their own Namespace, overriding the Default Namespace for their installation only.
Choice of HookNamespace affects the behaviour of the following Hook APIs:
See and for information about how to query the ledger regarding namespaces.