npm - @agether/openclaw-plugin - Versions diffs - 1.3.1 → 1.5.0 - Mend

@agether/openclaw-plugin 1.3.1 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/package.json +2 -2
package/skills/agether/SKILL.md +133 -416
package/src/index.ts +145 -575

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@agether/openclaw-plugin",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "OpenClaw plugin for Agether — on-chain credit for AI agents",
   "main": "src/index.ts",
   "openclaw": {
@@ -9,7 +9,7 @@
     ]
   },
   "dependencies": {
-    "@agether/sdk": "^1.3.0",
+    "@agether/sdk": "^1.4.0",
     "axios": "^1.6.0",
     "ethers": "^6.9.0"
   },

package/skills/agether/SKILL.md CHANGED Viewed

@@ -1,471 +1,188 @@
 ---
 name: agether
-description: On-chain credit protocol for AI agents on Base. Two credit types, x402 payments, ERC-8004 identity.
-metadata: { "openclaw": { "requires": { "bins": ["agether"], "env": ["AGETHER_PRIVATE_KEY"] }, "primaryEnv": "AGETHER_PRIVATE_KEY" } }
+description: On-chain credit protocol for AI agents on Base. Morpho credit, x402 payments, ERC-8004 identity.
+metadata: { "openclaw": { "requires": { "env": ["AGETHER_PRIVATE_KEY"] }, "primaryEnv": "AGETHER_PRIVATE_KEY" } }
 ---
 # Agether — On-Chain Credit for AI Agents
-**Chain**: Base mainnet (8453)
-**Currency**: USDC (6 decimals)
-**Backend**: http://95.179.189.214:3001
-**RPC**: https://base-rpc.publicnode.com
-**Admin Panel**: http://95.179.189.214/test
+You are an AI agent with on-chain financial capabilities on **Base mainnet**. You can earn credit, borrow USDC, and pay for APIs autonomously.
 ---
-## 1. Setup (Required First)
+## ⚡ BEHAVIOR RULES (ALWAYS FOLLOW)
-### ⚠️ CRITICAL: Private Key Rules
-- **ALWAYS** use the key from `$AGETHER_PRIVATE_KEY` environment variable. **NEVER** generate, create, or derive a new private key.
-- Do NOT call `ethers.Wallet.createRandom()` or any key-generation function.
-- Do NOT invent or hardcode any private key.
-- If `$AGETHER_PRIVATE_KEY` is not set, **stop and ask the user** — do not improvise.
-### 1.1 Initialize
-```bash
-agether init $AGETHER_PRIVATE_KEY
-```
-Saves config to `~/.agether/config.json`. Uses Base mainnet defaults.
-Override with env vars:
-```bash
-AGETHER_RPC_URL=https://base-rpc.publicnode.com AGETHER_BACKEND_URL=http://95.179.189.214:3001 agether init $AGETHER_PRIVATE_KEY
-```
-### 1.2 Register Agent
-```bash
-agether register --name "MyAgent"
-```
-Does 4 things on-chain:
-1. Mints ERC-8004 identity NFT on Base (assigns agentId)
-2. Creates AgentAccount smart wallet (isolated execution wallet)
-3. Registers code for KYA audit (Pending state)
-4. Fetches initial credit score
-**Requires**: ~$0.01 ETH on Base for gas.
-**Multiple agents per wallet**: YES, one wallet can own many agents. Each `register` mints a new ERC-8004 NFT with a unique agentId.
-**If `--agent-id` was passed to `init`**: The CLI skips minting and uses the existing agent. To register a NEW agent on the same wallet, re-init without `--agent-id` first:
-```bash
-agether init $AGETHER_PRIVATE_KEY          # no --agent-id = fresh start
-agether register --name "NewAgent"         # mints new ERC-8004 token
-# CLI prints new agentId — remember it for future init calls
-```
-### 1.3 Verify
-```bash
-agether balance    # Check ETH + USDC
-agether status     # Check credit line status
-```
+1. **ALWAYS show transaction hashes** — after every on-chain action, show the tx hash with a BaseScan link: `https://basescan.org/tx/<hash>`
+2. **ALWAYS show balance changes** — after deposit/borrow/repay/withdraw, call `agether_balance` and show before→after comparison
+3. **Be proactive** — if the user asks to "pay for an API" or "call a paid API", don't ask questions. Check balance → deposit+borrow if needed → pay. Do the full flow.
+4. **Know your state** — on startup, call `agether_balance` to know your wallet state. If not registered, call `agether_register`.
+5. **Never ask for private keys** — the key is already configured via `$AGETHER_PRIVATE_KEY`.
+6. **Use the right credit path** — MorphoCredit is instant (125% collateral, 80% max LTV). Use it when the user has collateral tokens (WETH, wstETH, cbETH).
+7. **Calculate collateral properly** — max LTV on-chain is 80%. For $X borrow, you need at least $X × 1.25 in collateral value. Use `morpho_compare` to get exact amounts with current oracle prices.
 ---
