iOS应用程序如何调用以太坊智能合约

zhuxiangzhidi 2019-06-28

以太坊智能合约有各种各样的用例,但到目前为止,从你的iOS应用程序中调用它们非常困难。不过如果使用以太坊iOS开发套件EtherKit,这种情况会改善很多,你可以立即开始使用。在本教程结束时,你将能够调用其ABI(应用程序二进制接口)中定义的任何公共合约函数。

对于这个项目,我们将使用Xcode 10.0和ContractCodegen 0.1。我们还建议使用iOS MVVM项目模板,但为了使本教程简单,我们将使用正常的iOS项目结构。

首先,我们将创建一个新的iOS项目,并将其称为EthereumContracts。在这里下载我们的示例合约abi.json文件。下载成功后,将文件拖到Xcode项目中。你的Xcode项目现在应该如下所示:

iOS应用程序如何调用以太坊智能合约

安装ContractCodegen

在本教程的下一部分中,我们将从我们的以太坊iOS开发工具包下载ContractCodegen。为此,我将使用Cocoapods,它将自动下载必要的依赖项,但还有其他方法可用,在以太坊iOS开发套件Github中有描述。

在项目根目录中创建Podfile并插入以下代码:

platform :ios, '10.3'
project 'EthereumContracts'

inhibit_all_warnings!
use_frameworks!

target 'EthereumContracts' do
   pod 'ContractCodegen', '~> x.y.z'
end

打开终端并粘贴此命令:

pod install

当此命令完成时,关闭我们的EthereumContracts项目并在Finder中打开EthereumContracts.xcworkspace

很好!现在让我们生成Swift代码以与我们的智能合约进行交互。

生成Swift代码

首先,确保你在项目根目录中。如果你已经在了,我们可以非常简单地生成我们的Swift代码,只需使用以下命令:

Pods/ContractCodegen/ContractCodegen/bin/contractgen HelloContract EthereumContracts/abi.json -x EthereumContracts.xcodeproj -o EthereumContracts/GeneraredContracts

当命令询问你使用哪个选项时,非常简单,只使用一个,即第一个选项。

瞧,如果你收到“Code generation: ok”的消息,你已经为以太坊智能合约创建了第一个Swift代码。

你现在应该看到一组Generated Contracts和其中的两个文件:SharedContract.swiftHelloContract.swift。第一个帮助我们调用合约文件中定义的各个方法(在我们的例子中是HelloContract),并且对于所有生成的合约都是相同的。

有趣的那部分实际上是使用我们生成的代码来调用我们自己的合约。

创建密钥

导航到我们的ViewController并在文件顶部写:

import EtherKit

现在我们需要声明我们将使用哪个geth网络与智能合约进行通信。为了做到这一点,让我们在ViewController中定义一个属性:

let query = EtherQuery(URL(string: "https://rinkeby.infura.io/v3/9f1a1e0782ab40c8b39fe189615714d0")!, connectionMode: .http)

你可以使用任何所需的URL,你在字符串中看到的只是我们为你提供的URL。

然后我们将继续在viewDidLoad()函数中创建我们的密钥:

let walletStorage = KeychainStorageStrategy(identifier: "cz.ackee.etherkit.example")

HDKey.Private.create(
            with: MnemonicStorageStrategy(walletStorage),
            mnemonic: sentence,
            network: .main,
            path: [
                KeyPathNode(at: 44, hardened: true),
                KeyPathNode(at: 60, hardened: true),
                KeyPathNode(at: 0, hardened: true),
                KeyPathNode(at: 0),
                ]
        )

这很简单,对吧。

首先,我们创建助记句,这句话用于创建私钥和公钥以及地址。要创建你自己的,这是很显然的,你可以使用从此处下载的MyCrypto钱包示例。然后,HDKey.Private.create创建我们的主节点,从该节点派生所有其他公钥和私钥以及地址。

如你所见,编译器现在向我们显示此警告:

iOS应用程序如何调用以太坊智能合约

当我们查看HDKey.Private.create的函数时,我们可以看到它有一个完成参数Result<HDKey.Private, EtherKitError>) -> Void。这是因为创建我们的帐户是异步操作,因此我们需要在此功能完成后开始调用我们的智能合约。

为了使我们的代码简单易读,我们将创建一个新函数,我们将从中调用我们的合约:

private func testContract() {

}

现在我们从前面提到的完成中调用这个函数,如下所示:

HDKey.Private.create(
            with: MnemonicStorageStrategy(walletStorage),
            mnemonic: sentence,
            network: .main,
            path: [
                KeyPathNode(at: 44, hardened: true),
                KeyPathNode(at: 60, hardened: true),
                KeyPathNode(at: 0, hardened: true),
                KeyPathNode(at: 0),
                ]
        ) { [weak self] _ in
            self?.testContract()
        }

请耐心等待,我们越来越接近最终结果。

调用我们的合约

前往我们之前创建的testContract()函数。首先,我们需要使用关键路径找到存储在存储中的一个创建的密钥(下面的代码只是通过树到达特定位置):

let walletStorage = KeychainStorageStrategy(identifier: "cz.ackee.etherkit.example")
let key = HDKey.Private(walletStorage, network: .rinkeby, path: [
            KeyPathNode(at: 44, hardened: true),
            KeyPathNode(at: 60, hardened: true),
            KeyPathNode(at: 0, hardened: true),
            KeyPathNode(at: 1),
            ])

到代码的最后部分,我们差不多了!

let testContractAddress = try! Address(describing: "0xb8f016F3529b198b4a06574f3E9BDc04948ad852")
        query.helloContract(at: testContractAddress).testString(greetString: "Greetings!").send(using: key, amount: Wei(10)).startWithResult { result in
            switch result {
            case .success(let hash):
                print(hash)
                print("Test greetings succeeded!")
            case .failure(let error):
                print(error)
                print("Test greetings failed.")
            }
        }

好的,让我们看看这是做什么的。

testContractAddress指向我们创建的智能合约地址。要使用你自己的字符串替换它,请使用所需的十六进制代码。

其余的代码就是调用本身。我认为这是非常自我描述的,但我们将运行它,只是为了清楚。

我们找到所有的HelloContract函数,并声明我们要使用query.helloContract(at:testContractAddress)的合约地址。然后我们选择其中一个函数,在这个例子中我选择了函数testString,它将String作为输入(这个值将由我们的智能合约使用)。之后,我们通过send发送此数据。密钥值是我们之前在存储中找到的密钥值,amount声明了我们想要发送多少以太坊(正如你所看到的,我们为UInt256使用了typealias以获得更好的可读性)。然后send返回SignalProducer。如果你不知道那是什么意思,请在ReactiveSwift文档中阅读更多相关信息。

如果调用成功,则返回Hash类型。这只是我们发送的交易的哈希值。

让我们看看它是否有效!

尝试运行应用程序,如果你在输出中看到一个哈希和一个字符串“Test greetings succeeded!”,你刚刚使用Swift调用了你的第一个智能合约函数!

还有一件事应该说。智能功能有两种类型:应付款和非应付款。这种差异由生成的智能合约代码处理,因此你在代码中将在这两种类型之间看到的唯一区别是,当调用非应付函数时,将省略参数金额(因为不应发送以太坊)。很简单,是吧?

如果想查看整个项目,可以在此处下载

======================================================================

分享一些以太坊区块链相关的交互式在线编程实战教程:

  • java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
  • 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。

这里是原文iOS应用程序如何调用以太坊智能合约

相关推荐