Address balances coming to Sui

Address balances will launch on Sui Mainnet on May 20th.

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

Using Address Balances | Sui Documentation

Address balances introduce a canonical balance system for fungible assets tied to Sui addresses. Learn how to send, withdraw, and query address balances.