-## 2. Two Credit Paths
-### Path A: ReputationCredit (Undercollateralized)
-**How it works**: Borrow USDC with only 80% collateral. Based on credit score and KYA code audit. Borrows from protocol LP Vault.
-**Requirements**:
-- Registered agent (agentId)
-- KYA code audit approved by admin
-- Credit application approved by admin
-- Collateral deposit (80% of limit)
-**Full flow**:
-```bash
-# Step 1: Apply for credit
-agether apply --limit 5000
-# Step 2: Wait for admin approval at /test panel
-# Admin approves KYA -> Admin approves credit line -> status becomes Active
-# Step 3: Draw USDC (goes into AgentAccount)
-agether draw --amount 1000
-# Step 4: Use USDC for x402 payments or other purposes
-# Step 5: Repay when done
-agether repay --amount 1000
-```
-**Credit tiers** (based on Bayesian score):
-| Score Range | Max Limit | APR | Collateral |
-|-------------|-----------|-----|------------|
-| 800-1000    | $100,000  | 5%  | 80%        |
-| 600-799     | $50,000   | 8%  | 80%        |
-| 400-599     | $20,000   | 12% | 80%        |
-| 200-399     | $5,000    | 15% | 80%        |
-| 0-199       | Rejected  | -   | -          |
-**Payment schedule**: 30-day cycles with 7-day grace period. Miss payment -> overdue -> potential default.
-### Path B: MorphoCredit (Overcollateralized)
-**How it works**: Deposit collateral (WETH/wstETH/cbETH), borrow USDC at 120% LTV via Morpho Blue. Instant, no admin approval needed.
-**Requirements**:
-- Registered agent (agentId + AgentAccount)
-- Collateral tokens (WETH, wstETH, or cbETH) in EOA wallet
-- No KYA needed, no admin approval needed
-**Full flow**:
-```bash
-# Step 1: Check what you need
-agether morpho-compare --amount 100
-# Step 2: Deposit collateral from EOA -> MorphoCredit -> Morpho Blue
-agether morpho-deposit --amount 0.05 --token WETH
-# Step 3: Borrow USDC (lands in AgentAccount)
-agether morpho-borrow --amount 100
-# Step 4: Use USDC for x402 payments
-# Step 5: Repay
-agether morpho-repay --amount 100
-# Step 6: Withdraw collateral back to EOA
-agether morpho-withdraw --amount all --token WETH
-```
-**Supported collateral**: WETH, wstETH, cbETH (Base addresses)
-**LTV**: 120% (need $120 collateral for $100 borrow)
-**No daily limits, no payment schedule** — repay anytime.
-### Choosing Between Them
-| Feature | ReputationCredit | MorphoCredit |
-|---------|-----------------|--------------|
-| Collateral | 80% (undercollat) | 120% (overcollat) |
-| Speed | Needs admin approval | Instant |
-| KYA required | Yes | No |
-| Source of funds | LP Vault | Morpho Blue pools |
-| Payment schedule | 30-day cycles | None (repay anytime) |
-| Best for | Established agents | Quick access, has collateral |
----
-## 3. x402 Payments
-Make paid API calls. USDC is transferred on-chain via EIP-3009 transferWithAuthorization.
-**Requirement**: USDC in your EOA wallet or AgentAccount. No USDC = payment rejected by facilitator.
-```bash
-# GET request ($0.001 per call to WeatherXM)
-agether x402 "https://agent.weatherxm.com/api/forecast?lat=40.71&lon=-74.00"
-# POST request
-agether x402 "https://api.example.com/data" --method POST --body '{"query":"test"}'
-```
-**How it works internally**:
-1. CLI calls the API -> gets HTTP 402 with payment requirements
-2. CLI signs EIP-3009 transferWithAuthorization (off-chain signature, NOT a tx)
-3. CLI does risk check via backend (optional, non-blocking)
-4. CLI retries the API with PAYMENT-SIGNATURE header
-5. API facilitator verifies signature + settles USDC on-chain
-6. API returns the data
-**Important**: Signing is free and always succeeds. The actual USDC transfer happens server-side by the facilitator. If wallet has 0 USDC, facilitator rejects.
----
-## 4. Complete Command Reference
-### Setup and Identity
-| Command | Args | Description |
-|---------|------|-------------|
-| `agether init <pk>` | `--agent-id <id>` (optional) | Initialize CLI with private key |
-| `agether register` | `--name <name>` | Register ERC-8004 identity + AgentAccount |
-| `agether balance` | none | Show ETH + USDC balances (EOA) |
-| `agether status` | none | Show ReputationCredit line details |
-| `agether score` | none | Show Bayesian credit score + subscores |
-| `agether unified-status` | none | Show ALL credit lines (both types) |
-### ReputationCredit (Undercollateralized)
-| Command | Args | Description |
-|---------|------|-------------|
-| `agether apply` | `--limit <usd>` | Apply for credit line (needs KYA first) |
-| `agether draw` | `--amount <usd>` | Draw USDC from credit line into AgentAccount |
-| `agether repay` | `--amount <usd>` | Repay debt (pulls USDC from EOA into AgentAccount then to credit) |
-### MorphoCredit (Overcollateralized)
-| Command | Args | Description |
-|---------|------|-------------|
-| `agether morpho-compare` | `--amount <usd>` | Compare options, show exact collateral needed (uses oracle prices) |
-| `agether morpho-balances` | none | Show all token balances + max borrow capacity |
-| `agether morpho-markets` | none | List supported Morpho markets |
-| `agether morpho-open` | `--collateral <TOKEN>` | Check or prepare Morpho position (WETH/wstETH/cbETH) |
-| `agether morpho-deposit` | `--amount <n> --token <TOKEN>` | Deposit collateral from EOA into Morpho Blue |
-| `agether morpho-borrow` | `--amount <usd>` | Borrow USDC into AgentAccount |
-| `agether morpho-repay` | `--amount <usd>` | Repay USDC from AgentAccount to Morpho |
-| `agether morpho-withdraw` | `--amount <n> --token <TOKEN>` | Withdraw collateral to EOA (use `--amount all` for max) |
-| `agether morpho-status` | none | Show Morpho positions |
-### Agent Wallet (AgentAccount)
-| Command | Args | Description |
-|---------|------|-------------|
-| `agether wallet-create` | none | Create AgentAccount (usually done by register) |
-| `agether wallet-status` | none | Show AgentAccount balances (ETH + USDC) |
-| `agether wallet-fund` | `--amount <usd>` | Transfer USDC from EOA into AgentAccount |
-| `agether wallet-draw` | `--amount <usd>` | Draw from ReputationCredit into AgentAccount |
-| `agether wallet-repay` | `--amount <usd>` | Repay from AgentAccount to ReputationCredit |
+## 🛠 YOUR TOOLS
+### Identity & Wallet
+| Tool | What it does |
+|------|-------------|
+| `agether_balance` | Show ETH + USDC balances for both EOA wallet and AgentAccount |
+| `agether_register` | Register on-chain: mints ERC-8004 identity NFT + creates AgentAccount |
+| `agether_score` | Show Bayesian credit score (5 factors) |
+| `wallet_fund` | Transfer USDC from EOA wallet → AgentAccount |
+### Morpho Credit (Overcollateralized — instant, no approval)
+| Tool | Params | What it does |
+|------|--------|-------------|
+| `morpho_compare` | `amount` (USD) | Calculate how much collateral needed for a given borrow. **Call this first!** |
+| `morpho_markets` | none | List supported Morpho markets and parameters |
+| `morpho_status` | none | Show all Morpho positions (collateral + debt) |
+| `morpho_deposit` | `amount`, `token` | Deposit collateral from EOA → Morpho (no borrow) |
+| `morpho_deposit_and_borrow` | `collateralAmount`, `token`, `borrowAmount` | Deposit + borrow in one flow. **Best for first-time setup** |
+| `morpho_borrow` | `amount` (USD) | Borrow USDC against existing collateral → lands in AgentAccount |
+| `morpho_repay` | `amount` (USD) | Repay USDC debt from AgentAccount → Morpho |
+| `morpho_withdraw` | `amount` (or "all"), `token` | Withdraw collateral back to EOA wallet |
+| `morpho_sponsor` | `agentId`/`agentAddress`, `amount`, `token`, `borrow?` | Deposit collateral for another agent |
 ### x402 Payments
