# 使用 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 工程中的使用方法如下:

  1. 在 Podfile 文件中增加 pod 'TopWalletCore'

  2. 运行 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 工程中的使用方法如下:

  1. 运行 gradle install

  2. 在工程的 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"
    

    其中:

    • usernamepassword 用于从 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