# JustLend DAO Documentation > JustLend DAO is the largest lending protocol on TRON, based on the Compound V2 architecture. Users supply TRX and TRC20 assets as collateral to earn interest, borrow against that collateral, stake TRX for sTRX (liquid staking), or rent TRON Energy at a discount. This site documents the protocol for users, integrators, and AI agents. > Site `Last-Modified` and per-page commit dates are published via HTTP headers and the page footer. For documentation change history see [CHANGELOG.md](https://github.com/justlend/justlend-docs/blob/main/CHANGELOG.md). ## Authoritative machine-readable sources - [OpenAPI 3.1 specification](https://docs.justlend.org/developers/apis/justlend_apis.yaml): Machine-readable contract for the public read-only HTTP API at `https://openapi.just.network`. Importable into Swagger UI, Postman, or any LLM tool. - [API reference (rendered)](https://docs.justlend.org/developers/apis): Swagger UI rendering of the OpenAPI spec. - [sitemap.xml](https://docs.justlend.org/sitemap.xml): Full list of indexable documentation pages. ## Getting started - [Overview](https://docs.justlend.org/getting_started/overview): Protocol model — suppliers, borrowers, jTokens, interest rates, liquidation. - [Whitepaper (PDF)](https://justlend.org/docs/justlend_whitepaper_en.pdf): Full protocol design. - [Supply concept](https://docs.justlend.org/getting_started/concepts/supply) - [Borrow concept](https://docs.justlend.org/getting_started/concepts/borrow) - [Withdraw concept](https://docs.justlend.org/getting_started/concepts/withdraw) - [Repay concept](https://docs.justlend.org/getting_started/concepts/repay) - [Liquidations](https://docs.justlend.org/getting_started/concepts/liquidations) - [Risks](https://docs.justlend.org/getting_started/concepts/risks) - [Staked TRX (sTRX)](https://docs.justlend.org/getting_started/concepts/staked_trx) - [Energy Rental](https://docs.justlend.org/getting_started/concepts/energy_rental) ## Governance - [JIPs (JustLend Improvement Proposals)](https://docs.justlend.org/governance/jips) - [Tokenomics (JST)](https://docs.justlend.org/governance/tokenomics) - [Community Forum](https://forum.justlend.org) ## Developer reference - [Contracts Overview](https://docs.justlend.org/developers/contracts_overview): Architecture across SBM, interest rate models, oracle, governance, comptroller. - [Supply and Borrow Market (SBM)](https://docs.justlend.org/developers/supply_and_borrow_market/sbm): Function signatures for `mint`, `borrow`, `repayBorrow`, `redeem`, `borrowBalanceCurrent`, etc. - [Interest Rate Model](https://docs.justlend.org/developers/supply_and_borrow_market/interest_rate_model) - [Governance contracts](https://docs.justlend.org/developers/supply_and_borrow_market/governance) - [Price Oracle](https://docs.justlend.org/developers/supply_and_borrow_market/price_oracle) - [Comptroller](https://docs.justlend.org/developers/supply_and_borrow_market/comptroller) - [Staked TRX contracts](https://docs.justlend.org/developers/staked_trx) - [Energy Rental contracts](https://docs.justlend.org/developers/energy_rental) - [Deployed Contracts](https://docs.justlend.org/developers/deployed_contracts): Mainnet and Nile addresses for jTokens, interest rate models, oracle, governance, comptroller, sTRX, and Energy Rental. - [Machine-readable contract directory](https://docs.justlend.org/developers/contracts.json): JSON address book with `base58`, `hex_evm`, `hex_tron`, and Tronscan links for Mainnet and Nile. - [Machine-readable ABIs](https://docs.justlend.org/developers/abis/jtoken.json): JSON ABI files under `/developers/abis/` for jToken, Comptroller, PriceOracle, TRC20, governance, WJST, sTRX, Energy Rental, and rate models. ## AI Agent integration - [AI / LLMs](https://docs.justlend.org/ai_support/ai_llms): Human-readable directory for `llms.txt`, `llms-full.txt`, OpenAPI, contract JSON, and ABI JSON endpoints. - [JustLend Skills](https://docs.justlend.org/ai_support/justlend_skills) (`@justlend/justlend-skills`): Read-only skills package + lightweight MCP server (**9 query tools**). Source: . - [Full MCP Server](https://docs.justlend.org/ai_support/mcp_server) (`@justlend/mcp-server-justlend`, v1.0.7, **59 tools**): Full read/write MCP server for supply, borrow, repay, withdraw, sTRX staking, energy rental, governance voting, mining rewards, transfers, and general TRON utilities. Source: . - [MCP source ABIs and network config](https://github.com/justlend/mcp-server-justlend): Upstream TypeScript definitions used to generate the docs JSON ABI and address files. ## API endpoints (read-only HTTP API) Base URL: `https://openapi.just.network`. Schema in [justlend_apis.yaml](https://docs.justlend.org/developers/apis/justlend_apis.yaml). Endpoints include: - `GET /lend/jtoken` — All jToken markets with supply/borrow APY, mining rewards, TVL. - `GET /lend/jtoken/{address}` — Single jToken details. - `GET /lend/account/{address}` — Account positions, health factor, rewards. - `GET /lend/dashboard` — Protocol-level totals (TVL, supply, borrow, users). - `GET /lend/mining` — Mining reward configuration and status. Refer to the OpenAPI spec for the full endpoint list, request parameters, response schemas, units, and error responses. ## Resources - [Audits — Supply & Borrow (PDF)](https://justlend.org/docs/justlend_audit_en.pdf) - [Audits — Staked TRX (PDF)](https://justlend.org/docs/justlend_strx_audit_en.pdf) - [Risk Warning](https://docs.justlend.org/resources/risk_warning) - [Wallet Integration Cooperation](https://docs.justlend.org/resources/community/wallet_integration_cooperation) - [Community Links](https://docs.justlend.org/resources/community/links) - [Terms of Service (PDF)](https://justlend.org/docs/JustLend_Terms_of_Use_en.pdf) - [Privacy Policy (PDF)](https://justlend.org/docs/JustLend_Privacy_Policy_en.pdf) ## Notes for AI agents - **Networks**: Rendered contract tables are **TRON Mainnet** unless a section says otherwise. Use Nile testnet (`NETWORK=nile`) for testing, and fetch [`/developers/contracts.json`](https://docs.justlend.org/developers/contracts.json) for Mainnet + Nile addresses. - **Address formats**: `contracts.json` includes Base58, EVM `0x` hex, and TRON-internal `41` hex. Rendered tables may show Base58 only. - **Precision**: jToken balances are returned in jToken units (8 decimals). Underlying token amounts use that token's own decimals (TRX = 6, USDT = 6, USDC = 6, BTC = 8, ETH = 18, etc.). Always check the underlying token's `decimals()` before submitting transactions. - **Rate limits**: The public OpenAPI service is unauthenticated and may throttle abusive clients. Keep `pageSize <= 1000`, cache market metadata, avoid tight polling loops, and retry `429` / `5xx` with exponential backoff. - **Recommended source-of-truth priority**: (1) OpenAPI spec → (2) MCP server tools → (3) rendered docs. The HTML docs are for human reading; for programmatic use prefer the OpenAPI spec and MCP server. - **Read-only vs. write**: The HTTP API and the JustLend Skills MCP server are read-only. Only `@justlend/mcp-server-justlend` exposes write tools. Write operations are clearly marked with `destructiveHint: true` and require an encrypted local wallet via `@bankofai/agent-wallet`. ## Optional - [llms-full.txt](https://docs.justlend.org/llms-full.txt) — Condensed full-text snapshot of the documentation for single-fetch LLM consumption.