AcalaNetwork · qiweiii · Oct 10, 2025 · Oct 10, 2025 · Oct 10, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 4.1.15 - Oct 10, 2025
+Changes:
+  - Update dependencies to latest versions
+
 ## 4.1.6-15 July 7, 2022
 Changes:
   - Changes homa sdk interface name subscribeEnv -> env$

diff --git a/README.md b/README.md
@@ -1,49 +1,107 @@
-![license](https://img.shields.io/badge/License-Apache%202.0-blue?logo=apache&style=flat-square)
-[![npm](https://img.shields.io/npm/v/@acala-network/api?logo=npm&style=flat-square)](https://www.npmjs.com/package/@acala-network/api)
+# 🌊 Acala.js
 
-# @acala-network
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue?logo=apache&style=flat-square)](https://github.com/AcalaNetwork/acala.js/blob/master/LICENSE)
+[![npm](https://img.shields.io/npm/v/@acala-network/sdk?logo=npm&style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?logo=typescript&style=flat-square)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22-green?logo=node.js&style=flat-square)](https://nodejs.org/)
 
-This library provides additional typing information for user to access Acala Network by using [polkadot.js](https://github.com/polkadot-js/api).
 
-# Getting Started
+## 📦 Packages
 
-More documentation and examples on [wiki](https://github.com/AcalaNetwork/acala.js/wiki).
+| Package | Description | Version |
+|---------|-------------|---------|
+| [`@acala-network/sdk`](./packages/sdk) | Main SDK with wallet, DeFi protocols | [![npm](https://img.shields.io/npm/v/@acala-network/sdk?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk) |
+| [`@acala-network/sdk-core`](./packages/sdk-core) | Core utilities, tokens, math operations | [![npm](https://img.shields.io/npm/v/@acala-network/sdk-core?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk-core) |
+| [`@acala-network/sdk-swap`](./packages/sdk-swap) | DEX trading and liquidity operations | [![npm](https://img.shields.io/npm/v/@acala-network/sdk-swap?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk-swap) |
+| [`@acala-network/sdk-loan`](./packages/sdk-loan) | CDP (Collateralized Debt Position) management | [![npm](https://img.shields.io/npm/v/@acala-network/sdk-loan?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk-loan) |
+| [`@acala-network/sdk-homa`](./packages/sdk-homa) | Liquid staking (LDOT/LKSM) operations | [![npm](https://img.shields.io/npm/v/@acala-network/sdk-homa?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk-homa) |
+| [`@acala-network/sdk-payment`](./packages/sdk-payment) | Transaction fee management | [![npm](https://img.shields.io/npm/v/@acala-network/sdk-payment?style=flat-square)](https://www.npmjs.com/package/@acala-network/sdk-payment) |
+| [`@acala-network/wormhole-portal`](./packages/wormhole-portal) | Cross-chain bridge operations | [![npm](https://img.shields.io/npm/v/@acala-network/wormhole-portal?style=flat-square)](https://www.npmjs.com/package/@acala-network/wormhole-portal) |
 
-- Install dependencies
+## 🚀 Quick Start
+
+### Installation
 
 ```bash
-yarn add @polkadot/api @acala-network/api@beta
+# 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
 ```
 
-- Create API instance
+### Basic Usage
 
-```ts
-import { ApiPromise } from '@polkadot/api';
-import { WsProvider } from '@polkadot/rpc-provider';
+```typescript
+import { ApiPromise, WsProvider } from '@polkadot/api';
 import { options } from '@acala-network/api';
+import { Wallet } from '@acala-network/sdk';
 
-async function main() {
-    const provider = new WsProvider('wss://karura.api.onfinality.io/public-ws');
-    const api = new ApiPromise(options({ provider }));
-    await api.isReady;
+// Connect to Acala network
+const provider = new WsProvider('wss://acala-rpc.aca-api.network');
+const api = await ApiPromise.create(options({ provider }));
 
-    // use api
-}
+// Create wallet instance
+const wallet = new Wallet(api);
 
-main()
+// 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());
+});
 ```
 
-- Use api to interact with node
+## 📚 Documentation
+
+- 📖 **[SDK Documentation](./packages/sdk/README.md)** - Complete API reference
+- 🏠 **[Homa Liquid Staking](./packages/sdk/docs/homa.md)** - Liquid staking guide
+- 🌉 **[Cross-Chain Operations](./packages/sdk/docs/cross-chain.md)** - Bridge functionality
+- 🔄 **[aUSD Bridge](./packages/sdk/docs/ausd-bridge.md)** - aUSD cross-chain transfers
+- 🎨 **[NFT Operations](./packages/sdk/docs/nft.md)** - NFT minting and trading
+
+## 🛠️ Development
+
+### Prerequisites
+
+- Node.js ≥ 22
+- Yarn 4.x
+
+### Setup
 
-```ts
-// query and display account data
-const data = await api.query.system.account('5F98oWfz2r5rcRVnP9VCndg33DAAsky3iuoBSpaPUbgN9AJn');
-console.log(data.toHuman())
+```bash
+# 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
 ```
 
-# Packages
+### Project Structure
 
-- [api](./packages/api)
-  - Contains necessary options to create a polkadot.js API instance
-- [types](./packages/types)
-  - Polkadot.js type definations for Acala Network
+```
+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
+```
diff --git a/package.json b/package.json
@@ -1,8 +1,8 @@
 {
-  "version": "4.1.14",
+  "version": "4.1.15",
   "private": true,
   "engines": {
-    "node": ">=16"
+    "node": ">=22"
   },
   "workspaces": [
     "packages/*"

diff --git a/packages/sdk-core/package.json b/packages/sdk-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk-core",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the core of acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -40,11 +40,11 @@
   },
   "peerDependencies": {
     "@acala-network/types": "^6",
-    "@polkadot/api": "^12"
+    "@polkadot/api": "^16"
   },
   "dependencies": {
-    "@acala-network/types": "^6.1.1",
-    "@polkadot/api": "^12.1.1",
+    "@acala-network/types": "^6.3.0",
+    "@polkadot/api": "^16.4.8",
     "bignumber.js": "^9.0.0",
     "lodash": "^4.17.20"
   },

diff --git a/packages/sdk-homa/package.json b/packages/sdk-homa/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk-homa",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the homa sub module in acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -40,12 +40,12 @@
   },
   "peerDependencies": {
     "@acala-network/types": "^6",
-    "@polkadot/api": "^12"
+    "@polkadot/api": "^16"
   },
   "dependencies": {
     "@acala-network/sdk-core": "workspace:*",
-    "@acala-network/types": "^6.0.4",
-    "@polkadot/api": "^12.1.1",
+    "@acala-network/types": "^6.3.0",
+    "@polkadot/api": "^16.4.8",
     "lodash": "^4.17.20",
     "rxjs": "^7.8.1"
   },

diff --git a/packages/sdk-loan/package.json b/packages/sdk-loan/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk-loan",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the loan sub module in acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -40,13 +40,13 @@
   },
   "peerDependencies": {
     "@acala-network/types": "^6",
-    "@polkadot/api": "^12"
+    "@polkadot/api": "^16"
   },
   "dependencies": {
     "@acala-network/sdk": "workspace:*",
     "@acala-network/sdk-core": "workspace:*",
-    "@acala-network/types": "^6.0.4",
-    "@polkadot/api": "^12.1.1",
+    "@acala-network/types": "^6.3.0",
+    "@polkadot/api": "^16.4.8",
     "lodash": "^4.17.20",
     "rxjs": "^7.8.1"
   },

diff --git a/packages/sdk-payment/package.json b/packages/sdk-payment/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk-payment",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the payment acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -40,7 +40,7 @@
   },
   "peerDependencies": {
     "@acala-network/types": "^6",
-    "@polkadot/api": "^12"
+    "@polkadot/api": "^16"
   },
   "dependencies": {
     "@acala-network/sdk": "workspace:*",

diff --git a/packages/sdk-swap/package.json b/packages/sdk-swap/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk-swap",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the swap sub module in acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -40,13 +40,13 @@
   },
   "peerDependencies": {
     "@acala-network/types": "^6",
-    "@polkadot/api": "^12"
+    "@polkadot/api": "^16"
   },
   "dependencies": {
     "@acala-network/sdk": "workspace:*",
     "@acala-network/sdk-core": "workspace:*",
-    "@acala-network/types": "^6.0.4",
-    "@polkadot/api": "^12.1.1",
+    "@acala-network/types": "^6.3.0",
+    "@polkadot/api": "^16.4.8",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {

diff --git a/packages/sdk/package.json b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/sdk",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "acala network sdk",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -50,16 +50,16 @@
   },
   "homepage": "https://github.com/AcalaNetwork/acala.js",
   "peerDependencies": {
-    "@acala-network/api": "^5",
+    "@acala-network/api": "^6",
     "@acala-network/eth-providers": "~2.7.18",
-    "@polkadot/api": "^12",
+    "@polkadot/api": "^16",
     "ethers": "~5.7.0"
   },
   "dependencies": {
-    "@acala-network/api": "^6.1.1",
+    "@acala-network/api": "^6.3.0",
     "@acala-network/eth-providers": "~2.7.18",
     "@acala-network/sdk-core": "workspace:*",
-    "@polkadot/api": "^12.1.1",
+    "@polkadot/api": "^16.4.8",
     "axios": "^0.24.0",
     "ethers": "~5.7.0",
     "graphql": "^16.3.0",

diff --git a/packages/sdk/src/wallet/vesting/index.ts b/packages/sdk/src/wallet/vesting/index.ts
@@ -4,7 +4,7 @@ import { Option, Vec } from '@polkadot/types';
 import {
   OrmlVestingVestingSchedule,
   PalletBalancesBalanceLock,
-  PolkadotPrimitivesV6PersistedValidationData
+  PolkadotPrimitivesV8PersistedValidationData
 } from '@polkadot/types/lookup';
 import { combineLatest, firstValueFrom, map, Observable } from 'rxjs';
 import { TokenProvider } from '../token-provider/type.js';
@@ -36,7 +36,7 @@ export class Vesting {
       params: [address]
     }).observable;
     // get parachain block  api.query.parachainSystem.validationData()
-    const parachain$ = Storage.create<Option<PolkadotPrimitivesV6PersistedValidationData>>({
+    const parachain$ = Storage.create<Option<PolkadotPrimitivesV8PersistedValidationData>>({
       api: this.api,
       path: 'query.parachainSystem.validationData',
       params: []

diff --git a/packages/wormhole-portal/package.json b/packages/wormhole-portal/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@acala-network/wormhole-portal",
-  "version": "4.1.14",
+  "version": "4.1.15",
   "description": "the wormhole wrapper for acala/karura network",
   "author": "Acala Developers <hello@acala.network>",
   "license": "Apache-2.0",
@@ -39,20 +39,20 @@
     }
   },
   "peerDependencies": {
-    "@acala-network/api": "^5",
+    "@acala-network/api": "^6",
     "@acala-network/eth-providers": "~2.7.18",
-    "@polkadot/api": "^12",
+    "@polkadot/api": "^16",
     "ethers": "~5.7.0"
   },
   "dependencies": {
-    "@acala-network/api": "^6.1.1",
+    "@acala-network/api": "^6.3.0",
     "@acala-network/eth-providers": "~2.7.18",
     "@acala-network/sdk": "workspace:*",
     "@certusone/wormhole-sdk": "^0.5.0",
     "@ethersproject/bignumber": "^5.7.0",
     "@grpc/grpc-js": "^1.6.8",
     "@improbable-eng/grpc-web-node-http-transport": "^0.15.0",
-    "@polkadot/api": "^12.1.1",
+    "@polkadot/api": "^16.4.8",
     "bn.js": "^5.2.1",
     "ethers": "~5.7.0"
   },

diff --git a/tsconfig.base.json b/tsconfig.base.json
@@ -4,8 +4,8 @@
 		"esModuleInterop": true,
 		"lib": ["esnext", "dom", "dom.iterable"],
 		"isolatedModules": true,
-		"module": "nodenext",
-		"moduleResolution": "nodenext",
+		"module": "esnext",
+		"moduleResolution": "bundler",
 		"resolveJsonModule": true,
 		"noUnusedLocals": true,
 		"noUnusedParameters": true,