@rootzero/contracts 0.8.0 → 0.9.1

package/blocks/cursors/Erc1155.sol

@@ -1,149 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { Cur, Cursors } from "./Core.sol";
-import { Keys } from "../Keys.sol";
-import { Assets } from "../../utils/Assets.sol";
-
-using Assets for bytes32;
-
-/// @title Erc1155Cursors
-/// @notice ERC-1155-aware cursor helpers layered on top of generic block parsing.
-library Erc1155Cursors {
-    /// @notice Validate an AMOUNT block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the block is not AMOUNT, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the AMOUNT block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Amount from the block.
-    function expectErc1155Amount(Cur memory cur, uint i, address collection) internal view returns (bytes32 meta, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Amount, 96, 96);
-        bytes32(msg.data[abs:abs + 32]).matchErc1155(collection);
-        meta = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a BALANCE block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the block is not BALANCE, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the BALANCE block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Balance amount from the block.
-    function expectErc1155Balance(Cur memory cur, uint i, address collection) internal view returns (bytes32 meta, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Balance, 96, 96);
-        bytes32(msg.data[abs:abs + 32]).matchErc1155(collection);
-        meta = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a MINIMUM block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the block is not MINIMUM, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the MINIMUM block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Minimum amount from the block.
-    function expectErc1155Minimum(Cur memory cur, uint i, address collection) internal view returns (bytes32 meta, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Minimum, 96, 96);
-        bytes32(msg.data[abs:abs + 32]).matchErc1155(collection);
-        meta = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a MAXIMUM block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the block is not MAXIMUM, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the MAXIMUM block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Maximum amount from the block.
-    function expectErc1155Maximum(Cur memory cur, uint i, address collection) internal view returns (bytes32 meta, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Maximum, 96, 96);
-        bytes32(msg.data[abs:abs + 32]).matchErc1155(collection);
-        meta = bytes32(msg.data[abs + 32:abs + 64]);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a CUSTODY block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the block is not CUSTODY, the host differs, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the CUSTODY block.
-    /// @param host Expected host node ID from the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Custodied amount from the block.
-    function expectErc1155Custody(
-        Cur memory cur,
-        uint i,
-        uint host,
-        address collection
-    ) internal view returns (bytes32 meta, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Custody, 128, 128);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert Cursors.UnexpectedValue();
-        bytes32(msg.data[abs + 32:abs + 64]).matchErc1155(collection);
-        meta = bytes32(msg.data[abs + 64:abs + 96]);
-        amount = uint(bytes32(msg.data[abs + 96:abs + 128]));
-    }
-
-    /// @notice Consume an AMOUNT block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the current block is not AMOUNT, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Cursor; advanced past the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Amount from the block.
-    function requireErc1155Amount(Cur memory cur, address collection) internal view returns (bytes32 meta, uint amount) {
-        (meta, amount) = expectErc1155Amount(cur, cur.i, collection);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a BALANCE block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the current block is not BALANCE, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Cursor; advanced past the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Balance amount from the block.
-    function requireErc1155Balance(Cur memory cur, address collection) internal view returns (bytes32 meta, uint amount) {
-        (meta, amount) = expectErc1155Balance(cur, cur.i, collection);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a MINIMUM block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the current block is not MINIMUM, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Cursor; advanced past the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Minimum amount from the block.
-    function requireErc1155Minimum(Cur memory cur, address collection) internal view returns (bytes32 meta, uint amount) {
-        (meta, amount) = expectErc1155Minimum(cur, cur.i, collection);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a MAXIMUM block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the current block is not MAXIMUM, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Cursor; advanced past the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Maximum amount from the block.
-    function requireErc1155Maximum(Cur memory cur, address collection) internal view returns (bytes32 meta, uint amount) {
-        (meta, amount) = expectErc1155Maximum(cur, cur.i, collection);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a CUSTODY block for a specific local ERC-1155 collection and return its token id and amount.
-    /// Reverts if the current block is not CUSTODY, the host differs, the asset is not a local ERC-1155, or the collection differs.
-    /// @param cur Cursor; advanced past the block.
-    /// @param host Expected host node ID from the block.
-    /// @param collection Expected local ERC-1155 collection.
-    /// @return meta Asset metadata slot from the block.
-    /// @return amount Custodied amount from the block.
-    function requireErc1155Custody(
-        Cur memory cur,
-        uint host,
-        address collection
-    ) internal view returns (bytes32 meta, uint amount) {
-        (meta, amount) = expectErc1155Custody(cur, cur.i, host, collection);
-        cur.i += 136;
-    }
-}

package/blocks/cursors/Erc20.sol

@@ -1,130 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { Cur, Cursors } from "./Core.sol";
-import { Keys } from "../Keys.sol";
-import { Assets } from "../../utils/Assets.sol";
-
-using Assets for bytes32;
-
-/// @title Erc20Cursors
-/// @notice ERC-20-aware cursor helpers layered on top of generic block parsing.
-library Erc20Cursors {
-    function erc20AddrAt(uint abs) private view returns (address) {
-        return Assets.erc20Addr(bytes32(msg.data[abs:abs + 32]));
-    }
-
-    /// @notice Validate an AMOUNT block for any local ERC-20 token and return it.
-    /// Reverts if the block is not AMOUNT or the asset is not a local ERC-20.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the AMOUNT block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Amount from the block.
-    function expectErc20Amount(Cur memory cur, uint i) internal view returns (address token, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Amount, 96, 96);
-        token = erc20AddrAt(abs);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a BALANCE block for any local ERC-20 token and return it.
-    /// Reverts if the block is not BALANCE or the asset is not a local ERC-20.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the BALANCE block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Balance amount from the block.
-    function expectErc20Balance(Cur memory cur, uint i) internal view returns (address token, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Balance, 96, 96);
-        token = erc20AddrAt(abs);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a MINIMUM block for any local ERC-20 token and return it.
-    /// Reverts if the block is not MINIMUM or the asset is not a local ERC-20.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the MINIMUM block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Minimum amount from the block.
-    function expectErc20Minimum(Cur memory cur, uint i) internal view returns (address token, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Minimum, 96, 96);
-        token = erc20AddrAt(abs);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Consume a MINIMUM block for any local ERC-20 token and return it.
-    /// Reverts if the current block is not MINIMUM or the asset is not a local ERC-20.
-    /// @param cur Cursor; advanced past the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Minimum amount from the block.
-    function requireErc20Minimum(Cur memory cur) internal view returns (address token, uint amount) {
-        (token, amount) = expectErc20Minimum(cur, cur.i);
-        cur.i += 104;
-    }
-
-    /// @notice Validate a MAXIMUM block for any local ERC-20 token and return it.
-    /// Reverts if the block is not MAXIMUM or the asset is not a local ERC-20.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the MAXIMUM block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Maximum amount from the block.
-    function expectErc20Maximum(Cur memory cur, uint i) internal view returns (address token, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Maximum, 96, 96);
-        token = erc20AddrAt(abs);
-        amount = uint(bytes32(msg.data[abs + 64:abs + 96]));
-    }
-
-    /// @notice Validate a CUSTODY block for any local ERC-20 token and return it.
-    /// Reverts if the block is not CUSTODY or the asset is not a local ERC-20.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the CUSTODY block.
-    /// @param host Expected host node ID from the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Custodied amount from the block.
-    function expectErc20Custody(Cur memory cur, uint i, uint host) internal view returns (address token, uint amount) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Custody, 128, 128);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert Cursors.UnexpectedValue();
-        token = erc20AddrAt(abs + 32);
-        amount = uint(bytes32(msg.data[abs + 96:abs + 128]));
-    }
-
-    /// @notice Consume an AMOUNT block for any local ERC-20 token and return it.
-    /// Reverts if the current block is not AMOUNT or the asset is not a local ERC-20.
-    /// @param cur Cursor; advanced past the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Amount from the block.
-    function requireErc20Amount(Cur memory cur) internal view returns (address token, uint amount) {
-        (token, amount) = expectErc20Amount(cur, cur.i);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a BALANCE block for any local ERC-20 token and return it.
-    /// Reverts if the current block is not BALANCE or the asset is not a local ERC-20.
-    /// @param cur Cursor; advanced past the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Balance amount from the block.
-    function requireErc20Balance(Cur memory cur) internal view returns (address token, uint amount) {
-        (token, amount) = expectErc20Balance(cur, cur.i);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a MAXIMUM block for any local ERC-20 token and return it.
-    /// Reverts if the current block is not MAXIMUM or the asset is not a local ERC-20.
-    /// @param cur Cursor; advanced past the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Maximum amount from the block.
-    function requireErc20Maximum(Cur memory cur) internal view returns (address token, uint amount) {
-        (token, amount) = expectErc20Maximum(cur, cur.i);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a CUSTODY block for any local ERC-20 token and return it.
-    /// Reverts if the current block is not CUSTODY or the asset is not a local ERC-20.
-    /// @param cur Cursor; advanced past the block.
-    /// @param host Expected host node ID from the block.
-    /// @return token Local ERC-20 token address extracted from the asset identifier.
-    /// @return amount Custodied amount from the block.
-    function requireErc20Custody(Cur memory cur, uint host) internal view returns (address token, uint amount) {
-        (token, amount) = expectErc20Custody(cur, cur.i, host);
-        cur.i += 136;
-    }
-
-}

package/blocks/cursors/Erc721.sol

@@ -1,66 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { Cur, Cursors } from "./Core.sol";
-import { Keys } from "../Keys.sol";
-import { Assets } from "../../utils/Assets.sol";
-
-using Assets for bytes32;
-
-/// @title Erc721Cursors
-/// @notice ERC-721-aware cursor helpers layered on top of generic block parsing.
-library Erc721Cursors {
-    /// @notice Validate a BALANCE block for a specific local ERC-721 collection and return its metadata.
-    /// Reverts if the block is not BALANCE, the asset is not a local ERC-721, the collection differs, or the amount is not 1.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the BALANCE block.
-    /// @param collection Expected local ERC-721 collection.
-    /// @return meta Asset metadata slot from the block.
-    function expectErc721Balance(Cur memory cur, uint i, address collection) internal view returns (bytes32 meta) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Balance, 96, 96);
-        bytes32(msg.data[abs:abs + 32]).matchErc721(collection);
-        meta = bytes32(msg.data[abs + 32:abs + 64]);
-        if (uint(bytes32(msg.data[abs + 64:abs + 96])) != 1) revert Cursors.UnexpectedValue();
-    }
-
-    /// @notice Validate a CUSTODY block for a specific local ERC-721 collection and return its metadata.
-    /// Reverts if the block is not CUSTODY, the host differs, the asset is not a local ERC-721, the collection differs, or the amount is not 1.
-    /// @param cur Source cursor.
-    /// @param i Byte offset of the CUSTODY block.
-    /// @param host Expected host node ID from the block.
-    /// @param collection Expected local ERC-721 collection.
-    /// @return meta Asset metadata slot from the block.
-    function expectErc721Custody(
-        Cur memory cur,
-        uint i,
-        uint host,
-        address collection
-    ) internal view returns (bytes32 meta) {
-        (uint abs, ) = Cursors.expect(cur, i, Keys.Custody, 128, 128);
-        if (uint(bytes32(msg.data[abs:abs + 32])) != host) revert Cursors.UnexpectedValue();
-        bytes32(msg.data[abs + 32:abs + 64]).matchErc721(collection);
-        meta = bytes32(msg.data[abs + 64:abs + 96]);
-        if (uint(bytes32(msg.data[abs + 96:abs + 128])) != 1) revert Cursors.UnexpectedValue();
-    }
-
-    /// @notice Consume a BALANCE block for a specific local ERC-721 collection and return its metadata.
-    /// Reverts if the current block is not BALANCE, the asset is not a local ERC-721, the collection differs, or the amount is not 1.
-    /// @param cur Cursor; advanced past the block.
-    /// @param collection Expected local ERC-721 collection.
-    /// @return meta Asset metadata slot from the block.
-    function requireErc721Balance(Cur memory cur, address collection) internal view returns (bytes32 meta) {
-        meta = expectErc721Balance(cur, cur.i, collection);
-        cur.i += 104;
-    }
-
-    /// @notice Consume a CUSTODY block for a specific local ERC-721 collection and return its metadata.
-    /// Reverts if the current block is not CUSTODY, the host differs, the asset is not a local ERC-721, the collection differs, or the amount is not 1.
-    /// @param cur Cursor; advanced past the block.
-    /// @param host Expected host node ID from the block.
-    /// @param collection Expected local ERC-721 collection.
-    /// @return meta Asset metadata slot from the block.
-    function requireErc721Custody(Cur memory cur, uint host, address collection) internal view returns (bytes32 meta) {
-        meta = expectErc721Custody(cur, cur.i, host, collection);
-        cur.i += 136;
-    }
-}

package/commands/Create.sol

@@ -1,44 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandBase, CommandContext, State } from "./Base.sol";
-import { Cursors, Cur } from "../Cursors.sol";
-
-string constant NAME = "create";
-
-using Cursors for Cur;
-
-abstract contract CreateHook {
-    /// @dev Override to create or initialize an object described by `input`.
-    /// Called once per top-level request item.
-    function create(bytes32 account, Cur memory input) internal virtual;
-}
-
-/// @title Create
-/// @notice Generic command that creates or initializes objects via a virtual hook.
-/// The request schema is constructor-defined; `create` is called once per top-level group.
-/// Produces no output state.
-abstract contract Create is CommandBase, CreateHook {
-    uint internal immutable createId = commandId(NAME);
-
-    constructor(string memory input) {
-        emit Command(host, NAME, input, createId, State.Empty, State.Empty, false);
-    }
-
-    function create(CommandContext calldata c) external onlyCommand(createId, c.target) returns (bytes memory) {
-        (Cur memory request, , ) = cursor(c.request, 1);
-
-        while (request.i < request.bound) {
-            create(c.account, request);
-        }
-
-        request.complete();
-        return "";
-    }
-}
-
-
-
-
-
-

