@rootzero/contracts 0.8.0 → 0.9.1

package/events/Erc721.sol

@@ -1,20 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-string constant ABI = "event Erc721Position(bytes32 indexed account, bytes32 asset, bytes32 meta, uint position, uint qid)";
-
-/// @notice Emitted when the lifecycle state of an ERC-721-backed position changes.
-abstract contract Erc721PositionEvent is EventEmitter {
-    /// @param account Account identifier that owns or is associated with the position.
-    /// @param asset Asset identifier for the ERC-721 class.
-    /// @param meta Asset metadata slot, typically carrying the token-specific position context.
-    /// @param position Context-specific position value; positive means active and 0 means closed.
-    /// @param qid Query ID associated with the position lookup or reporting context.
-    event Erc721Position(bytes32 indexed account, bytes32 asset, bytes32 meta, uint position, uint qid);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/events/Peer.sol

@@ -1,24 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { EventEmitter } from "./Emitter.sol";
-
-string constant ABI =
-    "event Peer(uint indexed host, string name, string schema, uint pid, bool acceptsValue)";
-
-/// @notice Emitted once per peer during host deployment to publish its schema.
-abstract contract PeerEvent is EventEmitter {
-    /// @param host Host node ID that owns this peer.
-    /// @param name Human-readable peer name.
-    /// @param schema Schema DSL string describing the peer request shape.
-    /// @param pid Peer node ID.
-    /// @param acceptsValue Whether the peer entrypoint accepts nonzero `msg.value`.
-    event Peer(uint indexed host, string name, string schema, uint pid, bool acceptsValue);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}
-
-
-

package/peer/AllowAssets.sol

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { AllowAssetsHook } from "../commands/admin/AllowAssets.sol";
-import { Cursors, Cur, Schemas } from "../Cursors.sol";
-
-using Cursors for Cur;
-
-string constant NAME = "peerAllowAssets";
-
-/// @title PeerAllowAssets
-/// @notice Peer that permits a list of (asset, meta) pairs on behalf of a remote host.
-/// Each ASSET block in the request calls `allowAsset`. Restricted to trusted peers.
-abstract contract PeerAllowAssets is PeerBase, AllowAssetsHook {
-    uint internal immutable peerAllowAssetsId = peerId(NAME);
-
-    constructor() {
-        emit Peer(host, NAME, Schemas.Asset, peerAllowAssetsId, false);
-    }
-
-    /// @notice Execute the allow-assets peer call.
-    function peerAllowAssets(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory assets, , ) = cursor(request, 1);
-
-        while (assets.i < assets.bound) {
-            (bytes32 asset, bytes32 meta) = assets.unpackAsset();
-            allowAsset(asset, meta);
-        }
-
-        assets.complete();
-        return "";
-    }
-}
-
-
-
-
-

package/peer/AssetPull.sol

@@ -1,44 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {PeerBase} from "./Base.sol";
-import {Cursors, Cur, Schemas} from "../Cursors.sol";
-
-string constant NAME = "peerAssetPull";
-
-using Cursors for Cur;
-
-abstract contract PeerAssetPullHook {
-    /// @notice Override to process one incoming amount-based asset pull request from a remote host.
-    /// @param peer Host node ID derived from the caller address.
-    /// @param asset Requested asset identifier.
-    /// @param meta Requested asset metadata slot.
-    /// @param amount Requested amount in the asset's native units.
-    function peerAssetPull(uint peer, bytes32 asset, bytes32 meta, uint amount) internal virtual;
-}
-
-/// @title PeerAssetPull
-/// @notice Peer that pulls requested asset amounts from a remote host into this one.
-/// Each AMOUNT block in the request calls `peerAssetPull(peer, asset, meta, amount)`, where `peer`
-/// is derived from `msg.sender`. Restricted to trusted peers.
-abstract contract PeerAssetPull is PeerBase, PeerAssetPullHook {
-    uint internal immutable peerAssetPullId = peerId(NAME);
-
-    constructor() {
-        emit Peer(host, NAME, Schemas.Amount, peerAssetPullId, false);
-    }
-
-    /// @notice Execute the asset-pull peer call.
-    function peerAssetPull(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory assets, , ) = cursor(request, 1);
-        uint peer = caller();
-
-        while (assets.i < assets.bound) {
-            (bytes32 asset, bytes32 meta, uint amount) = assets.unpackAmount();
-            peerAssetPull(peer, asset, meta, amount);
-        }
-
-        assets.complete();
-        return "";
-    }
-}

