This tutorial walks through the process of using the ArDrive Turbo CLI to top up your account with ARIO tokens. It's an extremely simple process and makes it very easy to manage your Turbo Credit balance without ever leaving your terminal or your IDE.

Prerequisites

Node.js installed on your system
ArDrive CLI installed
A wallet file (JSON format)
ARIO tokens in your wallet
Important: Make sure your wallet.json file is located in the same directory where you're running the commands

Step 1: Install Turbo SDK globally

npm install -g @ardrive/turbo-sdk

Step 2: Check your current Turbo balance

turbo balance --wallet-file wallet.json

You can specifically check your ARIO-related balance:

turbo balance --wallet-file wallet.json --token ario

Step 3: Top up your Turbo account with ARIO tokens

Use the crypto-fund command to top up your account:

turbo crypto-fund --wallet-file wallet.json --token ario --value 100

Where:

--wallet-file specifies your wallet file
--token ario indicates you want to use ARIO tokens
--value 100 is the amount of ARIO tokens to use (adjust as needed)

You'll be asked to confirm the transaction. Type yes to proceed.

Step 4: Verify your updated balance

After the transaction is confirmed, check your balance again:

turbo balance --wallet-file wallet.json

Using Turbo Credits for Uploads

Now that you have Turbo credits, you can use them for faster uploads:

ardrive upload-file --wallet-file wallet.json --parent-folder-id YOUR_FOLDER_ID --local-path YOUR_FILE_PATH --turbo

Troubleshooting

If you see "Destination address is not a valid supported native wallet address!" when using top-up, use crypto-fund instead.
Make sure your wallet has sufficient ARIO tokens before attempting to fund.
The credit amount received depends on the current exchange rate between ARIO and Turbo credits.
If you get file not found errors, verify that your wallet.json is in the current directory or provide the full path to the wallet file.

Additional Commands

View all available Turbo commands:

turbo --help

ArDrive Turbo CLI Tutorial: Topping Up with ARIO Tokens