Adresi doğrula

Yanlış adrese token göndermek, fonların kalıcı olarak kaybedilmesine neden olabilir. Adres doğrulama, yalnızca tokenları düzgün bir şekilde alabilecek ve erişebilecek adreslere göndermenizi sağlar.

Solana adreslerini anlama

Solana hesaplarının iki tür adresi vardır: eğri üzerinde ve eğri dışında.

Eğri üzerinde adresler

Standart adresler, Ed25519 anahtar çiftlerinden gelen genel anahtarlardır. Bu adresler:

• İşlemleri imzalayabilen karşılık gelen bir özel anahtara sahiptir
• Cüzdan adresi olarak kullanılır

Eğri dışında adresler (PDA'lar)

Program Derived Addresses, bir program kimliğinden ve seed'lerden deterministik olarak türetilir. Bu adresler:

• Karşılık gelen bir özel anahtara sahip değildir
• Yalnızca adresin türetildiği program tarafından imzalanabilir

Ödemelerde hesap türleri

Ağdan bir hesap almak için adresi kullanın, program sahibini ve hesap türünü kontrol ederek adresin nasıl işleneceğini belirleyin.

System Program hesapları (cüzdanlar)

System Program'a ait hesaplar standart cüzdanlardır. Bir cüzdana SPL token göndermek için, onun Associated Token Account (ATA) adresini türetip kullanırsınız.

ATA adresini türettikten sonra, token hesabının zincir üzerinde var olup olmadığını kontrol edin. ATA mevcut değilse, transfer ile aynı işlemde alıcının token hesabını oluşturmak için bir talimat ekleyebilirsiniz. Ancak bu, yeni token hesabı için rent ödemeyi gerektirir. Alıcı ATA'nın sahibi olduğundan, rent için ödenen SOL gönderen tarafından geri alınamaz.

Token hesapları

Token hesapları Token Program veya Token-2022 Program tarafından sahiplenilir ve token bakiyelerini tutar. Aldığınız adres bir token programına aitse, göndermeden önce hesabın bir token hesabı olduğunu (mint hesabı değil) ve beklenen token mint hesabıyla eşleştiğini doğrulamalısınız.

Mint hesapları

Mint hesapları belirli bir tokenın arzını ve meta verilerini takip eder. Mint hesapları da Token Programları tarafından sahiplenilir ancak token transferleri için geçerli alıcılar değildir. Bir mint adresine token gönderme girişimi başarısız bir işlemle sonuçlanır, ancak hiçbir fon kaybedilmez.

Diğer hesaplar

Diğer programlara ait hesaplar bir politika kararı gerektirir. Bazı hesaplar (örneğin çoklu imza cüzdanları) geçerli token hesabı sahipleri olabilirken, diğerleri reddedilmelidir.

Doğrulama akışı

Aşağıdaki diyagram, bir adresi doğrulamak için referans karar ağacını gösterir:

Demo

Aşağıdaki örnek yalnızca adres doğrulama mantığını göstermektedir. Bu, açıklama amaçlı referans kodudur.

Aşağıdaki demo üç olası sonuç kullanır:

/**
 * Validates an input address and classifies it as a wallet, token account, or invalid.
 *
 * @param inputAddress - The address to validate
 * @param rpc - Optional RPC client (defaults to mainnet)
 * @returns Classification result:
 *   - IS_WALLET: Valid wallet address
 *   - IS_TOKEN_ACCOUNT: Valid token account
 *   - REJECT: Invalid address for transfers
 */
export async function validateAddress(
  inputAddress: Address,
  rpc: Rpc<GetAccountInfoApi> = defaultRpc
): Promise<ValidationResult> {
  const account = await fetchJsonParsedAccount(rpc, inputAddress);
  // Log the account data for demo
  console.log("\nAccount:", account);

  // Account doesn't exist on-chain
  if (!account.exists) {
    // Off-curve = PDA that doesn't exist as an account
    // Reject conservatively to avoid sending to an address that may be inaccessible.
    if (isOffCurveAddress(inputAddress)) {
      return { type: "REJECT", reason: "PDA doesn't exist as an account" };
    }
    // On-curve = valid keypair address, treat as unfunded wallet
    return { type: "IS_WALLET" };
  }

  // Account exists, check program owner
  const owner = account.programAddress;

  // System Program = wallet
  if (owner === SYSTEM_PROGRAM) {
    return { type: "IS_WALLET" };
  }

  // Token Program or Token-2022, check if token account
  if (owner === TOKEN_PROGRAM || owner === TOKEN_2022_PROGRAM) {
    const accountType = (
      account.data as { parsedAccountMeta?: { type?: string } }
    ).parsedAccountMeta?.type;

    if (accountType === "account") {
      return { type: "IS_TOKEN_ACCOUNT" };
    }
    // Reject if not a token account (mint account)
    return {
      type: "REJECT",
      reason: "Not a token account"
    };
  }

  // Unknown program owner
  return { type: "REJECT", reason: "Unknown program owner" };
}

// =============================================================================
// Examples
// =============================================================================

/**
 * Validates an input address and classifies it as a wallet, token account, or invalid.
 *
 * @param inputAddress - The address to validate
 * @param rpc - Optional RPC client (defaults to mainnet)
 * @returns Classification result:
 *   - IS_WALLET: Valid wallet address
 *   - IS_TOKEN_ACCOUNT: Valid token account
 *   - REJECT: Invalid address for transfers
 */
export async function validateAddress(
  inputAddress: Address,
  rpc: Rpc<GetAccountInfoApi> = defaultRpc
): Promise<ValidationResult> {
  const account = await fetchJsonParsedAccount(rpc, inputAddress);
  // Log the account data for demo
  console.log("\nAccount:", account);

  // Account doesn't exist on-chain
  if (!account.exists) {
    // Off-curve = PDA that doesn't exist as an account
    // Reject conservatively to avoid sending to an address that may be inaccessible.
    if (isOffCurveAddress(inputAddress)) {
      return { type: "REJECT", reason: "PDA doesn't exist as an account" };
    }
    // On-curve = valid keypair address, treat as unfunded wallet
    return { type: "IS_WALLET" };
  }

  // Account exists, check program owner
  const owner = account.programAddress;

  // System Program = wallet
  if (owner === SYSTEM_PROGRAM) {
    return { type: "IS_WALLET" };
  }

  // Token Program or Token-2022, check if token account
  if (owner === TOKEN_PROGRAM || owner === TOKEN_2022_PROGRAM) {
    const accountType = (
      account.data as { parsedAccountMeta?: { type?: string } }
    ).parsedAccountMeta?.type;

    if (accountType === "account") {
      return { type: "IS_TOKEN_ACCOUNT" };
    }
    // Reject if not a token account (mint account)
    return {
      type: "REJECT",
      reason: "Not a token account"
    };
  }

  // Unknown program owner
  return { type: "REJECT", reason: "Unknown program owner" };
}

// =============================================================================
// Examples
// =============================================================================