在這個瞬息萬變的世界中阵子，智能合約已成為所有平臺中強有力的服務。Solidity是一種趨勢磷雇，PDX Utopia區(qū)塊鏈協(xié)議棧使用Solidity調(diào)用wasm智能合約羔砾。
▼
什么是Solidity？
Solidity是一種語法類似JavaScript的高級語言相艇。它被設計成以編譯的方式生成以太坊虛擬機代碼颖杏，這種語言的突出優(yōu)點是安全。
Solidity語言是靜態(tài)類型語言坛芽，支持繼承留储、庫和復雜的用戶定義類型，可以使用Solidity語言創(chuàng)建區(qū)塊鏈上運行的投票咙轩、眾籌获讳、錢包等各種類型的智能合約。
以太坊合約中的Solidity
合約是以太坊去中心化應用程序的基本構(gòu)建模塊活喊。所有變量和函數(shù)都是合約的一部分丐膝，這是所有項目的起點。一個名為MyFirst的空合約看起來像這樣：
version pragma ^0.4.19;contract MyFirst{}
Solidity文件的布局
源文件可以包含任意數(shù)量的合約定義钾菊，包括指令和pragma指令帅矗。
注釋
就像任何其他語言一樣，Solidity可以使用單行和多行注釋煞烫。
// This is a single-line comment./*This is amulti-line comment*/
Solidity中的值類型
以下類型也稱為值類型浑此，因為這些類型的變量將始終按值傳遞。
Solidity數(shù)據(jù)結(jié)構(gòu)
Solidity提供三種類型的數(shù)據(jù)結(jié)構(gòu)：
使用Solidity調(diào)用wasm智能合約
定義 ABI
>在 `hello-wasm-abi/src/abi.rs` 中定義了 Contract 對象滞详，包含了 `hello-wasm` 樣例中的 <br>凛俱；
>`put/get/getcounter` 三個方法的 `ABI` 描述紊馏，注意，我們還不能直接用 `JSON` 來描述 `ABI`最冰；
>必須使用 `pdxabi::Contract` 來定義聲明灵再。
建議通過以下三步來生成 ABI :
1. 使用 `solidity` 編寫 `contract interface`;
2. 使用 `remix` 編譯 `contract interface` 得到對應的 `ABI` 描述；
3. 參照 `ABI` 描述文件編寫 `pdxabi::Contract`亭敢；
部署 wasm 合約后可以使用合約地址和 contract interface 在 remix 里對合約進行實例化培慌，方便測試。
Solidity Contract Interface
在 [Remix IDE](http://remix.ethereum.org/#optimize=false&version=soljson-v0.5.3+commit.10d17f24.js&evmVersion=null&appVersion=0.7.7) 中編寫合約接口篇裁，并編譯solidity沛慢。
pragma solidity ^0.5.3;contract hello_wasm_abi {? ? ? function getcounter() public view returns(uint256);? ? ? function get(string memory key) public view returns(string memory);? ? function put(string memory key,string memory val) public payable;}
JSON ABI
編譯合約接口可以得到對應的 `ABI JSON` 描述，提供合約地址和此 `JSON ABI` 文檔达布。
`DAPP` 開發(fā)者即可實例化 `hello_wasm_abi` 合約团甲，并使用其中的三個函數(shù)：
json[? ? {? ? ? ? "constant": false,? ? "inputs": [? ? ? ? ? {? ? ? ? "name": "key",? ? ? ? "type": "string"? ? ? ? ? },? ? ? {? ? ? ? "name": "val",? ? ? ? "type": "string"? ? ? ? ? ? ? ? ? }? ? ],? ? "name": "put",? ? "outputs": [],? ? ? "payable": true,? ? "stateMutability": "payable",? ? "type": "? ? function"? },? {? ? "constant": true,? ? "inputs": [? ? ? ? ? {? ? ? ? "name": "key",? ? ? ? "type": "string"? ? ? }? ? ],? ? "name": "get",? ? "outputs": [? ? ? ? ? {? ? ? ? "name": "",? ? ? ? "type": "string"? ? ? ? ? }? ? ],? ? "payable": false,? ? "stateMutability": "view",? ? "type": "function"? },? {? ? "constant": true,? ? "inputs": [],? ? "name": "getcounter",? ? "outputs": [? ? {? ? ? ? "name": "",? ? ? ? "type": "uint256"? ? ? }? ? ],? ? "payable": false,? ? "stateMutability": "view",? ? "type": "function"? }]
pdxabi::Contract
根據(jù) `JSON ABI` 描述實例化 `pdxabi::Contract` 對象，用來對合約的 `input/output` 進行序列化和反序列化黍聂。
rustpub fn get_contract_abi() -> pdxabi::Contract {? ? let mut functions: HashMap<String, pdxabi::Function> = HashMap::new();? ? ? let fn_put = pdxabi::Function {? ? ? ? ? ? constant: false,? ? ? ? ? ? name: String::from("put"),? ? ? ? ? ? inputs: Vec::from(vec![? ? ? ? ? ? ? ? ? ? pdxabi::Param { name: String::from("key"), kind: pdxabi::param_type::ParamType::String },? ? ? ? ? ? ? ? ? pdxabi::Param { name: String::from("val"), kind: pdxabi::param_type::ParamType::String },? ? ? ? ? ? ? ]),? ? ? ? outputs: Vec::default(),? ? };? ? let fn_get = pdxabi::Function {? ? ? ? ? ? ? ? ? constant: true,? ? ? ? ? ? ? ? name: String::from("get"),? ? ? ? ? ? ? ? ? ? inputs: Vec::from(vec![? ? ? ? ? ? ? ? ? ? ? ? ? ? pdxabi::Param { name: String::from("key"), kind: pdxabi::param_type::ParamType::String },? ? ? ? ? ? ? ? ? ? ? ]),? ? ? ? ? ? ? ? ? ? ? ? ? outputs: Vec::from(vec![? ? ? ? ? ? ? ? ? ? ? ? ? ? ? pdxabi::Param { name: String::default(), kind: pdxabi::param_type::ParamType::String },? ? ? ? ? ? ? ? ? ? ? ? ? ]),? ? };? ? let fn_getcounter = pdxabi::Function? ? ? ? ? ? ? ? ? ? {? ? ? ? constant: true,? ? ? ? ? ? ? ? ? ? ? ? ? ? ? name: String::from("getcounter"),? ? ? ? ? ? ? ? ? ? ? ? ? ? inputs: Vec::default(),? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? outputs: Vec::from(vec![? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? pdxabi::Param { name: String::default(),? ? ? ? ? ? ? ? ? ? ? ? ? kind: pdxabi::param_type::ParamType::Uint(256) },? ? ? ? ]),? };? ? functions.insert(fn_put.clone().name, fn_put.clone());? functions.insert(fn_get.clone().name, fn_get.clone());? ? functions.insert(fn_getcounter.clone().name, fn_getcounter.clone());? pdxabi::Contract {? ? ? ? constructor: None,? ? ? ? functions: functions,? ? ? events: HashMap::default(),? ? ? ? ? fallback: false,? ? ? ? ? ? ? signers: HashMap::default(),? ? }}
使用 `ABI`
>在 hello-wasm-abi 合約中：
```rustextern crate wasm_bindgen;extern crate ewasm_api;??use wasm_bindgen::prelude::*;use ewasm_api::types::*;use ewasm_api::pdx::utils::*;
倒入處理 abi 的開發(fā)庫
use ewasm_api::pdxabi;
pdxabi::Contract 定義的對象放在 abi 模塊中：
pub mod abi;??const COUNTER_KEY: Bytes32 = Bytes32{ bytes: [255; 32] };??fn inc_counter() {? ? let old_v = ewasm_api::storage_load(&COUNTER_KEY);? ? let old_i = bytes_to_uint(&old_v.bytes[..]);? let new_i = old_i + 1;? ? let val = u32_to_bytes32(new_i as u32);? let value = Bytes32 { bytes: val };? ? ewasm_api::storage_store(&COUNTER_KEY, &value);}? ?fn get_counter() -> Vec<u8>? {? ? let v = ewasm_api::storage_load(&COUNTER_KEY);? ? Vec::from(&v.bytes[..])}??fn put_data(k: String, v: String){? ? ewasm_api::pdx::storage_store(k.as_bytes(), v.as_bytes());}??fn get_data(k: String) -> Vec<u8>? {? ? ewasm_api::pdx::storage_load(k.as_bytes())}??#[wasm_bindgen]pub fn main() {? ? inc_counter();? ? let input = ewasm_api::calldata_acquire();? if !input.is_empty() {
從 input 獲取方法簽名躺苦，按照 ABI 規(guī)范，input 的前 4 個 byte 為方法簽名产还。
let fn_sig = &Vec::from(&input[..4]);
根據(jù)方法簽名獲取 function 對象匹厘。
? let function = contract.function_by_sig(fn_sig).expect("error_fn_sig");
通過 function.name 來匹配相應的 handler。
match function.name.as_str() {? ? ? ? ? ? ? "getcounter" => { // function getcounter() public view returns(uint256);
調(diào)用 get_counter 得到返回值脐区，轉(zhuǎn)換成 uint
let rtn = ewasm_api::pdx::utils::bytes_to_uint(get_counter().as_slice());
此方法沒有輸入值愈诚，只有輸出，通過 function.encode_output 序列化輸出 牛隅。
let data = function.encode_output(&[pdxabi::Token::Uint(rtn.into())]).unwrap();
將結(jié)果返回給合約調(diào)用者炕柔。
ewasm_api::finish_data(data.as_slice());? ? ? ? ? ? }? ? ? ? ? "get" => { // function get(string memory key) public view returns(string memory);
此方法有定義輸入 string key , 先用 function.decode_input 解析 input, 得到輸入列表 。
let tokens = function.decode_input(input.as_slice()).expect("error_put_input");
接口中 input 只定義了一個參數(shù)媒佣，所以 key = tokens[0]匕累。
? let key = tokens.get(0).expect("error_put_key");
調(diào)用 get_data(key) 函數(shù)，得到 val 的字節(jié)數(shù)組丈攒。
? ? let val = get_data(key.clone().to_string().unwrap());
接口描述輸出值為 string哩罪，所以要將 val 轉(zhuǎn)換為 string。
let rtn = String::from_utf8(val).expect("error_get_val");
使用 function.encode_output 對返回值進行序列化巡验。
let data = function.encode_output(&[pdxabi::Token::String(rtn)]).expect("error_get_output");
將結(jié)果返回給合約調(diào)用者际插。
ewasm_api::finish_data(data.as_slice());? ? ? ? ? }? ? ? ? ? ? "put" => { // function put(string memory key,string memory val) public payable;
此方法有定義輸入 [string key,string val] , 先用 function.decode_input 解析 input, 得到輸入列表。
let tokens = function.decode_input(input.as_slice()).expect("error_put_input");
接口中定義了兩個參數(shù)显设，分別對應 key = tokens[0] , val = tokens[1]框弛。
? let key = tokens.get(0).expect("error_put_key");? ? ? ? ? ? ? let val = tokens.get(1).expect("error_put_val");
調(diào)用 put_data(key,val)。
put_data(key.clone().to_string().unwrap(), val.clone().to_string().unwrap());
結(jié)束調(diào)用捕捂，此方法沒有返回值瑟枫。
ewasm_api::finish()? ? ? ? ? ? }? ? ? ? ? ? _ => ewasm_api::finish()
如果方法匹配失敗斗搞，則直接返回不做任何處理。
? ? ? ? }? ? }}
部署與使用
* 部署合約方式與 `hello-wasm` 樣例相同慷妙，可以參照
[README.md](https://github.com/PDXbaap/ewasm-rust-demo/blob/master/README.md) 中關(guān)于`部署`的描述：
* 調(diào)用合約：部署成功后會得到 `Contract Address` 僻焚，如果使用 `web3` 系列 `SDK` 可以使用 `JSON ABI` + `Contract Address` 來實例化合約，并進行調(diào)用膝擂，如果使用 `remix IDE` 進行測試調(diào)用虑啤，可以使用 `Solidity Contract Interface` + `Contract Address` 來實例化合約并調(diào)用關(guān)于 web3 提供的 SDK 和 remix IDE 的詳細資料請參閱 web3 基金會的相關(guān)資料。
Solidity 調(diào)用 Wasm 合約
用 `sol` 合約來調(diào)用 `wasm` 合約架馋，與 `sol` 調(diào)用 `sol` 方式相同狞山，假設已經(jīng)部署過 `hello-wasm-abi` 這個合約，并得到合約地址 `0xda3ce11d916ffba4a1289cef66a7f142ec5a0f74`,通過 `hello-wasm-abi` 合約接口和地址叉寂，即可實例化這個合約萍启，之后用法與 `sol` 調(diào)用 `sol` 一致。
例如：
soliditypragma solidity ^0.5.3;
hello-wasm-abi 合約接口
contract hello_wasm_abi {? ? ? function getcounter() public view returns(uint256);? ? ? function get(string memory key) public view returns(string memory);? ? function put(string memory key,string memory val) public payable;}? ? ? ?
使用 hello-wasm-abi 合約的 solidity 合約
contract foobar {? ? ? ? function fetch(address addr,string memory key) public view returns(string memory) {
第一個參數(shù) addr 為 wasm 合約地址屏鳍，通過接口和地址實例化合約對象勘纯。
? ? ? ? hello_wasm_abi hello = hello_wasm_abi(addr);
調(diào)用 wasm 合約方法
? return hello.get(key);? ? }? ? ? function set(address addr,string memory key,string memory val) public payable? {? ? ? ? hello_wasm_abi hello = hello_wasm_abi(addr);? ? ? ? hello.put(key,val);? ? }??}
部署 `foobar` 合約后，使用 `hello-wasm-abi` 的合約地址：
`0xda3ce11d916ffba4a1289cef66a7f142ec5a0f74` 作為第一個參數(shù)分別調(diào)用 `fetch` 和 `set` 方法钓瞭，完成對 `hello-wasm-abi` 合約的 `get` 和 `put` 的調(diào)用屡律。
