sui-cli-web

Local server that bridges your browser to the Sui CLI

Live Demo · Documentation · Report Bug

Why sui-cli-web-server?

Your private keys stay on YOUR machine. This package runs a local server that connects the web interface to your locally installed Sui CLI. No keys are ever transmitted to external servers.

Browser (cli.firstmovers.io)  ←→  Local Server (this package)  ←→  Sui CLI (your machine)

Quick Start

# Make sure Sui CLI is installed
sui --version

# Run the server (no installation needed!)
npx sui-cli-web

Then open https://cli.firstmovers.io - it connects automatically.

Features

| Feature | Description | |---------|-------------| | Address Management | Create, switch, view addresses with balances | | Transfer SUI | Send tokens with gas estimation | | Gas Management | Split and merge gas coins | | Network Switching | Mainnet, testnet, devnet, localnet | | Faucet Integration | Request test tokens | | Move Development | Build, test, publish, upgrade packages | | Transaction Inspector | Inspect and replay transactions | | Community Tiers | On-chain membership with progression |

Installation

Option 1: npx (Recommended)

npx sui-cli-web

Option 2: Global Install

npm install -g sui-cli-web
sui-cli-web

Option 3: Local Install

npm install sui-cli-web
npx sui-cli-web

Requirements

• Node.js 18+
• Sui CLI installed and configured (Install Guide)

# Install Sui CLI
brew install sui          # macOS
cargo install --locked sui  # All platforms

API Reference

The server exposes a REST API at http://localhost:3001/api

Core Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /health | Health check | | GET | /status | Sui CLI status | | GET | /addresses | List all addresses | | GET | /addresses/active | Get active address | | POST | /addresses/create | Create new address | | POST | /addresses/switch | Switch active address |

Transfer Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /transfers/sui | Transfer SUI tokens | | POST | /transfers/sui/dry-run | Estimate gas | | POST | /transfers/object | Transfer object/NFT | | GET | /transfers/sui/coins/:address | Get transferable coins |

Gas Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /gas/split | Split gas coin | | POST | /gas/merge | Merge gas coins |

Environment Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /environments | List environments | | POST | /environments/switch | Switch network | | POST | /environments | Add custom RPC |

Move Development

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /move/build | Build package | | POST | /move/test | Run tests | | POST | /packages/publish | Publish on-chain | | POST | /packages/upgrade | Upgrade package |

Community

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /community/membership | Check membership | | POST | /community/join | Join community | | GET | /community/tier/:address | Get tier info |

Full API Documentation →

Example Usage

Transfer SUI

curl -X POST http://localhost:3001/api/transfers/sui \
  -H "Content-Type: application/json" \
  -d '{
    "to": "0x1234...abcd",
    "amount": "1.5"
  }'

Get Addresses

curl http://localhost:3001/api/addresses

Switch Network

curl -X POST http://localhost:3001/api/environments/switch \
  -H "Content-Type: application/json" \
  -d '{"alias": "testnet"}'

Configuration

The server runs on port 3001 by default and binds to localhost only.

| Setting | Value | Notes | |---------|-------|-------| | Port | 3001 | Fixed | | Host | localhost | Security: no external access | | CORS | Configured | cli.firstmovers.io + localhost |

Security

• Private keys never leave your machine - All signing happens via local Sui CLI
• Localhost only - Server doesn't accept external connections
• Open source - Audit the code
• Rate limited - 100/min read, 30/min write, 5/min faucet

Troubleshooting

Server won't start

# Check if port 3001 is in use
lsof -ti:3001 | xargs kill -9

Sui CLI not found

# Verify Sui is installed
sui --version

# If not, install it
brew install sui  # macOS
cargo install --locked sui  # Other

CORS errors

Make sure you're accessing via:

• https://cli.firstmovers.io
• http://localhost:5173 (dev mode)

Development

# Clone the repo
git clone https://github.com/hien-p/raycast-sui-cli.git
cd raycast-sui-cli/packages/server

# Install dependencies
npm install

# Run in dev mode
npm run dev

# Build
npm run build

Tech Stack

• Fastify - Fast, low overhead web framework
• TypeScript - Type safety
• Sui CLI - Official Sui command line tool

Related

• Web Interface - Beautiful UI for this server
• Sui Documentation - Official Sui docs
• Move Language - Smart contract language

License

MIT © hien-p

cli.firstmovers.io · Made with ❤️ for the Sui community