> 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*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://meshswap.gitbook.io/mesh/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.