Aptos Wallet Adapter

A comprehensive monorepo developed and maintained by Aptos for wallet and dapp builders. Includes wallet adapter SDK, cross-chain functionality, and derived wallet support for seamless multi-chain integration.

NOTE: Vue and Nuxt integration has been moved to a separate community-maintained repository: aptos-wallet-adapter-vue

Features

• Wallet Adapter: Connect dapps to Aptos wallets with React support
• Cross-Chain Transfers: USDC transfers between Aptos and other chains (Solana, Ethereum, Sui, etc.) via Circle's CCTP
• Derived Wallets: Create Aptos wallets derived from external chain keys (Ethereum, Solana, Sui)
• UI Components: Pre-built wallet selector components for Ant Design and Material-UI
• Comprehensive Testing: Full test coverage with Vitest

Getting Started

• Wallet Adapter Docs
• For Aptos Dapps
• For Aptos Wallets
• Cross-Chain Transfers

Example Applications

• Next.js Example - Basic wallet adapter integration
• Next.js Cross-Chain Example - Cross-chain USDC transfers demo

Packages

Core Packages

• @aptos-labs/wallet-adapter-core - Core wallet adapter logic and functionality
• @aptos-labs/wallet-adapter-react - React provider and hooks for wallet integration

UI Components

• @aptos-labs/wallet-adapter-ant-design - Pre-built wallet selector using Ant Design
• @aptos-labs/wallet-adapter-mui-design - Pre-built wallet selector using Material-UI

Cross-Chain Packages

• @aptos-labs/cross-chain-core - SDK for cross-chain USDC transfers via Circle's CCTP
• @aptos-labs/derived-wallet-base - Base functionality for derived wallets
• @aptos-labs/derived-wallet-ethereum - Ethereum/EVM-based derived wallet
• @aptos-labs/derived-wallet-solana - Solana-based derived wallet
• @aptos-labs/derived-wallet-sui - Sui-based derived wallet

Supported Wallets

• AptosConnect
• Backpack Wallet
• Bitget Wallet
• Cosmostation Wallet
• MSafe
• Nightly
• OKX
• Petra
• RimoSafe

Develop Locally

Requirements

• Node.js 20.18.0 or higher
• pnpm 9.15.5

Setup

1. Clone the repo with git clone https://github.com/aptos-labs/aptos-wallet-adapter.git
2. On the root folder, run pnpm install and pnpm turbo run build
3. On the root folder, run pnpm turbo run dev - that would spin up a local server (https://localhost:3000) with the Next.js demo app

Testing

Run tests across all packages:

pnpm test

All packages include comprehensive test coverage using Vitest.

Contributing

Looking how you can contribute? Take a look at our contribution guide

Terms of Use and Privacy Policy

By accessing or using the wallet adapter, you agree to be bound to the Aptos Labs Terms of Use and Privacy Policy.