package/peer/Base.sol

@@ -1,36 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { OperationBase } from "../core/Operation.sol";
-import { PeerEvent } from "../events/Peer.sol";
-import { Ids, Selectors } from "../utils/Ids.sol";
-
-/// @notice ABI-encode a peer call from a target peer ID and request block stream.
-/// @dev Derives the function selector from `target` via `Ids.peerSelector(target)`.
-/// Reverts if `target` is not a valid peer ID.
-/// @param target Destination peer node ID embedding the target selector.
-/// @param request Input block stream for the peer invocation.
-/// @return ABI-encoded calldata for the peer entry point.
-function encodePeerCall(uint target, bytes calldata request) pure returns (bytes memory) {
-    bytes4 selector = Ids.peerSelector(target);
-    return abi.encodeWithSelector(selector, request);
-}
-
-/// @title PeerBase
-/// @notice Abstract base for all rootzero peer contracts.
-/// Peers handle inter-host asset flows (push/pull) and asset allow/deny management
-/// between cooperating hosts. Access is restricted to trusted callers via `onlyPeer`.
-abstract contract PeerBase is OperationBase, PeerEvent {
-    /// @dev Restrict execution to trusted callers (authorized hosts or the commander).
-    modifier onlyPeer() {
-        enforceCaller(msg.sender);
-        _;
-    }
-
-    /// @notice Derive the deterministic node ID for a named peer on this contract.
-    /// @param name Peer function name (without argument list).
-    /// @return Peer node ID.
-    function peerId(string memory name) internal view returns (uint) {
-        return Ids.toPeer(Selectors.peer(name), address(this));
-    }
-}

package/peer/DenyAssets.sol

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {PeerBase} from "./Base.sol";
-import {DenyAssetsHook} from "../commands/admin/DenyAssets.sol";
-import {Cursors, Cur, Schemas} from "../Cursors.sol";
-
-using Cursors for Cur;
-
-string constant NAME = "peerDenyAssets";
-
-/// @title PeerDenyAssets
-/// @notice Peer that blocks a list of (asset, meta) pairs on behalf of a remote host.
-/// Each ASSET block in the request calls `denyAsset`. Restricted to trusted peers.
-abstract contract PeerDenyAssets is PeerBase, DenyAssetsHook {
-    uint internal immutable peerDenyAssetsId = peerId(NAME);
-
-    constructor() {
-        emit Peer(host, NAME, Schemas.Asset, peerDenyAssetsId, false);
-    }
-
-    /// @notice Execute the deny-assets peer call.
-    function peerDenyAssets(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory assets, , ) = cursor(request, 1);
-
-        while (assets.i < assets.bound) {
-            (bytes32 asset, bytes32 meta) = assets.unpackAsset();
-            denyAsset(asset, meta);
-        }
-
-        assets.complete();
-        return "";
-    }
-}
-
-
-
-
-

package/peer/Pull.sol