package/commands/Remove.sol

@@ -1,44 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandBase, CommandContext, State } from "./Base.sol";
-import { Cursors, Cur } from "../Cursors.sol";
-
-string constant NAME = "remove";
-
-using Cursors for Cur;
-
-abstract contract RemoveHook {
-    /// @dev Override to remove or dismantle an object described by `input`.
-    /// Called once per top-level request item.
-    function remove(bytes32 account, Cur memory input) internal virtual;
-}
-
-/// @title Remove
-/// @notice Generic command that removes or dismantles objects via a virtual hook.
-/// The request schema is constructor-defined; `remove` is called once per top-level group.
-/// Produces no output state.
-abstract contract Remove is CommandBase, RemoveHook {
-    uint internal immutable removeId = commandId(NAME);
-
-    constructor(string memory input) {
-        emit Command(host, NAME, input, removeId, State.Empty, State.Empty, false);
-    }
-
-    function remove(CommandContext calldata c) external onlyCommand(removeId, c.target) returns (bytes memory) {
-        (Cur memory request, , ) = cursor(c.request, 1);
-
-        while (request.i < request.bound) {
-            remove(c.account, request);
-        }
-
-        request.complete();
-        return "";
-    }
-}
-
-
-
-
-
-

package/commands/Settle.sol

