事件类接口

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;
}