Skip to main content
Your Tusky account has a balance you can top up at any time with SUI, WAL, or USDC. When your publishers post transactions to Walrus — publishing files, extending storage, or deleting blobs — costs are automatically deducted from that balance. No per-request approvals, no manual gas management. You can also withdraw your remaining balance back to your wallet at any time.

​
Supported tokens

You can deposit any of the following tokens:

SUI

Covers gas fees for every Sui transaction your publishers submit.

WAL

Pays Walrus storage nodes for the epochs you purchase. WAL is locked on-chain for the duration of your storage reservation.

USDC

Deposited as a stablecoin and converted to the required token as needed.
With auto-convert enabled (the default), you only need to hold one token — Tusky converts between SUI, WAL, and USDC via on-chain DEX as needed for each operation.

​
How it works

1

Deposit tokens

Top up your balance with SUI, WAL, or USDC from any Sui-compatible wallet. There is no minimum deposit — your balance carries forward indefinitely.
2

Publishers use the balance

Your pool of publishers automatically draws from the balance to pay for every on-chain operation: publishing new blobs, extending storage epochs, and deleting blobs.
3

Auto-convert as needed

If a transaction requires WAL but you only hold SUI (or vice versa), Tusky swaps tokens automatically via on-chain DEX at the best available rate — unless you have disabled auto-convert.
4

Get notified when low

Tusky monitors your balance and sends alerts before it runs out, so you can top up before any operations are affected.
5

Withdraw anytime

Withdraw your remaining balance back to your Sui wallet at any time — no lock-in periods.

​
What the balance pays for

Your balance is drawn on for all publisher operations:
OperationCosts
Publish (upload a file)WAL for storage epochs + SUI for gas
Extend (add storage epochs to a file)WAL for the additional epochs + SUI for gas
Delete (delete a blob on-chain)SUI for gas
The balance can also be applied toward subscription plans, letting you pay for a Tusky plan directly from your on-chain balance rather than a payment card. See Subscriptions.

​
Auto-convert

When auto-convert is enabled (the default on all publishers), Tusky automatically swaps between tokens via on-chain DEX whenever the required token is insufficient.
ScenarioAuto-convert onAuto-convert off
WAL insufficient, SUI availableSUI swapped to WAL, operation proceedsOperation fails with 402
SUI insufficient, WAL availableWAL swapped to SUI for gas, operation proceedsOperation fails with 402
All balances insufficientOperation fails with 402Operation fails with 402
Swaps use aggregated DEX liquidity (Cetus, DeepBook, and others) for the best available rate. A small amount of additional SUI covers swap gas. Conversion details are included in each operation receipt.
You can disable auto-convert per publisher in Settings → Publishers or via the API.

​
Cost estimation

Preview the cost of uploading files before committing: 
curl -X POST https://api.tusky.io/v2/uploads/cost \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      { "size": 10485760, "name": "video.mp4" },
      { "size": 2097152, "name": "document.pdf" }
    ],
    "epochs": 5
  }'
The response includes a per-file breakdown and tells you whether your current balance covers the batch.

​
Checking your balance

Navigate to Settings → Wallet in the Tusky dashboard to see current balances, recent transactions with costs and file references, and projected runway based on usage patterns.

​
Low balance notifications

Tusky monitors your balance and alerts you when it drops below a configurable threshold:
ChannelDescription
DashboardA banner alert appears at the top of the Tusky dashboard.
EmailA notification is sent to your configured email address.
WebhookA programmatic alert is sent to your configured webhook URL.
Configure thresholds and channels in Settings → Wallet → Notifications.

​
What happens when balance runs out

ScenarioBehavior
New uploads (WAL low, SUI available, auto-convert on)SUI swapped to WAL automatically — upload proceeds.
New uploads (all tokens low)Fail with 402 Payment Required until you top up.
Existing filesRemain available on Walrus until their purchased epochs expire.
Auto-extendPaused — storage will not be renewed without sufficient funds.
File downloadsUnaffected — retrieval does not consume SUI or WAL.
Running out of balance never deletes your data. Files remain accessible for the full duration of their purchased epochs. Top up at any time to resume uploads and re-enable auto-extend.

​
What’s next?

Publisher

Configure your publishers, including auto-convert and storage defaults.

Subscriptions

Use your balance to pay for a Tusky subscription plan.