GLIF Docs
V2 English
V2 English
  • Introduction
    • Quick Guide
    • GLIF Overview
    • Protocol Users
  • For Liquidity Providers
    • Benefits for token holders
    • GLIF Reward Mechanism - iFIL
    • Exit - Withdraw FIL
    • Asset Security
    • Risks
  • For Storage Providers
    • Benefits for Storage Providers
    • SP Liquidation Values
    • Borrowing Limits & DTL
    • Uses of Borrowed FIL
    • Liquidations
    • Borrowing Cost
    • Manage Miner Actors with Agents
    • Guarantor Model
  • Developer Resources
    • GLIF SDK
    • GLIF CLI
    • Deployed Contracts
  • TROUBLESHOOTING
    • FAQ
      • FAQ for Liquidity Providers
        • About GLIF
        • Deposit FIL
        • Withdraw FIL
        • Risk
        • Wallet Connection
        • GLIF Points
        • Miscellaneous
      • FAQ for Storage Providers
        • Borrow and Withdraw FIL
        • Key Financial Ratio
        • Payment
        • Liquidation
        • Agents
        • Transaction Issue
    • TUTORIALS
      • For Token Holders
        • Wallets
          • How to find your corresponding 0x/f410 wallet address
          • How to obtain a Ledger wallet as the intermediary wallet
          • How to obtain a burner wallet as the intermediary wallet
          • How to obtain a FilSnap wallet as the intermediary wallet
          • How to connect your wallet to Filecoin Mainnet
          • How to transfer FIL from a 0x address to an f1 address
          • How to create a multisig wallet on GLIF
        • Using the Pool
          • Deposit FIL into GLIF to earn rewards
          • How to deposit Filecoin from a hardware wallet with GLIF
          • How to deposit FIL to GLIF using multisig wallet
          • Withdraw FIL from GLIF
          • How to withdraw FIL from GLIF using a multisig wallet
        • Transfer FIL to/from exchanges
          • Transfer FIL between exchange and GLIF
          • Binance
            • Transfer FIL from Binance to GLIF
            • Transfer FIL from GLIF to Binance
          • MEXC
            • Transfer FIL from MEXC to GLIF
            • Transfer FIL from GLIF to MEXC
      • For Storage Providers
        • GLIF Agent Website Tutorial Part I— Preparation Setup
        • GLIF Agent Website Tutorial Part II — Create your Agent
        • GLIF Agent Website Tutorial Part III — Add Your Miner
        • How to withdraw FIL from the agent to an exchange at GLIF
      • How to Claim $GLF Airdrop
    • Glossary
    • Contact Us
  • Governance
    • Governance
    • Delegation
    • Proposals (GIPs)
    • Voting Process
Powered by GitBook
On this page
  1. TROUBLESHOOTING

Glossary

PreviousHow to Claim $GLF AirdropNextContact Us

Last updated 8 months ago

  • Administration: SPs with a Debt-to-Liquidation (DTL) ratio above 75% are eligible to be put on "administration", which allows GLIF to pay down the SP's debt using any available balances on the SP's miners. No terminations or penalties occur if a GLIF administrator pays down an SP's debt. Borrowing and withdrawal are also disabled. The goal of the administrator is to recover the SP into good standing with GLIF (DTL < 75%). Refer for details.

  • Agents: Agents are smart contracts on the FEVM that allow Storage Providers (SPs) to collateralize Filecoin Miner Actors (miners) in order to borrow FIL from GLIF. Agents act as intermediaries between SPs and GLIF, allowing SPs to maintain ownership and control over their miner(s) while borrowing from GLIF. Refer for details.

  • Agent Police: The Agent Police is a smart contract that ensures each Storage Provider adheres to the rules of the system. If an SP violates system rules, the Agent Police is responsible for preventing certain actions like borrowing and withdrawing, and in certain circumstances, is responsible for liquidating SPs to recover assets on behalf of LPs. Refer for details.

  • Agent Data Oracle (ADO): An off-chain data aggregator within the GLIF protocol that collects real-time and historical data on SPs to facilitate secure and low-cost access to real-time data inside FEVM smart contracts. The ADO will be eventually phased out as the FEVM matures, and more real-time data is available on-chain. Refer for details.

  • APR (Annual Percentage Rate): The annualized fee rate charged to Storage Providers, expressed as a percentage. Refer for details.

  • Borrowing Limits: Borrowing limit means the maximum amount for SP to borrow and use for sealing, which is not the same as the amount available for withdrawal, as the Debt-to-Liquidation (DTL) will be affected when SP withdraw from GLIF. Refer for details. The maximum DTL ratio for an SP when they can borrow from GLIF is 75%, which means an SP's debt cannot exceed 75% of its liquidation value. Refer for details.

  • Debt-to-Liquidation (DTL): This ratio determines the amount an SP can borrow based on their liquidation value. Refer for details. It is computed as:

