@rootzero/contracts 1.6.0 → 1.7.0

package/events/Peer.sol

@@ -1,22 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted once per peer during host deployment to publish its request and response schemas.
-abstract contract PeerEvent is EventEmitter {
-    string private constant ABI =
-        "event Peer(uint indexed host, uint id, bytes32 shape, string request, string response, bool funded)";
-
-    /// @param host Host node ID that owns this peer.
-    /// @param id Peer node ID.
-    /// @param shape Per-operation block counts encoded as `request:response`.
-    /// @param request Schema DSL string describing the input request run, or empty if none.
-    /// @param response Schema DSL string describing the peer response shape.
-    /// @param funded Whether the peer entrypoint accepts nonzero `msg.value`.
-    event Peer(uint indexed host, uint id, bytes32 shape, string request, string response, bool funded);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/peer/AllowAssets.sol

@@ -1,44 +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;
-
-interface IPeerAllowAssets {
-    function peerAllowAssets(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerAllowAssets
-/// @notice Peer that permits a list of assets on behalf of a peer host.
-/// Each ASSET block in the request calls `allowAsset`. Restricted to trusted peers.
-abstract contract PeerAllowAssets is PeerBase, AllowAssetsHook, IPeerAllowAssets {
-    uint internal immutable peerAllowAssetsId = peerId(this.peerAllowAssets.selector);
-
-    constructor() {
-        emit Peer(host, peerAllowAssetsId, "1:0", Schemas.Asset, "", false);
-        emit Labeled(peerAllowAssetsId, bytes32(0), "peerAllowAssets");
-    }
-
-    /// @notice Execute the allow-assets peer call.
-    /// @param request ASSET block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerAllowAssets(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory assets, , ) = Cursors.init(request, 1);
-
-        while (assets.i < assets.len) {
-            bytes32 asset = assets.unpackAsset();
-            allowAsset(asset);
-        }
-
-        assets.complete();
-        return "";
-    }
-}
-
-
-
-
-

package/peer/Allowance.sol

@@ -1,41 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {PeerBase} from "./Base.sol";
-import {AllowanceHook} from "../commands/admin/Allowance.sol";
-import {Cursors, Cur, Schemas} from "../Cursors.sol";
-
-using Cursors for Cur;
-
-interface IPeerAllowance {
-    function peerAllowance(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerAllowance
-/// @notice Peer that lets a trusted peer host request or refresh its own allowance.
-/// Each AMOUNT block in the request is scoped to the peer host and passed to the
-/// shared allowance hook as a host-scoped allowance. Restricted to trusted peers.
-abstract contract PeerAllowance is PeerBase, AllowanceHook, IPeerAllowance {
-    uint internal immutable peerAllowanceId = peerId(this.peerAllowance.selector);
-
-    constructor() {
-        emit Peer(host, peerAllowanceId, "1:0", Schemas.Amount, "", false);
-        emit Labeled(peerAllowanceId, bytes32(0), "peerAllowance");
-    }
-
-    /// @notice Execute the allowance peer call.
-    /// @param request AMOUNT block stream requested by the trusted peer.
-    /// @return Empty response bytes.
-    function peerAllowance(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory amounts, , ) = Cursors.init(request, 1);
-        uint peer = caller();
-
-        while (amounts.i < amounts.len) {
-            (bytes32 asset, uint amount) = amounts.unpackAmount();
-            allowance(peer, asset, amount);
-        }
-
-        amounts.complete();
-        return "";
-    }
-}

package/peer/Base.sol

@@ -1,41 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { NodeCalls } from "../core/Calls.sol";
-import { PeerEvent } from "../events/Peer.sol";
-import { LabeledEvent } from "../events/Labeled.sol";
-import { Nodes } from "../utils/Nodes.sol";
-
-/// @notice ABI-encode a peer call from a target peer ID and request block stream.
-/// @dev Derives the function selector from `target` via `Nodes.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 = Nodes.peerSelector(target);
-    return abi.encodeWithSelector(selector, request);
-}
-
-/// @title PeerBase
-/// @notice Abstract base for all rootzero peer contracts.
-/// Peers handle inter-host operations and asset allow/deny management
-/// between cooperating hosts. Access is restricted to trusted callers via `onlyPeer`.
-abstract contract PeerBase is NodeCalls, PeerEvent, LabeledEvent {
-    /// @dev Thrown when the commander attempts to call a peer entrypoint directly.
-    error CommanderNotAllowed();
-
-    /// @dev Restrict execution to trusted callers, excluding the commander.
-    modifier onlyPeer() {
-        if (msg.sender == commander) revert CommanderNotAllowed();
-        enforceCaller(msg.sender);
-        _;
-    }
-
-    /// @notice Derive the deterministic node ID for a peer selector on this contract.
-    /// @param selector Peer entrypoint selector.
-    /// @return Peer node ID.
-    function peerId(bytes4 selector) internal view returns (uint) {
-        return Nodes.toPeer(selector, address(this));
-    }
-}

package/peer/Credit.sol

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { CreditAccountHook } from "../commands/Credit.sol";
-import { Cursors, Cur, Forms } from "../Cursors.sol";
-
-using Cursors for Cur;
-
-interface IPeerCreditAccount {
-    function peerCreditAccount(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerCreditAccount
-/// @notice Peer that lets a trusted peer credit supplied accounts directly.
-/// Each ACCOUNT_AMOUNT block calls `creditAccount` for its account.
-abstract contract PeerCreditAccount is PeerBase, CreditAccountHook, IPeerCreditAccount {
-    uint internal immutable peerCreditAccountId = peerId(this.peerCreditAccount.selector);
-
-    constructor() {
-        emit Peer(host, peerCreditAccountId, "1:0", Forms.AccountAmount, "", false);
-        emit Labeled(peerCreditAccountId, bytes32(0), "peerCreditAccount");
-    }
-
-    /// @notice Execute the peer-credit call.
-    /// @param request ACCOUNT_AMOUNT block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerCreditAccount(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory amounts, , ) = Cursors.init(request, 1);
-
-        while (amounts.i < amounts.len) {
-            (bytes32 account, bytes32 asset, uint amount) = amounts.unpackAccountAmount();
-            creditAccount(account, asset, amount);
-        }
-
-        amounts.complete();
-        return "";
-    }
-}

package/peer/Debit.sol

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { DebitAccountHook } from "../commands/Debit.sol";
-import { Cursors, Cur, Forms } from "../Cursors.sol";
-
-using Cursors for Cur;
-
-interface IPeerDebitAccount {
-    function peerDebitAccount(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerDebitAccount
-/// @notice Peer that lets a trusted peer debit supplied accounts directly.
-/// Each ACCOUNT_AMOUNT block calls `debitAccount` for its account.
-abstract contract PeerDebitAccount is PeerBase, DebitAccountHook, IPeerDebitAccount {
-    uint internal immutable peerDebitAccountId = peerId(this.peerDebitAccount.selector);
-
-    constructor() {
-        emit Peer(host, peerDebitAccountId, "1:0", Forms.AccountAmount, "", false);
-        emit Labeled(peerDebitAccountId, bytes32(0), "peerDebitAccount");
-    }
-
-    /// @notice Execute the peer-debit call.
-    /// @param request ACCOUNT_AMOUNT block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerDebitAccount(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory amounts, , ) = Cursors.init(request, 1);
-
-        while (amounts.i < amounts.len) {
-            (bytes32 account, bytes32 asset, uint amount) = amounts.unpackAccountAmount();
-            debitAccount(account, asset, amount);
-        }
-
-        amounts.complete();
-        return "";
-    }
-}

package/peer/DenyAssets.sol

@@ -1,44 +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;
-
-interface IPeerDenyAssets {
-    function peerDenyAssets(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerDenyAssets
-/// @notice Peer that blocks a list of assets on behalf of a peer host.
-/// Each ASSET block in the request calls `denyAsset`. Restricted to trusted peers.
-abstract contract PeerDenyAssets is PeerBase, DenyAssetsHook, IPeerDenyAssets {
-    uint internal immutable peerDenyAssetsId = peerId(this.peerDenyAssets.selector);
-
-    constructor() {
-        emit Peer(host, peerDenyAssetsId, "1:0", Schemas.Asset, "", false);
-        emit Labeled(peerDenyAssetsId, bytes32(0), "peerDenyAssets");
-    }
-
-    /// @notice Execute the deny-assets peer call.
-    /// @param request ASSET block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerDenyAssets(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory assets, , ) = Cursors.init(request, 1);
-
-        while (assets.i < assets.len) {
-            bytes32 asset = assets.unpackAsset();
-            denyAsset(asset);
-        }
-
-        assets.complete();
-        return "";
-    }
-}
-
-
-
-
-

package/peer/Pipe.sol

@@ -1,44 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {PeerBase} from "./Base.sol";
-import {Pipeline} from "../core/Pipeline.sol";
-import {Cursors, Cur, Schemas} from "../Cursors.sol";
-import {Budget} from "../utils/Value.sol";
-
-using Cursors for Cur;
-
-interface IPeerPipePayable {
-    function peerPipePayable(bytes calldata request) external payable returns (bytes memory);
-}
-
-/// @title PeerPipePayable
-/// @notice Peer that consumes PIPE blocks and executes each context step stream.
-/// Each PIPE block carries chain resources plus a CONTEXT block; the nested
-/// context steps are passed to the shared pipeline as the step stream.
-abstract contract PeerPipePayable is PeerBase, Pipeline, IPeerPipePayable {
-    uint internal immutable peerPipePayableId = peerId(this.peerPipePayable.selector);
-
-    constructor() {
-        emit Peer(host, peerPipePayableId, "1:0", Schemas.Pipe, "", true);
-        emit Labeled(peerPipePayableId, bytes32(0), "peerPipePayable");
-    }
-
-    /// @notice Execute peer-supplied pipes through the shared payable pipe.
-    /// @dev Each pipe receives its own explicit EVM value sub-budget. Any top-level
-    ///      `msg.value` not assigned to a pipe remains on this host.
-    /// @param request PIPE block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerPipePayable(bytes calldata request) external payable onlyPeer returns (bytes memory) {
-        (Cur memory input, , ) = Cursors.init(request, 1);
-        Budget memory budget = valueBudget();
-
-        while (input.i < input.len) {
-            (uint resources, bytes32 account, bytes calldata state, bytes calldata steps) = input.unpackPipe();
-            pipe(account, state, steps, allocateValue(budget, resources));
-        }
-
-        input.complete();
-        return "";
-    }
-}

package/peer/Recover.sol

@@ -1,51 +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";
-
-using Cursors for Cur;
-
-interface IPeerRecover {
-    function peerRecover(bytes calldata request) external returns (bytes memory);
-}
-
-abstract contract RecoverHook {
-    /// @notice Override to recover one incoming pipe context from a peer host.
-    /// @dev Implementations may refund, retry, compensate, reconcile, or otherwise
-    ///      handle the supplied state and remaining steps.
-    /// @param account Account identifier for the recovery context.
-    /// @param state Embedded recovery state block stream.
-    /// @param steps Embedded recovery step block stream.
-    function recover(bytes32 account, bytes calldata state, bytes calldata steps) internal virtual;
-}
-
-/// @title PeerRecover
-/// @notice Peer endpoint for recovering an interrupted or failed pipe context.
-/// @dev Commonly used when a cross-chain pipe fails at its destination, but the
-///      hook is host-defined and may implement any recovery strategy. Each PIPE
-///      block carries chain resources plus a CONTEXT block; the nested context
-///      is passed to the recovery hook and resources are not allocated.
-abstract contract PeerRecover is PeerBase, RecoverHook, IPeerRecover {
-    uint internal immutable peerRecoverId = peerId(this.peerRecover.selector);
-
-    constructor() {
-        emit Peer(host, peerRecoverId, "1:0", Schemas.Pipe, "", false);
-        emit Labeled(peerRecoverId, bytes32(0), "peerRecover");
-    }
-
-    /// @notice Forward peer-supplied recovery pipes to the host-defined recovery hook.
-    /// @param request PIPE block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerRecover(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory input, , ) = Cursors.init(request, 1);
-
-        while (input.i < input.len) {
-            (, bytes32 account, bytes calldata state, bytes calldata steps) = input.unpackPipe();
-            recover(account, state, steps);
-        }
-
-        input.complete();
-        return "";
-    }
-}

package/peer/Settle.sol

@@ -1,41 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { PeerBase } from "./Base.sol";
-import { CreditAccountHook } from "../commands/Credit.sol";
-import { DebitAccountHook } from "../commands/Debit.sol";
-import { Cursors, Cur, Schemas } from "../Cursors.sol";
-
-using Cursors for Cur;
-
-interface IPeerSettle {
-    function peerSettle(bytes calldata request) external returns (bytes memory);
-}
-
-/// @title PeerSettle
-/// @notice Peer that consumes peer-supplied TRANSACTION blocks through debit and credit hooks.
-/// Each TRANSACTION block calls `debitAccount` for `from` and `creditAccount` for `to`.
-abstract contract PeerSettle is PeerBase, DebitAccountHook, CreditAccountHook, IPeerSettle {
-    uint internal immutable peerSettleId = peerId(this.peerSettle.selector);
-
-    constructor() {
-        emit Peer(host, peerSettleId, "1:0", Schemas.Transaction, "", false);
-        emit Labeled(peerSettleId, bytes32(0), "peerSettle");
-    }
-
-    /// @notice Execute the peer-settle call.
-    /// @param request TRANSACTION block stream supplied by the trusted peer.
-    /// @return Empty response bytes.
-    function peerSettle(bytes calldata request) external onlyPeer returns (bytes memory) {
-        (Cur memory state, , ) = Cursors.init(request, 1);
-
-        while (state.i < state.len) {
-            (bytes32 from, bytes32 to, bytes32 asset, uint amount) = state.unpackTransaction();
-            if (from != 0) debitAccount(from, asset, amount);
-            if (to != 0) creditAccount(to, asset, amount);
-        }
-
-        state.complete();
-        return "";
-    }
-}