# @deepliquidity/sdk 中文文档

规范地址：https://npmcn.com/package/%40deepliquidity/sdk/

版本：0\.1\.3
npm 元数据更新时间：2026-10-12T22:49:31.147Z
中文译文更新时间：2026-11-13T04:44:20.168Z
软件包许可：\(MIT AND Apache-2\.0\)

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

原始 npm 页面：https://www.npmjs.com/package/%40deepliquidity/sdk
原文对照：https://npmcn.com/package/%40deepliquidity/sdk/?lang=original
项目主页：https://deepliquidity.fun/
源码仓库：https://github.com/Deep-Liquidity/deep-sdk

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

- 包体积（解压后）：1.5 MB，97 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：5 个
- 首次发布：2026-10-08T20:33:36.065Z
- 最新版本发布：2026-10-12T22:49:30.966Z
- 近 30 天下载量：2304（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

Solana上的 DEEP 的 TypeScript 客户端:深曲线(发射板连接曲线)和 DepSwap (dep-amm) PDA, 指令构建器, 账户和事件解码器, 以及程序IDL.

## 安装

```sh
npm install @deepliquidity/sdk
```

也可以使用：`pnpm add @deepliquidity/sdk`、`yarn add @deepliquidity/sdk`、`bun add @deepliquidity/sdk`

## README

# @ 深层流动性/ sdk

