# @calp-pro/dex-db 中文文档

规范地址：https://npmcn.com/package/%40calp-pro/dex-db/

版本：3\.1\.1
npm 元数据更新时间：2026-08-23T07:22:41.681Z
中文译文更新时间：2026-11-09T00:16:05.113Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40calp-pro/dex-db
原文对照：https://npmcn.com/package/%40calp-pro/dex-db/?lang=original
项目主页：https://github.com/calp-pro/dex_db#readme
源码仓库：https://github.com/calp-pro/dex_db

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：19.2 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-03-14T15:53:59.553Z
- 最新版本发布：2026-08-23T07:22:41.361Z
- 近 30 天下载量：2641（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

用于处理关系对/ 池地址到 sorder0 和 sorder1 地址的数据库

## 安装

```sh
npm install @calp-pro/dex-db
```

也可以使用：`pnpm add @calp-pro/dex-db`、`yarn add @calp-pro/dex-db`、`bun add @calp-pro/dex-db`

## README

# ![calp.pro icon](https://cdn.jsdelivr.net/npm/uniswap-v2-loader@5.0.1/logo-light.svg)  DEX 数据库  [![Coverage](https://coveralls.io/repos/github/calp-pro/dex_db/badge.svg?branch=main)](https://coveralls.io/github/calp-pro/dex_db)

用于分散交换器的数据库.  
每个对子和令牌地址索引为数字( S) .  
礛 [工厂](https://github.com/Uniswap/v2-core/blob/master/contracts/UniswapV2Factory.sol) 资料可分为:

-   `0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc` - 有指数 **无**
-   `0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48` - 有指数 **页:1**
-   `0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2` - 有指数 **Y**

```
data_structure[N    ] = X
data_structure[N + 1] = Y
```

地点 **无**, (中文(简体) ), **页:1**, (中文(简体) ), **Y** 为: `uint24`。 。 。 .

示例  
`[0, 4, 0, 1, 5, 3, ...]`  
其中:  

-   `0, 4`
    -   在索引中的数组中是第一和第二个元素 `0`, (中文(简体) ), `1` (比例指数) `0`(中文(简体) )
    -   `0` 指数 `token0` 双对 `0`
    -   `4` 指数 `token1` 双对 `0`
-   `0, 1`
    -   是在位置上的下一对符号 `2`, (中文(简体) ), `3` (比例指数) `1`(中文(简体) )
    -   `0` 指数 `token0` 双对 `1` (同样的标志可以在不同对)
    -   `1` 指数 `token1` 双对 `1`
-   `5, 3`
    -   是在位置上的下一对符号 `4`, (中文(简体) ), `5` (比例指数) `2`(中文(简体) )
    -   `5` 指数 `token0` 双对 `2`
    -   `3` 指数 `token1` 双对 `2`

## 安装

```bash
npm i --save @calp-pro/dex-db
```

## 使用

```js
import dex_db from '@calp-pro/dex-db'

const db = dex_db(
    [
        ['0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc', '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'],
        ['0x12ede161c702d1494612d19f05992f43aa6a26fb', '0x06af07097c9eeb7fd685c692751d5c66db49c215', '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'],
        ['0xa478c2975ab1ea89e8196811f51a7b7ade33eb11', '0x6b175474e89094c44da98b954eedeac495271d0f', '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'],
        ['0x07f068ca326a469fc1d87d85d448990c8cba7df9', '0x408e41876cccdc0f92210600ef50372656052a38', '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'],
        ['0xae461ca67b15dc8dc81ce7615e0320da1a9ab8d5', '0x6b175474e89094c44da98b954eedeac495271d0f', '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'],
        ['0xce407cd7b95b39d3b4d53065e711e713dd5c5999', '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', '0xfa3e941d1f6b7b10ed84a0c211bfa8aee907965e']
    ]
)

const pairs = dex_db.find_pairs_with_token('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'/*USDC*/)

//pairs[0] == '0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc'/*WETH/USDC*/)
//pairs[1] == '0x07f068ca326a469fc1d87d85d448990c8cba7df9'/*REN/USDC*/)
//pairs[2] == '0xae461ca67b15dc8dc81ce7615e0320da1a9ab8d5'/*DAI/USDC*/)
```

## API 密码

-   `find_pairs_with_token`
-   `find_pairs_with_tokens`
-   `get_pair_tokens`
-   `index`
-   `index_save`
-   `save`
-   `load`
-   `sort`

### `sort`

三角洲5的压缩率只有10%,对于10mb的令牌/集合地址来说并不多. 发送到9mb或10mb的等待时间与用户等待的时间相同. 装入应在背景中进行,每个装入的块都应经过处理. 数据顺序是第一位的 对数据进行排序有助于提供快速最重要的数据,而较少的重要数据留待以后使用.

默认的代号排序是通过对代号的数量进行. WETH是顶级对接符- 应先出现在排序结果上 . 默认的对子排序是通过总对子s sorder0/1 已经完成的.

## 常见问题

### @calp-pro/dex-db 是什么？

用于处理关系对/ 池地址到 sorder0 和 sorder1 地址的数据库

### 如何安装 @calp-pro/dex-db？

在项目目录运行 npm install @calp-pro/dex-db，或使用 pnpm add / yarn add / bun add。

### @calp-pro/dex-db 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @calp-pro/dex-db 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @calp-pro/dex-db 可以商用吗？

@calp-pro/dex-db 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @calp-pro/dex-db 的下载量有多少？

根据 npm 官方下载统计，@calp-pro/dex-db 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,641 次，日均约 88 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @calp-pro/dex-db 还在维护吗？

最新版本 3\.1\.1 发布于 2026/08/23（2 个月前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。