-| Command | Args | Description |
-|---------|------|-------------|
-| `agether x402 <url>` | `--method GET` or `--method POST` and `--body <json>` | Make paid API call |
----
+| Tool | Params | What it does |
+|------|--------|-------------|
+| `x402_pay` | `url`, `method?`, `body?`, `autoDraw?` | Make a paid API call. Pays with USDC via EIP-3009 signature |
-## 5. Error Codes and Recovery
-### On-Chain Contract Errors (from ReputationCredit or MorphoCredit)
-| Error | Meaning | Fix |
-|-------|---------|-----|
-| `CodeNotApproved` | KYA code audit not yet approved | Wait for admin to approve at /test panel |
-| `DailyLimitExceeded` | Draw exceeds daily limit | Draw smaller amount or wait 24h |
-| `CollateralRequired` | Need to deposit collateral first | `agether collateral --amount <usd>` |
-| `ExceedsAvailable` | Draw exceeds remaining credit | Check `agether status` for available amount |
-| `NotAgentOwner` | Wallet does not own this agentId | Check private key matches registered wallet |
-| `AlreadyHasCreditLine` | Agent already applied | Check status: `agether status` |
-| `BelowMinimum` | Amount below $100 minimum | Use at least $100 |
-| `AboveMaximum` | Amount above $100,000 maximum | Use at most $100,000 |
-| `InsufficientLiquidity` | LP Vault has no USDC | Try MorphoCredit instead, or wait for LP deposits |
-| `Undercollateralized` | LTV too high for Morpho | Deposit more collateral |
-| `AgentDefaulted` | Agent has been defaulted | Cannot use protocol anymore |
-| `InvalidCreditStatus` | Wrong credit line state for this action | Check `agether status` for current state |
-### CLI Errors
-| Error | Meaning | Fix |
-|-------|---------|-----|
-| `Not initialized` | No config file | `agether init <private-key>` |
-| `No agentId` | Registered but agentId=0 | `agether register --name <name>` |
-| `No AgentAccount` | Account not created | `agether register --name <name>` or `agether wallet-create` |
-| `Credit line not active` | Status is Pending/Frozen/Closed | Wait for admin approval or check status |
-| `WALLET MISMATCH` | PK does not match agent owner | Use correct private key |
-| `Insufficient USDC` | Not enough USDC for operation | Fund wallet with USDC on Base |
-| `Insufficient <TOKEN> balance` | Not enough collateral in EOA | Get more WETH/wstETH/cbETH |
-| `Failed to reach backend` | Backend is down | Check http://95.179.189.214:3001/health |
-| `Unsupported token` | Wrong collateral symbol | Use: WETH, wstETH, or cbETH |
-| `No Morpho debt to repay` | No active Morpho borrow | Nothing to do |
-| `No collateral deposited` | Trying to borrow without collateral | `agether morpho-deposit --amount <n> --token WETH` first |
-| `Already registered` | ERC-8004 identity exists | Use existing agentId, set via `agether init <pk> --agent-id <id>` |
-### x402 Errors
-| Error | Meaning | Fix |
-|-------|---------|-----|
-| `Payment rejected (HTTP 4xx/5xx)` | Facilitator rejected the payment | Check USDC balance: wallet needs real USDC |
-| `Could not parse payment requirements` | API response is not valid x402 | API may not be x402-compatible |
-| `Risk check: deny` | Backend risk engine blocked | Payment amount may be too high for credit score |
-| `Request failed` | Network error | Check internet and RPC connectivity |
+### Slash Commands (user types these)
+| Command | What it does |
+|---------|-------------|
+| `/balance` | Quick balance check |
+| `/morpho` | Quick Morpho position summary |
 ---
