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 Simulate a Sui transaction without signing or submitting it.
  • 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

Simulate a Sui transaction without signing or submitting it. Takes Base64 BCS transaction bytes (build_transfer and build_staking produce them) and returns simulated status, gas cost, events, balance changes and object changes. Use it to check whether a transaction succeeds, what it costs and what an unfamiliar payload does before signing. The server holds no signing keys and cannot submit a transaction.

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