Vertrouwelijke Transfer-tokens uitgeven op Solana

Deze handleiding is bedoeld voor uitgevers: teams die een Token-2022-mint aanmaken en beheren die gebruikmaakt van de Confidential Transfer-extensie. Het behandelt de keuzes die u maakt bij het aanmaken van de mint en de bewerkingen die u uitvoert gedurende de levensduur van de mint. Voor de houderszijde (storten, toepassen, overmaken, opnemen) zie de stapsgewijze pagina's, en voor de ondersteuning van deze tokens in een product zie de Integratiehandleiding.

Vertrouwelijke overdrachten houden overdrachtsbedragen en accountsaldi versleuteld, terwijl accountadressen, de mint en eigenaren openbaar blijven. Ze zijn afhankelijk van het ZK ElGamal Proof Program voor onchain-bewijsverificatie, waardoor de mint bruikbaar is op clusters waar dat programma is ingeschakeld.

Keuzes die u maakt bij het aanmaken

De Confidential Transfer-extensie moet worden geïnitialiseerd voordat de mint wordt geïnitialiseerd en kan later niet meer worden toegevoegd. Bij het aanmaken beslist u:

• Goedkeuringsbeleid: of accounts toestemming kunnen geven voor vertrouwelijke overdrachten zonder toestemming (auto) of goedgekeurd moeten worden door de vertrouwelijke overdrachtsautoriteit van de mint (manual).
• Auditor: of u een globale auditor-ElGamal-publieke sleutel wilt instellen zodat een aangewezen partij elk overdrachtsbedrag voor de mint kan ontsleutelen. Optioneel en kan later worden gewijzigd.
• Optionele aanvullende extensies: vertrouwelijke overdrachtskosten (gecombineerd met de overdrachtskosten-extensie) en vertrouwelijke mint/burn, beide hieronder behandeld. Deze moeten ook bij het aanmaken worden geïnitialiseerd.

Maak een vertrouwelijke mint aan

De CLI stelt het goedkeuringsbeleid in met --enable-confidential-transfers auto of manual; auto laat elke houder zijn eigen account configureren, terwijl manual dit koppelt aan goedkeuring door de vertrouwelijke overdrachtautoriteit (die standardaard de mint-autoriteit is). De clientpaden nemen dezelfde instellingen over via de ConfidentialTransferMint parameters: een autoriteit, de automatische-goedkeuringsvlag, en een optionele auditorsleutel. Zowel het goedkeuringsbeleid als de auditor kunnen later worden gewijzigd (zie Configureer een auditor); alleen de aanwezigheid van de extensie zelf ligt vast bij aanmaak.

$ spl-token --program-id TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb create-token --enable-confidential-transfers auto

Configureer een auditor

Een globale auditor is een ElGamal-publieke sleutel die op de mint is opgeslagen. Wanneer ingesteld, versleutelt elke vertrouwelijke overdracht het bedrag ook onder deze sleutel, zodat wiegene de bijbehorende geheime sleutel bezit alle overdrachtsbedragen voor de mint kan ontcijferen. Dit is hoe vertrouwelijke overdrachten compatibel blijven met audit- en compliancevereisten: het publiek ziet niets, de auditor ziet alles.

De vertrouwelijke overdrachtautoriteit kan de auditor op elk moment instellen, roteren of verwijderen. Dezelfde bewerking werkt ook het goedkeuringsbeleid bij. Op de CLI is de auditorsleutel een base64-codering van een ElGamal-publieke sleutel; geef --auditor-pubkey none door om deze te verwijderen en --approve-policy auto|manual om het beleid te wijzigen.

Rotatie heeft alleen invloed op toekomstige overdrachten. Bedragen in transacties die al onchain staan, blijven versleuteld onder de auditorsleutel die actief was op het moment van uitvoering; bewaar daarom oude auditorsleutels als u historische activiteit wilt ontcijferen.

$ spl-token update-confidential-transfer-settings <MINT_PUBKEY> --auditor-pubkey <AUDITOR_ELGAMAL_PUBKEY>

