Sui Move Architecture

Design the smallest on-chain system that preserves consensus, custody, composition, and reconstruction.

Target repository instructions, accepted design records, pinned toolchain behavior, and published compatibility commitments take precedence over this standard's examples.

Decide what belongs on chain

Put logic or state on chain only when it must:

• authorize, reject, or order a consensus-critical transition;
• custody, allocate, conserve, mint, burn, or settle assets;
• provide a synchronous result for trustless contract composition; or
• commit the smallest primitive fact required for independent reconstruction.

Keep deterministic projections, formatting, aggregation, previews, transaction construction, and convenience reads off chain. A transition can recompute a derived value internally when it must enforce fees, slippage, bounds, conservation, or another invariant.

Choose package boundaries