sui-networks-gas
Skill20 starsChanged 16 days agoApache-2.0View on GitHub
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.
In this repository30 other files it gives its agents.
- accessing-dataSkill
- composable-move-functionsSkill
- deepbook-marginSkill
- deepbook-moveSkill
- deepbook-overviewSkill
- deepbook-predictSkill
- deepbook-sdkSkill
- frontend-appsSkill
- generate-sui-agent-configSkill
- kioskSkill
- modern-move-syntaxSkill
- move-securitySkill
- move-unit-testingSkill
- naming-conventionsSkill
- sui-object-modelSkill
- onchain-randomnessSkill
- ptbsSkill
- sui-bridgeSkill
- sui-buildSkill
- sui-clientSkill
- sui-for-ethereumSkill
- sui-installSkill
- sui-move-projectSkill
- sui-moveSkill
- sui-overviewSkill
- sui-publishSkill
- sui-sdksSkill
- sui-ts-sdk-backendSkill
- walrus-sitesSkill
- zkloginSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 43
Every transaction on Sui requires SUI tokens to pay gas.
- Distinctive: line 49
Storage rebate: When a transaction deletes objects or reduces their size, you receive a rebate for the storage freed.
- Very specific: line 59
Always specify --gas-budget when submitting transactions from the CLI.
- Very specific: line 60
Use sui client switch --env <ENV> to change networks.
- Very specific: line 65
Running out of gas on Testnet/Devnet: Use the faucet (see sui-client skill) to get free tokens.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
| 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-budgetwhen submitting transactions from the CLI. - Use
sui client switch --env <ENV>to change networks. Do not editclient.yamlmanually.
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-clientskill) to get free tokens.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.