> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lfg.rich/llms.txt
> Use this file to discover all available pages before exploring further.

# 开发者概览

> 围绕 LFG.RICH V5 构建集成。

本节面向围绕 LFG.RICH 构建看板、交易工具、机器人、提醒、分析和钱包集成的开发者。

<CardGroup cols={2}>
  <Card title="公共 API" icon="server" href="/zh/developers/api">
    读取代币列表、详情、交易、K 线、投资组合数据和公共协议配置。
  </Card>

  <Card title="合约参考" icon="braces" href="/zh/developers/contracts">
    使用 Factory、Hook、Router、Token、Referral 和 Treasury 的 V5 地址与可读 ABI 字符串数组。
  </Card>

  <Card title="协议示例" icon="terminal" href="/zh/developers/protocol-examples">
    查看 Ethers、Viem、Web3.js 和 Python Web3.py 的 V5 示例。
  </Card>

  <Card title="API 示例" icon="code" href="/zh/developers/examples">
    复制现有公共 REST 端点的实用 fetch 示例。
  </Card>
</CardGroup>

## V5 是当前集成目标

新的集成应使用 V5 合约。V3 只用于旧代币兼容，应视为弃用版本。

## 核心集成流程

代币交互不要硬编码旧 Factory、Hook 或 PoolKey。请按以下流程：

<Steps>
  <Step title="尽量读取代币的 Factory 和 Hook">
    V5 集成不应该假设所有代币都使用旧的合约路径。
  </Step>

  <Step title="从正确的 Factory 解析 PoolKey">
    优先使用 `getPoolKey(token)`，不要猜测 pool 字段。
  </Step>

  <Step title="用 PoolKey 调用 Swap Router">
    买入和卖出执行通过官方 Swap Router 完成。
  </Step>

  <Step title="用 poolId 调用 Hook">
    预估、借贷、还款和价格读取都使用该代币的 Hook 和 `poolId`。
  </Step>
</Steps>

## 价格精度

V5 价格类数值按 `1e22` 缩放：

* `getEffectivePrice(poolId)`
* `floorPrice`
* `allTimeHighPrice`
* V5 买卖事件中的 `newPrice`

显示每个代币的 BNB 价格：

```ts theme={null}
const priceBnb = Number(priceScaled) / 1e22;
```

不要把 V5 价格当作 `1e18` 价格，否则集成显示的价格会高出 10,000 倍。

## 合约

| 合约         | 地址                                           |
| ---------- | -------------------------------------------- |
| Factory    | `0x429a7ef0129649a97bb3f1e961dd56d9bd4ac01f` |
| Hook       | `0xc18e6e1926113cdcf53f3ec1a89d3eb84cc6a888` |
| SwapRouter | `0x4018abd5d24ee48c642e7e518a8aef03b59ec150` |
| OTOInvite  | `0x162e11887f6788ac9625a980e68044bee7f9d746` |
| Treasury   | `0xdb5b8aa5cecf7a6fe1812fb2ccc37723076b19d9` |