mcpField
S
sui-networks-gas

sui-networks-gas

github.com/mystenlabsOther19136 installsUpdated today
Repository

About sui-networks-gas

A reference skill covering Sui network environments, gas costs, and epochs, based exclusively on docs.sui.io. It is for developers working with Sui transactions and deployments, with practical network-switching and gas-budget guidance.

Key features

  1. 01Mainnet, Testnet, Devnet, and Localnet overview
  2. 02Computation, storage, and rebate gas model
  3. 03Epoch behavior and Move context methods
  4. 04CLI gas-budget and network-switching guidance
  5. 05Source constraint to docs.sui.io

Use cases

  1. 01Choose a Sui network for testing or deployment
  2. 02Estimate transaction gas components
  3. 03Check epoch data in Move code
  4. 04Avoid submitting transactions to the wrong network

MCP support

The skill recommends querying the Sui documentation MCP server at https://sui.mcp.kapa.ai for verification and details beyond its reference files.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mystenlabs/skills --skill sui-networks-gas

After installing, type/sui-networks-gasin Claude Code to confirm it loaded.

Bundled filesevals/evals.json

Details

From the project README

Sui Networks and Gas

MCP tool: When available in your environment, also query the Sui documentation MCP server (https://sui.mcp.kapa.ai) for up-to-date answers. Use it for verification and for details not covered by these reference files.

Source constraint: All information in this skill is sourced exclusively from docs.sui.io. When extending or updating this skill, only pull from this source. Do not use third-party blogs, tutorials, or unofficial documentation.

Related skills

TopicSkill
CLI client configuration, addresses, faucets, explorerssui-client/
Installing the Sui CLI (suiup)sui-install/
Move project setup and Move.tomlsui-move-project/
Publishing and upgrading packagessui-publish/

Sui networks

Sui operates four network environments:

  • Mainnet: Production network. SUI tokens have real monetary value. Use for final deployments.
  • Testnet: Mirrors Mainnet features. Free SUI tokens from faucets. Use for integration testing and staging.
  • Devnet: Development network. Free SUI tokens. Use for early-stage development and experimentation.
  • Localnet: Runs locally on your machine. Use for offline development and unit testing.

Gas cost model

Every transaction on Sui requires SUI tokens to pay gas. The total gas cost is:

gas cost = computation cost + storage cost - storage rebate

  • Computation cost: Proportional to the computational effort of executing the transaction.
  • Storage cost: The cost of storing new or expanded objects onchain. You pay for the bytes your objects occupy.
  • Storage rebate: When a transaction deletes objects or reduces their size, you receive a rebate for the storage freed. This incentivizes cleaning up unused state.

The gas budget (--gas-budget) sets the maximum you are willing to pay. If the transaction exceeds the budget, it fails and a portion of the gas budget is still charged. On Testnet and Devnet, tokens are free through faucets (see the sui-client skill for faucet methods). Gas prices can vary per epoch; query the current gas price through the RPC.

Epochs

An epoch is a fixed time period during which the validator set and gas price remain constant. On Mainnet, one epoch is approximately 24 hours. At the epoch boundary, the network processes staking rewards, rotates validators, and updates the gas price. Use ctx.epoch() to read the current epoch number in Move and ctx.epoch_timestamp_ms() for the epoch start time.

Rules

  • Always specify --gas-budget when submitting transactions from the CLI.
  • Use sui client switch --env <ENV> to change networks. Do not edit client.yaml manually.

Common mistakes

  • Forgetting to switch networks. Publishing to Mainnet when you meant Testnet. Always verify with sui client active-env.
  • Running out of gas on Testnet/Devnet. Use the faucet (see sui-client skill) to get free tokens.

Comments

Markdown supported