Skip to main content
Tusky uses a prepaid wallet system. You deposit tokens into your Tusky wallet, and storage operations draw from that balance automatically. There is no free tier — all storage is paid at current Walrus network rates. With auto-convert enabled (the default), you only need to deposit SUI — the publisher swaps SUI → WAL automatically when needed. You can also deposit WAL directly if you prefer.

​
How Billing Works

Every file you upload through Tusky involves two costs:
Cost ComponentTokenDescription
Walrus storageWALPaid to Walrus storage nodes for blob storage across epochs. Rate determined by the Walrus network.
Gas feeSUISui network transaction fee for publishing the blob on-chain.
Storage costs scale with file size and the number of storage epochs. Tusky passes through Walrus storage costs directly with no markup or infrastructure fee.

​
Funding Your Wallet

1

Open the wallet page

Navigate to Account → Wallet in the Tusky dashboard, or go directly to app.tusky.io/account/wallet.
2

Deposit SUI

Click Deposit SUI and approve the transfer from your connected Sui wallet. SUI is used for gas fees on Sui transactions.
3

Deposit WAL (optional)

Click Deposit WAL and approve the transfer. WAL is used to pay Walrus storage nodes for blob storage.
With autoConvert: true on your publisher (the default), you can skip this step entirely — the publisher swaps SUI → WAL via on-chain DEX when needed. If you prefer to deposit WAL directly, you can acquire it on supported Sui DEXes or through the Walrus staking mechanism.

​
Checking Your Balance

View your current SUI and WAL balances on the wallet page in the dashboard. The page shows:
  • Available balance — funds ready for storage operations
  • Reserved balance — funds earmarked for in-progress uploads
  • Estimated remaining storage — approximate storage capacity at current rates

​
Programmatic balance check

Use the SDK or API to check your balance programmatically: 
const account = await tusky.account.get();
console.log("SUI balance:", account.wallet.sui);
console.log("WAL balance:", account.wallet.wal);

​
Low Balance Notifications

Tusky sends notifications when your wallet balance drops below the threshold needed for continued operations:
  • Warning — balance is running low, top up soon to avoid upload failures
  • Critical — balance is insufficient for new uploads; existing stored files are unaffected
If your WAL balance runs out, you will not be able to upload new files or renew expiring blobs. Existing stored files remain available on the Walrus network until their storage epochs expire. Top up before epoch expiration to ensure continuity.
Configure notification preferences (email, webhook) in the dashboard under Account → Notifications.

​
Pay-As-You-Go with x402

For applications that prefer per-request billing over prepaid balances, Tusky supports the x402 protocol — a standard for HTTP-native micropayments. With x402, each API request includes a payment header, and Tusky charges the exact cost of the operation in real time. This eliminates the need to maintain a prepaid balance.
  1. Your application sends an API request to Tusky
  2. If the request requires payment, Tusky responds with a 402 Payment Required status and a payment specification
  3. Your application signs a micropayment using your Sui wallet
  4. The request is retried with the payment proof in the header
  5. Tusky processes the request and settles the payment
The x402-compatible SDK handles this flow automatically.

​
Cost Estimation

Use the dashboard cost calculator or the upload cost API to preview costs before uploading. Pass a list of file sizes to get a per-file breakdown and totals: 
const estimate = await tusky.upload.cost({
  files: [
    { size: 10 * 1024 * 1024, name: "video.mp4" },
    { size: 2 * 1024 * 1024, name: "report.pdf" },
  ],
  epochs: 5,
});

console.log("Total WAL:", estimate.totals.totalWal);
console.log("Total SUI:", estimate.totals.totalSui);
console.log("Balance sufficient:", estimate.balance.sufficient);
Cost estimates are based on current Walrus network rates and may fluctuate. The actual cost is determined at the time of the storage transaction.

​
Summary

FeaturePrepaid Walletx402 Pay-As-You-Go
Funding modelDeposit SUI + WAL upfrontPay per request via micropayment
Best forHigh-volume, predictable usageSporadic, per-request billing
OverheadSingle deposit transactionPayment header per request
Balance managementManual top-ups with notificationsNo balance to manage

​
Next Steps

Generate API Keys

Create API keys for programmatic access.

Quickstart

Upload your first file to Walrus.