在区块链应用生态中，钱包作为连接用户与链上世界的核心入口，其集成便捷性直接决定了产品的用户留存与增长，TokenPocket（简称TP钱包）作为全球领先的多链去中心化钱包，支持数十条主流公链及超10万种链上资产，凭借开放的开发者生态，为DApp开发者、第三方应用服务商及链上项目方提供了三类核心对接场景，本文将结合实际对接经验，分场景详解每一步操作，帮你快速完成对接并规避常见问题。 核心是实现用户用TP钱包登录DApp、授权操作、发起链上交易，是区块链应用对接钱包的核心场景,步骤如下：
准备工作：获取TP钱包开发者资源
访问TP钱包官方开发者中心（https://developer.tokenpocket.pro/），根据你的开发端（Web/移动端）下载对应SDK或参考文档，重点熟悉EIP-1193协议（TP钱包兼容该标准，是Web端对接的核心），EIP-1193是以太坊提出的钱包与DApp交互的标准化协议，Web端对接时，TP钱包会在浏览器window对象挂载标准化的provider实例，这是实现钱包连接、授权、交易的核心入口。
Web端DApp对接实操
TP钱包连接后会在浏览器window对象挂载provider，可通过Web3库（如ethers.js）快速对接，示例代码（含错误处理）：
// 检查TP钱包是否安装
if (typeof window.ethereum !== 'undefined') {
const provider = new ethers.providers.Web3Provider(window.ethereum);
try {
// 请求用户授权连接钱包，返回账户列表
await provider.send("eth_requestAccounts", []);
const signer = provider.getSigner();
const userAddress = await signer.getAddress();
console.log("已连接TP钱包，用户地址：", userAddress);
} catch (error) {
// 处理用户拒绝授权的情况
if (error.code === 4001) {
alert("您已拒绝连接TP钱包，请点击「连接钱包」重新尝试！");
} else {
console.error("连接钱包失败：", error);
}
}
} else {
// 引导用户安装TP钱包，附上官方下载链接
alert("请先安装TP钱包，立即前往官网下载：https://www.tokenpocket.pro/");
}
发起交易时，调用provider.send("eth_sendTransaction", txParams)，TP钱包会弹出签名请求,用户确认后交易上链。
移动端DApp对接实操
利用TP钱包的Scheme协议（tp://）实现跳转：用户在移动端打开DApp后，点击「连接TP钱包」按钮，跳转至TP钱包授权页，授权后回调DApp获取用户链信息，示例跳转链接：
tp://dapp/connect?chainId=56&dappUrl=你的DApp域名（chainId=56对应BSC链）
注意：除Scheme协议外，TP钱包还支持iOS Universal Links和Android App Links，能提升跳转稳定性，避免Scheme被拦截,建议优先使用。
第三方应用集成TP钱包支付功能
如果你的应用需要支持TP钱包支付，可对接TP钱包开放API,步骤如下：
- 申请开发者权限：在TP钱包开发者中心提交资质申请，获取API密钥（用于API调用签名验证）；
- 生成支付订单：调用支付API，传入订单号、金额、链类型、收款地址、回调地址等参数,生成TP钱包支付链接；
- 监听交易状态：用户在TP钱包内完成支付后，TP钱包会向你的应用回调通知，需验证交易哈希的签名有效性,确认支付成功。
补充：生成支付订单时，需对参数进行签名（TP钱包要求API调用需签名验证），以下是Node.js示例：
const crypto = require('crypto'); const axios = require('axios');
async function createTPayOrder(orderId, amount, chainId, receiveAddress, callbackUrl) { const apiKey = "你的TP钱包API密钥"; const apiUrl = "https://api.tokenpocket.pro/v1/payment/create"; const params = { order_id: orderId, amount: amount, chain_id: chainId, receive_address: receiveAddress, callback_url: callbackUrl, }; // 生成签名 const sign = crypto.createHmac('sha256', apiKey).update(JSON.stringify(params)).digest('hex'); const response = await axios.post(apiUrl, { ...params, sign }); return response.data.payment_url; // 返回TP钱包支付链接 }
## 链上项目资产上架TP钱包（项目方需求）
若你发行了代币或NFT，想让用户在TP钱包中搜索添加，需完成资产上架对接：
1. **满足基础要求**：项目需合规，合约地址准确，合约代码开源且无安全漏洞，链支持TP钱包（如ETH、BSC、Polygon等）；
2. **提交申请**：通过TP钱包官网「资产上架」通道，提交项目资料（合约ABI、代币logo（建议256x256px PNG格式）、项目介绍等）；
3. **审核上线**：TP钱包团队审核通过后，资产会更新到钱包的资产列表，用户可搜索添加。
> 补充：审核周期通常为1-3个工作日，若审核不通过，TP钱包会告知具体原因，你修改后可重新提交；上架后建议在项目社区引导用户搜索添加，提升曝光。
## 对接核心注意事项
1. **安全优先**：所有私钥签名必须在TP钱包端完成，DApp/第三方应用仅发起请求，严禁存储用户私钥；
2. **链兼容性**：确认TP钱包支持的链ID，避免链不匹配导致交易失败（开发者中心可查链列表）；
3. **版本适配**：及时更新SDK，兼容TP钱包最新版本，旧版本可能存在功能缺失或安全隐患；
4. **用户体验**：对接时给用户明确提示（如「请在TP钱包中确认连接」），处理用户拒绝授权、网络错误等异常情况时，给出友好的操作指引。
TP钱包的开放生态为开发者和项目方提供了便捷的对接通道，无论你是要打造链上应用，还是让自己的资产触达更多用户，遵循官方文档流程即可顺利完成对接，遇到问题可通过TP钱包开发者社区或客服获取支持。相关阅读：
