@rootzero/contracts 1.13.0 → 1.14.0

package/blocks/Cursors.sol

@@ -1,1529 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {AssetAmount, AccountAsset, AccountAmount, HostAmount, HostAccountAsset, Tx} from "../core/Types.sol";
-import {Sizes} from "./Schema.sol";
-import {Keys} from "./Keys.sol";
-
-/// @notice Zero-copy view into a calldata block stream.
-/// All positions (`i`) are byte offsets relative to the start of the source region.
-/// The absolute calldata location of byte `i` is `offset + i`.
-struct Cur {
-    /// @dev Absolute calldata byte offset of the source region start.
-    uint offset;
-    /// @dev Current read position, relative to the source start.
-    uint i;
-    /// @dev Total byte length of the source region.
-    uint len;
-}
-
-/// @notice Mutable reader over a block stream stored in memory.
-/// All positions (`i`) are byte offsets relative to the start of `source`.
-struct Reader {
-    /// @dev Current read position, relative to the source start.
-    uint i;
-    /// @dev Memory bytes containing the complete source region.
-    bytes source;
-}
-
-using Cursors for Cur;
-using Readers for Reader;
-
-/// @title Readers
-/// @notice Memory block stream parser for the rootzero protocol.
-/// A `Reader` advances through an existing `bytes memory` source without copying its contents.
-/// Blocks are encoded as `[bytes4 key][bytes4 payloadLen][payload]`.
-library Readers {
-    /// @dev The current block has a truncated header or payload, an unexpected key,
-    ///      or a payload size outside the accepted range.
-    error InvalidBlock();
-
-    /// @notice Create a reader backed by a memory byte array.
-    /// @param source Memory bytes containing the block stream.
-    /// @return cur Reader positioned at the beginning of `source`.
-    function open(bytes memory source) internal pure returns (Reader memory cur) {
-        cur.source = source;
-    }
-
-    /// @notice Return whether the reader has consumed its entire source.
-    /// @param cur Reader whose position should be checked.
-    /// @return Whether `cur.i` equals the source length.
-    function done(Reader memory cur) internal pure returns (bool) {
-        return cur.i == cur.source.length;
-    }
-
-    /// @notice Return whether the reader has bytes left to consume.
-    /// @param cur Reader whose position should be checked.
-    /// @return Whether `cur.i` differs from the source length.
-    function more(Reader memory cur) internal pure returns (bool) {
-        return cur.i != cur.source.length;
-    }
-
-    /// @notice Validate and consume the current block, advancing `cur.i` past it.
-    /// @param cur Reader to advance.
-    /// @param key Expected block key.
-    /// @param min Minimum payload length.
-    /// @param max Maximum payload length; zero means unbounded.
-    /// @return abs Absolute memory address of the payload start.
-    function consume(
-        Reader memory cur,
-        bytes4 key,
-        uint min,
-        uint max
-    ) internal pure returns (uint abs) {
-        bytes memory source = cur.source;
-        uint i = cur.i;
-
-        if (i > source.length || source.length - i < Sizes.Header) revert InvalidBlock();
-
-        bytes4 current;
-        uint len;
-        assembly ("memory-safe") {
-            let header := mload(add(add(source, 0x20), i))
-            current := header
-            len := and(shr(192, header), 0xffffffff)
-            abs := add(add(source, 0x28), i)
-        }
-
-        if (current != key || len < min || (max != 0 && len > max)) revert InvalidBlock();
-        if (len > source.length - i - Sizes.Header) revert InvalidBlock();
-        cur.i = i + Sizes.Header + len;
-    }
-
-    /// @notice Consume a BALANCE block and return its fields.
-    /// @param cur Reader; advanced past the block.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackBalance(Reader memory cur) internal pure returns (bytes32 asset, uint amount) {
-        uint abs = consume(cur, Keys.Balance, 64, 64);
-        assembly ("memory-safe") {
-            asset := mload(abs)
-            amount := mload(add(abs, 0x20))
-        }
-    }
-
-    /// @notice Consume a TRANSACTION block and return its fields.
-    /// @param cur Reader; advanced past the block.
-    /// @return from Source account identifier.
-    /// @return to Destination account identifier.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackTransaction(
-        Reader memory cur
-    ) internal pure returns (bytes32 from, bytes32 to, bytes32 asset, uint amount) {
-        uint abs = consume(cur, Keys.Transaction, 128, 128);
-        assembly ("memory-safe") {
-            from := mload(abs)
-            to := mload(add(abs, 0x20))
-            asset := mload(add(abs, 0x40))
-            amount := mload(add(abs, 0x60))
-        }
-    }
-}
-
-/// @title Cursors
-/// @notice Calldata block stream parser for the rootzero protocol.
-/// A `Cur` is a lightweight view into a slice of `msg.data`; no data is copied.
-/// Blocks are encoded as `[bytes4 key][bytes4 payloadLen][payload]`.
-library Cursors {
-    /// @dev Source region contains a block whose declared length exceeds the region boundary,
-    ///      or a header read would go out of bounds.
-    error MalformedBlocks();
-    /// @dev Current block key does not match the expected key, or payload size is out of range.
-    error InvalidBlock();
-    /// @dev `complete` called but the cursor has not consumed exactly to `len`.
-    error IncompleteCursor();
-    /// @dev `run` found zero blocks of the expected key; the cursor region is empty.
-    error ZeroCursor();
-    /// @dev `run` was called with a zero group size.
-    error ZeroGroup();
-    /// @dev An account field was required but the block or fallback was zero.
-    error ZeroAccount();
-    /// @dev A node field was required but the block or fallback was zero.
-    error ZeroNode();
-    /// @dev A field value did not match the expected value.
-    error UnexpectedValue();
-    /// @dev Prime block counts are not divisible by, or do not match, their declared group sizes.
-    error BadRatio();
-
-    // -------------------------------------------------------------------------
-    // Cursor construction and navigation
-    // -------------------------------------------------------------------------
-
-    /// @notice Create a cursor backed by a calldata slice.
-    /// @param source Calldata slice that forms the block stream.
-    /// @return cur Cursor positioned at the beginning of `source`.
-    function open(bytes calldata source) internal pure returns (Cur memory cur) {
-        uint offset;
-        // Extract the absolute calldata offset of `source` using inline assembly,
-        // as Solidity does not expose this directly for calldata slices.
-        assembly ("memory-safe") {
-            offset := source.offset
-        }
-        cur.offset = offset;
-        cur.len = source.length;
-    }
-
-    /// @notice Create a cursor backed by `source[i:]`.
-    /// @param source Calldata slice that forms the parent block stream.
-    /// @param i Start byte offset within `source`.
-    /// @return cur Cursor positioned at the beginning of `source[i:]`.
-    function open(bytes calldata source, uint i) internal pure returns (Cur memory cur) {
-        return open(source[i:]);
-    }
-
-    /// @notice Create a cursor over `source` and restrict it to its first grouped run.
-    /// Equivalent to `open(source)`, reading the current key, then `run(key, group)`.
-    /// When `group` is zero, `source` must be empty and the function returns an empty cursor.
-    /// @param source Calldata slice that forms the block stream.
-    /// @param group Expected block group size (e.g. 1 for single, 2 for paired); 0 means empty.
-    /// @return cur Cursor with `len` truncated to the end of the first run in `source`.
-    /// @return groups Number of block groups in the run (`block count / group`).
-    function init(bytes calldata source, uint group) internal pure returns (Cur memory cur, uint groups) {
-        cur = open(source);
-        if (group == 0) {
-            if (cur.len != 0) revert IncompleteCursor();
-            return (cur, 0);
-        }
-        if (cur.len == 0) revert ZeroCursor();
-        (bytes4 key, ) = cur.peek(cur.i);
-        groups = cur.run(key, group);
-    }
-
-    /// @notice Move the cursor to an absolute position within the source region.
-    /// @param cur Cursor to update.
-    /// @param i New read position (byte offset relative to source start).
-    /// @return Updated cursor with `cur.i == i`.
-    function seek(Cur memory cur, uint i) internal pure returns (Cur memory) {
-        if (i > cur.len) revert MalformedBlocks();
-        cur.i = i;
-        return cur;
-    }
-
-    /// @notice Advance the cursor by `n` bytes within the source region.
-    /// Reverts with `IncompleteCursor` if `n` exceeds the remaining cursor region length.
-    /// @param cur Cursor to advance.
-    /// @param n Number of bytes to skip from the current read position.
-    function skip(Cur memory cur, uint n) internal pure returns (Cur memory) {
-        if (n > cur.len - cur.i) revert IncompleteCursor();
-        cur.i += n;
-        return cur;
-    }
-
-    /// @notice Advance the cursor to a later absolute position within the source region.
-    /// Reverts with `IncompleteCursor` if `i` exceeds the cursor region length or is before `cur.i`.
-    /// @param cur Cursor to advance.
-    /// @param i New read position (byte offset relative to source start).
-    function skipTo(Cur memory cur, uint i) internal pure returns (Cur memory) {
-        if (i > cur.len || cur.i > i) revert IncompleteCursor();
-        cur.i = i;
-        return cur;
-    }
-
-    /// @notice Create a subcursor over the half-open range `[from, to)` within the source region.
-    /// The returned cursor starts at position zero within that sliced region.
-    /// @param cur Source cursor.
-    /// @param from Start byte offset within the source region (inclusive).
-    /// @param to End byte offset within the source region (exclusive).
-    /// @return out Cursor scoped to the requested sub-range.
-    function slice(Cur memory cur, uint from, uint to) internal pure returns (Cur memory out) {
-        if (from > to || to > cur.len) revert MalformedBlocks();
-        out.offset = cur.offset + from;
-        out.len = to - from;
-    }
-
-    /// @notice Return the full cursor region as a calldata slice.
-    /// Does not advance the cursor; `cur.i` is ignored.
-    /// @param cur Cursor whose backing region should be returned.
-    /// @return data Calldata view over `[cur.offset, cur.offset + cur.len)`.
-    function raw(Cur memory cur) internal pure returns (bytes calldata data) {
-        if (cur.len > msg.data.length || cur.offset > msg.data.length - cur.len) revert MalformedBlocks();
-        data = msg.data[cur.offset:cur.offset + cur.len];
-    }
-
-    /// @notice Return a sub-range of the cursor region as a calldata slice.
-    /// Does not advance the cursor; `cur.i` is ignored.
-    /// @param cur Source cursor.
-    /// @param from Start byte offset within the source region (inclusive).
-    /// @param to End byte offset within the source region (exclusive).
-    /// @return data Calldata view over the requested sub-range.
-    function raw(Cur memory cur, uint from, uint to) internal pure returns (bytes calldata data) {
-        if (from > to || to > cur.len) revert MalformedBlocks();
-        if (cur.len > msg.data.length || cur.offset > msg.data.length - cur.len) revert MalformedBlocks();
-        data = msg.data[cur.offset + from:cur.offset + to];
-    }
-
-    /// @notice Hash a sub-range of the cursor region.
-    /// Does not advance the cursor; `from` and `to` are relative to the source region.
-    /// @param cur Source cursor.
-    /// @param from Start byte offset within the source region (inclusive).
-    /// @param to End byte offset within the source region (exclusive).
-    /// @return digest Keccak256 hash of the requested sub-range.
-    function hash(Cur memory cur, uint from, uint to) internal pure returns (bytes32 digest) {
-        digest = keccak256(cur.raw(from, to));
-    }
-
-    /// @notice Read a block header at position `i` without advancing the cursor.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the block header within the source region.
-    /// @return key Four-byte block type identifier.
-    /// @return len Payload byte length declared in the header.
-    function peek(Cur memory cur, uint i) internal pure returns (bytes4 key, uint len) {
-        if (i + Sizes.Header > cur.len) revert MalformedBlocks();
-        uint abs = cur.offset + i;
-        key = bytes4(msg.data[abs:abs + 4]);
-        len = uint32(bytes4(msg.data[abs + 4:abs + 8]));
-        if (i + Sizes.Header + len > cur.len) revert MalformedBlocks();
-    }
-
-    /// @notice Return the byte offset immediately past the block at the current cursor position.
-    /// Does not advance the cursor.
-    /// @param cur Source cursor.
-    /// @return Byte offset immediately past the current block, relative to the source region.
-    function past(Cur memory cur) internal pure returns (uint) {
-        (, uint len) = peek(cur, cur.i);
-        return cur.i + Sizes.Header + len;
-    }
-
-    /// @notice Return true if position `i` is at a block header with the given key.
-    /// Returns false when `i` is out of bounds or the key differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the block header within the source region.
-    /// @param key Expected block type identifier.
-    /// @return Whether the block header at `i` uses `key`.
-    function hasAt(Cur memory cur, uint i, bytes4 key) internal pure returns (bool) {
-        if (i > cur.len || Sizes.Header > cur.len - i) return false;
-        uint abs = cur.offset + i;
-        return bytes4(msg.data[abs:abs + 4]) == key;
-    }
-
-    /// @notice Return true if the current cursor position is at a block header with the given key.
-    /// Returns false when `cur.i` is out of bounds or the key differs.
-    /// @param cur Source cursor.
-    /// @param key Expected block type identifier.
-    /// @return Whether the block header at `cur.i` uses `key`.
-    function isAt(Cur memory cur, bytes4 key) internal pure returns (bool) {
-        return cur.hasAt(cur.i, key);
-    }
-
-    /// @notice Enter a block at the current position and return its next offset.
-    /// Advances `cur.i` past the block header so the payload can be parsed
-    /// directly from the same cursor. The returned `next` is the byte offset
-    /// immediately after the block payload, relative to the current cursor region.
-    /// @param cur Cursor positioned at the expected block; advanced past the 8-byte header.
-    /// @param key Expected block key.
-    /// @param min Minimum acceptable payload length.
-    /// @param max Maximum acceptable payload length; 0 means unbounded.
-    /// @return next Byte offset immediately after the block payload.
-    function enter(Cur memory cur, bytes4 key, uint min, uint max) internal pure returns (uint next) {
-        (bytes4 current, uint len) = peek(cur, cur.i);
-        if (current != key) revert InvalidBlock();
-        if (len < min || (max != 0 && len > max)) revert InvalidBlock();
-        next = cur.i + Sizes.Header + len;
-        cur.i += Sizes.Header;
-    }
-
-    /// @notice Validate a block at position `i` and return its payload location.
-    /// Does not advance the cursor.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the block within the source region.
-    /// @param end Required next offset after the block; 0 means no exact-end check.
-    /// @param key Expected block type key; reverts if actual key differs.
-    /// @param min Minimum acceptable payload length (inclusive).
-    /// @param max Maximum acceptable payload length (inclusive); 0 means unbounded.
-    /// @return abs Absolute calldata offset of the payload start.
-    /// @return next Byte offset of the block immediately following this one (relative to source start).
-    function expect(
-        Cur memory cur,
-        uint i,
-        uint end,
-        bytes4 key,
-        uint min,
-        uint max
-    ) internal pure returns (uint abs, uint next) {
-        (bytes4 current, uint len) = peek(cur, i);
-        if (current != key) revert InvalidBlock();
-        if (len < min || (max != 0 && len > max)) revert InvalidBlock();
-        abs = cur.offset + i + Sizes.Header;
-        next = i + Sizes.Header + len;
-        if (end != 0 && next != end) revert IncompleteCursor();
-    }
-
-    /// @notice Validate and consume the current block, advancing `cur.i` past it.
-    /// @param cur Cursor to advance.
-    /// @param end Required next offset after the block; 0 means no exact-end check.
-    /// @param key Expected block type key.
-    /// @param min Minimum payload length.
-    /// @param max Maximum payload length (0 = unbounded).
-    /// @return abs Absolute calldata offset of the payload start.
-    function consume(Cur memory cur, uint end, bytes4 key, uint min, uint max) internal pure returns (uint abs) {
-        uint next;
-        (abs, next) = expect(cur, cur.i, end, key, min, max);
-        cur.i = next;
-    }
-
-    /// @notice Count consecutive blocks of the same key starting at `i`.
-    /// @param cur Source cursor.
-    /// @param i Starting byte offset within the source region.
-    /// @param key Block type to count.
-    /// @return total Number of consecutive matching blocks.
-    /// @return next Byte offset immediately after the last counted block.
-    function countRun(Cur memory cur, uint i, bytes4 key) internal pure returns (uint total, uint next) {
-        next = i;
-        while (next < cur.len) {
-            (bytes4 current, uint len) = peek(cur, next);
-            if (current != key) break;
-            next += Sizes.Header + len;
-
-            unchecked {
-                ++total;
-            }
-        }
-    }
-
-    /// @notice Restrict the cursor to the consecutive run of `key` at its current position.
-    /// Counts the run, truncates `cur.len` to the run end, and validates that the
-    /// count is a multiple of `group`.
-    /// @param cur Cursor to restrict; `cur.len` is updated in place.
-    /// @param key Expected block type identifier of the run.
-    /// @param group Expected group size (e.g. 1 for single-asset, 2 for paired input/output).
-    /// @return groups Number of groups represented by the run (`block count / group`).
-    function run(Cur memory cur, bytes4 key, uint group) internal pure returns (uint groups) {
-        if (group == 0) revert ZeroGroup();
-        (uint count, uint next) = countRun(cur, cur.i, key);
-        if (count == 0) revert ZeroCursor();
-        if (count % group != 0) revert BadRatio();
-        cur.len = next;
-        groups = count / group;
-    }
-
-    /// @notice Scan forward from `i` for the first block matching `key`.
-    /// @param cur Source cursor.
-    /// @param i Starting byte offset for the search.
-    /// @param key Block type to find.
-    /// @return Byte offset of the matching block, or `cur.len` if not found.
-    function find(Cur memory cur, uint i, bytes4 key) internal pure returns (uint) {
-        while (i < cur.len) {
-            (bytes4 current, uint len) = peek(cur, i);
-            if (current == key) return i;
-            i += Sizes.Header + len;
-        }
-        return cur.len;
-    }
-
-    /// @notice Scan forward from the current position for the first block matching `key`.
-    /// @param cur Source cursor.
-    /// @param key Block type to find.
-    /// @return Byte offset of the matching block, or `cur.len` if not found.
-    function find(Cur memory cur, bytes4 key) internal pure returns (uint) {
-        return find(cur, cur.i, key);
-    }
-
-    /// @notice Consume a LIST block and return a cursor over its payload.
-    /// Advances `cur.i` past the full list while the returned cursor is scoped to
-    /// the list members as a fresh zero-based region.
-    /// @param cur Cursor positioned at a list block; advanced past the full list.
-    /// @return items Cursor scoped to the list payload.
-    function list(Cur memory cur) internal pure returns (Cur memory items) {
-        uint next = enter(cur, Keys.List, 0, 0);
-        items = cur.slice(cur.i, next);
-        cur.i = next;
-    }
-
-    /// @notice Consume a block with the given key at the current position and return a cursor over the full block slice.
-    /// Advances `cur.i` past the block while the returned cursor is scoped to the
-    /// full block bytes as a fresh zero-based region.
-    /// @param cur Cursor positioned at the expected block.
-    /// @param key Expected block type key.
-    /// @return out Cursor scoped to the full block.
-    function take(Cur memory cur, bytes4 key) internal pure returns (Cur memory out) {
-        (, uint next) = expect(cur, cur.i, 0, key, 0, 0);
-        out = cur.slice(cur.i, next);
-        cur.i = next;
-    }
-
-    /// @notice Return whether the remaining cursor region is empty or exactly one block with `key`.
-    /// Returns false for an empty remaining region. Reverts if the next block has another key or
-    /// if a matching block is followed by trailing bytes.
-    /// @param cur Source cursor.
-    /// @param key Expected optional block key.
-    /// @return Whether the remaining region contains exactly one block with `key`.
-    function maybeOnly(Cur memory cur, bytes4 key) internal pure returns (bool) {
-        if (cur.i == cur.len) return false;
-        if (!cur.isAt(key)) revert InvalidBlock();
-        if (cur.past() != cur.len) revert IncompleteCursor();
-        return true;
-    }
-
-    /// @notice Consume an optional block with the given key and return a cursor over the full block slice.
-    /// If the current block key does not match, returns an empty cursor and leaves `cur.i` unchanged.
-    /// Otherwise behaves like `take(cur, key)`.
-    /// @param cur Cursor positioned at an optional block.
-    /// @param key Optional block type key.
-    /// @return out Cursor scoped to the full matching block, or empty when no matching block is present.
-    function maybeTake(Cur memory cur, bytes4 key) internal pure returns (Cur memory out) {
-        return cur.isAt(key) ? take(cur, key) : cur.slice(cur.i, cur.i);
-    }
-
-    /// @notice Ensure the cursor is at an exact position.
-    /// Reverts with `IncompleteCursor` if `pos` exceeds the cursor region length
-    /// or `cur.i != pos`.
-    /// @param cur Cursor to check.
-    /// @param pos Relative byte offset the cursor must be positioned at.
-    function ensureAt(Cur memory cur, uint pos) internal pure {
-        if (pos > cur.len || cur.i != pos) revert IncompleteCursor();
-    }
-
-    /// @notice Assert that the cursor has consumed its entire source region.
-    /// Reverts with `IncompleteCursor` when `cur.i != cur.len`.
-    /// @param cur Cursor to check.
-    function complete(Cur memory cur) internal pure {
-        if (cur.i != cur.len) revert IncompleteCursor();
-    }
-
-    // -------------------------------------------------------------------------
-    // Block factory helpers
-    // -------------------------------------------------------------------------
-
-    /// @notice Encode a block with a raw payload.
-    /// @param key Block type key.
-    /// @param data Raw payload bytes.
-    /// @return Encoded block bytes.
-    function createBlock(bytes4 key, bytes memory data) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(data.length)), data);
-    }
-
-    /// @notice Encode a block with a single 32-byte payload word.
-    /// @param key Block type key.
-    /// @param value 32-byte payload.
-    /// @return Encoded block bytes.
-    function createBlock32(bytes4 key, bytes32 value) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(0x20)), value);
-    }
-
-    /// @notice Encode a block with two 32-byte payload words (64-byte payload).
-    /// @param key Block type key.
-    /// @param a First payload word.
-    /// @param b Second payload word.
-    /// @return Encoded block bytes.
-    function createBlock64(bytes4 key, bytes32 a, bytes32 b) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(0x40)), a, b);
-    }
-
-    /// @notice Encode a block with three 32-byte payload words (96-byte payload).
-    /// @param key Block type key.
-    /// @param a First payload word.
-    /// @param b Second payload word.
-    /// @param c Third payload word.
-    /// @return Encoded block bytes.
-    function createBlock96(bytes4 key, bytes32 a, bytes32 b, bytes32 c) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(0x60)), a, b, c);
-    }
-
-    /// @notice Encode a block with four 32-byte payload words (128-byte payload).
-    /// @param key Block type key.
-    /// @param a First payload word.
-    /// @param b Second payload word.
-    /// @param c Third payload word.
-    /// @param d Fourth payload word.
-    /// @return Encoded block bytes.
-    function createBlock128(
-        bytes4 key,
-        bytes32 a,
-        bytes32 b,
-        bytes32 c,
-        bytes32 d
-    ) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(0x80)), a, b, c, d);
-    }
-
-    /// @notice Encode a block with five 32-byte payload words (160-byte payload).
-    /// @param key Block type key.
-    /// @param a First payload word.
-    /// @param b Second payload word.
-    /// @param c Third payload word.
-    /// @param d Fourth payload word.
-    /// @param e Fifth payload word.
-    /// @return Encoded block bytes.
-    function createBlock160(
-        bytes4 key,
-        bytes32 a,
-        bytes32 b,
-        bytes32 c,
-        bytes32 d,
-        bytes32 e
-    ) internal pure returns (bytes memory) {
-        return bytes.concat(key, bytes4(uint32(0xa0)), a, b, c, d, e);
-    }
-
-    /// @notice Encode a BYTES block with a raw payload.
-    /// @param data Raw payload bytes.
-    /// @return Encoded BYTES block bytes.
-    function toBytesBlock(bytes memory data) internal pure returns (bytes memory) {
-        return createBlock(Keys.Bytes, data);
-    }
-
-    /// @notice Encode a STRING block with a UTF-8 payload.
-    /// @param data String payload.
-    /// @return Encoded STRING block bytes.
-    function toStringBlock(string memory data) internal pure returns (bytes memory) {
-        return createBlock(Keys.String, bytes(data));
-    }
-
-    /// @notice Encode a BOUNTY block.
-    /// @param bounty Relayer reward amount.
-    /// @param relayer Relayer account identifier.
-    /// @return Encoded BOUNTY block bytes.
-    function toBountyBlock(uint bounty, bytes32 relayer) internal pure returns (bytes memory) {
-        return createBlock64(Keys.Bounty, bytes32(bounty), relayer);
-    }
-
-    /// @notice Encode a BALANCE block.
-    /// @param asset Asset identifier.
-    /// @param amount Token amount.
-    /// @return Encoded BALANCE block bytes.
-    function toBalanceBlock(bytes32 asset, uint amount) internal pure returns (bytes memory) {
-        return createBlock64(Keys.Balance, asset, bytes32(amount));
-    }
-
-    /// @notice Encode a CUSTODY block.
-    /// @param host Host node ID holding the custody.
-    /// @param asset Asset identifier.
-    /// @param amount Token amount.
-    /// @return Encoded CUSTODY block bytes.
-    function toCustodyBlock(uint host, bytes32 asset, uint amount) internal pure returns (bytes memory) {
-        return createBlock96(Keys.Custody, bytes32(host), asset, bytes32(amount));
-    }
-
-    /// @notice Encode a TRANSACTION block.
-    /// @param from Source account identifier.
-    /// @param to Destination account identifier.
-    /// @param asset Asset identifier.
-    /// @param amount Transfer amount.
-    /// @return Encoded TRANSACTION block bytes.
-    function toTransactionBlock(
-        bytes32 from,
-        bytes32 to,
-        bytes32 asset,
-        uint amount
-    ) internal pure returns (bytes memory) {
-        return createBlock128(Keys.Transaction, from, to, asset, bytes32(amount));
-    }
-
-    /// @notice Encode a STEP block.
-    /// @param target Command target identifier.
-    /// @param resources Packed resources assigned to the step.
-    /// @param request Raw nested request payload.
-    /// @return Encoded STEP block bytes.
-    function toStepBlock(uint target, uint resources, bytes memory request) internal pure returns (bytes memory) {
-        return createBlock(Keys.Step, bytes.concat(bytes32(target), bytes32(resources), toBytesBlock(request)));
-    }
-
-    /// @notice Encode a CALL block.
-    /// @param target Target node identifier.
-    /// @param resources Packed resources assigned to the call.
-    /// @param data Raw calldata payload for the target.
-    /// @return Encoded CALL block bytes.
-    function toCallBlock(uint target, uint resources, bytes memory data) internal pure returns (bytes memory) {
-        return createBlock(Keys.Call, bytes.concat(bytes32(target), bytes32(resources), toBytesBlock(data)));
-    }
-
-    /// @notice Encode a CONTEXT block.
-    /// @param account Command account identifier.
-    /// @param state Embedded state block stream.
-    /// @param request Embedded request block stream.
-    /// @return Encoded CONTEXT block bytes.
-    function toContextBlock(
-        bytes32 account,
-        bytes memory state,
-        bytes memory request
-    ) internal pure returns (bytes memory) {
-        return createBlock(Keys.Context, bytes.concat(account, toBytesBlock(state), toBytesBlock(request)));
-    }
-
-    /// @notice Encode a RELAY block.
-    /// @param portal Destination portal identifier, often the destination host ID.
-    /// @param resources Chain-specific resources for the destination context.
-    /// @param request Nested request block stream.
-    /// @return Encoded RELAY block bytes.
-    function toRelayBlock(uint portal, uint resources, bytes memory request) internal pure returns (bytes memory) {
-        return createBlock(Keys.Relay, bytes.concat(bytes32(portal), bytes32(resources), toBytesBlock(request)));
-    }
-
-    /// @notice Encode a DISPATCH block.
-    /// @param portal Destination portal identifier, often the destination host ID.
-    /// @param resources Chain-specific resources for the destination dispatch.
-    /// @param payload Encoded payload.
-    /// @return Encoded DISPATCH block bytes.
-    function toDispatchBlock(uint portal, uint resources, bytes memory payload) internal pure returns (bytes memory) {
-        return createBlock(Keys.Dispatch, bytes.concat(bytes32(portal), bytes32(resources), toBytesBlock(payload)));
-    }
-
-    // -------------------------------------------------------------------------
-    // Raw calldata loaders
-    // -------------------------------------------------------------------------
-
-    /// @notice Read the next calldata word from the cursor and advance by `n` bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks. Always loads 32 bytes;
-    ///      callers may cast the returned word to `bytesN` when `n < 32`.
-    /// @param cur Cursor whose current position is advanced by `n` bytes.
-    /// @param n Number of bytes to advance.
-    /// @return value Loaded word.
-    function read(Cur memory cur, uint n) internal pure returns (bytes32 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += n;
-    }
-
-    /// @notice Read the next byte from the cursor and advance by 1 byte.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 1 byte.
-    /// @return value Loaded bytes1 value.
-    function read1(Cur memory cur) internal pure returns (bytes1 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 1;
-    }
-
-    /// @notice Read the next 2 bytes from the cursor and advance by 2 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 2 bytes.
-    /// @return value Loaded bytes2 value.
-    function read2(Cur memory cur) internal pure returns (bytes2 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 2;
-    }
-
-    /// @notice Read the next 4 bytes from the cursor and advance by 4 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 4 bytes.
-    /// @return value Loaded bytes4 value.
-    function read4(Cur memory cur) internal pure returns (bytes4 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 4;
-    }
-
-    /// @notice Read the next 8 bytes from the cursor and advance by 8 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 8 bytes.
-    /// @return value Loaded bytes8 value.
-    function read8(Cur memory cur) internal pure returns (bytes8 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 8;
-    }
-
-    /// @notice Read the next 16 bytes from the cursor and advance by 16 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 16 bytes.
-    /// @return value Loaded bytes16 value.
-    function read16(Cur memory cur) internal pure returns (bytes16 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 16;
-    }
-
-    /// @notice Read the next 32-byte word from the cursor and advance by one word.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 32 bytes.
-    /// @return value Loaded word.
-    function read32(Cur memory cur) internal pure returns (bytes32 value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 32;
-    }
-
-    /// @notice Read the next uint from the cursor and advance by one word.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 32 bytes.
-    /// @return value Loaded uint value.
-    function readUint(Cur memory cur) internal pure returns (uint value) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            value := calldataload(abs)
-        }
-        cur.i += 32;
-    }
-
-    /// @notice Read the next two 32-byte words from the cursor and advance by 64 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 64 bytes.
-    /// @return a First loaded word.
-    /// @return b Second loaded word.
-    function read64(Cur memory cur) internal pure returns (bytes32 a, bytes32 b) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            a := calldataload(abs)
-            b := calldataload(add(abs, 0x20))
-        }
-        cur.i += 64;
-    }
-
-    /// @notice Read the next three 32-byte words from the cursor and advance by 96 bytes.
-    /// @dev Performs no bounds, key, length, or cursor checks.
-    /// @param cur Cursor whose current position is advanced by 96 bytes.
-    /// @return a First loaded word.
-    /// @return b Second loaded word.
-    /// @return c Third loaded word.
-    function read96(Cur memory cur) internal pure returns (bytes32 a, bytes32 b, bytes32 c) {
-        uint abs = cur.offset + cur.i;
-        assembly ("memory-safe") {
-            a := calldataload(abs)
-            b := calldataload(add(abs, 0x20))
-            c := calldataload(add(abs, 0x40))
-        }
-        cur.i += 96;
-    }
-
-    /// @notice Consume the next 32-byte word and require it to match `expected`.
-    /// @dev Performs no bounds, key, length, or cursor checks beyond the value comparison.
-    /// @param cur Cursor whose current position is advanced by 32 bytes.
-    /// @param expected Required word value.
-    function require32(Cur memory cur, bytes32 expected) internal pure {
-        if (read32(cur) != expected) revert UnexpectedValue();
-    }
-
-    // -------------------------------------------------------------------------
-    // unpack* - consume current block and decode payload fields
-    // -------------------------------------------------------------------------
-
-    // Generic fixed-width decoders
-
-    /// @notice Consume a dynamic block with the given key and return the raw payload as a calldata slice.
-    /// The payload length is variable; the returned slice covers the entire payload.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return data Raw block payload bytes.
-    function unpackRaw(Cur memory cur, bytes4 key) internal pure returns (bytes calldata data) {
-        (uint abs, uint next) = expect(cur, cur.i, 0, key, 0, 0);
-        data = msg.data[abs:cur.offset + next];
-        cur.i = next;
-    }
-
-    /// @notice Consume a reserved BYTES block and return its raw payload.
-    /// @param cur Cursor; advanced past the BYTES block.
-    /// @return data Raw BYTES payload.
-    function unpackBytes(Cur memory cur) internal pure returns (bytes calldata data) {
-        return unpackRaw(cur, Keys.Bytes);
-    }
-
-    /// @notice Consume a reserved STRING block and return its UTF-8 payload.
-    /// @param cur Cursor; advanced past the STRING block.
-    /// @return data Decoded STRING payload.
-    function unpackString(Cur memory cur) internal pure returns (string memory data) {
-        return string(unpackRaw(cur, Keys.String));
-    }
-
-    /// @notice Consume a LABEL block and return its fields.
-    /// @param cur Cursor; advanced past the LABEL block.
-    /// @return id Node ID being labelled.
-    /// @return namespace Label namespace.
-    /// @return name Label value.
-    function unpackLabel(Cur memory cur) internal pure returns (uint id, bytes32 namespace, string memory name) {
-        uint end = cur.enter(Keys.Label, 64 + Sizes.Header, 0);
-        id = cur.readUint();
-        namespace = cur.read32();
-        name = cur.unpackString();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a SCHEMA block and return its fields.
-    /// @param cur Cursor; advanced past the SCHEMA block.
-    /// @return key Block key being defined.
-    /// @return body Schema DSL string describing the block payload body.
-    /// @return name Optional block alias.
-    function unpackSchema(Cur memory cur) internal pure returns (bytes4 key, string memory body, bytes32 name) {
-        uint end = cur.enter(Keys.Schema, 36 + Sizes.Header, 0);
-        key = cur.read4();
-        body = cur.unpackString();
-        name = cur.read32();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a dynamic block with a single bytes32 payload.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return value Decoded bytes32.
-    function unpack32(Cur memory cur, bytes4 key) internal pure returns (bytes32 value) {
-        uint abs = consume(cur, 0, key, 32, 32);
-        value = bytes32(msg.data[abs:abs + 32]);
-    }
-
-    /// @notice Consume a dynamic block with two bytes32 payload words.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return a First decoded bytes32.
-    /// @return b Second decoded bytes32.
-    function unpack64(Cur memory cur, bytes4 key) internal pure returns (bytes32 a, bytes32 b) {
-        uint abs = consume(cur, 0, key, 64, 64);
-        a = bytes32(msg.data[abs:abs + 32]);
-        b = bytes32(msg.data[abs + 32:abs + 64]);
-    }
-
-    /// @notice Consume a dynamic block with three bytes32 payload words.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return a First decoded bytes32.
-    /// @return b Second decoded bytes32.
-    /// @return c Third decoded bytes32.
-    function unpack96(Cur memory cur, bytes4 key) internal pure returns (bytes32 a, bytes32 b, bytes32 c) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        a = bytes32(msg.data[abs:abs + 32]);
-        b = bytes32(msg.data[abs + 32:abs + 64]);
-        c = bytes32(msg.data[abs + 64:abs + 96]);
-    }
-
-    /// @notice Consume a dynamic block with a 128-byte payload (four 32-byte words).
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return a First decoded bytes32.
-    /// @return b Second decoded bytes32.
-    /// @return c Third decoded bytes32.
-    /// @return d Fourth decoded bytes32.
-    function unpack128(Cur memory cur, bytes4 key) internal pure returns (bytes32 a, bytes32 b, bytes32 c, bytes32 d) {
-        uint abs = consume(cur, 0, key, 128, 128);
-        a = bytes32(msg.data[abs:abs + 32]);
-        b = bytes32(msg.data[abs + 32:abs + 64]);
-        c = bytes32(msg.data[abs + 64:abs + 96]);
-        d = bytes32(msg.data[abs + 96:abs + 128]);
-    }
-
-    /// @notice Consume a dynamic block with a 160-byte payload (five 32-byte words).
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected dynamic block key.
-    /// @return a First decoded bytes32.
-    /// @return b Second decoded bytes32.
-    /// @return c Third decoded bytes32.
-    /// @return d Fourth decoded bytes32.
-    /// @return e Fifth decoded bytes32.
-    function unpack160(
-        Cur memory cur,
-        bytes4 key
-    ) internal pure returns (bytes32 a, bytes32 b, bytes32 c, bytes32 d, bytes32 e) {
-        uint abs = consume(cur, 0, key, 160, 160);
-        a = bytes32(msg.data[abs:abs + 32]);
-        b = bytes32(msg.data[abs + 32:abs + 64]);
-        c = bytes32(msg.data[abs + 64:abs + 96]);
-        d = bytes32(msg.data[abs + 96:abs + 128]);
-        e = bytes32(msg.data[abs + 128:abs + 160]);
-    }
-
-    // Generic typed-shape decoders
-
-    /// @notice Consume a fixed-size asset amount block and return asset and amount.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @return asset Asset identifier.
-    /// @return amount Scalar amount value.
-    function unpackAssetAmount(Cur memory cur, bytes4 key) internal pure returns (bytes32 asset, uint amount) {
-        uint abs = consume(cur, 0, key, 64, 64);
-        asset = bytes32(msg.data[abs:abs + 32]);
-        amount = uint(bytes32(msg.data[abs + 32:abs + 64]));
-    }
-
-    /// @notice Consume a fixed-size account amount block and return account, asset, and amount.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @return account Account identifier.
-    /// @return asset Asset identifier.
-    /// @return amount Scalar amount value.
-    function unpackAccountAmount(
-        Cur memory cur,
-        bytes4 key
-    ) internal pure returns (bytes32 account, bytes32 asset, uint amount) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        account = bytes32(msg.data[abs:abs + 32]);
-        asset = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Consume a fixed-size host amount block and return host, asset, and amount.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @return host Host node ID.
-    /// @return asset Asset identifier.
-    /// @return amount Scalar amount value.
-    function unpackHostAmount(
-        Cur memory cur,
-        bytes4 key
-    ) internal pure returns (uint host, bytes32 asset, uint amount) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        host = uint(bytes32(msg.data[abs:abs + 32]));
-        asset = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Consume a fixed-size host account asset block and return host, account, and asset.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @return host Host node ID.
-    /// @return account Account identifier.
-    /// @return asset Asset identifier.
-    function unpackHostAccountAsset(
-        Cur memory cur,
-        bytes4 key
-    ) internal pure returns (uint host, bytes32 account, bytes32 asset) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        host = uint(bytes32(msg.data[abs:abs + 32]));
-        account = bytes32(msg.data[abs + 32:abs + 64]);
-        asset = bytes32(msg.data[abs + 64:abs + 96]);
-    }
-
-    /// @notice Consume a fixed-size transaction block and return from, to, asset, and amount.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @return from Source account identifier.
-    /// @return to Destination account identifier.
-    /// @return asset Asset identifier.
-    /// @return amount Scalar amount value.
-    function unpackTransaction(
-        Cur memory cur,
-        bytes4 key
-    ) internal pure returns (bytes32 from, bytes32 to, bytes32 asset, uint amount) {
-        uint abs = consume(cur, 0, key, 128, 128);
-        from = bytes32(msg.data[abs:abs + 32]);
-        to = bytes32(msg.data[abs + 32:abs + 64]);
-        asset = bytes32(msg.data[abs + 64:abs + 96]);
-        amount = uint(bytes32(msg.data[abs + 96:abs + 128]));
-    }
-
-    // Type-specific fixed-width decoders
-
-    /// @notice Consume an ACCOUNT block and return the account.
-    /// @param cur Cursor; advanced past the block.
-    /// @return account Account identifier.
-    function unpackAccount(Cur memory cur) internal pure returns (bytes32 account) {
-        account = unpack32(cur, Keys.Account);
-    }
-
-    /// @notice Consume a NODE block and return the node ID.
-    /// @param cur Cursor; advanced past the block.
-    /// @return node Node identifier.
-    function unpackNode(Cur memory cur) internal pure returns (uint node) {
-        node = uint(unpack32(cur, Keys.Node));
-    }
-
-    /// @notice Consume a FEE block and return the amount.
-    /// @param cur Cursor; advanced past the block.
-    /// @return amount Fee amount.
-    function unpackFee(Cur memory cur) internal pure returns (uint amount) {
-        amount = uint(unpack32(cur, Keys.Fee));
-    }
-
-    /// @notice Consume an ASSET block and return the asset identifier.
-    /// @param cur Cursor; advanced past the block.
-    /// @return asset Asset identifier.
-    function unpackAsset(Cur memory cur) internal pure returns (bytes32 asset) {
-        asset = unpack32(cur, Keys.Asset);
-    }
-
-    /// @notice Consume an ACCOUNT_ASSET form block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return account Account identifier.
-    /// @return asset Asset identifier.
-    function unpackAccountAsset(Cur memory cur) internal pure returns (bytes32 account, bytes32 asset) {
-        uint abs = consume(cur, 0, Keys.AccountAsset, 64, 64);
-        account = bytes32(msg.data[abs:abs + 32]);
-        asset = bytes32(msg.data[abs + 32:abs + 64]);
-    }
-
-    /// @notice Consume an ACCOUNT_ASSET form block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded account and asset.
-    function unpackAccountAssetValue(Cur memory cur) internal pure returns (AccountAsset memory value) {
-        (value.account, value.asset) = unpackAccountAsset(cur);
-    }
-
-    /// @notice Consume a BOUNTY block and return the reward amount and relayer.
-    /// @param cur Cursor; advanced past the block.
-    /// @return amount Relayer reward amount.
-    /// @return relayer Relayer account identifier.
-    function unpackBounty(Cur memory cur) internal pure returns (uint amount, bytes32 relayer) {
-        (bytes32 x, bytes32 y) = unpack64(cur, Keys.Bounty);
-        amount = uint(x);
-        relayer = y;
-    }
-
-    /// @notice Consume an AMOUNT block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackAmount(Cur memory cur) internal pure returns (bytes32 asset, uint amount) {
-        return unpackAssetAmount(cur, Keys.Amount);
-    }
-
-    /// @notice Consume an AMOUNT block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded asset and amount.
-    function unpackAmountValue(Cur memory cur) internal pure returns (AssetAmount memory value) {
-        (value.asset, value.amount) = unpackAssetAmount(cur, Keys.Amount);
-    }
-
-    /// @notice Consume a BALANCE block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackBalance(Cur memory cur) internal pure returns (bytes32 asset, uint amount) {
-        return unpackAssetAmount(cur, Keys.Balance);
-    }
-
-    /// @notice Consume a BALANCE block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded asset and amount.
-    function unpackBalanceValue(Cur memory cur) internal pure returns (AssetAmount memory value) {
-        (value.asset, value.amount) = unpackAssetAmount(cur, Keys.Balance);
-    }
-
-    /// @notice Consume a HOST_ACCOUNT_ASSET form block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return host Host node ID.
-    /// @return account Account identifier.
-    /// @return asset Asset identifier.
-    function unpackHostAccountAsset(Cur memory cur) internal pure returns (uint host, bytes32 account, bytes32 asset) {
-        return unpackHostAccountAsset(cur, Keys.HostAccountAsset);
-    }
-
-    /// @notice Consume a HOST_ACCOUNT_ASSET form block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded host, account, and asset.
-    function unpackHostAccountAssetValue(Cur memory cur) internal pure returns (HostAccountAsset memory value) {
-        (value.host, value.account, value.asset) = unpackHostAccountAsset(cur, Keys.HostAccountAsset);
-    }
-
-    /// @notice Consume an ACCOUNT_AMOUNT form block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return account Account identifier.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackAccountAmount(Cur memory cur) internal pure returns (bytes32 account, bytes32 asset, uint amount) {
-        return unpackAccountAmount(cur, Keys.AccountAmount);
-    }
-
-    /// @notice Consume an ACCOUNT_AMOUNT form block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded account, asset, and amount.
-    function unpackAccountAmountValue(Cur memory cur) internal pure returns (AccountAmount memory value) {
-        (value.account, value.asset, value.amount) = unpackAccountAmount(cur, Keys.AccountAmount);
-    }
-
-    /// @notice Consume an ALLOCATION block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return host Host node ID.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackAllocation(Cur memory cur) internal pure returns (uint host, bytes32 asset, uint amount) {
-        return unpackHostAmount(cur, Keys.Allocation);
-    }
-
-    /// @notice Consume an ALLOCATION block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded host, asset, and amount.
-    function unpackAllocationValue(Cur memory cur) internal pure returns (HostAmount memory value) {
-        (value.host, value.asset, value.amount) = unpackHostAmount(cur, Keys.Allocation);
-    }
-
-    /// @notice Consume an ALLOWANCE block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return host Host node ID.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackAllowance(Cur memory cur) internal pure returns (uint host, bytes32 asset, uint amount) {
-        return unpackHostAmount(cur, Keys.Allowance);
-    }
-
-    /// @notice Consume an ALLOWANCE block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded host, asset, and amount.
-    function unpackAllowanceValue(Cur memory cur) internal pure returns (HostAmount memory value) {
-        (value.host, value.asset, value.amount) = unpackHostAmount(cur, Keys.Allowance);
-    }
-
-    /// @notice Consume a CUSTODY block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return host Host node ID.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackCustody(Cur memory cur) internal pure returns (uint host, bytes32 asset, uint amount) {
-        return unpackHostAmount(cur, Keys.Custody);
-    }
-
-    /// @notice Consume a CUSTODY block and return its fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded host, asset, and amount.
-    function unpackCustodyValue(Cur memory cur) internal pure returns (HostAmount memory value) {
-        (value.host, value.asset, value.amount) = unpackHostAmount(cur, Keys.Custody);
-    }
-
-    /// @notice Consume a TRANSACTION block and return its fields as separate values.
-    /// @param cur Cursor; advanced past the block.
-    /// @return from Source account identifier.
-    /// @return to Destination account identifier.
-    /// @return asset Asset identifier.
-    /// @return amount Token amount.
-    function unpackTransaction(
-        Cur memory cur
-    ) internal pure returns (bytes32 from, bytes32 to, bytes32 asset, uint amount) {
-        return unpackTransaction(cur, Keys.Transaction);
-    }
-
-    /// @notice Consume a TRANSACTION block and return all fields as a struct.
-    /// @param cur Cursor; advanced past the block.
-    /// @return value Decoded from, to, asset, and amount.
-    function unpackTxValue(Cur memory cur) internal pure returns (Tx memory value) {
-        (value.from, value.to, value.asset, value.amount) = unpackTransaction(cur);
-    }
-
-    // Type-specific dynamic decoders
-
-    /// @notice Consume a STEP block and return its sub-command invocation fields.
-    /// The `req` slice is the raw payload of the block's required BYTES child.
-    /// @param cur Cursor; advanced past the block.
-    /// @return target Destination node ID for the sub-command.
-    /// @return resources Packed resources assigned to the step.
-    /// @return req Embedded request bytes for the sub-command.
-    function unpackStep(Cur memory cur) internal pure returns (uint target, uint resources, bytes calldata req) {
-        uint end = cur.enter(Keys.Step, 64 + Sizes.Header, 0);
-        target = uint(cur.read32());
-        resources = uint(cur.read32());
-        req = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a CALL block and return its target invocation fields.
-    /// The `data` slice is the raw payload of the block's required BYTES child.
-    /// @param cur Cursor; advanced past the block.
-    /// @return target Target node ID to call.
-    /// @return resources Packed resources assigned to the call.
-    /// @return data Raw calldata payload for the target.
-    function unpackCall(Cur memory cur) internal pure returns (uint target, uint resources, bytes calldata data) {
-        uint end = cur.enter(Keys.Call, 64 + Sizes.Header, 0);
-        target = uint(cur.read32());
-        resources = uint(cur.read32());
-        data = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a CONTEXT block and return its command context fields.
-    /// The `state` and `request` slices are the raw payloads of the required BYTES children.
-    /// @param cur Cursor; advanced past the block.
-    /// @return account Command account identifier.
-    /// @return state Embedded state block stream.
-    /// @return request Embedded request block stream.
-    function unpackContext(
-        Cur memory cur
-    ) internal pure returns (bytes32 account, bytes calldata state, bytes calldata request) {
-        uint end = cur.enter(Keys.Context, 32 + 2 * Sizes.Header, 0);
-        account = cur.read32();
-        state = cur.unpackBytes();
-        request = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a RELAY block and return its destination portal, resources, and request stream.
-    /// @param cur Cursor; advanced past the block.
-    /// @return portal Destination portal identifier, often the destination host ID.
-    /// @return resources Chain-specific resources for the destination context.
-    /// @return request Embedded request block stream.
-    function unpackRelay(Cur memory cur) internal pure returns (uint portal, uint resources, bytes calldata request) {
-        uint end = cur.enter(Keys.Relay, 64 + Sizes.Header, 0);
-        portal = cur.readUint();
-        resources = cur.readUint();
-        request = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a DISPATCH block and return its destination portal, resources, and payload.
-    /// @param cur Cursor; advanced past the block.
-    /// @return portal Destination portal identifier, often the destination host ID.
-    /// @return resources Chain-specific resources for the destination dispatch.
-    /// @return payload Encoded payload.
-    function unpackDispatch(
-        Cur memory cur
-    ) internal pure returns (uint portal, uint resources, bytes calldata payload) {
-        uint end = cur.enter(Keys.Dispatch, 64 + Sizes.Header, 0);
-        portal = cur.readUint();
-        resources = cur.readUint();
-        payload = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    /// @notice Consume a RECOVER block and return its handler, resources, key, and witness bytes.
-    /// @param cur Cursor; advanced past the block.
-    /// @return handler Recovery handler port node ID.
-    /// @return resources Packed resources assigned to the recovery attempt.
-    /// @return key Recovery lookup key.
-    /// @return witness Witness bytes used by the recovery handler.
-    function unpackRecover(
-        Cur memory cur
-    ) internal pure returns (uint handler, uint resources, bytes32 key, bytes calldata witness) {
-        uint end = cur.enter(Keys.Recover, 96 + Sizes.Header, 0);
-        handler = cur.readUint();
-        resources = cur.readUint();
-        key = cur.read32();
-        witness = cur.unpackBytes();
-        cur.ensureAt(end);
-    }
-
-    // Type-specific validators
-
-    /// @notice Validate an AUTH block at position `i` and extract deadline and proof.
-    /// Does not advance the cursor.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the AUTH block.
-    /// @param cid Command ID that the AUTH block must reference.
-    /// @return deadline Expiry timestamp.
-    /// @return proof Raw proof bytes (layout: `[bytes20 signer][bytes65 sig]`).
-    function expectAuth(Cur memory cur, uint i, uint cid) internal pure returns (uint deadline, bytes calldata proof) {
-        (uint abs, uint next) = expect(cur, i, 0, Keys.Auth, 64 + Sizes.Header + Sizes.Proof, 0);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != cid) revert UnexpectedValue();
-        deadline = uint(bytes32(msg.data[abs + 32:abs + 64]));
-
-        (abs, ) = expect(cur, i + Sizes.Header + 64, next, Keys.Bytes, Sizes.Proof, Sizes.Proof);
-        proof = msg.data[abs:abs + Sizes.Proof];
-    }
-
-    // -------------------------------------------------------------------------
-    // require* - validate + advance (like consume with content checks)
-    // -------------------------------------------------------------------------
-
-    /// @notice Consume an asset block and assert it matches the expected asset.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block type key.
-    /// @param asset Expected asset identifier.
-    /// @return amount Amount from the block.
-    function requireAssetAmount(Cur memory cur, bytes4 key, bytes32 asset) internal pure returns (uint amount) {
-        uint abs = consume(cur, 0, key, 64, 64);
-        if (bytes32(msg.data[abs:abs + 32]) != asset) revert UnexpectedValue();
-        amount = uint(bytes32(msg.data[abs + 32:abs + 64]));
-    }
-
-    /// @notice Consume an asset amount block, assert it matches the expected asset, and require the amount to be 1.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block type key.
-    /// @param asset Expected asset identifier.
-    function requireUnitAssetAmount(Cur memory cur, bytes4 key, bytes32 asset) internal pure {
-        uint abs = consume(cur, 0, key, 64, 64);
-        if (bytes32(msg.data[abs:abs + 32]) != asset) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 32:abs + 64])) != 1) revert UnexpectedValue();
-    }
-
-    /// @notice Consume a host amount block and assert it matches the expected host.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block type key.
-    /// @param host Expected host node ID.
-    /// @return asset Asset identifier from the block.
-    /// @return amount Amount from the block.
-    function requireHostAmount(
-        Cur memory cur,
-        bytes4 key,
-        uint host
-    ) internal pure returns (bytes32 asset, uint amount) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        asset = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Consume a host amount block and assert it matches the expected host and asset.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block type key.
-    /// @param host Expected host node ID.
-    /// @param asset Expected asset identifier.
-    /// @return amount Amount from the block.
-    function requireHostAmount(
-        Cur memory cur,
-        bytes4 key,
-        uint host,
-        bytes32 asset
-    ) internal pure returns (uint amount) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        if (bytes32(msg.data[abs + 32:abs + 64]) != asset) revert UnexpectedValue();
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Consume a host amount block, assert it matches the expected host and asset, and require the amount to be 1.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block type key.
-    /// @param host Expected host node ID.
-    /// @param asset Expected asset identifier.
-    function requireUnitHostAmount(Cur memory cur, bytes4 key, uint host, bytes32 asset) internal pure {
-        uint abs = consume(cur, 0, key, 96, 96);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        if (bytes32(msg.data[abs + 32:abs + 64]) != asset) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 64:abs + 96])) != 1) revert UnexpectedValue();
-    }
-
-    /// @notice Consume a host account asset block and assert it matches the expected host and account.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @param host Expected host node ID.
-    /// @param account Expected account identifier.
-    /// @return asset Asset identifier from the block.
-    function requireHostAccountAsset(
-        Cur memory cur,
-        bytes4 key,
-        uint host,
-        bytes32 account
-    ) internal pure returns (bytes32 asset) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        if (bytes32(msg.data[abs + 32:abs + 64]) != account) revert UnexpectedValue();
-        asset = bytes32(msg.data[abs + 64:abs + 96]);
-    }
-
-    /// @notice Consume a host account asset block, assert it targets the expected host, and return account and asset.
-    /// @param cur Cursor; advanced past the block.
-    /// @param key Expected block key.
-    /// @param host Expected host node ID.
-    /// @return account Account identifier from the block.
-    /// @return asset Asset identifier from the block.
-    function requireHostAccountAsset(
-        Cur memory cur,
-        bytes4 key,
-        uint host
-    ) internal pure returns (bytes32 account, bytes32 asset) {
-        uint abs = consume(cur, 0, key, 96, 96);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        account = bytes32(msg.data[abs + 32:abs + 64]);
-        asset = bytes32(msg.data[abs + 64:abs + 96]);
-    }
-
-    /// @notice Consume a HOST_ACCOUNT_ASSET form block, assert it targets the expected host, and return account and asset.
-    /// @param cur Cursor; advanced past the block.
-    /// @param host Expected host node ID.
-    /// @return account Account identifier from the block.
-    /// @return asset Asset identifier from the block.
-    function requireHostAccountAsset(Cur memory cur, uint host) internal pure returns (bytes32 account, bytes32 asset) {
-        return requireHostAccountAsset(cur, Keys.HostAccountAsset, host);
-    }
-
-    /// @notice Consume an AUTH block at the current position and verify the command ID.
-    /// @param cur Cursor; advanced past the block.
-    /// @param cid Expected command ID.
-    /// @return deadline Expiry timestamp.
-    /// @return proof Raw proof bytes.
-    function requireAuth(Cur memory cur, uint cid) internal pure returns (uint deadline, bytes calldata proof) {
-        (deadline, proof) = expectAuth(cur, cur.i, cid);
-        cur.i += Sizes.Auth;
-    }
-
-    // -------------------------------------------------------------------------
-    // ensure* - validate constraint blocks against provided values
-    // -------------------------------------------------------------------------
-
-    /// @notice Consume a BALANCE_LIMIT block and assert all constraint fields match the provided balance.
-    /// @param cur Cursor; advanced past the block.
-    /// @param asset Expected asset identifier.
-    /// @param amount Amount that must fall within the encoded min/max range.
-    function ensureBalanceLimit(Cur memory cur, bytes32 asset, uint amount) internal pure {
-        uint abs = consume(cur, 0, Keys.BalanceLimit, 96, 96);
-        if (bytes32(msg.data[abs:abs + 32]) != asset) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 32:abs + 64])) > amount) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 64:abs + 96])) < amount) revert UnexpectedValue();
-    }
-
-    /// @notice Consume a CUSTODY_LIMIT block and assert all constraint fields match the provided custody.
-    /// @param cur Cursor; advanced past the block.
-    /// @param host Expected host node ID.
-    /// @param asset Expected asset identifier.
-    /// @param amount Amount that must fall within the encoded min/max range.
-    function ensureCustodyLimit(Cur memory cur, uint host, bytes32 asset, uint amount) internal pure {
-        uint abs = consume(cur, 0, Keys.CustodyLimit, 128, 128);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert UnexpectedValue();
-        if (bytes32(msg.data[abs + 32:abs + 64]) != asset) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 64:abs + 96])) > amount) revert UnexpectedValue();
-        if (uint(bytes32(msg.data[abs + 96:abs + 128])) < amount) revert UnexpectedValue();
-    }
-
-    // -------------------------------------------------------------------------
-    // Transform helpers
-    // -------------------------------------------------------------------------
-
-    /// @notice Consume a BALANCE block and scope its amount to a host.
-    /// @param cur Cursor; advanced past the BALANCE block.
-    /// @param host Host node ID to attach to the decoded balance.
-    /// @return value Host-scoped balance amount.
-    function unpackBalanceForHost(
-        Cur memory cur,
-        uint host
-    ) internal pure returns (HostAmount memory value) {
-        value.host = host;
-        (value.asset, value.amount) = cur.unpackBalance();
-    }
-
-    /// @notice Consume a RELAY block and encode its destination context payload.
-    /// @param cur Cursor; advanced past the RELAY block.
-    /// @param account Account identifier to embed in the destination context.
-    /// @param state State block stream to embed in the destination context.
-    /// @return portal Destination portal identifier, often the destination host ID.
-    /// @return resources Chain-specific resources assigned to the destination context.
-    /// @return context Encoded CONTEXT block containing `account`, `state`, and relay request.
-    function relayToContext(
-        Cur memory cur,
-        bytes32 account,
-        bytes calldata state
-    ) internal pure returns (uint portal, uint resources, bytes memory context) {
-        bytes calldata request;
-        (portal, resources, request) = cur.unpackRelay();
-        context = toContextBlock(account, bytes(state), bytes(request));
-    }
-
-    // -------------------------------------------------------------------------
-    // Search helpers
-    // -------------------------------------------------------------------------
-
-    /// @notice Look for a NODE block anywhere in a calldata source and return its value.
-    /// Scans from the start of `source` to the end.
-    /// @param source Calldata block stream to search.
-    /// @param backup Value to return if no NODE block is found.
-    /// @return node Node ID from the NODE block, or `backup` if absent.
-    function resolveNode(bytes calldata source, uint backup) internal pure returns (uint node) {
-        Cur memory cur = open(source);
-        uint i = find(cur, 0, Keys.Node);
-        if (i == cur.len) return backup;
-
-        (uint abs, ) = expect(cur, i, 0, Keys.Node, 32, 32);
-        return uint(bytes32(msg.data[abs:abs + 32]));
-    }
-
-    /// @notice Look for a NODE block anywhere in a calldata source and require a non-zero result.
-    /// Scans from the start of `source` to the end.
-    /// @param source Calldata block stream to search.
-    /// @param backup Value to use if no NODE block is found.
-    /// @return node Node ID from the NODE block, or `backup` if absent.
-    function resolveNodeOrRevert(bytes calldata source, uint backup) internal pure returns (uint node) {
-        node = resolveNode(source, backup);
-        if (node == 0) revert ZeroNode();
-    }
-
-    /// @notice Look for an ACCOUNT block anywhere in a calldata source and return its value.
-    /// Scans from the start of `source` to the end.
-    /// @param source Calldata block stream to search.
-    /// @param backup Account to return if no ACCOUNT block is found.
-    /// @return account Account from the ACCOUNT block, or `backup` if absent.
-    function resolveAccount(bytes calldata source, bytes32 backup) internal pure returns (bytes32 account) {
-        Cur memory cur = open(source);
-        uint i = find(cur, 0, Keys.Account);
-        if (i == cur.len) return backup;
-
-        (uint abs, ) = expect(cur, i, 0, Keys.Account, 32, 32);
-        return bytes32(msg.data[abs:abs + 32]);
-    }
-}