Adresse verifizieren

Das Senden von Token an die falsche Adresse kann zu einem dauerhaften Verlust von Geldern führen. Die Adressverifizierung stellt sicher, dass Sie Token nur an Adressen senden, die diese ordnungsgemäß empfangen und darauf zugreifen können.

Solana-Adressen verstehen

Solana-Konten haben zwei Arten von Adressen: on-curve und off-curve.

On-Curve-Adressen

Standardadressen sind die öffentlichen Schlüssel von Ed25519-Schlüsselpaaren. Diese Adressen:

• Haben einen entsprechenden privaten Schlüssel, der Transaktionen signieren kann
• Werden als Wallet-Adressen verwendet

Off-Curve-Adressen (PDAs)

Program Derived Addresses werden deterministisch aus einer Programm-ID und Seeds abgeleitet. Diese Adressen:

• Haben keinen entsprechenden privaten Schlüssel
• Können nur vom Programm signiert werden, von dem die Adresse abgeleitet wurde

Kontentypen bei Zahlungen

Verwenden Sie die Adresse, um ein Konten aus dem Netzwerk abzurufen, prüfen Sie dessen Programmeigentümer und Kontotyp, um zu bestimmen, wie die Adresse zu handhaben ist.

System Program-Konten (Wallets)

Konten, die dem System Program gehören, sind Standard-Wallets. Um SPL-Token an ein Wallet zu senden, leiten Sie dessen Associated Token Account (ATA) ab und verwenden es.

Nachdem Sie die ATA-Adresse abgeleitet haben, prüfen Sie, ob das token account on-chain existiert. Wenn das ATA nicht existiert, können Sie eine Anweisung zum Erstellen des token account des Empfängers in derselben Transaktion wie die Übertragung einschließen. Dies erfordert jedoch die Zahlung von rent für das neue token account. Da der Empfänger das ATA besitzt, kann das für die rent gezahlte SOL nicht vom Absender zurückgefordert werden.

Token-Konten

Token-Konten gehören dem Token Program oder Token-2022 Program und halten Token-Guthaben. Wenn die Adresse, die Sie erhalten, einem Token-Programm gehört, sollten Sie überprüfen, dass das Konto ein Token-Konto ist (kein Mint-Konto) und mit dem erwarteten Token-Mint-Konto übereinstimmt, bevor Sie senden.

Mint-Konten

Mint-Konten verfolgen das Token-Angebot und die Metadaten eines bestimmten Tokens. Mint-Konten gehören ebenfalls Token Programs, sind aber keine gültigen Empfänger für Token-Überweisungen. Der Versuch, Token an eine Mint-Adresse zu senden, führt zu einer fehlgeschlagenen Transaktion, aber es gehen keine Mittel verloren.

Andere Konten

Konten, die anderen Programmen gehören, erfordern eine Grundsatzentscheidung. Einige Konten (z. B. Multisig-Wallets) können gültige Token-Konto-Eigentümer sein, während andere abgelehnt werden sollten.

Verifizierungsablauf

Das folgende Diagramm zeigt einen Referenz-Entscheidungsbaum zur Validierung einer Adresse:

Demo

Das folgende Beispiel zeigt nur die Adressvalidierungslogik. Dies ist Referenzcode zu Illustrationszwecken.

Die folgende Demo verwendet drei mögliche Ergebnisse:

/**
 * 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
// =============================================================================