權杖分類架構的鷹架式 Go 專案
Blockchain App Builder 會從您的權杖規格檔案進行輸入,並產生功能完整的鷹架式鏈碼專案。
專案會自動產生記號週期類別和函數,包括 CRUD 和非 CRUD 方法。系統會自動支援引數驗證、封送處理 (Marshal) / 解除封送處理 (unmarshal) 以及透明保存功能。
如需鷹架專案的相關資訊,以及與記號無關的方法,請參閱 Scaffolded Go Chaincode Project 。
Model
在 OchainModel
類別中擷取「通透保存功能 (Transparent Persistence Capability)」或簡化的 ORM。
package src
type Digicur struct {
AssetType string `json:"AssetType" final:"otoken"`
Token_id string `json:"Token_id" id:"true" mandatory:"true" validate:"regexp=^[A-Za-z0-9][A-Za-z0-9_-]*$,max=16"`
Token_name string `json:"Token_name" final:"digicur"`
Token_desc string `json:"Token_desc" validate:"max=256"`
Token_type string `json:"Token_type" final:"fungible" validate:"regexp=^fungible$"`
Behavior []string `json:"Behavior" final:"[\"divisible\",\"mintable\",\"transferable\",\"burnable\",\"holdable\",\"roles\"]"`
Roles map[string]interface{} `json:"Roles" final:"{\"minter_role_name\":\"minter\",\"burner_role_name\":\"burner\",\"notary_role_name\":\"notary\"}"`
Mintable map[string]interface{} `json:"Mintable" final:"{\"Max_mint_quantity\":20000}"`
Divisible map[string]interface{} `json:"Divisible" final:"{\"Decimal\":1}"`
Token_to_currency_ratio int `json:"Token_to_currency_ratio" validate:"int"`
Currency_representation string `json:"Currency_representation" validate:"string"`
Metadata interface{} `json:"Metadata,omitempty"`
}
控制器
只有一個主控制器。
type Controller struct {
Ctx trxcontext.TrxContext
}
您可以建立不限數目的類別、函數或檔案,但只能呼叫在主控制器類別中定義的方法。其他方法則為隱藏。
您可以使用記號 SDK 方法,為商業應用程式撰寫自訂方法。
如果您在自訂方法中使用多個記號 SDK 方法,請勿使用會影響狀態資料庫中相同索引鍵 - 值組的方法。
請改用 BulkTransferTokens
方法,從呼叫端的帳戶轉移到多個帳戶,如以下程式碼片段所示。
BulkTransferTokens(token_id string, flow: []map[string]interface{})
附註:
如果您在自訂方法中使用多個可能影響狀態資料庫中相同索引鍵 - 值組的記號 SDK 方法,請啟用記號鏈碼的 MVCC 最佳化。如需詳細資訊,請參閱 MVCC 最佳化。自動產生的記號方法
Blockchain App Builder 會自動產生支援權杖和權杖生命週期的方法。您可以使用這些方法來初始化記號、管理角色和帳戶,以及完成其他記號生命週期工作,而無需進行任何其他編碼。控制器方法必須是公用才能呼叫。公用方法名稱開頭為大寫字元。開頭為小寫字元的方法名稱是私密的。
存取控制管理的方法
-
AddTokenAdmin
- 此方法會將使用者新增為鏈碼的
Token Admin
。鏈碼的Token Admin
只能呼叫此方法。 -
RemoveTokenAdmin
- 此方法會將使用者移除為鏈碼的
Token Admin
。鏈碼的Token Admin
只能呼叫此方法。 -
IsTokenAdmin
- 如果函數的呼叫程式是
Token Admin
,此方法會傳回布林值true
,否則會傳回false
。Token Admin
或Org Admin
可在區塊鏈網路中的任何其他使用者呼叫此功能。其他使用者只能在自己的帳戶呼叫此方法。 -
GetAllTokenAdmins
- 此方法會傳回屬於鏈碼
Token Admin
的所有使用者清單。此方法只能由鏈碼的Token Admin
或Org Admin
呼叫。 -
AddOrgAdmin
- 此方法會將使用者新增為組織的
Org Admin
。此方法只能由鏈碼的Token Admin
或由指定組織的Org Admin
呼叫。 -
RemoveOrgAdmin
- 此方法會將使用者移除為組織的
Org Admin
。此方法只能由鏈碼的Token Admin
或由指定組織的Org Admin
呼叫。 -
GetOrgAdmins
- 此方法會傳回組織
Org Admin
的所有使用者清單。此方法只能由鏈碼的Token Admin
或任何Org Admin
呼叫。
記號組態管理的方法
-
Init
- 部署鏈碼時會呼叫此方法。每個
Token Admin
都是由必要adminList
參數中的user_id
和org_id
資訊所識別。user_id
是執行處理擁有者或登入執行處理之使用者的使用者名稱或電子郵件 ID。org_id
是目前網路組織中使用者的成員服務提供者 (MSP) ID。 -
Initialize<Token Name>Token
- 此方法會建立記號並初始化記號特性。資產及其特性會儲存在狀態資料庫中。此方法只能由鏈碼的
Token Admin
呼叫。 -
Update<Token Name>Token
- 此方法會更新記號特性。建立權杖資產之後,只能更新
token_desc
特性和自訂特性。鏈碼的Token Admin
只能呼叫此方法。 -
GetTokenDecimals
- 此方法會傳回為小數記號設定的小數位數。如果未指定記號的
divisible
行為,則預設值為 0。此方法只能由鏈碼的Token Admin
或Org Admin
呼叫。 -
GetTokenById
- 如果權杖物件存在於狀態資料庫中,這個方法就會傳回該物件。此方法只能由鏈碼的
Token Admin
或Org Admin
呼叫。 -
GetTokenHistory
- 此方法會傳回指定記號 ID 的記號歷史記錄。任何使用者都可以呼叫此方法。
-
GetAllTokens
- 此方法會傳回所有儲存在狀態資料庫中的記號。此方法只能由鏈碼的
Token Admin
或Org Admin
呼叫。 -
GetTokensByName
- 此方法會傳回具有指定名稱的所有記號物件。此方法只能由鏈碼的
Token Admin
或Org Admin
呼叫。此方法使用 Berkeley 資料庫 SQL 豐富查詢,且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
帳戶管理方法
-
CreateAccount
- 此方法會為指定的使用者和記號建立一個帳戶。必須為任何時候會有權杖的任何使用者建立帳戶。帳戶會追蹤餘額、保留餘額及交易歷史記錄。帳戶 ID 是一組文數字字元,前面加上
oaccount~<token asset name>~
,後面接著執行處理擁有者的使用者名稱或電子郵件 ID (user_id
) 雜湊,或登入執行處理的使用者,即目前網路組織中使用者的成員服務提供者 ID (org_id
)。此方法只能由鏈碼的Token Admin
或指定組織的Org Admin
呼叫。 -
AssociateTokenToAccount
- 此方法會將有趣的記號與帳戶建立關聯。此方法只能由鏈碼的
Token Admin
或相關組織的Org Admin
呼叫。 -
GetAccount
- 此方法會傳回指定之使用者和記號的帳戶詳細資訊。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。 -
GetAccountHistory
- 此方法會傳回指定之使用者和記號的帳戶歷史記錄詳細資訊。此方法只能由鏈碼的
Token Admin
或帳戶的AccountOwner
呼叫。 -
GetAccountOnHoldBalance
- 此方法會傳回指定帳戶與變數替代字的目前保留餘額。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。 -
GetAllAccounts
- 此方法會傳回所有帳戶的清單。鏈碼的
Token Admin
只能呼叫此方法。此方法使用 Berkeley 資料庫 SQL 豐富查詢,且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。 -
GetUserByAccountId
- 此方法會傳回指定帳戶的使用者詳細資訊 (
org_id
和user_id
)。鏈碼的任何使用者都可以呼叫此方法。 -
GetAccountBalance
- 此方法會傳回指定帳戶和權杖的目前餘額。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。 -
GetAllOrgAccounts
- 此方法會傳回屬於指定組織的所有權杖帳戶清單。此方法只能由鏈碼的
Token Admin
或由指定組織的Org Admin
呼叫。
角色管理方法
-
AddRole
- 這個方法會將角色新增至指定的使用者和記號。此方法只能由鏈碼的
Token Admin
呼叫,或由同時具有指定角色之指定組織的Org Admin
呼叫。 -
RemoveRole
- 此方法會從指定的使用者和記號移除角色。此方法只能由鏈碼的
Token Admin
或同時具有指定角色之指定組織的Org Admin
呼叫。 -
GetAccountsByRole
- 此方法會傳回指定角色和權杖的所有帳戶 ID 清單。鏈碼的
Token Admin
只能呼叫此方法。 -
GetAccountsByUser
- 此方法會傳回指定之組織 ID 與使用者 ID 的所有帳戶 ID 清單。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或參數中指定的Account Owner
呼叫。 -
GetUsersByRole
- 此方法會針對指定的角色和記號,傳回所有使用者的清單。此方法只能由鏈碼的
Token Admin
或由參數中指定的Account Owner
呼叫。 -
IsInRole
- 此方法會傳回布林值,指示使用者和記號是否具有指定的角色。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。 -
GetOrgUsersByRole
- 此方法會傳回在指定組織中具有指定角色之所有使用者的相關資訊。此方法只能由鏈碼的
Token Admin
或由指定組織的Org Admin
呼叫。 -
GetOrgAccountsByRole
- 此方法會傳回在指定組織中具有指定角色之所有帳戶的相關資訊。此方法只能由鏈碼的
Token Admin
或由指定組織的Org Admin
呼叫。
交易歷史記錄管理的方法
-
GetAccountTransactionHistory
- 此方法會傳回指定使用者和權杖的帳戶交易歷史記錄明細陣列。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。 -
GetAccountTransactionHistoryWithFilters
- 此方法會傳回指定使用者和權杖的帳戶交易歷史記錄明細陣列。此方法只能由鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的AccountOwner
呼叫。連線至遠端 Oracle Blockchain Platform 網路時才能呼叫此方法。 -
GetSubTransactionsById
- 此方法會傳回指定交易的子交易歷史記錄明細陣列。
-
GetSubTransactionsByIdWithFilters
- 此方法會傳回指定交易的子交易歷史記錄明細陣列。
-
GetTransactionById
- 此方法會傳回
Transaction
資產的歷史記錄。 -
DeleteHistoricalTransactions
- 此方法會從狀態資料庫中刪除較舊的交易。
記號行為管理方法 - 可調整行為
-
IssueTokens
- 這個方法會提示記號,然後由方法的呼叫程式所擁有。呼叫者必須具有帳戶與較小者角色。可提示的記號數目受規格檔案中
mintable
行為的max_mint_quantity
特性限制。如果未指定max_mint_quantity
特性,則可提示不限數目的記號。數量必須在規格檔案中divisible
行為的decimal
參數所指定的小數值內。只有具備較小角色的帳戶AccountOwner
才能呼叫此方法。 -
GetTotalMintedTokens
- 此方法會傳回指定記號的 Minted 記號總數。此方法只能由鏈碼的
Token Admin
或Org Admin
呼叫。 -
GetNetTokens
- 此方法會傳回系統中特定記號可用的記號總數。淨記號總計是記號燒錄後剩餘的記號量。在方程式表單中,淨記號 = 提示的記號總計 - 消耗的記號總計。如果沒有燒錄記號,則淨記號的數目等於提示的記號總數。此方法只能由鏈碼的
Token Admin
或Org Admin
呼叫。
記號行為管理方法 - 可傳輸行為
-
TransferTokens
- 此方法會將記號從呼叫程式傳輸至指定的帳戶。方法的呼叫程式必須要有一個帳戶。數量必須在規格檔案中
divisible
行為的decimal
參數所指定的小數值內。此方法只能由帳戶的AccountOwner
呼叫。 -
BulkTransferTokens
- 此方法是用來執行從呼叫程式帳戶到
flow
物件中指定帳戶的大量記號傳輸。此方法之規格 file.The 呼叫程式中divisible
行為的decimal
參數所指定的數量必須在已建立帳戶的小數值內。此方法只能由帳戶的AccountOwner
呼叫。
記號行為管理方法 - 可保留行為
-
HoldTokens
- 此方法會代表記號擁有者的
to_account_id
帳戶建立保留。已指定公證人帳戶,其負責完成或解除保留。建立保留時,付款人的指定變數替代字餘額會設為保留。保留餘額必須等到完成或解除後才能移轉。這個方法的呼叫程式必須已經建立帳戶。此方法只能由帳戶的AccountOwner
呼叫。 -
ExecuteHoldTokens
- 這個方法會完成記號的保留。權杖擁有者之前持有的權杖數量會轉移給接收者。如果
quantity
值小於實際保留值,則記號的原始擁有者可再使用剩餘金額。只有具備notary
角色的AccountOwner
ID 才能呼叫此方法。保留只能由公證人完成。 -
ReleaseHoldTokens
- 此方法會解除記號的保留。移轉未完成,所有保留的變數替代字會再次可供原始擁有者使用。
Account Owner
ID 可在指定的時間限制內以notary
角色呼叫此方法,或在指定的時間限制之後由付款人、受款人或公證人呼叫。 -
GetOnHoldIds
- 這個方法會傳回指定帳戶之所有持有 ID 的清單。鏈碼的
Token Admin
、指定組織的Org Admin
或帳戶的Account Owner
可以呼叫此方法。 -
GetOnHoldDetailsWithOperationId
- 此方法會傳回指定作業 ID 和記號的保留交易詳細資訊。任何人都可以呼叫這個方法。
-
GetOnHoldBalanceWithOperationId
- 此方法會傳回指定作業 ID 與變數替代字的保留餘額。任何人都可以呼叫這個方法。
記號行為管理方法 - 可燒錄行為
自訂方法
您可以使用記號 SDK 方法,為商業應用程式撰寫自訂方法。
使用記號 SDK 方法時,請務必追蹤傳回值。此外,為了避免雙支出,請勿結合在狀態資料庫中同一個索引鍵 - 值組上運作的多個非同步函數。請改用 BulkTransferTokens
方法,在一個方法中進行多重傳輸。
下列範例顯示如何在自訂方法中使用記號 SDK 方法。呼叫 BuyTicket
方法時,它會從來電者帳戶將 20 個權杖傳輸至賣方帳戶,並傳回轉帳的交易訊息。
func (t *Controller) BuyTicket(TokenId string, SellerOrgId string, SellerUserId string) (interface{}, error){
token, err := t.Ctx.Token.Get(TokenId)
if err != nil {
return nil, err
}
/**
* The following method t.Ctx.Account.GenerateAccountId(TokenId, SellerOrgId, SellerUserId) generates account id of the seller
*/
sellerAccountId, err := t.Ctx.Account.GenerateAccountId(TokenId, SellerOrgId, SellerUserId)
if err != nil {
return nil, err
}
/**
* The following method t.Ctx.Token.Transfer(sellerAccountId, 20, token) transfers the quantity 20 from caller's
* account & to seller's account.
*/
transaction, err := t.Ctx.Token.Transfer(sellerAccountId, 20, token)
if err != nil {
return nil, err
}
return transaction, nil
}
權杖 SDK 方法
存取控制管理的方法
Token Admin
、Org Admin
或 AccountOwner
呼叫。您可以使用此功能來確保作業只由預期的使用者執行。任何未經授權的存取都會導致錯誤。若要使用存取控制功能,請從 ../lib/auth
模組匯入 Authorization
類別。import { Authorization } from '../lib/auth';
-
AddAdmin
- 此方法會將使用者新增為記號鏈碼的
Token Admin
。 -
RemoveAdmin
- 此方法會將使用者移除為記號鏈碼的
Token Admin
。 -
GetAllAdmins
- 此方法會傳回
Token Admin
記號鏈碼的所有使用者清單。 -
GetAllAdminUsers
- 此方法會傳回
Token Admin
記號鏈碼的所有使用者清單。 -
CheckAuthorization
- 使用此方法將存取控制新增至您的鏈碼。許多自動產生的記號方法都使用存取控制。
oChainUtil.go
檔案中說明 SDK 接收器與具有存取控制之方法之間的對應。若要使用您自己的存取控制或停用存取控制,請從自動產生的控制器方法與自訂方法移除存取控制程式碼。var t TokenAccess var r RoleAccess var a AccountAccess var as AccountStatusAccess var h HoldAccess var ad AdminAccess var trx TransactionAccess var tc TokenConversionAccess var auth AuthAccess auth.IsTokenAdmin = []string{"Admin", "MultipleAccountOwner"} trx.DeleteHistoricalTransactions = []string{"Admin"} ad.AddAdmin = []string{"Admin"} ad.RemoveAdmin = []string{"Admin"} ad.GetAllAdmins = []string{"Admin", "OrgAdmin"} ad.AddOrgAdmin = []string{"Admin", "OrgAdminOrgIdCheck"} ad.RemoveOrgAdmin = []string{"Admin", "OrgAdminOrgIdCheck"} ad.GetOrgAdmins = []string{"Admin", "OrgAdmin"} ad.IsTokenAdmin = []string{"Admin", "MultipleAccountOwner", "OrgAdmin"} t.Save = []string{"Admin"} t.GetAllTokens = []string{"Admin", "OrgAdmin"} t.Update = []string{"Admin"} t.GetTokenDecimals = []string{"Admin", "OrgAdmin"} t.GetTokensByName = []string{"Admin", "OrgAdmin"} t.AddRoleMember = []string{"Admin", "OrgAdminRoleCheck"} t.RemoveRoleMember = []string{"Admin", "OrgAdminRoleCheck"} t.IsInRole = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} t.GetTotalMintedTokens = []string{"Admin", "OrgAdmin"} t.GetNetTokens = []string{"Admin", "OrgAdmin"} t.Get = []string{"Admin", "OrgAdmin"} t.GetTokenHistory = []string{"Admin", "OrgAdmin"} a.CreateAccount = []string{"Admin", "OrgAdminOrgIdCheck"} a.AssociateToken = []string{"Admin", "OrgAdminAccountIdCheck"} a.GetAllAccounts = []string{"Admin"} a.GetAllOrgAccounts = []string{"Admin", "OrgAdminOrgIdCheck"} a.GetAccount = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.History = []string{"Admin", "AccountOwner"} a.GetAccountTransactionHistory = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountTransactionHistoryWithFilters = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetSubTransactionsById = []string{"Admin", "TransactionInvoker"} a.GetSubTransactionsByIdWithFilters = []string{"Admin", "TransactionInvoker"} a.GetAccountBalance = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountOnHoldBalance = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetOnHoldIds = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} a.GetAccountsByUser = []string{"Admin", "OrgAdminOrgIdCheck", "MultipleAccountOwner"} as.Get = []string{"Admin", "OrgAdminAccountIdCheck", "AccountOwner"} as.ActivateAccount = []string{"Admin", "OrgAdminOrgIdCheck"} as.SuspendAccount = []string{"Admin", "OrgAdminOrgIdCheck"} as.DeleteAccount = []string{"Admin", "OrgAdminOrgIdCheck"} r.GetAccountsByRole = []string{"Admin"} r.GetUsersByRole = []string{"Admin"} r.GetOrgAccountsByRole = []string{"Admin", "OrgAdminOrgIdCheck"} r.GetOrgUsersByRole = []string{"Admin", "OrgAdminOrgIdCheck"} tc.InitializeExchangePoolUser = []string{"Admin"} tc.AddConversionRate = []string{"Admin"} tc.UpdateConversionRate = []string{"Admin"} tc.GetConversionRate = []string{"Admin", "OrgAdmin", "AnyAccountOwner"} tc.GetConversionRateHistory = []string{"Admin", "OrgAdmin", "AnyAccountOwner"} tc.TokenConversion = []string{"Admin", "AnyAccountOwner"} tc.GetExchangePoolUser = []string{"Admin"}
-
IsUserTokenAdmin
- 如果函數的呼叫程式是
Token Admin
,此方法會傳回布林值true
。否則,方法會傳回false
。 -
AddOrgAdmin
- 此方法會將使用者新增為組織的
Org Admin
。 -
RemoveOrgAdmin
- 此方法會將使用者移除為組織的
Org Admin
。 -
GetOrgAdmins
- 此方法會傳回組織
Org Admin
的所有使用者清單。
記號組態管理的方法
-
GetTokenDecimals
- 此方法會傳回小數記號可用的小數位數。如果未指定
divisible
行為,則預設值為 0。 -
GetAllTokens
- 此方法會傳回儲存在狀態資料庫中的所有記號資產。此方法使用 Berkeley 資料庫 SQL 豐富查詢,且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
GetTokensByName
- 此方法會傳回具有指定名稱的所有權杖資產。此方法使用 Berkeley 資料庫 SQL 豐富查詢,且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
Get
- 如果權杖物件存在於狀態資料庫中,這個方法就會傳回該物件。此方法只能由記號鏈碼的
Token Admin
呼叫。 -
IsTokenType
- 此方法會測試指定的記號 ID 是否存在記號資產。
-
Save
- 此方法會建立記號,並將其特性儲存在狀態資料庫中。
-
Update
- 此方法會更新記號特性。建立權杖資產之後,您只能更新
token_desc
值及其自訂特性。 -
GetByRange
- 此方法會在內部呼叫結構
getStateByRange
方法。即使從分類帳傳回任何具有指定 ID 的資產,此方法會將資產轉換成呼叫程式資產類型。 -
History
- 此方法會傳回指定記號 ID 的記號歷史記錄。
帳戶管理方法
-
GenerateAccountId
- 此方法會傳回帳戶 ID,這是一組文數字字元,前面加上
oaccount~<token asset name>~
,後面接著執行處理擁有者的使用者名稱或電子郵件 ID (user_id
) 雜湊、登入執行處理的使用者、目前網路組織中使用者的成員服務提供者 ID (org_id
) 以及唯一權杖 ID (token_id
)。 -
CreateAccount
- 此方法會為指定的使用者和記號建立一個帳戶。每個有權杖的使用者都必須有帳戶。帳戶會追蹤使用者的餘額、保留餘額及交易歷史記錄。帳戶 ID 是一組文數字字元,前面加上
oaccount~<token asset name>~
,後面接著執行處理擁有者的使用者名稱或電子郵件 ID (user_id
) 雜湊,或登入執行處理的使用者,即目前網路組織中使用者的成員服務提供者 ID (org_id
)。鏈碼的Token Admin
只能呼叫此方法。 -
AssociateToken
- 此方法會將有趣的記號與帳戶建立關聯。鏈碼的
Token Admin
只能呼叫此方法。 -
GetAccountWithStatus
- 此方法會傳回指定帳戶的帳戶詳細資訊,包括帳戶狀態。
-
GetAccount
- 此方法會傳回指定帳戶的帳戶詳細資料。
-
GetAccountHistory
- 此方法會傳回指定帳戶的帳戶歷史記錄詳細資料陣列。
-
GetAccountOnHoldBalance
- 此方式會傳回指定科目的保留餘額。
-
GetAllAccounts
- 此方法會傳回所有帳戶的清單。此方法使用 Berkeley 資料庫 SQL 豐富查詢,且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
GetUserByAccountId
- 此方法會傳回指定帳戶的使用者詳細資訊。
-
GetAccountBalance
- 此方法會傳回指定帳戶的帳戶餘額。
-
GetAllOrgAccounts
- 此方法會傳回屬於指定組織的所有權杖帳戶清單。
角色管理方法
-
AddRoleMember
- 這個方法會將角色新增至指定的使用者和記號。
-
RemoveRoleMember
- 此方法會從指定的使用者和記號移除角色。
-
GetAccountsByRole
- 此方法會傳回所指定角色和記號的所有帳戶清單。
-
GetUsersByRole
- 此方法會針對指定的角色和記號,傳回所有使用者的清單。
-
IsInRole
- 此方法指示使用者和記號是否具有指定的角色。
-
RoleCheck
- 此方法會檢查提供的帳戶 ID 是否為任何角色的成員。
-
GetOrgUsersByRole
- 此方法會傳回在指定組織中具有指定角色之所有使用者的相關資訊。
-
GetOrgAccountsByRole
- 此方法會傳回在指定組織中具有指定角色之所有帳戶的相關資訊。
交易歷史記錄管理的方法
-
GetAccountTransactionHistory
- 此方式會傳回指定科目的交易歷史記錄明細陣列。
-
GetAccountTransactionHistoryWithFilters
- 此方法會傳回指定交易之交易歷史記錄明細的陣列。連線至遠端 Oracle Blockchain Platform 網路時才能呼叫此方法。
-
GetSubTransactionsById
- 此方法會傳回指定交易之交易歷史記錄明細的陣列。
-
GetSubTransactionsByIdWithFilters
- 此方法會傳回指定交易之交易歷史記錄明細的陣列。
-
GetTransactionById
- 此方法會傳回
Transaction
資產的歷史記錄。 -
DeleteHistoricalTransactions
- 此方法會從狀態資料庫中刪除較舊的交易。
記號行為管理方法 - 可調整行為
-
Mint
- 這個方法會提示記號,然後由方法的呼叫程式所擁有。呼叫者必須具有帳戶與較小者角色。可提示的記號數目受規格檔案中
mintable
行為的max_mint_quantity
特性限制。如果未指定max_mint_quantity
特性,則可提示不限數目的記號。數量必須在規格檔案中divisible
行為的decimal
參數所指定的小數值內。只有具備較小角色的帳戶AccountOwner
才能呼叫此方法。 -
GetTotalMintedTokens
- 此方法會傳回提示的記號總數。
-
GetNetTokens
- 此方法會傳回系統中指定記號可用的記號淨數量。網路記號是記號被燒錄後剩餘的記號量。在方程式形式中:淨記號 = 提示的記號總計 - 消耗的記號總計。如果沒有燒錄記號,則淨記號的數目等於提示的記號總數。
-
GetMaxMintQuantity
- 此方式會傳回變數替代字的最大可修改數量。如果未指定
max_mint_quantity
行為,則預設值為 0,允許任意數目的記號進行調解。
記號行為管理方法 - 可傳輸行為
-
Transfer
- 此方法會將記號從呼叫程式傳輸至指定的帳戶。方法的呼叫程式必須要有一個帳戶。數量必須在規格檔案中
divisible
行為的decimal
參數所指定的小數值內。此方法只能由帳戶的AccountOwner
呼叫。 -
BulkTransfer
- 此方法是用來執行從呼叫程式帳戶到
flow
物件中指定帳戶的大量記號傳輸。這個方法的呼叫程式必須已經建立帳戶。
記號行為管理方法 - 可保留行為
-
Hold
- 此方法會代表記號擁有者的
to_account_id
帳戶建立保留。已指定公證人帳戶,其負責完成或解除保留。建立保留時,付款人的指定變數替代字餘額會設為保留。保留餘額必須等到完成或解除後才能移轉。這個方法的呼叫程式必須已經建立帳戶。 -
ExecuteHold
- 此方式會完成記號的保留,將先前保留的指定記號數量移轉給接收者。如果
quantity
值小於實際保留值,則記號的原始擁有者可再使用剩餘金額。只有具備notary
角色的AccountOwner
ID 才能呼叫此方法。 -
ReleaseHold
- 此方法會解除記號的保留。移轉未完成,所有保留的變數替代字會再次可供原始擁有者使用。
Account Owner
ID 可在指定的時間限制內以notary
角色呼叫此方法,或在指定的時間限制之後由付款人、受款人或公證人呼叫。 -
GetOnHoldIds
- 這個方法會傳回指定之使用者和記號的所有保留 ID 清單。
-
GetOnHoldDetailsWithOperationID
- 此方法會傳回指定作業 ID 和記號的保留交易詳細資訊。
-
GetOnHoldBalanceWithOperationID
- 此方法會傳回指定作業 ID 與變數替代字的保留餘額。
記號行為管理方法 - 可燒錄行為