# @droplinked\_inc/wallet-connection 中文文档

规范地址：https://npmcn.com/package/%40droplinked_inc/wallet-connection/

版本：0\.5\.0
npm 元数据更新时间：2026-11-02T13:35:47.597Z
中文译文更新时间：2026-11-16T02:01:10.160Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40droplinked_inc/wallet-connection
原文对照：https://npmcn.com/package/%40droplinked_inc/wallet-connection/?lang=original
项目主页：https://github.com/droplinked/droplink-packages/tree/main/packages/wallet-connection#readme
源码仓库：https://github.com/droplinked/droplink-packages

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

- 包体积（解压后）：219 kB，57 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：3 个
- 首次发布：2026-05-19T05:25:43.283Z
- 最新版本发布：2026-11-02T13:35:47.391Z
- 近 30 天下载量：1962（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

钱包连接适配器用于滴接(MetaMask, Coinbase, WaletConnect, Phantom). 已硬化的恢复/ 重写原始的 @ droplink/ wallet- connection .

## 安装

```sh
npm install @droplinked_inc/wallet-connection
```

也可以使用：`pnpm add @droplinked_inc/wallet-connection`、`yarn add @droplinked_inc/wallet-connection`、`bun add @droplinked_inc/wallet-connection`

## README

# @ droplined inc/wallet- connection

> 替换 `droplinked-wallet-connection`。见 [移民.md](https://npmcn.com/package/docs/MIGRATION.md) 用于交换路径.

硬化钱包连接原始投放链接: MetaMask, Coinbase 钱包和幻影 EIP-712 键入数据登录带链 + 来源 + 无约束性, Zod- 验证 RPC 边界, 无 `any`没有远程 ABI 获取.

此套件是原作的干净重写 `@droplinked/wallet-connection@1.0.1` (敌方: 演员). 见 `THREAT_MODEL.md` 本套方案针对威胁情景 减轻影响和减轻影响.

## 安装

```sh
pnpm add @droplinked_inc/wallet-connection
```

类似运行时间 :

-   `viem ^2.21`
-   `zod ^4.6.7`

两者都是直接的依赖;你不需要自己安装.

## 快速启动 — EVM 登录( MetaMask)

```ts
import {
  EvmConnector,
  Chain,
  Network,
  verifyLoginSignature,
  buildSession,
  saveSession,
} from '@droplinked_inc/wallet-connection';

const connector = new EvmConnector({
  chain: Chain.ETH,
  network: Network.MAINNET,
  origin: window.location.origin,
});

const { address, signature } = await connector.walletLogin();

// Verify (server-side or client-side):
await verifyLoginSignature({
  payload: /* the LoginPayload returned by your server */,
  signature,
  expectedAddress: address,
  expectedChainId: 1,
  expectedOrigin: window.location.origin,
});

saveSession(
  buildSession({
    address,
    chainId: 1,
    origin: window.location.origin,
    signature,
    ttlSeconds: 60 * 60 * 8, // 8 hours
  }),
);
```

## 快速启动 — 幽灵( Solana) 登录

```ts
import { PhantomConnector, Network } from '@droplinked_inc/wallet-connection';

const connector = new PhantomConnector(Network.MAINNET);
const { address, signature } = await connector.walletLogin();
```

## ERC-20 转让

```ts
const txHash = await connector.paymentWithToken(
  receiverAddress,
  1000000n, // amount as bigint
  tokenAddress,
);
```

注:这是直接印发的 `transfer`。这里有 **没有** `approve` API 密码 暴露的 -- -- 排水者式的津贴流动无法达到 软件包。 见 `THREAT_MODEL.md` 第5节.

## 自定义检出调用数据

退出链接 v3 退出合同通过 `submitRawTransaction()` 由滴入链接生成的调用数据 检查出API。 遗留下来的ABI编码器被故意删除 (见 `THREAT_MODEL.md` §T7 — 远程 ABI/ 地址获取是单个 供应链折中点.

```ts
const txHash = await connector.submitRawTransaction({
  to: checkoutContractAddress,
  data: serverProducedCalldata,
  value: totalPriceWei,
  gasLimit: 3_000_000n,
});
```

## 警卫

-   所有RPC的答复都经过了Zod验证. 返回错误的钱包 数据导致输入错误,而不是沉默的腐败.
-   登录签名为EIP-712,以链条+来源+非ce+键入 时间.
-   `selectMetaMaskProvider()` 财务报告和审定财务报表 `selectCoinbaseProvider()` 要求 钱包本身的自我识别旗。 没有退路 伞 `window.ethereum`。 。 。 .
-   非单数使用量 `crypto.getRandomValues()` (256位数). 如果网络加密是 无法拨打电话——没有 `Math.random()` 倒计时.
-   会话默认为 `sessionStorage` (已关闭标签),不是 `localStorage`。它们带有明确的 `expiresAt` 那个 `loadSession()` 强制执行.

见 `THREAT_MODEL.md` (原始内容存档于2013-10-01) (中文(中国大陆) ). free delta vs. 原文 v1.0.1 and 测试每个情景.

## 状态

初步恢复+硬化. 原有的公开 API 名称保留下来 在可行的情况下;下列修改是有意的,并在 `THREAT_MODEL.md`数字 :

-   链条/网络/ChanWallet现在是字符串值的enum(是暗指的) 以数字表示).
-   `getNetworkProvider(chain, network, address, wallet)` 现在 `getNetworkProvider({ chain, network, address, wallet, ... })`。 。 。 .
-   `EVMProvider` 现在 `EvmConnector`· ; `SolanaProvider` 现在 `PhantomConnector` (建筑师签名相应更改).
-   `EVMPayment` (自由函数)被删除; 使用 `EvmConnector.submitRawTransaction()`。 。 。 .
-   错误类别现在扩展 `Error` (退后补针尝试/捕获).

## 许可证

麻省理工学院.

## 常见问题

### @droplinked\_inc/wallet-connection 是什么？

钱包连接适配器用于滴接\(MetaMask, Coinbase, WaletConnect, Phantom\)\. 已硬化的恢复/ 重写原始的 @ droplink/ wallet- connection \.

### 如何安装 @droplinked\_inc/wallet-connection？

在项目目录运行 npm install @droplinked\_inc/wallet-connection，或使用 pnpm add / yarn add / bun add。

### @droplinked\_inc/wallet-connection 支持 TypeScript 吗？

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

### @droplinked\_inc/wallet-connection 支持 ESM 还是 CommonJS？

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

### @droplinked\_inc/wallet-connection 需要什么版本的 Node\.js？

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

### @droplinked\_inc/wallet-connection 可以商用吗？

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

### @droplinked\_inc/wallet-connection 的下载量有多少？

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

### @droplinked\_inc/wallet-connection 还在维护吗？

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