@@ -1,38 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandContext, CommandBase, State } from "./Base.sol";
-import { Cursors, Cur, Tx } from "../Cursors.sol";
-import { TransferHook } from "./Transfer.sol";
-using Cursors for Cur;
-
-string constant NAME = "settle";
-
-/// @title Settle
-/// @notice Command that consumes each TRANSACTION state block and settles it through the shared transfer hook.
-/// Produces no output state.
-abstract contract Settle is CommandBase, TransferHook {
-    uint internal immutable settleId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, "", settleId, State.Transactions, State.Empty, false);
-    }
-
-    function settle(CommandContext calldata c) external onlyCommand(settleId, c.target) returns (bytes memory) {
-        (Cur memory state, , ) = cursor(c.state, 1);
-
-        while (state.i < state.bound) {
-            Tx memory value = state.unpackTxValue();
-            transfer(value);
-        }
-
-        state.complete();
-        return "";
-    }
-}
-
-
-
-
-
-

package/commands/Stake.sol

@@ -1,49 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandContext, CommandBase, State } from "./Base.sol";
-import { HostAmount, Cur, Cursors } from "../Cursors.sol";
-
-string constant SCTP = "stakeCustodyToPosition";
-
-using Cursors for Cur;
-
-abstract contract StakeCustodyToPositionHook {
-    /// @dev Override to stake a custody position into a non-balance setup
-    /// target described by `request`.
-    function stakeCustodyToPosition(bytes32 account, HostAmount memory custody, Cur memory request) internal virtual;
-}
-
-/// @title StakeCustodyToPosition
-/// @notice Command that stakes CUSTODY state positions into a non-balance target
-/// described by the request stream. Produces no output state.
-abstract contract StakeCustodyToPosition is CommandBase, StakeCustodyToPositionHook {
-    uint internal immutable stakeCustodyToPositionId = commandId(SCTP);
-
-    constructor(string memory input) {
-        emit Command(host, SCTP, input, stakeCustodyToPositionId, State.Custodies, State.Empty, false);
-    }
-
-    function stakeCustodyToPosition(
-        CommandContext calldata c
-    ) external onlyCommand(stakeCustodyToPositionId, c.target) returns (bytes memory) {
-        (Cur memory state, , ) = cursor(c.state, 1);
-        Cur memory request = cursor(c.request);
-
-        while (state.i < state.bound) {
-            HostAmount memory custody = state.unpackCustodyValue();
-            stakeCustodyToPosition(c.account, custody, request);
-        }
-
-        state.complete();
-        return "";
-    }
-}
-
-
-
-
-
-
-
-

