Lista Lending

Lista Lending Skill (POC)

Status: Pre-release (internal only, not in public registry) Agent quick check: node dist/cli/cli.bundle.mjs version Agent rebuild: npm install && npm run build

Execute Lista Lending vault and market operations through @lista-dao/moolah-lending-sdk, with transaction sending delegated to lista-wallet-connect.

Agent Execution Policy

• Execute CLI/setup commands directly as the agent; do not ask the user to run shell commands.
• If dependencies/build are missing or outdated, run setup/build automatically.
• Before any signing or on-chain write action, explain the action and get user consent.
• Do not output raw JSON/internal payloads to users by default; convert results into human-readable summaries/tables.
• Use command snippets in this document as agent-side execution references only.

When to Use This Skill

This skill handles LENDING-SPECIFIC viewing and operations.

✅ Use when user wants to:

1. View LENDING positions only:

• "Check my lending positions"
• "Show my Lista vaults"
• "What's in my lending markets"
• "My collateral in lending vaults"

2. Execute lending operations:

• "Deposit 100 USDT to Lista vault"
• "Withdraw from my Lista vault"
• "Borrow against my collateral"
• "Repay my lending debt"
• "Find best lending yield"

❌ Do NOT use for:

• All-product/report-style overview → Use lista
• "Check ALL my Lista positions" (report view) → Use lista
• "My total Lista collateral/debt" (summary-style answer) → Use lista

Key difference:

• lista: VIEW report-style lending analytics and summaries
• lista-lending: VIEW/OPERATE lending only (vaults + markets)
• lista-wallet-connect: Wallet operations (connect/sign/call)

Routing Priority (Required)

Apply these routing rules before running commands:

1. Wallet/session/signing issues (pair, auth, sign, topic, session) → lista-wallet-connect
2. Lending write operations (deposit, withdraw, supply, borrow, repay, market-withdraw) → lista-lending
3. Lending actionable reads (holdings, vaults, markets for selection/filtering/follow-up execution) → lista-lending
4. Report/narrative analysis (position report, risk check, daily digest, high-level market/vault summary) → lista

Ambiguous intent handling:

• check my positions: if user asks for operation follow-up or lending-only detail, use lista-lending; otherwise use lista.
• market list / vault list: if user needs execution target selection, use lista-lending; if user only wants macro overview, use lista.

Scope

Supported capabilities:

• Vault: vaults, select --vault, deposit, withdraw
• Market: markets, select --market, supply, borrow, repay, market-withdraw
• Portfolio: holdings
• Runtime/config: config, version

Not in scope:

• CDP operations
• Non-EVM chains

Temporary Limitations

Current unsupported market types for trade actions (select/supply/borrow/repay/market-withdraw):

• SmartLending markets (zone === 3)
• Fixed-term markets (termType === 1)

Behavior:

• markets command filters them out from list output.
• select --market rejects them with unsupported_market_type.
• holdings still returns them (for full portfolio visibility) and marks:
  • isSmartLending
  • isFixedTerm
  • isActionable

Project Structure

skills/lista-lending/
├── SKILL.md
├── package.json
├── tsconfig.json
└── src/
    ├── cli/                # args/help/meta/run
    ├── api/                # vault/market/user read-side queries
    ├── sdk/                # SDK client + market runtime prefetch
    ├── executor/           # tx execution + receipt polling
    ├── commands/           # command handlers
    │   ├── shared/         # context/errors/output/tx helpers
    │   ├── select/
    │   ├── borrow/
    │   └── repay/
    ├── presenters/
    ├── utils/
    ├── config.ts
    ├── context.ts
    ├── api.ts              # API facade export
    ├── sdk.ts              # SDK facade export
    ├── executor.ts         # executor facade export
    └── cli.ts              # CLI entrypoint

Notes:

• CLI parsing/routing lives in src/cli/* and keeps src/cli.ts as the single entrypoint.
• Read-side querying is split by domain in src/api/* (vault, market, user).
• SDK integration is centralized in src/sdk/client.ts; market runtime prefetch is in src/sdk/market-runtime.ts.
• borrow and repay are split into dedicated simulate and execute modules to keep command files small.

Prerequisites

1. Wallet is paired via lista-wallet-connect skill.
2. You have a valid wallet-topic and wallet-address.
3. Node.js version is >= 18.0.0 (recommended >= 20).
4. lista-wallet-connect is built (skills/lista-wallet-connect/dist/cli/cli.bundle.mjs exists).
5. lista-lending is built (skills/lista-lending/dist/cli/cli.bundle.mjs exists).

Setup (Agent-Run)

Use prebuilt dist/ by default for faster startup.

cd skills/lista-lending
# ensure Node.js >= 18 (recommended >= 20)
node -v
node dist/cli/cli.bundle.mjs version

Only run install/build when dist/ is missing or version check fails:

cd skills/lista-lending
npm install
npm run build
node dist/cli/cli.bundle.mjs version

Fallback for local debugging (non-bundled output):

cd skills/lista-lending
npm run build
node dist/cli.js version

If skills/lista-wallet-connect/dist/cli/cli.bundle.mjs is missing, rebuild wallet-connect as well:

cd skills/lista-wallet-connect
npm install
npm run build

Agent execution path:

cd skills/lista-lending
node dist/cli/cli.bundle.mjs <command> [options]

Output Contract

• stdout: machine-readable JSON (result payload)
• stderr: errors only
• Optional debug mode: add --debug-log-file <path> to append structured stdout/stderr logs (jsonl).

Agent Display Guidelines

For user-facing answers, keep CLI JSON as internal source of truth, then render human-readable tables/summaries. Return raw JSON only when the user explicitly asks for raw output.

vaults recommended columns:

• Vault, Asset, TVL (USD), APY, Curator

markets recommended columns:

• Collateral, Loan, LLTV, Borrow Rate, Liquidity (USD)

holdings recommended structure:

• Summary block first: total vault count, total market count, actionable market count, unsupported market count.
• Vault table columns:
  • Vault, Chain, Deposited, Deposited USD, APY, Wallet Balance
• Actionable market table columns:
  • Market, Chain, Collateral USD, Borrowed USD, LTV, Health
• Unsupported market table columns (non-technical by default):
  • Market, Chain, Reason, Collateral USD, Borrowed USD

Default rule:

• Use different table layouts for different commands (vaults, markets, holdings); do not reuse holdings layout for vault/market list pages.
• Keep CLI/runtime JSON and debug logs in raw format (for example eip155:56, eip155:1) for stable machine parsing and debugging.
• For user-facing text/tables, map chain IDs to names (eip155:1 -> Ethereum, eip155:56 -> BSC).
• Do not show zone/termType in user-facing table unless user explicitly asks for technical details.
• Do not paste full raw payloads (JSON/RPC internals) in normal user-facing replies.
• Derive Reason from flags:
  • isSmartLending => SmartLending
  • isFixedTerm => Fixed-term

Health definition (for market positions):

• Formula: health = LLTV / LTV when LTV > 0; otherwise health = 100.
• Display label suggestion:
  • Healthy: health >= 1.2
  • Warning: 1.0 <= health < 1.2
  • Risk: health < 1.0
• Action hint: if label is Warning or Risk, suggest repay/reduce borrow.

Supported Chains

• eip155:56 (BSC, default)
• eip155:1 (Ethereum)