Accounts goedkeuren (handmatig beleid)

Met een handmatig goedkeuringsbeleid kan een account dat is geconfigureerd voor vertrouwelijke overdrachten niet vertrouwelijk transacteren totdat de autoriteit voor vertrouwelijke overdrachten het goedkeurt. Dit geeft uitgevers een toegangspoort voor deelnemers op de allowlist of met KYC-verificatie. De CLI biedt geen goedkeuringsopdracht, dus goedkeuring verloopt via een client.

token
    .confidential_transfer_approve_account(
        &token_account,
        &authority,
        &[&authority_keypair],
    )
    .await?;

Vertrouwelijke overdrachtskosten

Als uw mint overdrachtskosten in rekening brengt en overdrachten vertrouwelijk zijn, moeten de kosten ook vertrouwelijk worden ingehouden. De ConfidentialTransferFeeConfig-extensie verwerkt dit en wordt geïnitialiseerd bij het aanmaken van de mint, samen met zowel de overdrachtskosten- als de vertrouwelijke overdrachtsextensies.

Ingehouden kosten worden versleuteld opgebouwd op ontvangersaccounts, worden naar de mint overgebracht en vervolgens opgenomen door de autoriteit voor het opnemen van ingehouden kosten. Elk kostenbedrag blijft durend versleuteld. Niets hiervan is toegankelijk via de CLI. De ElGamal-geheime sleutel van de autoriteit voor het opnemen van ingehouden kosten kan ingehouden kostenbedragen ontsleutelen, wat in combinatie met de openbare kostenparameters informatie over overdachtsbedragen kan onthullen. Behandel die sleutel daarom als gevoelig.

De kostenconfiguratie initialiseren

Voeg dit toe samen met ConfidentialTransferMint en de overdrachtskosten-configuratie bij hetzelfde aanmaken van de mint.

use spl_token_client::token::ExtensionInitializationParams;

ExtensionInitializationParams::ConfidentialTransferFeeConfig {
    authority: Some(authority.pubkey().into()),
    withdraw_withheld_authority_elgamal_pubkey: withdraw_withheld_elgamal_pubkey,
};

Ingehouden kosten oogsten en opnemen

Oogsten verplaatst de versleuteld ingehouden kosten van accounts naar de mint; opnemen verplaatst ze uit de mint naar een gekozen account. Er zijn twee autoriteiten betrokken, die elk kunnen verschillen van de mint-autoriteit:

• De autoriteit voor vertrouwelijke overdrachtskosten (de authority ingesteld op ConfidentialTransferFeeConfig) schakelt het oogsten in of uit.
• De autoriteit voor het opnemen van ingehouden kosten (vanuit de TransferFeeConfig van de overdrachtskosten-extensie) neemt de geoogste kosten uit de mint op.

Opnames vereisen een gelijkheids- en een bereikbewijs, inline aangeleverd of geverifieerd in contextstaataccounts.

// Permissionless: move withheld fees from accounts into the mint.
token
    .confidential_transfer_harvest_withheld_tokens_to_mint(&[&source_account])
    .await?;

// Withdraw withheld fees from the mint (requires the withdraw withheld authority).
token
    .confidential_transfer_withdraw_withheld_tokens_from_mint(
        &destination_account,
        &withdraw_withheld_authority,
        None, // proof context state account, supplied inline if None
        None, // withheld tokens info, fetched if None
        &withdraw_withheld_elgamal_keypair,
        &destination_elgamal_pubkey,
        &new_decryptable_available_balance,
        &[&withdraw_withheld_authority_keypair],
    )
    .await?;

In de JS-client vereist het opnemen van de geoogste vergoedingen uit de mint (getWithdrawWithheldTokensFromMintForConfidentialTransferFeeInstruction) bovendien een gelijkheids- en bereikbewijs dat is geverifieerd in contextstaataccounts, zodat het hetzelfde bewijs-accountpatroon volgt als een vertrouwelijke overdracht.

