Chaining
Chain multiple hooks together to do more useful tasks
Last updated
Was this helpful?
Chain multiple hooks together to do more useful tasks
Last updated
Was this helpful?
👍 Hook Design Philosophy
Each Hook should do one thing, and do it really well.
In the early days of Hooks it was only possible to install one Hook per account. This meant users were forced to produce omnibus Hooks if they wanted to do more than one thing: for example offset carbon and firewall at the same time.
This was counter to the Hook Design Philosophy, so Hook Chaining was introduced.
A Hook Chain is a sequence of up to 10 Hooks installed on an Xahau account.
A Hook Chain executes successfully when every Hook in the chain has been individually executed and subsequently calls .
Each chain's execution starts at chain position 0 and ends at chain position 9. If a position is blank (because it was never filled or because the hook that was installed there has been removed) then that position is skipped and treated as successful.
In order for a transaction to succeed, both ends of the transaction (sending side and receiving side) must have executed successfully. This means if there is a Hook Chain installed on both sides, then both Hook Chains must execute successfully for the transaction to succeed.
Hooks are installed into the chain using the . When they are installed, the installer may specify install-time which may change the behaviour of the installed Hook.
cbak execution if this was an Emitted Transaction.
Any Again as Weak (AAW) Hooks. Execution order for AAW is first numerically according to Account ID then numerically according to Hook position.
In addition to the install-time operations specified in the , Hooks have some runtime control over chain execution:
A Hook may determine its own HookHash by calling .
A Hook may determine its location in the Hook Chain using .
A Hook may skip (or re-enable) another Hook further down the chain using .
A Hook may modify the of a Hook further down the chain using .
Hook Chains are . However any Hook in any chain may flag that it requires a second, Weak Execution by calling . If all Hook Chains execute successfully then the originating transaction is applied. Once the originating transaction has been applied any Weak Executions may happen, in the following order:
Weak Transactional Stake Holders who have opted in to allow a . Execution order is first-come first-serve according to the event that caused the TSH to be flagged (such as pathing).
