# 合约API函数
使用全局函数transfer_from_contract_to_address可以从当前合约(这个函数调用代码所在的合约)转账一定数额的某种资产给某个地址,第一个参数是目标地址(字符串),第二个参数是资产名称(比如HSR),第三个参数是转账数量的10万倍(int64类型),要求是正数
返回值 0 转账成功 -1 未知系统异常 -2 Asset_symbol异常 -3 合约地址非法 -4 目标地址非法 -5 账户余额不足支付转账金额 -6 转账金额为负数
使用全局函数get_contract_balance_amount可以获取某个合约带精度的余额(精度为100000),第一个参数是合约地址(支持查询其他合约的余额),第二个参数是资产名称(比如HSR),返回带精度的合约余额(int64类型),如果出现错误或者合约不存在返回负数
返回值 非负数 合约账户余额 -1 资产id异常 -2 合约地址异常
使用全局函数get_chain_now可以获取链上的当前时间,没有参数.
返回值 正数 时间戳整数 0 系统异常
使用全局函数get_chain_random可以获取链上的一个伪随机数字,但是同一个此链上的operation操作,不同节点不同时间执行返回结果都一样(实际是取操作发生的块上prev_secret_hash和本交易结合后的哈希)
返回值 随机结果
使用全局函数get_header_block_num,可以获取上一个块的块号
返回值 当前链最新块的序号
使用全局函数get_waited(num),表示根据未来块的数据获取伪随机数,num是未来块的块号(但是未来需要再次调用,那个时候第num块已经是过去的块了就能知道结果了)
返回值 正整数 结果值 -1 目标块未到 -2 设定的目标块不大于1
使用全局函数get_current_contract_address可以获取这个函数调用出现位置的合约地址,没有参数
全局变量caller存储着调用合约的用户的公钥,全局变量caller_address存储着调用合约的用户的账户地址
在转账到合约发生的时候,如果合约中定义了on_deposit_asset(参数是"资产标识,转账金额")这个API,那么在转账发生后会调用这个API,并且保证转账和触发此API是原子性的,如果中途出现错误,整体回滚,转账失败。
使用语句emit EventName(arg: string)可以抛出事件,这里emit是关键字,EventName根据需要写入事件名称,由区块链记录下来,其他节点同步到emit触发的event时可以调用本地设置的回调
使用全局函数 is_valid_address(arg: string)可以检查一个地址字符串是否是合法的本区块链地址
使用全局函数 is_valid_contract_address(arg: string)可以检查一个地址字符串是否是合法的合约地址
使用全局函数get_transaction_fee() 可以获取一笔交易的手续费
返回值 正整数 结果值 -1 手续费资产id异常 -2 系统异常
使用全局函数get_transaction_id(): string 可以获取本次交易的交易id
使用全局函数transfer_from_contract_to_public_account(to_account_name: string, asset_type: string, amount: int)可以从当前合约中转账到链上的账户名称,返回是否转账的状态
返回值 0 转账成功 -1 未知系统异常 -2 Asset_symbol异常 -3 合约地址非法 -4 目标地址非法 -5 账户余额不足支付转账金额 -6 转账金额为负数 -7 不存在指定账户名
import_contract: (string) => table 引用合约,参数是合约的名称字符串,返回合约对应的table
import_contract_from_address: (string) => table 根据合约地址引用合约,返回合约对应的table
get_prev_call_frame_contract_address: () => string 获取合约调用栈的上一级合约地址(如果上一级合约调用栈不是合约,则返回nil)
get_prev_call_frame_api_name: () => string 获取合约调用栈的上一级合约API名称(如果上一级合约调用栈不是合约,则返回nil)
get_contract_call_frame_stack_size: () => int 获取合约调用栈深度
wait_for_future_random: (int) => int 根据参数的块高度获取根据这个块数据得到的伪随机数,如果这个块高度还没有达到,则返回0
get_system_asset_symbol: () => string 获取系统基础资产的资产符号
get_system_asset_precision: () => int 获取系统基础资产的精度,这个值一般是10的若干次方
hex_to_bytes: (string) => table 把16进制字符串转成字节数组
bytes_to_hex: (table) => string 把字节数组转成16进制字符串
sha1_hex: (string) => string 对参数的16进制字符串转换得到的字节数组进行sha1操作然后转成16进制字符串返回
sha3_hex: (string) => string 对参数的16进制字符串转换得到的字节数组进行sha3-256操作然后转成16进制字符串返回
sha256_hex: (string) => string 对参数的16进制字符串转换得到的字节数组进行sha256操作然后转成16进制字符串返回
ripemd160_hex: (string) => string 对参数的16进制字符串转换得到的字节数组进行ripemd160操作然后转成16进制字符串返回
cbor_encode: (object) => string 把参数按cbor序列化方式序列化成二进制字节数组,并以16进制字符串的形式返回
cbor_decode: (string) => object 把16进制字符串对应的二进制字节数组按cbor序列化方式来反序列化成glua对象
signature_recover: (string, string) => string 从第一个参数的签名(压缩签名格式,65字节,以16进制字符串表示)和第二个参数的原文摘要(32字节,以16进制字符串表示)