Web3.swift is a Swift library for signing transactions and interacting with Smart Contracts in the Ethereum Network.
It allows you to connect to a geth or parity Ethereum node (like Infura) to send transactions and read values from Smart Contracts without the need of writing your own implementations of the protocols.
Web3.swift supports iOS, macOS, tvOS and watchOS with CocoaPods and Carthage and macOS and Linux with Swift Package Manager.
Check the usage below or look through the repositories tests.
There are already some Web3 library out there written in Swift. We know their strengths and weaknesses and for our use case they just didn't work.
Web3.swift was built with modularity, portability, speed and efficiency in mind.
Ok, thank you for the buzzwords. But what does this actually mean?
Web3.swift was built to be modular. If you install/use the basic Web3 subspec/SPM product, you get access to the most basic
functions like transaction signing and interacting with an http rpc server.
If you want to add support for IPC rpc or something else, you can simple create a library which depends on Web3 and implements
this exact functionality. More about that later.
If you want to use PromiseKit extensions for the web3 calls, you can either use the
provided PromiseKit subspec/SPM product or create your own.
If you want to conveniently parse JSON ABIs for Ethereum Smart Contracts, you can use the provided ABI Parsing subspec/SPM product.
Finally, if you want to add functionality to Web3.swift which is not provided yet, you don't have to wait until it gets merged
and released in a version bump. You can simple extend/update functionality within you own app as our APIs are made to be very open
for changes.
For example, if you want to add a web3 method which is not provided yet by Web3.swift (we will only support Infura supported methods),
you only have to add some 3 lines of code
(depending on the input and output parameters of the method). Adding IPC rpc support would be only implementing a protocol and answering
requests.
Like you can see, everything is possible with Web3.swift.
One of the main reasons we started working on this project is because we wanted to use it with CocoaPods and Swift Package Manager on
different platforms.
Because of that, Web3.swift is available through CocoaPods, Carthage
and Swift Package Manager on iOS, macOS, tvOS, watchOS (with CocoaPods and Carthage)
and macOS and Linux (with SPM).
Note: For SPM we are only testing macOS and officially supported Linux distributions (currently Ubuntu 14.04 and 16.04) but it should be compatible with all little endian systems which are able to compile the Swift Compiler, Foundation and Glibc.
We try to make this library as fast as possible while trying to provide an API which increases your development workflow such that you can focus on building great DAPPS instead of worrying about implementation details.
All our APIs are thread safe and designed to be used in highly concurrent applications.
Web3 is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod 'Web3'If you want to use the PromiseKit extensions, also add the following line
to your Podfile:
pod 'Web3/PromiseKit'If you want to use the ContractABI module, which makes it easy to interact with smart contracts by calling
their functions and parsing their outputs automatically, also add the following line to your Podfile:
pod 'Web3/ContractABI'Web3 is compatible with Carthage, a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To install it, simply add the following line to your Cartfile:
github "Boilertalk/Web3.swift"
You will also have to install the dependencies, which can be found in our Cartfile.
Web3 is compatible with Swift Package Manager v4 (Swift 4 and above). Simply add it to the dependencies in your Package.swift.
dependencies: [
.package(url: "https://github.com/Boilertalk/Web3.swift.git", from: "0.4.0")
]And then add it to your target dependencies:
targets: [
.target(
name: "MyProject",
dependencies: ["Web3", "Web3PromiseKit", "Web3ContractABI"]),
.testTarget(
name: "MyProjectTests",
dependencies: ["MyProject"])
]Note:
Web3PromiseKitandWeb3ContractABIare optional and you only have to put them into your target dependencies (and later import them) if you want to use them.
After the installation you can import Web3 in your .swift files.
import Web3With Web3.swift you can use an Ethereum node on a server to communicate with Ethereum.
You can send signed transactions, read contract data, call contract functions and much more.
The base class for all available methods is Web3. You can, for example, instantiate it with
an http provider:
let web3 = Web3(rpcURL: "https://mainnet.infura.io/<your_infura_id>")All web3_ methods are available directly from the Web3 struct. The net_ methods are
available under the net struct in the web3 struct. The eth_ methods are available
under the eth struct in the web3 struct.
Please see the examples below
Note: For the examples to work you need to import Web3 and PromiseKit first
Returns the current client version.
Parameters
none
Returns
String - The current client version
firstly {
web3.clientVersion()
}.done { version in
print(version)
}.catch { error in
print("Error")
}Returns the current network id.
Parameters
none
Returns
String - The current network id
firstly {
web3.net.version()
}.done { version in
print(version)
}.catch { error in
print("Error")
}Returns number of peers currently connected to the client.
Parameters
none
Returns
EthereumQuantity - BigInt of the number of connected peers.
firstly {
web3.net.peerCount()
}.done { ethereumQuantity in
print(ethereumQuantity.quantity)
}.catch { error in
print("Error")
}Creates new message call transaction or a contract creation for signed transactions.
Parameters
EthereumTransaction: The signed transaction
Returns
EthereumData, 32 Bytes - The transaction hash, or the zero hash if the transaction is not yet available
To send some ETH you first need to get the current transaction count of the sender (nonce), create the transaction, sign it and then send it.
let privateKey = try! EthereumPrivateKey(hexPrivateKey: "0xa26da69ed1df3ba4bb2a231d506b711eace012f1bd2571dfbfff9650b03375af")
firstly {
web3.eth.getTransactionCount(address: privateKey.address, block: .latest)
}.then { nonce in
let tx = try EthereumTransaction(
nonce: nonce,
gasPrice: EthereumQuantity(quantity: 21.gwei),
gas: 21000,
to: EthereumAddress(hex: "0xC0866A1a0ed41e1aa75c932cA3c55fad847fd90D", eip55: true),
value: EthereumQuantity(quantity: 1.eth)
)
return try tx.sign(with: privateKey, chainId: 1).promise
}.then { tx in
web3.eth.sendRawTransaction(transaction: tx)
}.done { hash in
print(hash)
}.catch { error in
print(error)
}firstly {
web3.eth.getBlockTransactionCountByNumber(block: .block(5397389))
}.done { count in
print(count) // 88
}.catch { error in
print(error)
}For more examples either read through our test cases, the Web3 struct or the official Ethereum JSON RPC documentation.
We are providing an optional module for interaction with smart contracts. To use it you have to either add the corresponding subspec to your Podfile (for Cococapods) or you have to add Web3ContractABI to your target dependencies in your Podfile (for SPM). Make sure you check out the installation instructions first.
We are providing two different options to create contract abi interfaces in Swift. Either you define your functions and events manually (or use one of our provided interfaces like ERC20 or ERC721). Or you parse them from the JSON ABI representation just like in web3.js.
Static contracts are classes implementing StaticContract. They provide a set of functions and events they want to use from the original smart contract. Check out our provided static contracts as a starting point (ERC20 or ERC721).
Our static ERC20 interface is called GenericERC20Contract, the ERC721 contract is called GenericERC721Contract. Both can be subclassed to add more functions for custom contracts.
With those StaticContract types you can create and use your contract like in the following example (We are using PromiseKit again in our examples).
let web3 = Web3(rpcURL: "https://mainnet.infura.io/<your_infura_id>")
let contractAddress = try EthereumAddress(hex: "0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0", eip55: true)
let contract = web3.eth.Contract(type: GenericERC20Contract.self, address: contractAddress)
// Get balance of some address
firstly {
try contract.balanceOf(address: EthereumAddress(hex: "0x3edB3b95DDe29580FFC04b46A68a31dD46106a4a", eip55: true)).call()
}.done { outputs in
print(outputs["_balance"] as? BigUInt)
}.catch { error in
print(error)
}
// Send some tokens to another address (locally signing the transaction)
let myPrivateKey = try EthereumPrivateKey(hexPrivateKey: "...")
firstly {
web3.eth.getTransactionCount(address: myPrivateKey.address, block: .latest)
}.then { nonce in
try contract.transfer(to: EthereumAddress(hex: "0x3edB3b95DDe29580FFC04b46A68a31dD46106a4a", eip55: true), value: 100000).createTransaction(
nonce: nonce,
from: myPrivateKey.address,
value: 0,
gas: 100000,
gasPrice: EthereumQuantity(quantity: 21.gwei)
)!.sign(with: myPrivateKey).promise
}.then { tx in
web3.eth.sendRawTransaction(transaction: tx)
}.done { txHash in
print(txHash)
}.catch { error in
print(error)
}
// Send some tokens to another address (signing will be done by the node)
let myAddress = try EthereumAddress(hex: "0x1f04ef7263804fafb839f0d04e2b5a6a1a57dc60", eip55: true)
firstly {
web3.eth.getTransactionCount(address: myAddress, block: .latest)
}.then { nonce in
try contract.transfer(to: EthereumAddress(hex: "0x3edB3b95DDe29580FFC04b46A68a31dD46106a4a", eip55: true), value: 100000).send(
nonce: nonce,
from: myAddress,
value: 0,
gas: 150000,
gasPrice: EthereumQuantity(quantity: 21.gwei)
)
}.done { txHash in
print(txHash)
}.catch { error in
print(error)
}By creating your own interfaces, you can interact with any smart contract!
If you only have access to the JSON ABI of a smart contract or you don't want to create a static template, you can use our dynamic contract api to parse the json string into a usable contract during runtime. See the example below.
let web3 = Web3(rpcURL: "https://mainnet.infura.io/<your_infura_id>")
let contractAddress = try EthereumAddress(hex: "0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0", eip55: true)
let contractJsonABI = "<your contract ABI as a JSON string>".data(using: .utf8)!
// You can optionally pass an abiKey param if the actual abi is nested and not the top level element of the json
let contract = try web3.eth.Contract(json: contractJsonABI, abiKey: nil, address: contractAddress)
print(contract.methods.count)
// Get balance of some address
firstly {
try contract["balanceOf"]!(EthereumAddress(hex: "0x3edB3b95DDe29580FFC04b46A68a31dD46106a4a", eip55: true)).call()
}.done { outputs in
print(outputs["_balance"] as? BigUInt)
}.catch { error in
print(error)
}
// Send some tokens to another address (locally signing the transaction)
let myPrivateKey = try EthereumPrivateKey(hexPrivateKey: "...")
guard let transaction = contract["transfer"]?(EthereumAddress.testAddress, BigUInt(100000)).createTransaction(nonce: 0, from: myPrivateKey.address, value: 0, gas: 150000, gasPrice: EthereumQuantity(quantity: 21.gwei)) else {
return
}
let signedTx = try transaction.sign(with: myPrivateKey)
firstly {
web3.eth.sendRawTransaction(transaction: signedTx)
}.done { txHash in
print(txHash)
}.catch { error in
print(error)
}Using this API you can interact with any smart contract in the Ethereum Network!
For more examples, including contract creation (constructor calling) check out our tests.
Until we reach version 1.0.0 our API is subject to breaking changes between minor version jumps. This is to make sure we can focus on providing the best implementation while we are in heavy development instead of trying to maintain something which is deprecated.
That being said, we will try to minimize breaking changes. Most certainly there won't be many.
The awesome guys at Boilertalk ⚗️
...and even more awesome members from the community 💜
Check out the contributors list for a complete list.
Web3 is available under the MIT license. See the LICENSE file for more info.