Agent Allowance Protocol

Agent Allowance Protocol is a treasury primitive for giving autonomous agents a real operating budget without giving them direct access to treasury principal. A human funds the treasury, the protocol tracks a protected principal floor separately from accrued headroom, and only the yield / surplus layer can become spendable. That spendable layer can be partitioned into root budgets and manager-controlled child budgets, so a parent operator or higher-level agent can allocate narrower sub-budgets to specialized executors without double-counting treasury allocation. Agents do not get treasury ownership. Instead, they receive constrained authority through explicit spending rules and the MetaMask smart-account delegation path. Those rules can narrow execution by executor, recipient, selector, amount, and validity window. When a spend occurs, the treasury records a structured receipt containing the task ID, budget ID, evidence hash, result hash, metadata URI, and the exact matched authorization ruleId. That makes the system auditable, accountable, and much closer to a financial trust primitive than a normal agent wallet. The repo demonstrates: principal protection, yield-only spendable budgeting, sub-budget allowance-tree semantics, constrained delegated execution, receipt-producing treasury spends, a dedicated WstETHYieldTreasury path for real wstETH, a real MetaMask Delegation Framework integration workspace, a live Base mainnet treasury + MetaMask proof, and a judge dashboard with public-safe ERC-8004 manifest/log packaging.