# 使用 TOP Wallet
TOP Wallet 库 fork 自 Trust Wallet 库,主要面向第三方钱包,用于生成/管理地址、生成交易结构体并签名功能。目前已经支持大部分主流币(点此查看 (opens new window))。官方代码地址:https://github.com/trustwallet/wallet-core。
本文档介绍如何使用 TOP wallet 库。
地址相关操作和交易结构体生成签名功能,已经在 iOS 和 Android 客户端单元实现。且已支持转账,兑票,取消兑票,兑换 gas,取消兑换 gas 等功能。
# iOS
目前仅支持 Xcode 下的 CocoaPods,所以在 iOS 中需通过 pod 方式使用 Top Wallet 库。
在 iOS 工程中的使用方法如下:
在 Podfile 文件中增加
pod 'TopWalletCore'
。运行
pod install
安装 pod 库。
如果安装失败,可通过以下方式排查问题:
- 运行
pod repo update
更新 pod 库。 - 运行
pod search TopWalletCore
搜索 TOP Wallet 库。
代码示例:
iOS 示例工程:https://github.com/hench-ye/wallet-core/tree/hench1/samples/osx/cocoapods
Swift 代码示例:https://github.com/hench-ye/wallet-core/blob/hench1/swift/Tests/Blockchains/TopTests.swift
# Android
Android 库提交到 GitHub 进行统一管理。
在 Android 工程中的使用方法如下:
运行
gradle install
。在工程的
app/build.gradle
文件中添加如下代码:maven { name = "GitHubPackages" url = uri("https://maven.pkg.github.com/hench-ye/wallet-core") credentials { /**Create github.properties in root project folder file with gpr.usr=GITHUB_USER_ID & gpr.key =PERSONAL_ACCESS_TOKEN**/ username = "hench-ye" password = "*************************" } } implementation "com.topwallet:wallet-core:$walletcore_version"
其中:
username
与password
用于从 GitHub 下载库。password
是通过 https://github.com/settings/tokens 生成的 Personal access token。$walletcore_version
为最新版本号,当前为 2.6.16,可通过 https://github.com/hench-ye/wallet-core/releases 查看。
代码示例:
- Android 示例工程:https://github.com/hench-ye/wallet-core/tree/hench1/samples/android
- Kotlin 代码示例:https://github.com/hench-ye/wallet-core/blob/hench1/android/app/src/androidTest/java/com/trustwallet/core/app/blockchains/top/TestTop.kt