Tokens sur Solana

Les tokens sont des actifs numériques qui représentent la propriété de diverses catégories d'actifs. La tokenisation permet la numérisation des droits de propriété. Les tokens sur Solana sont appelés tokens SPL (Solana Program Library).

Cette section couvre les concepts de base de la représentation des tokens sur Solana. Consultez la section Principes de base des tokens SPL pour des exemples de code.

Points clés

• Les Token Programs contiennent toute la logique d'instruction pour interagir avec les tokens sur le réseau (à la fois fongibles et non fongibles).

• Un Mint Account représente un token spécifique et stocke des métadonnées globales sur le token comme l'offre totale et l'autorité de mint (adresse autorisée à créer de nouvelles unités d'un token).

• Un Token Account suit la propriété individuelle des tokens pour un mint account spécifique pour un propriétaire spécifique.

• Un Associated Token Account est un Token Account créé avec une adresse dérivée des adresses du propriétaire et du mint account.

Token Programs

L'écosystème Solana possède deux Token Programs principaux. Code source pour les deux programmes ci-dessous.

Les Token Programs contiennent toute la logique d'instruction pour interagir avec les tokens sur le réseau (à la fois fongibles et non fongibles). Tous les tokens sur Solana sont effectivement des comptes de données détenus par un Token Program.

Token Program

Mint Account

Les tokens sur Solana sont identifiés de manière unique par l'adresse d'un Mint Account détenu par le Token Program. Ce compte agit comme un compteur global pour un token spécifique et stocke des données telles que:

• Approvisionnement : Approvisionnement total du token
• Décimales : Précision décimale du token
• Autorité de frappe : Le compte autorisé à créer de nouvelles unités du token, augmentant ainsi l'approvisionnement
• Autorité de gel : Le compte autorisé à geler des tokens dans un token account, les empêchant d'être transférés ou brûlés

Compte Mint

Les détails complets stockés sur chaque mint account comprennent les éléments suivants :

pub struct Mint {
    /// Optional authority used to mint new tokens. The mint authority may only
    /// be provided during mint creation. If no mint authority is present
    /// then the mint has a fixed supply and no further tokens may be
    /// minted.
    pub mint_authority: COption<Pubkey>,
    /// Total supply of tokens.
    pub supply: u64,
    /// Number of base 10 digits to the right of the decimal place.
    pub decimals: u8,
    /// Is `true` if this structure has been initialized
    pub is_initialized: bool,
    /// Optional authority to freeze token accounts.
    pub freeze_authority: COption<Pubkey>,
}

Pour référence, voici un lien Solana Explorer vers le mint account USDC.

Token Account

Le Token Program crée des token accounts pour suivre la propriété individuelle de chaque unité de token. Un token account stocke des données telles que :

• Mint : Le token dont le token account détient des unités
• Propriétaire : Le compte autorisé à transférer des tokens depuis le token account
• Montant : Nombre de tokens que le token account détient actuellement

Token Account

Les détails complets stockés sur chaque token account comprennent les éléments suivants :

pub struct Account {
    /// The mint associated with this account
    pub mint: Pubkey,
    /// The owner of this account.
    pub owner: Pubkey,
    /// The amount of tokens this account holds.
    pub amount: u64,
    /// If `delegate` is `Some` then `delegated_amount` represents
    /// the amount authorized by the delegate
    pub delegate: COption<Pubkey>,
    /// The account's state
    pub state: AccountState,
    /// If is_native.is_some, this is a native token, and the value logs the
    /// rent-exempt reserve. An Account is required to be rent-exempt, so
    /// the value is used by the Processor to ensure that wrapped SOL
    /// accounts do not drop below this threshold.
    pub is_native: COption<u64>,
    /// The amount delegated
    pub delegated_amount: u64,
    /// Optional authority to close the account.
    pub close_authority: COption<Pubkey>,
}

Un portefeuille a besoin d'un token account pour chaque token (mint) qu'il souhaite détenir, avec l'adresse du portefeuille définie comme propriétaire du token account. Chaque portefeuille peut posséder plusieurs token accounts pour le même token (mint), mais un token account ne peut avoir qu'un seul propriétaire et détenir des unités d'un seul token (mint).

Relation des Comptes

Associated Token Account

Les associated token accounts simplifient le processus de recherche de l'adresse d'un token account pour un mint et un propriétaire spécifiques. Considérez l'associated token account comme le token account "par défaut" pour un mint et un propriétaire spécifiques.

Un Compte Token Associé est créé avec une adresse dérivée de l'adresse du propriétaire et de l'adresse du compte mint. Il est important de comprendre qu'un Compte Token Associé n'est qu'un compte token avec une adresse spécifique.

Cela introduit un concept clé dans le développement Solana : Program Derived Address (PDA). Un PDA dérive une adresse de manière déterministe en utilisant des entrées prédéfinies, facilitant ainsi la recherche de l'adresse d'un compte.

Compte Token Associé

Notez que chaque portefeuille a besoin de son propre compte token pour détenir des tokens provenant du même mint.

Relations de Comptes Étendues

Exemples CLI de Token

La CLI spl-token vous aide à expérimenter avec les tokens SPL. Les exemples ci-dessous utilisent le terminal Solana Playground pour exécuter des commandes CLI directement dans le navigateur sans installation locale.

La création de tokens et de comptes nécessite du SOL pour les dépôts de rent de compte et les frais de transaction. Pour les nouveaux utilisateurs de Solana Playground, créez un portefeuille Playground et exécutez la commande solana airdrop dans le terminal Playground. Vous pouvez également obtenir du SOL devnet depuis le faucet web public.

$ 
solana airdrop 2Copy

Exécutez spl-token --help pour voir toutes les commandes disponibles.

$ 
spl-token --helpCopy

Pour installer la CLI spl-token localement, exécutez :

$ 
cargo install spl-token-cliCopy

Trouvez plus d'exemples dans la documentation spl-token.

Créer un nouveau token

Pour créer un nouveau token (compte mint), exécutez :

$ 
spl-token create-tokenCopy

La sortie ressemble à :

Creating token 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg

Address:  99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg
Decimals:  9

Signature: 44fvKfT1ezBUwdzrCys3fvCdFxbLMnNvBstds76QZyE6cXag5NupBprSXwxPTzzjrC3cA6nvUZaLFTvmcKyzxrm1

Un nouveau compte mint commence avec une offre nulle. Vérifiez l'offre actuelle avec :

$ 
spl-token supply <TOKEN_ADDRESS>Copy

La commande supply pour un nouveau jeton renvoie 0 :

spl-token supply 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg

La création d'un nouveau compte mint nécessite une transaction avec deux instructions. Voici un exemple en Javascript sur Solana Playground.

1. Le System Program crée un nouveau compte avec l'espace nécessaire pour les données du compte mint et transfère la propriété au Token Program.

2. Le Token Program initialise les données du nouveau compte en tant que compte mint

Créer un compte de jetons

Pour détenir des jetons d'un mint spécifique, créez un compte de jetons :

$ 
spl-token create-account <TOKEN_ADDRESS>Copy

Exemple de commande :

spl-token create-account 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg

Sortie :

Creating account AfB7uwBEsGtrrBqPTVqEgzWed5XdYfM1psPNLmf7EeX9

Signature: 2BtrynuCLX9CNofFiaw6Yzbx6hit66pup9Sk7aFjwU2NEbFz7NCHD9w9sWhrCfEd73XveAGK1DxFpJoQZPXU9tS1

La commande create-account crée un associated token account avec votre adresse de portefeuille comme propriétaire.

Pour créer un compte de jetons avec un propriétaire différent :

$ 
spl-token create-account --owner <OWNER_ADDRESS> <TOKEN_ADDRESS>Copy

Remarque : <TOKEN_ADDRESS> spécifie le compte mint pour le compte de jetons.

Exemple de commande :

spl-token create-account --owner 2i3KvjDCZWxBsqcxBHpdEaZYQwQSYE6LXUMx5VjY5XrR 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg

Sortie :

Creating account Hmyk3FSw4cfsuAes7sanp2oxSkE9ivaH6pMzDzbacqmt

Signature: 44vqKdfzspT592REDPY4goaRJH3uJ3Ce13G4BCuUHg35dVUbHuGTHvqn4ZjYF9BGe9QrjMfe9GmuLkQhSZCBQuEt

La création d'un associated token account nécessite une instruction qui invoque le Associated Token Program. Voici un exemple en Javascript sur Solana Playground.

L'Associated Token Program utilise des invocations inter-programmes pour :

• Invoquer le System Program pour créer un nouveau compte en utilisant le PDA fourni comme adresse
• Invoquer le Token Program pour initialiser les données du compte de jetons

Pour créer un nouveau compte de jetons avec une nouvelle keypair au lieu d'une adresse de compte de jetons associé, envoyez une transaction avec deux instructions. Voici un exemple en Javascript sur Solana Playground.

1. Le System Program crée un nouveau compte avec l'espace pour les données du compte de jetons et transfère la propriété au Token Program.

2. Le Token Program initialise les données comme un compte de jetons

Frapper des jetons

Pour créer de nouvelles unités d'un jeton, frappez des jetons vers un compte de jetons :

$ 
spl-token mint [OPTIONS] <TOKEN_ADDRESS> <TOKEN_AMOUNT> [--] [RECIPIENT_TOKEN_ACCOUNT_ADDRESS]Copy

Exemple de commande :

spl-token mint 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg 100

Sortie :

Minting 100 tokens
  Token: 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg
  Recipient: AfB7uwBEsGtrrBqPTVqEgzWed5XdYfM1psPNLmf7EeX9

Signature: 2NJ1m7qCraPSBAVxbr2ssmWZmBU9Jc8pDtJAnyZsZJRcaYCYMqq1oRY1gqA4ddQno3g3xcnny5fzr1dvsnFKMEqG

Pour frapper des jetons vers un compte de jetons différent :

spl-token mint 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg 100 -- Hmyk3FSw4cfsuAes7sanp2oxSkE9ivaH6pMzDzbacqmt

Sortie :

Minting 100 tokens
  Token: 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg
  Recipient: Hmyk3FSw4cfsuAes7sanp2oxSkE9ivaH6pMzDzbacqmt

Signature: 3SQvNM3o9DsTiLwcEkSPT1Edr14RgE2wC54TEjonEP2swyVCp2jPWYWdD6RwXUGpvDNUkKWzVBZVFShn5yntxVd7

L'instruction MintTo sur le Token Program crée de nouveaux jetons. L'autorité de frappe doit signer la transaction. L'instruction frappe des jetons vers un compte de jetons et augmente l'approvisionnement total sur le mint account. Voici un exemple en Javascript sur Solana Playground.

Transférer des jetons

Pour transférer des jetons entre comptes de jetons :

spl-token transfer [OPTIONS] <TOKEN_ADDRESS> <TOKEN_AMOUNT> <RECIPIENT_ADDRESS or RECIPIENT_TOKEN_ACCOUNT_ADDRESS>

Exemple de commande :

spl-token transfer 99zqUzQGohamfYxyo8ykTEbi91iom3CLmwCA75FK5zTg 100 Hmyk3FSw4cfsuAes7sanp2oxSkE9ivaH6pMzDzbacqmt

Sortie :

Transfer 100 tokens
  Sender: AfB7uwBEsGtrrBqPTVqEgzWed5XdYfM1psPNLmf7EeX9
  Recipient: Hmyk3FSw4cfsuAes7sanp2oxSkE9ivaH6pMzDzbacqmt

Signature: 5y6HVwV8V2hHGLTVmTmdySRiEUCZnWmkasAvJ7J6m7JR46obbGKCBqUFgLpZu5zQGwM4Xy6GZ4M5LKd1h6Padx3o

L'instruction Transfer sur le Token Program gère les transferts de jetons. Le propriétaire du compte de jetons de l'expéditeur doit signer la transaction. L'instruction déplace les jetons entre les comptes de jetons. Voici un exemple en Javascript sur Solana Playground.

L'expéditeur et le destinataire ont tous deux besoin de comptes de jetons pour le jeton spécifique (mint). L'expéditeur peut inclure des instructions pour créer le compte de jetons du destinataire dans la même transaction.

Créer des métadonnées de jetons

Le Token Extensions Program vous permet de stocker des métadonnées (nom, symbole, lien d'image) directement sur le Mint Account.

Pour créer un token avec l'extension de métadonnées :

spl-token create-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb --enable-metadata

Sortie :

Creating token BdhzpzhTD1MFqBiwNdrRy4jFo2FHFufw3n9e8sVjJczP under program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
To initialize metadata inside the mint, please run `spl-token initialize-metadata BdhzpzhTD1MFqBiwNdrRy4jFo2FHFufw3n9e8sVjJczP <YOUR_TOKEN_NAME> <YOUR_TOKEN_SYMBOL> <YOUR_TOKEN_URI>`, and sign with the mint authority.

Address:  BdhzpzhTD1MFqBiwNdrRy4jFo2FHFufw3n9e8sVjJczP
Decimals:  9

Signature: 5iQofFeXdYhMi9uTzZghcq8stAaa6CY6saUwcdnELST13eNSifiuLbvR5DnRt311frkCTUh5oecj8YEvZSB3wfai

Pour initialiser les métadonnées :

spl-token initialize-metadata <TOKEN_MINT_ADDRESS> <YOUR_TOKEN_NAME> <YOUR_TOKEN_SYMBOL> <YOUR_TOKEN_URI>

L'URI du token renvoie vers des métadonnées hors chaîne. Consultez un exemple de format JSON ici.

Exemple de commande :

spl-token initialize-metadata BdhzpzhTD1MFqBiwNdrRy4jFo2FHFufw3n9e8sVjJczP "TokenName" "TokenSymbol" "https://raw.githubusercontent.com/solana-developers/opos-asset/main/assets/DeveloperPortal/metadata.json"

Visualisez les métadonnées sur Solana Explorer.

En savoir plus dans le Guide d'extension de métadonnées. Pour plus de détails sur Token Extensions, consultez le guide Premiers pas de Token Extensions et la documentation SPL.