波场链/币安链/马蹄链2.0佛萨奇开发源码
2.0佛萨奇马蹄链/币安链/波场链dapp智能合约系统开发(详情及规则)
5.1.0. 部署调用合约
编译完成后，将得到一个.wasm格式的合约文件，可将之部署到指定到长安链上，完成合约部署。部署合约的使用教程可详见：部署示例合约。
5.1. 1迭代器使用示例
点击此处查看接口说明
使用示例如下：
#[no_mangle]pub extern "c" fn how_to_use_iterator() { let ctx = &mut sim_context::get_sim_context(); // 构造数据 ctx.put_state("key1", "field1", "val".as_bytes()); ctx.put_state("key1", "field2", "val".as_bytes()); ctx.put_state("key1", "field23", "val".as_bytes()); ctx.put_state("key1", "field3", "val".as_bytes()); // 使用迭代器，能查出来 field1，field2，field23 三条数据 let r = ctx.new_iterator_with_field("key1", "field1", "field3"); if r.is_ok() { let rs = r.unwrap(); // 遍历 while rs.has_next() { // 获取下一行值 let row = rs.next_row().unwrap(); let key = row.get_string("key").unwrap(); let field = row.get_bytes("field"); let val = row.get_bytes("value"); // do something } // 关闭游标 rs.close(); } ctx.put_state("key2", "field1", "val".as_bytes()); ctx.put_state("key3", "field2", "val".as_bytes()); ctx.put_state("key33", "field2", "val".as_bytes()); ctx.put_state("key4", "field3", "val".as_bytes()); // 能查出来 key2，key3，key33 三条数据 ctx.new_iterator("key2", "key4"); // 能查出来 key3，key33 两条数据 ctx.new_iterator_prefix_with_key("key3"); // 能查出来 field2，field23 三条数据 ctx.new_iterator_prefix_with_key_field("key1", "field2"); ctx.put_state_from_key("key5","val".as_bytes()); ctx.put_state_from_key("key56","val".as_bytes()); ctx.put_state_from_key("key6","val".as_bytes()); // 能查出来 key5，key56 两条数据 ctx.new_iterator("key5", "key6");}
复制
5.1.2 rust sdk api描述
5.1.3. 下载 contract-sdk-rust 项目代码
git clone https://git.chainmaker.org.cn/chainmaker/contract-sdk-rust -b v2.3.0
复制
5.1.4. 项目文件说明
tree -i target ├── cargo.lock # 依赖版本信息├── cargo.toml # 项目配置及依赖，参考：https://rustwasm.github.io/wasm-pack/book/cargo-toml-configuration.html├── makefile # build一个wasm文件├── readme.md # 编译环境说明├── src│ ├── easycodec.rs # 序列化工具类│ ├── lib.rs # 程序入口│ ├── sim_context.rs # 合约sdk主要接口及实现│ ├── sim_context_bulletproofs.rs # 合约sdk基于bulletproofs的范围证明接口实现│ ├── sim_context_paillier.rs # 合约sdk基于paillier的半同态运算接口实现│ ├── sim_context_rs.rs # 合约sdk sql接口实现│ └── vec_box.rs # 内存管理类
复制
5.1.5. 内置链交互接口
用于链与sdk数据交互。
// 申请size大小内存，返回该内存的首地址pub extern "c" fn allocate(size: usize) -> i32 {}// 释放某地址pub extern "c" fn deallocate(pointer: *mut c_void) {}// 获取sdk运行时环境pub extern "c" fn runtime_type() -> i32 { 0 }
复制
5.1.6 用户与链交互接口
/// simcontext is a interface with chainmaker interactionpub trait simcontext { // common method fn call_contract( &self, contract_name: &str, method: &str, param: easycodec, ) -> result<vec<u8>, result_code>; fn ok(&self, value: &[u8]) -> result_code; fn error(&self, body: &str) -> result_code; fn log(&self, msg: &str); fn arg(&self, key: &str) -> result<vec<u8>, string>; fn arg_as_utf8_str(&self, key: &str) -> string; fn args(&self) -> &easycodec; fn get_creator_org_id(&self) -> string; fn get_creator_pub_key(&self) -> string; fn get_creator_role(&self) -> string; fn get_sender_org_id(&self) -> string; fn get_sender_pub_key(&self) -> string; fn get_sender_role(&self) -> string; fn get_block_height(&self) -> u64; fn get_tx_id(&self) -> string; fn emit_event(&mut self, topic: &str, data: &vec<string>) -> result_code; // paillier fn get_paillier_sim_context(&self) -> box<dyn pailliersimcontext>; // bulletproofs fn get_bulletproofs_sim_context(&self) -> box<dyn bulletproofssimcontext>; // sql fn get_s(&self) -> box<dyn s>; // kv method fn get_state(&self, key: &str, field: &str) -> result<vec<u8>, result_code>; fn get_state_from_key(&self, key: &str) -> result<vec<u8>, result_code>; fn put_state(&self, key: &str, field: &str, value: &[u8]) -> result_code; fn put_state_from_key(&self, key: &str, value: &[u8]) -> result_code; fn delete_state(&self, key: &str, field: &str) -> result_code; fn delete_state_from_key(&self, key: &str) -> result_code; /// new_iterator range of [startkey, limitkey), front closed back open fn new_iterator( &self, start_key: &str, limit_key: &str, ) -> result<box<dyn resultset>, result_code>;