SwiftyEOS是一个用于与EOS交互的开源框架,用Swift编写。可以在iOS和macOS上使用。
特点:
- EOS密钥对生成
- 私钥导入
- 签名哈希
- 基本的RPC API(链/历史)可查询客户端
- 交易(EOS token 转账)
- 帮助类处理iOS上的脱机钱包
- 在iOS上加密/解密导入私钥
如何使用它
- 1.将
Libraries
和Sources
文件夹复制到项目中,不需要main.swift
。 - 2.如果不是针对iOS平台,请删除
Sources/Utils/iOS
。 - 3.将
Libraries/include
添加到Header搜索路径中。 - 4.将
Libraries/include/Bridging-Header.h
设置为Objective-C Bridging Header。如果你有自己的bridging header,请复制该文件中的所有导入内容并粘贴到你自己的文件中。 - 5.编译然后等结果
密钥对生成
SwiftyEOS现在支持secp256k1密钥对。
secp256r1密钥对生成有bug但我无法弄清楚原因。从cleos
创建的单元测试创建密钥--r1
不会通过。你可能不会将secp256r1视为一个选项,因为cleos wallet
命令也无法导入这些键。
生成随机密钥对:
let (pk, pub) = generateRandomKeyPair(enclave: .Secp256k1)
很容易对吧?
print("private key: \(pk!.wif())")
print("public key : \(pub!.wif())")
// private key: PVT_K1_5HxrYTdZX89zodtJhTzCk87MfNZAkiBRfFvSX8kacYjtwaDpTkL
// public key : PUB_K1_4yDYdmcVcXxAxeNsUWRG7x9FKQE4HbJZdzgZFv1AYxk6oSVcLd
PVT_K1_
和PUB_K1_
前缀是标准密钥表示的一部分。但是EOS系统和SwiftyEOS也支持旧方式:
print("private key: \(pk!.rawPrivateKey())")
print("public key : \(pub!.rawPublicKey())")
// private key: 5HxrYTdZX89zodtJhTzCk87MfNZAkiBRfFvSX8kacYjtwaDpTkL
// public key : EOS4yDYdmcVcXxAxeNsUWRG7x9FKQE4HbJZdzgZFv1AYxk6oSVcLd
导入现有密钥:
let importedPk = try PrivateKey(keyString: "5HxrYTdZX89zodtJhTzCk87MfNZAkiBRfFvSX8kacYjtwaDpTkL")
let importedPub = PublicKey(privateKey: importedPk!)
带分隔符和前缀:
let importedPk = try PrivateKey(keyString: "PVT_K1_5HxrYTdZX89zodtJhTzCk87MfNZAkiBRfFvSX8kacYjtwaDpTkL")
let importedPub = PublicKey(privateKey: importedPk!)
RPC API
EOSRPC.sharedInstance.chainInfo { (chainInfo, error) in
if error == nil {
print("Success: \(chainInfo!)")
} else {
print("Error: \(error!.localizedDescription)")
}
}
目前我们有一些基本的RPC端点,你可以在Sources/SwiftyEOS/Network
找到它。
iOS的密钥存储
我们有SEWallet.swift
iOS版离线钱包管理助手。
SEWallet.swift
可以方便地保存AES加密的密钥信息到文件系统。默认位置是应用程序的沙盒。
目前还不支持多个钱包管理。
在iOS上创建新钱包
在Objective-C中:
[SEKeystoreService.sharedInstance newAccountWithPasscode:passcode succeed:^(SELocalAccount *account) {
} failed:^(NSError *error) {
}];
检索已保存的钱包
[SELocalAccount currentAccount];
如果没有保存钱包,它将返回零。
交易
交易行为目前尚未完全支持,但你仍可以尝试使用main.swift
中的示例代码。
整个功能完成后,将提供相关文件。
- 货币转账(2018.08.15)
- 提交一般交易(2018.08.16)
- iOS上的设备上(离线)钱包锁定和解锁(2018.08.17)
- 押注/取消押注/净值(2018.08.28)
- 买/卖ram(2018.08.28)
- 创建账户(2018.10)
- 用params列表推送交易(2018.11.05)
- 使用助记符创建/导入密钥对
货币转账
var transfer = Transfer()
transfer.from = "agoodaccount"
transfer.to = "gq3dinztgage"
transfer.quantity = "1.0000 EOS"
transfer.memo = "eureka"
Currency.transferCurrency(transfer: transfer, code: "eosio.token", privateKey: importedPk!, completion: { (result, error) in
if error != nil {
if error is RPCErrorResponse {
print("\((error as! RPCErrorResponse).errorDescription())")
} else {
print("other error: \(String(describing: error?.localizedDescription))")
}
} else {
print("done.")
}
})
提交一般交易
swift:
let account = "raoji"
let asset = "1.0000 EPRA"
let data = "{\"hey\": {\"account\":\"" + account + "\", \"quantity\":\"" + asset + "\"}}"
let abi = try! AbiJson(code: "prabox1", action: "withdraw", json: data)
TransactionUtil.pushTransaction(abi: abi, account: account, privateKey: importedPk!, completion: { (result, error) in
if error != nil {
if (error! as NSError).code == RPCErrorResponse.ErrorCode {
print("\(((error! as NSError).userInfo[RPCErrorResponse.ErrorKey] as! RPCErrorResponse).errorDescription())")
} else {
print("other error: \(String(describing: error?.localizedDescription))")
}
} else {
print("Ok. Txid: \(result!.transactionId)")
}
})
Objective-C:
AbiJson *your_abi;
[TransactionUtil pushTransactionWithAbi:your_abi
account:@"your_account"
pkString:@"your_private_key"
completion:^(TransactionResult *result, NSError *error) {
}];
iOS上的设备上(离线)钱包锁定和解锁
我们添加lock
和timedUnlock
函数到SELocalAccount
。
Cpu/net/ram 操作
ResourceUtil.swift
文件包括ResourceUtil
类,包括下面几个方法:
stakeResource
unstakeResource
buyRam
sellRam
Stake resource:
ResourceUtil.stakeResource(account: "raoji", net: 1.0, cpu: 1.0, pkString: "5HsaHvRCPrjU3yhapB5rLRyuKHuFTsziidA13Uw6WnQTeJAG3t4", completion: { (result, error) in
})
助记符
建一个新的密钥对:
let (pk, pub, mn) = generateRandomKeyPair(enclave: .Secp256k1)
导入现有助记符:
let (pk, mn) = PrivateKey(enclave: .Secp256k1, mnemonicString: "your words here")
我们在SEWallet.swift
中有密钥管理的iOS助手API和助记符。现在可以使用SEKeystoreService
类创建和导入助记符(如果你自己存储,则可以使用SEKeystore更深入的API):
SEKeystoreService.sharedInstance.newAccountAndMnemonic(passcode: "your pass here", succeed: { (account, mnemonic) in
}) { (error) in
}
我们正在为所有顶级API使用NSObject
固有类,因此在不提供额外桥接文件的情况下调用Objective-C也是一样的。
在SEWallet.swift
文件中也有iOS的帮助方法。
谢谢。
======================================================================
分享一些以太坊、EOS、比特币等区块链相关的交互式在线编程实战教程:
- EOS教程,本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。
- java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
- python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
- php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
- 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
- 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
- C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
- java比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Java代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Java工程师不可多得的比特币开发学习课程。
- php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。
- tendermint区块链开发详解,本课程适合希望使用tendermint进行区块链开发的工程师,课程内容即包括tendermint应用开发模型中的核心概念,例如ABCI接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是go语言工程师快速入门区块链开发的最佳选择。
汇智网原创翻译,转载请标明出处。这里是原文Swift编写的EOS开源框架SwiftyEOS
来源:oschina
链接:https://my.oschina.net/u/2275217/blog/2962062