存入代币

如何将代币存入保密待处理余额

在代币能够以保密方式转账之前，公开代币余额必须转换为保密余额。此转换分两个阶段进行：

保密待处理余额：首先，代币从公开余额 "存入"到"待处理"保密余额。
保密可用余额：待处理余额随后被"应用"到可用余额，使代币可用于保密转账。

本节介绍第一阶段：将公开代币余额存入保密待处理余额。

下图展示了将代币从公开余额存入保密待处理余额所涉及的步骤：

Deposit Tokens

所需指令

要将公开余额转换为保密待处理余额，请调用 ConfidentialTransferInstruction::Deposit 指令。每条存款指令的最大金额限制为 2^48。

spl_token_client crate 提供了 confidential_transfer_deposit 方法，该方法构建并发送包含 Deposit 指令的交易，如下面的示例所示。

示例代码

以下示例演示如何将公开代币余额存入保密待处理余额。

保密转账依赖于 ZK ElGamal 证明程序，该程序已在主网和开发网上启用。标准的 solana-test-validator 不会启用它，但类似 Surfpool 这样的主网分叉本地 validator 会启用。请使用已充值的付款账户针对其中一个环境运行示例（代码默认使用开发网），并将占位符的 mint 地址和账户地址替换为您自己的地址。

Rust



const ZK_PROOF_PROGRAM_ID: Pubkey =
    solana_pubkey::pubkey!("ZkE1Gama1Proof11111111111111111111111111111");

fn main() -> Result<()> {
    let rpc_client = RpcClient::new_with_commitment(
        String::from("https://api.devnet.solana.com"),
        CommitmentConfig::confirmed(),
    );

    // Owner = fee payer = token account owner. The setup below configures the
    // account for confidential transfers (see "Create a Token Account").
    let owner = load_keypair()?;
    let amount: u64 = 100;
    let decimals: u8 = 2;

    // Setup: create a confidential token account with public tokens.
    let (mint, token_account) = setup_deposit_account(&rpc_client, &owner, amount, decimals)?;

    // Deposit moves tokens from the public balance into the pending confidential
    // balance. No proof is required. The tokens land in the pending balance and
    // must be applied (see "Apply Pending Balance") before they can be spent.
    let deposit_ix = deposit(
        &spl_token_2022::id(),
        &token_account,
        &mint,
        amount,
        decimals,
        &owner.pubkey(),
        &[&owner.pubkey()],
    )?;

    let blockhash = rpc_client.get_latest_blockhash()?;
    let transaction =
        Transaction::new_signed_with_payer(&[deposit_ix], Some(&owner.pubkey()), &[&owner], blockhash);
    let signature = rpc_client.send_and_confirm_transaction(&transaction)?;
    println!("Deposited {amount} tokens to the pending confidential balance: {signature}");
    Ok(())
}

Typescript



const client = await createClient()
  .use(signerFromFile(join(homedir(), ".config/solana/id.json")))
  .use(
    solanaRpc({
      rpcUrl: "https://api.devnet.solana.com"
    })
  );

// The Solana CLI default keypair, used as fee payer, mint authority, and
// token account owner.
const owner = client.payer;
const amount = 100n;
const decimals = 2;

// Setup: create a confidential mint and token account with public tokens.
const mint = await createConfidentialMint(client, owner, decimals);
const token = await createConfidentialTokenAccount(client, owner, mint);
await mintPublicTokens(client, owner, mint, token, amount);

// Deposit moves public tokens into the pending confidential balance. No proof
// is required; the tokens must then be applied before they can be spent.
const depositInstruction = getConfidentialDepositInstruction({
  token,
  mint,
  authority: owner,
  amount,
  decimals
});

const result = await client.sendTransaction([depositInstruction]);
console.log(
  `Deposited ${amount} tokens to the pending confidential balance: ${result.context.signature}`
);

如何将代币存入保密待处理余额

所需指令

示例代码

Rust

Typescript

Table of Contents