HODL

HODL is a cross-chain, crypto-backed lending protocol that allows users to collateralize their digital assets and borrow fiat currency directly to their bank account.

1. The Core Vision
   The traditional financial world and the decentralized economy are separated by a "friction gap." Users who believe in the long-term value of their crypto (HODLers) are often forced to sell their assets to cover real-world expenses like rent, bills, or business costs.
   HODL eliminates this trade-off. It provides a seamless bridge that allows you to keep your crypto upside while accessing immediate fiat liquidity, regardless of which blockchain your assets live on. HODL turns your crypto into a high-utility line of credit.

2. The Problem: The "Cost of Liquidity"
   Currently, if a user holds AVAX but needs USD in their bank, they face three major pain points:

• The Tax Trap: Selling crypto triggers capital gains taxes.
• The Bridge Barrier: Moving assets across chains is technically risky and slow.
• The Multi-Hop Headache: Moving from DeFi to a Centralized Exchange to a Bank takes days and involves high fees.

3. The Solution: How HODL Works
   At the heart of HODL is the Chainlink Runtime Environment (CRE). This isn't just a relay; it is the secure, decentralized execution layer that ensures every borrow and unlock request is verified, signed, and executed with institutional-grade security. By leveraging the CRE, HODL removes the "trust" factor from the off-chain orchestrator(Hodl Backend), making the bridge between your bank and the blockchain transparent and immutable.

• Step 1: Secure Deposit: Users choose their entry point. Whether you are depositing on the Hub or an Spoke contracts, your assets are locked in non-custodial smart contracts. HODL never takes "custody"—the code controls the vault.
• Step 2: Automated Verification (CRE) The Chainlink Runtime Environment (CRE) monitors these vaults. It acts as the bridge that tells the protocol: "The collateral is safe, the price-feeds are verified, and it is safe to issue the loan."
• Step 3: Global Liquidity & Fiat Payout HODL sources stable assets from the Base Hub. These are instantly off-ramped through our integrated fiat partners, delivering USD or EUR directly to your bank account via ACH or Wire transfer.
• Step 4: Seamless Repayment Repay in fiat to clear your debt. Once the Hub confirms the repayment, the CRE triggers the automatic release of your collateral, whether it’s on Base or Avalanche.

4. Key Product Features

• Chainlink-Grade Security: Utilizing the CRE means HODL inherits the security properties of the world's most trusted decentralized oracle network.
• Omni-Chain Liquidity: You aren't limited to the liquidity of a single chain. HODL aggregates power from the Base Hub to serve every Spoke.
• Price-Feed Parity: We use custom sync jobs to ensure that even "non-native" assets on the Spoke are priced accurately against the Hub, protecting you from unfair liquidations.
• Pure Abstraction: No bridging, no manual swapping, and no gas-fee headaches on the destination chain.

5. The User Journey: Tap, Lock, Spend
6. Select: Choose your collateral (e.g., AVAX) and the amount of fiat you need.
7. Lock: Secure your assets in the HODL Spoke Vault.
8. Receive: The HODL Orchestrator settles the debt on the Base Hub and wires fiat to your account.
9. Repay: Pay back the loan in fiat to automatically unlock your crypto.

Why HODL?
Because you shouldn't have to choose between your future wealth and your current needs. HODL: Keep your crypto, spend your cash

HODL is built as a multi-layered system that synchronizes state across different blockchains and a traditional banking backend.

1. The Smart Contract Layer (On-Chain)
   The foundation of the protocol is written in Solidity and deployed across two environments:

• The Spoke: This contract manages the locking and unlocking of user collateral (e.g., AVAX). It is designed to be "passive," waiting for authorized instructions from the CRE to release funds.
• The Hub: Contains the Diamond Standard Upgradable Proxy for Hub and ERC4626 Complaint Vault contracts. This is where the actual debt is recorded, and the stable assets (used for the fiat loan) are managed.
• Custom Price Oracles: We deployed custom price-feed contracts on the Spoke. Since some assets are only priced on the Hub, these contracts act as "mirrors" that accept signed updates from our sync service.

2. The Execution Layer (Chainlink CRE)
   We utilize the Chainlink Runtime Environment (CRE) as our secure, decentralized execution layer.

• The Trigger: When the off-chain orchestrator(Hodl Backend) validates a user's request, it sends a signed H-T-T-P request to the CRE.
• The Validation: The CRE verifies the cryptographic signature of the orchestrator to ensure the request is legitimate.
• The Action: The CRE then interacts directly with the Hub to execute the borrow or the Spoke to execute the unlock. This removes the risk of a "hot wallet" being compromised on a standard server.

3. The Orchestration Layer (Off-Chain "Brain")
   Built using Nestjs/TypeScript, the orchestrator acts as the glue for the entire system:

• Event Listeners: Uses WebSockets to monitor CollateralLocked events on Spoke and PaymentReceived webhooks from fiat gateways.
• State Machine: Manages the lifecycle of a loan, ensuring that we never trigger a borrow on the Hub until the collateral lock on the Spoke has reached 1-click finality.
• API Integrations: Connects to Fiat On/Off-ramp providers (e.g., Circle, Stripe, or custom banking APIs) to handle the movement of NGN/GHC/KSH/USD/EUR.

4. The Price/Liquidation Synchronization Services (Cron Jobs)
   To maintain protocol health, we built an automated Price-Sync and Liquidation Service:

• The Trigger: A scheduled cron job runs every 60 seconds (or upon significant price deviation).
• The Logic: It fetches the latest, high-accuracy price feeds from the Hub (using Chainlink Data Feeds).
• The Update: It then formats this data and pushes it to our custom price-feed contracts on the Spoke. This ensures that the Spoke-side vault always knows if a user's position is nearing liquidation.

5. Security & Trust Model

• Non-Custodial: Collateral is held in smart contracts, not in the orchestrator's wallet.
• Signature-Gated: Every cross-chain action requires a signature that is verified on-chain, preventing unauthorized movement of funds.
• Decoupled Logic: The "Decision Maker" (Orchestrator) is separate from the "Executioner" (CRE), adding a layer of defense-in-depth.

6. Frontend & User Interface

• NextJs/Tailwind CSS: A high-performance dashboard that abstracts all the technical complexity.
• Wallet Integration: We utilize Privy's MPC (Multi-Party Computation) wallets, allowing users to interact with smart contracts on Hub and Spoke using simple social logins.