债券市场模型
区块链应用构建器的增强版本包括一个模型属性,该属性为债券市场方案生成其他方法。
如果您在使用扩展 ERC-1155 标准的令牌的规范文件中包括 model: bond 参数,则 Blockchain App Builder 应用程序特定的链代码,包括用于债券市场应用程序的以下附加方法。
TypeScript 债券市场的方法
债券市场链代码包括通用 ERC-1155 NFT 链代码中可用的所有方法。提供了以下特定于债券市场方案的其他方法。-
postToken - 此方法只能由令牌创建者调用。该方法提交债券令牌以在市场中列出。创建令牌时,其状态最初设置为
created。此方法将状态更新为posted。用户可以运行getAllTokensWithFilter方法来检索状态为posted的所有 NFT。 -
purchaseToken - 任何账户持有人都可以调用此方法来购买列出的债券 NFT。采购将债券 NFT 从创建者的帐户转移到调用者的帐户,并将 CBDC 令牌从调用者的帐户转移到创建者的帐户。因此,该方法必须在原子事务的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId来调用相应的 CBDC 链代码以进行传输。orgId和userId必须对应于令牌创建者,CBDC 令牌传输值必须等于债券令牌的面值乘以所购买的数量。 -
payInterest - 此方法只能由令牌创建者或管理员调用,以支付债券令牌上获得的利息。仅当令牌的利息频率为每月、每季度或每年时,才能调用此方法。如果利息频率已到期,则无法支付利息。利息由链代码根据令牌的息票利率计算。采购操作将 CBDC 令牌从呼叫者的帐户转移到债券所有者的帐户。因此,此方法必须在原子事务处理的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须对应于令牌所有者,并且 CBDC 令牌传输值必须等于债券链代码计算的利息。 -
requestTokenRedemption - 只有令牌所有者才能调用此方法,以便在到期后发出赎回债券令牌的请求。此方法还涉及链代码计算赎回价格。只能对用户拥有的债券令牌的全部数量提出赎回请求。用户可以根据不同的结算 ID 提出多个兑换请求,但令牌创建者只能批准一个兑换请求。
-
approveTokenRedemption - 只有令牌创建者才能调用此方法来批准赎回债券令牌的请求。审批操作将债券 NFT 从所有者帐户(提出请求的用户)转移到创建者的帐户,并将 CBDC 令牌从债券创建者的帐户转移到所有者帐户。因此,此方法必须在原子事务的上下文中执行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须与提出兑换请求的令牌所有者的帐户相对应,并且 CBDC 令牌传输值必须等于在提出兑换请求时链代码计算的计算兑换价格。 -
rejectRedemption - 令牌创建者可以调用此方法以拒绝兑换请求。令牌所有者可以使用其他结算 ID 再次提出赎回请求。
-
getAllTokensWithFilters - 管理员可以调用此 get 方法来提取按状态(
CREATED或POSTED)筛选的所有令牌。 -
getTokenApprovalRequestByUser - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
getTokenApprovalRequestForUserByStatus - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
getAccountBondSummary - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。
-
getAccountBondSummaryWithPagination - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。此方法可以根据页面大小和书签值使用分页返回结果,还可以按开始时间和结束时间进行筛选。
债券市场的 Go 方法
债券市场链代码包括通用 ERC-1155 NFT 链代码中可用的所有方法。提供了以下特定于债券市场方案的其他方法。-
PostToken - 此方法只能由令牌创建者调用。该方法提交债券令牌以在市场中列出。创建令牌时,其状态最初设置为
created。此方法将状态更新为posted。用户可以运行getAllTokensWithFilter方法来检索状态为posted的所有 NFT。 -
PurchaseToken - 任何账户持有人都可以调用此方法来购买列出的债券 NFT。采购将债券 NFT 从创建者的帐户转移到调用者的帐户,并将 CBDC 令牌从调用者的帐户转移到创建者的帐户。因此,该方法必须在原子事务的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId来调用相应的 CBDC 链代码以进行传输。orgId和userId必须对应于令牌创建者,CBDC 令牌传输值必须等于债券令牌的面值乘以所购买的数量。 -
PayInterest - 此方法只能由令牌创建者或管理员调用,以支付债券令牌上获得的利息。仅当令牌的利息频率为每月、每季度或每年时,才能调用此方法。如果利息频率已到期,则无法支付利息。利息由链代码根据令牌的息票利率计算。采购操作将 CBDC 令牌从呼叫者的帐户转移到债券所有者的帐户。因此,此方法必须在原子事务处理的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须对应于令牌所有者,并且 CBDC 令牌传输值必须等于债券链代码计算的利息。 -
RequestTokenRedemption - 只有令牌所有者才能调用此方法,以便在到期后发出赎回债券令牌的请求。此方法还涉及链代码计算赎回价格。只能对用户拥有的债券令牌的全部数量提出赎回请求。用户可以根据不同的结算 ID 提出多个兑换请求,但令牌创建者只能批准一个兑换请求。
-
ApproveTokenRedemption - 只有令牌创建者才能调用此方法来批准赎回债券令牌的请求。审批操作将债券 NFT 从所有者帐户(提出请求的用户)转移到创建者的帐户,并将 CBDC 令牌从债券创建者的帐户转移到所有者帐户。因此,此方法必须在原子事务的上下文中执行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须与提出兑换请求的令牌所有者的帐户相对应,并且 CBDC 令牌传输值必须等于在提出兑换请求时链代码计算的计算兑换价格。 -
RejectRedemption - 令牌创建者可以调用此方法以拒绝兑换请求。令牌所有者可以使用其他结算 ID 再次提出赎回请求。
-
GetAllTokensWithFilter - 管理员可以调用此 get 方法来提取按状态(
CREATED或POSTED)筛选的所有令牌。 -
GetTokenApprovalRequestByUser - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
GetTokenApprovalRequestForUserByStatus - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
GetAccountBondSummary - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。
-
GetAccountBondSummaryWithPagination - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。此方法可以根据页面大小和书签值使用分页返回结果,还可以按开始时间和结束时间进行筛选。
TypeScript 债券市场的 SDK 方法
-
payInterest - 令牌创建者或管理员可以调用此方法来支付债券令牌上获得的利息。仅当令牌的利息频率为每月、每季度或每年时,才能调用此方法。如果利息频率已到期,则无法支付利息。利息由链代码本身根据令牌的息票利率计算。采购操作将 CBDC 令牌从呼叫者的帐户转移到债券所有者的帐户。因此,此方法必须在原子事务处理的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须对应于令牌所有者,并且 CBDC 令牌传输值必须等于债券链代码计算的利息。 -
requestTokenRedemption - 只有令牌所有者才能调用此方法,以便在到期后发出赎回债券令牌的请求。此方法还涉及链代码计算赎回价格。只能对用户拥有的债券令牌的全部数量提出赎回请求。用户可以根据不同的结算 ID 提出多个兑换请求,但令牌创建者只能批准一个兑换请求。
-
approveTokenRedemption - 只有令牌创建者才能调用此方法来批准赎回债券令牌的请求。审批操作将债券 NFT 从所有者帐户(提出请求的用户)转移到创建者的帐户,并将 CBDC 令牌从债券创建者的帐户转移到所有者帐户。因此,此方法必须在原子事务的上下文中执行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须与提出兑换请求的令牌所有者的帐户相对应,并且 CBDC 令牌传输值必须等于在提出兑换请求时链代码计算的计算兑换价格。 -
rejectRedemption - 令牌创建者可以调用此方法以拒绝兑换请求。令牌所有者可以使用其他结算 ID 再次提出赎回请求。
-
getAllTokensWithFilter - 管理员可以调用此 get 方法来提取按状态(
CREATED或POSTED)筛选的所有令牌。 -
getTokenApprovalRequestByUser - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
getTokenApprovalRequestForUserByStatus - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
getAccountBondSummary - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。
-
getAccountBondSummaryWithPagination - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。此方法可以根据页面大小和书签值使用分页返回结果,还可以按开始时间和结束时间进行筛选。
转到债券市场的 SDK 方法
-
PayInterest - 令牌创建者或管理员可以调用此方法来支付债券令牌上获得的利息。仅当令牌的利息频率为每月、每季度或每年时,才能调用此方法。如果利息频率已到期,则无法支付利息。利息由链代码本身根据令牌的息票利率计算。采购操作将 CBDC 令牌从呼叫者的帐户转移到债券所有者的帐户。因此,此方法必须在原子事务处理的上下文中运行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须对应于令牌所有者,并且 CBDC 令牌传输值必须等于债券链代码计算的利息。 -
RequestTokenRedemption - 只有令牌所有者才能调用此方法,以便在到期后发出赎回债券令牌的请求。此方法还涉及链代码计算赎回价格。只能对用户拥有的债券令牌的全部数量提出赎回请求。用户可以根据不同的结算 ID 提出多个兑换请求,但令牌创建者只能批准一个兑换请求。
-
ApproveTokenRedemption - 只有令牌创建者才能调用此方法来批准赎回债券令牌的请求。审批操作将债券 NFT 从所有者帐户(提出请求的用户)转移到创建者的帐户,并将 CBDC 令牌从债券创建者的帐户转移到所有者帐户。因此,此方法必须在原子事务的上下文中执行。该方法还验证传输过程,确保使用正确的
orgId和userId调用适当的 CBDC 链代码进行传输。orgId和userId必须与提出兑换请求的令牌所有者的帐户相对应,并且 CBDC 令牌传输值必须等于在提出兑换请求时链代码计算的计算兑换价格。 -
RejectRedemption - 令牌创建者可以调用此方法以拒绝兑换请求。令牌所有者可以使用其他结算 ID 再次提出赎回请求。
-
GetAllTokensWithFilter - 管理员可以调用此 get 方法来提取按状态(
CREATED或POSTED)筛选的所有令牌。 -
GetTokenApprovalRequestByUser - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
GetTokenApprovalRequestForUserByStatus - 任何帐户持有者都可以调用此 get 方法来获取他们所做的所有令牌审批请求(赎回请求)的详细信息。
-
GetAccountBondSummary - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。
-
GetAccountBondSummaryWithPagination - 任何账户持有人都可以调用此获取方法来获取账户摘要,其中包括已购买或已兑换代币的详细信息以及购买价格和赎回价格。此方法可以根据页面大小和书签值使用分页返回结果,还可以按开始时间和结束时间进行筛选。