Skip to main content
Prepaid mode lets you fund your Tusky managed wallet in advance with SUI and WAL tokens. When you upload files, the cost is automatically deducted from your balance — no per-request payment prompts and no x402 handshakes.

​
How It Works

1

Fund your wallet

Send SUI or WAL tokens to your managed wallet address. You can find your wallet address in the dashboard or via the SDK.
2

Upload files

When you upload, Tusky deducts the Walrus storage cost from your prepaid balance automatically.
3

Monitor balance

Track your remaining balance through the dashboard, API, or SDK. Tusky sends notifications when your balance is running low.

​
Funding Your Wallet

​
Find Your Wallet Address

Navigate to Settings → Wallet to view your managed wallet address and current balances.

​
Send Tokens

Transfer SUI or WAL to your managed wallet address from any Sui-compatible wallet (Sui Wallet, Suiet, Ethos, or a CLI wallet). The balance updates within seconds after the transaction is confirmed on-chain.
You can fund your wallet at any time and there is no minimum deposit. Top up whenever it is convenient — your balance carries forward indefinitely.

​
Balance Deduction

When you upload a file, the cost breakdown is: 
Deducted Amount = Walrus Storage Cost
If your balance is insufficient, the upload will fail with a 402 Payment Required error. You can either fund your wallet or fall back to pay-as-you-go micropayments.

​
Low Balance Notifications

Tusky monitors your wallet balance and sends notifications when it drops below a configurable threshold:
ChannelDescription
DashboardA banner alert appears in the Tusky dashboard.
EmailAn email notification is sent if you have an email address configured.
WebhookConfigure a webhook URL to receive low-balance alerts programmatically.
You can configure the low-balance threshold in Settings → Wallet → Notifications. The default threshold is 1 SUI.

​
Checking Your Balance

​
SDK

const account = await tusky.account.get();
const wallet = account.managedWallet;

console.log(`SUI: ${wallet.suiBalance}`);
console.log(`WAL: ${wallet.walBalance}`);

// Check usage statistics
const usage = await tusky.account.usage();
console.log(`Storage: ${usage.storageBytes} bytes`);
console.log(`Files: ${usage.fileCount}`);

​
Dashboard

The Wallet section of the dashboard shows:
  • Current SUI and WAL balances
  • Recent transactions with costs and file references
  • Projected runway based on current usage patterns

​
Prepaid vs. Pay-As-You-Go

FeaturePrepaidPay-As-You-Go
Payment timingUpfront depositPer-request
Payment methodDirect wallet transferx402 micropayment
Upload experienceSeamless (no payment prompts)Automatic via x402
Best forFrequent uploaders, automationOccasional use, testing
You can use both models simultaneously. If your prepaid balance has funds, it is used first. If the balance is insufficient, Tusky falls back to x402 pay-as-you-go.

​
What’s Next

Pay As You Go

Learn about x402 micropayments for per-request billing.

Account

Monitor your balance and usage programmatically.