> For the complete documentation index, see [llms.txt](https://meshswap.gitbook.io/mesh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meshswap.gitbook.io/mesh/readme.md).

# Mesh

**Cross-chain atomic swaps between Ethereum and Sui with zero gas fees.**

## What is Mesh?

Mesh lets you swap ETH for SUI (and vice versa) directly between blockchains. No centralized exchanges, no gas fees for users, completely secure.

**Key Benefits:**

* 🆓 **Zero gas fees** - You only pay tiny transaction costs
* ⚡ **Fast swaps** - Complete in 2-3 minutes
* 🔒 **100% secure** - Either you get your tokens or money back
* 🌉 **Direct cross-chain** - No bridges or wrapped tokens

## Quick Start

1. **Get the code**

```bash
git clone https://github.com/ashwanth511/mesh
cd mesh
```

2. **Start the app**

```bash
cd Frontend && npm install && npm run dev
```

3. **Make your first swap**

* Open <http://localhost:3000>
* Connect MetaMask + Sui Wallet
* Enter swap details and confirm

## How It Works

```
You create swap → Resolver fills it → Both unlock simultaneously → Done!
```

1. **You create a swap** - Lock your ETH/SUI with your requirements
2. **Resolver finds it** - Automated service provides what you want
3. **Smart contracts coordinate** - Both sides unlock at the same time
4. **Everyone gets tokens** - You get SUI/ETH, resolver gets profit

## Architecture

**4 Main Parts:**

* **Ethereum Contracts** - Handle ETH side (Solidity + 1inch Fusion+)
* **Sui Contracts** - Handle SUI side (Move language)
* **Relayer Service** - Coordinates between chains (TypeScript)
* **Frontend App** - Where you make swaps (React)

## Documentation

* [Installation](/mesh/installation.md) - Set up Mesh locally
* [User Guide](/mesh/user-guide.md) - How to swap tokens
* [Contracts](/mesh/contracts.md) - Smart contract details
* [Relayer](/mesh/relayer.md) - Run the coordination service
* [Developer Guide](/mesh/developer.md) - Build with Mesh
* [FAQ](/mesh/faq.md) - Common questions

***

*Open source project - MIT License*