Das ZK ElGamal Program ist vorübergehend im Mainnet und Devnet deaktiviert, da es einem Sicherheitsaudit unterzogen wird. Dies bedeutet, dass die Confidential Transfers-Erweiterung derzeit nicht verfügbar ist. Obwohl die Konzepte weiterhin gültig sind, werden die Code-Beispiele nicht funktionieren.
Wie man einen Mint mit Confidential Transfer-Erweiterung erstellt
Die Confidential Transfer-Erweiterung ermöglicht private Token-Transfers, indem sie zusätzlichen Zustand zum Mint-Konten hinzufügt. Dieser Abschnitt erklärt, wie man einen Token-Mint mit aktivierter Erweiterung erstellt.
Das folgende Diagramm zeigt die Schritte, die beim Erstellen eines Mints mit der Confidential Transfer-Erweiterung erforderlich sind:
Confidential Transfer Mint-Zustand
Die Erweiterung fügt den ConfidentialTransferMint Zustand zum Mint-Konten hinzu:
#[repr(C)]#[derive(Clone, Copy, Debug, Default, PartialEq, Pod, Zeroable)]pub struct ConfidentialTransferMint {/// Authority to modify the `ConfidentialTransferMint` configuration and to/// approve new accounts (if `auto_approve_new_accounts` is true)////// The legacy Token Multisig account is not supported as the authoritypub authority: OptionalNonZeroPubkey,/// Indicate if newly configured accounts must be approved by the/// `authority` before they may be used by the user.////// * If `true`, no approval is required and new accounts may be used/// immediately/// * If `false`, the authority must approve newly configured accounts (see/// `ConfidentialTransferInstruction::ConfigureAccount`)pub auto_approve_new_accounts: PodBool,/// Authority to decode any transfer amount in a confidential transfer.pub auditor_elgamal_pubkey: OptionalNonZeroElGamalPubkey,}
Der ConfidentialTransferMint enthält drei Konfigurationsfelder:
-
authority: Das Konten, das die Berechtigung hat, Confidential Transfer-Einstellungen für den Mint zu ändern und neue vertrauliche Konten zu genehmigen, wenn die automatische Genehmigung deaktiviert ist.
-
auto_approve_new_accounts: Wenn auf true gesetzt, können Benutzer Token-Konten mit standardmäßig aktivierten vertraulichen Transfers erstellen. Wenn false, muss die Authority jedes neue Token-Konten genehmigen, bevor es für vertrauliche Transfers verwendet werden kann.
-
auditor_elgamal_pubkey: Ein optionaler Auditor, der Transfer-Beträge in vertraulichen Transaktionen entschlüsseln kann und so einen Compliance-Mechanismus bietet, während die Privatsphäre gegenüber der allgemeinen Öffentlichkeit gewahrt bleibt.
Erforderliche Anweisungen
Das Erstellen eines Mints mit aktiviertem Confidential Transfer erfordert drei Anweisungen in einer einzigen Transaktion:
-
Mint-Konten erstellen: Rufen Sie die
CreateAccountAnweisung des System Programs auf, um das Mint-Konten zu erstellen. -
Confidential Transfer-Erweiterung initialisieren: Rufen Sie die ConfidentialTransferInstruction::InitializeMint Anweisung des Token Extension Programs auf, um den
ConfidentialTransferMintZustand für den Mint zu konfigurieren. -
Mint initialisieren: Rufen Sie die
Instruction::InitializeMintAnweisung des Token Extension Programs auf, um den Standard-Mint-Zustand zu initialisieren.
Obwohl Sie diese Anweisungen manuell schreiben könnten, bietet die
spl_token_client Crate eine create_mint Methode, die eine Transaktion mit
allen drei Anweisungen in einem einzigen Funktionsaufruf erstellt und sendet,
wie im folgenden Beispiel demonstriert.
Beispielcode
Der folgende Code demonstriert, wie man einen Mint mit der Confidential Transfer-Erweiterung erstellt.
Um das Beispiel auszuführen, starten Sie einen lokalen Validator mit dem Token Extension Program, das vom Mainnet geklont wurde, mit folgendem Befehl. Sie müssen die Solana CLI installiert haben, um den lokalen Validator zu starten.
$solana-test-validator --clone-upgradeable-program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb --url https://api.mainnet.solana.com -r
Zum Zeitpunkt der Erstellung ist Confidential Transfers auf dem Standard-Local-Validator nicht aktiviert. Sie müssen das Token Extension Program vom Mainnet klonen, um den Beispielcode auszuführen.
use anyhow::{Context, Result};use solana_client::nonblocking::rpc_client::RpcClient;use solana_sdk::{commitment_config::CommitmentConfig,signature::{Keypair, Signer},};use spl_token_client::{client::{ProgramRpcClient, ProgramRpcClientSendTransaction},spl_token_2022::id as token_2022_program_id,token::{ExtensionInitializationParams, Token},};use std::sync::Arc;#[tokio::main]async fn main() -> Result<()> {// Create connection to local test validatorlet rpc_client = RpcClient::new_with_commitment(String::from("http://localhost:8899"),CommitmentConfig::confirmed(),);// Load the default Solana CLI keypair to use as the fee payer// This will be the wallet paying for the transaction fees// Use Arc to prevent multiple clones of the keypairlet payer = Arc::new(load_keypair()?);println!("Using payer: {}", payer.pubkey());// Generate a new keypair to use as the address of the token mintlet mint = Keypair::new();println!("Mint keypair generated: {}", mint.pubkey());// Set up program client for Token clientlet program_client =ProgramRpcClient::new(Arc::new(rpc_client), ProgramRpcClientSendTransaction);// Number of decimals for the mintlet decimals = 9;// Create a token client for the Token-2022 program// This provides high-level methods for token operationslet token = Token::new(Arc::new(program_client),&token_2022_program_id(), // Use the Token-2022 program (newer version with extensions)&mint.pubkey(), // Address of the new token mintSome(decimals), // Number of decimal placespayer.clone(), // Fee payer for transactions (cloning Arc, not keypair));// Create extension initialization parameters// The ConfidentialTransferMint extension enables confidential (private) transfers of tokenslet extension_initialization_params =vec![ExtensionInitializationParams::ConfidentialTransferMint {authority: Some(payer.pubkey()), // Authority that can modify confidential transfer settingsauto_approve_new_accounts: true, // Automatically approve new confidential accountsauditor_elgamal_pubkey: None, // Optional auditor ElGamal public key}];// Create and initialize the mint with the ConfidentialTransferMint extension// This sends a transaction to create the new token mintlet transaction_signature = token.create_mint(&payer.pubkey(), // Mint authority - can mint new tokensSome(&payer.pubkey()), // Freeze authority - can freeze token accountsextension_initialization_params, // Add the ConfidentialTransferMint extension&[&mint], // Mint keypair needed as signer).await?;// Print results for user verificationprintln!("Mint Address: {}", mint.pubkey());println!("Transaction Signature: {}", transaction_signature);Ok(())}// Load the keypair from the default Solana CLI keypair path (~/.config/solana/id.json)// This enables using the same wallet as the Solana CLI toolsfn load_keypair() -> Result<Keypair> {// Get the default keypair pathlet keypair_path = dirs::home_dir().context("Could not find home directory")?.join(".config/solana/id.json");// Read the keypair file directly into bytes using serde_json// The keypair file is a JSON array of byteslet file = std::fs::File::open(&keypair_path)?;let keypair_bytes: Vec<u8> = serde_json::from_reader(file)?;// Create keypair from the loaded bytes// This converts the byte array into a keypairlet keypair = Keypair::from_bytes(&keypair_bytes)?;Ok(keypair)}
Is this page helpful?