ERC-721 的鷹架式 Go NFT 專案
Blockchain App Builder 會從您的 NFT 規格檔案進行輸入，並產生功能完整的鷹架式鏈碼專案。
專案會自動產生 NFT 生命週期類別和函數，包括 CRUD 和非 CRUD 方法。系統會自動支援引數驗證、封送處理 (Marshall) / 取消封送處理 (unmarshal) 以及通透保存功能。
如需結構化專案和與 NFT 無直接相關之方法的相關資訊，請參閱 Scaffolded Go Chaincode Project 。
參考資料：
Model
「通透持續性功能 (Transparent Persistence Capability)」或簡化的 ORM 會擷取到 OchainModel 類別中。
package model
type ArtCollection struct {
AssetType string `json:"AssetType" final:"otoken"`
TokenId string `json:"TokenId" id:"true" mandatory:"true" validate:"regexp=^[A-Za-z0-9][A-Za-z0-9_-]*$,max=16"`
TokenName string `json:"TokenName" final:"artcollection"`
TokenDesc string `json:"TokenDesc" validate:"max=256"`
Symbol string `json:"Symbol" final:"ART"`
TokenStandard string `json:"TokenStandard" final:"erc721+"`
TokenType string `json:"TokenType" final:"nonfungible" validate:"regexp=^nonfungible$"`
TokenUnit string `json:"TokenUnit" final:"whole" validate:"regexp=^whole$"`
Behavior []string `json:"Behavior" final:"[\"indivisible\",\"singleton\",\"mintable\",\"transferable\",\"burnable\",\"roles\"]"`
Roles map[string]interface{} `json:"Roles" final:"{\"minter_role_name\":\"minter\"}"`
Mintable map[string]interface{} `json:"Mintable" final:"{\"Max_mint_quantity\":20000}"`
Owner string `json:"Owner,omitempty" validate:"string"`
CreatedBy string `json:"CreatedBy,omitempty" validate:"string"`
TransferredBy string `json:"TransferredBy,omitempty" validate:"string"`
CreationDate string `json:"CreationDate,omitempty" validate:"string"`
TransferredDate string `json:"TransferredDate,omitempty" validate:"string"`
IsBurned bool `json:"IsBurned" validate:"bool"`
BurnedBy string `json:"BurnedBy,omitempty" validate:"string"`
BurnedDate string `json:"BurnedDate,omitempty" validate:"string"`
TokenUri string `json:"TokenUri" validate:"string,max=2000"`
TokenMetadata ArtCollectionMetadata `json:"TokenMetadata"`
Price int `json:"Price" validate:"int"`
On_sale_flag bool `json:"On_sale_flag" validate:"bool"`
}
type ArtCollectionMetadata struct {
Painting_name string `json:"Painting_name" validate:"string"`
Description string `json:"Description" validate:"string"`
Image string `json:"Image" validate:"string"`
Painter_name string `json:"Painter_name" validate:"string"`
}
控制器
只有一個主要控制器。
type Controller struct {
Ctx trxcontext.TrxContext
}您可以建立不限數目的類別、函數或檔案，但只能呼叫在 main Controller 類別中定義的方法。其他方法則會隱藏。
您可以使用記號 SDK 方法，為您的商業應用程式撰寫自訂方法。
自動產生的 NFT 方法
Blockchain App Builder 會自動產生支援 NFT 和 NFT 生命週期的方法。您可以使用這些方法來初始化 NFT、管理角色和帳戶，以及完成其他 NFT 生命週期作業，而無需進行任何其他編碼。
Blockchain App Builder 會自動產生支援 NFT 和 NFT 生命週期的方法。您可以使用這些方法來初始化 NFT、管理角色和帳戶，以及完成其他 NFT 生命週期作業，而無需進行任何其他編碼。控制器方法必須為 public，才能呼叫。公用方法名稱的開頭是大寫字元。以小寫字元開頭的方法名稱是私密的。
存取控制管理方法
-
AddTokenAdmin - 此方法會將使用者新增為鏈碼的
Token Admin。只有鏈碼的Token Admin才能呼叫此方法。 -
RemoveTokenAdmin - 此方法會移除使用者作為鏈碼的
Token Admin。只有鏈碼的Token Admin才能呼叫此方法。您無法使用此方法將自己移除為Token Admin。 -
IsTokenAdmin - 如果函數的呼叫程式是
Token Admin，則此方法會傳回布林值true，否則會傳回false。Token Admin可以對區塊鏈網路中的任何其他使用者呼叫此功能。其他使用者只能在自己的帳戶上呼叫此方法。 -
GetAllTokenAdmins - 此方法會傳回鏈碼為
Token Admin的所有使用者清單。只有鏈碼的Token Admin才能呼叫此方法。
權杖組態管理方法
-
Init - 建立鏈碼時會呼叫這個方法。每個
Token Admin都是由adminList參數中的UserId和OrgId資訊來識別。UserId是執行處理擁有者或登入執行處理之使用者的使用者名稱或電子郵件 ID。OrgId是目前網路組織中使用者的成員服務提供者 (MSP) ID。第一次部署鏈碼時，必須輸入adminList參數。如果您要升級鏈碼，請傳送空白清單 ([])。升級時會忽略adminList參數中的任何其他資訊。 -
GetAllTokens - 此方法會傳回狀態資料庫中儲存的所有記號資產。只有鏈碼的
Token Admin才能呼叫此方法。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。 -
GetAllTokensByUser - 此方法會傳回指定使用者擁有的所有權杖資產。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。只有鏈碼的
Token Admin或帳戶擁有者才能呼叫此方法。 -
GetTokenById - 如果狀態資料庫中有記號，這個方法會傳回一個記號物件。只有鏈碼的
Token Admin或記號擁有者才能呼叫此方法。 -
GetTokenHistory - 這個方法會傳回所指定記號 ID 的歷史記錄。只有在連線至遠端 Oracle Blockchain Platform 網路時才能呼叫此方法。任何人都可以呼叫這個方法。
-
getTokenObject - 此公用程式方法會傳回指定記號 ID 之記號的執行處理。許多自動產生的方法都會使用此方法來擷取記號物件。您可以視需要從自訂方法呼叫此方法。當您建立記號化資產或類別時，請使用對應的
Token類別更新切換案例，以傳回正確的記號物件。在規格檔案中建立權杖化資產時，區塊鏈 App 產生器中的ochain sync命令會自動建立切換大小寫。因為這個方法屬於私密，所以它無法直接呼叫，也只能從其他方法呼叫。 -
OwnerOf - 此方法會傳回所指定權杖 ID 之擁有者的帳戶 ID。任何人都可以呼叫這個方法。
-
Name - 這個方法會傳回記號類別的名稱。任何人都可以呼叫這個方法。
-
Symbol - 這個方法會傳回記號類別的符號。任何人都可以呼叫這個方法。
-
TokenURI - 此方法會傳回所指定記號的 URI。任何人都可以呼叫這個方法。
-
TotalSupply - 此方法會傳回所提示記號的總數。只有鏈碼的
Token Admin才能呼叫此方法。 -
TotalNetSupply - 此方法會傳回所提示記號的總數減去已燒記號的數目。只有鏈碼的
Token Admin才能呼叫此方法。
帳戶管理方法
-
CreateAccount - 這個方法會為指定的使用者與記號建立帳號。必須為任何需要記號的使用者建立帳戶。帳戶會追蹤使用者擁有的 NFT 數目。使用者必須在網路中擁有帳戶，才能完成權杖相關作業。每個使用者只能建立一個 NFT 帳戶。
帳戶 ID 是英數字元集，前面加上
oaccount~，後面接著目前網路組織中使用者之成員服務提供者 ID (OrgId) 的 SHA-256 雜湊、執行處理擁有者的使用者名稱或電子郵件 ID (UserId) 或登入執行處理的使用者，以及常數字串nft。只有鏈碼的Token Admin才能呼叫此方法。 -
BalanceOf - 此方法會傳回指定使用者所保留的 NFT 總數。只有鏈碼的
Token Admin或帳戶擁有者才能呼叫此方法。 -
GetAllAccounts - 這個方法會傳回所有帳號的清單。只有鏈碼的
Token Admin才能呼叫此方法。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。 -
GetAccountByUser - 此方法會傳回指定使用者的帳戶詳細資料。只有鏈碼的
Token Admin或帳戶的Account Owner才能呼叫此方法。 -
GetUserByAccountId - 此方法會傳回指定帳戶的使用者詳細資料。任何使用者都可以呼叫這個方法。
-
GetAccountHistory - 此方法會傳回指定使用者的帳戶歷史記錄。只有鏈碼的
Token Admin或帳戶擁有者才能呼叫此方法。
角色管理方法
-
AddRole - 此方法會將角色新增至指定的使用者。只有鏈碼的
Token Admin才能呼叫此方法。 -
RemoveRole - 此方法會從指定的使用者移除角色。只有鏈碼的
Token Admin才能呼叫此方法。 -
GetAccountsByRole - 此方法會傳回指定角色的所有帳戶 ID 清單。只有鏈碼的
Token Admin才能呼叫此方法。 -
GetUsersByRole - 此方法會傳回指定角色的所有使用者清單。只有鏈碼的
Token Admin才能呼叫此方法。 -
IsInRole - 此方法會傳回布林值，以指出使用者是否具有指定的角色。只有鏈碼的
Token Admin或帳戶的Account Owner才能呼叫此方法。
交易歷史記錄管理的方式
-
GetAccountTransactionHistory - 此方法會傳回指定使用者的帳戶交易歷史記錄。此方法可由鏈碼的
Token Admin或帳戶的擁有者呼叫。 -
GetAccountTransactionHistoryWithFilters - 此方法會傳回依
PageSize、Bookmark、StartTime和EndTime篩選之指定使用者的帳戶交易歷史記錄。只有在連線至遠端 Oracle Blockchain Platform 網路時才能呼叫此方法。只有鏈碼的Token Admin或帳戶擁有者才能呼叫此方法。 -
GetTransactionById - 此方法會傳回指定交易 ID 的交易記錄。只有鏈碼的
Token Admin或帳戶擁有者才能呼叫此方法。 -
DeleteHistoricalTransactions - 此方法會刪除狀態資料庫中早於指定時間戳記的交易。只有鏈碼的
Token Admin才能呼叫此方法。
權杖行為管理方法 - 可變行為
-
Create<Token Name>Token - 此方法會建立 (提示) NFT。資產和關聯的性質會儲存在狀態資料庫中。此交易的來電者必須有權杖帳戶。此交易的呼叫者會成為 NFT 的擁有者。如果記號規格檔案包含
behaviors的roles區段和roles的minter_role_name特性，則交易的呼叫者必須具有 minter 角色。否則，任何來電者都可以提示 NFT。 -
Update<Token Name>Token - 此方法會更新記號特性。只有權杖的擁有者或建立者能夠呼叫此方法。記號資產建立之後，只有記號擁有者可以更新記號自訂特性。如果使用者同時是權杖擁有者和權杖建立者，他們也可以更新
TokenDesc特性。無法更新權杖描述資料。即使您只想更新特定特性，也必須將所有記號特性傳送給此方法。
權杖行為管理方法 - 可轉移行為
-
SafeTransferFrom - 這個方法會將指定 NFT 的所有權從呼叫者轉移到另一個帳戶。此方法包含下列驗證：
- 記號存在且未燒錄。
- 寄件人帳戶與接收者帳戶已存在，且不是相同的帳戶。
- 寄件者帳戶擁有權杖。
- 函數的呼叫程式是寄件者。
-
TransferFrom - 此方法會將指定 NFT 的所有權從寄件者帳戶轉移至接收者帳戶。呼叫者必須負責傳送正確的參數。任何使用者都可以呼叫此方法，而不只是記號擁有者。此方法包含下列驗證：
- 記號存在且未燒錄。
- 寄件人帳戶與接收者帳戶已存在，且不是相同的帳戶。
- 寄件者帳戶擁有權杖。
記號行為管理方法 - 可燃行為
-
Burn - 此方法會停用或燒錄呼叫者帳戶中指定的 NFT。此方法的呼叫者必須有帳戶。除非記號規格檔案包含
burnable行為，否則無法燒錄記號。如果未在規格檔案的roles區段中指定burner_role_name特性，則記號的擁有者可以燒錄記號。如果在roles區段中指定了burner_role_name特性，則被指派為該記號之 minter (建立者) 的燒錄者角色的使用者可以燒錄記號。 -
BurnNFT - 此方法會停用或燒錄呼叫者帳戶中指定的 NFT，並傳回記號物件和記號歷史記錄。此方法的呼叫者必須有帳戶。除非記號規格檔案包含
burnable行為，否則無法燒錄記號。如果未在規格檔案的roles區段中指定burner_role_name特性，則記號的擁有者可以燒錄記號。如果在roles區段中指定了burner_role_name特性，則使用者若指定了也是記號之探勘器 (建立者) 或擁有者的燃燒器角色，即可燒錄記號。
自訂方式
您可以使用記號 SDK 方法，為您的商業應用程式撰寫自訂方法。
下列範例顯示如何在自訂方法中使用記號 SDK 方法。呼叫 Sell 方法時，會針對指定的價格張貼記號以供銷售。
func (t *Controller) Sell(tokenId string, sellingPrice int) (interface{}, error) {
var tokenAsset ArtCollection
_, err := t.Ctx.ERC721Token.Get(tokenId, &tokenAsset)
if err != nil {
return nil, err
}
/** * price is a custom asset
attribute to set the price of a non-fungible token in the
marketplace */
tokenAsset.Price = sellingPrice
/** * on_sale_flag is a
custom asset attribute that maintains non-fungible token selling status in the
marketplace */
tokenAsset.On_sale_flag = true
_, err = t.Ctx.ERC721Token.UpdateToken(tokenAsset)
if err != nil {
return nil, err
}
msg := fmt.Sprintf("Token ID : %s has been posted for selling in the marketplace", tokenId)
return msg, nil
}NFT SDK 方法
存取控制管理方法
NFT SDK 提供存取控制功能。某些方法只能由記號的
Token Admin 或 Account Owner 呼叫。您可以使用此功能來確保只由預期的使用者執行作業。任何未授權的存取都會導致錯誤。若要使用存取控制功能，請從 ../lib/auth 模組匯入 Authorization 類別。import { ERC721Authorization } from '../lib/erc721-auth';-
AddAdmin - 此方法會將使用者新增為權杖鏈碼的
Token Admin。 -
RemoveAdmin - 此方法會移除使用者作為記號鏈碼的
Token Admin。 -
IsUserTokenAdmin - 如果函數的呼叫程式是
Token Admin，此方法會傳回布林值true的對應。否則，方法會傳回false。 -
GetAllAdmins - 此方法會傳回所有
Token Admin使用者的清單。 -
GetAllAdminUsers - 此方法會傳回所有
Token Admin使用者的清單。 -
CheckAuthorization - 使用此方法將存取控制檢查新增至作業。大多數自動產生的方法都包括存取控制。某些記號方法只能由記號的
ERC721Admin或Account Owner執行，或由MultipleAccountOwner針對具有多個帳戶的使用者執行。CheckAuthorization方法是erc721Auth套裝軟體的一部分，您可以透過Ctx結構 (接收者) 存取此套裝軟體。存取控制對應在oChainUtil.go檔案中說明，如下文所示。您可以編輯oChainUtil.go檔案來修改存取控制。若要使用自己的存取控制或停用存取控制，請從自動產生的控制器方法和自訂方法中移除存取控制碼。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 var erc721ad ERC721AdminAccess var erc721t ERC721TokenAccess var erc721r ERC721RoleAccess var erc721a ERC721AccountAccess var erc721as ERC721AccountStatusAccess var erc721trx ERC721TransactionAccess 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"} erc721ad.AddAdmin = []string{"Admin"} erc721ad.GetAllAdmins = []string{"Admin"} erc721ad.IsTokenAdmin = []string{"Admin"} erc721ad.RemoveAdmin = []string{"Admin"} erc721trx.DeleteHistoricalTransactions = []string{"Admin"} erc721t.Save = []string{"Admin"} erc721t.GetAllTokens = []string{"Admin"} erc721t.Update = []string{"Admin"} erc721t.GetTokensByName = []string{"Admin"} erc721t.AddRoleMember = []string{"Admin"} erc721t.RemoveRoleMember = []string{"Admin"} erc721t.IsInRole = []string{"Admin", "AccountOwner"} erc721t.Get = []string{"Admin", "TokenOwner"} erc721t.GetAllTokensByUser = []string{"Admin", "AccountOwner"} erc721t.TotalSupply = []string{"Admin"} erc721t.TotalNetSupply = []string{"Admin"} erc721t.History = []string{"Admin"} erc721a.CreateAccount = []string{"Admin"} erc721a.CreateUserAccount = []string{"Admin"} erc721a.CreateTokenAccount = []string{"Admin"} erc721a.AssociateFungibleTokenToAccount = []string{"Admin", "AccountOwner"} erc721a.GetAllAccounts = []string{"Admin"} erc721a.History = []string{"Admin", "AccountOwner"} erc721a.GetAccountTransactionHistory = []string{"Admin", "AccountOwner"} erc721a.GetAccountTransactionHistoryWithFilters = []string{"Admin", "AccountOwner"} erc721a.GetAccountByUser = []string{"Admin", "MultipleAccountOwner"} erc721a.BalanceOf = []string{"Admin", "MultipleAccountOwner"} erc721as.Get = []string{"Admin", "AccountOwner"} erc721as.ActivateAccount = []string{"Admin"} erc721as.SuspendAccount = []string{"Admin"} erc721as.DeleteAccount = []string{"Admin"} erc721r.GetAccountsByRole = []string{"Admin"} erc721r.GetUsersByRole = []string{"Admin"} var accessMap TokenAccessControl accessMap.Token = t accessMap.Account = a accessMap.AccountStatus = as accessMap.Hold = h accessMap.Role = r accessMap.Admin = ad accessMap.Auth = auth accessMap.TokenConversion = tc accessMap.ERC721ADMIN = erc721ad accessMap.ERC721TOKEN = erc721t accessMap.ERC721ACCOUNT = erc721a accessMap.ERC721AccountStatus = erc721as accessMap.ERC721ROLE = erc721r accessMap.ERC721TRANSACTION = erc721trx
權杖組態管理方法
-
CreateToken - 這個方法會建立一個記號，並將它的特性儲存到狀態資料庫中。只有具備 minter 角色的使用者才能呼叫此方法。
-
GetAllTokens - 此方法會傳回狀態資料庫中儲存的所有記號資產。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
GetAllTokensByUser - 此方法會傳回指定帳戶 ID 擁有的所有記號。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
GetTokenUri - 此方法會傳回所指定記號的記號 URI。
-
History - 此方法會傳回指定記號的歷史記錄。
-
Get - 如果指定的記號物件存在於狀態資料庫中，此方法會傳回該物件。
-
OwnerOf - 此方法會傳回所指定記號之擁有者的帳戶 ID。
-
Name - 這個方法會傳回記號類別的名稱。
-
Symbol - 這個方法會傳回記號類別的符號。
-
TokenUri - 此方法會傳回所指定記號的記號 URI。
-
TotalSupply - 此方法會傳回所提示的 NFT 總數。
-
UpdateToken - 此方法會更新記號特性。權杖的擁有者或建立者才能呼叫此方法。記號資產建立之後，只有記號擁有者可以更新記號自訂特性。如果使用者同時是權杖擁有者和權杖建立者，他們也可以更新
TokenDesc特性。無法更新權杖描述資料。即使您只想更新特定特性，也必須將所有記號特性傳送給此方法。 -
GetNewCtx - 此方法會傳回新的
TrxContext物件。trxcontext結構包含所有 SDK 程式庫的參考。只使用這個物件來存取 sdk 方法。當並行交易執行時，trxcontext物件會維持 SDK 程式庫中交易存根的相互排除性。
帳戶管理方法
-
GenerateAccountId - 此方法會傳回帳戶 ID，此 ID 是透過串連成員服務提供者 ID (
orgId) 和使用者名稱或電子郵件 ID (userId) 所形成，然後建立 SHA-256 雜湊。 -
CreateAccount - 此方法會為指定的使用者建立帳戶。必須為任何需要記號的使用者建立帳戶。帳戶會追蹤使用者擁有的 NFT 數目。使用者必須在網路中擁有帳戶，才能完成權杖相關作業。每個使用者只能建立一個 NFT 帳戶。
帳戶 ID 是英數字元集，前面加上
oaccount~，後面接著目前網路組織中使用者之成員服務提供者 ID (org_id) 的 SHA-256 雜湊、執行處理擁有者的使用者名稱或電子郵件 ID (userId) 或登入執行處理的使用者，以及常數字串nft。 -
BalanceOf - 此方法會傳回指定使用者保留的 NFT 總數。
-
GetAllAccounts - 這個方法會傳回所有帳號的清單。此方法使用 Berkeley DB SQL RTF 查詢，而且只能在連線至遠端 Oracle Blockchain Platform 網路時呼叫。
-
GetAccountByUser - 此方法會傳回指定使用者的帳戶詳細資料。只有鏈碼的
Token Admin或帳戶的Account Owner才能呼叫此方法。 -
GetUserByAccountId - 此方法會傳回指定帳戶的使用者詳細資料。
-
History - 此方法會傳回指定帳戶的帳戶歷史記錄詳細資料陣列。
-
GetAccountWithStatusByUser - 此方法會傳回指定使用者的帳戶詳細資料，包括帳戶狀態。只有鏈碼的
Token Admin或帳戶的Account Owner才能呼叫此方法。
角色管理方法
-
AddRoleMember - 此方法會將角色新增至指定的使用者。
-
RemoveRoleMember - 這個方法會從指定的使用者和記號中移除角色。帳戶 ID 的形成方式是建立鏈結成員服務提供者 ID (
orgId) 的 SHA-256 雜湊，以及使用者名稱或電子郵件 ID (userId)。 -
GetAccountsByRole - 此方法會傳回指定角色的所有帳戶 ID 清單。
-
GetUsersByRole - 此方法會傳回指定角色的所有使用者清單。
-
IsInRole - 此方法會傳回布林值，指示使用者和記號是否具有指定的角色。帳戶 ID 的形成方式是建立鏈結成員服務提供者 ID (
orgId) 的 SHA-256 雜湊，以及使用者名稱或電子郵件 ID (userId)。
交易歷史記錄管理的方式
-
GetAccountTransactionHistory - 此方法會傳回指定帳戶的交易記錄詳細資料陣列。
-
GetAccountTransactionHistoryWithFilters - 此方法會傳回依
PageSize、Bookmark、startTime和endTime篩選之指定使用者的帳戶交易歷史記錄。只有在連線至遠端 Oracle Blockchain Platform 網路時才能呼叫此方法。 -
GetTransactionById - 此方法會傳回
Transaction資產的歷史記錄。 -
DeleteHistoricalTransactions - 此方法會從狀態資料庫中刪除早於指定日期的交易。
權杖行為管理 - 可變行為
-
GetMaxMintQuantity - 此方法會傳回記號的最大可移動數量。如果規格檔案中未設定
max_mint_quantity行為，則預設值為 0，且可提示不限數目的記號。 -
GetTotalMintedTokens - 此方法會傳回系統中指定記號可用的記號總數。可用的記號網路數目是經過提示的記號總數減去已燒錄的記號數目。
權杖行為管理 - 可傳輸行為
-
SafeTransferFrom - 這個方法會將指定 NFT 的所有權從呼叫者轉移到另一個帳戶。此方法包含下列驗證：
- 記號存在且未燒錄。
- 寄件人帳戶與接收者帳戶已存在，且不是相同的帳戶。
- 寄件者帳戶擁有權杖。
- 函數的呼叫程式是寄件者。
-
TransferFrom - 此方法會將指定 NFT 的所有權從寄件者帳戶轉移至接收者帳戶。呼叫者必須負責傳送正確的參數。任何使用者都可以呼叫此方法，而不只是記號擁有者。此方法包含下列驗證：
- 記號存在且未燒錄。
- 寄件人帳戶與接收者帳戶已存在，且不是相同的帳戶。
- 寄件者帳戶擁有權杖。
權杖行為管理 - 可燒錄行為