Skip to content

Transaction building

Tool Summary
build_staking Build an unsigned transaction to stake or unstake SUI.
build_transfer Build an unsigned transaction to transfer a coin (SUI or any coin type) from one address to another.
simulate_transaction Dry-run a Sui transaction without signing, sending, or spending anything.
  • Title: Build staking
  • Profile: developer
  • Annotations: openWorldHint: true, readOnlyHint: true

Build an unsigned transaction to stake or unstake SUI. action=‘stake’ delegates SUI to a validator (needs validator_address + amount_mist); action=‘unstake’ withdraws a StakedSui object (needs staked_sui_id). Returns base64-encoded BCS bytes for simulation via simulate_transaction.

Parameter Type Required Description
action stake | unstake yes ‘stake’ to delegate SUI, ‘unstake’ to withdraw a StakedSui
sender string yes Sender address (0x…)
validator_address string no (stake) Validator address to stake with (0x…)
amount_mist string no (stake) Amount to stake in MIST (1 SUI = 1e9 MIST)
staked_sui_id string no (unstake) Object ID of the StakedSui to withdraw
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’
  • Title: Build transfer
  • Profile: developer
  • Annotations: openWorldHint: true, readOnlyHint: true

Build an unsigned transaction to transfer a coin (SUI or any coin type) from one address to another. For SUI it splits from the gas coin; for other coins it draws the amount from the sender’s coin objects and address balance together, so a sender holding the coin only in its address balance can still send it. Returns base64-encoded BCS bytes for simulation via simulate_transaction.

Parameter Type Required Description
sender string yes Sender address (0x…)
recipient string yes Recipient address (0x…)
amount string yes Amount in the coin’s smallest unit (raw, no decimals; for SUI this is MIST, 1 SUI = 1e9 MIST)
coin_type string no Full coin type string (default 0x2::sui::SUI)
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’
  • Title: Simulate transaction
  • Profile: developer
  • Annotations: openWorldHint: true, readOnlyHint: true

Dry-run a Sui transaction without signing, sending, or spending anything. Takes Base64 BCS transaction bytes (build_transfer and build_staking produce them) and returns the effects it WOULD have: status, gas cost, emitted events, balance and object changes. Use it to check whether a transaction succeeds and what it costs before committing, or to see what an unfamiliar payload actually does. This server holds no keys and cannot execute anything.

Parameter Type Required Description
transaction_bcs string yes Base64-encoded BCS transaction bytes
network mainnet | testnet | devnet no Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’