Mikä on token-tili
Token-tili tallentaa tokeneita yhdelle mintille ja yhdelle token-tilin omistajalle Solanassa.
/// Account data.#[repr(C)]#[derive(Clone, Copy, Debug, Default, PartialEq)]pub struct Account {/// The mint associated with this accountpub 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 delegatepub delegate: COption<Pubkey>,/// The account's statepub 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 delegatedpub delegated_amount: u64,/// Optional authority to close the account.pub close_authority: COption<Pubkey>,}
Tässä owner tarkoittaa valtuutusta, joka voi siirtää, polttaa tai
delegoida tokeneita token-tililtä. Tilin ohjelma-omistaja on edelleen Token
Program tai Token Extensions Program.
Jokainen token account on sidottu täsmälleen yhteen minttiin, mikä tarkoittaa
että token account voi sisältää vain yhden tokenin yksiköitä, tokenin, jonka
token-tilin mint -kenttä määrittää.
Mikä on liitetty token-tili
Liitetty token-tili (ATA) on lompakon ja mintin oletusarvoinen token-tili. Associated Token Program johtaa ATA-osoitteen lompakon osoitteesta, token-ohjelman osoitteesta ja mintin osoitteesta.
Vain Associated Token Program -ohjelman luomia token-tilejä kutsutaan associated token account -tileiksi.
Associated Token Program on tapa luoda token-tili vakioidussa, deterministisessä osoitteessa. Tuloksena oleva tili on silti token account, jonka omistaa Token Program tai Token Extensions Program, ei Associated Token Program.
Associated Token Program johtaa ATA-osoitteen kuten address.rs -tiedostossa näytetään:
pub fn get_associated_token_address_and_bump_seed_internal(wallet_address: &Pubkey,token_mint_address: &Pubkey,program_id: &Pubkey,token_program_id: &Pubkey,) -> (Pubkey, u8) {Pubkey::find_program_address(&[&wallet_address.to_bytes(), // Owner's public key&token_program_id.to_bytes(), // Token Program or Token Extension Program&token_mint_address.to_bytes(), // Token mint address],program_id, // Associated Token Program ID)}
Jokaiselle lompakolle, token-ohjelmalle ja mintille on täsmälleen yksi
ATA-osoite. Associated Token Program luo vakiomuotoisen token-tilin kyseiseen
osoitteeseen, ja tuloksena oleva tili käyttää edelleen Account -tyyppiä,
jonka Token Program tai Token Extensions Program määrittää.
Kuinka luoda Associated Token Account
Associated token accountin luominen käyttää Associated Token Programin
Create- tai CreateIdempotent-käskyä. Associated Token Program johtaa
ATA-osoitteen, luo tilin ATA-osoitteeseen ja alustaa tilin token accountiksi,
jonka omistaa Token Program tai Token Extension Program.
Suositeltu
Useimmissa sovelluksissa token accountit kannattaa luoda Associated Token Programin kautta sen sijaan, että ne luotaisiin suoraan kutsumalla System Programin ja Token Programin käskyjä. Associated token account käyttää deterministista osoitetta, joka johdetaan omistajasta, token programista ja mintistä, mikä tekee oletusmääräisestä token accountista tietyn mintin kohdalla helpommin löydettävän lompakkosovelluksille.
Lähdeviite
| Kohde | Kuvaus | Lähde |
|---|---|---|
Create | Luo associated token accountin johdettuun ATA-osoitteeseen. | Lähde |
CreateIdempotent | Luo associated token accountin, mutta onnistuu silti, jos kyseinen ATA on jo olemassa samalle omistajalle ja mintille. | Lähde |
process_create_associated_token_account | Johtaa ATA-osoitteen ja käyttää create_pda_account-kutsua sekä CPI-kutsuja valittuun token programiin alustamaan token accountin. Kun valittu ohjelma on Token Extension Program, ATA-prosessori alustaa myös immutable owner -laajennuksen. | Lähde |
create_pda_account | Apuväline, jota process_create_associated_token_account käyttää luomaan PDA-tilin CPI-kutsulla System Programiin. | Lähde |
Typescript
Alla olevat Kit-esimerkit näyttävät suositellun lähestymistavan käyttäen
@solana/kit-kirjastoa. Vanhemmat esimerkit, jotka käyttävät
@solana/web3.js-kirjastoa, on sisällytetty viitteeksi.
Kit
import { generateKeyPairSigner } from "@solana/kit";import { createLocalClient } from "@solana/kit-client-rpc";import {associatedTokenProgram,findAssociatedTokenPda,tokenProgram,TOKEN_PROGRAM_ADDRESS} from "@solana-program/token";const client = await createLocalClient().use(tokenProgram()).use(associatedTokenProgram());const result = await client.associatedToken.instructions.createAssociatedToken({payer: client.payer, // Account funding account creation.mint: mint.address, // Mint for the token this account holds.owner: client.payer.address // Account that owns the token account.}).sendTransaction();const [associatedTokenAddress] = await findAssociatedTokenPda({mint: mint.address,owner: client.payer.address,tokenProgram: TOKEN_PROGRAM_ADDRESS});const tokenAccountData = await client.token.accounts.token.fetch(associatedTokenAddress);console.log("Mint Address:", mint.address);console.log("\nAssociated Token Account Address:", associatedTokenAddress);console.log("Associated Token Account:", tokenAccountData.data);console.log("\nTransaction Signature:", result.context.signature);
Web3.js
import { Connection, Keypair, LAMPORTS_PER_SOL } from "@solana/web3.js";import {createAssociatedTokenAccount,createMint,getAccount,TOKEN_PROGRAM_ID} from "@solana/spl-token";const associatedTokenAccount = await createAssociatedTokenAccount(connection, // Connection to the local validator.feePayer, // Account funding account creation.mintPubkey, // Mint for the token this account holds.feePayer.publicKey, // Account that owns the token account.{commitment: "confirmed" // Confirmation options for the transaction.},TOKEN_PROGRAM_ID // Token program to invoke.);const tokenAccountData = await getAccount(connection,associatedTokenAccount,"confirmed",TOKEN_PROGRAM_ID);console.log("Mint Address:", mintPubkey.toBase58());console.log("\nAssociated Token Account Address:",associatedTokenAccount.toBase58());console.log("Associated Token Account:", tokenAccountData);
Rust
use anyhow::Result;use solana_client::nonblocking::rpc_client::RpcClient;use solana_commitment_config::CommitmentConfig;use solana_sdk::{program_pack::Pack,signature::{Keypair, Signer},transaction::Transaction,};use solana_system_interface::instruction::create_account;use spl_associated_token_account_interface::{address::get_associated_token_address, instruction::create_associated_token_account,};use spl_token_interface::{id as token_program_id,instruction::initialize_mint,state::{Account, Mint},};#[tokio::main]async fn main() -> Result<()> {let client = RpcClient::new_with_commitment(String::from("http://localhost:8899"),CommitmentConfig::confirmed(),);let transaction = Transaction::new_signed_with_payer(&[create_associated_token_account(&fee_payer.pubkey(), // Account funding account creation.&fee_payer.pubkey(), // Account that owns the token account.&mint.pubkey(), // Mint for the token this account holds.&token_program_id(), // Token program that owns the account.),],Some(&fee_payer.pubkey()),&[&fee_payer],latest_blockhash,);let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;let associated_token_account = get_associated_token_address(&fee_payer.pubkey(), &mint.pubkey());let token_account = client.get_account(&associated_token_account).await?;let token_data = Account::unpack(&token_account.data)?;println!("Mint Address: {}", mint.pubkey());println!("\nAssociated Token Account Address: {}",associated_token_account);println!("Associated Token Account: {:#?}", token_data);println!("\nTransaction Signature: {}", transaction_signature);Ok(())}
Python
#!/usr/bin/env python3import asyncioimport jsonfrom solana.rpc.async_api import AsyncClientfrom solders.keypair import Keypairfrom solders.message import Messagefrom solders.pubkey import Pubkeyfrom solders.system_program import create_account, CreateAccountParamsfrom solders.transaction import Transactionfrom spl.token.async_client import AsyncTokenfrom spl.token.instructions import (create_associated_token_account,get_associated_token_address,initialize_mint,InitializeMintParams,)from spl.token.constants import MINT_LEN, TOKEN_PROGRAM_IDasync def main():rpc = AsyncClient("http://localhost:8899")fee_payer = Keypair()owner = Keypair()async with rpc:create_associated_token_account_instruction = create_associated_token_account(payer=fee_payer.pubkey(), # Account funding account creation.owner=owner.pubkey(), # Account that owns the token account.mint=mint.pubkey(), # Mint for the token this account holds.token_program_id=TOKEN_PROGRAM_ID, # Token program that owns the new token account.)latest_blockhash = await rpc.get_latest_blockhash()transaction = Transaction([fee_payer],Message([create_associated_token_account_instruction], fee_payer.pubkey()),latest_blockhash.value.blockhash,)result = await rpc.send_transaction(transaction)token_account_info = await token.get_account_info(associated_token_account)token_account = {key: str(value) if isinstance(value, Pubkey) else valuefor key, value in token_account_info._asdict().items()}print("Mint Address:", mint.pubkey())print("\nToken Account Address:", associated_token_account)print("Token Account:")print(json.dumps(token_account, indent=2))print("\nTransaction Signature:", result.value)if __name__ == "__main__":asyncio.run(main())
Token accountin luominen
Token accountin luominen vaatii kaksi instruktiota:
- System Programin
CreateAccount-instruktio luo uuden rent-vapautetun accountin ja määrittää Token Programin uuden accountin omistajaohjelmaksi. - Token Programin
InitializeAccount-,InitializeAccount2- taiInitializeAccount3-instruktio alustaa uuden accountin mintille ja omistajalle.
Sisällytä CreateAccount-instruktio ja token accountin alustusinstruktio
samaan transaktioon.
Token accountin alustuksen aikana Token Program tarkistaa, että accountia ei ole jo alustettu ja että se on rent-vapautettu.
Alla oleva osio näyttää, kuinka token account luodaan kutsumalla suoraan System Programin ja Token Programin instruktioita. Useimmissa sovelluksissa käytä sen sijaan Associated Token Programia. Käytä suoria System Programin ja Token Programin kutsuja vain, kun sinulla on erityinen syy olla käyttämättä associated token accountia tai kun sinun täytyy luoda mukautettuja PDA token accounteja tekemällä CPI-kutsuja System Programin ja Token Programin instruktioihin omasta Solana-ohjelmastasi.
Lähdeviite
| Kohde | Kuvaus | Token Program | Token Extensions Program |
|---|---|---|---|
Account | Perus token account -kentät, jotka on tallennettu jokaiseen token accountiin. | Lähde | Lähde |
InitializeAccount | Token accountin alustusinstruktio, joka odottaa omistajan ja rent sysvar accountin accounttien listassaan. | Lähde | Lähde |
InitializeAccount2 | Token accountin alustusinstruktio, joka välittää omistajan instruction datassa accounttien listan sijaan. | Lähde | Lähde |
InitializeAccount3 | Token accountin alustusinstruktio, joka välittää omistajan instruction datassa eikä vaadi rent sysvar accountia. | Lähde | Lähde |
_process_initialize_account | Jaettu prosessorilogiikka token accountin alustukselle. | Lähde | Lähde |
process_initialize_account | Julkinen käsittelijä InitializeAccount-instruktiolle. | Lähde | Lähde |
process_initialize_account2 | Julkinen käsittelijä InitializeAccount2-instruktiolle. | Lähde | Lähde |
process_initialize_account3 | Julkinen käsittelijä InitializeAccount3-instruktiolle. | Lähde | Lähde |
Typescript
Alla olevat Kit-esimerkit näyttävät suositellun lähestymistavan käyttäen
@solana/kit. Vanhat esimerkit käyttäen @solana/web3.js on sisällytetty
viitteeksi.
Kit
import { generateKeyPairSigner } from "@solana/kit";import { createLocalClient } from "@solana/kit-client-rpc";import { systemProgram } from "@solana-program/system";import {getTokenSize,tokenProgram,TOKEN_PROGRAM_ADDRESS} from "@solana-program/token";const client = await createLocalClient().use(systemProgram()).use(tokenProgram());const result = await client.sendTransaction([client.system.instructions.createAccount({newAccount: tokenAccount, // New token account to create.lamports: rent, // Lamports funding the new account rent.space, // Account size in bytes.programAddress: TOKEN_PROGRAM_ADDRESS // Program that owns the new account.}),client.token.instructions.initializeAccount({account: tokenAccount.address, // Token account to initialize.mint: mint.address, // Mint for the token this account holds.owner: client.payer.address // Account that owns the token account.})]);const tokenAccountData = await client.token.accounts.token.fetch(tokenAccount.address);console.log("Mint Address:", mint.address);console.log("\nToken Account Address:", tokenAccount.address);console.log("Token Account:", tokenAccountData.data);console.log("\nTransaction Signature:", result.context.signature);
Web3.js
import { Connection, Keypair, LAMPORTS_PER_SOL } from "@solana/web3.js";import {createAccount,createMint,getAccount,TOKEN_PROGRAM_ID} from "@solana/spl-token";const tokenAccount = await createAccount(connection, // Connection to the local validator.feePayer, // Account paying transaction fees.mintPubkey, // Mint for the token this account holds.feePayer.publicKey, // Account that owns the token account.Keypair.generate(), // New token account to create.{commitment: "confirmed" // Confirmation options for the transaction.},TOKEN_PROGRAM_ID // Token program to invoke.);const tokenAccountData = await getAccount(connection,tokenAccount,"confirmed",TOKEN_PROGRAM_ID);console.log("Mint Address:", mintPubkey.toBase58());console.log("\nToken Account Address:", tokenAccount.toBase58());console.log("Token Account:", tokenAccountData);
Rust
use anyhow::Result;use solana_client::nonblocking::rpc_client::RpcClient;use solana_commitment_config::CommitmentConfig;use solana_sdk::{program_pack::Pack,signature::{Keypair, Signer},transaction::Transaction,};use solana_system_interface::instruction::create_account;use spl_token_interface::{id as token_program_id,instruction::{initialize_account, initialize_mint},state::{Account, Mint},};#[tokio::main]async fn main() -> Result<()> {let client = RpcClient::new_with_commitment(String::from("http://localhost:8899"),CommitmentConfig::confirmed(),);let token_account = Keypair::new();let token_account_rent = client.get_minimum_balance_for_rent_exemption(Account::LEN).await?;let transaction = Transaction::new_signed_with_payer(&[create_account(&fee_payer.pubkey(), // Account funding account creation.&token_account.pubkey(), // New token account to create.token_account_rent, // Lamports funding the new account rent.Account::LEN as u64, // Account size in bytes.&token_program_id(), // Program that owns the new account.),initialize_account(&token_program_id(),&token_account.pubkey(), // Token account to initialize.&mint.pubkey(), // Mint for the token this account holds.&fee_payer.pubkey(), // Account that owns the token account.)?,],Some(&fee_payer.pubkey()),&[&fee_payer, &token_account],latest_blockhash,);let transaction_signature = client.send_and_confirm_transaction(&transaction).await?;let token_account_data = client.get_account(&token_account.pubkey()).await?;let token_data = Account::unpack(&token_account_data.data)?;println!("Mint Address: {}", mint.pubkey());println!("\nToken Account Address: {}", token_account.pubkey());println!("Token Account: {:#?}", token_data);println!("\nTransaction Signature: {}", transaction_signature);Ok(())}
Python
#!/usr/bin/env python3import asyncioimport jsonfrom solana.rpc.async_api import AsyncClientfrom solders.keypair import Keypairfrom solders.message import Messagefrom solders.pubkey import Pubkeyfrom solders.system_program import create_account, CreateAccountParamsfrom solders.transaction import Transactionfrom spl.token.async_client import AsyncTokenfrom spl.token.instructions import (initialize_account,InitializeAccountParams,initialize_mint,InitializeMintParams,)from spl.token.constants import ACCOUNT_LEN, MINT_LEN, TOKEN_PROGRAM_IDasync def main():rpc = AsyncClient("http://localhost:8899")async with rpc:token_account = Keypair()token_account_rent = (await rpc.get_minimum_balance_for_rent_exemption(ACCOUNT_LEN)).valuecreate_token_account_instructions = [create_account(CreateAccountParams(from_pubkey=fee_payer.pubkey(), # Account funding account creation.to_pubkey=token_account.pubkey(), # New token account to create.lamports=token_account_rent, # Lamports funding the new account rent.space=ACCOUNT_LEN, # Account size in bytes.owner=TOKEN_PROGRAM_ID, # Program that owns the new token account.)),initialize_account(InitializeAccountParams(program_id=TOKEN_PROGRAM_ID, # Token program to invoke.account=token_account.pubkey(), # Token account to initialize.mint=mint.pubkey(), # Mint for the token this account holds.owner=fee_payer.pubkey(), # Account that owns the token account.)),]latest_blockhash = await rpc.get_latest_blockhash()transaction = Transaction([fee_payer, token_account],Message(create_token_account_instructions, fee_payer.pubkey()),latest_blockhash.value.blockhash,)result = await rpc.send_transaction(transaction)token_account_info = await token.get_account_info(token_account.pubkey())token_account_data = {key: str(value) if isinstance(value, Pubkey) else valuefor key, value in token_account_info._asdict().items()}print("Mint Address:", mint.pubkey())print("\nToken Account Address:", token_account.pubkey())print("Token Account:")print(json.dumps(token_account_data, indent=2))print("\nTransaction Signature:", result.value)if __name__ == "__main__":asyncio.run(main())
Is this page helpful?