Skip to main content
skill CX Codex

sui-networks-gas — Claude Code skill: networks and setup

The sui-networks-gas Claude Code skill explains Sui networks and gas costs. It activates for questions about Mainnet, Testnet, Devnet, Localnet, gas budgets, or epochs.

Apache-2.0 184 installs ★ 25 updated 2026-11-12

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MystenLabs/skills --skill sui-networks-gas -a claude-code
Open on GitHub

What sui-networks-gas does

The skill compares Sui’s four network environments and explains transaction fees. It breaks gas costs into computation, object storage, and rebates for freed storage, then describes how the gas budget affects a transaction.

It also covers epochs, validator changes, and gas price updates. The material focuses on network concepts, not CLI commands. Use sui-client for client setup, addresses, faucets, and explorers; sui-install covers installing the CLI. When available, the Sui documentation MCP server can help verify current details.

What it helps with

  • compare Mainnet, Testnet, Devnet, and Localnet
  • calculate gas using computation, storage, and rebates
  • understand how a gas budget affects a transaction
  • find out what changes at an epoch boundary

Example prompts for the agent

  • Explain how Sui Mainnet differs from Testnet.
  • How do storage rebates affect a Sui transaction fee?
  • What happens to gas prices when an epoch changes?

How to install sui-networks-gas

1Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill sui-networks-gas -a claude-code

2Manually: put the files in place

~/.claude/skills/sui-networks-gas/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sui-networks-gas/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about sui-networks-gas

How do I install sui-networks-gas in Claude Code?

Run npx skills add MystenLabs/skills --skill sui-networks-gas -a claude-code. The skill file is at ~/.claude/skills/sui-networks-gas/SKILL.md.

What does sui-networks-gas do?

It explains Sui network environments, gas costs and budgets, and epochs. Its scope is network concepts rather than CLI commands.

How is Sui gas cost calculated?

Add computation and storage costs, then subtract the storage rebate: gas cost = computation cost + storage cost - storage rebate.

Source text

SKILL.md · Apache-2.0
---
name: sui-networks-gas
description: >
  Sui network environments and gas economics. Use when the user asks about
  Mainnet, Testnet, Devnet, or Localnet differences, gas cost calculations
  (computation + storage - rebate), gas budgets, epochs, or how the Sui network
  operates at a high level. This skill covers network concepts, not CLI commands.

  For CLI client setup, address management, faucets, and explorers, see the
  `sui-client` skill. For installing the Sui CLI, see the `sui-install` skill.
---

# 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](https://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

| Topic | Skill |
|-------|-------|
| CLI client configuration, addresses, faucets, explorers | `sui-client/` |
| Installing the Sui CLI (suiup) | `sui-install/` |
| Move project setup and Move.toml | `sui-move-project/` |
| Publishing and upgrading packages | `sui-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.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Similar skills

All skills for Backend and APIs →
gas therealharpaljadeja Skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode: explains gas mechanics in Monad blockchain. Loaded when writing smart contracts, estimating gas or building transaction UI. CX Codex +1 255installs gas-war-sniper-teneo TeneoProtocolAI The gas-war-sniper-teneo skill queries gas prices, tracks spikes, and reports monitoring data through the Teneo CLI. Use it for live gas-war checks. CX Codex +1 534installs Multi-Chain Gas Estimator — ETH, Base, Polygon, Arb axel-belfort Multi-Chain Gas Estimator — ETH, Base, Polygon, Arb is an MCP server for Claude Code that compares gas costs across EVM networks in one request, informing deployment, bridging, or other transaction decisions. CX Codex +1 3,624installs Sui Knowledge Base (kapa.ai) MystenLabs Sui Knowledge Base (kapa.ai) is an MCP server for Claude Code and other platforms that searches Sui documentation by meaning and returns relevant links instead of a file list. CX Codex +1 ★ 7,782repo stars architecting-networks ancoleman architecting-networks is a Claude Code skill for choosing cloud network topologies: flat, multi-VPC, hub-and-spoke, or full mesh. It supports VPC, segmentation, and hybrid connectivity planning. CX Codex +1 1installs tooluniverse-gene-regulatory-networks mims-harvard tooluniverse-gene-regulatory-networks guides gene regulatory network analysis using JASPAR binding motifs, Enrichr ChIP-seq targets, GTEx eQTL data, and STRING protein interactions. CX Codex +1 148installs

From the same set30

The whole set →
sui-overview The sui-overview Claude Code skill explains Sui’s design and ecosystem. It activates for blockchain comparisons, Sui architecture planning, and questions about moving from Ethereum or Solana. CX Codex +1 400installs sui-publish sui-publish — a skill for Claude Code deploys, tests, and upgrades Sui Move smart contract packages. Triggers on requests to publish packages, manage UpgradeCap, or troubleshoot dry run deployment failures. CX Codex +1 399installs generate-sui-agent-config generate-sui-agent-config — a skill for Claude Code and Codex generates CLAUDE.md or AGENT.md config files in Sui projects. Triggers when starting a new repo or when agent instructions are missing. CX Codex +1 391installs move-security The move-security Claude Code skill reviews security in Sui Move contracts. It activates for package audits, access-control design, and checks involving keys or randomness. CX Codex +1 381installs deepbook-overview The deepbook-overview Claude Code skill explains DeepBook V3 on Sui and its integration options. It activates for questions about the order book, pool internals, DEEP, or mainnet IDs. CX Codex +1 183installs deepbook-sdk The deepbook-sdk Claude Code skill covers TypeScript integration with DeepBook V3 pools. It activates for trading apps, bots, and scripts built with @mysten/deepbook-v3. CX Codex +1 183installs deepbook-margin The deepbook-margin Claude Code skill explains margin trading on DeepBook on Sui. It covers borrowed positions, collateral, risk ratios, and liquidation. CX Codex +1 181installs deepbook-move The deepbook-move Claude Code skill guides Move contract work with DeepBook V3. It covers pools, orders, swaps, flash loans, and BalanceManager permissions. CX Codex +1 181installs

Project sponsors

Companies that keep this analytics open