-## 6. Credit Line States
+## 📋 DECISION TREES
+### User asks to call a paid API (x402)
 ```
-None (0) --[apply]--> Pending (1) --[admin approves]--> Active (2)
-                                                          |
-                                           [admin freezes] --> Frozen (3)
-                                           [admin unfreezes] --> Active (2)
-                                           [default] --> Defaulted (5)
-                                           [close] --> Closed (4)
+1. agether_balance → check USDC in AgentAccount
+2. IF AgentAccount has USDC ≥ $0.01:
+     → x402_pay(url)
+3. IF no USDC but has collateral deposited:
+     → morpho_borrow(amount: "1")    ← borrow $1
+     → x402_pay(url)
+4. IF no USDC AND no collateral:
+     → morpho_compare(amount: "1")   ← see how much WETH needed
+     → Check EOA WETH balance
+     → IF has WETH:
+         morpho_deposit_and_borrow(collateralAmount, token: "WETH", borrowAmount: "1")
+         x402_pay(url)
+     → IF no WETH:
+         Tell user: "Need WETH on Base to get credit. Send WETH to <EOA address>"
 ```
-| Status | Can Draw | Can Repay | Can Apply |
-|--------|----------|-----------|-----------|
-| None (0) | No | No | Yes |
-| Pending (1) | No | No | No |
-| Active (2) | Yes | Yes | No |
-| Frozen (3) | No | Yes | No |
-| Closed (4) | No | No | Yes (re-apply) |
-| Defaulted (5) | No | No | No |
----
-## 7. Decision Trees
-### User wants to call a paid API
+### User wants to borrow USDC via Morpho
 ```
-1. agether balance          -- Do I have USDC?
-   YES --> agether x402 <url>
-   NO  --> Get USDC first:
-         Option A: Buy USDC on Base, send to EOA wallet
-         Option B: Get credit line, then draw:
-           agether morpho-deposit --amount 0.05 --token WETH
-           agether morpho-borrow --amount 10
-           agether wallet-status   -- verify USDC arrived
-           agether x402 <url>
+1. morpho_compare(amount)        ← always call first to get exact collateral needed
+2. morpho_deposit_and_borrow(collateralAmount, token, borrowAmount)
+3. agether_balance               ← show the result with balance changes
+4. Show: tx hash, collateral deposited, USDC borrowed, new balances
 ```
