Swift編寫的EOS開源框架SwiftyEOS

SwiftyEOS是一個用於與EOS交互的開源框架,用Swift編寫。可以在iOS和macOS上使用。

特點:

  • EOS密鑰對生成
  • 私鑰導入
  • 簽名哈希
  • 基本的RPC API(鏈/歷史)可查詢客戶端
  • 交易(EOS token 轉賬)
  • 幫助類處理iOS上的脫機錢包
  • 在iOS上加密/解密導入私鑰

如何使用它

  • 1.將LibrariesSources文件夾複製到項目中,不需要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上的設備上(離線)錢包鎖定和解鎖

我們添加locktimedUnlock函數到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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章