@droplinked_inc/wallet-connection

中文文档
0.5.0发布于 2026/11/02MITTypeScriptES Module近 30 天下载 1962

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

中文使用文档
文档目录8 节
  1. 安装
  2. 快速启动 — EVM 登录( MetaMask)
  3. 快速启动 — 幽灵( Solana) 登录
  4. ERC-20 转让
  5. 自定义检出调用数据
  6. 警卫
  7. 状态
  8. 许可证

@ droplined inc/wallet- connection

替换 droplinked-wallet-connection。见 移民.md 用于交换路径.

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

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

安装

pnpm add @droplinked_inc/wallet-connection

类似运行时间 :

  • viem ^2.21
  • zod ^4.6.7

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

快速启动 — EVM 登录( MetaMask)

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) 登录

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

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

ERC-20 转让

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/ 地址获取是单个 供应链折中点.

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 共发布 5 个版本,首次发布于 2026/05/19;过去 12 个月发布了 5 个版本。

版本发布日期距今
0.5.0latest2026/11/0213 天前
0.4.12026/08/063 个月前
0.4.02026/05/215 个月前
0.3.02026/05/195 个月前
0.1.12026/05/195 个月前

关于 @droplinked_inc/wallet-connection 的常见问题

@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 和提交记录判断。