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.