智能合约API提供合约与节点底层数据的交互接口

所有的接口函数都封装在mylib库中，调用采用Lua语言

---

WriteData

写脚本数据库

Prototype of function

mylib.WriteData(writeDbTbl)

Parameters

parameter	type
writeDbTbl	table

example

local writeDbTbl = {
    key = "config", --关键字
    length = 0, -- value数据流的总长
    value = {} --值
}

Returns

成功：执行成功；失败：nil

Example

function mylib_WriteData()
    local writeDbTbl = {
        key = "config", --关键字
        length = 0, -- value数据流的总长
        value = {} --值
    }

    addressTbl = {0x64,0x63,0x6D,0x43,0x62,0x4B,0x62,0x41,
    0x66,0x4B,0x72,0x6F,0x66,0x4E,0x7A,0x33,
    0x35,0x4D,0x53,0x46,0x75,0x70,0x78,0x72,
    0x78,0x34,0x55,0x77,0x6E,0x33,0x76,0x67,
    0x6A,0x4C}

    --每次限额,每日限额,企业登记的账户地址
    writeDbTbl.value = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x64,
    0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x2C,
    Unpack(addressTbl)}
    writeDbTbl.length = #writeDbTbl.value
    assert(mylib.WriteData(writeDbTbl),"WriteData err")
end

---

ReadData

根据指定的key读取脚本数据库中的记录

Prototype of function

mylib.ReadData(key)

Parameters

parameter	type
key	String

Returns

成功：返回value；失败：nil

Example

