Lista Lending Skill (POC)

Status: Pre-release (internal only, not in public registry) Agent quick check:
node dist/cli.js 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/transfer)

Routing Priority (Required)

Apply these routing rules before running commands:

Wallet/session/signing issues (

pair

auth

sign

topic

session

) →

lista-wallet-connect

Lending write operations (

deposit

withdraw

supply

borrow

repay

market-withdraw

) →

lista-lending

Lending actionable reads (
```
holdings
```
,
```
vaults
```
,
```
markets
```
for selection/filtering/follow-up execution) →
```
lista-lending
```
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

text

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

Wallet is paired via
```
lista-wallet-connect
```
skill.
You have a valid
```
wallet-topic
```
and
```
wallet-address
```
.
Node.js version is
```
>= 18.0.0
```
(recommended
```
>= 20
```
).

lista-wallet-connect

is built (

skills/lista-wallet-connect/dist/cli.js

exists).

lista-lending

is built (

skills/lista-lending/dist/cli.js

exists).

Setup (Agent-Run)

Agent should run these steps automatically when environment is not ready:

bash

# install dependencies
cd skills/lista-lending && npm install

# build
npm run build

Agent execution path:

bash

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

Output Contract

```
stdout
```
: machine-readable JSON (result payload)
```
stderr
```
: errors only

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.
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)

Command Index

```
version
```
- show skill version and compatibility hints
```
config
```
- read/update RPC settings
```
vaults
```
- list vaults with filters
```
markets
```
- list markets with filters (SmartLending/fixed-term filtered)
```
holdings
```
- query user positions across vault + market
```
select
```
- set active vault or market context
```
deposit
```
- deposit to selected/explicit vault
```
withdraw
```
- withdraw from selected/explicit vault
```
supply
```
- supply collateral to selected/explicit market
```
borrow
```
- simulate or execute borrow
```
repay
```
- simulate or execute repay
```
market-withdraw
```
- withdraw supplied collateral from selected/explicit market

Global/Shared Options

```
--chain <eip155:56|eip155:1>
```
```
--wallet-topic <topic>
```
```
--wallet-address <0x...>
```

Command Details

All command snippets below are for agent execution; do not instruct the user to type them manually.

version

Purpose: Print skill version and dependency constraints.

bash

node dist/cli.js version

config

Purpose: Manage RPC override.

Examples:

bash

# show config
node dist/cli.js config --show

# set rpc override
node dist/cli.js config --set-rpc --chain eip155:56 --url https://bsc-mainnet.nodereal.io/v1/<key>

# clear rpc override
node dist/cli.js config --clear-rpc --chain eip155:56

Notes:

Config file:
```
~/.agent-wallet/lending-config.json
```
Chain fallback RPCs are still used if primary RPC fails.

vaults

Purpose: Discover vaults from SDK list API.

Common options:

```
--page
```
,
```
--page-size
```
,
```
--sort
```
,
```
--order
```
```
--zone
```
,
```
--keyword
```
```
--assets <a,b>
```
,
```
--curators <a,b>
```

Examples:

bash

node dist/cli.js vaults
node dist/cli.js vaults --chain eip155:1
node dist/cli.js vaults --sort apy --order desc --page 1 --page-size 10
node dist/cli.js vaults --assets 0x8d0d...,0x55d3... --curators "Lista DAO,Pangolins"

markets

Purpose: Discover markets from SDK list API.

Common options:

```
--page
```
,
```
--page-size
```
,
```
--sort
```
,
```
--order
```
```
--zone
```
,
```
--keyword
```
```
--loans <a,b>
```
,
```
--collaterals <a,b>
```

Examples:

bash

node dist/cli.js markets
node dist/cli.js markets --chain eip155:56 --sort liquidity --order desc --page-size 20
node dist/cli.js markets --loans USD1,USDT --collaterals USD1,BTCB

Notes:

Command filters out SmartLending (
```
zone=3
```
) and fixed-term (
```
termType=1
```
) markets in output.

Always include this user-facing note when presenting market list:

Smart Lending and fixed-term market operations are currently not supported in this skill. For full functionality, please use the Lista website.

holdings

Purpose: Query positions by wallet address.

Options:

```
--address <0x...>
```
(optional if context already has
```
userAddress
```
)
```
--scope <all|vault|market|selected>
```

Examples:

bash

# all positions (vault + market)
node dist/cli.js holdings --address 0xYOUR_ADDRESS

# only vault positions
node dist/cli.js holdings --address 0xYOUR_ADDRESS --scope vault

# only market positions
node dist/cli.js holdings --address 0xYOUR_ADDRESS --scope market

# only currently selected position
node dist/cli.js holdings --scope selected

Market position fields include:

User-facing fields:

```
isSmartLending
```
(
```
zone === 3
```
)
```
isFixedTerm
```
(
```
termType === 1
```
)

isActionable

(

!isSmartLending && !isFixedTerm

)

Raw JSON technical fields (debug/integration only):
- ```
zone
```
  ,
```
termType
```

select

Purpose: Persist active target in context for follow-up operations.

Modes:

select vault:
```
--vault
```
select market:
```
--market
```
read context:
```
--show
```
clear context:
```
--clear
```

Examples:

bash

# select vault
node dist/cli.js select \
  --vault 0xfa27f172e0b6ebcef9c51abf817e2cb142fbe627 \
  --chain eip155:56 \
  --wallet-topic <topic> \
  --wallet-address 0xYOUR_ADDRESS

# select market
node dist/cli.js select \
  --market 0xd384584abf6504425c9873f34a63372625d46cd1f2e79aeedc77475cacaca922 \
  --chain eip155:56 \
  --wallet-topic <topic> \
  --wallet-address 0xYOUR_ADDRESS