package/commands/Supply.sol

@@ -1,43 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {CommandBase, CommandContext, State} from "./Base.sol";
-import {Cursors, Cur, HostAmount} from "../Cursors.sol";
-string constant NAME = "supply";
-
-using Cursors for Cur;
-
-abstract contract SupplyHook {
-    /// @notice Override to consume or supply a single custody position.
-    /// Called once per CUSTODY block in state.
-    /// @param account Caller's account identifier.
-    /// @param value Decoded custody position (host, asset, meta, amount).
-    function supply(bytes32 account, HostAmount memory value) internal virtual;
-}
-
-/// @title Supply
-/// @notice Command that processes each CUSTODY state block through a virtual hook.
-/// Used to move assets out of cross-host custody positions (e.g. to settle or redeem them).
-/// Produces no output state.
-abstract contract Supply is CommandBase, SupplyHook {
-    uint internal immutable supplyId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, "", supplyId, State.Custodies, State.Empty, false);
-    }
-
-    /// @notice Execute the supply command.
-    function supply(CommandContext calldata c) external onlyCommand(supplyId, c.target) returns (bytes memory) {
-        (Cur memory state, , ) = cursor(c.state, 1);
-        
-        while (state.i < state.bound) {
-            HostAmount memory value = state.unpackCustodyValue();
-            supply(c.account, value);
-        }
-
-        state.complete();
-        return "";
-    }
-}
-
-

