@rootzero/contracts 1.10.0 → 1.12.0

package/commands/admin/Init.sol

@@ -1,43 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import { AdminBase, CommandContext, Keys } from "./Base.sol";
-import { Cursors, Cur } from "../../Cursors.sol";
-
-using Cursors for Cur;
-
-abstract contract InitHook {
-    /// @notice Override to run host initialization logic.
-    /// @param input Cursor over the full request byte stream.
-    function init(Cur memory input) internal virtual;
-}
-
-/// @title Init
-/// @notice Admin command that runs host initialization logic via a virtual hook.
-/// The full request is passed to `init` as a cursor. Only callable by the admin account.
-abstract contract Init is AdminBase, InitHook {
-    uint internal immutable initId = commandId(this.init.selector);
-
-    /// @param input Request schema advertised for initialization input.
-    constructor(string memory input) {
-        emit Admin(host, initId, "1:0:0", input, Keys.Empty, Keys.Empty, false);
-        emit Labeled(initId, bytes32(0), "init");
-    }
-
-    /// @notice Run host initialization logic over the full admin request.
-    /// @param c Admin command context; `c.request` is passed through as a cursor.
-    /// @return Empty output state.
-    function init(
-        CommandContext calldata c
-    ) external onlyAdmin(c.account) returns (bytes memory) {
-        init(Cursors.open(c.request));
-        return "";
-    }
-}
-
-
-
-
-
-
-

package/events/Admin.sol

@@ -1,32 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted once per admin command during host deployment to publish its request schema and state keys.
-abstract contract AdminEvent is EventEmitter {
-    string private constant ABI =
-        "event Admin(uint indexed host, uint id, bytes32 shape, string request, bytes4 state, bytes4 output, bool funded)";
-
-    /// @param host Host node ID that owns this admin command.
-    /// @param id Command node ID.
-    /// @param shape Per-operation block counts encoded as `request:state:output`.
-    /// Request and state are each a single run of blocks under the current command convention.
-    /// @param request Schema DSL string describing the input request run, or empty if none.
-    /// @param state Block key expected for input state, `Keys.Empty`, or `Keys.Any`.
-    /// @param output Block key produced for output state, or `Keys.Empty`.
-    /// @param funded Whether the command entrypoint accepts nonzero `msg.value`.
-    event Admin(
-        uint indexed host,
-        uint id,
-        bytes32 shape,
-        string request,
-        bytes4 state,
-        bytes4 output,
-        bool funded
-    );
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/events/Command.sol

@@ -1,32 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted once per command during host deployment to publish its request schema and state keys.
-abstract contract CommandEvent is EventEmitter {
-    string private constant ABI =
-        "event Command(uint indexed host, uint id, bytes32 shape, string request, bytes4 state, bytes4 output, bool funded)";
-
-    /// @param host Host node ID that owns this command.
-    /// @param id Command node ID.
-    /// @param shape Per-operation block counts encoded as `request:state:output`.
-    /// Request and state are each a single run of blocks under the current command convention.
-    /// @param request Schema string describing the input request run, or empty if none.
-    /// @param state Block key expected for input state, `Keys.Empty`, or `Keys.Any`.
-    /// @param output Block key produced for output state, or `Keys.Empty`.
-    /// @param funded Whether the command entrypoint accepts nonzero `msg.value`.
-    event Command(
-        uint indexed host,
-        uint id,
-        bytes32 shape,
-        string request,
-        bytes4 state,
-        bytes4 output,
-        bool funded
-    );
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/events/Guard.sol

@@ -1,18 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted once per guard action during host deployment to publish its request schema.
-abstract contract GuardEvent is EventEmitter {
-    string private constant ABI = "event Guard(uint indexed host, uint id, string request)";
-
-    /// @param host Host node ID that owns this guard action.
-    /// @param id Guard action node ID.
-    /// @param request Schema DSL string describing the guard action request shape.
-    event Guard(uint indexed host, uint id, string request);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/events/Port.sol

@@ -1,22 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted by hosts to advertise callable peer-facing ports.
-abstract contract PortEvent is EventEmitter {
-    string private constant ABI =
-        "event Port(uint indexed host, uint id, bytes32 shape, string request, string response, bool funded)";
-
-    /// @param host Host node ID that exposes the port.
-    /// @param id Port node ID.
-    /// @param shape Block shape/version descriptor.
-    /// @param request Human-readable request schema.
-    /// @param response Human-readable response schema.
-    /// @param funded True if the port accepts native value.
-    event Port(uint indexed host, uint id, bytes32 shape, string request, string response, bool funded);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/events/Query.sol

@@ -1,20 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {EventEmitter} from "./Emitter.sol";
-
-/// @notice Emitted once per query during host deployment to publish its request and response schemas.
-abstract contract QueryEvent is EventEmitter {
-    string private constant ABI = "event Query(uint indexed host, uint id, bytes32 shape, string request, string response)";
-
-    /// @param host Host node ID that owns this query.
-    /// @param id Query 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 query response shape.
-    event Query(uint indexed host, uint id, bytes32 shape, string request, string response);
-
-    constructor() {
-        emit EventAbi(ABI);
-    }
-}

package/queries/Positions.sol

@@ -1,54 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-pragma solidity ^0.8.33;
-
-import {Cur, Cursors, Writer, Writers} from "../Cursors.sol";
-import {Forms} from "../blocks/Schema.sol";
-import {QueryBase} from "./Base.sol";
-
-using Cursors for Cur;
-using Writers for Writer;
-
-abstract contract GetPositionHook {
-    /// @notice Append the position response for one requested position.
-    /// Concrete implementations must append exactly one response block matching
-    /// the query output schema.
-    /// @param account Requested account identifier.
-    /// @param asset Requested asset identifier.
-    /// @param response Destination writer for the response stream.
-    function appendPosition(
-        bytes32 account,
-        bytes32 asset,
-        Writer memory response
-    ) internal view virtual;
-}
-
-/// @title GetPosition
-/// @notice Rootzero query that resolves one dynamic position response for each requested position.
-/// The request is a run of `ACCOUNT_ASSET` form blocks.
-/// The response returns one output-schema block per position entry, preserving request order.
-abstract contract GetPosition is QueryBase, GetPositionHook {
-    uint public immutable getPositionId = queryId(this.getPosition.selector);
-
-    /// @param output Response schema advertised for each position output block.
-    constructor(string memory output) {
-        emit Query(host, getPositionId, "1:1", Forms.AccountAsset, output);
-        emit Labeled(getPositionId, bytes32(0), "getPosition");
-    }
-
-    /// @notice Resolve positions for a run of requested `(account, asset)` tuples.
-    /// @dev Allocates from a per-block capacity hint and grows when position outputs exceed it.
-    /// @param request Block-stream request consisting of `accountAsset(account, asset)*`.
-    /// @return Block-stream response containing one output-schema block per position block.
-    function getPosition(bytes calldata request) external view returns (bytes memory) {
-        (Cur memory query, uint groups) = Cursors.init(request, 1);
-        Writer memory response = Writers.allocAny(groups);
-
-        while (query.i < query.len) {
-            (bytes32 account, bytes32 asset) = query.unpackAccountAsset();
-            appendPosition(account, asset, response);
-        }
-
-        query.complete();
-        return response.finish();
-    }
-}