Skip to main content

Method Signature

align.blockchain.utils.isValidAddress(address: string): boolean

Parameters

address
string
required
String to validate

Returns

Returns true if valid address, false otherwise.

Examples

import Align from "@tolbel/align";

const align = new Align({
  apiKey: process.env.ALIGN_API_KEY!,
  environment: "sandbox",
});

// Valid addresses
console.log(align.blockchain.utils.isValidAddress(
  "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42"
)); // true

// Invalid addresses
console.log(align.blockchain.utils.isValidAddress("0x123")); // false
console.log(align.blockchain.utils.isValidAddress("not-an-address")); // false
console.log(align.blockchain.utils.isValidAddress("")); // false

Input Validation

function validateRecipient(address: string): void {
  if (!align.blockchain.utils.isValidAddress(address)) {
    throw new Error("Invalid recipient address");
  }

  // Also check it's not the zero address
  if (address === "0x0000000000000000000000000000000000000000") {
    throw new Error("Cannot send to zero address");
  }
}
This validates the format only. It doesn’t check if the address exists on-chain or has any balance.