事件类接口
1. 转账事件
1.1 创建转账事件
- 接口全称:
trTransferAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trTransferAsset
- 请求参数:
interface TrTransferAsset extends TrCommonParam {
/**转移的权益数量,0-9 组成并且不包含小数点,必须大于 0 */
amount: string;
/**转移的权益类型,大写字母组成,3-5 个字符 */
assetType?: string;
/**转移的权益所属链名,小写字母组成,3-8 位 */
sourceChainName?: string;
/**转移的权益所属链网络标识符,大写字母或数字组成,5 个字符,最后一位是校验位 */
sourceChainMagic?: string;
/**事件的接收账户地址,base58 编码的 16 进制字符串 */
recipientId: string;
}
- 返回参数:
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string
}
}
1.2 创建转账事件(带安全密钥)
- 接口全称:
trTransferAssetWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trTransferAssetWithSign
- 请求参数:
interface TrTransferAssetWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 TrTransferAsset 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string
}
}
1.3 发送转账事件
- 接口全称:
transferAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/transferAsset
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrTransferAsset {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
2. 设置安全密码事件
2.1 创建设置安全密码事件
- 接口全称:
trSignature
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trSignature
- 请求参数:
interface TrSignature extends TrCommonParam {
/**新的安全密码 */
newSecondSecret: string;
}
- 返回参数:
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
2.2 创建设置安全密码事件(带安全密钥)
- 接口全称:
trSignatureWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trSignatureWithSign
- 请求参数:
interface TrSignatureWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trSignature 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
2.3 发送设置安全密码事件
- 接口全称:
signature
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/trSignature
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrSignature {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
3. 设置用户名事件
3.1 创建设置用户名事件
- 接口全称:
trUsername
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trUsername
- 请求参数:
interface TrUsername extends TrCommonParam {
/**用户名字符串,大小写字母、数字、下划线组成,1-20 个字符,不能包含当前链的名称 */
alias: string;
}
- 返回参数:
interface TrUsername {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
3.2 创建设置用户名事件(带安全密钥)
- 接口全称:
trUsernameWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trUsernameWithSign
- 请求参数:
interface TrUsernameWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trUsername 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrUsername {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
3.3 发送设置用户名事件
- 接口全称:
username
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/username
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrUsername {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
4. 注册受托人事件
4.1 创建注册受托人事件
- 接口全称:
trDelegate
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDelegate
- 请求参数:
interface TrDelegate extends TrCommonParam {
}
- 返回参数:
interface TrDelegate {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
4.2 创建注册受托人事件(带安全密钥)
- 接口全称:
trDelegateWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDelegateWithSign
- 请求参数:
interface TrDelegateWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trDelegate 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface SendTrDelegate {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
4.3 发送注册受托人事件
- 接口全称:
delegate
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/delegate
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface Delegate {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
5. 接收投票事件
5.1 创建接收投票事件
- 接口全称:
trAcceptVote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trAcceptVote
- 请求参数:
interface TrAcceptVote extends TrCommonParam {
}
- 返回参数:
interface TrAcceptVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
5.2 创建接收投票事件(带安全密钥)
- 接口全称:
trAcceptVoteWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trAcceptVoteWithSign
- 请求参数:
interface TrAcceptVoteWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trAcceptVote 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrAcceptVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
5.3 发送接收投票事件
- 接口全称:
acceptVote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/acceptVote
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrAcceptVote {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
6. 拒绝投票事件
6.1 创建拒绝投票事件
- 接口全称:
trRejectVote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trRejectVote
- 请求参数:
interface TrRejectVote extends TrCommonParam {
}
- 返回参数:
interface TrRejectVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
6.2 创建拒绝投票事件(带安全密钥)
- 接口全称:
trRejectVoteWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trRejectVoteWithSign
- 请求参数:
interface TrRejectVoteWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trRejectVote 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrRejectVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
6.3 发送拒绝投票事件
- 接口全称:
rejectVote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/rejectVote
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrRejectVote {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
7. 投票事件
7.1 创建投票事件
- 接口全称:
trVote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trVote
- 请求参数:
interface TrVote extends TrCommonParam {
/**投出的权益数,0-9 组成并且不包含小数点,允许为 0 */
equity: string;
/**事件的接收账户地址,base58 编码的 16 进制字符串 */
recipientId: string;
}
- 返回参数:
interface TrVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
7.2 创建投票事件(带安全密钥)
- 接口全称:
trVoteWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trVoteWithSign
- 请求参数:
interface TrVoteWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trVote 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
- 返回参数:
interface TrVote {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer */
buffer: Buffer
}
}
7.3 发送接收投票事件
- 接口全称:
vote
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/vote
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: Buffer;
/**交易的签名 */
signature: string;
/**交易的安全签名 */
signSignature?: string;
}
- 返回参数:
interface SendTrVote {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
8. 发行 dapp 事件
8.1 创建发行 dapp 事件
- 接口全称:
trDapp
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDapp
- 请求参数:
interface TrDapp extends TrCommonParam {
/**不包含校验位的 dappid, 大写字母或数字组成, 7 个字符 */
newDappid: string;
/**dappid 的类型,只能为 0 或 1,0 表示这个 dappid 是付费使用的,1 表示这个 dappid 是免费使用的 */
type: number;
/**购买 dappid 使用权需要的权益数量(如果 dappid 是付费应用则必须携带,如果是免费应用则无需携带),0-9 组成并且不包含小数点,必须大于 0 */
amount: string;
/**事件的接收账户地址,base58 编码的 16 进制字符串 */
recipientId?: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
8.2 创建发行 dapp 事件(带安全密钥)
- 接口全称:
trDappWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDappWithSign
- 请求参数:
interface TrDappWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trDapp 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
8.3 发送发行 dapp 事件
- 接口全称:
dapp
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/dapp
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface Dapp {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
/**完整的发行 dapp 事件 */
result: BFChainCore.TransactionJSON;
}
9. dapp 购买事件
9.1 创建 dapp 购买事件
- 接口全称:
trDappPurchasing
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDappPurchasing
- 请求参数:
interface TrDappPurchasing extends TrCommonParam {
/**事件的接收账户地址,base58 编码的 16 进制字符串 */
recipientId: string;
/**存证所属的 dappid,大写字母获取数组组成,8 个字符 */
dappid: string;
/**dappid 的类型,只能是 0 或 1,0 表示 dappid 是付费类型的,1 表示 dappid 是 免费类型的 */
type: number;
/**购买 dappid 花费的权益数 */
purchaseAsset: number;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
9.2 创建 dapp 购买事件(带安全密钥)
- 接口全称:
trDappPurchasingWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDappPurchasingWithSign
- 请求参数:
interface TrDappPurchasingWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trDappPurchasing 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
9.3 发送 dapp 购买事件
- 接口全称:
dappPurchasing
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/dappPurchasing
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface SendTrDappPurchasing {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
/**完整的 dappPurchasing 事件 */
result: BFChainCore.TransactionJSON;
}
10. 存证事件
10.1 创建存证事件
- 接口全称:
trMark
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trMark
- 请求参数:
interface TrMark extends TrCommonParam {
/**存证内容,为任意字符串 */
content: string;
/**存证类型,为任意字符串,用于区别存证 */
action: string;
/**存证所属的 dappid,大写字母获取数组组成,8 个字符 */
dappid: string;
/**dappid 的类型,只能是 0 或 1,0 表示 dappid 是付费类型的,1 表示 dappid 是 免费类型的 */
type: number;
/**购买 dappid 花费的权益数 */
purchaseAsset?: number;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
10.2 创建存证事件(带安全密钥)
- 接口全称:
trMarkWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trMarkWithSign
- 请求参数:
interface TrMarkWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trMark 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
10.3 发送存证事件
- 接口全称:
mark
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/mark
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface SendTrMark {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
/**完整的 mark 事件 */
result: BFChainCore.TransactionJSON;
}
11. 权益发行事件
11.1 创建权益发行事件
- 接口全称:
trIssueAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trIssueAsset
- 请求参数:
interface TrIssueAsset extends TrCommonParam{
/**发行的权益名,大写字母组成,3-5 个字符 */
assetType: string;
/**发行的新权益总数,权益数量由0-9共十个数字组成,权益数量不包含小数点且必须大于0 */
expectedIssuedAssets: string;
/**新权益的创世账户地址, base58 编码的 16 进制字符串, 该地址必须给本事件的发起账户转过本链的主权益 */
recipientId: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
11.2 创建权益发行事件(带安全密钥)
- 接口全称:
trIssueAssetWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trIssueAssetWithSign
- 请求参数:
interface TrIssueAssetWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trMark 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
11.3 发送权益发行事件
- 接口全称:
issueAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/issueAsset
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface TrIssueAsset {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
12. 权益销毁事件
12.1 创建权益销毁事件
- 接口全称:
trDestroyAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDestroyAsset
- 请求参数:
interface TrDestroyAsset extends TrCommonParam{
/**销毁的权益数,0-9 组成并且不包含小数点,必须大于 0 */
amount: string;
/**销毁的权益名,大写字母组成,3-5 个字符 */
assetType: string;
/**权益的发行账户地址, base58 编码的 16 进制字符串 */
recipientId: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
12.2 创建权益销毁事件(带安全密钥)
- 接口全称:
trDestroyAssetWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trDestroyAssetWithSign
- 请求参数:
interface TrDestroyAssetWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trMark 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
12.3 发送权益销毁事件
- 接口全称:
destroyAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/destroyAsset
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface TrDestroyAsset {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
13. 权益交换事件
13.1 创建权益交换事件
- 接口全称:
trToExchangeAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trToExchangeAsset
- 请求参数:
interface TrToExchangeAsset extends TrCommonParam{
/**用于交换的权益来源链网络标识符,大写字母或数字组成,5 个字符,最后一位是校验位 */
toExchangeSource: string;
/**被交换的权益来源链网络标识符,大写字母或数字组成,5 个字符,最后一位是校验位 */
beExchangeSource: string;
/**用于交换的权益来源链名,小写字母组成,3-8 位 */
toExchangeChainName: string;
/**被交换的权益来源链名,小写字母组成,3-8 位 */
beExchangeChainName: string;
/**用于交换的权益名,大写字母组成,3-5 个字符 */
toExchangeAsset: string;
/**被交换的权益名,大写字母组成,3-5 个字符 */
beExchangeAsset: string;
/**用于交换的权益数量,0-9 组成并且不包含小数点,必须大于 0 */
toExchangeNumber: string;
/**用作与权益的交换比例的分母,为正整数。被交换权益=交换权益*交换比例 */
prevWeight: string;
/**用作与权益的交换比例的分子,为正整数。被交换权益=交换权益*交换比例 */
nextWeight: string;
/**加密密钥组,如果填写了密钥,则接收权益交换的事件必须携带某个密钥生成的签名对 */
ciphertexts?: string[];
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
13.2 创建权益交换事件(带安全密钥)
- 接口全称:
trToExchangeAssetWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trToExchangeAssetWithSign
- 请求参数:
interface TrToExchangeAssetWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trMark 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
13.3 发送权益交换事件
- 接口全称:
trToExchangeAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/trToExchangeAsset
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface TrToExchangeAsset {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}
14. 接受权益交换事件
14.1 创建接受权益交换事件
- 接口全称:
trBeExchangeAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trBeExchangeAsset
- 请求参数:
interface TrBeExchangeAsset extends TrCommonParam{
/**to 事件的签名,128 个字节的 16 进制字符串 */
transactionSignature: string;
/**用于交换的权益数量,权益数量由0-9共十个数字组成,权益数量不包含小数点且必须大于0 */
beExchangeNumber: string;
/**交换得到的权益数量,权益数量由0-9共十个数字组成,权益数量不包含小数点且必须大于0 */
toExchangeNumber: string;
/**加密密钥,如果权益交换事件填写了加密密钥,则必须携带某个权益交换事件指定密钥以生成密钥签名对 */
ciphertext?: string;
/**to 事件的发起账户地址,base58 编码的 16 进制字符串 */
recipientId: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
14.2 创建接受权益交换事件(带安全密钥)
- 接口全称:
trBeExchangeAssetWithSign
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/trBeExchangeAssetWithSign
- 请求参数:
interface TrBeExchangeAssetWithSign {
/**不包含 signature 的事件体生成的 buffer,通过 trMark 生成 */
buffer: string;
/**事件签名 */
signature: string;
}
interface TrCommonParamResponse {
/**是否成功 */
success: boolean;
result: {
/** 需要签名的buffer, 转为base64的string字符串 */
buffer: string;
};
}
14.3 发送接受权益交换事件
- 接口全称:
destroyAsset
- 可调用方式:
Http,Websocket,命令行
- 调用方法:
post
- 接口
url
地址:/api/transaction/send/destroyAsset
- 请求参数:
interface SendTrCommonParam {
/**需要签名的buffer, 转为base64的string字符串 */
buffer: string;
/**事件的签名 */
signature: string;
/**事件的安全签名 */
signSignature?: string;
}
interface TrBeExchangeAsset {
/**是否成功 */
success: boolean;
/**最小手续费 */
minFee: number;
result: BFChainCore.TransactionJSON;
}