# @debridge-finance/dln-client 中文文档 规范地址：https://npmcn.com/package/%40debridge-finance/dln-client/ 版本：17\.6\.2 npm 元数据更新时间：2026-10-06T19:08:30.477Z 中文译文更新时间：2026-11-11T18:48:27.238Z 软件包许可：GPL-3\.0-only 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40debridge-finance/dln-client 原文对照：https://npmcn.com/package/%40debridge-finance/dln-client/?lang=original 项目主页：https://debridge.finance/ 源码仓库：https://github.com/debridge-finance/dln-ts-client ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.4 MB，506 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：11 个 - peer 依赖：@solana/web3\.js ^1\.89\.1，@solana/buffer-layout ^4\.0\.0，@solana/buffer-layout-utils ^0\.2\.0，@debridge-finance/solana-utils ^5\.0\.0 - 首次发布：2022-11-23T19:59:31.418Z - 最新版本发布：2024-11-14T13:02:12.437Z - 近 30 天下载量：14494（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：304（近 12 个月 0 个） ## 中文简介 一个客户SDK,促进互动 deSwap 流动性网络(DLN)关于索拉纳和EVM区块链的合同 ## 安装 ```sh npm install @debridge-finance/dln-client ``` 也可以使用：`pnpm add @debridge-finance/dln-client`、`yarn add @debridge-finance/dln-client`、`bun add @debridge-finance/dln-client` ## README # `dln-client` 由德布里奇编辑 一个客户SDK,促进互动 deSwap 流动性网络(DLN)关于索拉纳和EVM区块链的合同. DLN是建在顶部 [deBridge 跨链通讯协议](https://debridge.finance/)。 。 。 . ## 关于计算执行费和承担费用的说明 考虑看看 [https://github.com/debridge-finance/dln-ts-client/pull/63 互联网档案馆的存檔,存档日期2013-12-12](https://github.com/debridge-finance/dln-ts-client/pull/63) 定义 # DLN 订货和开支 主流量 : ``` Order creation -> Fulfill / Cancel -> Send unlock -> Claim ``` 订单创建后, 您需要发送完成, 解锁交易 . 而且,如果命令有调用数据,你需要存储并执行. ## 索拉纳呼叫EVM 交易顺序 : 1. 顺序创建( Solana) 2. 完成( EVM) / 取消( EVM) 3. 发送解锁( EVM) 4. 索赔(索拉纳) 5. 执行呼叫数据(索拉纳) ### 顺序创建 交易 [实例](https://solana.fm/tx/26HVerXPXa8Dzn88oB1DqQeZystYZe1DiDDAJjWsr91j16pQJr4dE5waqYZ7EfvbM4eHm1j9fq8JgRmAGa13azgk)。 。 。 . 这笔交易包括下列费用和收益: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 创建命令与诺斯 | 租金 | 给定命令状态 | 页:1 | \-2115840号 | | | | 租金 | 给定命令 | 165 (韩语) | \-2039280 (英语) | | | | 租金 | 无主 | 16个 | \-1002240号 | 当 dln 非ce 账户不存在时添加 | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ### 索赔 债权交易在完成/取消后进行,并在源链中发送解锁交易. 交易 [实例](https://solana.fm/tx/39gAkX9bdk3cuxPMNgPAZPjCAS6RL2jA8hxLqr6HvqdXKxkZbZ2Qv3KT7qbATfHHnffZAm8LxKJNL7JshtCNjYmm)。 。 。 . 这笔交易包括下列费用和收益: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 索赔 | 租金 | 请求钱包 | 165 (韩语) | \-2039280 (英语) | 应在索赔后归还 | | | 租金 | 提交日期 | 第194条 | \- 2241120 (英语) | 应在索赔后归还 | | | 租金返还 | 实数 | | +5909040 (韩语) | | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ### 执行调用数据 在调用数据执行之前, 您需要完成命令 . 交易 [实例](https://solana.fm/tx/31JV7K6CXDoMNzVH644pDYvTTRBqwUHQqgpiFnZyR3QGcs5337PWpfNRpdXDbzZ4sKkgYWyYgzDFprZCkvVqkbAw)。 。 。 . 这笔交易包括下列费用和收益: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 执行外部呼叫 | 租金返还 | 外部 调用 | | +13906080 时间轴 | | | | 租金返还 | 外部呼叫网络 | | +1085760 (中文(简体) ) | | | | 租金返还 | 提交日期 钱包 | | +2039280 时间轴 | | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ## EVM呼叫索拉纳 交易顺序 : 1. 顺序创建( EVM) 2. 完成(索拉纳)/取消(索拉纳) 3. 发送解锁( Solana) 4. 索赔(EVM) 5. 执行调用数据( EVM) ### 实现 创建包含顺序状态的链上数据存储账户和调用数据的额外账户. 交易 [实例](https://solana.fm/tx/4jWoYcHe1JrCDXWe2rBNygUE3EaZGP5AodkHeqT6Nmrq89V18ikRnbZ7Hyf5Gb7K1NsVWWXhdvF3XMcJLRnwqWLf)。 。 。 . 这笔交易包括下列费用和收益: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 执行命令 | 租金 | 顺序状态 | 106 (韩语) | \- 1628640 (英语) | | | 初始化 ExtcallMeta | 租金 | 外部呼叫网络 | 200个 | \-2282880号 | 如果命令包含调用数据则创建 | | | 租金 | 执行Wallet | 165 (韩语) | \-2039280 (英语) | 如果索拉纳上的顺序符是 SPL并存在调用数据, 则添加 | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ### 发送解锁 在目的地链中申请订单. 交易 [实例](https://solana.fm/tx/4b4WiMX4a7JYVETdeyNXvtNVKbTcD6xnX2th6yLapR15a5f2NsRNnkgBweAqgD1G5bEHaJ43tMCQz41aD9kKXWhz)。 。 。 . 这笔交易包括下列费用和收益: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 准备发送 | 转让 | 从 | | | \= 外部CallStorage + 外部CallMeta + 脱桥固定费(转入脱桥费) | | | 转让 | 从Wallet 发送 | | | \= 执行费 | | 发送解锁/ 发送批次解锁 | 租金 | 非总汇 | 16个 | \-1002240号 | 当非账户不存在时添加 | | | 租金 | 外部 调用 | 第76条 | \-1419840号 | 如果批次解锁,则为108 + (32 \* n),其中n - 批次订购量 | | | 租金 | 外部呼叫网络 | 第28条 | \-1085760 (英语) | | | | 礼宾费 | | | \- 30000000(千分数) | 转至受益方(收益值,hanoi值为1000) | | | 执行费 | | | \-57823号 | 取决于从赠与链, 转让到shoingWallet | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ### 取消 如果您想要取消命令, 拨打而不是完成 . 交易 [实例](https://solana.fm/tx/ATNhEfmzvDB3eXY34h8MZXJ1VwXw3tASHYqbyxDow5i7uJviK8NparEmFM48XXV8Uget1qapwdkJJ23RnJn62LR)。 。 。 . 这项交易包括下列费用: | 指令 | 支出类型 | 账户名称 | 字节( 对于 aloc) | 灯塔 | 注释 | | --- | --- | --- | --- | --- | --- | | 取消顺序 | 租金 | 顺序状态 | 106 (韩语) | \- 1628640 (英语) | | | 准备发送 | 转让 | 从 | | | \= 外部CallStorage + 外部CallMeta + 脱桥固定费(转入脱桥费) | | | 转让 | 从Wallet 发送 | | | \= 执行费 | | 发送解锁 | 租金 | 非总汇 | 16个 | \-1002240号 | 当非账户不存在时添加 | | | 租金 | 外部 调用 | 第76条 | \-1419840号 | | | | 租金 | 外部呼叫网络 | 第28条 | \-1085760 (英语) | | | | 礼宾费 | | | \- 30000000(千分数) | 转至受益方(收益值,hanoi值为1000) | | | 执行费 | | | \-364728号 | 取决于从赠与链, 转让到shoingWallet | | | tx 费用 | | | \-五千块 | | | | 优先权费 | | | | | ## 常见问题 ### @debridge-finance/dln-client 是什么？ 一个客户SDK,促进互动 deSwap 流动性网络\(DLN\)关于索拉纳和EVM区块链的合同 ### 如何安装 @debridge-finance/dln-client？ 在项目目录运行 npm install @debridge-finance/dln-client，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@solana/web3\.js（^1\.89\.1）、@solana/buffer-layout（^4\.0\.0）、@solana/buffer-layout-utils（^0\.2\.0）、@debridge-finance/solana-utils（^5\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @debridge-finance/dln-client 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @debridge-finance/dln-client 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @debridge-finance/dln-client 可以商用吗？ @debridge-finance/dln-client 使用 GPL-3\.0-only 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。 ### @debridge-finance/dln-client 的下载量有多少？ 根据 npm 官方下载统计，@debridge-finance/dln-client 在 2026/10/12 – 2026/11/10 这 30 天内被下载 14,494 次，日均约 483 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @debridge-finance/dln-client 还在维护吗？ 最新版本 17\.6\.2 发布于 2024/11/14（2 年前）；至今共发布 304 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/11/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。