Sui Address Balances Coming to Mainnet

March 16, 2026

Summary

The Upside announces address balances coming to Sui Mainnet. Fungible tokens can now be stored directly at addresses as well as Coin<T> objects, so wallets, exchanges, explorers, and infra should review integrations. Use TS SDK v2+ coinWithBalance and the migration guide to support combined balances and withdrawals from address balances.

Address balances coming to Sui

Address balances will launch on Sui Mainnet soon.

At that time, fungible tokens can be stored directly at an address, not only as Coin<T> objects.

Nothing is being deprecated, but wallets, exchanges, explorers, and infra providers should review integrations. Funds can now also arrive via send_funds() as an address balance, not just as a coin object. If your system only tracks coins, users may receive funds you don’t detect causing your system not to display or spend them correctly.

The latest TS SDK (v2+) coinWithBalance allows you to spend funds in address balances automatically.

All mysten-supported RPC systems (JSON RPC, gRPC, Graphql) display accurate balance information including address balances.

Migration guide: https://docs.sui.io/guides/developer/address-balances-migration

What to check

Builders of potentially affected products should review their integrations and ensure they:
- Support balances that include both coin objects and address balances
- Use updated balance queries (RPC now returns combined balances)
- Support transaction construction that can withdraw from address balances

Address balances and coin objects will coexist, and migration is optional, but builders are encouraged to update integrations to support the new balance model.
@Sui Developer