# show/clear
node dist/cli.js select --show
node dist/cli.js select --clear

Notes:

Market selection rejects SmartLending and fixed-term markets.
Context file:
```
~/.agent-wallet/lending-context.json
```

deposit

Purpose: Deposit vault asset.

Required:

```
--amount
```
plus either selected vault context or explicit
```
--vault
```
+ wallet info

Example:

bash

# using selected vault
node dist/cli.js deposit --amount 1

# explicit target
node dist/cli.js deposit \
  --vault 0xVAULT \
  --amount 1 \
  --chain eip155:56 \
  --wallet-topic <topic> \
  --wallet-address 0xYOUR_ADDRESS

withdraw

Purpose: Withdraw vault asset.

Required:

one of
```
--amount
```
or
```
--withdraw-all
```

Examples:

bash

node dist/cli.js withdraw --amount 0.5
node dist/cli.js withdraw --withdraw-all

supply

Purpose: Supply market collateral.

Required:

```
--amount
```
plus selected market context or explicit market/wallet parameters

Example:

bash

node dist/cli.js supply --amount 2

10)

borrow

Purpose: Borrow loan token, or simulate borrow capacity.

Modes:

simulate only:
```
--simulate
```
simulate with hypothetical supply:
```
--simulate --simulate-supply <amt>
```
execute borrow:
```
--amount <amt>
```

Examples:

bash

# check max borrowable
node dist/cli.js borrow --simulate

# check max after hypothetical supply
node dist/cli.js borrow --simulate --simulate-supply 2

# execute borrow
node dist/cli.js borrow --amount 0.01

11)

repay

Purpose: Repay market debt, or simulate repay impact.

Modes:

simulate repay amount:
```
--simulate --amount <amt>
```
simulate repay-all:
```
--simulate --repay-all
```
execute repay:
```
--amount <amt>
```
or
```
--repay-all
```

Examples:

bash

# simulate partial repay impact
node dist/cli.js repay --simulate --amount 0.01

# simulate full repay impact
node dist/cli.js repay --simulate --repay-all

# execute
node dist/cli.js repay --amount 0.01
node dist/cli.js repay --repay-all

12)

market-withdraw

Purpose: Withdraw market collateral.

Required:

one of
```
--amount
```
or
```
--withdraw-all
```

Examples:

bash

node dist/cli.js market-withdraw --amount 0.5
node dist/cli.js market-withdraw --withdraw-all

Transaction Behavior

Transactions are built by SDK and executed through
```
lista-wallet-connect
```
```
call
```
command.
```
call
```
performs simulation by default before requesting wallet signature.
If simulation fails, result is returned as error/reverted and no signing request is sent.

If user rejects in wallet, command returns

status: "rejected", reason: "user_rejected"

For multi-step operations (approve + action), responses include completed step count and failed/pending step.

Typical Workflows

Vault flow

bash

# 1) discover
node dist/cli.js vaults --chain eip155:56

# 2) select
node dist/cli.js select --vault 0xVAULT --wallet-topic <topic> --wallet-address 0xADDR

# 3) operate
node dist/cli.js deposit --amount 1
node dist/cli.js withdraw --amount 0.5

Market flow

bash

# 1) discover
node dist/cli.js markets --chain eip155:56

# 2) select
node dist/cli.js select --market 0xMARKET --wallet-topic <topic> --wallet-address 0xADDR

# 3) operate
node dist/cli.js supply --amount 2
node dist/cli.js borrow --simulate
node dist/cli.js borrow --amount 0.01
node dist/cli.js repay --simulate --amount 0.01
node dist/cli.js repay --amount 0.01
node dist/cli.js market-withdraw --amount 1

Security Checklist

Confirm token symbol and amount with user before any state-changing action.
Confirm chain (
```
eip155:56
```
vs
```
eip155:1
```
) before sending tx.
Prefer
```
borrow --simulate
```
before first borrow on a market.
Treat
```
user_rejected
```
as normal user decision, not protocol failure.

lista-lending

NPX Install

Tags

SKILL.md Content

Lista Lending Skill (POC)

Agent Execution Policy

When to Use This Skill

Routing Priority (Required)

Scope

Temporary Limitations

Project Structure

Prerequisites

Setup (Agent-Run)

Output Contract

Agent Display Guidelines

Supported Chains

Command Index

Global/Shared Options

Command Details

1)
`version`

2)
`config`

3)
`vaults`

4)
`markets`

5)
`holdings`

6)
`select`

7)
`deposit`

8)
`withdraw`

9)
`supply`

10)
`borrow`

11)
`repay`

12)
`market-withdraw`

Transaction Behavior

Typical Workflows

Vault flow

Market flow

Security Checklist

lista-lending

NPX Install

Tags

SKILL.md Content

Lista Lending Skill (POC)

Agent Execution Policy

When to Use This Skill

Routing Priority (Required)

Scope

Temporary Limitations

Project Structure

Prerequisites

Setup (Agent-Run)

Output Contract

Agent Display Guidelines

Supported Chains

Command Index

Global/Shared Options

Command Details

1) version

2) config

3) vaults

4) markets

5) holdings

6) select

7) deposit

8) withdraw

9) supply

10) borrow

11) repay

12) market-withdraw

Transaction Behavior

Typical Workflows

Vault flow

Market flow

Security Checklist

1)
`version`

2)
`config`

3)
`vaults`

4)
`markets`

5)
`holdings`

6)
`select`

7)
`deposit`

8)
`withdraw`

9)
`supply`

10)
`borrow`

11)
`repay`

12)
`market-withdraw`