@rootzero/contracts 0.7.2 → 0.9.0

package/commands/Create.sol

@@ -1,42 +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;
-
-/// @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 {
-    uint internal immutable createId = commandId(NAME);
-
-    constructor(string memory input) {
-        emit Command(host, NAME, input, createId, State.Empty, State.Empty, false);
-    }
-
-    /// @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;
-
-    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,42 +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;
-
-/// @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 {
-    uint internal immutable removeId = commandId(NAME);
-
-    constructor(string memory input) {
-        emit Command(host, NAME, input, removeId, State.Empty, State.Empty, false);
-    }
-
-    /// @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;
-
-    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,47 +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;
-
-/// @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 {
-    uint internal immutable stakeCustodyToPositionId = commandId(SCTP);
-
-    constructor(string memory input) {
-        emit Command(host, SCTP, input, stakeCustodyToPositionId, State.Custodies, State.Empty, false);
-    }
-
-    /// @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;
-
-    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,41 +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;
-
-/// @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 {
-    uint internal immutable supplyId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, "", supplyId, State.Custodies, State.Empty, false);
-    }
-
-    /// @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;
-
-    /// @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,41 +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";
-
-/// @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 {
-    uint internal immutable allocateId = commandId(NAME);
-
-    constructor() {
-        emit Command(host, NAME, Schemas.Allocation, allocateId, State.Empty, State.Empty, false);
-    }
-
-    /// @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;
-
-    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/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();
-}

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/peer/Pull.sol

@@ -1,39 +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;
-
-/// @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 {
-    uint internal immutable peerPullId = peerId(NAME);
-
-    constructor(string memory input) {
-        emit Peer(host, NAME, input, peerPullId, false);
-    }
-
-    /// @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;
-
-    /// @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,45 +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;
-
-/// @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 {
-    uint internal immutable peerPushId = peerId(NAME);
-
-    constructor(string memory input) {
-        emit Peer(host, NAME, input, peerPushId, false);
-    }
-
-    /// @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;
-
-    /// @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/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;
-}