-### User wants credit fast, no approval needed (120% collateral, Morpho)
+### User wants to repay + withdraw
 ```
-1. agether morpho-compare --amount <how-much-usd>
-2. agether morpho-deposit --amount <needed> --token WETH
-3. agether morpho-borrow --amount <usd>
-4. agether wallet-status    -- USDC is in AgentAccount
+1. morpho_status                 ← check current debt and collateral
+2. morpho_repay(amount)          ← repay USDC
+3. morpho_withdraw("all", token) ← get collateral back
+4. agether_balance               ← show final balances
 ```
-### User wants credit with less collateral (80% collateral, needs admin approval)
+### User asks "what can I do?" or "what is agether?"
 ```
-1. agether apply --limit 5000
-2. Wait for admin approval (KYA + credit) at /test panel
-3. agether status           -- check if Active
-4. Deposit 80% collateral (e.g. $4000 for $5000 limit)
-5. agether draw --amount 1000
-6. agether wallet-status    -- USDC is in AgentAccount
+Explain: You're an AI agent with on-chain credit on Base.
+You can:
+- Deposit WETH/wstETH/cbETH as collateral
+- Borrow USDC instantly (125% collateral ratio)
+- Pay for APIs using x402 protocol
+- All on Base mainnet, all autonomous
 ```
-### User wants to check everything
+---
+## 📊 RESPONSE FORMAT
+After **every** on-chain action, format your response like this:
 ```
-agether balance            -- EOA ETH + USDC
-agether wallet-status      -- AgentAccount ETH + USDC
-agether unified-status     -- ALL credit lines, both types
-agether score              -- Bayesian score + 5-factor subscores
+✅ [Action completed]
+📝 Tx: https://basescan.org/tx/0x...
+💰 Balance changes:
+   EOA: 0.05 WETH → 0.047 WETH (-0.003 WETH)
+   AgentAccount: $0 USDC → $5.00 USDC (+$5.00)
+📊 Position:
+   Collateral: 0.003 WETH (~$5.93)
+   Debt: $5.00 USDC
+   LTV: 84% (max 80%)
 ```
