Trust Wallet Core is an open-source, cross-platform, mobile-focused library implementing low-level cryptographic wallet functionality for a high number of blockchains. It is a core part of the popular Trust Wallet, and some other projects. Most of the code is C++ with a set of strict C interfaces, and idiomatic interfaces for supported languages: Swift for iOS and Java (Kotlin) for Android.
For comprehensive documentation, see developer.trustwallet.com.
Security Audit reports can be found in the audit directory.
Wallet Core supports more than 130 blockchains: Bitcoin, Ethereum, BNB, Cosmos, Solana, and most major blockchain platforms. The full list is here.
For build instructions, see developer.trustwallet.com/wallet-core/building.
If you want to use wallet core in your project follow these instructions.
Android releases are hosted on GitHub packages, you need to add GitHub access token to install it. Please check out this installation guide or build.gradle from our android sample
Don't forget replacing the version in the code with latest:
We currently support Swift Package Manager and CocoaPods (will discontinue in the future).
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:
.package(name: "WalletCore", path: "../WalletCore"),Or add remote url + master branch, it points to recent (not always latest) binary release.
.package(name: "WalletCore", url: "https://github.com/trustwallet/wallet-core", .branchItem("master")),Then add libraries to target's dependencies:
.product(name: "WalletCore", package: "WalletCore"),
.product(name: "SwiftProtobuf", package: "WalletCore"),Add this line to your Podfile and run pod install:
pod 'TrustWalletCore'npm install @trustwallet/wallet-corePlease check out the Go integration sample.
Please check out the Kotlin Multiplatform sample
Projects using Trust Wallet Core. Add yours too!
Coinpaprika | crypto.com | Alice | Frontier | Tokenary | MemesWallet | xPortal | Slingshot
There are a few community-maintained projects that extend Wallet Core to some additional platforms and languages. Note this is not an endorsement, please do your own research before using them:
- Flutter binding https://github.com/weishirongzhen/flutter_trust_wallet_core
- Python binding https://github.com/phuang/wallet-core-python
- Wallet Core on Windows https://github.com/kaetemi/wallet-core-windows
The best way to submit feedback and report bugs related to WalletCore is to open a GitHub issue. If the bug is not related to WalletCore but to the TrustWallet app, please create a Customer Support ticket. If you want to contribute code please see Contributing. If you want to add support for a new blockchain also see Adding Support for a New Blockchain, make sure you have read the requirements section.
Thanks to all the people who contribute.
- Before opening a pull-request, bump WalletCore library version in the
./version.propertiesfile - [Optional] To update SwiftProtobuf library (only if necessary):
- Make sure that the new version of the SwiftProtobuf library is compatible with other consumers of a binary artifact (
grpc-swift,hedera-sdk-swift,SwiftBinanceChain,blockchain-sdk-swift, and so on) - Set a new version in the
./swift-protobuf-version.propertiesfile - Set a new version in the
./swift/Podfilefile
- Make sure that the new version of the SwiftProtobuf library is compatible with other consumers of a binary artifact (
The Wallet Core project is led and managed by Trust Wallet with a large contributor community and actively used in several projects. Our goal at Wallet Core is to give other wallets an easy way to add chain support.
Trust Wallet products leverage wallet core, however, they may or may not leverage all the capabilities, features, and assets available in wallet core due to their own product requirements.
Trust Wallet Core is available under the Apache 2.0 license. See the LICENSE file for more info.