@rootzero/contracts 0.9.2 → 0.9.4

package/Commands.sol

@@ -4,13 +4,13 @@ pragma solidity ^0.8.33;
 // Aggregator: re-exports command, admin, and peer abstractions.
 // Import this file to inherit from the full rootzero command surface without managing individual paths.
 
-import { CommandBase, CommandContext, CommandPayable } from "./commands/Base.sol";
+import { CommandBase, CommandContext } from "./commands/Base.sol";
+import { Payable } from "./core/Payable.sol";
 import { Keys } from "./blocks/Keys.sol";
 import { Burn, BurnHook } from "./commands/Burn.sol";
 import { CreditAccount, CreditAccountHook } from "./commands/Credit.sol";
 import { DebitAccount, DebitAccountHook } from "./commands/Debit.sol";
 import { Deposit, DepositHook, DepositPayable, DepositPayableHook } from "./commands/Deposit.sol";
-import { PipePayable, PipePayableHook } from "./commands/Pipe.sol";
 import { Provision, ProvisionHook, ProvisionPayable, ProvisionPayableHook } from "./commands/Provision.sol";
 import { Transfer, TransferHook } from "./commands/Transfer.sol";
 import { Withdraw, WithdrawHook } from "./commands/Withdraw.sol";
@@ -24,9 +24,10 @@ import { Allowance, AllowanceHook } from "./commands/admin/Allowance.sol";
 import { Unauthorize } from "./commands/admin/Unauthorize.sol";
 import { PeerBase, encodePeerCall } from "./peer/Base.sol";
 import { PeerAllowance } from "./peer/Allowance.sol";
-import { PeerAssetPull, AssetPullHook } from "./peer/AssetPull.sol";
+import { PeerBalancePull, BalancePullHook } from "./peer/BalancePull.sol";
 import { PeerAllowAssets } from "./peer/AllowAssets.sol";
 import { PeerDenyAssets } from "./peer/DenyAssets.sol";
+import { PeerPipePayable } from "./peer/Pipe.sol";
 import { PeerSettle } from "./peer/Settle.sol";
 
 

package/Core.sol

@@ -9,6 +9,9 @@ import { Balances } from "./core/Balances.sol";
 import { RootZeroContext } from "./core/Context.sol";
 import { Host } from "./core/Host.sol";
 import { FailedCall, NodeCalls } from "./core/Calls.sol";
+import { Payable } from "./core/Payable.sol";
+import { Pipeline } from "./core/Pipeline.sol";
+import { AssetAmount, AccountAsset, AccountAmount, HostAmount, HostAccountAsset, HostAccountAmount, Tx } from "./core/Types.sol";
 import { Validator } from "./core/Validator.sol";
 import { HostDiscovery } from "./core/Host.sol";
 import { IHostDiscovery } from "./interfaces/IHostDiscovery.sol";

package/Cursors.sol

@@ -9,7 +9,7 @@ import { Forms, Sizes } from "./blocks/Schema.sol";
 import { Keys } from "./blocks/Keys.sol";
 import { Schemas } from "./blocks/Schema.sol";
 import { Cursors, Cur } from "./blocks/Cursors.sol";
-import { ALLOC_SCALE, Writer, Writers } from "./blocks/Writers.sol";
+import { Writer, Writers, Hints } from "./blocks/Writers.sol";
 
 
 

package/README.md

@@ -15,19 +15,6 @@ Most consumers should start from the package root entry points:
 - `@rootzero/contracts/Utils.sol` — IDs, assets, accounts, layout, and value helpers
 - `@rootzero/contracts/Events.sol` — reusable event emitters and event contracts
 
-## Start Here
-
-If you are new to rootzero, read [`docs/GETTING_STARTED.md`](docs/GETTING_STARTED.md) first.
-
-It walks through:
-
-- the host and command mental model
-- which built-in commands expect `request` vs `state`
-- a minimal host example
-- a built-in command example
-- a custom command example
-- simple TypeScript request encoding
-
 ## Block Wire Format
 
 All request and response data is encoded as a binary block stream. Each block is:
@@ -36,15 +23,15 @@ All request and response data is encoded as a binary block stream. Each block is
 [bytes4 key][bytes4 payloadLen][payload]
 ```
 
-`key` is `bytes4(keccak256(schemaString))` — see `Keys` for the full set. `Cursors` parses calldata streams zero-copy via the `Cur` struct; `Writers` builds response streams into pre-allocated memory.
+`key` is `bytes4(keccak256("#name"))`; see `Keys` for the full set and [`docs/Schema.md`](docs/Schema.md) for the schema format. `Cursors` parses calldata streams zero-copy via the `Cur` struct; `Writers` builds response streams into pre-allocated memory.
 
 ## Schemas, Forms, And State
 
 Protocol blocks use schema strings and four-byte keys:
 
-- `Schemas` describes semantic protocol blocks such as `amount(...)`, `balance(...)`, `custody(...)`, and `payout(...)`.
-- `Forms` describes reusable structural blocks such as `accountAsset(...)` and `accountAmount(...)`, mostly used by queries.
-- `Keys` contains the runtime `bytes4` keys derived from those schema/form strings.
+- `Schemas` describes semantic protocol blocks such as `#amount`, `#balance`, `#custody`, and `#payout`.
+- `Forms` describes reusable structural blocks such as `#accountAsset` and `#accountAmount`, mostly used by queries.
+- `Keys` contains the runtime `bytes4` keys derived from block names.
 
 Every command declares its input and output pipeline state with block keys in the `Command` event. Use `Keys.Empty` when a command expects or returns no state.
 
@@ -80,9 +67,10 @@ Extend `CommandBase` to define a command mixin that runs inside the protocol's t
 pragma solidity ^0.8.33;
 
 import { CommandBase, CommandContext, Keys } from "@rootzero/contracts/Commands.sol";
-import { Cursors, Cur, Schemas } from "@rootzero/contracts/Cursors.sol";
+import { Cursors, Cur, Schemas, Writer, Writers } from "@rootzero/contracts/Cursors.sol";
 
 using Cursors for Cur;
+using Writers for Writer;
 
 string constant NAME = "myCommand";
 
@@ -90,16 +78,22 @@ abstract contract ExampleCommand is CommandBase {
     uint internal immutable myCommandId = commandId(NAME);
 
     constructor() {
-        emit Command(host, myCommandId, NAME, Schemas.Amount, Keys.Empty, Keys.Balance, false);
+        emit Command(host, myCommandId, NAME, "1:0:1", Schemas.Amount, Keys.Empty, Keys.Balance, false);
     }
 
     function myCommand(
         CommandContext calldata c
-    ) external onlyCommand(c.account) returns (bytes memory) {
-        (Cur memory input, , ) = cursor(c.request, 1);
-        (bytes32 asset, bytes32 meta, uint amount) = input.unpackAmount();
-        input.complete();
-        return Cursors.toBalanceBlock(asset, meta, amount);
+    ) external onlyCommand returns (bytes memory) {
+        (Cur memory request, uint groups) = cursor(c.request, 1);
+        Writer memory writer = Writers.allocBalances(groups);
+
+        while (request.i < request.bound) {
+            (bytes32 asset, bytes32 meta, uint amount) = request.unpackAmount();
+            writer.appendBalance(asset, meta, amount);
+        }
+
+        request.close();
+        return writer.finish();
     }
 }
 ```