package/commands/admin/Allocate.sol

@@ -1,43 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandBase, CommandContext, State } from "../Base.sol";
-import { Cursors, Cur, Schemas } from "../../Cursors.sol";
-using Cursors for Cur;
-
-string constant NAME = "allocate";
-
-abstract contract AllocateHook {
-    /// @dev Override to apply a single allocation entry.
-    /// Called once per ALLOCATION block in the request.
-    function allocate(uint host, bytes32 asset, bytes32 meta, uint amount) internal virtual;
-}
-
-/// @title Allocate
-/// @notice Admin command that applies cross-host allocation entries via a virtual hook.
-/// Each ALLOCATION block in the request calls `allocate`. Only callable by the admin account.
-abstract contract Allocate is CommandBase, AllocateHook {
-    uint internal immutable allocateId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, Schemas.Allocation, allocateId, State.Empty, State.Empty, false);
-    }
-
-    function allocate(CommandContext calldata c) external onlyAdmin(c.account) onlyCommand(allocateId, c.target) returns (bytes memory) {
-        (Cur memory request, , ) = cursor(c.request, 1);
-
-        while (request.i < request.bound) {
-            (uint host, bytes32 asset, bytes32 meta, uint amount) = request.unpackAllocation();
-            allocate(host, asset, meta, amount);
-        }
-
-        request.complete();
-        return "";
-    }
-}
-
-
-
-
-
-

package/commands/admin/Relocate.sol

@@ -1,43 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { CommandContext, CommandPayable, State } from "../Base.sol";
-import { Cursors, Cur, Schemas } from "../../Cursors.sol";
-import { Budget, Values } from "../../utils/Value.sol";
-using Cursors for Cur;
-
-string constant NAME = "relocatePayable";
-
-/// @title RelocatePayable
-/// @notice Admin command that forwards native value (ETH) to one or more destination hosts.
-/// Each FUNDING block in the request specifies a target host node ID and an amount to forward.
-/// Only callable by the admin account.
-abstract contract RelocatePayable is CommandPayable {
-    uint internal immutable relocatePayableId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, Schemas.Funding, relocatePayableId, State.Empty, State.Empty, true);
-    }
-
-    function relocatePayable(
-        CommandContext calldata c
-    ) external payable onlyAdmin(c.account) onlyCommand(relocatePayableId, c.target) returns (bytes memory) {
-        (Cur memory request, , ) = cursor(c.request, 1);
-        Budget memory budget = Values.fromMsg();
-
-        while (request.i < request.bound) {
-            (uint peer, uint amount) = request.unpackFunding();
-            callTo(peer, Values.use(budget, amount), "");
-        }
-
-        request.complete();
-        settleValue(c.account, budget);
-        return "";
-    }
-}
-
-
-
-
-
-

package/core/HostBound.sol

@@ -1,14 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {Assets} from "../utils/Assets.sol";
-import {Ids} from "../utils/Ids.sol";
-
-/// @title HostBound
-/// @notice Minimal base for contracts that need host-scoped identity constants.
-abstract contract HostBound {
-    /// @dev This contract's host node ID, set to `Ids.toHost(address(this))` at construction.
-    uint public immutable host = Ids.toHost(address(this));
-    /// @dev Asset ID for the native chain value (ETH), bound to the current chain at deployment.
-    bytes32 internal immutable valueAsset = Assets.toValue();
-}