function mylib_ReadData()
    local key ="config"
    local readResult = {mylib.ReadData(key)}
    assert(#readResult > 0,"ReadData0 err")
    local i
    for i = 1,#readResult do
        print("",i,(readResult[i]))
    end
end

---

ModifyData

修改脚本数据库内容

Prototype of function

mylib.ModifyData(writeDbTbl)

Parameters

parameter	type
writeDbTbl	table

example

local writeDbTbl = {
    key = "config", --关键字
    length = 0, -- value数据流的总长
    value = {} --值
}

Returns

成功：True；失败：false

Example

function mylib_ModifyData()
    local writeDbTbl = {
        key = "config", --关键字
        length = 0, -- value数据流的总长
        value = {} --值
    }
    addressTbl = {0x64,0x63,0x6D,0x43,0x62,0x4B,0x62,0x41,
    0x66,0x4B,0x72,0x6F,0x66,0x4E,0x7A,0x33,
    0x35,0x4D,0x53,0x46,0x75,0x70,0x78,0x72,
    0x78,0x34,0x55,0x77,0x6E,0x33,0x76,0x67,
    0x6A,0x4C}

    --每次限额,每日限额,企业登记的账户地址
    writeDbTbl.value = {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x64,
    0x00,0x00,0x00,0x00,0x00,0x00,0x01,0x2C,
    Unpack(addressTbl)}
    writeDbTbl.length = #writeDbTbl.value
    writeDbTbl.value[8] = 200
    assert(mylib.ModifyData(writeDbTbl),"ModifyData err")
    print("ModifyData ok")
    readResult = {}
    readResult = {mylib.ReadData(writeDbTbl.key)}
    assert(#readResult > 0,"ReadData1 err")
    print("ReadData1 ok")
    for i = 1,#readResult do
        print("",i,(readResult[i]))
    end
end

---

LogPrint

输出日志信息

Prototype of function

mylib.LogPrint(LogTable)

Parameters

parameter	type
待保存的内容	table

example

local LogTable = {
    key = 0 , --日志类型:LOG_TYPE.ENUM_STRING/LOG_TYPE.ENUM_NUMBER
    length = 0, --value数据流的总长
    value = nil -- 字符串或数字流
}

Returns

• none

Example

function mylib_LogPrint()

    local LogTable = {
        key = 0 , --日志类型:LOG_TYPE.ENUM_STRING/LOG_TYPE.ENUM_NUMBER
        length = 0, --value数据流的总长
        value = nil -- 字符串或数字流
    }

    --保存字符串
    LogTable.length = 9
    LogTable.value = "lua start"
    mylib.LogPrint(LogTable)

    --保存数据流
    LogTable.key = LOG_TYPE.ENUM_NUMBER
    LogTable.length = 20
    local i
    for i = 1,20 do
        LogTable.value [i] = i
    end

    mylib.LogPrint(LogTable)
end

---

WriteOutput

操作系统账户,用于操作地址账户里的WICC

Prototype of function

mylib.WriteOutput(writeOutputTbl)

Parameters

parameter	type
writeOutputTbl	table

Returns

成功：True；

失败：False

Example

Refer to TransferToAddr

---

GetScriptID

获取智能合约脚本ID

Prototype of function

mylib.GetScriptID()

Parameters

• none

Returns

成功：返回6字节的脚本ID；失败：nil

Example

function mylib_GetScriptID()
    local result = {mylib.GetScriptID()}
    assert(#result > 0," GetScriptID err")
    for i = 1,#result do
        print("GetScriptID",i,(result[i]))
    end
end

---

GetCurTxAccount

获取当前交易账户

Prototype of function

mylib.GetCurTxAccount()

Parameters

• none

Returns

成功：返回账户信息；失败：nil

Example

function mylib_GetCurTxAccount()
    local i
    local result = {mylib.GetCurTxAccount()}
    assert(#result == 6," GetCurTxAccount err");
    for i = 1,#result do
        print("Account",i,(result[i]))
    end
end

---

GetCurTxInputAsset

获取当前交易转入合约的币种和金额

Prototype of function

mylib.GetCurTxInputAsset()

Parameters

• none

Returns

成功：返回 Table 数组

{
      symbol: (string)  币种symbol
      amount: (Int)   转账金额 ，单位 `sawi`
}

失败：nil

Example

function mylib_GetCurTxInputAsset()

    local CurTxInputAsset = mylib.GetCurTxInputAsset()
    print("symbol=",CurTxInputAsset.symbol)
    print("amount=",CurTxInputAsset.amount)
end

---

GetUserAppAccValue

获取指定账户的合约代币余额

Prototype of function

mylib.GetUserAppAccValue(idTbl)

Parameters

parameter	type
34字节base58地址	table

example

-- 用户id
local idTbl = {
    idLen = 0, --base58地址长度
    idValueTbl = {} --base58地址
}

Returns

成功：返回8字节长度的余额值，可用 mylib.ByteToInteger 方法转换为Nnmber类型的数额 失败：nil

Example

function mylib_GetUserAppAccValue()
    local idTbl = {
        idLen = 34, --base58地址长度
        idValueTbl = {0x77,0x68,0x4d,0x31,0x64,0x4c,0x6d,0x59,0x62,0x38,0x75,0x41,0x50,0x45,0x61,0x65,0x43,0x4d,0x46,0x4b,0x72,0x74,0x37,0x46,0x4a,0x57,0x46,0x4d,0x64,0x53,0x32,0x6a,0x4b,0x67} --base58地址
    }

    local i
    local money = { mylib.GetUserAppAccValue(idTbl) }
    assert(#money == 8," GetUserAppAccValue err");
    for i = 1,# money do
        print("money ",i,( money [i]))
    end
end

---

WriteOutAppOperate

操作系统应用账户,用于token的发行、转账、冻结等操作

Prototype of function

mylib.WriteOutAppOperate(app_operateTbl)

Parameters

parameter	type
app_operateTbl	table

example

local app_operateTbl = {
    operatorType = 0, --操作类型
    outHeight = 0, --超时高度
    moneyTbl = {}, --金额
    userIdLen = 0, --账户ID长度
    userIdTbl = {}, --账户ID
    fundTagLen = 0, --fund tag len
    fundTagTbl = {} --fund tag
}

Returns

成功：True；失败：false

Example

Refer to TransferToken

---

GetBase58Addr

根据regid获取base58地址

Prototype of function

mylib.GetBase58Addr(Unpack(accountTbl))

Parameters

parameter	type
accountTbl	table

example

--6字节的regid
local accountTbl = {5,157,0,0,7,34}

Returns

成功：base58地址；

失败：nil

Example

function mylib_GetBase58Addr()
    local accountTbl = {5,157,0,0,7,34} --6字节的regid
    local result = {mylib.GetBase58Addr(Unpack(accountTbl))}
    assert(#result == 34,"GetBase58Addr err")
end

---

ByteToInteger

将字节流转换成 Number类型

Prototype of function

mylib.ByteToInteger(Unpack(byteTbl))

Parameters

4字节流或8字节的字节流

Returns

成功：Number类型 失败：nil

Example

function mylib_ByteToInteger()
    local height = mylib.ByteToInteger(0xa0,0x05,0x00,0x00)
    assert(height > 0,"ByteToInteger error0")
    print("height=",height)
    local money = mylib.ByteToInteger(0x78,0x56,0x34,0x12,0x78,0x56,0x34,0x12)
    assert(money > 0,"ByteToInteger error1")
    print("money=",money)
end

---

IntegerToByte8

将 Number类型值转换成8字节类型

Prototype of function

mylib.IntegerToByte8(height)

Parameters

parameter	type
Interger	Number

Returns

成功：返回8个字节的字节流 失败：nil

Example

function mylib_IntegerToByte8()
    local money = 1311768465173141112
    local result = {mylib.IntegerToByte8(money)}
    assert(#result == 8,"IntegerToByte8 error0")
    for i = 1,#result do
        print("",i,(result[i]))
    end
end

---

VerifySignature

验证签名

Prototype of function

mylib.VerifySignature(sigTbl)

Parameters

parameter	type
待验证的内容	table

example

local sigTbl =
{
    dataLen =0, --原始数据长度
    data = {}, --原始数据
    pubKeyLen = 0, --签名公钥长度
    pubKey = {}, --签名公钥
    signatureLen = 0, --签名长度
    signature = {} --签名
}

Returns

true：验证成功，false：失败

Example

function mylib_VerifySignature()
    local sigTbl =
    {
        dataLen = 9,
        data = {0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39},
        pubKeyLen = 33,
        pubKey = {0x03, 0xee, 0xf7, 0xa3, 0x80, 0xbc, 0xf9, 0xcf, 0x97, 0x5d, 0x91, 0x6f, 0xda, 0xb1, 0x8d, 0x08, 0x1c, 0x9d, 0x55, 0xba, 0x43, 0x46, 0x54, 0x35, 0xa4, 0xd1, 0xcc, 0x59, 0x86, 0x10, 0xa4, 0x44, 0x79},
        signatureLen = 32,
        signature = {0x24, 0x4f, 0xa7, 0xcf, 0x97, 0xae, 0x15, 0x85, 0xd8, 0xf8, 0x02, 0x4b, 0xa1, 0x8b, 0x8a, 0xbe, 0xce, 0x8e, 0xb9, 0xcd, 0x4d, 0x01, 0x6d, 0xd0, 0xba, 0x8c, 0xc0, 0xdc, 0x85, 0x1a, 0x9c, 0x0e}
    }

    local ret = mylib.VerifySignature(sigTbl)
    if ret then
        LogMsg("VerifySignature ok!")
    else
        LogMsg("VerifySignature bad!")
    end
end

---

QueryAccountBalance

获取账户的WICC余额

Prototype of function

mylib.QueryAccountBalance(Unpack(accountTbl))

Parameters

accountTbl: 34字节的账户地址

Returns

成功：返回8字节余额,单位为 sawi, 可以使用mylib.ByteToInteger方法返回Number类型的数据

失败：nil

Example

function mylib_QueryAccountBalance()
    local accountTbl = {0x77,0x4c,0x4b,0x66,0x32,0x4e,0x71,0x77,0x74,0x48,0x6b,0x33,0x42,0x66,0x7a,0x4b,0x35,0x77,
        0x4d,0x44,0x66,0x62,0x4b,0x59,0x4e,0x31,0x53,0x43,0x33,0x77,0x65,0x79,0x52,0x34}

    local result = {mylib.QueryAccountBalance(Unpack(accountTbl))}
    assert(#result == 8,"QueryAccountBalance err");
end

---

GetCurTxHash

获取当前交易hash

Prototype of function

mylib.GetCurTxHash()

Parameters

• none

Returns

return	type	example	destination
hashTbl	table	{0x46,0x78,0xd3,0xc5,0x4c,0xaf,0x3b,0xd7,0xaf,0x59,0x1d, 0xb4,0x85,0x21,0xf9,0xb1,0xf6,0x98,0x12,0x90,0x9c,0x56,0x19, 0xba,0x7a,0x46,0x22,0x6b,0xb7,0x2b,0x61,0xd0}	success
nil			failed

Example

function mylib_GetCurTxHash()
    local result = {mylib.GetCurTxHash()}
    assert(#result == 32,"GetCurTxHash err");
end

---

GetTxConFirmHeight

根据交易哈希获取交易确认高度

Prototype of function

mylib.GetTxConfirmHeight(Unpack(txhashTbl))

Parameters

parameter	type
交易哈希	table

Returns

return	type	example	destination
height	Number	1234.0	success
nil			failed

Example

function mylib_GetTxConfirmHeight()
    -- "hash" :"4a2af2d83683325e780f2b859e7421f4592e3105d01017aab45c15da3910be8e"
    local txhashTbl = {0x4a,0x2a,0xf2,0xd8,0x36,0x83,0x32,0x5e,
    0x78,0x0f,0x2b,0x85,0x9e,0x74,0x21,0xf4,
    0x59,0x2e,0x31,0x05,0xd0,0x10,0x17,0xaa,
    0xb4,0x5c,0x15,0xda,0x39,0x10,0xbe,0x8e}
    local result = mylib.GetTxConfirmHeight(Unpack(txhashTbl))
    assert(result > 0,"GetTxConfirmHeight err");
end

---

GetBlockHash

根据区块高度获取区块哈希

Prototype of function

mylib.GetBlockHash(height)

Parameters

parameter	type
区块高度	Number

Returns

return	type	example	destination
height	table	{0x46,0x78,0xd3,0xc5,0x4c,0xaf,0x3b,0xd7,0xaf, 0x59,0x1d,0xb4,0x85,0x21,0xf9,0xb1,0xf6, 0x98,0x12,0x90,0x9c,0x56,0x19,0xba,0x7a, 0x46,0x22,0x6b,0xb7,0x2b,0x61,0xd0}	success
nil			failed

Example

function mylib_GetBlockHash()
    local height = 47037
    local result = {mylib.GetBlockHash(height)}
    assert(#result == 32,"GetBlockHash err");
end

---

GetBlockTimestamp

获取块的时间戳

Prototype of function

mylib.GetBlockTimestamp(height)

Parameters

height if < =0 ,则实际查询高度为最新区块高度 - 传入参数的绝对值；

height if > 0 实际查询高度 = 传入参数

Returns

成功：unix时间戳；

失败：nil

Example

function mylib_GetBlockTimestamp()
    local ts = mylib.GetBlockTimestamp(0)
    assert(ts ~= nil,"ts is nil")
    str = string.format("0:%d", ts)
    LogMsg(str)
    ts = mylib.GetBlockTimestamp(100)
    assert(ts ~= nil,"ts is nil")
    str = string.format("100:%d", ts)
    LogMsg(str)
    ts = mylib.GetBlockTimestamp(-100)
    assert(ts ~= nil,"ts is nil")
    str = string.format("-100:%d", ts)
    LogMsg(str)
end

---

公链2.0新增合约API

---

GetCurTxInputAsset

获取调用合约时所用的资产币种和传入金额

Prototype of function

mylib.GetCurTxInputAsset()

Parameters

none

Returns

成功：

{
    symbol: (string), 币种符号, 支持但不限于`WICC`、`WUSD`、`WGRT`中的一种
    amount: (number), 传入的币种对应金额, 单位 `sawi`
}

失败：nil

Example

function mylib_GetCurTxInputAsset()
    LogMsg("symbol:"..mylib.GetCurTxInputAsset().symbol)
    LogMsg("amount:"..mylib.GetCurTxInputAsset().amount.." sawi.") 
end