Projet échafaudé TypeScript NFT pour ERC-721
Blockchain App Builder prend l'entrée de votre fichier de spécification NFT et génère un projet de code de chaîne entièrement fonctionnel.
Le projet génère automatiquement des classes et des fonctions de cycle de vie NFT, y compris des méthodes CRUD et non CRUD, ainsi qu'une trousse SDK de segmentation en unités. La validation des arguments, la conversion/déconversion des paramètres et la capacité de persistance transparente sont toutes prises en charge automatiquement.
Pour plus d'informations sur le projet échafaudé et les méthodes qui ne sont pas directement liées aux opérations de réseau (NFT), voir Projet de code de chaîne échafaudé TypeScript.
Informations de référence :
Modèle
Chaque classe de modèle segmentée en unités étend la classe OchainModel. Transparent Persistence Capability, ou ORM simplifié, est capturé dans la classe OchainModel.
import * as yup from 'yup';
import { Id, Mandatory, Validate, Default, Embedded, Derived, ReadOnly } from '../../lib/decorators';
import { OchainModel } from '../../lib/ochain-model';
import { STRATEGY } from '../../lib/utils';
import { EmbeddedModel } from '../../lib/ochain-embedded-model';
export class ArtCollectionMetadata extends EmbeddedModel<ArtCollectionMetadata> {
@Validate(yup.string())
public painting_name: string;
@Validate(yup.string())
public description: string;
@Validate(yup.string())
public image: string;
@Validate(yup.string())
public painter_name: string;
}
@Id('tokenId')
export class ArtCollection extends OchainModel<ArtCollection> {
public readonly assetType = 'otoken';
@Mandatory()
@Validate(yup.string().required().matches(/^[A-Za-z0-9][A-Za-z0-9_-]*$/).max(16))
public tokenId: string;
@ReadOnly('artcollection')
public tokenName: string;
@Validate(yup.string().trim().max(256))
public tokenDesc: string;
@ReadOnly('ART')
public symbol: string;
@ReadOnly('erc721+')
public tokenStandard: string;
@ReadOnly('nonfungible')
public tokenType: string;
@ReadOnly('whole')
public tokenUnit: string;
@ReadOnly(["indivisible","singleton","mintable","transferable","burnable","roles"])
public behaviors: string[];
@ReadOnly({minter_role_name: "minter"})
public roles: object;
@ReadOnly({max_mint_quantity: 20000})
public mintable: object;
@Validate(yup.string())
public owner: string;
@Validate(yup.string())
public createdBy: string;
@Validate(yup.string())
public transferredBy: string;
@Validate(yup.string())
public creationDate: string;
@Validate(yup.string())
public transferredDate: string;
@Validate(yup.bool())
public isBurned: boolean;
@Validate(yup.string())
public burnedBy: string;
@Validate(yup.string())
public burnedDate: string;
@Validate(yup.string().max(2000))
public tokenUri: string;
@Embedded(ArtCollectionMetadata)
public metadata: ArtCollectionMetadata;
@Validate(yup.number())
public price: number;
@Validate(yup.boolean())
public on_sale_flag: boolean;
}
Controller
La classe du contrôleur principal étend la classe OchainController. Il n'y a qu'un seul contrôleur principal.
export class DigiCurrCCController extends OchainController{Vous pouvez créer un nombre illimité de classes, de fonctions ou de fichiers, mais seules les méthodes définies dans la classe de contrôleur principale peuvent être appelées. Les autres méthodes sont masquées.
Vous pouvez utiliser les méthodes de la trousse SDK de jeton pour écrire des méthodes personnalisées pour votre application d'affaires.
Méthodes NFT générées automatiquement
Blockchain App Builder génère automatiquement des méthodes pour prendre en charge les NFT et les cycles de vie NFT. Vous pouvez utiliser ces méthodes pour initialiser les NFT, gérer les rôles et les comptes et effectuer d'autres tâches du cycle de vie NFT sans codage supplémentaire. Les méthodes de contrôleur doivent avoir un décorateur @Validator(...params) pour pouvoir être appelées.
- Gestion du contrôle d'accès
- Gestion de la configuration des jetons
- Gestion des comptes
- Gestion des rôles
- Gestion de l'historique des transactions
- Gestion du comportement des jetons
Méthodes de gestion du contrôle d'accès
-
addTokenAdmin - Cette méthode ajoute un utilisateur en tant qu'
Token Admindu code de chaîne. Cette méthode ne peut être appelée que par unToken Admindu code de chaîne. -
removeTokenAdmin - Cette méthode supprime un utilisateur en tant qu'
Token Admindu code de chaîne. Cette méthode ne peut être appelée que par unToken Admindu code de chaîne. -
isTokenAdmin - Cette méthode retourne la valeur booléenne
truesi l'appelant de la fonction estToken Admin, sinon elle retournefalse. UnToken Adminpeut appeler cette fonction sur n'importe quel autre utilisateur du réseau de chaîne de blocs. Les autres utilisateurs ne peuvent appeler cette méthode que sur leurs propres comptes. -
getAllTokenAdmins - Cette méthode retourne la liste de tous les utilisateurs qui sont des
Token Admindu code de chaîne. Cette méthode ne peut être appelée que parToken Admindu code de chaîne.
Méthodes de gestion de la configuration de jeton
-
init - Cette méthode est appelée lorsque le code de chaîne est instancié. Chaque
Token Adminest identifié par les informationsuserIdetorgIddans le paramètreadminList.userIdest le nom d'utilisateur ou l'ID courriel du responsable de l'instance ou de l'utilisateur connecté à l'instance.orgIdest l'ID fournisseur de services d'adhésion (MSP) de l'utilisateur dans l'organisation de réseau courante. Le paramètreadminListest obligatoire lors du premier déploiement du code de chaîne. Si vous mettez à niveau le code de chaîne, transmettez une liste vide ([]). Toutes les autres informations du paramètreadminListsont ignorées lors des mises à niveau. -
getAllTokens - Cette méthode retourne toutes les ressources de jeton enregistrées dans la base de données d'état. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. Cette méthode utilise des interrogations Berkeley DB SQL riches et ne peut être appelée qu'en cas de connexion au réseau distant Oracle Blockchain Platform. -
getAllTokensByUser - Cette méthode retourne toutes les ressources de jeton détenues par un utilisateur spécifié. Cette méthode utilise des interrogations Berkeley DB SQL riches et ne peut être appelée qu'en cas de connexion au réseau distant Oracle Blockchain Platform. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou par le responsable du compte. -
getTokenById - Cette méthode retourne un objet de jeton si le jeton est présent dans la base de données d'état. Cette méthode ne peut être appelée que par
Token Admindu code de chaîne ou du responsable du jeton. -
getTokenHistory - Cette méthode retourne l'historique pour un ID jeton spécifié. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que si elle est connectée au réseau Oracle Blockchain Platform distant. Tout le monde peut appeler cette méthode.
-
getTokenObject - Il s'agit d'une méthode d'utilitaire qui retourne une instance du jeton pour un ID de jeton spécifié. Cette méthode est utilisée par de nombreuses méthodes générées automatiquement pour extraire des objets de jeton. Vous pouvez appeler cette méthode si nécessaire à partir de vos méthodes personnalisées. Lorsque vous créez une ressource ou une classe segmentée en unités, mettez à jour la casse du commutateur avec la classe
Tokencorrespondante pour retourner l'objet de jeton correct. La commandeochain syncdans Blockchain App Builder crée automatiquement un cas de commutateur lorsqu'une ressource segmentée en unités est créée dans le fichier de spécification. Cette méthode n'a pas de décorateur de méthode@Validator(), ce qui signifie que cette méthode n'est pas directement appelable et ne peut être appelée qu'à partir d'autres méthodes. -
ownerOf - Cette méthode retourne l'ID compte du responsable de l'ID jeton spécifié. Tout le monde peut appeler cette méthode.
-
name - Cette méthode retourne le nom de la classe de jeton. Tout le monde peut appeler cette méthode.
-
symbol - Cette méthode retourne le symbole de la classe de jeton. Tout le monde peut appeler cette méthode.
-
tokenURI - Cette méthode retourne l'URI d'un jeton spécifié. Tout le monde peut appeler cette méthode.
-
totalSupply - Cette méthode retourne le nombre total de jetons frappés. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. -
totalNetSupply - Cette méthode retourne le nombre total de jetons frappés moins le nombre de jetons brûlés. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne.
Méthodes de gestion des comptes
-
createAccount - Cette méthode crée un compte pour un utilisateur et un jeton spécifiés. Un compte doit être créé pour tout utilisateur qui aura des jetons à tout moment. Les comptes suivent le nombre d'opérations de transfert de fonds (NFT) dont dispose un utilisateur. Les utilisateurs doivent avoir des comptes dans le réseau pour effectuer des opérations liées au jeton. Vous ne pouvez créer qu'un seul compte NFT par utilisateur.
Un ID compte est un jeu alphanumérique de caractères, précédé de
oaccount~et suivi d'un hachage SHA-256 de l'ID fournisseur de services d'adhésion (orgId) de l'utilisateur dans l'organisation réseau courante, du nom d'utilisateur ou de l'ID courriel (userId) du responsable de l'instance ou de l'utilisateur connecté à l'instance, et de la chaîne constantenft. Cette méthode ne peut être appelée que parToken Admindu code de chaîne. -
balanceOf - Cette méthode retourne le nombre total de TEF qu'un utilisateur spécifié détient. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou par le responsable du compte. -
getAllAccounts - Cette méthode retourne une liste de tous les comptes. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. Cette méthode utilise des interrogations Berkeley DB SQL riches et ne peut être appelée qu'en cas de connexion au réseau distant Oracle Blockchain Platform. -
getAccountByUser - Cette méthode retourne les détails du compte pour un utilisateur spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou leAccount Ownerdu compte. -
getUserByAccountId - Cette méthode retourne les détails de l'utilisateur pour un compte spécifié. Cette méthode peut être appelée par n'importe quel utilisateur.
-
getAccountHistory - Cette méthode retourne l'historique de compte pour un utilisateur spécifié. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que par
Token Admindu code de chaîne ou par le responsable du compte.
Méthodes de gestion des rôles
-
addRole - Cette méthode ajoute un rôle à un utilisateur spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. -
removeRole - Cette méthode supprime un rôle d'un utilisateur spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. -
getAccountsByRole - Cette méthode retourne une liste de tous les ID compte pour un rôle spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. -
getUsersByRole - Cette méthode retourne une liste de tous les utilisateurs pour un rôle spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne. -
isInRole - Cette méthode retourne une valeur booléenne pour indiquer si un utilisateur a un rôle spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou leAccount Ownerdu compte.
Méthodes de gestion de l'historique des transactions
-
getAccountTransactionHistory - Cette méthode retourne l'historique des transactions de compte pour un utilisateur spécifié. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que par
Token Admindu code de chaîne ou par le responsable du compte. -
getAccountTransactionHistoryWithFilters - Cette méthode retourne l'historique des transactions de compte pour un utilisateur spécifié, filtré par
PageSize,Bookmark,startTimeetendTime. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que si elle est connectée au réseau Oracle Blockchain Platform distant. Cette méthode ne peut être appelée que parToken Admindu code de chaîne ou par le responsable du compte. -
getTransactionById - Cette méthode retourne l'historique des transactions pour un ID transaction spécifié. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou par le responsable du compte. -
deleteHistoricalTransactions - Cette méthode supprime les transactions antérieures à un horodatage spécifié dans la base de données d'état. Il s'agit d'une méthode asynchrone. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne.
Méthodes de gestion du comportement des jetons - Comportement mentable
-
create<Token Name>Token - Cette méthode crée (exploite) un NFT. La ressource et les propriétés associées sont enregistrées dans la base de données d'état. L'appelant de cette transaction doit avoir un compte de jeton. L'appelant de cette transaction devient le propriétaire du NFT. Si le fichier de spécification de jeton inclut la section
rolespourbehaviorset la propriétéminter_role_namepourroles, l'appelant de la transaction doit avoir le rôle de filtre. Sinon, tout appelant peut extraire des NFT. -
update<Token Name>Token - Cette méthode met à jour les propriétés du jeton. Cette méthode ne peut être appelée que par l'utilisateur qui est le propriétaire ou le créateur du jeton. Après la création d'une ressource de jeton, seul le responsable du jeton peut mettre à jour les propriétés personnalisées du jeton. Si l'utilisateur est à la fois responsable et créateur d'un jeton, il peut également mettre à jour la propriété
TokenDesc. Les métadonnées du jeton ne peuvent pas être mises à jour. Vous devez transmettre toutes les propriétés de jeton à cette méthode, même si vous souhaitez mettre à jour uniquement certaines propriétés.
Méthodes de gestion du comportement des jetons - Comportement transférable
-
safeTransferFrom - Il s'agit d'une fonction asynchrone. Cette méthode transfère la propriété du NFT spécifié de l'appelant à un autre compte. Cette méthode comprend les validations suivantes :
- Le jeton existe et n'est pas brûlé.
- Le compte de l'expéditeur et le compte destinataire existent et ne sont pas le même compte.
- Le compte de l'expéditeur est responsable du jeton.
- L'appelant de la fonction est l'expéditeur.
-
transferFrom - Il s'agit d'une fonction asynchrone. Cette méthode transfère la propriété du NFT spécifié d'un compte d'expéditeur à un compte de destinataire. Il est de la responsabilité de l'appelant de transmettre les paramètres corrects. Cette méthode peut être appelée par n'importe quel utilisateur, pas seulement par le propriétaire du jeton. Cette méthode comprend les validations suivantes :
- Le jeton existe et n'est pas brûlé.
- Le compte de l'expéditeur et le compte destinataire existent et ne sont pas le même compte.
- Le compte de l'expéditeur est responsable du jeton.
Méthodes pour Token Behavior Management - Burnable Behavior
-
burn - Cette méthode désactive ou brûle le NFT spécifié à partir du compte de l'appelant. L'appelant de cette méthode doit avoir un compte. Un jeton ne peut pas être gravé sauf si le fichier de spécification de jeton inclut le comportement
burnable. Si aucune propriétéburner_role_namen'est spécifiée dans la sectionrolesdu fichier de spécification, le responsable du jeton peut graver le jeton. Si une propriétéburner_role_nameest spécifiée dans la sectionroles, l'utilisateur a affecté le rôle de brûleur qui est également le créateur ou le responsable du jeton peut graver le jeton. -
burnNFT - Cette méthode désactive ou grave le NFT spécifié à partir du compte de l'appelant et retourne un objet de jeton et un historique de jeton. L'appelant de cette méthode doit avoir un compte. Un jeton ne peut pas être gravé sauf si le fichier de spécification de jeton inclut le comportement
burnable. Si aucune propriétéburner_role_namen'est spécifiée dans la sectionrolesdu fichier de spécification, le responsable du jeton peut graver le jeton. Si une propriétéburner_role_nameest spécifiée dans la sectionroles, l'utilisateur a affecté le rôle de brûleur qui est également le créateur ou le responsable du jeton peut graver le jeton.
Méthodes personnalisées
Vous pouvez utiliser les méthodes de la trousse SDK de jeton pour écrire des méthodes personnalisées pour votre application d'affaires.
L'exemple suivant montre comment utiliser des méthodes de trousse SDK de jeton dans des méthodes personnalisées. Lorsque la méthode sell est appelée, elle publie un jeton à vendre pour un prix spécifié.
@Validator(yup.string(), yup.number())
public async sell(token_id: string, selling_price: number) {
try {
const token = await this.Ctx.ERC721Token.get(token_id);
const t = new ArtCollection(token)
/** * price is a custom asset
attribute to set the price of a non-fungible token in the
marketplace */
t.price = selling_price;
/** * on_sale_flag is a
custom asset attribute that maintains non-fungible token selling status in the
marketplace */
t.on_sale_flag = true;
await this.Ctx.ERC721Token.updateToken(t);
let msg = `Token ID : '${token_id}' has been posted for selling in the marketplace'`;
return {msg}
} catch(error) {
throw new Error(error.message);
}
}Méthodes de trousse SDK NFT
- Gestion du contrôle d'accès
- Gestion de la configuration des jetons
- Gestion des comptes
- Gestion des rôles
- Gestion de l'historique des transactions
- Gestion du comportement des jetons
Méthodes de gestion du contrôle d'accès
La trousse SDK NFT fournit une fonction de contrôle d'accès. Certaines méthodes ne peuvent être appelées que par
Token Admin ou Account Owner du jeton. Vous pouvez utiliser cette fonction pour vous assurer que les opérations ne sont effectuées que par les utilisateurs prévus. Tout accès non autorisé entraîne une erreur. Pour utiliser la fonction de contrôle d'accès, importez la classe Authorization à partir du module ../lib/erc721-auth.import { ERC721Authorization } from '../lib/erc721-auth';-
addAdmin - Cette méthode ajoute un utilisateur en tant qu'
Token Admindu code de chaîne de jeton. -
removeAdmin - Cette méthode supprime un utilisateur en tant qu'
Token Admindu code de chaîne de jeton. -
isUserTokenAdmin - Cette méthode retourne la valeur booléenne
truesi l'appelant de la fonction estToken Admin. Sinon, la méthode retournefalse. Il s'agit d'une fonction statique asynchrone. -
getAllAdmins - Cette méthode retourne une liste de tous les utilisateurs
Token Admin. -
checkAuthorization - Utilisez cette méthode pour ajouter une vérification de contrôle d'accès à une opération. Il s'agit d'une fonction asynchrone. La plupart des méthodes générées automatiquement incluent le contrôle d'accès. Certaines méthodes de jeton ne peuvent être exécutées que par
ERC721AdminouAccount Ownerdu jeton ou parMultipleAccountOwnerpour les utilisateurs ayant plusieurs comptes. La méthodecheckAuthorizationfait partie de la classeAuthorization, à laquelle vous accédez au moyen de l'objetCtx. Le mappage du contrôle d'accès est décrit dans le fichier../lib/constant.ts, comme indiqué dans le texte suivant. Vous pouvez modifier le contrôle d'accès en modifiant le fichier../lib/constant.ts. Pour utiliser votre propre contrôle d'accès ou pour désactiver le contrôle d'accès, supprimez le code de contrôle d'accès des méthodes de contrôleur et des méthodes personnalisées générées automatiquement.export const TOKENACCESS = { ADMIN: { isUserTokenAdmin: ['Admin', 'MultipleAccountOwner'], addAdmin: ['Admin'], removeAdmin: ['Admin'], getAllAdmins: ['Admin'], }, TOKEN: { save: ['Admin'], getAllTokens: ['Admin'], get: ['Admin'], update: ['Admin'], getDecimals: ['Admin'], getTokensByName: ['Admin'], addRoleMember: ['Admin'], removeRoleMember: ['Admin'], isInRole: ['Admin', 'AccountOwner'], getTotalMintedTokens: ['Admin'], getNetTokens: ['Admin'], }, ROLE: { getAccountsByRole: ['Admin'], getUsersByRole: ['Admin'], }, TRANSACTION: { deleteTransactions: ['Admin'], }, ACCOUNT: { createAccount: ['Admin'], getAllAccounts: ['Admin'], getAccountsByUser: ['Admin', 'MultipleAccountOwner'], getAccount: ['Admin', 'AccountOwner'], history: ['Admin', 'AccountOwner'], getAccountTransactionHistory: ['Admin', 'AccountOwner'], getAccountBalance: ['Admin', 'AccountOwner'], getAccountOnHoldBalance: ['Admin', 'AccountOwner'], getOnHoldIds: ['Admin', 'AccountOwner'], }, ERC721ADMIN: { isUserTokenAdmin: ['Admin'], addAdmin: ['Admin'], removeAdmin: ['Admin'], getAllAdmins: ['Admin'], }, ERC721TOKEN: { getAllTokens: ['Admin'], getAllTokensByUser: ['Admin', 'AccountOwner'], get: ['Admin', TOKEN_OWNER], getTokensByName: ['Admin'], addRoleMember: ['Admin'], removeRoleMember: ['Admin'], isInRole: ['Admin', 'AccountOwner'], totalSupply: ['Admin'], totalNetSupply: ['Admin'], history: ['Admin'], }, ERC721ROLE: { getAccountsByRole: ['Admin'], getUsersByRole: ['Admin'], }, ERC721TRANSACTION: { deleteTransactions: ['Admin'], }, ERC721ACCOUNT: { createAccount: ['Admin'], getAllAccounts: ['Admin'], getAccountsByUser: ['Admin', 'MultipleAccountOwner'], history: ['Admin', 'AccountOwner'], getAccountTransactionHistory: ['Admin', 'AccountOwner'], getAccountTransactionHistoryWithFilters: ['Admin', 'AccountOwner'], balanceOf: ['Admin', 'MultipleAccountOwner'], } }
Méthodes de gestion de la configuration de jeton
Les méthodes de gestion de la configuration des jetons sont basées sur la norme ERC-721. Pour utiliser les méthodes de gestion de la configuration de jeton, importez la classe Token à partir du module ../lib/erc721-token.
-
createToken - Cette méthode crée un jeton et enregistre ses propriétés dans la base de données d'état. Cette méthode ne peut être appelée que par les utilisateurs ayant le rôle de minter. Il s'agit d'une fonction asynchrone.
-
getAllTokens - Cette méthode retourne toutes les ressources de jeton enregistrées dans la base de données d'état. Cette méthode utilise des interrogations Berkeley DB SQL riches et ne peut être appelée qu'en cas de connexion au réseau distant Oracle Blockchain Platform. Il s'agit d'une fonction statique asynchrone.
-
getAllTokensByUser - Cette méthode retourne tous les jetons appartenant à un ID compte spécifié. Il s'agit d'une fonction statique asynchrone.
-
getTokenUri - Cette méthode retourne l'URI d'un jeton spécifié. Il s'agit d'une fonction statique asynchrone.
-
history - Cette méthode retourne l'historique du jeton spécifié. Il s'agit d'une fonction statique asynchrone.
-
get - Cette méthode retourne l'objet de jeton spécifié s'il est présent dans la base de données d'état. Il s'agit d'une fonction statique asynchrone.
-
ownerOf - Cette méthode retourne l'ID compte du responsable d'un jeton spécifié. Il s'agit d'une fonction statique asynchrone.
-
symbol - Cette méthode retourne le symbole de la classe de jeton.
-
tokenUri - Cette méthode retourne l'URI d'un jeton spécifié. Il s'agit d'une fonction statique asynchrone.
-
totalSupply - Cette méthode retourne le nombre total d'opérations de transfert de fonds (NFT) minées. Il s'agit d'une fonction asynchrone.
-
updateToken - Cette méthode met à jour les propriétés du jeton. Cette méthode ne peut être appelée que par le propriétaire ou le créateur du jeton. Après la création d'une ressource de jeton, seul le responsable du jeton peut mettre à jour les propriétés personnalisées du jeton. Si l'utilisateur est à la fois responsable et créateur d'un jeton, il peut également mettre à jour la propriété
TokenDesc. Les métadonnées du jeton ne peuvent pas être mises à jour. Vous devez transmettre toutes les propriétés de jeton à cette méthode, même si vous souhaitez mettre à jour uniquement certaines propriétés. Il s'agit d'une fonction asynchrone. -
getByRange - Cette méthode appelle la méthode fabric
getStateByRangeen interne. Même si une immobilisation portant le code indiqué provient du grand livre, cette méthode envoie l'immobilisation au type d'immobilisation appelant. Il s'agit d'une fonction statique asynchrone.@validator(yup.string(), yup.string()) public async getDigiCurrGetByRange(startId: string, endId: string) { return await this.Ctx.ERC721TOken.getByRange(startId, endId, PaintingNft); } -
isTokenType - Cette méthode indique si une immobilisation avec jeton existe avec l'ID spécifié. Il s'agit d'une fonction statique asynchrone.
Méthodes de gestion des comptes
-
generateAccountId - Cette méthode retourne un ID compte, formé par la concaténation de l'ID fournisseur de services d'adhésion (
orgId) et du nom d'utilisateur ou de l'ID courriel (userId), puis la création d'un hachage SHA-256. -
createAccount - Cette méthode crée un compte pour un utilisateur et un jeton spécifiés. Un compte doit être créé pour tout utilisateur qui aura des jetons à tout moment. Les comptes suivent le nombre d'opérations de transfert de fonds (NFT) dont dispose un utilisateur. Les utilisateurs doivent avoir des comptes dans le réseau pour effectuer des opérations liées au jeton. Vous ne pouvez créer qu'un seul compte NFT par utilisateur.
Un ID compte est un jeu alphanumérique de caractères, précédé de
oaccount~et suivi d'un hachage SHA-256 de l'ID fournisseur de services d'adhésion (orgId) de l'utilisateur dans l'organisation réseau courante, du nom d'utilisateur ou de l'ID courriel (userId) du responsable de l'instance ou de l'utilisateur connecté à l'instance, et de la chaîne constantenft. Cette méthode ne peut être appelée que parToken Admindu code de chaîne. -
balanceOf - Cette méthode retourne le nombre total de NFT bloqués par l'utilisateur spécifié.
-
getAllAccounts - Cette méthode retourne une liste de tous les comptes. Cette méthode utilise des interrogations Berkeley DB SQL riches et ne peut être appelée qu'en cas de connexion au réseau distant Oracle Blockchain Platform.
-
getAccountByUser - Cette méthode retourne les détails de l'utilisateur pour un compte spécifié. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou leAccount Ownerdu compte. -
getUserByAccountId - Cette méthode retourne les détails de l'utilisateur pour un compte spécifié.
-
history - Cette méthode retourne un tableau des détails de l'historique de compte pour un compte spécifié.
-
getAccountWithStatusByUser - Cette méthode retourne les détails de l'utilisateur pour un compte spécifié, notamment le statut du compte. Cette méthode ne peut être appelée que par un
Token Admindu code de chaîne ou leAccount Ownerdu compte.
Méthodes de gestion des rôles
-
addRoleMember - Cette méthode ajoute un rôle à un utilisateur et à un jeton spécifiés. Un ID compte est formé par la création d'un hachage SHA-256 de l'ID fournisseur de services d'adhésion concaténé (
orgId) et du nom d'utilisateur ou de l'ID courriel (userId). Il s'agit d'une fonction asynchrone. -
removeRoleMember - Cette méthode supprime un rôle d'un utilisateur et d'un jeton spécifiés. Un ID compte est formé par la création d'un hachage SHA-256 de l'ID fournisseur de services d'adhésion concaténé (
orgId) et du nom d'utilisateur ou de l'ID courriel (userId). Il s'agit d'une fonction asynchrone. -
getAccountsByRole - Cette méthode retourne une liste de tous les ID compte pour un rôle spécifié.
-
getUsersByRole - Cette méthode retourne une liste de tous les utilisateurs pour un rôle spécifié.
-
isInRole - Cette méthode retourne une valeur booléenne pour indiquer si un utilisateur et un jeton ont un rôle spécifié. Un ID compte est formé par la création d'un hachage SHA-256 de l'ID fournisseur de services d'adhésion concaténé (
orgId) et du nom d'utilisateur ou de l'ID courriel (userId). Il s'agit d'une fonction asynchrone.
Méthodes de gestion de l'historique des transactions
-
getAccountTransactionHistory - Cette méthode retourne un tableau des détails de l'historique des transactions pour un compte spécifié.
-
getAccountTransactionHistoryWithFilters - Cette méthode retourne l'historique des transactions de compte pour un utilisateur spécifié, filtré par
PageSize,Bookmark,startTimeetendTime. Cette méthode ne peut être appelée que si elle est connectée au réseau Oracle Blockchain Platform distant. -
getTransactionById - Cette méthode retourne l'historique d'une ressource
Transaction. -
deleteHistoricalTransactions - Cette méthode supprime de la base de données d'état les transactions antérieures à une date spécifiée.
Gestion du comportement des jetons - Comportement mentable
-
getMaxMintQuantity - Cette méthode retourne la quantité minimale maximale d'un jeton. Si le comportement
max_mint_quantityn'est pas configuré dans le fichier de spécification, la valeur par défaut est 0 et un nombre infini de jetons peut être extrait. -
getTotalMintedTokens - Cette méthode retourne le nombre total de jetons extraits disponibles dans le système pour le jeton spécifié. Le nombre net de jetons disponibles est le nombre total de jetons frappés moins le nombre de jetons brûlés. Il s'agit d'une fonction asynchrone.
Gestion du comportement des jetons - Comportement transférable
-
safeTransferFrom - Il s'agit d'une fonction asynchrone. Cette méthode transfère la propriété du NFT spécifié de l'appelant à un autre compte. Cette méthode comprend les validations suivantes :
- Le jeton existe et n'est pas brûlé.
- Le compte de l'expéditeur et le compte destinataire existent et ne sont pas le même compte.
- Le compte de l'expéditeur est responsable du jeton.
- L'appelant de la fonction est l'expéditeur.
-
transferFrom - Il s'agit d'une fonction asynchrone. Cette méthode transfère la propriété du NFT spécifié d'un compte d'expéditeur à un compte de destinataire. Il est de la responsabilité de l'appelant de transmettre les paramètres corrects. Cette méthode peut être appelée par n'importe quel utilisateur, pas seulement par le propriétaire du jeton. Cette méthode comprend les validations suivantes :
- Le jeton existe et n'est pas brûlé.
- Le compte de l'expéditeur et le compte destinataire existent et ne sont pas le même compte.
- Le compte de l'expéditeur est responsable du jeton.
Gestion du comportement des jetons - Comportement Burnable
-
burn - Cette méthode désactive ou brûle le NFT spécifié à partir du compte de l'appelant. L'appelant de cette méthode doit avoir un compte. Un jeton ne peut pas être gravé sauf si le fichier de spécification de jeton inclut le comportement
burnable. Si aucune propriétéburner_role_namen'est spécifiée dans la sectionrolesdu fichier de spécification, le responsable du jeton peut graver le jeton. Si une propriétéburner_role_nameest spécifiée dans la sectionroles, l'utilisateur a affecté le rôle de brûleur qui est également le créateur du jeton peut graver le jeton. Il s'agit d'une fonction asynchrone.