@@ -1,41 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {PeerBase} from "./Base.sol";
-import {Cursors, Cur} from "../Cursors.sol";
-
-string constant NAME = "peerPull";
-
-using Cursors for Cur;
-
-abstract contract PeerPullHook {
-    /// @notice Override to process a single incoming block from the pull request.
-    /// @param peer Host node ID derived from the caller address.
-    /// @param input Cursor positioned at the current input block; advance it before returning.
-    function peerPull(uint peer, Cur memory input) internal virtual;
-}
-
-/// @title PeerPull
-/// @notice Peer that pulls assets from a remote host into this one.
-/// Each block in the request is dispatched to `peerPull(peer, input)`, where `peer`
-/// is derived from `msg.sender`. Restricted to trusted peers.
-abstract contract PeerPull is PeerBase, PeerPullHook {
-    uint internal immutable peerPullId = peerId(NAME);
-
-    constructor(string memory input) {
-        emit Peer(host, NAME, input, peerPullId, false);
-    }
-
-    /// @notice Execute the pull peer call.
-    function peerPull(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory input, , ) = cursor(request, 1);
-        uint peer = caller();
-
-        while (input.i < input.bound) {
-            peerPull(peer, input);
-        }
-
-        input.complete();
-        return "";
-    }
-}

package/peer/Push.sol

@@ -1,47 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { Cursors, Cur } from "../Cursors.sol";
-
-string constant NAME = "peerPush";
-
-using Cursors for Cur;
-
-abstract contract PeerPushHook {
-    /// @notice Override to process a single incoming block from the push request.
-    /// @param peer Host node ID derived from the caller address.
-    /// @param input Cursor positioned at the current input block; advance it before returning.
-    function peerPush(uint peer, Cur memory input) internal virtual;
-}
-
-/// @title PeerPush
-/// @notice Peer that receives assets pushed from a remote host into this one.
-/// Each block in the request is dispatched to `peerPush(peer, input)`, where `peer`
-/// is derived from `msg.sender`. Restricted to trusted peers.
-abstract contract PeerPush is PeerBase, PeerPushHook {
-    uint internal immutable peerPushId = peerId(NAME);
-
-    constructor(string memory input) {
-        emit Peer(host, NAME, input, peerPushId, false);
-    }
-
-    /// @notice Execute the push peer call.
-    function peerPush(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory input, , ) = cursor(request, 1);
-        uint peer = caller();
-
-        while (input.i < input.bound) {
-            peerPush(peer, input);
-        }
-
-        input.complete();
-        return "";
-    }
-}
-
-
-
-
-
-

package/peer/Settle.sol

@@ -1,34 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { TransferHook } from "../commands/Transfer.sol";
-import { Cursors, Cur, Tx, Schemas } from "../Cursors.sol";
-
-using Cursors for Cur;
-
-string constant NAME = "peerSettle";
-
-/// @title PeerSettle
-/// @notice Peer that consumes peer-supplied TRANSACTION blocks through the shared transfer hook.
-/// Each TRANSACTION block in the request calls `transfer(value)`. Restricted to trusted peers.
-abstract contract PeerSettle is PeerBase, TransferHook {
-    uint internal immutable peerSettleId = peerId(NAME);
-
-    constructor() {
-        emit Peer(host, NAME, Schemas.Transaction, peerSettleId, false);
-    }
-
-    /// @notice Execute the peer-settle call.
-    function peerSettle(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory state, , ) = cursor(request, 1);
-
-        while (state.i < state.bound) {
-            Tx memory value = state.unpackTxValue();
-            transfer(value);
-        }
-
-        state.complete();
-        return "";
-    }
-}

package/utils/State.sol

@@ -1,22 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-/// @title State
-/// @notice Command state type discriminants.
-/// Each constant tags the shape of the encoded state block stream stored
-/// in a command's metadata slot, allowing commands to select the correct
-/// decode path without inspecting the raw bytes.
-library State {
-    /// @dev No state; the command produces or expects an empty state stream.
-    uint8 constant Empty = 0x0001;
-    /// @dev State stream contains STEP blocks (sub-command invocations).
-    uint8 constant Steps = 0x0002;
-    /// @dev State stream contains BALANCE blocks.
-    uint8 constant Balances = 0x0003;
-    /// @dev State stream contains TRANSACTION blocks.
-    uint8 constant Transactions = 0x0004;
-    /// @dev State stream contains CUSTODY blocks.
-    uint8 constant Custodies = 0x0005;
-    /// @dev State stream contains claim records.
-    uint8 constant Claims = 0x0006;
-}