Wallet Release - Multi-Chain Asset Off-Boarding Tool

A comprehensive tool for transferring assets from Smart Account vaults across multiple blockchains (Solana, Base, BNB chain, xLayer).

Quick Start

Prerequisites

• Node.js 18+
• TypeScript

Installation

📥 Manual Installation

git clone https://github.com/okx/Wallet-Release.git
cd Wallet Release
npm install

Environment Setup

Create .env file:

# EVM
EVM_EOA_PRIVATE_KEY=<your EVM EOA private key>
EVM_DEXTRADING_ADDRESS=<your EVM AA address>

# Solana
SOL_EOA_PRIVATE_KEY=<your solana EOA private key>
SOL_DEXTRADING_ADDRESS=<your solana AA ID>

Notice : For users who use EVM only, they can leave blank to solana fields; vice versa

Usage

🌐 Web Interface (Recommended)

# Start the web server
npm run web

Then open your browser to http://localhost:3000

Terminal (Incomplete, for development only)

# Start the terminal
npm run terminal

Common Flow (Both Interfaces):

1. Choose chain (Solana/Base/BNB chain/xLayer)
2. Select asset type (Native Token/Fungible Token)
3. For fungible tokens, input token contract address
4. Input recipient address & amount
5. Review estimated gas fee and balance
6. Confirm transaction
7. Get transaction hash for verification

Supported Chains

• Solana (Native SOL + SPL tokens)
• Base (Native ETH + ERC-20)
• BNB chain (Native BNB + BEP-20)
• xLayer (Native OKB + ERC-20)

🔐 Security

• Private keys are loaded from environment variables
• Memory cleanup patterns implemented for sensitive data
• Both interfaces use identical security practices
• Consider using hardware wallets for production
• Web interface runs on localhost only

❓ Troubleshooting

Web Interface Issues

• Port already in use: kill process on port 3000

Common Issues

• "Invalid private key": Ensure Solana keys are in correct 64-byte array format
• "SOL_DEXTRADING_ADDRESS not set": Check your .env file has all required variables
• "Insufficient balance": Verify you have enough tokens/native currency
• "Too many decimals": Check token decimal precision matches your input

Environment Variables

All chains require their respective private keys and addresses to be set in .env:

• Solana: SOL_EOA_PRIVATE_KEY, SOL_DEXTRADING_ADDRESS
• EVM chains: EVM_EOA_PRIVATE_KEY, EVM_DEXTRADING_ADDRESS