目錄
準備三步曲
本地環(huán)境
賬戶
基礎文件生成
開始三步曲
結構編寫
邏輯.cpp
abi編寫
成功三步曲
智能合約文件生成
智能合約發(fā)布
智能合約使用
準備三步曲
這一節(jié)我們要講的是智能合約前期的準備工作。
本地環(huán)境
本地環(huán)境部署這個就不在多說本論壇已經(jīng)有很多的教程,這里列出鏈接:
在MacOS和Ubuntu上搭建EOS V2.0 ---爬過好多坑后的總結
除了部署本地環(huán)境以外,你還需要以下額外的操作:
cdbuild make install
編譯完以后就可以使用eos的插件了:eosc/eos-wallet/eoscpp/eosd
eosd: 用來開啟本地測試網(wǎng)絡。
eosc: eos的命令行接口。
eoscpp: eos智能合約相關的功能,生成模版智能合約等等。
eos-wallet: eos錢包功能。
賬戶
新建一個或多個賬戶,部署智能合約,測試智能合約都能用得到。
本論壇有關賬戶的創(chuàng)建教程已經(jīng)很完善,例如:
基礎文件生成
利用eoscpp可以快速的生成模版智能合約:
eoscpp -n
執(zhí)行完以后會在本地生成一個contract name的文件夾,里面包含智能合約需要的基礎文件。執(zhí)行截圖如下:
會生成.cpp/.abi/.hpp三個必要的文件,文件中包含生成智能合約的基本內容。
開始三步曲
準備工作完成以后,開始寫智能合約。
結構編寫
/** *? @file *? @copyright definedineos/LICENSE.txt */#include #include using namespace eosio; //使用eosio命名空間namespace eos_fans{? ? ? ? //數(shù)據(jù)庫? ? struct PACKED(love) {? ? ? ? account_name? ? lover; //被表白的人? ? ? ? account_name? ? author; //表白的人? ? ? ? uint8_ttimes; //表白次數(shù)? ? };? ? //對誰表白action? ? struct say {? ? ? ? account_name? ? lover; //被表白的人? ? ? ? account_name? ? author; //表白的人? ? };//table 參數(shù)依次為:該表所在的默認帳戶名范圍,代碼帳戶名稱具有對此表的寫入權限,表名,存儲在每一行中的數(shù)據(jù)類型, 記錄中存儲的第一個字段的類型。? ? using Lovers = eosio::table; }
邏輯.cpp
#include using namespace eosio;namespace eos_fans{? ? //代碼邏輯? ? void say_love(const say& s) {? ? ? ? ? //判斷用戶權限? ? ? ? require_auth(s.author);? ? ? ? love exited_love;? ? ? ? bool love_exiting = Lovers::get(s.lover, exited_love, s.author);? ? ? ? ? //判斷是否已經(jīng)存在,如果存在times加1,如果不存在則創(chuàng)建數(shù)據(jù)。if(love_exiting ==true){? ? ? ? ? ? exited_love.times += 1;? ? ? ? ? ? Lovers::update(exited_love, s.author);? ? ? ? }else{? ? ? ? ? ? love love_to_say;? ? ? ? ? ? love_to_say.lover = s.lover;? ? ? ? ? ? love_to_say.author = s.author;? ? ? ? ? ? love_to_say.times = 1;? ? ? ? ? ? Lovers::store(love_to_say, s.author);? ? ? ? }? ? }}extern"C"{? ? voidinit() {? ? }? ? /// The apply method implements the dispatch of events to this contract? ? void apply( uint64_t code, uint64_t action ) {if( code == N(eosfans) ){if(action == N(say)){? ? ? ? ? ? ? ? eos_fans::say_love(current_message());? ? ? ? ? ? }? ? }}}// extern"C"
abi編寫
abi文件根據(jù)官網(wǎng)描述是可以通過eoscpp自動生成的,但是筆者嘗試過,生成的文件的各個字段都是空的,所以這里就需要筆者自己編寫,當然如果有人生成成功,可以告訴筆者正確生成方法,在這里提前感謝。
abi文件內容如下:
{"types": [],"structs": [{"name":"love",//所存儲的數(shù)據(jù)類型"base":"","fields": {"lover":"account_name","author":"account_name","times":"uint8"}? },{"name":"say",//action"base":"","fields": {"lover":"account_name","author":"account_name"}? }],"actions": [{"action_name":"say","type":"say"}],"tables": [{"table_name":"loves",//數(shù)據(jù)表"type":"love","index_type":"i64","key_names": ["lover"],//索引字段"key_types": ["account_name"]? }]}
成功三步曲
智能合約寫完以后,成功就近在眼前了。
智能合約文件生成
智能合約的各個組件編寫完畢以后,下一步就是編譯成.wast文件,eos有專門的工具:eoscpp,執(zhí)行命令如下:
eoscpp-geosfans.wasteosfans.cpp
執(zhí)行完以后如果沒有報錯,就說明智能合約文件生成完畢,如果有錯誤可以根據(jù)錯誤對智能合約進行更改。
智能合約發(fā)布
智能合約文件生成完以后我們就要發(fā)布智能合約,命令如下:
eoscsetcontracteosfanseosfans.wasteosfans.abi
執(zhí)行完以后你會看到智能合約生成的交易:
Reading WAST...Assembling WASM...Publishing contract...{"transaction_id":"e59fac3876441bce2e65c6d20294523f6e597af71e0e7699b2d6d436a6f24444","processed": {"ref_block_num":64936,"ref_block_prefix":4035039255,"expiration":"2018-03-03T07:59:50","scope": ["eos","lome"],"signatures": ["1f030f69ef5e5f3c3f90835c04cd5ee9756a78ba22f7227ffee88dd33d3bc138450dd1e8caceb3c11bfe318389f772593f53f6103316d0c1650b514aab680a2c8d"],"messages": [{"code":"eos","type":"setcode","authorization": [{"account":"lome","permission":"active"}? ? ? ? ],"data": {"account":"lome","vm_type":0,"vm_version":0,"code":"0061736d01000000012d0860017e0060057e7e7e7f7f017f60047e7e7f7f017f60017f0060027f7f017f60027f7f0060000060027e7e0002710703656e7606617373657274000503656e76086c6f61645f693634000103656e76067072696e7473000303656e760c726561645f6d657373616765000403656e760c726571756972655f61757468000003656e760973746f72655f693634000203656e760a7570646174655f69363400020304030306070404017000000503010001073c04066d656d6f72790200205f5a4e38656f735f66616e73387361795f6c6f766545524b4e535f3373617945000704696e69740008056170706c7900090afd0503bf0102017e017f4100410028020441306b220236020420002903081004200220002903003703180240024020002903084280808080f0e9ac98d50042808080808080ab9b8d7f200241186a411110014111470d00200220022d002841016a3a0028200041086a29030042808080808080ab9b8d7f200241186a411110061a0c010b200241013a0010200220002903003703002002200041086a2903002201370308200142808080808080ab9b8d7f2002411110051a0b4100200241306a3602040b02000bb60403027f047e017f4100410028020441c0006b220836020442002105423b2104411021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a5016a21020c020b420021072005420b580d020c030b200241d0016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b024020062000520d0042002105423b2104412021034200210603400240024002400240024020054202560d0020032c00002202419f7f6a41ff017141194b0d01200241a5016a21020c020b420021072005420b580d020c030b200241d0016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b20062001520d0041301002200841101003410f4b41c00010002008290308100420082008290300370328024020082903084280808080f0e9ac98d50042808080808080ab9b8d7f200841286a411110014111470d00200820082d003841016a3a0038200841086a29030042808080808080ab9b8d7f200841286a411110061a0c010b200841013a0020200820082903003703102008200841086a2903002205370318200542808080808080ab9b8d7f200841106a411110051a0b4100200841c0006a3602040b0b52050041040b04604000000041100b08656f7366616e73000041200b04736179000041300b09736179206c6f7665000041c0000b1e6d6573736167652073686f72746572207468616e2065787065637465640000ad01046e616d650a06617373657274020000086c6f61645f693634050000000000067072696e747301000c726561645f6d6573736167650200000c726571756972655f6175746801000973746f72655f69363404000000000a7570646174655f6936340400000000205f5a4e38656f735f66616e73387361795f6c6f766545524b4e535f33736179450301300131013204696e697400056170706c7909013001310132013301340135013601370138","code_abi": {"types": [],"structs": [{"name":"love","base":"","fields": {"lover":"account_name","author":"account_name","times":"uint8"}? ? ? ? ? ? ? },{"name":"say","base":"","fields": {"lover":"account_name","author":"account_name"}? ? ? ? ? ? ? }? ? ? ? ? ? ],"actions": [{"action_name":"say","type":"say"}? ? ? ? ? ? ],"tables": [{"table_name":"loves","index_type":"i64","key_names": ["lover"],"key_types": ["account_name"],"type":"love"}? ? ? ? ? ? ]? ? ? ? ? }? ? ? ? },"hex_data":"0000000000a0248d0000fd090061736d01000000012d0860017e0060057e7e7e7f7f017f60047e7e7f7f017f60017f0060027f7f017f60027f7f0060000060027e7e0002710703656e7606617373657274000503656e76086c6f61645f693634000103656e76067072696e7473000303656e760c726561645f6d657373616765000403656e760c726571756972655f61757468000003656e760973746f72655f693634000203656e760a7570646174655f69363400020304030306070404017000000503010001073c04066d656d6f72790200205f5a4e38656f735f66616e73387361795f6c6f766545524b4e535f3373617945000704696e69740008056170706c7900090afd0503bf0102017e017f4100410028020441306b220236020420002903081004200220002903003703180240024020002903084280808080f0e9ac98d50042808080808080ab9b8d7f200241186a411110014111470d00200220022d002841016a3a0028200041086a29030042808080808080ab9b8d7f200241186a411110061a0c010b200241013a0010200220002903003703002002200041086a2903002201370308200142808080808080ab9b8d7f2002411110051a0b4100200241306a3602040b02000bb60403027f047e017f4100410028020441c0006b220836020442002105423b2104411021034200210603400240024002400240024020054206560d0020032c00002202419f7f6a41ff017141194b0d01200241a5016a21020c020b420021072005420b580d020c030b200241d0016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b024020062000520d0042002105423b2104412021034200210603400240024002400240024020054202560d0020032c00002202419f7f6a41ff017141194b0d01200241a5016a21020c020b420021072005420b580d020c030b200241d0016a41002002414f6a41ff01714105491b21020b2002ad42388642388721070b2007421f83200442ffffffff0f838621070b200341016a2103200542017c2105200720068421062004427b7c2204427a520d000b20062001520d0041301002200841101003410f4b41c00010002008290308100420082008290300370328024020082903084280808080f0e9ac98d50042808080808080ab9b8d7f200841286a411110014111470d00200820082d003841016a3a0038200841086a29030042808080808080ab9b8d7f200841286a411110061a0c010b200841013a0020200820082903003703102008200841086a2903002205370318200542808080808080ab9b8d7f200841106a411110051a0b4100200841c0006a3602040b0b52050041040b04604000000041100b08656f7366616e73000041200b04736179000041300b09736179206c6f7665000041c0000b1e6d6573736167652073686f72746572207468616e2065787065637465640000ad01046e616d650a06617373657274020000086c6f61645f693634050000000000067072696e747301000c726561645f6d6573736167650200000c726571756972655f6175746801000973746f72655f69363404000000000a7570646174655f6936340400000000205f5a4e38656f735f66616e73387361795f6c6f766545524b4e535f33736179450301300131013204696e697400056170706c79090130013101320133013401350136013701380002046c6f76650003056c6f7665720c6163636f756e745f6e616d6506617574686f720c6163636f756e745f6e616d650574696d65730575696e7438037361790002056c6f7665720c6163636f756e745f6e616d6506617574686f720c6163636f756e745f6e616d6501000000000000bcc103736179010000000000ac368d0369363401056c6f766572010c6163636f756e745f6e616d65046c6f7665"}? ? ],"output": [{"notify": [],"deferred_trxs": []? ? ? }? ? ]? }}
現(xiàn)在我們可以來看一下我們智能合約的table內容,通過如下命令察看:
eosc get table eosfans eosfans loves //table 擁有者,智能合約名稱, table名稱
我們可以看到如下的顯示:
智能合約使用
根據(jù)abi文件我們可以輕松使用智能合約,命令如下:
eosc push message eosfans say '{"lover": "eosfans", "author": "lome2"}' -S lome2 -p lome2@active
執(zhí)行完以后我們可以看到交易的詳情:
現(xiàn)在我們來看一下執(zhí)行完幾次后筆者的數(shù)據(jù)表,如下所示:
該智能合約我已經(jīng)發(fā)布在測試網(wǎng)絡,合約名稱為eosfans歡迎各位一起玩。
說明: 最近一直在學習智能合約其中遇到很多困難,譬如本地用的是2.0,官網(wǎng)的接口文檔是3.0。這次使用的是2.0,以后將會把本地版本部署為3.0,這片文章以后若是在未說明的情況下所用的版本都為3.0。
可到http://eosmonitor.io查看你的表白。