Stablecoin Quickstart

import {
  Connection,
  Keypair,
  PublicKey,
} from "@solana/web3.js";
import {
  getMint,
  getOrCreateAssociatedTokenAccount,
  transfer,
} from "@solana/spl-token";
import * as fs from "fs";

const MINT_ADDRESS = new PublicKey("5P6MkoaCd9byPxH4X99kgKtS6SiuCQ67ZPCJzpXGkpCe"); // CBTUSD on devnet

async function main() {
  const connection = new Connection(process.env.RPC_URL!);
  const keyData    = JSON.parse(fs.readFileSync(process.env.WALLET_PATH!, "utf-8"));
  // `payer` signs the transaction, covers fees, and owns the token account below.
  const payer      = Keypair.fromSecretKey(Uint8Array.from(keyData));

  // Get or create the token account for your wallet (creates an ATA if needed).
  const tokenAccount = await getOrCreateAssociatedTokenAccount(
    connection,
    payer,
    MINT_ADDRESS,
    payer.publicKey
  );

  // SPL balances are integers in the smallest unit; `decimals` scales them to whole tokens.
  const mintInfo = await getMint(connection, MINT_ADDRESS);
  const balance  = Number(tokenAccount.amount) / Math.pow(10, mintInfo.decimals);
  console.log("Balance:", balance);

  // Make the "you need a balance" assumption explicit with a friendly error.
  const amount = BigInt(1) * BigInt(10 ** mintInfo.decimals);
  if (tokenAccount.amount < amount) {
    throw new Error(
      "Not enough CBTUSD to transfer. See 'How do I get testnet CBTUSD?' in the quickstart."
    );
  }

  // Transfer 1 token to yourself as a smoke test
  const sig = await transfer(
    connection,
    payer,
    tokenAccount.address,   // source
    tokenAccount.address,   // destination (self-transfer for test)
    payer,
    amount
  );
  console.log("Transfer confirmed:", sig);
}

main()
  .then(() => process.exit(0))
  .catch((err) => { console.error(err.message); process.exit(1); });