Domande e risposte
Risposte allineate allo stato attuale di GriffinX su Arbitrum Sepolia: Market, Pools, Trade, P2P e wallet. I numeri on-chain (LTV, fee, oracoli) restano quelli dei contratti; in testnet usa solo fondi di prova.
Cos'è GriffinX
Che cos'è GriffinX?
GriffinX è una dApp DeFi su Arbitrum Sepolia (testnet). Unisce sei prodotti: Market Overcollateral (prestiti LTV), Market Pegno a scadenza, Pools di liquidità, Radar (intel mercati 24/7), Trade (perpetual su Orderly) e P2P crypto↔fiat. I fondi lending restano negli smart contract: GriffinX non custodisce le chiavi del wallet.È già mainnet? Posso usare soldi veri?
No. Oggi GriffinX è solo testnet. Token mock (mUSDC, mETH, …), ETH di prova per il gas, Trade su Orderly testnet e P2P in ambiente di prova. Non depositare fondi mainnet: le transazioni sulla rete sbagliata non arrivano ai contratti GriffinX.Su quale rete funziona GriffinX oggi?
Lending (Market, Pegno, Pools) su Arbitrum Sepolia, chain ID 421614. Trade usa Orderly testnet sulla stessa rete. P2P usa escrow on-chain Sepolia più API per chat e metodi di pagamento. In MetaMask seleziona Arbitrum Sepolia (il pulsante «Passa a Arbitrum Sepolia» nella dApp aggiunge la rete se manca).Come ottengo ETH e token per provare?
Serve ETH di testnet su Arbitrum Sepolia per il gas (faucet pubblici Arbitrum/Sepolia). I token della dApp sono mock ERC-20 whitelistati, non USDC/ETH mainnet. Non c'è un faucet nella navbar: i mock si ottengono in testnet dal team / dagli script di prova. Senza saldo mock le approve e le tx di prestito falliscono.Devo connettere il wallet su ogni prodotto?
Sì, almeno la prima volta: Market/Pools, Trade e P2P sono siti distinti (griffinx.it, trade.griffinx.it, p2p.griffinx.it). Il wallet è lo stesso (MetaMask); ogni origine chiede i permessi una volta. Trade usa il connettore Orderly; lending e P2P usano la connessione diretta al wallet.
I sei prodotti
Quali prodotti ci sono e dove li trovo?
Market — offerte Overcollateral (LTV) e Pegno a scadenza tra due wallet; crea offerta e apri posizione dalla stessa pagina.
Pools — liquidità condivisa: depositi, borrow, delega credito; Factory già live su Sepolia.
Mio portfolio — le tue offerte, posizioni LTV, pegni e ruoli (garante, offerta riservata).
Radar — intel mercati (tassi, rischio, segnali) e Prezzi & pledge: spot USD, grafico e calcolatori per fixed-term pledge e Overcollateral. I tassi vincolanti restano on-chain.
Trade — perpetual futures (ETH-PERP e altri) su Orderly testnet: grafico, order book, posizioni.
P2P — compra/vendi crypto con fiat via annunci, escrow on-chain e chat.Radar influenza i tassi on-chain?
No. Radar è intel di mercato (display-only): confronta APR esterni, stima stress collaterale e suggerisce FIXED vs FLEXIBLE. I prezzi in Radar → Prezzi & pledge sono vetrina (CoinGecko, fallback Binance) e non entrano nel contratto. I tassi GriffinX restano quelli on-chain (CDY / getFlexibleRate / curve pool). Non è predizione di prezzo né consiglio finanziario.Quali sono i due tipi di prestito sul Market?
Overcollateral (LTV): prestito collateralizzato con LTV, margin call e liquidazione; puoi aggiungere/ritirare collaterale e ripagare, anche in parte. Pegno: un solo mutuario prende tutto il capitale, deposita un importo fisso di collaterale, durata 1–365 giorni e tasso sul periodo scelto dal prestatore; rimborso pro-rata prima della scadenza, altrimenti il prestatore claima il pegno. Nessun oracolo, nessuna liquidazione sul prezzo. Entrambi si creano dal pannello Market (toggle Overcollateral / Pegno).
Market Overcollateral (LTV)
Come creo un'offerta LTV?
Connetti il wallet su Market, scegli Overcollateral, l'asset da prestare, l'importo, uno o più collaterali ammessi, LTV e la modalità di tasso (fisso o flessibile). Scegli «Un mutuatario — prelievo intero» oppure «Multimutuatario — prelievi parziali». Confermi approve + transazione sul Diamond LTV. L'offerta compare in Offerte disponibili.Cosa sono LTV, margin call e liquidation LTV?
Sono in BPS (1% = 100 BPS). LTV = massimo prestito rispetto al collaterale. Margin call = soglia di allerta (impostata a livello protocollo). Liquidation LTV = oltre questa soglia la posizione può essere liquidata. Esempio: LTV 70% = 7000 BPS. L'health factor dipende da questi valori e dal prezzo on-chain del collaterale.Cosa significano «Un mutuatario» e «Multimutuatario» in creazione offerta LTV?
Non sono più due opzioni separate. Un mutuatario: un solo wallet può aprire e deve prelevare tutta la liquidità disponibile in un’unica apertura. Multimutuatario: più wallet possono aprire sulla stessa offerta e ogni apertura usa solo una parte della liquidità. Il saldo non prestato puoi ritirarlo da Mio portfolio / Le mie offerte.Come apro una posizione (prendo un prestito LTV)?
Sul Market scegli un'offerta nella lista, apri il dettaglio e inserisci debito e collaterale. Se rispetti LTV e non sei il prestatore, confermi openPosition. Poi gestisci la posizione da Mio portfolio (ripaga, aggiungi/ritira collaterale).Cos'è l'health factor?
Indica quanto la posizione è lontana dalla liquidazione: valore del collaterale rispetto al debito e alle soglie dell'offerta. Se scende troppo, un liquidatore può chiudere la posizione. Aggiungi collaterale o ripaga per rialzarlo.Chi può liquidare una posizione?
Qualsiasi wallet può chiamare liquidate quando l'health factor è sotto soglia (prezzo oracolo + LTV di liquidazione). Non è un'azione riservata a GriffinX. In testnet i prezzi mock possono muoversi: tieni collaterale in eccesso se vuoi evitare liquidazioni di prova.Come annullo un'offerta?
Da Mio portfolio / Le mie offerte, se non c'è debito attivo sull'offerta, puoi cancellarla e recuperare la liquidità rimasta.Cos'è un'offerta riservata?
In creazione offerta LTV (o dopo da Le mie offerte) il prestatore può riservarla a uno o più wallet autorizzati. Solo quei wallet potranno accettare l'offerta. Con offerta multimutuatario, in creazione vanno indicati almeno 2 portafogli. Non è delega credito: il mutuario designato deve comunque fornire garanzia (collaterale proprio o di un garante). Per tornare al market pubblico usa "Rendi pubblica".Offerta riservata (Market) vs delega credito (Pool): qual è la differenza?
Offerta riservata (Market) — whitelist del borrower su una singola offerta P2P: solo gli indirizzi autorizzati possono 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).
Market Pegno a scadenza
Come funziona un pegno?
Il prestatore blocca il capitale e fissa collaterale, durata e tasso sul periodo. Un solo mutuario accetta: deposita il pegno, riceve il prestito meno la fee di protocollo. Prima della scadenza rimborsa capitale + interessi pro-rata e ritira il collaterale. Dopo la scadenza, se non ha rimborsato, il prestatore fa claim del pegno. Gestione da Mio portfolio / I miei pegni.C’è liquidazione se il prezzo del collaterale scende?
No. Il contratto Pegno non legge oracoli e non liquida sul prezzo. Il rischio di mercato resta sul prestatore fino alla data. I prezzi in vetrina (se mostrati) sono solo informativi.Posso rimborsare dopo due giorni su un pegno a 30 giorni?
Sì, prima della scadenza. Gli interessi sono pro-rata sui giorni (o secondi) trascorsi, con un minimo di 1 secondo. Dopo la scadenza il rimborso è chiuso: resta solo il claim del prestatore. In Radar → Prezzi & pledge puoi simulare il rimborso anticipato con gli stessi numeri del contratto.Dove vedo i prezzi dei token e gli strumenti per il fixed-term pledge?
Radar → Prezzi & pledge. Listino dei 12 mock (spot USD + variazione 24h + grafico stile CoinGecko). I prezzi arrivano da CoinGecko (piano demo gratuito); se non risponde si usa Binance pubblico. Sotto, i calcolatori stimano LTV implicito e rimborso anticipato del fixed-term pledge, e LTV / health factor / calo fino a margin call o liquidazione per Overcollateral. Non muovono il contratto.Il Leverage è ancora disponibile?
No. Il prodotto Leverage (skin/base, settle quotidiano, liquidazione oracolo) è ritirato. Lo slot nel Market è il Pegno. Eventuali prestiti Leverage già aperti restano sul Diamond vecchio fino a chiusura naturale; non si migrano nel pegno.
Pools di liquidità
Cosa sono le Pools?
Mercati di liquidità condivisi già on-chain (Factory su Arbitrum Sepolia): più prestatori depositano lo stesso asset (es. mUSDC) e ricevono share pro-rata. I mutuatari prendono in prestito dalla pool, non da una singola offerta. Il tasso borrow segue l'utilization (curva kink). In creazione puoi usare una curva fissa oppure market-linked (base ancorata al CDY entro bound immutabili).Come creo una pool?
Pools → Crea pool: wizard (asset, collaterale, tassi, seed minimo, ricompense opzionali). I parametri di rischio restano fissi alla creazione. Serve wallet connesso, seed token e gas. Dopo il deploy la pool compare in elenco; in Mio portfolio → Le mie pool vedi creator, supply lzLP e borrow con metriche e withdraw.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. Nelle Pool il tasso è automatico in base all'utilizzo (e, se market-linked, al CDY); sul Market il prestatore imposta LTV/tasso (LTV) o durata/tasso di periodo (Pegno).Cos'è la delega credito nelle Pool?
Nelle Pool (Factory già live su Sepolia) 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.
Trade (perpetual)
Che cos'è Trade?
È il modulo perpetual su trade.griffinx.it, alimentato da Orderly Network (testnet, broker demo). Grafico candele, order book, last trades e pannello ordini. Non usa i Diamond LTV né il contratto Pegno: è trading, non prestito collateralizzato GriffinX.Perché a volte chiede di nuovo Connetti wallet?
Trade è un altro dominio. Orderly gestisce la sessione di trading dopo il connect. Connetti MetaMask dalla navbar; i depositi nel conto Orderly (es. USDC testnet) seguono il flusso del pannello ordini, non il Market lending.I fondi su Trade sono gli stessi del Market?
No. I mock token nei Diamond lending non sono il saldo Orderly. Per tradare depositi nel vault/account Orderly dalla UI Trade. Ritirare da Orderly non sblocca un'offerta Market.
P2P (crypto ↔ fiat)
Come funziona P2P?
Su p2p.griffinx.it gli advertiser pubblicano annunci (compra/vendi, es. mock USDC con EUR). All'apertura del trade la crypto del venditore va in escrow on-chain. Il buyer paga il fiat fuori catena con i dati dell'ordine, segnala «Pagamento completato»; il seller rilascia i token. Chat e metodi di pagamento passano dall'API GriffinX. Fee di protocollo oggi 0 bps (modificabile on-chain dall'owner, max 1%).Cosa succede se il fiat non arriva o c'è un problema?
Non pagare conti diversi da quelli dell'ordine e non uscire dalla chat del trade. Se hai già pagato puoi aprire una disputa; un arbitrator on-chain risolve. Se non hai ancora pagato puoi annullare. Dettagli anche nella FAQ del singolo trade.P2P è lo stesso del Market «P2P lending»?
No. Il Market è prestito crypto-crypto tra wallet. P2P GriffinX è marketplace crypto↔fiat con escrow. Stessa navbar, prodotti e rischi diversi.
Collaterale, token, oracoli e CDY
Quali asset sono supportati?
In testnet i mock ERC-20 whitelistati: mETH, mLINK, mLTC, mMATIC, mSOL, mAAVE, mAVAX, mBNB, mBTC, mDAI, mUSDC, mUSDT. La whitelist on-chain (listWhitelist) è quella vincolante. Non sono token mainnet: servono per provare i flussi.Posso usare più di un asset come collaterale per un'offerta?
Sì, in creazione offerta LTV puoi selezionare più token collaterale. Non è consentito stablecoin vs stablecoin (es. prestare mUSDC con collaterale mUSDT).Da dove arrivano i prezzi?
On-chain da oracoli (feed tipo Chainlink) configurati dall'owner del Diamond. Se manca il feed, le operazioni che richiedono prezzo possono fallire (es. «No oracle for asset»).Cosa sono i rate mode FIXED e FLEXIBLE?
FIXED: tasso in BPS fissato alla creazione dell'offerta. FLEXIBLE: tasso da getFlexibleRate sul contratto (mercato/oracolo, include CDY). La UI mostra una stima annua/giornaliera in base alla modalità.Che cos'è il CDY?
Credit Demand Yield: un parametro on-chain (bps) usato nel tasso flessibile del Market LTV e, se scegli market-linked, come base della curva Pool (clampata a bound fissi alla creazione). Il Pegno non usa CDY: il tasso lo fissa il prestatore. Il valore globale si legge dai Diamond; lo storico in UI è un snapshot, non un feed live dell'indexer.
Wallet, fee e sicurezza
Devo approvare i token prima di usare la dApp?
Sì. Creare offerta, depositare in pool, aprire posizione o ripagare richiede approve verso il contratto corretto (Diamond LTV, LendzyPawn o pool). La dApp propone l'approve prima della transazione principale.I miei fondi sono custoditi da GriffinX?
No. Lending e escrow P2P sono smart contract. Trade passa da Orderly (non-custodial verso GriffinX). Verifica sempre rete (Arbitrum Sepolia) e indirizzo contratto nel wallet prima di firmare.Perché una transazione fallisce?
Cause tipiche in testnet: rete diversa da Arbitrum Sepolia, ETH gas insufficiente, saldo mock troppo basso, approve mancante, LTV non rispettato, oracolo assente, oppure stai usando un'offerta riservata a un altro wallet. Il messaggio in dApp traduce l'errore on-chain quando possibile.Cos'è un flash loan su GriffinX?
Prestito istantaneo senza collaterale sul Diamond LTV (e, se ancora attivo on-chain, sul Diamond Leverage ritirato in UI): capital + fee nella stessa transazione, altrimenti revert. Serve un contratto IFlashLoanReceiver, non un wallet normale. La fee default è 9 bps (0,09%). Il Pegno non offre flash loan.
Contratti LTV, Pegno e Pool Factory sono separati. Fee/pause Pegno e margin call LTV: pannelli owner in Mio portfolio. Whitelist, oracoli e ops avanzate: admin panel esterno.

