def contentStorage(title: str, key: str, content: bytes, value: str,
op: int) -> tx.Transaction:
"""
contentStorage 构建明文存证交易，返回Transaction类对象实例
:param title: 链名前缀，比如user.p.huobi. (主链填空字符串即可）
:param key: 唯一标识，后面可以根据key来查询存证内容，如果不填则默认以txhash作为key
:param content: 存证内容,（注意 content和value只能二选一，不可同时填写，要么选择bytes类型存储，要么选择str类型存储）
:param value: 存证内容（注意 content和value只能二选一，不可同时填写，要么选择bytes类型存储，要么选择str类型存储）
:param op: 0表示创建 1表示追加add
:return:
"""
if op != 0 and op != 1:
raise ValueError("Error: op is not correct.")
v = storage_pb2.ContentOnlyNotaryStorage()
v.key = key
v.value = value
v.op = op
action = storage_pb2.StorageAction(contentStorage=v)
action.ty = 1
execer = title + "storage"
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def encryptStorage(title: str, key: str, contentHash: bytes,
encryptContent: bytes, nonce: bytes,
value: str) -> tx.Transaction:
"""
encryptStorage 构建加密存证交易，返回Transaction类对象实例
:param title: 链名前缀，比如user.p.huobi. (主链填空字符串即可）
:param key: 唯一标识，后面可以根据key来查询存证内容，如果不填则默认以txhash作为key
:param contentHash: 存证明文hash
:param encryptContent: 密文
:param nonce: 加密iv，通过AES进行加密时制定随机生成的iv,解密时需要使用该值
:param value: 备注
:return:
"""
v = storage_pb2.EncryptNotaryStorage()
v.key = key
v.value = value
v.contentHash = contentHash
v.encryptContent = encryptContent
v.nonce = nonce
action = storage_pb2.StorageAction(encryptStorage=v)
action.ty = 4
execer = title + "storage"
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def transferToExec(title: str, amount: int, execName: str,
note: str) -> tx.Transaction:
"""
transferToExec 将coins执行器下面的代币转移到其他执行器下面
:param title: 平行链链名前缀 比如user.p.huobi.
:param amount: 转账金额
:param execName: 合约名称
:param note: 备注
:return: tx.Transaction
"""
transfer = tx_pb2.AssetsTransferToExec()
transfer.amount = amount
transfer.note = bytes(note, encoding='utf-8')
transfer.execName = execName
transfer.to = address.getExecAddress(execName)
action = tx_pb2.CoinsAction(transferToExec=transfer)
action.ty = 10
execer = title + "coins"
to = transfer.to
if title != "":
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def withdraw(title: str, amount: int, execName: str,
note: str) -> tx.Transaction:
"""
构造提款交易，将其他执行器下面coins代币提回到coins执行器下面
:param title: 平行链链名前缀 比如user.p.huobi.
:param amount: 提款金额
:param execName: 合约名称
:param note: 备注
:return: tx.Transaction
"""
withdraw = tx_pb2.AssetsWithdraw()
withdraw.amount = amount
withdraw.note = bytes(note, encoding='utf-8')
withdraw.execName = execName
withdraw.to = address.getExecAddress(execName)
action = tx_pb2.CoinsAction(withdraw=withdraw)
action.ty = 3
execer = title + "coins"
to = withdraw.to
if title != "":
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def linkStorage(title: str, key: str, link: bytes,
value: str) -> tx.Transaction:
"""
linkStorage 构建链接存证交易，返回Transaction类对象实例
:param title: 链名前缀，比如user.p.huobi. (主链填空字符串即可）
:param key: 唯一标识，后面可以根据key来查询存证内容，如果不填则默认以txhash作为key
:param link: 存证内容
:param value: 备注
:return:
"""
v = storage_pb2.LinkNotaryStorage()
v.key = key
v.value = value
v.link = link
action = storage_pb2.StorageAction(linkStorage=v)
action.ty = 3
execer = title + "storage"
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def hashStorage(title: str, key: str, hash: bytes,
value: str) -> tx.Transaction:
"""
hashStorage 构建哈希存证交易，返回Transaction类对象实例
:param title: 链名前缀，比如user.p.huobi. (主链填空字符串即可）
:param key: 唯一标识，后面可以根据key来查询存证内容，如果不填则默认以txhash作为key
:param hash: 存证内容
:param value: 存证内容,用户可以先将Hash值 str
:return:
"""
v = storage_pb2.HashOnlyNotaryStorage()
v.key = key
v.value = value
v.hash = hash
action = storage_pb2.StorageAction(hashStorage=v)
action.ty = 2
execer = title + "storage"
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def createManage(title: str, key: str, value: str, op: str,
addr: str) -> tx.Transaction:
"""
createManage 构造管理合约配置交易
:param title: 平行链链名前缀 比如user.p.huobi.
:param key: 类型
:param value: 具体值
:param op: 操作符，add,delete
:param addr: 替换之前addr的值，具有唯一性，这个值不会增加或者删除，始终只有一个
:return: tx.Transaction
"""
modify = manage_pb2.ModifyConfig()
modify.key = key
modify.value = value
modify.op = op
modify.addr = addr
action = manage_pb2.ManageAction(modify=modify)
action.ty = 0
execer = title + "manage"
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)
def transfer(title: str, amount: int, toAddr: str,
note: str) -> tx.Transaction:
"""
transfer 构造普通转账交易
:param title: 平行链链名前缀 比如user.p.huobi.
:param amount: 转账金额
:param toAddr: 收款地址
:param note: 备注
:return: tx.Transaction
"""
transfer = tx_pb2.AssetsTransfer()
transfer.amount = amount
transfer.note = bytes(note, encoding='utf-8')
transfer.to = toAddr
action = tx_pb2.CoinsAction(transfer=transfer)
action.ty = 1
execer = title + "coins"
to = toAddr
if title != "":
to = address.getExecAddress(execer)
return tx.CreateTransaction(execer=bytes(execer, encoding='utf-8'),
payload=action.SerializeToString(),
expire=0,
to=to)