Skip to main content
All notable changes to Agether Protocol, SDK, scoring model, and OpenClaw plugin are documented here.

​
v2.0.0 — Safe + ERC-4337 Migration

Breaking change: Complete architecture migration from custom AgentAccount (BeaconProxy) to Safe + Safe7579 + ERC-4337.

​
Smart Contracts

  • Agether4337Factory replaces AccountFactory — deploys Safe proxies with ERC-7579 modules
  • Agether8004ValidationModule — new combined validator (ownership + KYA gate + module lock)
  • AgetherHookMultiplexer — new admin-managed hook chain (replaces KYAHook)
  • Agether8004Scorer replaces AgentReputation — UUPS upgradeable scoring contract
  • Agether7579Bootstrap — new module initializer for Safe.setup()
  • Sentinel owner pattern — Safes have no execTransaction, 4337-only execution
  • All modules are non-removable — agents cannot escape validation rules

​
New Base Mainnet Addresses

ContractAddress
Agether4337Factory0x67DE66D07ff3dba0092C21f070f8a0f53D657BC3
Agether7579Bootstrap0xCc83AA714c05B7141B21a17e80EB21bD09652b27
Agether8004ValidationModule0xde896C58163b5f6cAC5B16C1b0109843f26106F6
AgetherHookMultiplexer0x4AB6DaD0f7360fa8d8c75889A5c206B65d7CbeDb
Agether8004Scorer0x56c7D35A976fac67b1993b66b861fCA32f59104F
TimelockController0xc600e7AAB8a230326C714CE66f356fdf6aC021d8

​
SDK

  • MorphoClient now submits ERC-4337 UserOps instead of direct execute() calls
  • New supply methods: supplyAsset(), withdrawSupply(), getSupplyPositions()
  • New diagnostic methods: getMaxBorrowable()
  • External signer support (Bankr, Privy, Turnkey, etc.)
  • All 49+ Morpho Blue USDC markets now discoverable via getMarkets()

​
Plugin

  • New tools: morpho_supply, morpho_supply_status, morpho_withdraw_supply
  • New tools: agether_health, agether_preflight, morpho_max_borrowable

​
v1.1.0 — Production Redeploy

Base Mainnet — Fresh Deployment Complete redeployment of all protocol contracts with ERC-7579 modular account architecture.

​
Changes

  • ERC-7579 Modular Accounts — AgentAccount is now a pure ERC-7579 smart account with execute(bytes32 mode, bytes calldata) interface, supporting single and batch execution modes
  • KYAHook — New self-protecting ERC-7579 hook module. Deployed as a shared singleton, owned by TimelockController. Cannot be uninstalled by account owners.
  • TimelockController delay set to 1 week (604800s) for maximum governance visibility
  • KYA gate disabled — KYAHook.validationRegistry is unset (address(0)), so all transactions pass. Can be enabled via timelocked setValidationRegistry().
  • All contract implementations redeployed with ERC-7579 architecture
Updated addresses (Base mainnet):
ContractAddress
AccountFactory0x89a8758E60A56EcB47247D92E05447eFd450d6Bf
KYAHook0x28e50Aa9eD517E369b2806928709B44062aD9821
AgentReputation0xe88f3419a2dbac70e3aF6E487b0C63e8301C6A87
ValidationRegistry0x6f76cF69B71Dc5F9A414BCEe4583b12738E47985
TimelockController0x8211001425a0Ee785877eBe3D8Fa162c07a919c1
UpgradeableBeacon0x8670cABbC940AeF91351a559aeFe9D29c975A5B0

​
SDK — @agether/sdk v1.10.0

  • Updated all baked-in contract addresses for the new deployment
  • Signer abstraction — walletClient and privateKey both supported across all clients
  • EIP-1271 smart wallet signature handling with automatic padding for x402 payments
  • accountAddress config for X402Client ensures payments come from the AgentAccount, not the EOA

​
OpenClaw Plugin — @agether/agether v1.3.0

  • Updated to SDK v1.10.0 with new contract addresses
  • Improved error handling for revert code translation
  • Package renamed from @agether/openclaw-plugin to @agether/agether

