Field guide for Sui builders

Ship on Sui.
Skip the guesswork.

Concise guides, working snippets and the right tools for Move contracts and TypeScript dApps on the Sui blockchain.

Try Sui in your browser Start building with the CLI

Why Sui

A chain designed around objects

Sui’s data model lets independent transactions run in parallel, which shapes how you design contracts and apps.

Objects, not accounts

State lives in typed objects with owners. Transactions touching different objects never contend.

Parallel by default

Owned-object transactions skip consensus entirely; Mysticeti handles shared state with sub-second finality.

Programmable transactions

Chain up to 1,024 Move calls in one atomic PTB, composed client-side, with no custom contract needed.

zkLogin

Users sign in with Google or Apple and get a self-custodial address without seed phrases.

From zero to published in four steps

1
Install the Sui CLI
terminal
brew install sui

Create an address on testnet

terminal

sui client new-env --alias testnet --rpc https://fullnode.testnet.sui.io:443
sui client switch --env testnet
sui client new-address ed25519

Fund it from faucet.sui.io.

Write and test a Move package

terminal

sui move new hello
cd hello
sui move test

sources/counter.move

module hello::counter;

public struct Counter has key {
    id: UID,
    value: u64,
}

public fun create(ctx: &mut TxContext) {
    transfer::share_object(Counter {
        id: object::new(ctx),
        value: 0,
    })
}

public fun increment(c: &mut Counter) {
    c.value = c.value + 1;
}

Publish and call it

terminal

sui client publish

app.ts

import { SuiClient, getFullnodeUrl } from '@mysten/sui/client'
import { Transaction } from '@mysten/sui/transactions'

const client = new SuiClient({ url: getFullnodeUrl('testnet') })

const tx = new Transaction()
tx.moveCall({
  target: `${PACKAGE_ID}::counter::increment`,
  arguments: [tx.object(COUNTER_ID)],
})

await client.signAndExecuteTransaction({ signer, transaction: tx })

The stack