SDA Token Integration Guide

Ownership Verification

Verifying token ownership is crucial for access control and governance participation.

import {
  getAssociatedTokenAddress,
  getAccount,
  TOKEN_2022_PROGRAM_ID
} from '@solana/spl-token';

async function verifyOwnership(walletAddress, minBalance = 0) {
  const wallet = new PublicKey(walletAddress);

  try {
    // Get the Associated Token Account for Token-2022
    const ata = await getAssociatedTokenAddress(
      SDA_MINT,
      wallet,
      false,
      TOKEN_2022_PROGRAM_ID
    );

    // Fetch account info (throws if account doesn't exist)
    const tokenAccount = await getAccount(connection, ata, 'confirmed', TOKEN_2022_PROGRAM_ID);

    // Calculate human-readable balance (assuming 6 decimals)
    const balance = Number(tokenAccount.amount) / 1e6;

    return {
      isHolder: balance > 0,
      balance: balance,
      meetsRequirement: balance >= minBalance,
      tokenAccount: ata.toBase58(),
      owner: tokenAccount.owner.toBase58()
    };
  } catch (error) {
    // Account doesn't exist = not a holder
    return {
      isHolder: false,
      balance: 0,
      meetsRequirement: false,
      tokenAccount: null,
      owner: null
    };
  }
}

// Example: Check if wallet holds at least 100 SDA
const result = await verifyOwnership(
  'GgkjCVbnDUpsp86mWSqtw6TgRSh7FTLUaNzchWhs1ZyP',
  100
);
console.log(result);

Transfer Implementation

Implementing SPL token transfers using the official Solana libraries.

import { Transaction, sendAndConfirmTransaction } from '@solana/web3.js';
import {
  getAssociatedTokenAddress,
  createTransferInstruction,
  getOrCreateAssociatedTokenAccount,
  TOKEN_2022_PROGRAM_ID
} from '@solana/spl-token';

async function transferTokens(fromKeypair, toAddress, amount) {
  const to = new PublicKey(toAddress);
  const decimals = 6; // SDA Token decimals
  const transferAmount = amount * Math.pow(10, decimals);

  // Get source token account (sender's ATA for Token-2022)
  const sourceAta = await getAssociatedTokenAddress(
    SDA_MINT,
    fromKeypair.publicKey,
    false,
    TOKEN_2022_PROGRAM_ID
  );

  // Get or create destination token account (recipient's ATA)
  const destAta = await getOrCreateAssociatedTokenAccount(
    connection,
    fromKeypair,  // payer for account creation if needed
    SDA_MINT,
    to,
    false,
    'confirmed',
    {},
    TOKEN_2022_PROGRAM_ID
  );

  // Create transfer instruction for Token-2022
  const transferIx = createTransferInstruction(
    sourceAta,           // source
    destAta.address,     // destination
    fromKeypair.publicKey, // owner of source
    transferAmount,      // amount in smallest units
    [],                  // multiSigners
    TOKEN_2022_PROGRAM_ID
  );

  // Build and send transaction
  const transaction = new Transaction().add(transferIx);
  const signature = await sendAndConfirmTransaction(
    connection,
    transaction,
    [fromKeypair]
  );

  console.log(`Transfer successful: ${signature}`);
  return { success: true, signature };
}

Exchange Integration

Exchanges require additional considerations for custody, compliance, and high-volume operations.