Trust Developer
Search…
iOS Integration Guide
Wallet Core is available on the iOS platform, it comes with Swift bindings. In this guide we show how to use it.
A sample application is available at: https://github.com/trustwallet/wallet-core/tree/master/samples/osx .
Prerequisites
- Xcode toolchain
- Wallet Core library
Adding Library Dependency
An easy way to add Wallet Core dependency to an iOS project is through CocoaPods, like this (the exact version may change in the future):
1
pod 'TrustWalletCore'
Copied!
The dependency can be installed simply by
pod install:1
pod install
Copied!
SPM is also supported, download latest
Package.swift from GitHub Releases and put it in a local WalletCore folder.Add this line to the
dependencies parameter in your Package.swift:1
.package(name: "WalletCore", path: "../WalletCore"),
Copied!
Or add remote url +
master branch, it points to recent (not always latest) binary release.1
.package(name: "WalletCore", url: "https://github.com/trustwallet/wallet-core", .branchItem("master")),
Copied!
Then add libraries to target's
dependencies:1
.product(name: "WalletCore", package: "WalletCore"),
2
.product(name: "SwiftProtobuf", package: "WalletCore"),
Copied!
Code Examples
In the following sections we show code examples for some common funcions. Please refer to the Wallet Usage Guide for detailed explanations.
Accessing Wallet Core functionality requires one import statement:
1
import WalletCore
Copied!
Wallet Management
Creating or Importing a Multi-Coin HD Wallet
1
let wallet = HDWallet(strength: 128, passphrase: "")
Copied!
1
let wallet = HDWallet(mnemonic: "ripple scissors kick mammal hire column oak again sun offer wealth tomorrow wagon turn fatal", passphrase: "")!
Copied!
Account Address Derivation
Generating the Default Address for a Coin
1
let addressBTC = wallet.getAddressForCoin(coin: .bitcoin)
2
let addressETH = wallet.getAddressForCoin(coin: .ethereum)
3
let addressBNB = wallet.getAddressForCoin(coin: .binance)
Copied!
Generating an Address Using a Custom Derivation Path (Expert)
1
let key = wallet.getKey(derivationPath: "m/44\'/60\'/1\'/0/0") // m/44'/60'/1'/0/0
2
let address = CoinType.ethereum.deriveAddress(privateKey: key)
Copied!
Transaction Signing
In general, when creating a new blockchain transaction, a wallet has to:
- 1.Put together a transaction with relevant fields (source, target, amount, etc.)
- 2.Sign the transaction, using the account private key. This is done by Wallet Core.
- 3.Send to a node for broadcasting to the blockchain network.
Ethereum Transaction Signing
Code example to fill in signer input parameters, perform signing, and retrieve encoded result:
1
let signerInput = EthereumSigningInput.with {
2
$0.chainID = Data(hexString: "01")!
3
$0.gasPrice = Data(hexString: "d693a400")! // decimal 3600000000
4
$0.gasLimit = Data(hexString: "5208")! // decimal 21000
5
$0.toAddress = "0xC37054b3b48C3317082E7ba872d7753D13da4986"
6
$0.transaction = EthereumTransaction.with {
7
$0.transfer = EthereumTransaction.Transfer.with {
8
$0.amount = Data(hexString: "0348bca5a16000")!
9
}
10
}
11
$0.privateKey = wallet.getKeyForCoin(coin: .ethereum).data
12
}
13
let output: EthereumSigningOutput = AnySigner.sign(input: signerInput, coin: .ethereum)
14
print(" data: ", output.encoded.hexString)
Copied!
Last modified 3mo ago