@ 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.21zod ^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(退后补针尝试/捕获).
许可证
麻省理工学院.