​
v1.0.0 — Initial Production Release

Base Mainnet Deployment The first production release of the Agether Protocol, deployed on Base mainnet (chain ID 8453).

​
Protocol Contracts

AccountFactory

Deployed with BeaconProxy pattern. All AgentAccount implementations share one upgradeable beacon — one transaction upgrades every account atomically.

AgentReputation

Oracle-based credit score store. Accepts ECDSA-signed attestations from the ML backend. Publishes feedback to ERC-8004 Reputation Registry.

ValidationRegistry

Know Your Agent (KYA) gate. Agents must pass code audit before their AgentAccount can execute transactions.

TimelockController

Timelock protecting all upgrade operations. Ensures community visibility into protocol changes.
Deployed addresses (Base mainnet):
ContractAddress
AccountFactory0xFab8b924fb292a736BA05AF7b4AEC2c8d05cdcbF
AgentReputation0x1fcb28eE3E8F3234E653b0A7a6fb56dE11E3c203
ValidationRegistry0x493f1551cbbC75afb2127CDBD5375ad8e8959f42
TimelockController0x0ceFC603Da20D71622cBEB42BaB9C199bfc5Ad13

​
SDK — @agether/sdk v1.0.0

  • MorphoClient — Direct Morpho Blue lending: deposit collateral, borrow USDC, repay, withdraw, market discovery via GraphQL
  • AgetherClient — Account management, balances, credit line operations
  • ScoringClient — Credit score querying (free read + x402-gated fresh computation)
  • X402Client — HTTP 402 payment protocol with auto-draw from Morpho
  • AgentIdentityClient — ERC-8004 registration, metadata, reputation
Key features:
  • Atomic depositAndBorrow() — 4 calls in one executeBatch() transaction
  • repay("all") / withdrawCollateral("all") convenience methods
  • Daily spending limits and yield-limited spending controls for X402Client
  • Calibrated credit scores with SHAP feature explanations
  • CLI (agether command) for testing and integration

​
Scoring Model — v1.0.0

  • ML model trained on 1.15M Morpho Blue events on Base
  • Comprehensive risk feature engineering across borrowing behavior, position health, portfolio composition, activity patterns, and agent trust signals
  • Calibrated probability estimates for reliable default predictions
  • Score mapping (300–1000) using FICO-style log-odds methodology
  • Safety rails for edge cases (thin file, underwater, recent liquidation, concentration risk, KYA bonus)
  • FastAPI service with 1-hour result cache
  • SHAP explainability — top contributing factors returned with each score

​
OpenClaw Plugin — @agether/openclaw-plugin v1.0.0

  • 15 tools registered with the OpenClaw AI
  • 2 slash commands: /balance, /morpho
  • Natural language interface for all protocol operations
  • AgentId persistence across gateway restarts
  • Revert code translation (human-readable Solidity errors)

​
Backend API — v1.0.0

  • Fastify server on :3001
  • x402-gated scoring endpoint (GET /score/:agentId, $0.01 USDC)
  • Free score read (GET /score/:agentId/current)
  • KYA audit endpoints with SSRF protection and malicious pattern scanning
  • Agent listing and details
  • Heuristic fallback scorer (when ML service is unreachable)

​
Upcoming

The following features are planned for future releases:
Ethereum mainnet deployment is under consideration for a future phase. Currently Agether is Base-only.
High-score agents (800+) will be eligible for credit lines with reduced collateral requirements. Currently all borrowing is overcollateralized.
The owner_graph_score feature in the ML model is reserved for a future social trust layer — connecting agent reputation to onchain social graphs.
The ERC-8004 Reputation Registry is not yet deployed on Base mainnet. Once live, AgentReputation feedback will be fully integrated.
The next scoring model will incorporate additional event types including flash loans, yield protocol interactions, and cross-chain activity.
For the latest updates and discussion, join the Agether community. Bug reports and feature requests are welcome via the GitHub repository.