Align SDK

The unofficial TypeScript/JavaScript SDK for the AlignLab API. Build production-ready payment infrastructure with comprehensive type safety, validation, and error handling.

This is an unofficial SDK. For the official API documentation, visit docs.alignlabs.dev.

Why Align SDK?

Type-Safe

Full TypeScript support with comprehensive type definitions. Catch errors at compile time, not runtime.

Validated Requests

Built-in request validation with Zod schemas. Invalid data is caught before hitting the API.

Secure Webhooks

HMAC-SHA256 webhook signature verification out of the box. Prevent replay attacks and tampering.

Automatic Retry

Built-in retry mechanism with exponential backoff for transient network errors.

What Can You Build?

Fiat-to-Crypto Onramps

Allow users to purchase cryptocurrency with fiat currency. Support for ACH, wire transfers, SEPA, and more.

// Create a quote for buying USDC with USD
const quote = await align.transfers.createOnrampQuote(customerId, {
  source_amount: "100.00",
  source_currency: "usd",
  source_payment_rails: "ach",
  destination_token: "usdc",
  destination_network: "polygon",
});

Crypto-to-Fiat Offramps

Enable users to convert cryptocurrency back to fiat currency and withdraw to their bank accounts.

// Create a quote for selling USDC to USD
const quote = await align.transfers.createOfframpQuote(customerId, {
  source_amount: "100.00",
  source_token: "usdc",
  source_network: "polygon",
  destination_currency: "usd",
  destination_payment_rails: "ach",
});

Cross-Chain Transfers

Move assets seamlessly between different blockchain networks.

// Transfer USDC from Ethereum to Polygon
const transfer = await align.crossChain.createTransfer(customerId, {
  source_network: "ethereum",
  source_token: "usdc",
  destination_network: "polygon",
  destination_token: "usdc",
  amount: "100.00",
});

Virtual Bank Accounts

Create dedicated virtual bank accounts for seamless fiat deposits.

// Create a USD virtual account
const account = await align.virtualAccounts.create(customerId, {
  source_currency: "usd",
  destination_token: "usdc",
  destination_network: "polygon",
  destination_address: "0xYourWalletAddress...", // Address to receive funds
});

Supported Networks & Tokens

Blockchain Networks
Stablecoins
Fiat Currencies

Network	Chain ID	Status
Ethereum	1	Mainnet
Polygon	137	Mainnet
Base	8453	Mainnet
Arbitrum	42161	Mainnet
Solana	-	Mainnet
Tron	-	Mainnet

Token	Networks
USDC	Ethereum, Polygon, Base, Arbitrum, Solana
USDT	Ethereum, Polygon, Tron
EURC	Ethereum, Polygon

Currency	Payment Rails
USD	ACH, Wire
EUR	SEPA, SWIFT
AED	UAEFTS

Quick Example

Here’s a complete example of onboarding a user and processing their first deposit:

import Align from "@tolbel/align";

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

// 1. Create a customer
const customer = await align.customers.create({
  email: "[email protected]",
  type: "individual",
  first_name: "Alice",
  last_name: "Smith",
});

// 2. Start KYC verification
const kyc = await align.customers.createKycSession(customer.customer_id);
console.log(`KYC Link: ${kyc.kycs.kyc_flow_link}`);

// 3. Create virtual account for deposits (after KYC approved)
const virtualAccount = await align.virtualAccounts.create(
  customer.customer_id,
  {
    source_currency: "usd",
    destination_token: "usdc",
    destination_network: "polygon",
    destination_address: "0x742d35Cc6634C0532925a3b844Bc9e7595f0aB42",
  }
);

if ("us" in virtualAccount.deposit_instructions) {
  console.log(
    "Routing:",
    virtualAccount.deposit_instructions.us.routing_number
  );
  console.log(
    "Account:",
    virtualAccount.deposit_instructions.us.account_number
  );
}

Next Steps

Installation

Install the SDK with your preferred package manager

Quick Start

Get up and running in 5 minutes

API Reference

Explore the complete API documentation

Installation

​Align SDK

​Why Align SDK?

Type-Safe

Validated Requests

Secure Webhooks

Automatic Retry

​What Can You Build?

​Supported Networks & Tokens

​Quick Example

​Next Steps

Installation

Quick Start

API Reference

Align SDK

Why Align SDK?

What Can You Build?

Supported Networks & Tokens

Quick Example

Next Steps