Domande e risposte
Questa sezione spiega in modo trasparente le funzionalità della dApp Lendzy: tipi di prestito, offerte, posizioni, collaterale, tassi e sicurezza.
Cos'è Lendzy
Che cos'è Lendzy?
Lendzy è una dApp di prestito e prestito decentralizzato (DeFi). I prestatori creano offerte bloccando liquidità e definendo condizioni (LTV, tasso, collaterale). I mutuatari prendono prestiti accettando un'offerta o aprendo una posizione fornendo collaterale. Tutto avviene on-chain tramite smart contract, senza intermediari.Su quale rete funziona Lendzy?
Lendzy è configurato per la rete Arbitrum Sepolia (testnet). I contratti LTV (Advanced Lending) e Leverage sono deployati su Arbitrum Sepolia. I prezzi degli asset possono provenire da oracoli Chainlink configurati dall'admin sul contratto.
Due tipi di prestito
Quali sono i due tipi di prestito?
Ci sono due modelli: (1) Overcollateral (LTV) – prestiti collateralizzati con LTV, margin call e liquidazione; puoi aggiungere/ritirare collaterale, ripagare o essere liquidato. (2) Leverage – prestiti a cicli con parametri skin/base, interesse giornaliero e rimborso completo a scadenza.Dove trovo le offerte Overcollateral e quelle Leverage?
Le offerte Overcollateral (LTV) sono nella pagina Market (lista principale) e puoi crearle da Market o da "Crea offerta". Le offerte Leverage sono nella pagina "Leverage" e i tuoi prestiti Leverage in "Leverage Loans". Le posizioni LTV (Overcollateral) sono in "Le mie posizioni".
Pools di liquidità
Cosa sono le Pools?
Le Pools sono mercati di liquidità condivisi: più prestatori depositano lo stesso asset (es. mUSDC) e ricevono share (lpToken) pro-rata su interessi e perdite. I mutuatari prendono in prestito dalla pool, non da una singola offerta. Market e Leverage restano per prestiti diretti offerta-per-offerta.Come creo una pool?
Vai su Pools → Crea pool e segui il wizard (asset, collaterale, tassi, seed minimo, ricompense opzionali). I parametri di rischio e la curva tasso sono fissati alla creazione. Quando i contratti Pool saranno deployati, la creazione avverrà on-chain tramite LendzyPoolFactory; fino ad allora la UI può salvare configurazioni in anteprima locale.Qual è la differenza tra un'offerta Market e una Pool?
Un'offerta ha un solo lender on-chain; una Pool ha molti co-prestatori con quote verificabili. Nelle Pool il tasso borrow segue l'utilization (curva kink); l'APY supply dipende da quanto viene effettivamente preso in prestito.
Offerte (lato prestatore)
Come creo un'offerta?
Da Market puoi scegliere "Overcollateral" o "Leverage" e compilare il form. Per Overcollateral: scegli l'asset da prestare (borrow asset), la liquidità da bloccare, uno o più asset come collaterale, LTV / margin call / liquidation LTV e la modalità di tasso (fisso o flessibile). Per Leverage: oltre ai campi base, imposti ciclo (giorni), skin %, base premium % e interesse giornaliero %. Puoi anche usare la pagina dedicata "Crea offerta" per una sola offerta LTV.Cosa sono LTV, margin call e liquidation LTV?
Sono espressi in BPS (centesimi di punto percentuale). LTV = rapporto prestito/valore collaterale massimo concesso. Margin call LTV = soglia oltre la quale la posizione è "a rischio". Liquidation LTV = soglia oltre la quale la posizione può essere liquidata. Esempio: LTV 70% = 7000 BPS; la salute della posizione (health factor) dipende da questi valori e dal prezzo del collaterale.Cosa significano «Più mutuatari» e «Draw parziale» in creazione offerta LTV?
Due opzioni separate: «Più mutuatari» permette a wallet diversi di aprire posizioni sulla stessa offerta; se disattivo, un solo wallet può usare l'offerta finché c'è debito aperto. «Draw parziale» consente di prendere solo una parte della liquidità disponibile; se disattivo, ogni apertura deve usare tutto il disponibile. Il saldo non prestato puoi ritirarlo da Le mie offerte.Come annullo un'offerta?
Nella pagina "Le mie offerte" vedi le tue offerte (contratto LTV). Puoi cancellare un'offerta se le condizioni del contratto lo consentono (es. nessun debito attivo).Cos'è un'offerta riservata?
Dopo aver creato un'offerta sul Market (LTV o Leverage), il prestatore può riservarla a un wallet specifico con setOfferDelegatedBorrower (pannello "Offerta riservata" in Le mie offerte o Mio portfolio). Solo quel wallet potrà accettare l'offerta. Non è delega credito: il mutuario designato deve comunque fornire garanzia (collaterale proprio o di un garante). Per tornare al market pubblico usa "Rendi pubblica" (indirizzo zero on-chain).Offerta riservata (Market) vs delega credito (Pool): qual è la differenza?
Offerta riservata (Market) — whitelist del borrower su una singola offerta P2P: solo l'indirizzo impostato con setOfferDelegatedBorrower può chiamare acceptOffer / openPosition. Il prestatore resta unico lender; nessun trasferimento di linea di credito.
Delega credito (Pool) — modello stile Aave su liquidità aggregata: il delegator deposita collaterale nella pool e chiama approveDelegation sul debt token; il delegatee può borrow(amount, onBehalfOf=delegator), riceve i token ma il debito resta sul delegator. Serve per prestiti onBehalfOf nelle Pool, non per filtrare chi accetta un'offerta Market.
In sintesi: riservata = chi può accettare l'offerta; delega Pool = chi può prendere in prestito a nome del delegator nella pool.Cos'è il collaterale di terzi (garante)?
Su Market/posizioni LTV il borrower può approvare un garante (approveOfferGuarantor o approvePositionGuarantor). Il garante deposita collaterale con depositCollateralFor; in liquidazione la perdita è pro-rata. Al rimborso ogni contributor ritira la propria quota. Per aprire con collaterale fornito da terzi in un'unica tx usa openPositionWithProviders dopo approveOfferGuarantor. Chi vuole (o non vuole) ricevere richieste attiva/disattiva da Mio portfolio con setGuarantorReceiving (on-chain; default ON).Cos'è la delega credito nelle Pool?
Nelle Pool (liquidità aggregata, creabili via Factory quando deployate) il delegator deposita collaterale e approva una quota di borrow sul debt token (approveDelegation). Il delegatee può borrow(amount, onBehalfOf=delegator): riceve i fondi, il debito resta sul delegator. È distinto dall'offerta riservata sul Market — vedi la domanda "Offerta riservata vs delega credito" sopra.
Flash loan
Cos'è un flash loan su Lendzy?
Prestito istantaneo senza collaterale: prendi token dal contratto LTV o Leverage e li restituisci (capitale + fee) nella stessa transazione. Se non restituisci tutto, l'operazione viene annullata e non resti indebitato. Serve un contratto smart (IFlashLoanReceiver), non un wallet normale.Quanto costa la fee flash loan?
La fee default è 9 bps (0,09%) sull'importo preso in prestito, configurabile on-chain con flashFeeBps. Su 1.000 USDC la fee è circa 0,9 USDC. Vedi fee e liquidità disponibile nella pagina Tools → Flash loan.Da dove arriva la liquidità per i flash loan?
Dal saldo ERC20 già presente nei contratti LTV e Leverage (liquidità bloccata dalle offerte, rimborsi, fee). Se il contratto non ha abbastanza token dell'asset richiesto, il flash loan non parte.Come eseguo un flash loan dalla dApp?
1) Deploy del contratto demo LendzyFlashLoanDemo (contracts/v3/) con l'indirizzo del pool LTV o Leverage. 2) Vai su Tools → Flash loan, sezione "Esecuzione avanzata". 3) Approva la fee del token verso il receiver. 4) Compila receiver, asset, importo ed esegui flashLoan. Il receiver demo ripaga amount+fee prelevando la fee dal tuo wallet.
Tassi (FIXED vs FLEXIBLE)
Cosa sono i rate mode FIXED e FLEXIBLE?
FIXED: il tasso è fissato in BPS (fixedRateBps) al momento della creazione dell'offerta. FLEXIBLE: il tasso è determinato dal mercato/oracolo (getFlexibleRate sul contratto). La dApp mostra il tasso annuo/diario stimato in base alla modalità selezionata.
Posizioni LTV (Overcollateral)
Come apro una posizione (prendo un prestito LTV)?
Vai al Market, scegli un'offerta dalla lista (offerte LTV) e clicca per aprire il dettaglio (pagina /offer?id=…). Inserisci l'importo di debito e il collaterale che desideri bloccare. Se rispetti LTV e condizioni dell'offerta, puoi confermare; la transazione openPosition viene eseguita sul contratto LTV. Dopo il successo sei reindirizzato a "Le mie posizioni".Cosa posso fare su una posizione aperta?
Puoi ripagare (parzialmente o totalmente), aggiungere collaterale, ritirare collaterale (se il contratto e l'health factor lo consentono) e, se applicabile, liquidare una posizione altrui quando sotto la soglia di liquidazione.Cos'è l'health factor?
È un indicatore di "salute" della posizione: rapporto tra valore collaterale (ponderato) e debito, rispetto alle soglie di liquidazione. Se scende sotto 1 (o sotto la soglia definita dal contratto), la posizione può essere liquidata. Mantenere l'health factor sopra la soglia di margin call è importante per evitare rischi.
Prestiti Leverage
Come funziona un prestito Leverage?
Il prestito Leverage ha un ciclo (es. 7–90 giorni), una componente "skin" e una "base" (in %), e un interesse giornaliero. Accetti un'offerta Leverage dalla pagina Leverage o dal dettaglio offerta; il debito e il collaterale sono bloccati sul contratto Leverage. Durante il ciclo puoi pagare gli interessi (settleInterest) e a scadenza (o prima) rimborsare in full (repayLoan).Cosa sono skin e base?
Sono percentuali (in BPS) definite dall'offerente: skin (es. 5–25%) e base premium (es. 5–25%). Insieme all'interesse giornaliero determinano il costo del prestito e come evolve il debito/collaterale nel tempo. La dApp mostra lo stato del prestito (stage, giorni rimanenti, skin rimanente, ecc.) in "Leverage Loans".Un'offerta Leverage può essere accettata in parte?
Ogni offerta Leverage ammette un solo mutuario che deve prendere tutta la liquidità bloccata in un'unica accettazione. L'opzione «importo parziale» non è al momento disponibile in creazione offerta.Dove gestisco i miei prestiti Leverage?
Nella pagina "Leverage Loans" (o "My Leverage Loans"). Da lì puoi vedere lo stato di ogni prestito, pagare gli interessi dovuti e rimborsare il prestito per intero.
Collaterale e asset
Quali asset sono supportati?
Attualmente la dApp supporta i token configurati sulla rete (es. Arbitrum Sepolia): mETH, mLINK, mLTC, mMATIC, mSOL, mAAVE, mAVAX, mBNB, mBTC, mDAI, mUSDC, mUSDT. La whitelist effettiva è definita on-chain (listWhitelist); solo gli asset whitelistati possono essere usati come collaterale o come asset da prestare.Posso usare più di un asset come collaterale per un'offerta?
Sì. Nella creazione offerta puoi selezionare più token come collaterale (CollateralSelectorModal). Verrà creata un'offerta per ogni asset collaterale selezionato (tranne il caso stablecoin vs stablecoin, che non è consentito).Perché non posso usare uno stablecoin come collaterale quando presto uno stablecoin?
Per evitare rischi e arbitraggi inutili: prestito e collaterale in stablecoin della stessa natura non sono ammessi. La dApp blocca questa combinazione in fase di validazione.
Prezzi e oracoli
Da dove arrivano i prezzi degli asset?
I prezzi possono essere letti dagli smart contract (getAssetPriceRaw) che a loro volta usano oracoli (es. Chainlink). L'admin del contratto deve aver configurato i feed dei prezzi per ogni asset whitelistato. Se un oracolo non è configurato, il contratto può revertare con errori tipo "No oracle for asset" o "Invalid price".
Approvazioni e sicurezza
Devo approvare i token prima di usare la dApp?
Sì. Per bloccare liquidità (creare offerta), bloccare collaterale (aprire posizione) o ripagare, devi aver approvato lo smart contract a spendere i token del tuo wallet (approve). La dApp può guidarti nelle approvazioni necessarie per l'operazione che stai eseguendo.I miei fondi sono custoditi da Lendzy?
No. I fondi sono gestiti dagli smart contract on-chain. Non c'è un custodio centrale: le transazioni sono firmate dal tuo wallet (es. MetaMask) e eseguite sulla blockchain. È importante verificare gli indirizzi dei contratti e la rete (es. Arbitrum Sepolia) prima di effettuare transazioni.
Navigazione e pagine
Quali sono le pagine principali della dApp?
Market – Lista offerte LTV, filtri e pannello per creare offerta (Overcollateral o Leverage).
Crea offerta – Form dedicato per creare un\'offerta LTV.
Leverage – Lista offerte Leverage e creazione offerta Leverage.
Le mie offerte – Le tue offerte LTV con possibilità di annullare.
Le mie posizioni – Le tue posizioni LTV: ripaga, aggiungi/ritira collaterale, liquidazione.
Leverage Loans – I tuoi prestiti Leverage attivi: pagamento interessi e rimborso.
Tools → Flash loan – Fee e liquidità disponibile per flash loan (LTV e Leverage).
Dettaglio offerta (/offer?id=…) – Dettagli e azione "Borrow" (apri posizione LTV o accetta offerta Leverage).
Per dettagli tecnici su oracoli e configurazione admin (whitelist, feed Chainlink) puoi consultare la documentazione nel repository (.cursor/ORACOLI_ADMIN_E_FEED_SEPOLIA.md). I contratti LTV e Leverage sono separati; indirizzi e ABI sono in src/config/contract.ts e contractLeverage.ts.

