Wpłać Tokeny

Przegląd

Instrukcja Deposit przenosi tokeny SPL z associated token account użytkownika do associated token account escrow. Po wpłaceniu tokeny są dostępne do transferów off-chain za pośrednictwem bramki. Opcjonalny parametr recipient pozwala wpłacającemu zasilić saldo kanału innego użytkownika.

Wymagania wstępne

Ukończona instalacja i generowanie klienta
Portfel devnet z SOL (na opłaty transakcyjne) oraz tokenem SPL, który chcesz wpłacić
Aktywna instancja Private Channels z Twoim mintem na liście dozwolonych

Kod

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);

Weryfikacja

Po potwierdzeniu transakcji w sieci devnet indekser wykrywa zdarzenie wpłaty za pośrednictwem Yellowstone gRPC, a operator mintuje równoważne saldo na kanale. Przed zasileniem salda stosowane jest opóźnienie bezpieczeństwa finalności, więc spodziewaj się ~15 sekund przed udostępnieniem salda kanału.

Zapytaj o swoje saldo przez bramkę (nie przez RPC devnet), aby potwierdzić:

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);

Niezerowe saldo potwierdza, że wpłata została zaindeksowana i zaksięgowana. Jeśli saldo wynosi zero po 30 sekundach, sprawdź, czy indexer-solana i operator-solana działają (make docker-devnet-logs).

Kolejne kroki

Wyślij Transfer – wyślij swój pierwszy transfer off-chain

Wpłać Tokeny

Przegląd

Wymagania wstępne

Kod

Weryfikacja

Kolejne kroki

Spis treści