井通合约编写部署帮助文档

井通合约使用有两种方式:

1).通过合约使用网站:http://contract.jingtum.com。

2).使用井通api。

1 井通合约脚本规范

编写井通合约需遵循以下规范才可保证合约正确执行。
1.1 编写合约需使用lua语言 但是lua脚本不支持lua的io操作和lua模块的引用操作，以下类似操作在合约编写中是不合
法的:

1. print(‘hello’)
2. require("module")
   1.2 合约固定基本格式 1)合约以result={};语句开始。该table类型确保合约有正确的返回值类型。合约执行的结
   果通过该table返回，该table类型中包含两个值，布尔类型:result[‘state’]和字符串类型: result[‘res’]。result[‘state’]中存放合约执行状态，true表示合约执行成功，false表示合约执行 失败。result[‘res’]中存放合约执行结果或错误信息。当result[‘state’]为false时，存放错误信息， 当result[‘state’]为true时，存放合约执行的结果。
   2)所有合约函数的参数都是一个table类型。合约脚本中必须包含一个Init(t)函数。该函数 的作用是存储合约执行中需要的一些参数。具体参数由合约具体功能决定。

2 通过合约网站使用合约步骤 2.1 合约部署步骤

这里写图片描述

按上图的要求填写好字段后，点击部署合约按钮。如果部署成功会出现下面的界面:

这里写图片描述

如果部署失败上图会显示错误信息。部署成功后记录下合约账号，可以进行合约执行。
2.2 合约执行步骤

这里写图片描述

按照上图填写好参数后，点击执行合约按钮。执行成功会出现如下界面

这里写图片描述

如果执行失败上图会显示失败原因。

3 通过井通API使用合约方式 3.1 部署合约

接口:/v2/accounts/{:address}/contract/deploy，POST方法 接口参数:

这里写图片描述

POST需要提交的参数格式如下:

{
"secret": "snUaJxp2k4WFt5LCCtEx2zjThQhpT",
"amount": 10,
"params": ["jsqRs9BDCjyTuRWEPZk3yHa4MFmRi9D834"],
"payload": "result={}; function Init(t) result=scGetAccountInfo(t) return result end; function foo(t) a={} result=scGetAccountInfo(t) return result end"
}

例子:
http://localhost/v2/accounts/jsqRs9BDCjyTuRWEPZk3yHa4MFmRi9D834/contract/deploy
结果:

这里写图片描述

返回的结果信息:

这里写图片描述

3.2 调用合约 接口:/v2/accounts/{:address}/contract/call，POST方法
接口参数:

这里写图片描述

这里写图片描述

POST需要提交的参数格式如下:

{
"secret": "snUaJxp2k4WFt5LCCtEx2zjThQhpT",
"destination": "jKotgzRHyoa7dywd7vf6LgFBXnv3K66zEg",
"params":  ["jsqRs9BDCjyTuRWEPZk3yHa4MFmRi9D834"],
"foo": "foo"
}

例子:
http://localhost/v2/accounts/jsqRs9BDCjyTuRWEPZk3yHa4MFmRi9D834/contract/call
结果:

这里写图片描述

这里写图片描述

作为一个开发者，有一个学习的氛围跟一个交流的圈子特别重要，下面是我们的社区交流群，不管你是小白还是大牛欢迎入住，分享经验、讨论技术、社区开发。大家一起交流学习共同成长！希望开发者少走弯路。
1.社区开发者大赛 QQ 群：568285439
2.社区论坛：http://bbswtc.com
3.社区公众号：SWTC 互动社区、SWTC 社区
4.github：https://github.com/swtcpro