債券市集模型
增強版的 Blockchain App Builder 包含模型屬性,可為債券市集情境產生其他方法。
如果您將 model: bond
參數納入使用延伸 ERC-1155 標準、區塊鏈 App 產生器應用程式特定鏈碼之記號的規格檔案中,包括下列與債券市集應用程式搭配使用的額外方法。
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
- 管理員可以呼叫此取得方法來擷取依狀態篩選的所有記號 (
CREATED
或POSTED
)。 -
getTokenApprovalRequestByUser
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
getTokenApprovalRequestForUserByStatus
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
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
- 管理員可以呼叫此取得方法來擷取依狀態篩選的所有記號 (
CREATED
或POSTED
)。 -
GetTokenApprovalRequestByUser
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
GetTokenApprovalRequestForUserByStatus
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
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
- 管理員可以呼叫此取得方法來擷取依狀態篩選的所有記號 (
CREATED
或POSTED
)。 -
getTokenApprovalRequestByUser
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
getTokenApprovalRequestForUserByStatus
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
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
- 管理員可以呼叫此取得方法來擷取依狀態篩選的所有記號 (
CREATED
或POSTED
)。 -
GetTokenApprovalRequestByUser
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
GetTokenApprovalRequestForUserByStatus
- 任何帳戶持有人都可以呼叫此取得方法,以取得他們所提出之所有權杖核准要求 (贖回要求) 的詳細資料。
-
GetAccountBondSummary
- 任何帳戶持有人都可以呼叫此取得方法,以取得帳戶摘要,其中包含購買或贖回權杖的詳細資料,以及購買價格與贖回價格。
-
GetAccountBondSummaryWithPagination
- 任何帳戶持有人都可以呼叫此取得方法,以取得帳戶摘要,其中包含購買或贖回權杖的詳細資料,以及購買價格與贖回價格。此方法可以根據頁面大小和書籤值傳回分頁結果,也可以依開始時間和結束時間篩選。