# @caravan/wallets 中文文档
规范地址：https://npmcn.com/package/%40caravan/wallets/
版本：1\.0\.3
npm 元数据更新时间：2026-11-09T16:40:40.290Z
中文译文更新时间：2026-11-09T17:49:26.356Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40caravan/wallets
原文对照：https://npmcn.com/package/%40caravan/wallets/?lang=original
项目主页：https://github.com/caravan-bitcoin/caravan/
源码仓库：https://github.com/caravan-bitcoin/caravan
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：13.8 MB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：19 个
- 首次发布：2024-02-13T03:43:17.733Z
- 最新版本发布：2026-11-09T16:40:39.938Z
- 近 30 天下载量：2047（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 12 个）
## 中文简介
无链首都HWI图书馆
## 安装
```sh
npm install @caravan/wallets
```
也可以使用：`pnpm add @caravan/wallets`、`yarn add @caravan/wallets`、`bun add @caravan/wallets`
## README
# 无链键库公用事业
[](https://travis-ci.com/unchained-capital/@caravan/wallets)
该图书馆提供课程,用于整合来自 跟踪键盘进入 JavaScript 应用程序 :
- Trezor 硬件钱包( 型号: 1, T)
- 编目硬件钱包(型号:Nano)
- [隐士](https://github.com/unchained-capital/hermit)
完整的 API 文档可见于 [@ caravan/ 钱包](https://unchained-capital.github.io/@caravan/wallets)。 。 。 .
这间图书馆是建造和维护的 [无链](https://www.unchained.com/)。 。 。 .
## 安装
`@caravan/wallets` 作为国家防范机制一揽子计划分发。 把它加进你的 应用程序的依赖性 :
```
$ npm install --save @caravan/wallets
```
## 使用量
此库提供课程,旨在包罗交互 应用程序和密钥,例如 - 在 a 中导出公钥 某些从Trezor型号T.的BIP32路径.
类别设计为无国籍;所有键盘交互 状态(我们目前是和Trezor说话吗?)是打算被存储的 由调用应用程序.
这些课也会向合适的开发者提供消息 用于在用户界面中显示。 所有错误也会被过滤 到开发者处理他们认为合适的.
### API 密码
以下顶级功能是此API的切入点:
- `GetMetadata({keystore})` - 获取设备的元数据
- `ExportPublicKey({keystore, network, bip32Path})` - 导出一个 HD 公钥
- `ExportExtendedPublicKey({keystore, network, bip32Path})` - 输出一个扩展的HD公钥
- `SignMultisigTransaction({keystore, network, inputs, outputs, bip32Paths})` - 用一些多相码输入签名交易
- `ConfirmMultisigAddress({keystore, network, bip32Path, multisig})` - 确认一个多西格地址
不是每个密钥都由这个库支持 执行其中的每个 互动.
每一次互动都需要不同的论据。 见 [API 密码 文档](https://unchained-capital.github.io/@caravan/wallets) 详细情况.
### 应用程序
以下最小反应示例显示应用程序开发者如何 将使用 `ExportPublicKey` 此库的 API 函数导出 一个来自Trezor硬件钱包的公钥.
```javascript
// This is a React example but a similar
// pattern would work for other frameworks.
import React from "react";
import PropTypes from "prop-types";
// The `@caravan/bitcoin` library is used by `@caravan/wallets`.
import { MAINNET } from "@caravan/bitcoin";
import {
// This is the interaction we are implementing.
ExportPublicKey,
// These are the keystores we want to support. They both
// work identically as far as this minimal UI is concerned.
// Other keystores are supported but they would require a
// different UI.
TREZOR,
LEDGER,
// These are possible states our keystore could be in.
PENDING,
ACTIVE,
UNSUPPORTED,
} from "@caravan/wallets";
export class HardwareWalletPublicKeyImporter extends React.Component {
// For this example, the required arguments are
// passed into this component via `props`.
//
// A more realistic example would provide a UI for
// entering this or pull it from somewhere else.
static propTypes = {
network: PropTypes.string.isRequired,
bip32Path: PropTypes.string.isRequired,
keystore: PropTypes.string.isRequired,
};
// The interaction is stateless so can be instantiated
// on the fly as needed, with appropriate arguments.
interaction() {
const { keystore, network, bip32Path } = this.props;
return ExportPublicKey({ keystore, network, bip32Path });
}
constructor(props) {
super(props);
// Keystore state is kept in the React component
// and passed to the library.
this.state = {
keystoreState: this.interaction().isSupported() ? PENDING : UNSUPPORTED,
publicKey: "",
error: "",
};
this.importPublicKey = this.importPublicKey.bind(this);
}
render() {
const { keystoreState, publicKey, error } = this.state;
const { bip32Path } = this.props;
if (publicKey) {
return (
Public key for BIP32 path {bip32Path}:
{publicKey}
);
} else {
return (
Click here to import public key for BIP32 path {bip32Path}.
{this.renderMessages()}
{error &&
{error}
}
);
}
}
renderMessages() {
const { keystoreState } = this.state;
// Here we grab just the messages relevant for the
// current keystore state, but more complex filtering is possible...
const messages = this.interaction().messagesFor({ state: keystoreState });
return
{messages.map(this.renderMessage)}
;
}
renderMessage(message, i) {
// The `message` object will always have a `text` property
// but may have additional properties useful for display.
return