@drift-labs/vaults-sdk

中文文档
0.11.1发布于 2026/03/30TypeScriptCommonJS近 30 天下载 2.6万

此 repo 具有简单的 CLI ,用于与金库交互( 从此运行) package.json:

中文使用文档
文档目录11 节
  1. 管理器命令
  2. 初始化新金库
  3. 更新默认参数
  4. 更新边距交易已启用
  5. 经理存款
  6. 管理器退出
  7. 应用利润份额
  8. 保存者命令
  9. 存入金库
  10. 退出金库
  11. 只查看命令

CLI 使用量

此 repo 具有简单的 CLI ,用于与金库交互( 从此运行) package.json:

这种 CLI 工具需要一个 RPC 节点和 keypair 来签名交易 。 您可以在 .env 文件,或使用 cli 标记( 如 --keypair 财务报告和审定财务报表 --url) (中文(简体) ).

需要的环境变量或标记 :

环境变量命令行旗说明
缩写:RPC URL- url (英语)要连接的 RPC 交易节点
关键部分键盘用于签名交易的 keypair( 文件或 base58) 路径 。 这也可能是分类账文件路径(例如:. usb://ledger/<wallet_id>?key=0/0(中文(简体) )
ENV 主题--env 数据“ devnet” 或“ mainnet”( 默认为“ minnet ”)

查看可用命令, 以 --help 在嵌入命令中获取每个命令可用的选项

yarn cli --help

管理器命令

以下命令由Vault Manageers管理. KEYPAIR_PATH 应该是经理的钥匙.

初始化新金库

进入一个新的金库。 这将初始化一个新的金库,并更新你(经理)作为代表,除非 --delegate 已指定.

$ yarn cli init-vault --help
Usage: cli init-vault [options]

Initialize a new vault

Options:
  -n, --name <string>               Name of the vault to create
  -i, --market-index <number>       Spot market index to accept for deposits (default 0 == USDC) (default: "0")
  -r, --redeem-period <number>      The period (in seconds) depositors must wait after requesting a withdraw (default: 7 days) (default: "604800")
  -x, --max-tokens <number>         The max number of spot marketIndex tokens the vault can accept (default 0 == unlimited) (default: "0")
  -m, --management-fee <percent>    The annualized management fee to charge depositors (default: "0")
  -s, --profit-share <percent>      The percentage of profits charged by manager (default: "0")
  -p, --permissioned                Provide this flag to make the vault permissioned, vault-depositors will need to be initialized by the manager
                                    (default: false)
  -a, --min-deposit-amount <number  The minimum token amount allowed to deposit (default: "0")
  -d, --delegate <publicKey>        The address to make the delegate of the vault
  -h, --help                        display help for command

更新默认参数

要更新金库中的段落 :

$ yarn cli manager-update-vault --help
Usage: cli manager-update-vault [options]

Update vault params for a manager

Options:
  --vault-address <address>         Address of the vault to update
  -r, --redeem-period <number>      The new redeem period (can only be lowered)
  -x, --max-tokens <number>         The max tokens the vault can accept
  -a, --min-deposit-amount <number  The minimum token amount allowed to deposit
  -m, --management-fee <percent>    The new management fee (can only be lowered)
  -s, --profit-share <percent>      The new profit share percentage (can only be lowered)
  -p, --permissioned <boolean>      Set the vault as permissioned (true) or open (false) (default: false)
  -h, --help                        display help for command

更新边距交易已启用

如果您想用金库的现货差额进行交易, 您必须允许差额交易 :

yarn cli manager-update-margin-trading-enabled --vault-address=<VAULT_ADDRESS> --enabled=<true|false>

经理存款

以经理身份存入金库(DEPOSIT_AMOUNT 在人精度方面,例如5比5 USDC:

yarn cli manager-deposit --vault-address=<VAULT_ADDRESS> --amount=<DEPOSIT_AMOUNT>

管理器退出

作为管理者从金库中撤回请求( E)SHARES 原始精确度:

yarn cli manager-request-withdraw --vault-address=<VAULT_ADDRESS> --amount=<SHARES>

赎回期过后,经理可以完成取出: 1

yarn cli manager-withdraw --vault-address=<VAULT_ADDRESS>

应用利润份额

管理器可以触发利润份额的计算( 这查看所有 VaultDepositors 符合利润份额条件的金库及其分批处理:

yarn cli apply-profit-share-all --vault-address=<VAULT_ADDRESS>

保存者命令

存入金库

允许的跳过

允许的金库需要 管理器 初始化 VaultDepositor 在存款人存款之前的账户.

初始化 a VaultDepositor 账户 AUTHORITY_TO_ALLOW_DEPOSIT 存款:

yarn cli init-vault-depositor --vault-address=<VAULT_ADDRESS> --deposit-authority=<AUTHORITY_TO_ALLOW_DEPOSIT>

无权限的断层

无人允许的金库允许任何人存款. 这个 deposit 指令将初始化 a VaultDepositor 如果不存在的话. DEPOSIT_AMOUNT (e) 保证金的精度(例如5美元兑5美元).

yarn cli deposit --vault-address=<VAULT_ADDRESS> --deposit-authority=<DEPOSIT_AUTHORITY> --amount=<DEPOSIT_AMOUNT>

或者,你可以通过在 VaultDepositor 直接地址:

yarn cli deposit --vault-depositor-address=<VAULT_DEPOSITOR_ADDRESS> --amount=<DEPOSIT_AMOUNT>

退出金库

请求退出金库 :

yarn cli request-withdraw --vault-address=<VAULT_ADDRESS> --authority=<AUTHORITY> --amount=<WITHDRAW_AMOUNT>

赎回期过后,储户可以完成提款: 1

yarn cli withdraw --vault-address=<VAULT_ADDRESS> --authority=<AUTHORITY>

只查看命令

打印当前状态 Vault数字 :

yarn cli view-vault --vault-address=<VAULT_ADDRESS>

打印当前状态 VaultDepositor数字 :

yarn cli view-vault-depositor --vault-depositor-address=<VAULT_DEPOSITOR_ADDRESS>

版本与发布记录

@drift-labs/vaults-sdk 共发布 1,170 个版本,首次发布于 2023/09/12;过去 12 个月发布了 50 个版本。

版本发布日期距今
0.11.1latest2026/03/307 个月前
0.10.82026/03/307 个月前
0.10.72026/03/277 个月前
0.10.62026/03/277 个月前
0.10.52026/03/267 个月前
0.10.42026/03/247 个月前

关于 @drift-labs/vaults-sdk 的常见问题

@drift-labs/vaults-sdk 是什么?

此 repo 具有简单的 CLI ,用于与金库交互( 从此运行) package.json:

如何安装 @drift-labs/vaults-sdk?

在项目目录运行 npm install @drift-labs/vaults-sdk,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@solana/web3.js(1.98.0)、@coral-xyz/anchor(0.29.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@drift-labs/vaults-sdk 支持 TypeScript 吗?

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

@drift-labs/vaults-sdk 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@drift-labs/vaults-sdk 需要什么版本的 Node.js?

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

@drift-labs/vaults-sdk 可以商用吗?

@drift-labs/vaults-sdk 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@drift-labs/vaults-sdk 的下载量有多少?

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

@drift-labs/vaults-sdk 还在维护吗?

最新版本 0.11.1 发布于 2026/03/30(7 个月前);至今共发布 1170 个版本,其中过去 12 个月发布了 50 个;首次发布于 2023/09/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。