With the version 0.3.0 API should be less volatile. All public functions should return a Result<>[https://github.com/antitypical/Result] instead of nil or throwing.
Example is not yet updated for 0.3.0, please use tests as an example for your code.
- Swift implementation of web3.js functionality ⚡
- Interaction with remote node via JSON RPC 💭
- Smart-contract ABI parsing 📖
- ABI deconding
- RLP encoding
- Interactions (read/write to Smart contracts) 🔄
- Local keystore management (geth compatible)
- Literally following the standarts:
- Private key and transaction were created directly on the iOS device and sent directly to Infura node
- Native API
- Security (as cool as hard wallet! Right out-of-the-box! :box: )
- Not every JSON RPC function is exposed yet, priority is gives to ones required for mobile devices
- Functionality was focused on serializing and signing transactions locally on device to send raw transaction to Ethereum network
- Requirements for password input on every transactions are indeed a design decision. Interface designers can save user passwords given user's consent
- Public function for private key export is exposed for user convenience, but marked as UNSAFE_ :) Normal workflow takes care of EIP155 compatibility and proper clearing of private key data from memory
https://rinkeby.etherscan.io/tx/0xc6eca60ecac004a1501a4323a10edb7fa4cd1a0896675f6b51704c84dedad056
Transaction
Nonce: 35
Gas price: 5000000000
Gas limit: 21000
To: 0x6394b37Cf80A7358b38068f0CA4760ad49983a1B
Value: 1000000000000000
Data: 0x
v: 43
r: 73059897783840535708732471549376620878882680550447969052675399628060606060727
s: 12280625377431973240236065453692843538037349746280474092545114784968542260859
Intrinsic chainID: Optional(4)
Infered chainID: Optional(4)
sender: Optional(web3swift.EthereumAddress(_address: "0x855adf524273c14b7260a188af0ae30e82e91959"))
["id": 1514485925, "result": 0xc6eca60ecac004a1501a4323a10edb7fa4cd1a0896675f6b51704c84dedad056, "jsonrpc": 2.0]
On Rinkeby TXid = 0xc6eca60ecac004a1501a4323a10edb7fa4cd1a0896675f6b51704c84dedad056
You can try it by yourself by running the example project:
- Clone the repo
cd Example/web3swiftExample- run
pod installfrom theExample/web3swiftExampledirectory. open ./web3swiftExample.xcworkspace
Web3swift requires Swift 4.0 and iOS 9.0 or macOS 10.13 although we recommend to use the latest iOS and MacOS versions for your own safety.
web3swift is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'web3swift', git: 'https://github.com/Vaultie/web3swift.git'- Send transactions, call functions of smart-contracts, estimate gas costs
- Serialize and deserialize transactions and results to native Swift types
- Convenience functions for chain state: block number, gas price
- Check transaction results and get receipt
- Parse event logs for transaction
- Manage user's private keys through encrypted keystore abstractions
- Full reference
web3jsfunctionality - Light Ethereum subprotocol (LES) integration
- Gnosis team and their library Bivrost-swift for inspiration for the ABI decoding approach
- Trust iOS Wallet for collaboration and discussion for initial idea
For the latest version, please check develop branch. Changes from this branch will be merged into the master branch at some point.
- If you want to contribute, submit a pull request against a development
developbranch. - If you found a bug, open an issue.
- If you have a feature request, open an issue.
When using this pod references to this repo, Bankex and Bankex Foundation are appreciated.
Alex Vlasov, @shamatar, [email protected]
Petr Korolev, @skywinder, [email protected]
web3swift is available under the Apache License 2.0 license. See the LICENSE file for more info.