How do I set up wallet release for my DEX trading wallet?

What is wallet release?

Wallet release is a safeguard feature for OKX DEX trading wallets. These wallets are smart contracts that cannot be imported into other wallet applications using a mnemonic phrase or private key.
Wallet release allows you to:

• Transfer control of your DEX trading wallet to your own self-custody wallet.

• Ensure you always have full access to your assets.

• Use a web-based tool to transfer funds to your wallet when it is needed.

How does wallet release work?

In summary, here's how it works:

1. On the OKX app, trigger Wallet Release to transfer control of your DEX trading wallet to your preferred wallet address.

2. It's crucial for you to carefully review your preferred wallet address and original DEX trading wallet address in the app.

3. Set up and run a script that prepares a token transfer browser on your web browser.

4. Use the browser to safely transfer assets from your DEX trading wallet to your own wallet.

How do I set up wallet release?

1. Check which chains your DEX trading wallet is on.

2. Create a self-custody wallet if needed:

   • If you don't already have a wallet address, create one using OKX Wallet, MetaMask, or another wallet. Learn how to create an OKX wallet here.

   • For EVM chains (BNB Chain, Base, etc.): You can use one wallet address across chains. Deposit ~5 USD worth of gas tokens.

   • For Solana (SOL): Use a Solana wallet and deposit ~5 USD worth of SOL as gas.

3. On the app, select Trading > Wallet Release and follow the on-screen instructions.

   • This transfers control of your DEX trading wallet to your chosen wallet address.

     

     Choose wallet release to continue

4. At some point in the configuration, you will be prompted to enter and review your new address before continuing:

   • Enter the new address for each supported chain (e.g., SOL, BASE, BNB Chain).

   • For BASE and BNB Chain, both use the same EVM address.

     

     Review your addresses

     • Note: Do not use an address from a centralized exchange. Doing so may result in permanent loss of assets.

   • Learn how to back up your wallet's private key here.

5. Once wallet release is complete, continue on the web to transfer your funds.

How do I set up the transfer tool on my web browser?

Before you begin

To transfer your funds, you must first configure the transfer tool in your web browser. This requires installing the latest versions of Node.js and npm package manager:

• Node.js: version 22.19.0 or later

• npm: version 10.9.3 or later

Select your operating system before downloading

Download the installation files

1. Download the project archive here to your preferred folder.

2. Once the project files are downloaded and unzipped, open the folder named Wallet-Release-main.

Run the installation script

i) Mac users

1. Double-click offBoarding_Mac_script.command in the Wallet-Release-main folder.

2. If you see a warning, go to System Settings > Security & Privacy > Security, select Open Anyway > Open Anyway again, then enter your Mac password.

3. If you see an access error:

   • Right-click the Wallet-Release-main folder and select New Terminal at Folder.

   • Type chmod 755 offBoarding_Mac_script.command and press Enter.

   • Double-click offBoarding_Mac_script.command again.

4. After setup, you will see a node_modules folder and a .env file.

   1. On Mac, .env files may be hidden. Press Command + Shift + . (period) to show hidden files.

5. Update the .env file in Wallet-Release-main folder:

   1. Enter your wallet's private key and the DEX trading wallet (AA) address. If you are using OKX Wallet, follow this guide to view your wallet's private key.

   2. For the Solana chain, make sure to copy the control address (there are two DEX trading addresses).

   3. The Solana private key must be provided in base58 format.

   4. If you are only using EVM, you can leave the Solana fields blank (and vice versa).

6. Run the tool again by double-clicking offBoarding_Mac_script.command.

7. Open your browser and go to http://localhost:3000.

Note: After this initial setup, you only need to repeat Step 4 to run the project again.

ii) Windows users

1. Double-click offBoarding_Windows_script.bat in the Wallet-Release-main folder.

2. If Windows Defender SmartScreen shows a warning, select More info > Run anyway.

3. If you see a permissions error, right-click the file and select Run as administrator.

4. After setup, you will see a node_modules folder and a .env file.

5. Update the .env file in Wallet-Release-main folder:

   1. Enter your wallet's private key and the DEX trading wallet address.

   2. For Solana: use a valid 64-byte or base58 format for the private key.

   3. If you are only using EVM, you can leave the Solana fields blank (and vice versa).

   4. A .env.example file is included for reference.

6. Run the tool again by double-clicking offBoarding_Windows_script.bat.

7. Open your browser and go to http://localhost:3000.

Note: After this initial setup, you only need to repeat Step 4 to run the project again.

How do I transfer my tokens using the transfer tool?

1. Go to OKLink and select the blockchain you want to transfer tokens from.

   

   Find your blockchain on the Explorer tab

2. For Solana chain, there are 2 DEX trading addresses, copy the Storage address.

   

   Copy the storage address

3. Paste the address into OKLink and search for it.

   • You can view your native token balances (SOL, BNB, ETH).

     

     View native token balance here

   • You can also view your fungible token balances (USDT, USDC, etc.).

     

     View fungible token balance here

4. If you need to transfer fungible tokens, click the token listed to find its contract address, then copy it.

   

   Copy the contract address

5. In the wallet release tool, paste the token contract address into the Recipient Address field and enter the transfer amount (must not exceed your token balance).

   

   Paste the token contract address into the Recipient Address field

6. To transfer a native token, select Native token under Asset type.

   

   Select Native Token as your asset type

7. If the amount entered is greater than your balance, the transaction will be stopped immediately.

8. Review the estimated gas fee and other transaction details, then click Confirm to send the transaction.

9. If successful, you will see a confirmation message with the transaction hash.

10. Open the blockchain explorer and enter the transaction hash to verify the transaction.

11. To end the program, close the terminal window opened by the script.

Common issues and solutions

• Invalid private key: ensure the Solana key uses the correct format (base58).

• DEXTRADING_ADDRESS/EOA_PRIVATE_KEY not set: check that your .env file includes all required variables.

• Insufficient balance: verify that your wallet has enough tokens to cover the transfer.

• Too many decimals: check that the token’s decimal precision matches your input.

• Port is already in use: another program may be using port 3000. Close other running terminals or kill the process.

• Developer tools pop-up (Mac): close any pop-ups asking to install developer tools. These are not required.

• Software installation pop-up (Windows): close any pop-ups prompting you to install additional software.