[![DEEP — Launch deeper.](https://raw.githubusercontent.com/Deep-Liquidity/deep-sdk/main/assets/deep-og.png)](https://deepliquidity.fun/)

[![App](https://img.shields.io/badge/App-mainnet-00F0FF?style=for-the-badge&labelColor=0E141A)](https://deepliquidity.fun/) [![Integration guide](https://img.shields.io/badge/Guide-integrators-AEC6FF?style=for-the-badge&labelColor=0E141A)](https://github.com/Deep-Liquidity/deep-sdk/blob/main/docs/INTEGRATORS.md) [![API](https://img.shields.io/badge/API-OpenAPI%203.1-34F6A8?style=for-the-badge&labelColor=0E141A)](https://api.deepliquidity.fun/v1/openapi.json) [![X @LaunchOnDL](https://img.shields.io/badge/X-%40LaunchOnDL-DDE3EC?style=for-the-badge&logo=x&logoColor=white&labelColor=0E141A)](https://x.com/LaunchOnDL) [![Telegram @LaunchOnDL](https://img.shields.io/badge/Telegram-%40LaunchOnDL-34F6A8?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0E141A)](https://t.me/LaunchOnDL)

类型脚本客户端 **深处** 索拉纳问题: **深曲线** 发射板(捆接曲线)和 **深扫描** (深-阿姆常量产品 AMM,毕业的符号移动到). PDA 指令 构建器、账户和事件解码器,整数引号与程序完全一致 (原始内容存档于2018-10-25). Programs' Anchor IDL.

> **状态.** 程序运行在 **主网** 财务报告和审定财务报表 **脱网**,在同一程序编号. 本套件中没有任何内容会自行发送交易.

完整整合指南(账户布局包含抵消,事件,收费数学,出错代码, 计算预算,与pump.fun和Raydium CPMM的差异是: [融合指南](https://github.com/Deep-Liquidity/deep-sdk/blob/main/docs/INTEGRATORS.md) 财务报告和审定财务报表 “整合”部分 [深处文件](https://docs.deepliquidity.fun/docs)。 。 。 .

## 安装

```bash
npm install @deepliquidity/sdk @deepliquidity/curve-math @solana/web3.js
```

仅限无害环境管理,有类型脚本声明. 在节点 \\\\ 22 和浏览器捆绑中工作: 软件包 进口 `Buffer` 从 `buffer` 软件包,从不依赖全局 `Buffer`。 。 。 .

## 程序编号

```ts
import { DEEP_CURVE_PROGRAM_ID, DEEP_AMM_PROGRAM_ID } from "@deepliquidity/sdk";
// deep-curve 7czURwVLkQpcF1HVhhZU5GGzvPA8YniogZY1BhZHCDtA (mainnet and devnet)
// deep-amm   HCrCy6bzHhZ1b6bXwQAucEFkKXyzYMh3hgAR8UPrYSEP (mainnet and devnet)
```

## 快速启动: 引用并构建曲线购买

```ts
import { quoteBuyV1 } from "@deepliquidity/curve-math";
import { applySlippage, buyIx, curveFees, curvePda, decodeBondingCurve } from "@deepliquidity/sdk";
import { ComputeBudgetProgram, Connection, PublicKey, Transaction } from "@solana/web3.js";

const conn = new Connection("https://api.devnet.solana.com", "confirmed");
const mint = new PublicKey("<mint>");
const user = new PublicKey("<wallet>");

const curve = decodeBondingCurve((await conn.getAccountInfo(curvePda(mint)))!.data);
// the token's own terms: DEEP's buy and sell rate, its reward rate and reward model
const fees = curveFees(curve);
const q = quoteBuyV1(curve.state, 100_000_000n, fees); // 0.1 SOL in, fees included
const tx = new Transaction().add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 80_000 }),
  buyIx({
    user,
    mint,
    amount: 100_000_000n,
    minOut: applySlippage(q.tokensOut, 100), // 1% slippage floor
    deadline: BigInt(Math.floor(Date.now() / 1000) + 60),
  }),
);
// sign with the user's wallet and send
```

## 自己收费

DEEP没有链上推荐份额. 要收取应用费, 请在您的钱包中添加 SOL 传输 在与交易相同的交易中: `quoteBuyWithIntegratorFee` 编号 : `quoteSellWithIntegratorFee` 说明数额和细目, `integratorFeeIx` 构建传输( 0- 10%, 四舍五入) . 向用户显示收费; DEEP 自己的收费仍然适用. 见"融合指南": 自费".

## 快速启动: 在 DepSwap 池上互换

```ts
import {
  cpmmDirection,
  cpmmReserves,
  cpmmSwapBaseInputIx,
  decodeCpmmAmmConfig,
  decodeCpmmPoolState,
  DEEP_AMM_PROGRAM_ID,
  graduationPoolPda,
  NATIVE_MINT,
  quoteCpmmSwapBaseInput,
} from "@deepliquidity/sdk";

const poolId = graduationPoolPda(mint); // the pool a token graduated into
const pool = decodeCpmmPoolState((await conn.getAccountInfo(poolId))!.data);
const amm = decodeCpmmAmmConfig((await conn.getAccountInfo(pool.ammConfig))!.data);
const bal = async (k: PublicKey) => BigInt((await conn.getTokenAccountBalance(k)).value.amount);
const [r0, r1] = cpmmReserves(pool, await bal(pool.token0Vault), await bal(pool.token1Vault));
const { zeroForOne, creatorFeeOnInput } = cpmmDirection(pool, NATIVE_MINT);
const q = quoteCpmmSwapBaseInput({
  amountIn: 10_000_000n,
  inputReserve: zeroForOne ? r0 : r1,
  outputReserve: zeroForOne ? r1 : r0,
  config: amm,
  creatorFeeEnabled: pool.enableCreatorFee,
  creatorFeeOnInput,
});
const ix = cpmmSwapBaseInputIx({
  programId: DEEP_AMM_PROGRAM_ID,
  payer: user,
  poolId,
  pool,
  inputMint: NATIVE_MINT,
  amountIn: 10_000_000n,
  minimumAmountOut: (q.amountOut * 99n) / 100n,
}); // wrap SOL into the user's WSOL account first; see examples/deepswap-swap.ts
```

## 活动

```ts
import { parseEventsFromLogs, parseFeeEventsFromLogs, parseAmmSwapEvents } from "@deepliquidity/sdk";

conn.onLogs(DEEP_CURVE_PROGRAM_ID, (l) => {
  for (const { event } of parseEventsFromLogs(l.logs)) console.log(event.name, event);
});
conn.onLogs(DEEP_AMM_PROGRAM_ID, (l) => console.log(parseAmmSwapEvents(l.logs)));
```

`parseEventsFromLogs` 只接受 `Program data:` 程序本身发出的行( 它 轨迹) 引用堆栈),所以另一个程序不能 spoof DEEP 事件.

## 身份证

```ts
import curveIdl from "@deepliquidity/sdk/idl/deep_curve.json" with { type: "json" };
import ammIdl from "@deepliquidity/sdk/idl/deep_amm.json" with { type: "json" };
```

Anchor IDL spect 0.0.0. (英语). SDK的解码器是用字段对这些文件进行测试的,以及 与实时devnet账户相关的文件.

## 实例

`examples/` 建立实际交易和 **模拟** 他们将永居其中`sigVerify: false`: 没有签名或寄出 没有读过密钥页 过 `--payer <public key>` 选择 他们的帐户是模拟的.

| 文件 | 它会做什么 |
| --- | --- |
| `read-curve.ts` | 配置、曲线状态、价格、进度、完成、毕业池 |
| `watch-launches.ts` | `onLogs` - 启动、交易、毕业、互换 |
| `quote-and-buy.ts` | 引用 + `buy`,检查贸易事件与引用 |
| `sell.ts` | 引用 + `sell` |
| `deepswap-swap.ts` | 深扫描 `swap_base_input` (购买或往返) |
| `deepswap-liquidity.ts` | `deposit` 财务报告和审定财务报表 `withdraw` 精确的 LP 数学 |
| `claim-creator-fees.ts` | 曲线 `claim_creator_fees` 和 DepSwap 创建器- 收费收藏 |

```bash
npx tsx examples/read-curve.ts --rpc https://api.devnet.solana.com
```

## 许可证

`MIT AND Apache-2.0`: cp- swap 端口 `NOTICE` 为 Apache-2.0 (`LICENSE-APACHE`, (中文(简体) ), 其他一切都是麻省理工学院的`LICENSE`) (中文(简体) ).

## 链接

[网站和应用程序](https://deepliquidity.fun/) • 妇女 [文档](https://docs.deepliquidity.fun/docs) • 妇女 [融合指南](https://github.com/Deep-Liquidity/deep-sdk/blob/main/docs/INTEGRATORS.md) • 妇女 [GitHub 图像](https://github.com/Deep-Liquidity/deep-sdk) • 妇女 [博客](https://blog.deepliquidity.fun/) • 妇女 [状态](https://status.deepliquidity.fun/) • 妇女 [页:1](https://x.com/LaunchOnDL) • 妇女 [电报](https://t.me/LaunchOnDL)

## 常见问题

### @deepliquidity/sdk 是什么？

Solana上的 DEEP 的 TypeScript 客户端:深曲线\(发射板连接曲线\)和 DepSwap \(dep-amm\) PDA, 指令构建器, 账户和事件解码器, 以及程序IDL\.

### 如何安装 @deepliquidity/sdk？

在项目目录运行 npm install @deepliquidity/sdk，或使用 pnpm add / yarn add / bun add。

### @deepliquidity/sdk 支持 TypeScript 吗？

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

### @deepliquidity/sdk 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @deepliquidity/sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @deepliquidity/sdk 可以商用吗？

@deepliquidity/sdk 使用 \(MIT AND Apache-2\.0\) 许可。声明的许可为 \(MIT AND Apache-2\.0\)，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @deepliquidity/sdk 的下载量有多少？

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

### @deepliquidity/sdk 还在维护吗？

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