🌊 Acala.js

📦 Packages

Package	Description	Version
@acala-network/sdk	Main SDK with wallet, DeFi protocols
@acala-network/sdk-core	Core utilities, tokens, math operations
@acala-network/sdk-swap	DEX trading and liquidity operations
@acala-network/sdk-loan	CDP (Collateralized Debt Position) management
@acala-network/sdk-homa	Liquid staking (LDOT/LKSM) operations
@acala-network/sdk-payment	Transaction fee management
@acala-network/wormhole-portal	Cross-chain bridge operations

🚀 Quick Start

Installation

# Install the main SDK
npm install @acala-network/sdk @acala-network/types @polkadot/api

# Or with yarn
yarn add @acala-network/sdk @acala-network/types @polkadot/api

Basic Usage

import { ApiPromise, WsProvider } from '@polkadot/api';
import { options } from '@acala-network/api';
import { Wallet } from '@acala-network/sdk';

// Connect to Acala network
const provider = new WsProvider('wss://acala-rpc.aca-api.network');
const api = await ApiPromise.create(options({ provider }));

// Create wallet instance
const wallet = new Wallet(api);

// Get account balance
const address = '5F98oWfz2r5rcRVnP9VCndg33DAAsky3iuoBSpaPUbgN9AJn';
const accountInfo = await wallet.queryBalance(address);
console.log('ACA Balance:', accountInfo.native.available.toString());

// Subscribe to balance changes
wallet.subscribeBalance(address, (balance) => {
  console.log('Balance updated:', balance.native.available.toString());
});

📚 Documentation

• 📖 SDK Documentation - Complete API reference
• 🏠 Homa Liquid Staking - Liquid staking guide
• 🌉 Cross-Chain Operations - Bridge functionality
• 🔄 aUSD Bridge - aUSD cross-chain transfers
• 🎨 NFT Operations - NFT minting and trading

🛠️ Development

Prerequisites

• Node.js ≥ 22
• Yarn 4.x

Setup

# Clone the repository
git clone https://github.com/AcalaNetwork/acala.js.git
cd acala.js

# Install dependencies
yarn install

# Build all packages
yarn build

# Run tests
yarn test

# Lint code
yarn lint

Project Structure

acala.js/
├── packages/
│   ├── sdk/           # Main SDK package
│   ├── sdk-core/      # Core utilities
│   ├── sdk-swap/      # DEX operations
│   ├── sdk-loan/      # CDP management
│   ├── sdk-homa/      # Liquid staking
│   ├── sdk-payment/   # Fee management
│   └── wormhole-portal/ # Cross-chain bridge
├── docs/              # Documentation
└── examples/          # Example applications