在chainsql的nodejs接口中，我们提供了chainsql.contract对象，通过创建该对象，就可以开始与chainsql智能合约的交互了。
合约示例¶
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
// Modified Greeter contract. Based on example at https://www.ethereum.org/greeter.
contract mortal {
/* Define variable owner of the type address*/
address owner;
/* this function is executed at initialization and sets the owner of the contract */
constructor() { owner = msg.sender; }
/* Function to recover the funds on the contract */
function kill() public { if (msg.sender == owner) selfdestruct(payable(owner)); }
}
contract greeter is mortal {
/* define variable greeting of the type string */
string greeting;
fallback() external payable { }
/* this runs when the contract is executed */
constructor(string memory _greeting) public payable{
greeting = _greeting;
}
function newGreeting(string calldata _greeting) public {
emit Modified(greeting, _greeting, greeting, _greeting);
greeting = _greeting;
}
function getMultiGreeting() public view returns(string memory,string memory){
return(greeting,greeting);
}
/* main function */
function greet() public view returns (string memory) {
return greeting;
}
event showSM3Ret(address msgSender, string orgStr, bytes32 sm3Ret);
function getSM3(string calldata orgStr) public
{
bytes32 sm3byte = sm3(bytes(orgStr));
emit showSM3Ret(msg.sender, orgStr, sm3byte);
}
/* we include indexed events to demonstrate the difference that can be
captured versus non-indexed */
event Modified(
string indexed oldGreetingIdx, string indexed newGreetingIdx,
string oldGreeting, string newGreeting);
}
创建合约对象¶
chainsql.contract(abi[, contractAddr]);
创建一个包含了所有在abi中定义的函数和事件的新合约对象。chainsql是一个chainsql-nodejs的对象。
参数说明¶
abi-Array: 一个由Json对象组成的数组，每个Json对象都是solidity的函数或者事件,可通过 remix.chainsql.net 获取；contractAddr-String: [可选]合约地址，在初次创建合约对象时，没有合约地址，可不填；合约已经存在，可直接利用合约地址，创建一个包含该合约函数和事件的合约对象。
返回值¶
Object : 包含合约函数和事件的智能合约对象。
示例¶
//first create a contract object without contract address.
const abi = '[{"constant":true,"inputs":[],"name":"getMultiGreeting","outputs":[{"name":"","type":"string"},{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"kill","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_greeting","type":"string"}],"name":"newGreeting","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"greet","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":true,"stateMutability":"payable","type":"constructor"},{"payable":true,"stateMutability":"payable","type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"oldGreetingIdx","type":"string"},{"indexed":true,"name":"newGreetingIdx","type":"string"},{"indexed":false,"name":"oldGreeting","type":"string"},{"indexed":false,"name":"newGreeting","type":"string"}],"name":"Modified","type":"event"}]';
const contractObj = chainsql.contract(JSON.parse(abi));
//create a contract object with contract address already in chainsql blockchain.
const abi = '[{"constant":true,"inputs":[],"name":"getMultiGreeting","outputs":[{"name":"","type":"string"},{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"kill","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_greeting","type":"string"}],"name":"newGreeting","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"greet","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":true,"stateMutability":"payable","type":"constructor"},{"payable":true,"stateMutability":"payable","type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"oldGreetingIdx","type":"string"},{"indexed":true,"name":"newGreetingIdx","type":"string"},{"indexed":false,"name":"oldGreeting","type":"string"},{"indexed":false,"name":"newGreeting","type":"string"}],"name":"Modified","type":"event"}]';
const contractObj = chainsql.contract(JSON.parse(abi), "zEyJTYupmFGo3tWCts8uyzmkkmjJAwgS2u");
合约部署¶
contractObj.deploy(paramsNeeded).submit(options[, callback]);
通过deploy函数将合约部署到链上，返回结果可以通过指定callback函数或者直接使用then和catch接收promise的resolve和reject。
参数说明¶
paramsNeeded-JsonObject: 由以下两个必选字段组成：ContractData-String: 智能合约字节码，以0x开头。可通过 remix.chainsql.net 获取，也可以通过chainsql-solc的nodejs-npm包进行本地编译；arguments-Array: 智能合约构造函数的参数作为元素组成的数组，每个元素根据类型填写元素值，没有参数提供一个空数组[]。
options-JsonObject: 由以下两个字段组成：ContractValue-String: [可选]如果合约构造函数为payable类型，则可使用该字段给合约转账，单位为drop；Gas-Number: 执行合约部署所需要的手续费用。
callback-Function: [可选]回调函数，如果指定，则通过指定回调函数返回结果，否则需要通过then和catch接收promise结果。
返回值¶
JsonObject - 智能合约的部署成功或失败的结果。返回方式取决于是否指定回调函数。
部署成功 - 指定回调函数，则通过回调函数返回，否则返回一个resolve的Promise对象。
JsonObject包含以下字段：status-String: 表示部署状态，成功则为固定值:”validate_success”；tx_hash-String: 部署合约的交易hash值；contractAddress-String: 部署成功的合约地址。
部署失败 - 指定回调函数，则通过回调函数返回，否则返回一个reject的Promise对象。
JsonObject内容依具体错误形式返回。
示例¶
// use the callback
const abi = '[{"constant":true,"inputs":[],"name":"getMultiGreeting","outputs":[{"name":"","type":"string"},{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"kill","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_greeting","type":"string"}],"name":"newGreeting","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"greet","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":true,"stateMutability":"payable","type":"constructor"},{"payable":true,"stateMutability":"payable","type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"oldGreetingIdx","type":"string"},{"indexed":true,"name":"newGreetingIdx","type":"string"},{"indexed":false,"name":"oldGreeting","type":"string"},{"indexed":false,"name":"newGreeting","type":"string"}],"name":"Modified","type":"event"}]'; const contractObj = chainsql.contract(JSON.parse(abi));
const deployBytecode = '0x60806040526040516109b13803806109b18339810180604052602081101561002657600080fd5b81019080805164010000000081111561003e57600080fd5b8281019050602081018481111561005457600080fd5b815185600182028301116401000000008211171561007157600080fd5b5050929190505050336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555080600190805190602001906100cf9291906100d6565b505061017b565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061011757805160ff1916838001178555610145565b82800160010185558215610145579182015b82811115610144578251825591602001919060010190610129565b5b5090506101529190610156565b5090565b61017891905b8082111561017457600081600090555060010161015c565b5090565b90565b6108278061018a6000396000f300608060405260043610610062576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806305fe42491461006457806341c0e1b5146101605780634ac0d66e14610177578063cfae32171461023f575b005b34801561007057600080fd5b506100796102cf565b604051808060200180602001838103835285818151815260200191508051906020019080838360005b838110156100bd5780820151818401526020810190506100a2565b50505050905090810190601f1680156100ea5780820380516001836020036101000a031916815260200191505b50838103825284818151815260200191508051906020019080838360005b83811015610123578082015181840152602081019050610108565b50505050905090810190601f1680156101505780820380516001836020036101000a031916815260200191505b5094505050505060405180910390f35b34801561016c57600080fd5b50610175610415565b005b34801561018357600080fd5b5061023d6004803603602081101561019a57600080fd5b81019080803590602001906401000000008111156101b757600080fd5b8201836020820111156101c957600080fd5b803590602001918460018302840111640100000000831117156101eb57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192905050506104a6565b005b34801561024b57600080fd5b506102546106b4565b6040518080602001828103825283818151815260200191508051906020019080838360005b83811015610294578082015181840152602081019050610279565b50505050905090810190601f1680156102c15780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b606080600180818054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561036a5780601f1061033f5761010080835404028352916020019161036a565b820191906000526020600020905b81548152906001019060200180831161034d57829003601f168201915b50505050509150808054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156104065780601f106103db57610100808354040283529160200191610406565b820191906000526020600020905b8154815290600101906020018083116103e957829003601f168201915b50505050509050915091509091565b6000809054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156104a4576000809054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16ff5b565b806040518082805190602001908083835b6020831015156104dc57805182526020820191506020810190506020830392506104b7565b6001836020036101000a0380198251168184511680821785525050505050509050019150506040518091039020600160405180828054600181600116156101000203166002900480156105665780601f10610544576101008083540402835291820191610566565b820191906000526020600020905b815481529060010190602001808311610552575b505091505060405180910390207f047dcd1aa8b77b0b943642129c767533eeacd700c7c1eab092b8ce05d2b2faf56001846040518080602001806020018381038352858181546001816001161561010002031660029004815260200191508054600181600116156101000203166002900480156106245780601f106105f957610100808354040283529160200191610624565b820191906000526020600020905b81548152906001019060200180831161060757829003601f168201915b5050838103825284818151815260200191508051906020019080838360005b8381101561065e578082015181840152602081019050610643565b50505050905090810190601f16801561068b5780820380516001836020036101000a031916815260200191505b5094505050505060405180910390a380600190805190602001906106b0929190610756565b5050565b606060018054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561074c5780601f106107215761010080835404028352916020019161074c565b820191906000526020600020905b81548152906001019060200180831161072f57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061079757805160ff19168380011785556107c5565b828001600101855582156107c5579182015b828111156107c45782518255916020019190600101906107a9565b5b5090506107d291906107d6565b5090565b6107f891905b808211156107f45760008160009055506001016107dc565b5090565b905600a165627a7a72305820ec5e59bd3a1929ffbf0765edb4eaf1e4d7589b32337d5fd1de23074fdef29f390029';
contractObj.deploy({
ContractData : deployBytecode,
arguments:['Hello blockchain world!']
}).submit({
Gas: '5000000',
}, function (err, res) {
err ? console.log(err) : console.log(res);
});
>
{
status:"validate_success"
tx_hash:"DD443076A8A4B02B6661261CCD456F2DC7F4031F12EC38EAD35E821782328318"
contractAddress:"zPqMARn53PpN2fu8eScac4cEYW6b4w8ZH"
}
// use the promise
const abi = '[{"constant":true,"inputs":[],"name":"getMultiGreeting","outputs":[{"name":"","type":"string"},{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"constant":false,"inputs":[],"name":"kill","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":false,"inputs":[{"name":"_greeting","type":"string"}],"name":"newGreeting","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"greet","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[{"name":"_greeting","type":"string"}],"payable":true,"stateMutability":"payable","type":"constructor"},{"payable":true,"stateMutability":"payable","type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"oldGreetingIdx","type":"string"},{"indexed":true,"name":"newGreetingIdx","type":"string"},{"indexed":false,"name":"oldGreeting","type":"string"},{"indexed":false,"name":"newGreeting","type":"string"}],"name":"Modified","type":"event"}]'; const contractObj = chainsql.contract(JSON.parse(abi));
const deployBytecode = '0x60806040526040516109b13803806109b18339810180604052602081101561002657600080fd5b81019080805164010000000081111561003e57600080fd5b8281019050602081018481111561005457600080fd5b815185600182028301116401000000008211171561007157600080fd5b5050929190505050336000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555080600190805190602001906100cf9291906100d6565b505061017b565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061011757805160ff1916838001178555610145565b82800160010185558215610145579182015b82811115610144578251825591602001919060010190610129565b5b5090506101529190610156565b5090565b61017891905b8082111561017457600081600090555060010161015c565b5090565b90565b6108278061018a6000396000f300608060405260043610610062576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806305fe42491461006457806341c0e1b5146101605780634ac0d66e14610177578063cfae32171461023f575b005b34801561007057600080fd5b506100796102cf565b604051808060200180602001838103835285818151815260200191508051906020019080838360005b838110156100bd5780820151818401526020810190506100a2565b50505050905090810190601f1680156100ea5780820380516001836020036101000a031916815260200191505b50838103825284818151815260200191508051906020019080838360005b83811015610123578082015181840152602081019050610108565b50505050905090810190601f1680156101505780820380516001836020036101000a031916815260200191505b5094505050505060405180910390f35b34801561016c57600080fd5b50610175610415565b005b34801561018357600080fd5b5061023d6004803603602081101561019a57600080fd5b81019080803590602001906401000000008111156101b757600080fd5b8201836020820111156101c957600080fd5b803590602001918460018302840111640100000000831117156101eb57600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f8201169050808301925050505050505091929192905050506104a6565b005b34801561024b57600080fd5b506102546106b4565b6040518080602001828103825283818151815260200191508051906020019080838360005b83811015610294578082015181840152602081019050610279565b50505050905090810190601f1680156102c15780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b606080600180818054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561036a5780601f1061033f5761010080835404028352916020019161036a565b820191906000526020600020905b81548152906001019060200180831161034d57829003601f168201915b50505050509150808054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156104065780601f106103db57610100808354040283529160200191610406565b820191906000526020600020905b8154815290600101906020018083116103e957829003601f168201915b50505050509050915091509091565b6000809054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156104a4576000809054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16ff5b565b806040518082805190602001908083835b6020831015156104dc57805182526020820191506020810190506020830392506104b7565b6001836020036101000a0380198251168184511680821785525050505050509050019150506040518091039020600160405180828054600181600116156101000203166002900480156105665780601f10610544576101008083540402835291820191610566565b820191906000526020600020905b815481529060010190602001808311610552575b505091505060405180910390207f047dcd1aa8b77b0b943642129c767533eeacd700c7c1eab092b8ce05d2b2faf56001846040518080602001806020018381038352858181546001816001161561010002031660029004815260200191508054600181600116156101000203166002900480156106245780601f106105f957610100808354040283529160200191610624565b820191906000526020600020905b81548152906001019060200180831161060757829003601f168201915b5050838103825284818151815260200191508051906020019080838360005b8381101561065e578082015181840152602081019050610643565b50505050905090810190601f16801561068b5780820380516001836020036101000a031916815260200191505b5094505050505060405180910390a380600190805190602001906106b0929190610756565b5050565b606060018054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561074c5780601f106107215761010080835404028352916020019161074c565b820191906000526020600020905b81548152906001019060200180831161072f57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061079757805160ff19168380011785556107c5565b828001600101855582156107c5579182015b828111156107c45782518255916020019190600101906107a9565b5b5090506107d291906107d6565b5090565b6107f891905b808211156107f45760008160009055506001016107dc565b5090565b905600a165627a7a72305820ec5e59bd3a1929ffbf0765edb4eaf1e4d7589b32337d5fd1de23074fdef29f390029';
contractObj.deploy({
ContractData : deployBytecode,
arguments:['Hello blockchain world!']
}).submit({
Gas: '5000000',
}).then(res => {
console.log(res);
}).catch(err => {
console.error(err);
});
有依赖库的合约部署¶
当合约有依赖第三方库时，编译完的合约bytecode是不能直接进行部署使用的，需要使用合约的bytecode和库合约的地址进行link。 link功能由chainsql-solc模块提供，这个模块同样可以进行合约的编译；具体使用方法为以下几步：
编译合约及依赖的库合约；
通过chainsql的SDK部署所有库合约，得到所有库合约地址；
将合约bytecode及所有库合约地址作为参数传递给chainsql-solc的linkBytecode函数，返回可部署的合约bytecode；
通过chainsql的SDK部署合约；
chainsql-solc的linkBytecode函数参数说明¶
bytecode-String: 有依赖库的合约的bytecode，十六进制字符串，不用加0x;libraryInfo-JsonObject: 由以下两个字段组成：libraryName-String: 库合约名称，格式【编译时库合约所在路径/文件名:库合约名】；libraryAddress-String: 部署完的库合约地址。
（详细说明参见npmjs.com网站中chainsql-solc模块的说明）
返回值¶
bytecode - String : 连接完库合约地址的可用于部署的合约bytecode。
示例¶
/** 带依赖库合约示例，合约文件ContractWithLib.sol
// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.0;
library libraryA {
function add(int a, int b) pure public returns (int) {
return a + b;
}
}
library libraryB {
function multi(int a, int b) pure public returns (int) {
return a * b;
}
}
contract Test {
int intA;
int intB;
constructor(int a, int b) {
intA = a;
intB = b;
}
function getSum() view public returns (int) {
return libraryA.add(intA, intB);
}
function getMulti() view public returns (int) {
return libraryB.multi(intA, intB);
}
}
**/
// nodejs调用代码, 需要安装chainsql和chainsql-solc
const linker = require('chainsql-solc/linker');
const libraryAAbi = '[{"inputs":[{"internalType":"int256","name":"a","type":"int256"},{"internalType":"int256","name":"b","type":"int256"}],"name":"add","outputs":[{"internalType":"int256","name":"","type":"int256"}],"stateMutability":"pure","type":"function","signature":"0xa5f3c23b"}]';
const libraryABytecode = "0x60e9610039600b82828239805160001a60731461002c57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe730000000000000000000000000000000000000000301460806040526004361060335760003560e01c8063a5f3c23b146038575b600080fd5b60476043366004606a565b6059565b60405190815260200160405180910390f35b600060638284608b565b9392505050565b60008060408385031215607c57600080fd5b50508035926020909101359150565b600080821280156001600160ff1b038490038513161560aa5760aa60c6565b600160ff1b839003841281161560c05760c060c6565b50500190565b634e487b7160e01b600052601160045260246000fdfea164736f6c6343000805000a";
const libraryBAbi = '[{"inputs":[{"internalType":"int256","name":"a","type":"int256"},{"internalType":"int256","name":"b","type":"int256"}],"name":"multi","outputs":[{"internalType":"int256","name":"","type":"int256"}],"stateMutability":"pure","type":"function","signature":"0xb1fd5838"}]';
const libraryBBytecode = "0x61013c61003a600b82828239805160001a60731461002d57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600436106100355760003560e01c8063b1fd58381461003a575b600080fd5b61004d610048366004610072565b61005f565b60405190815260200160405180910390f35b600061006b8284610094565b9392505050565b6000806040838503121561008557600080fd5b50508035926020909101359150565b60006001600160ff1b03818413828413808216868404861116156100ba576100ba610119565b600160ff1b60008712828116878305891216156100d9576100d9610119565b600087129250878205871284841616156100f5576100f5610119565b8785058712818416161561010b5761010b610119565b505050929093029392505050565b634e487b7160e01b600052601160045260246000fdfea164736f6c6343000805000a";
const contractAbi = '[{"inputs":[],"name":"getMulti","outputs":[{"internalType":"int256","name":"","type":"int256"}],"stateMutability":"view","type":"function","signature":"0xf3c66284"},{"inputs":[],"name":"getSum","outputs":[{"internalType":"int256","name":"","type":"int256"}],"stateMutability":"view","type":"function","signature":"0x569c5f6d"},{"inputs":[{"internalType":"int256","name":"a","type":"int256"},{"internalType":"int256","name":"b","type":"int256"}],"stateMutability":"nonpayable","type":"constructor","signature":"constructor"}]';
let contractBytecode = "608060405234801561001057600080fd5b506040516101d23803806101d283398101604081905261002f9161003d565b600091909155600155610061565b6000806040838503121561005057600080fd5b505080516020909101519092909150565b610162806100706000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c8063569c5f6d1461003b578063f3c6628414610055575b600080fd5b61004361005d565b60405190815260200160405180910390f35b6100436100f7565b6000805460015460405163a5f3c23b60e01b815273__$63ad81b819b00bb667992e24d91ef9a087$__9263a5f3c23b926100a292600401918252602082015260400190565b60206040518083038186803b1580156100ba57600080fd5b505af41580156100ce573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906100f2919061013c565b905090565b6000805460015460405163163fab0760e31b815273__$f97a89a10f16b752a7f1e32bb4b266773b$__9263b1fd5838926100a292600401918252602082015260400190565b60006020828403121561014e57600080fd5b505191905056fea164736f6c6343000805000a";
let libraryA = chainsql.contract(JSON.parse(libraryAAbi));
let libraryB = chainsql.contract(JSON.parse(libraryBAbi));
let contractObj = chainsql.contract(JSON.parse(contractAbi));
try {
let deployARes = await libraryA.deploy({ ContractData : libraryABytecode }).submit({ Gas : 400000 });
let deployBRes = await libraryB.deploy({ ContractData : libraryBBytecode }).submit({ Gas : 400000 });
let newCtrBytecode = "0x" + linker.linkBytecode(contractBytecode, {
"browser/ContractWithLib.sol:libraryA": deployARes.contractAddress,
"browser/ContractWithLib.sol:libraryB": deployBRes.contractAddress
})
let deployRes = await contractObj.deploy({
ContractData : newCtrBytecode,
arguments: [2,16] }).submit({ Gas : 400000 });
console.log(deployRes);
} catch (error) {
console.log(error);
}
>
{
status:"validate_success"
tx_hash:"DD443076A8A4B02B6661261CCD456F2DC7F4031F12EC38EAD35E821782328318"
contractAddress:"zPqMARn53PpN2fu8eScac4cEYW6b4w8ZH"
}
更改合约内部状态调用¶
contractObj.methods.function([params1[, params2, ...]]]).submit(options[, callback])
这种调用方式实际是以交易的形式发送到chainsql链上。然后执行合约的对应方法。并会对合约内部状态产生影响。function为合约的具体方法名。
参数说明¶
params-any: 合约本身function的参数值，依据合约方法的参数个数和类型进行传递；options-JsonObject: 由以下两个字段组成：ContractValue-String: [可选]如果合约函数为payable类型，则可使用该字段给合约转账，单位为drop；Gas-Number: 执行合约函数所需要的手续费用。expect-String: [可选]在chainsql中提供几种预期交易执行结果的返回，不指定则使用”send_success”，可选执行结果如下：“send_success” : 交易发送成功即返回结果；
“validate_success” ： 交易共识成功即返回结果；
“db_success” ： 涉及数据库交易，执行入库成功即返回结果。
callback-Function: [可选]回调函数，如果指定，则通过指定回调函数返回结果，否则需要通过then和catch接收promise结果。
返回值¶
JsonObject : 合约函数执行成功或失败的结果。返回方式取决于是否指定回调函数。
调用成功 - 指定回调函数，则通过回调函数返回，否则返回一个resolve的Promise对象。
JsonObject包含以下字段：status-String: 表示合约函数执行状态，其值由调用时的expect决定；tx_hash-String: 合约函数的交易hash值。
调用失败 - 指定回调函数，则通过回调函数返回，否则返回一个reject的Promise对象。
JsonObject内容依具体错误形式返回。
示例¶
// use the promise
contractObj.methods.newGreeting('hello 1').submit({
Gas: 500000,
expect: "validate_success"
}).then(res => {
console.log(res);
}).catch(err => {
console.log(err);
});
// use the callback
contractObj.methods.newGreeting('hello 1').submit({
Gas: 500000,
expect: "validate_success"
},function (err, res) {
err ? console.error(err) : console.log(res);
});
>
{
status:"validate_success"
tx_hash:"F29FE3A0652162A480E591B92CB6982408FB4AFEB5BF645024D847E4218385BB"
}
读取合约内部状态调用¶
contractObj.methods.function([params1[, params2[, ...]]]).call([callback])
这种调用方式只是读取合约内部某个变量状态，非交易，不会对合约内部状态产生影响。function为合约的具体方法名。
参数说明¶
params-any: 合约本身function的参数值，依据合约方法的参数个数和类型进行传递；callback-Function: [可选]回调函数，如果指定，则通过指定回调函数返回结果，否则需要通过then和catch接收promise结果。
返回值¶
返回值由合约本身的函数规定的返回值个数及类型决定，个数为1时，直接返回该值，个数大于1时，构造为一个JsonObject返回。返回方式取决于是否指定回调函数。
调用成功时，指定回调函数，则通过回调函数返回，否则返回一个resolve的Promise对象；
调用失败时，指定回调函数，则通过回调函数返回，否则返回一个reject的Promise对象。依具体错误形式返回。
示例¶
// return only one value
contractObj.methods.greet().call((err, str) => {
err ? console.log("greet err:", err) : console.log(str);
});
>
hello 1
// return more than one value
contractObj.methods.getMultiGreeting().call((err, str) => {
err ? console.log("getMultiGreeting err:", err) : console.log(str);
});
>
{0: "hello 1", 1: "hello 1"}
合约fallback函数调用¶
chainsql.payToContract(contractAddr, contractValue, gas).submit(options)
当合约定义了fallback函数时，可通过payToContract接口直接向合约转账。如果未定义则调用出错。
参数说明¶
contractAddr-String: 接收转账的合约地址；contractValue-Number: 转账数额；gas-Number: 执行转账交易的手续费用；options-JsonObject: 指定交易执行到何种状态返回，默认为”send_success”, 具体可参考 交易expect。
返回值¶
Promise : 根据调用时的expect值，返回对应的执行状态。成功返回一个resolve的Promise对象，失败返回一个reject的Promise对象。
示例¶
const contractAddr = "zEyJTYupmFGo3tWCts8uyzmkkmjJAwgS2u";
chainsql.payToContract(contractAddr, 2000, 30000000).submit({
expect: "validate_success"
}).then(res => {
console.log(res);
}).catch(err => {
console.log(err);
});
>
{
status:"validate_success",
tx_hash:"92A7E277BB4229DAEC71A2D9D8C282FB307E328E8FC05C4BE29D20240A5F9E13"
}
获取合约函数编码值¶
contractObj.methods.function([params1[, params2, ...]]]).encodeABI()
将合约函数包括参数在内进行编码，得到contract data，或者称为inputdata。可以直接用于合约函数调用，或者在其他合约中作为参数传递，或者使用chainsql的rpc接口调用合约。
参数说明¶
params-any: 合约本身function的参数值，依据合约方法的参数个数和类型进行传递；
返回值¶
String : 进行合约调用时可以使用的函数编码值，contract data。
示例¶
let funInputData = contractObj.methods.greet().encodeABI();
console.log(funInputData);
> "0xcfae3217"
合约事件监听¶
contractObj.events.eventFunc([callback]);
参数说明¶
callback-Function: [可选]回调函数，如果指定，则通过指定回调函数返回结果，否则需要通过then和catch接收promise结果。
返回值¶
返回值包含合约事件指定的监听内容，返回方式由是否指定回调函数决定。
1. 正常监听：指定回调函数，则通过回调函数返回，否则返回一个resolve的Promise对象。具体返回内容包括：
JsonObject : 返回事件内容，具体包含以下字段：
ContractAddress-String: 合约地址；
event-String: 事件函数名称；
raw-JsonObject: 事件返回原始十六进制数据，包括data和topic两个字段；
returnValues-JsonObject: 按事件定义的返回值顺序以及返回值变量名，给出可读形式的返回值；
signature-String: 事件函数签名；
type-String: 类型，固定值为”contract_event”。
监听异常：指定回调函数，则通过回调函数返回，否则返回一个reject的Promise对象。依具体错误形式返回。
示例¶
contractObj.events.Modified((err, res) => {
err ? console.log(err) : console.log(JSON.stringify(res));
});
>
{
"ContractAddress": "zfKAaSvH5QLm25bn2VGv2fbYfuthFdVxeP",
"type": "contract_event",
"returnValues": {
"0": "0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c",
"1": "0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c",
"2": "hello 1",
"3": "hello 1",
"oldGreetingIdx": "0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c",
"newGreetingIdx": "0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c",
"oldGreeting": "hello 1",
"newGreeting": "hello 1"
},
"event": "Modified",
"signature": "0x047dcd1aa8b77b0b943642129c767533eeacd700c7c1eab092b8ce05d2b2faf5",
"raw": {
"data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000768656C6C6F203200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000768656C6C6F203200000000000000000000000000000000000000000000000000",
"topics": [
"0x047dcd1aa8b77b0b943642129c767533eeacd700c7c1eab092b8ce05d2b2faf5",
"0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c",
"0x67bc65b2694b00787b2c2fb7ac32f828b5c1f01c49107edabd382a1dc3a5f86c"
]
}
}
获取合约历史事件¶
contractObj.getPastEvent(txHashJson, callback);
参数说明¶
txHashJson-JsonObject: 要查询的合约交易哈希值，格式为{txHash:xxx}。callback-Function: 回调函数。
返回值¶
返回值包含合约事件指定的监听内容，返回方式通过回调函数返回结果。
1. 正常监听：指定回调函数，则通过回调函数返回，否则返回一个resolve的Promise对象。具体返回内容包括：
JsonObject : 返回事件内容，具体包含以下字段：
ContractAddress-String: 合约地址；
event-String: 事件函数名称；
raw-JsonObject: 事件返回原始十六进制数据，包括data和topic两个字段；
returnValues-JsonObject: 按事件定义的返回值顺序以及返回值变量名，给出可读形式的返回值；
signature-String: 事件函数签名；
type-String: 类型，固定值为”contract_event”。
监听异常：指定回调函数，则通过回调函数返回，否则返回一个reject的Promise对象。依具体错误形式返回。
示例¶
myContract.getPastEvent({txHash:"04DAE5FCF04DC8B5C471F2BCDF6FB2FA648244B5DF0110A630F32A68E46DF2CF"}, (err, data) =>{
err ? console.error(err) : console.log(JSON.stringify(data));
});
>
{
"Account":"zHb9CJAWyB4zj91VRWn96DkukG4bwdtyTh",
"ContractAddress":"zx1eNuwaP8YGygi1VPNaZP6ZAJhq3m31Kf",
"ContractData":"BDB483A70000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000B68656C6C6F20776F726C64000000000000000000000000000000000000000000",
"ContractOpType":2,
"ContractValue":"0",
"Fee":"12",
"Flags":2147483648,
"Gas":3000000,
"LastLedgerSequence":10,
"Sequence":2,
"SigningPubKey":"0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
"TransactionType":"Contract",
"TxnSignature":"304502210099642EC14FC938854A9C2A96620DCA54E436ECDBC3AF8540D542B34A88717A1002204763EA68643621F4D960EDADBE96910B180AE6620A2412CA54824263CE3B5E6C",
"date":680926182,
"hash":"04DAE5FCF04DC8B5C471F2BCDF6FB2FA648244B5DF0110A630F32A68E46DF2CF",
"inLedger":3,
"ledger_index":3,
"meta_chain":{
"ContractChain":{
"NextHash":"",
"PreviousHash":"180D1BE517E6D365831B42AA5791FF1765069D8A2BE78D591A9CCD81C9996D45"
}
},
"validated":true,
"ContractLogs":{
"showSM3Ret":{
"returnValues":{
"0":"zHb9CJAWyB4zj91VRWn96DkukG4bwdtyTh",
"1":"hello world",
"2":"0x44f0061e69fa6fdfc290c494654a05dc0c053da7e5c52b84ef93a9d67d3fff88",
"msgSender":"zHb9CJAWyB4zj91VRWn96DkukG4bwdtyTh",
"orgStr":"hello world",
"sm3Ret":"0x44f0061e69fa6fdfc290c494654a05dc0c053da7e5c52b84ef93a9d67d3fff88"
},
"event":"showSM3Ret",
"signature":"1CFD41687C0E896AA373DA0F3C85600D2EC4CA978520902116407F0C77EC495E",
"raw":{
"data":"000000000000000000000000B5F762798A53D543A014CAF8B297CFF8F2F937E8000000000000000000000000000000000000000000000000000000000000006044F0061E69FA6FDFC290C494654A05DC0C053DA7E5C52B84EF93A9D67D3FFF88000000000000000000000000000000000000000000000000000000000000000B68656C6C6F20776F726C64000000000000000000000000000000000000000000",
"topics":["1CFD41687C0E896AA373DA0F3C85600D2EC4CA978520902116407F0C77EC495E"]
}
}
}
}