Депозит токенов

Обзор

Инструкция Deposit перемещает SPL-токены из associated token account пользователя в associated token account эскроу. После внесения токены становятся доступны для внецепочечных переводов через шлюз. Необязательный параметр recipient позволяет депозитору зачислить средства на баланс канала другого пользователя.

Предварительные требования

Завершённая установка и генерация клиента
Кошелёк в devnet с SOL (для оплаты комиссий за транзакции) и SPL-токеном, который вы хотите внести
Активный экземпляр Private Channels с вашим минтом в списке разрешённых

Код

import { getDepositInstructionAsync } from "../private-channel-escrow-program/clients/typescript/src/generated";
import {
  createSolanaRpc,
  address,
  pipe,
  createTransactionMessage,
  setTransactionMessageFeePayerSigner,
  setTransactionMessageLifetimeUsingBlockhash,
  appendTransactionMessageInstruction,
  signAndSendTransactionMessageWithSigners,
  assertIsTransactionMessageWithSingleSendingSigner,
  getBase58Decoder
} from "@solana/kit";
import { findAssociatedTokenPda } from "@solana-program/token";

const rpc = createSolanaRpc("https://api.devnet.solana.com");

const TOKEN_PROGRAM_ADDRESS = address(
  "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
);

// Derive the user's associated token account
const [userAta] = await findAssociatedTokenPda({
  mint: address(mintAddress),
  owner: address(payerSigner.address),
  tokenProgram: TOKEN_PROGRAM_ADDRESS
});

// Build the deposit instruction - allowedMint and instanceAta are auto-derived
const depositIx = await getDepositInstructionAsync({
  payer: payerSigner,
  user: payerSigner,
  instance: address(instancePda),
  mint: address(mintAddress),
  userAta,
  amount: 1_000_000n, // 1 USDC (6 decimals)
  recipient: null // null = credit the depositing user's channel balance
});

const { value: latestBlockhash } = await rpc
  .getLatestBlockhash({ commitment: "confirmed" })
  .send();

// Deposit is an ordinary Solana instruction sent to Solana RPC directly
// (not the gateway), so the versioned (v0) transaction format applies here.
const transactionMessage = pipe(
  createTransactionMessage({ version: 0 }),
  (m) => setTransactionMessageFeePayerSigner(payerSigner, m),
  (m) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, m),
  (m) => appendTransactionMessageInstruction(depositIx, m)
);

assertIsTransactionMessageWithSingleSendingSigner(transactionMessage);

const signatureBytes =
  await signAndSendTransactionMessageWithSigners(transactionMessage);
const signature = getBase58Decoder().decode(signatureBytes);
console.log("Deposit signature:", signature);

Проверка

После подтверждения вашей транзакции в devnet индексатор обнаруживает событие депозита через Yellowstone gRPC, и оператор начисляет эквивалентный баланс в канале. Перед зачислением применяется задержка безопасности финальности, поэтому ожидайте ~15 секунд до появления баланса в канале.

Запросите ваш баланс через шлюз (не через devnet RPC) для подтверждения:

import { createSolanaRpc, address } from "@solana/kit";
import { findAssociatedTokenPda } from "@solana-program/token";

// Point to the gateway, not a public Solana RPC
const privateChannelRpc = createSolanaRpc("http://localhost:8899");

const TOKEN_PROGRAM_ADDRESS = address(
  "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
);

const [channelAta] = await findAssociatedTokenPda({
  mint: address(mintAddress),
  owner: address(payerSigner.address),
  tokenProgram: TOKEN_PROGRAM_ADDRESS
});

const balance = await privateChannelRpc
  .getTokenAccountBalance(channelAta)
  .send();
console.log("Channel balance:", balance.value.uiAmountString);

Ненулевой баланс подтверждает, что депозит был проиндексирован и зачислен. Если баланс равен нулю спустя 30 секунд, проверьте, что indexer-solana и operator-solana запущены (make docker-devnet-logs).

Следующие шаги

Отправить перевод — выполните ваш первый внецепочечный перевод

Депозит токенов

Обзор

Предварительные требования

Код

Проверка

Следующие шаги

Содержание