lends-sdk 0.1.0

Non-custodial Python SDK for LENDS lending, leUSD, and sleUSD.

LENDS Python SDK

Typed, non-custodial access to LENDS lending/borrowing, the leUSD PSM, and sleUSD staking.

Install

python -m pip install lends-sdk

Usage

import os
from lends_sdk import LendsClient

lends = LendsClient(os.environ["RPC_URL"])
lends.assert_chain()

protocol = lends.get_protocol_state()
markets = lends.get_markets()
position = lends.get_position(
    "0x1111111111111111111111111111111111111111",
    markets[0].address,
)

amount = 10 ** markets[0].collateral_decimals
approval = lends.transactions.approve_collateral(markets[0].address, amount)
deposit = lends.transactions.deposit(markets[0].address, amount)

PreparedTransaction.as_dict() returns to, data, value, and chainId for a wallet or signing system. The SDK does not accept private keys, sign, or broadcast.

All amounts are raw integer token units. leUSD and sleUSD use 6 decimals; collateral and USDG decimals are read on-chain; oracle prices are normalized to 8 decimals. Quotes and projected position values are point-in-time previews. Contract execution is authoritative.

Scope

Included: approvals, collateral deposit/withdrawal, borrow/repay, fee accrual, PSM conversion, sleUSD stake/unstake lifecycle, and relevant state/statistics.

Excluded: every privileged write, liquidation execution, reserves, harvests, losses, minters, risk settings, pauses, ownership, upgrades, LENDS purchases, locks, liquidity, and vesting.

Development

python -m pip install -e ".[dev]"
python -m unittest discover -s tests
ruff check .
mypy
python -m build
twine check dist/*