Vertrouwelijk aanmaken en verbranden

De ConfidentialMintBurn-extensie stelt de mint-autoriteit in staat om aanbod rechtstreeks op basis van vertrouwelijke saldi uit te geven en te verbranden, waarbij het totale aanbod versleuteld blijft. Een mint met deze extensie schakelt het publieke storting- en opnamepad uit, omdat tokens uitsluitend vertrouwelijk bestaan. Zie de protocoldocumentatie voor het volledige model.

Initialiseer de extensie bij het aanmaken van de mint en mint, verbrand en reconcilieer het aanbod vervolgens in de loop van de tijd. Aanmaken geeft een versleuteld bedrag uit aan het vertrouwelijke saldo van een ontvanger; verbranden verwijdert een versleuteld bedrag naar een openstaande verbranding die later in het aanbod wordt opgenomen. Beide genereren bewijzen zoals bij een vertrouwelijke overdracht.

use spl_token_client::token::ExtensionInitializationParams;

// 1. Initialize at creation (alongside ConfidentialTransferMint).
ExtensionInitializationParams::ConfidentialMintBurn {
    supply_elgamal_pubkey, // encrypts the confidential supply
    decryptable_supply,    // AES ciphertext of the initial supply (zero)
};

// 2. Mint an encrypted amount into a recipient's confidential balance.
token
    .confidential_transfer_mint(
        &mint_authority,
        &destination_account,
        None, // equality proof account
        None, // ciphertext validity proof account
        None, // range proof account
        mint_amount,
        &supply_elgamal_keypair,
        &destination_elgamal_pubkey,
        auditor_elgamal_pubkey, // Option
        &supply_aes_key,
        None, // supply account info, fetched if None
        &[&mint_authority_keypair],
    )
    .await?;

// 3. Burn an encrypted amount from a holder's confidential balance into the
//    mint's pending burn. Generates proofs like a confidential transfer.
token
    .confidential_transfer_burn(
        &owner,
        &source_account,
        None, // equality proof account
        None, // ciphertext validity proof account
        None, // range proof account
        burn_amount,
        &source_elgamal_keypair,
        &supply_elgamal_pubkey,
        auditor_elgamal_pubkey, // Option
        &source_aes_key,
        None, // burn account info, fetched if None
        &[&owner_keypair],
    )
    .await?;

// 4. Fold the accumulated pending burn into the confidential supply.
token
    .confidential_transfer_apply_pending_burn(&mint_authority, &[&mint_authority_keypair])
    .await?;

Roteer de versleutelingssleutel van het aanbod met confidential_transfer_rotate_supply_elgamal_pubkey (de openstaande verbranding moet eerst nul zijn), en ververs de leesbare aanbodciphertext met confidential_transfer_update_decrypt_supply.

Operationele en compliance-overwegingen

• Bewaarneming van de auditorsleutel. Als u een auditor instelt, is de geheime sleutel van de auditor een hoogwaardige ontsleutelingssleutel. Sla deze op en roteer hem zorgvuldig, en beslis wie binnen uw organisatie (of welke toezichthouder) deze beheert.
• Compliance-houding. Adresscreening en analyse van tegenpartijgrafieken blijven werken omdat adressen openbaar blijven. Monitoring op basis van bedragen is afhankelijk van de auditorsleutel of van selectieve openbaarmaking door accounteigenaren. Bepaal uw aanpak vóór de lancering.
• Gebruikers onboarden. Het configureren van een vertrouwelijk account vereist de handtekening van de eigenaar. Laat gebruikers voor een soepele accountinrichting eenmalig een ElGamal-sleutel registreren en gebruik het registerpad, beschreven in de Integratiegids.
• Transactieaantal. Een vertrouwelijke overdracht beslaat momenteel enkele afhankelijke transacties, omdat de bewijzen de huidige transactiegroottelimiet overschrijden. Transactieformaat v1 (geleverd met Agave v4.2) verhoogt die limiet en zal naar verwachting één enkele onchain-transactie mogelijk maken.