Skip to main content
skill CX Codex

sui-bridge — Claude Code skill: what it does, how to install

This Claude Code skill explains Sui Bridge and answers questions about transfers between Sui and Ethereum. It activates for queries about supported assets, limits, finality, or validator governance.

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

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

What sui-bridge does

The skill answers questions about Sui Bridge architecture, validator governance, and asset transfers between Sui and Ethereum. It routes requests for contract addresses, supported tokens, limits, and finality details to the reference file overview.md.

Supported assets are WBTC, LBTC, ETH, WETH, and USDT; ETH and WETH transfers use 8-decimal precision. The 24-hour limit depends on direction: $16 million from Ethereum to Sui and $7 million from Sui to Ethereum. A transfer is complete only after finality on the destination chain. If a Sui documentation MCP server is available, the skill can query https://sui.mcp.kapa.ai.

What it helps with

  • check which tokens Sui Bridge supports
  • look up contract addresses and package IDs
  • compare transfer limits by direction
  • find the finality requirements for a transfer
  • explain validator governance of the bridge

Example prompts for the agent

  • Explain how Sui Bridge works and how validators govern it.
  • Which assets does Sui Bridge support, and what limits apply in each direction?
  • What finality is required to transfer assets from Ethereum to Sui?

How to install sui-bridge

1Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill sui-bridge -a claude-code

2Manually: put the files in place

~/.claude/skills/sui-bridge/SKILL.md

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

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

Questions about sui-bridge

How do I install sui-bridge in Claude Code?

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

What does sui-bridge do?

It answers questions about Sui Bridge, including supported assets, transfer limits and finality, contract addresses, and validator governance.

Which assets can move through Sui Bridge?

The supported assets are WBTC, LBTC, ETH, WETH, and USDT.

Source text

SKILL.md · Apache-2.0
---
name: sui-bridge
description: >
  Sui Bridge — the native bridge for the Sui network. Use when explaining how
  Sui Bridge works, looking up supported assets, querying package IDs or contract
  addresses, understanding the global limiter, transfer parameters, finality
  requirements, or governance model. Also use when the user asks about bridging
  assets between Sui and Ethereum.
---

# Sui Bridge

> **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/concepts/tokenomics/sui-bridging](https://docs.sui.io/concepts/tokenomics/sui-bridging). When extending or updating this skill, only pull from this source. Do not use third-party blogs, tutorials, or unofficial documentation.

Sui Bridge is the native bridge for the Sui network, integrated into its core architecture. It enables asset movement between Sui and other blockchains. Sui validators operate and govern Sui Bridge. Bridge transfers and other actions require validator signatures with a threshold of voting power. Common mistakes include assuming any token can be bridged (only specific supported assets are available), misunderstanding the global limiter constraints, and not accounting for finality requirements on both chains.

This skill routes to focused reference files. Load only the ones relevant to the current task.

All patterns in this skill are derived from:
  https://docs.sui.io/concepts/tokenomics/sui-bridging

If unsure about any detail, fetch the relevant page before answering. Do not guess or extrapolate.

---

## Reference files

### overview -- Architecture and Usage
**Path:** `overview.md`
**Load when:** the user asks about bridge architecture, governance, supported assets, package IDs and contract addresses, the global limiter, transfer parameters, finality requirements, or security audits.
**Covers:** operation and governance, supported assets, package IDs and addresses, global limiter, transfer parameters, finality requirements, security architecture.

---

## Routing guide

| Task | Load |
|------|------|
| Explaining what Sui Bridge is | SKILL.md only |
| Understanding governance and validator operation | overview |
| Looking up supported assets | overview |
| Looking up package IDs or contract addresses | overview |
| Understanding the global limiter | overview |
| Understanding transfer parameters and limits | overview |
| Understanding finality requirements | overview |
| Understanding security architecture and audits | overview |
| Full deep dive on Sui Bridge | **all reference files** |

---

## Skill Content

### Key concepts

- **Native bridge.** Sui Bridge is the native bridge for the Sui network, integrated into core architecture. It is not a third-party bridge. Bridge tokens at bridge.sui.io.

- **Validator-operated.** Sui validators (the same entities securing the network) operate and govern Sui Bridge. Bridge transfers and other actions require validator signatures with a threshold of voting power.

- **Governance.** Governance occurs through validator voting. Actions require a threshold of validator voting power.

- **Supported assets.** The bridge supports a specific set of assets: WBTC, LBTC, ETH, WETH, and USDT.

- **Global limiter.** The bridge constrains total asset value leaving the bridge within 24 hours. Current limits are $16 million (Ethereum to Sui) and $7 million (Sui to Ethereum) daily, with ETH priced at $2,600 for limit calculations.

- **Open source and audited.** The bridge source code is open source (Move, Solidity, bridged ETH, bridge node, and bridge indexer implementations). Third-party security audits have been conducted by OtterSec and Zellic.

### Rules

1. **Always specify the direction when discussing limits.** The global limiter has different limits for Ethereum-to-Sui ($16 million) vs Sui-to-Ethereum ($7 million).
2. **Always note finality requirements.** Ethereum-to-Sui requires configurable Ethereum block confirmations before minting. Sui-to-Ethereum requires Sui transaction finality before releasing tokens. Do not credit the user until the bridge transfer is fully confirmed on the destination chain.
3. **Only reference supported assets.** The bridge supports WBTC, LBTC, ETH, WETH, and USDT. Do not suggest other tokens can be bridged.

### Common mistakes

- **Assuming any ERC-20 token can be bridged.** Only the specifically supported assets (WBTC, LBTC, ETH, WETH, USDT) are available on Sui Bridge.
- **Ignoring the global limiter.** Large transfers may be constrained by the 24-hour rolling limit.
- **Not accounting for finality delays.** Transfers are not instant. Ethereum-to-Sui requires Ethereum block confirmations; Sui-to-Ethereum requires Sui transaction finality.
- **Confusing transfer precision.** ETH/WETH transfers use 8-decimal precision on the bridge.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Similar skills

All skills for Writing and docs →

From the same set30

The whole set →
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 deepbook-predict This Claude Code skill covers DeepBook Predict integration for prediction markets on Sui. It explains position creation, settlement, and the liquidity pool. CX Codex +1 181installs sui-ts-sdk-backend The sui-ts-sdk-backend Claude Code skill covers backend services and agents that interact with Sui through the TypeScript SDK. It is invoked for client setup, transaction signing, package publishing, and high-throughput execution. CX Codex +1 167installs zklogin Explains zkLogin and guides its integration into Sui apps. It activates for questions about OpenID providers, address derivation, session lifetime, or security. CX Codex +1 164installs kiosk This Claude Code skill supports writing, reviewing, and debugging Move code for Sui Kiosk. It covers asset trading, NFT listings, TransferPolicy, and Kiosk extensions. CX Codex +1 162installs onchain-randomness Guides onchain randomness implementation in Sui Move. Secures functions using the 0x8 Random object against composition and PTB attacks. CX Codex +1 162installs sui-for-ethereum The sui-for-ethereum Claude Code skill explains how Sui Move differs from Ethereum and Solidity. It activates for pattern comparisons, token mappings, and contract migration questions. CX Codex +1 159installs

Project sponsors

Companies that keep this analytics open