-### User wants to repay
+If something **fails**, show the error clearly:
 ```
-ReputationCredit: agether repay --amount <usd>
-MorphoCredit:     agether morpho-repay --amount <usd>
+❌ Borrow failed: ExceedsMaxLtv (83% > 80% max)
+💡 Fix: Deposit more collateral. Need at least $X × 1.25 = $Y in collateral value.
 ```
 ---
-## 8. Backend API Endpoints
-All at http://95.179.189.214:3001:
-| Endpoint | Method | Purpose |
-|----------|--------|---------|
-| `/health` | GET | Health check |
-| `/status` | GET | Contract addresses, chainId, version |
-| `/agents/count` | GET | Total registered agents |
-| `/credit/score/<agentId>` | GET | Bayesian score + 5-factor subscores |
-| `/credit/evaluate` | POST | Evaluate credit application. Body: `{"agentId":"123","requestedLimit":"5000000000"}` |
-| `/morpho/balances/<address>` | GET | Token balances + credit capacity |
-| `/morpho/markets` | GET | Supported Morpho markets |
-| `/morpho/estimate/<amountUsd>` | GET | Collateral estimates with oracle prices |
-| `/morpho/compare` | POST | Compare credit options. Body: `{"agentId":"123","amount":"5000000000"}` |
-| `/morpho/unified/agent/<agentId>` | GET | All credit lines for agent |
-| `/kya/verify` | POST | Verify agent identity (KYA) |
-| `/x402/verify` | POST | Risk-check x402 payment |
-| `/x402/settle` | POST | Settle x402 payment |
-| `/risk/evaluate` | POST | Risk evaluation |
+## 🔢 KEY NUMBERS
----
-## 9. Architecture
-```
-EOA Wallet (your private key)
-  |-- Owns ERC-8004 Identity NFT (agentId)
-  +-- Owns AgentAccount (smart wallet)
-        |-- Holds USDC (from draws or direct funding)
-        |-- drawCredit(provider, amount)   -- pull USDC from credit provider
-        |-- repayCredit(provider, amount)  -- push USDC back to credit provider
-        |-- fund(token, amount)            -- pull from EOA into account
-        +-- payX402(...)                   -- pay for API call
-ReputationCredit (undercollat, 80%)
-  |-- applyForCredit() --> Pending
-  |-- approveCreditLine() --> Active (admin only)
-  |-- draw() --> USDC from LP Vault to AgentAccount
-  |-- repay() --> USDC from AgentAccount to LP Vault
-  +-- declareDefault() --> slashes collateral (admin only)
-MorphoCredit (overcollat, 120%)
-  |-- depositCollateral() --> into Morpho Blue
-  |-- drawWithCollateral() --> USDC from Morpho Blue to AgentAccount
-  |-- repayWithCollateral() --> USDC from AgentAccount to Morpho Blue
-  +-- withdrawCollateral() --> collateral back to EOA
-LP Vault (ERC-4626)
-  |-- LPs deposit USDC --> earn yield from interest
-  +-- Funds ReputationCredit draws
-```
+| Parameter | Value |
+|-----------|-------|
+| Chain | Base mainnet (8453) |
+| Currency | USDC (6 decimals) |
+| Max LTV | 80% (= 125% collateral ratio) |
+| Collateral tokens | WETH, wstETH, cbETH |
+| x402 cost | ~$0.001 per API call (WeatherXM) |
+| Gas cost | ~$0.001–$0.01 per tx |
 ---
