Gerüste Go NFT Projekt für ERC-721
Blockchain App Builder übernimmt die Eingabe aus Ihrer NFT-Spezifikationsdatei und generiert ein voll funktionsfähiges Gerüstkettencode-Projekt.
Das Projekt generiert automatisch NFT-Lebenszyklusklassen und -Funktionen, einschließlich CRUD- und Nicht-CRUD-Methoden. Die Validierung von Argumenten, das Marshalling/Unmarshalling und die transparente Persistenzfunktion werden automatisch unterstützt.
Informationen zum Gerüstprojekt und zu Methoden, die nicht direkt mit NFTs in Verbindung stehen, finden Sie unter Scaffolded Go Chaincode Project.
Modell
Transparente Persistenzfähigkeit oder vereinfachtes ORM wird in der Klasse OchainModel
erfasst.
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"`
}
Controller
Es gibt nur einen Hauptcontroller.
type Controller struct {
Ctx trxcontext.TrxContext
}
Sie können eine beliebige Anzahl von Klassen, Funktionen oder Dateien erstellen, aber nur die Methoden, die in der Hauptcontrollerklasse definiert sind, können nicht verwendet werden. Die anderen Methoden sind verborgen.
Mit den Token-SDK-Methoden können Sie benutzerdefinierte Methoden für Ihre Geschäftsanwendung schreiben.
Automatisch generierte NFT-Methoden
Blockchain App Builder generiert automatisch Methoden zur Unterstützung von NFTs und NFT-Lebenszyklen. Mit diesen Methoden können Sie NFTs initialisieren, Rollen und Accounts verwalten und andere NFT-Lebenszyklusaufgaben ohne zusätzliche Codierung abschließen.
Blockchain App Builder generiert automatisch Methoden zur Unterstützung von NFTs und NFT-Lebenszyklen. Mit diesen Methoden können Sie NFTs initialisieren, Rollen und Accounts verwalten und andere NFT-Lebenszyklusaufgaben ohne zusätzliche Codierung abschließen. Controller-Methoden müssen öffentlich sein, damit sie nicht verwendet werden können. Öffentliche Methodennamen beginnen mit einem Großbuchstaben. Methodennamen, die mit einem Kleinbuchstaben beginnen, sind privat.
- Access Control Management
- Tokenkonfigurationsverwaltung
- Account Management
- Rollenverwaltung
- Transaktionshistorienverwaltung
- Verwaltung des Tokenverhaltens
Methoden für Access Control Management
-
AddTokenAdmin
- Mit dieser Methode wird ein Benutzer als
Token Admin
des Chaincodes hinzugefügt. Diese Methode kann nur von einemToken Admin
des Chaincodes aufgerufen werden. -
RemoveTokenAdmin
- Mit dieser Methode wird ein Benutzer als
Token Admin
des Chaincodes entfernt. Diese Methode kann nur von einemToken Admin
des Chaincodes aufgerufen werden. Sie können diese Methode nicht verwenden, um sich selbst alsToken Admin
zu entfernen. -
IsTokenAdmin
- Diese Methode gibt den booleschen Wert
true
zurück, wenn der Aufrufer der Funktion einToken Admin
ist. Andernfalls wirdfalse
zurückgegeben. EineToken Admin
kann diese Funktion für jeden anderen Benutzer im Blockchain-Netzwerk aufrufen. Andere Benutzer können diese Methode nur auf ihren eigenen Konten aufrufen. -
GetAllTokenAdmins
- Diese Methode gibt eine Liste aller Benutzer zurück, die ein
Token Admin
des Chaincodes sind. Diese Methode kann nur vomToken Admin
des Chaincodes aufgerufen werden.
Methoden für die Tokenkonfigurationsverwaltung
-
Init
- Diese Methode wird aufgerufen, wenn der Chaincode instanziiert wird. Alle
Token Admin
werden durch die InformationenUserId
undOrgId
im ParameteradminList
identifiziert.UserId
ist der Benutzername oder die E-Mail-ID des Instanzeigentümers oder des bei der Instanz angemeldeten Benutzers. DieOrgId
ist die Membership Service Provider-(MSP-)ID des Benutzers in der aktuellen Netzwerkorganisation. Der ParameteradminList
ist beim ersten Deployment des Chaincodes obligatorisch. Wenn Sie den Chaincode upgraden, übergeben Sie eine leere Liste ([]
). Alle anderen Informationen im ParameteradminList
werden bei Upgrades ignoriert. -
GetAllTokens
- Diese Methode gibt alle Tokenassets zurück, die in der Statusdatenbank gespeichert sind. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird. -
GetAllTokensByUser
- Diese Methode gibt alle Tokenassets zurück, deren Eigentümer ein angegebener Benutzer ist. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder vom Accounteigentümer aufgerufen werden. -
GetTokenById
- Diese Methode gibt ein Tokenobjekt zurück, wenn das Token in der Statusdatenbank vorhanden ist. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder des Tokeneigentümers aufgerufen werden. -
GetTokenHistory
- Diese Methode gibt die Historie für eine angegebene Token-ID zurück. Diese Methode kann nur aufgerufen werden, wenn sie mit dem Remote-Netzwerk von Oracle Blockchain Platform verbunden ist. Jeder kann diese Methode nennen.
-
getTokenObject
- Dies ist eine Utilitymethode, die eine Instanz des Tokens für eine angegebene Token-ID zurückgibt. Diese Methode wird von vielen automatisch generierten Methoden zum Abrufen von Tokenobjekten verwendet. Sie können diese Methode nach Bedarf von Ihren benutzerdefinierten Methoden aufrufen. Wenn Sie ein tokenisiertes Asset oder eine tokenisierte Klasse erstellen, aktualisieren Sie den Switch Case mit der entsprechenden
Token
-Klasse, um das richtige Tokenobjekt zurückzugeben. Der Befehlochain sync
in Blockchain App Builder erstellt automatisch einen Switch-Fall, wenn ein tokenisiertes Asset in der Spezifikationsdatei erstellt wird. Da diese Methode privat ist, ist sie nicht direkt aufrufbar und kann nur von anderen Methoden aufgerufen werden. -
OwnerOf
- Diese Methode gibt die Konto-ID des Eigentümers der angegebenen Token-ID zurück. Jeder kann diese Methode nennen.
-
Name
- Diese Methode gibt den Namen der Token-Klasse zurück. Jeder kann diese Methode nennen.
-
Symbol
- Diese Methode gibt das Symbol der Token-Klasse zurück. Jeder kann diese Methode nennen.
-
TokenURI
- Diese Methode gibt den URI eines angegebenen Tokens zurück. Jeder kann diese Methode nennen.
-
TotalSupply
- Diese Methode gibt die Gesamtanzahl der Münztoken zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
TotalNetSupply
- Diese Methode gibt die Gesamtanzahl der Münztoken abzüglich der Anzahl der gebrannten Token zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden.
Methoden für die Accountverwaltung
-
CreateAccount
- Diese Methode erstellt einen Account für einen angegebenen Benutzer und ein Token. Ein Konto muss für jeden Benutzer erstellt werden, der jederzeit Token hat. Konten verfolgen die Anzahl der NFTs, die ein Benutzer hat. Benutzer müssen über Konten im Netzwerk verfügen, um tokenbezogene Vorgänge abzuschließen. Sie können nur einen NFT-Account pro Benutzer erstellen.
Eine Account-ID ist eine alphanumerische Gruppe von Zeichen mit dem Präfix
oaccount~
, gefolgt von einem SHA-256-Hash der Mitgliedschaftsserviceprovider-ID (OrgId
) des Benutzers in der aktuellen Netzwerkorganisation, dem Benutzernamen oder der E-Mail-ID (UserId
) des Instanzeigentümers oder des bei der Instanz angemeldeten Benutzers und der Konstantenzeichenfolgenft
. Diese Methode kann nur vomToken Admin
des Chaincodes aufgerufen werden. -
BalanceOf
- Diese Methode gibt die Gesamtanzahl der NFTs zurück, die ein angegebener Benutzer hält. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder vom Accounteigentümer aufgerufen werden. -
GetAllAccounts
- Diese Methode gibt eine Liste aller Konten zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird. -
GetAccountByUser
- Diese Methode gibt Accountdetails für einen angegebenen Benutzer zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder demAccount Owner
des Accounts aufgerufen werden. -
GetUserByAccountId
- Diese Methode gibt die Benutzerdetails eines angegebenen Accounts zurück. Diese Methode kann von jedem Benutzer aufgerufen werden.
-
GetAccountHistory
- Diese Methode gibt die Accounthistorie für einen angegebenen Benutzer zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder vom Accounteigentümer aufgerufen werden.
Methoden für die Rollenverwaltung
-
AddRole
- Diese Methode fügt einem angegebenen Benutzer eine Rolle hinzu. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
RemoveRole
- Diese Methode entfernt eine Rolle von einem angegebenen Benutzer. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
GetAccountsByRole
- Diese Methode gibt eine Liste aller Konto-IDs für eine angegebene Rolle zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
GetUsersByRole
- Diese Methode gibt eine Liste aller Benutzer für eine angegebene Rolle zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes aufgerufen werden. -
IsInRole
- Diese Methode gibt einen booleschen Wert zurück, der angibt, ob ein Benutzer eine angegebene Rolle hat. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder demAccount Owner
des Accounts aufgerufen werden.
Methoden für das Transaktionshistorienmanagement
-
GetAccountTransactionHistory
- Diese Methode gibt die Kontotransaktionshistorie für einen angegebenen Benutzer zurück. Diese Methode kann vom
Token Admin
des Chaincodes oder vom Eigentümer des Accounts aufgerufen werden. -
GetAccountTransactionHistoryWithFilters
- Diese Methode gibt die Kontotransaktionshistorie für einen angegebenen Benutzer zurück, gefiltert nach
PageSize
,Bookmark
,StartTime
undEndTime
. Diese Methode kann nur aufgerufen werden, wenn sie mit dem Remote-Netzwerk von Oracle Blockchain Platform verbunden ist. Diese Methode kann nur von einemToken Admin
des Chaincodes oder vom Accounteigentümer aufgerufen werden. -
GetTransactionById
- Diese Methode gibt die Transaktionshistorie für eine angegebene Transaktions-ID zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder vom Accounteigentümer aufgerufen werden. -
DeleteHistoricalTransactions
- Diese Methode löscht Transaktionen, die älter als ein angegebener Zeitstempel in der Statusdatenbank sind. Diese Methode kann nur vom
Token Admin
des Chaincodes aufgerufen werden.
Methoden für Token Behavior Management - Mintable Behavior
-
Create<Token Name>Token
- Diese Methode erstellt (mints) eine NFT. Das Asset und die zugehörigen Eigenschaften werden in der Statusdatenbank gespeichert. Der Aufrufer dieser Transaktion muss ein Token-Konto haben. Der Aufrufer dieser Transaktion wird zum Eigentümer der NFT. Wenn die Tokenspezifikationsdatei den Abschnitt
roles
fürbehaviors
und die Eigenschaftminter_role_name
fürroles
enthält, muss der Aufrufer der Transaktion die Minter-Rolle haben. Andernfalls kann jeder Anrufer NFTs prägen. -
Update<Token Name>Token
- Diese Methode aktualisiert Tokeneigenschaften. Diese Methode kann nur von dem Benutzer aufgerufen werden, der Eigentümer oder Ersteller des Tokens ist. Nachdem ein Tokenasset erstellt wurde, kann nur der Tokeneigentümer die benutzerdefinierten Eigenschaften des Tokens aktualisieren. Wenn der Benutzer sowohl Tokeneigentümer als auch Ersteller eines Tokens ist, kann er auch die Eigenschaft
TokenDesc
aktualisieren. Tokenmetadaten können nicht aktualisiert werden. Sie müssen alle Token-Eigenschaften an diese Methode übergeben, auch wenn Sie nur bestimmte Eigenschaften aktualisieren möchten.
Methoden für die Verwaltung des Tokenverhaltens - Übertragbares Verhalten
-
SafeTransferFrom
- Diese Methode überträgt das Eigentum an der angegebenen NFT vom Anrufer auf ein anderes Konto. Diese Methode umfasst die folgenden Validierungen:
- Der Token existiert und wird nicht gebrannt.
- Absenderkonto und Empfängerkonto sind vorhanden und nicht dasselbe Konto.
- Der Absenderaccount ist Eigentümer des Tokens.
- Der Aufrufer der Funktion ist der Absender.
-
TransferFrom
- Diese Methode überträgt das Eigentum an der angegebenen NFT von einem Absenderkonto auf ein Empfängerkonto. Es liegt in der Verantwortung des Anrufers, die richtigen Parameter zu übergeben. Diese Methode kann von jedem Benutzer aufgerufen werden, nicht nur vom Token-Eigentümer. Diese Methode umfasst die folgenden Validierungen:
- Der Token existiert und wird nicht gebrannt.
- Absenderkonto und Empfängerkonto sind vorhanden und nicht dasselbe Konto.
- Der Absenderaccount ist Eigentümer des Tokens.
Methoden für die Verwaltung des Tokenverhaltens - Burnable Behavior
-
Burn
- Diese Methode deaktiviert oder brennt die angegebene NFT aus dem Konto des Anrufers. Der Aufrufer dieser Methode muss ein Konto haben. Ein Token kann nur gebrannt werden, wenn die Tokenspezifikationsdatei das Verhalten
burnable
enthält. Wenn im Abschnittroles
der Spezifikationsdatei keine Eigenschaftburner_role_name
angegeben ist, kann der Eigentümer des Tokens das Token brennen. Wenn im Abschnittroles
eine Eigenschaftburner_role_name
angegeben ist, kann der Benutzer die Brennerrolle zuweisen, die auch der Minter (Ersteller) des Tokens ist, das Token brennen. -
BurnNFT
- Diese Methode deaktiviert oder brennt die angegebene NFT aus dem Konto des Aufrufers und gibt ein Tokenobjekt und eine Tokenhistorie zurück. Der Aufrufer dieser Methode muss ein Konto haben. Ein Token kann nur gebrannt werden, wenn die Tokenspezifikationsdatei das Verhalten
burnable
enthält. Wenn im Abschnittroles
der Spezifikationsdatei keine Eigenschaftburner_role_name
angegeben ist, kann der Eigentümer des Tokens das Token brennen. Wenn eineburner_role_name
-Eigenschaft im Abschnittroles
angegeben wird, kann der Benutzer die Burner-Rolle zuweisen, die auch der Minter (Ersteller) oder Eigentümer des Tokens ist, das Token brennen.
Benutzerdefinierte Methoden
Mit den Token-SDK-Methoden können Sie benutzerdefinierte Methoden für Ihre Geschäftsanwendung schreiben.
Das folgende Beispiel zeigt, wie Token-SDK-Methoden in benutzerdefinierten Methoden verwendet werden. Wenn die Methode Sell
aufgerufen wird, wird ein Token für einen bestimmten Preis zum Verkauf gebucht.
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-Methoden
- Access Control Management
- Tokenkonfigurationsverwaltung
- Account Management
- Rollenverwaltung
- Transaktionshistorienverwaltung
- Verwaltung des Tokenverhaltens
Methoden für Access Control Management
Token Admin
oder Account Owner
des Tokens aufgerufen werden. Mit diesem Feature können Sie sicherstellen, dass Vorgänge nur von den beabsichtigten Benutzern ausgeführt werden. Jeder nicht autorisierte Zugriff führt zu einem Fehler. Um die Zugriffskontrollfunktion zu verwenden, importieren Sie die Klasse Authorization
aus dem Modul ../lib/auth
.import { ERC721Authorization } from '../lib/erc721-auth';
-
CheckAuthorization
- Mit dieser Methode können Sie einem Vorgang eine Zugriffskontrollprüfung hinzufügen. Die meisten automatisch generierten Methoden umfassen die Zugriffskontrolle. Bestimmte Tokenmethoden können nur von einem
ERC721Admin
oder demAccount Owner
des Tokens oder von demMultipleAccountOwner
für Benutzer mit mehreren Accounts ausgeführt werden. Die MethodeCheckAuthorization
ist Teil des Packageserc721Auth
, auf das Sie über die StrukturCtx
(Empfänger) zugreifen. Die Zugriffskontrollzuordnung wird in der DateioChainUtil.go
beschrieben, wie im folgenden Text dargestellt. Sie können die Zugriffskontrolle ändern, indem Sie die DateioChainUtil.go
bearbeiten. Um Ihre eigene Zugriffskontrolle zu verwenden oder die Zugriffskontrolle zu deaktivieren, entfernen Sie den Zugriffskontrollcode aus den automatisch generierten Controllermethoden und benutzerdefinierten Methoden.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
-
IsUserTokenAdmin
- Diese Methode gibt eine Zuordnung mit dem booleschen Wert
true
zurück, wenn der Aufrufer der Funktion einToken Admin
ist. Andernfalls gibt die Methodefalse
zurück. -
AddAdmin
- Mit dieser Methode wird ein Benutzer als
Token Admin
des Token Chaincodes hinzugefügt. -
RemoveAdmin
- Mit dieser Methode wird ein Benutzer als
Token Admin
des Token Chaincodes entfernt. -
GetAllAdmins
- Diese Methode gibt eine Liste aller
Token Admin
-Benutzer zurück. -
GetAllAdminUsers
- Diese Methode gibt eine Liste aller
Token Admin
-Benutzer zurück.
Methoden für die Tokenkonfigurationsverwaltung
-
CreateToken
- Diese Methode erstellt ein Token und speichert seine Eigenschaften in der Statusdatenbank. Diese Methode kann nur von Benutzern mit der Minter-Rolle aufgerufen werden.
-
GetTokenUri
- Diese Methode gibt die Token-URI für ein angegebenes Token zurück.
-
TokenUri
- Diese Methode gibt die Token-URI für ein angegebenes Token zurück.
-
Symbol
- Diese Methode gibt das Symbol der Token-Klasse zurück.
-
Name
- Diese Methode gibt den Namen der Token-Klasse zurück.
-
OwnerOf
- Diese Methode gibt die Konto-ID des Eigentümers eines angegebenen Tokens zurück.
-
TotalSupply
- Diese Methode gibt die Gesamtanzahl der geprägten NFTs zurück.
-
GetAllTokens
- Diese Methode gibt alle Tokenassets zurück, die in der Statusdatenbank gespeichert sind. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird.
-
GetAllTokensByUser
- Diese Methode gibt alle Token zurück, für die eine angegebene Konto-ID verantwortlich ist. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird.
-
Get
- Diese Methode gibt das angegebene Tokenobjekt zurück, wenn es in der Statusdatenbank vorhanden ist.
-
UpdateToken
- Diese Methode aktualisiert Tokeneigenschaften. Diese Methode kann nur vom Eigentümer oder Ersteller des Tokens aufgerufen werden. Nachdem ein Tokenasset erstellt wurde, kann nur der Tokeneigentümer die benutzerdefinierten Eigenschaften des Tokens aktualisieren. Wenn der Benutzer sowohl Tokeneigentümer als auch Ersteller eines Tokens ist, kann er auch die Eigenschaft
TokenDesc
aktualisieren. Tokenmetadaten können nicht aktualisiert werden. Sie müssen alle Token-Eigenschaften an diese Methode übergeben, auch wenn Sie nur bestimmte Eigenschaften aktualisieren möchten. -
History
- Diese Methode gibt die Historie für das angegebene Token zurück.
-
GetNewCtx
- Diese Methode gibt ein neues
TrxContext
-Objekt zurück. Die Strukturtrxcontext
enthält Referenzen auf alle SDK-Librarys. Greifen Sie nur mit diesem Objekt auf die SDK-Methoden zu. Das Objekttrxcontext
behält die gegenseitige Exklusivität von Transaktions-Stubs in SDK-Librarys bei, wenn nebenläufige Transaktionen ausgeführt werden.
Methoden für die Accountverwaltung
-
GenerateAccountId
- Diese Methode gibt eine Konto-ID zurück, die durch Verkettung der ID des Mitgliedschaftsserviceproviders (
orgId
) und des Benutzernamens oder der E-Mail-ID (userId
) gebildet wird und dann einen SHA-256-Hash erstellt wird. -
CreateAccount
- Mit dieser Methode wird ein Account für einen angegebenen Benutzer erstellt. Ein Konto muss für jeden Benutzer erstellt werden, der jederzeit Token hat. Konten verfolgen die Anzahl der NFTs, die ein Benutzer hat. Benutzer müssen über Konten im Netzwerk verfügen, um tokenbezogene Vorgänge abzuschließen. Sie können nur einen NFT-Account pro Benutzer erstellen.
Eine Account-ID ist eine alphanumerische Gruppe von Zeichen mit dem Präfix
oaccount~
, gefolgt von einem SHA-256-Hash der Mitgliedschaftsserviceprovider-ID (org_id
) des Benutzers in der aktuellen Netzwerkorganisation, dem Benutzernamen oder der E-Mail-ID (userId
) des Instanzeigentümers oder des bei der Instanz angemeldeten Benutzers und der Konstantenzeichenfolgenft
. -
GetAllAccounts
- Diese Methode gibt eine Liste aller Konten zurück. Diese Methode verwendet SQL-reiche Berkeley DB-Abfragen und kann nur aufgerufen werden, wenn eine Verbindung mit dem Remote-Netzwerk von Oracle Blockchain Platform hergestellt wird.
-
History
- Diese Methode gibt ein Array der Accounthistoriendetails für ein angegebenes Konto zurück.
-
GetUserByAccountId
- Diese Methode gibt die Benutzerdetails für einen angegebenen Account zurück.
-
GetAccountWithStatusByUser
- Diese Methode gibt Accountdetails für einen angegebenen Benutzer zurück, einschließlich Accountstatus. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder demAccount Owner
des Accounts aufgerufen werden. -
GetAccountByUser
- Diese Methode gibt Accountdetails für einen angegebenen Benutzer zurück. Diese Methode kann nur von einem
Token Admin
des Chaincodes oder demAccount Owner
des Accounts aufgerufen werden. -
BalanceOf
- Diese Methode gibt die Gesamtanzahl der NFTs zurück, die der angegebene Benutzer hält.
Methoden für die Rollenverwaltung
-
AddRoleMember
- Diese Methode fügt einem angegebenen Benutzer eine Rolle hinzu.
-
RemoveRoleMember
- Diese Methode entfernt eine Rolle von einem angegebenen Benutzer und Token. Eine Konto-ID wird gebildet, indem ein SHA-256-Hash mit der Serviceprovider-ID der verketteten Mitgliedschaft (
orgId
) und dem Benutzernamen oder der E-Mail-ID (userId
) erstellt wird. -
IsInRole
- Diese Methode gibt einen booleschen Wert zurück, der angibt, ob ein Benutzer und ein Token eine angegebene Rolle haben. Eine Konto-ID wird gebildet, indem ein SHA-256-Hash mit der Serviceprovider-ID der verketteten Mitgliedschaft (
orgId
) und dem Benutzernamen oder der E-Mail-ID (userId
) erstellt wird. -
GetAccountsByRole
- Diese Methode gibt eine Liste aller Konto-IDs für eine angegebene Rolle zurück.
-
GetUsersByRole
- Diese Methode gibt eine Liste aller Benutzer für eine angegebene Rolle zurück.
Methoden für das Transaktionshistorienmanagement
-
GetAccountTransactionHistory
- Diese Methode gibt ein Array der Transaktionshistoriendetails für ein angegebenes Konto zurück.
-
GetAccountTransactionHistoryWithFilters
- Diese Methode gibt die Kontotransaktionshistorie für einen angegebenen Benutzer zurück, gefiltert nach
PageSize
,Bookmark
,startTime
undendTime
. Diese Methode kann nur aufgerufen werden, wenn sie mit dem Remote-Netzwerk von Oracle Blockchain Platform verbunden ist. -
GetTransactionById
- Diese Methode gibt die Historie eines
Transaction
-Assets zurück. -
DeleteHistoricalTransactions
- Diese Methode löscht Transaktionen, die älter als ein angegebenes Datum sind, aus der Statusdatenbank.
Token Behavior Management - Mintable Behavior
-
GetMaxMintQuantity
- Diese Methode gibt die maximale Mindestmenge eines Tokens zurück. Wenn das Verhalten
max_mint_quantity
nicht in der Spezifikationsdatei konfiguriert ist, lautet der Standardwert 0, und eine unbegrenzte Anzahl von Token kann geprägt werden. -
GetTotalMintedTokens
- Diese Methode gibt die Gesamtanzahl der im System verfügbaren Token für das angegebene Token zurück. Die Netto-Anzahl der verfügbaren Token ist die Gesamtanzahl der geprägten Token abzüglich der Anzahl der gebrannten Token.
Token Behavior Management - Übertragbares Verhalten
-
SafeTransferFrom
- Diese Methode überträgt das Eigentum an der angegebenen NFT vom Anrufer auf ein anderes Konto. Diese Methode umfasst die folgenden Validierungen:
- Der Token existiert und wird nicht gebrannt.
- Absenderkonto und Empfängerkonto sind vorhanden und nicht dasselbe Konto.
- Der Absenderaccount ist Eigentümer des Tokens.
- Der Aufrufer der Funktion ist der Absender.
-
TransferFrom
- Diese Methode überträgt das Eigentum an der angegebenen NFT von einem Absenderkonto auf ein Empfängerkonto. Es liegt in der Verantwortung des Anrufers, die richtigen Parameter zu übergeben. Diese Methode kann von jedem Benutzer aufgerufen werden, nicht nur vom Token-Eigentümer. Diese Methode umfasst die folgenden Validierungen:
- Der Token existiert und wird nicht gebrannt.
- Absenderkonto und Empfängerkonto sind vorhanden und nicht dasselbe Konto.
- Der Absenderaccount ist Eigentümer des Tokens.
Token Behavior Management - Brennendes Verhalten
-
Burn
- Diese Methode deaktiviert oder brennt die angegebene NFT aus dem Konto des Anrufers. Der Aufrufer dieser Methode muss ein Konto haben. Ein Token kann nur gebrannt werden, wenn die Tokenspezifikationsdatei das Verhalten
burnable
enthält. Wenn im Abschnittroles
der Spezifikationsdatei keine Eigenschaftburner_role_name
angegeben ist, kann der Eigentümer des Tokens das Token brennen. Wenn im Abschnittroles
eine Eigenschaftburner_role_name
angegeben ist, kann der Benutzer die Brennerrolle zuweisen, die auch der Minter (Ersteller) des Tokens ist, das Token brennen. Die Methodeburn
ist Teil des PackagesERC721Token
, auf das Sie über den Empfänger der StrukturCtx
zugreifen.