DTL=Principal+InterestOwed/LiquidationValueDTL = Principal + Interest Owed/Liquidation ValueDTL=Principal+InterestOwed/LiquidationValue
  • Debt Value: SP's outstanding principal plus any unpaid interest.

  • Exit: The process by which iFIL holders can withdraw FIL from GLIF at any time, provided that the pool has sufficient liquidity to process the withdrawal. Refer for details.

  • GLIF: GLIF is the foundational DeFi primitive of Filecoin - enabling Filecoin token holders to earn sustainable rewards on their FIL by lending (aka “leasing”) it to a diverse pool of Filecoin miners (also known as “Storage Providers”). Storage Providers borrow FIL to use as pledge collateral in Filecoin mining, which helps Storage Providers grow and simultaneously improves the security of the Filecoin network. GLIF is Filecoin's first and most popular DeFi protocol. Refer for details.

  • Guarantors: A model allows a single SP to aggregate multiple Miner Actors together, aggregating its equity and borrowing power. This architecture allows a big Miner Actor with a large equity value to post collateral for a much smaller node to borrow funds. Refer for details.

  • iFIL: iFIL is GLIF's reward token - an ERC20 token deployed on FEVM. Liquidity Providers (LPs) hold iFIL tokens to earn rewards. Refer for details. The current iFIL price is computed as:

iFILPrice=(PoolTotalDeposits+PoolExpectedEarnings)/iFILCirculatingSupplyiFIL Price=(PoolTotalDeposits+PoolExpectedEarnings)/iFIL Circulating SupplyiFILPrice=(PoolTotalDeposits+PoolExpectedEarnings)/iFILCirculatingSupply
  • LiquidationValue=MinerBalance−MinerMaxTerminationFeeLiquidationValue = MinerBalance - MinerMaxTerminationFeeLiquidationValue=MinerBalance−MinerMaxTerminationFee
MinerBalance=AvailableBalance+VestingBalance+InitialPledgeMinerBalance = AvailableBalance + VestingBalance + InitialPledgeMinerBalance=AvailableBalance+VestingBalance+InitialPledge
  • Miner: In the context of the Filecoin project, a miner refers to the built-in Filecoin Miner Actor responsible for managing storage mining operations and providing proofs. One Storage Provider may run more than one Filecoin Miners.

RecoveryRate=(PledgeBalance−MaxTerminationFee)/PledgeBalanceRecoveryRate = (PledgeBalance - MaxTerminationFee) / PledgeBalanceRecoveryRate=(PledgeBalance−MaxTerminationFee)/PledgeBalance
  • Termination Fee: The amount of FIL that would be lost in a liquidation scenario.

Liquidation Threshold: SPs with a DTL ratio above 85% are in a critical risk zone for liquidation. Immediate corrective actions and proactive communication with the GLIF team are essential to avoid liquidation and minimize further losses. Refer for details.

Liquidation Value: The estimated value of a Storage Provider's miners that could be recovered if the miner's sectors were terminated, calculated after considering termination fee. Refer for details. It is computed as:

Liquidity Providers: A FIL token holder that has deposited FIL into GLIF and actively holds iFIL. Refer for details of what they can do with GLIF.

Liquidity Reserve: The pool maintains a 10% asset reserve specifically for facilitating iFIL exit. Refer for details.

Owner and Operator Key: The GLIF protocol utilizes two distinct keys for managing Agent smart contracts. Only the Storage Provider should have access to these keys, and it's important to keep them private and safe. Refer for details.

Recovery Rate: The portion of an SP's pledged FIL that would be recovered in a liquidation event. Refer for details. Computed as:

Storage Providers (SPs): Storage Providers (SPs) are individuals or organizations operating one or more (“Miner”). Refer for details of what they can do with GLIF.

Withdrawal: Storage Providers can withdraw FIL to fund fiat denominated expenses like gas, payroll, rent. When an SP borrows FIL for withdrawing outside of GLIF, it becomes restricted by DTL faster because borrowed FIL is not included in the SP's liquidation value. Refer for details.

here
here
here
here
here
here
here
here
here
here
here
here
here
here
here
here
here
here
Filecoin Miner Actors
here
here