> For the complete documentation index, see [llms.txt](https://docs.primefi.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.primefi.xyz/v3-markets/fathom-v3.md).

# Fathom v3 (XDC)

The PrimeFi app header has a **v2 / v3** toggle. This page explains what **v3** means.

### TL;DR

* **v2 = PrimeFi.** Operated by Prime Numbers Labs on Base, HyperEVM and XDC. This is the protocol the rest of this documentation describes.
* **v3 = Fathom Lending.** A separate, third-party Aave v3 fork operated by **Fathom Protocol** on the XDC network. PrimeFi surfaces it inside our app as a convenience so users can access both markets from one interface, but **PrimeFi does not operate, custody or take responsibility for the v3 contracts**.

{% hint style="info" %}
For anything related to Fathom v3 (supply, borrow, collateral, health factor, liquidations, oracle questions, contract addresses, audits, support tickets), please use the official **Fathom Lending** documentation and support channels — not PrimeFi's.
{% endhint %}

### Fathom Lending — official resources

| What you need                        | Where to go                                                                                                                                                    |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Lending docs (root)**              | [docs.fathom.fi/lending](https://docs.fathom.fi/lending/)                                                                                                      |
| **XDC deployment & contract list**   | [docs.fathom.fi/lending/deployments/xdc-network](https://docs.fathom.fi/lending/deployments/xdc-network)                                                       |
| **How to supply / borrow / repay**   | [docs.fathom.fi/lending/user-guides/supply-borrow-repay-and-withdraw-asset](https://docs.fathom.fi/lending/user-guides/supply-borrow-repay-and-withdraw-asset) |
| **FXD stablecoin (related product)** | [docs.fathom.fi/fxd-stablecoin](https://docs.fathom.fi/fxd-stablecoin/)                                                                                        |
| **Fathom dApp**                      | [app.fathom.fi](https://app.fathom.fi/)                                                                                                                        |

### What's different between v2 and v3 inside the PrimeFi UI

| Feature                              | PrimeFi (v2)                                       | Fathom (v3)                                                |
| ------------------------------------ | -------------------------------------------------- | ---------------------------------------------------------- |
| Chains                               | Base, HyperEVM, XDC                                | XDC only                                                   |
| Underlying protocol                  | PrimeFi (Aave v2 fork + omnichain layer)           | Fathom Lending (Aave v3 fork)                              |
| Reserves                             | USDC, USDT, ETH, HYPE, WBTC, XDC, PSXDC, PRFI etc. | FXD, FTHM, WXDC and other Fathom reserves                  |
| pLP boost / PRFI emissions           | Yes (where chef is active — currently Base)        | **No** — Fathom has its own incentive model                |
| Cross-chain borrow (Stargate)        | Yes                                                | No                                                         |
| Auto-compound / vesting / locked pLP | Yes                                                | No                                                         |
| Prime Points eligibility             | Yes                                                | No                                                         |
| Smart contract operator              | Prime Numbers Labs                                 | Fathom Protocol                                            |
| Audits                               | See [Audits](/reference/audits.md)                 | Halborn Formal Verification (March 2026) — see Fathom docs |

### How to switch versions

Open the PrimeFi app, look at the header on the top right, and click the **v2 / v3** pill. The app will:

1. Update the active market and reserves list.
2. Switch your wallet to the appropriate chain (XDC for v3).
3. Hide PrimeFi-specific surfaces that don't apply to Fathom (pLP tabs, Prime Points, Flik, Prepaid Gas).

If you're on a PrimeFi-only page like `/plp` or `/prime-points` when you toggle to v3, the app will bounce you to the Dashboard.

### Contract addresses

* **PrimeFi v2 contracts** are documented under [Smart Contracts Addresses](/reference/smart-contracts-addresses.md).
* **Fathom v3 contracts** are listed in the [Fathom XDC deployment doc](/reference/smart-contracts-addresses/fathom-xdc-deployment-addresses.md), with the canonical source being [Fathom's own deployment page](https://docs.fathom.fi/lending/deployments/xdc-network).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primefi.xyz/v3-markets/fathom-v3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.