-## 10. Key Addresses (Base Mainnet)
+## ⚠️ COMMON ERRORS
-| Contract | Address |
-|----------|---------|
-| AccountFactory | 0xeB72f248Ad9F4bf4024e8D9da75cf7AAD37B58f5 |
-| LPVault | 0x612A80D6c3175F8283e9C7EE71d5177fE9acc338 |
-| ReputationCredit | 0x57B2B4ef3e7B8BE5FC86c6369602125d240F552A |
-| MorphoCredit | 0x7dFfa40E17471F7f26F5662D0F07a31977F47BeB |
-| ValidationRegistry | 0x8842f2383A86134Dd80c3Ecf6Bbae2e38396A5ec |
-| AgentReputation | 0xF1bed094D4E33E47CC8C72E086FFFde09e2211b4 |
-| USDC | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
-| ERC-8004 Identity | 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 |
-| WETH | 0x4200000000000000000000000000000000000006 |
-| wstETH | 0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452 |
-| cbETH | 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 |
-| Morpho Blue | 0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb |
+| Error | Meaning | What to do |
+|-------|---------|-----------|
+| `ExceedsMaxLtv` | Collateral too low for borrow amount | Deposit more collateral or borrow less. LTV must be ≤ 80% |
+| `Payment rejected (402)` | No USDC for x402 payment | Borrow USDC first: `morpho_borrow` or `morpho_deposit_and_borrow` |
+| `No collateral deposited` | Trying to borrow without collateral | `morpho_deposit` first |
+| `Insufficient WETH/wstETH/cbETH` | EOA doesn't have enough collateral | Tell user to send collateral to EOA address |
+| `Insufficient USDC in AgentAccount` | Not enough USDC for repay | Need to fund AgentAccount or borrow more |
+| `ExecutionFailed` | Smart contract call reverted | Check inner error, usually LTV or approval issue |
 ---
-## 11. Installation (For New Bot or Team Lead)
+## 🏗 ARCHITECTURE (for context)
-### Prerequisites
-- Node.js >= 20
-- A wallet with ~$0.01 ETH on Base (gas) + USDC on Base (for x402 payments)
-### Install CLI
-```bash
-git clone <repo-url>
-cd agent-credit-protocol/sdk
-npm install
-npm run build
-npm link          # Makes agether command available globally
 ```
+EOA Wallet (private key)
+  ├── Owns ERC-8004 Identity NFT (agentId)
+  └── Owns AgentAccount (smart wallet)
+        ├── Holds USDC (from borrows)
+        └── Executes credit operations
-### Quick Test
-```bash
-# 1. Setup
-agether init <private-key>
-agether register --name "TestBot"
-agether balance
-# 2. Quick credit via Morpho (if you have WETH)
-agether morpho-compare --amount 5
-agether morpho-deposit --amount 0.003 --token WETH
-agether morpho-borrow --amount 5
-agether wallet-status
-# 3. Make a paid API call ($0.001)
-agether x402 "https://agent.weatherxm.com/api/forecast?lat=40.71&lon=-74.00"
-# 4. Repay and clean up
-agether morpho-repay --amount 5
-agether morpho-status
+MorphoCredit (overcollateralized, 125%)
+  ├── depositCollateralFor() → collateral into Morpho Blue
+  ├── drawWithCollateral()   → USDC from Morpho Blue → AgentAccount
+  ├── repayWithCollateral()  → USDC from AgentAccount → Morpho Blue
+  └── withdrawCollateral()   → collateral back to EOA
 ```
-### OpenClaw Integration
-1. Copy SKILL.md into OpenClaw's skill folder:
-```bash
-mkdir -p ~/.openclaw/skills/agether
-cp SKILL.md ~/.openclaw/skills/agether/SKILL.md
-```
+---
-2. Add to `~/.openclaw/openclaw.json` under `skills.entries`:
-```json
-{
-  "agether": {
-    "enabled": true,
-    "env": {
-      "AGETHER_PRIVATE_KEY": "<your-private-key>",
-      "AGETHER_RPC_URL": "https://base-rpc.publicnode.com",
-      "AGETHER_BACKEND_URL": "http://95.179.189.214:3001"
-    }
-  }
-}
-```
+## 📍 CONTRACT ADDRESSES (Base Mainnet)
-OpenClaw reads the SKILL.md from `~/.openclaw/skills/agether/` and finds the `agether` binary on PATH (from `npm link`).
+| Contract | Address |
+|----------|---------|
+| AccountFactory | `0xeB72f248Ad9F4bf4024e8D9da75cf7AAD37B58f5` |
+| MorphoCredit | `0x7dFfa40E17471F7f26F5662D0F07a31977F47BeB` |
+| ERC-8004 Identity | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
+| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
+| WETH | `0x4200000000000000000000000000000000000006` |
+| wstETH | `0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452` |
+| cbETH | `0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22` |