> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yattacorp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Unified Liquidity

> Cross-chain liquidity across BTC, ZEC, and DOGE — coming in V2

<Warning>
  **Unified liquidity and cross-chain swaps are V2 features — not yet live.** V1 supports smart contracts, deposits, and withdrawals on each chain independently. Cross-chain swapping (BTC ↔ ZEC ↔ DOGE) is coming in V2.
</Warning>

## What is Unified Liquidity?

Today, BTC, ZEC, and DOGE each live in separate ecosystems. Swapping between them requires:

1. Sell your BTC on a centralized exchange
2. Receive ZEC
3. Withdraw to your wallet

This involves trusting a third party, paying high fees, and waiting.

NEXUS V2 eliminates this. All three assets are accessible from a single protocol. You express what you want and solvers (automated market participants) compete to give you the best rate — no exchange account needed.

***

## V1 (Current) — Independent Chain Operations

Each chain works fully today, just independently:

| Chain            | Deposits   | Withdrawals | Smart Contracts |
| ---------------- | ---------- | ----------- | --------------- |
| Bitcoin          | ✅          | ✅           | ✅               |
| Zcash            | ✅ (t-addr) | ✅ (t-addr)  | ✅               |
| Dogecoin         | ✅          | ✅           | ✅               |
| BTC ↔ ZEC swaps  | ❌ V2       | —           | —               |
| BTC ↔ DOGE swaps | ❌ V2       | —           | —               |
| ZEC ↔ DOGE swaps | ❌ V2       | —           | —               |

In V1, you can deposit BTC and use DeFi contracts on NEXUS, or deposit ZEC and use DeFi contracts on NEXUS — but moving BTC value to a ZEC address requires V2.

***

## V2 — Intent Exchange

V2 introduces **intent exchange**: declare what you want, solvers compete to fill it.

```
You declare:  "Swap 1 BTC for at least 50,000 DOGE"
                          ↓
Solver network sees your intent
                          ↓
Solvers compete to find the best route and rate
                          ↓
Best solver executes the swap across chains
                          ↓
You receive DOGE; solver keeps a small fee
```

### Why Intent Exchange?

| Problem           | How Intent Exchange Solves It                                          |
| ----------------- | ---------------------------------------------------------------------- |
| Front-running     | Intents are committed before execution — no one can trade ahead of you |
| Slippage          | Price is locked when you create the intent                             |
| Counterparty risk | All-or-nothing: you either get the minimum promised or nothing         |
| Complexity        | You just say what you want — solvers handle routing                    |

***

## V2 AMM Pools

Alongside intent exchange, V2 introduces on-chain liquidity pools that anyone can provide liquidity to:

```
BTC/ZEC Pool
BTC/DOGE Pool
ZEC/DOGE Pool
Any Token/vSAT Pool (NEP-20 tokens)
```

**Benefits of providing liquidity:**

* Earn a share of swap fees (0.3% per swap)
* Deep liquidity = better prices for everyone
* Withdraw any time

### Concentrated Liquidity (V3-style)

NEXUS AMM V3 lets liquidity providers choose a **price range** to concentrate their liquidity in. Liquidity in range earns more fees than spread across all prices — more capital-efficient.

***

## V2 Swap Preview (Code, Not Yet Live)

```typescript theme={null}
// This is what V2 swap will look like — not available yet
const intent = await client.createSwapIntent({
  fromChain: 'bitcoin',
  toChain: 'dogecoin',
  fromAmount: '100000000',      // 1 BTC in satoshis
  minToAmount: '50000000000',   // Minimum 500 DOGE (won't execute below this)
  recipient: 'DQkw...',         // Your Dogecoin address
  deadline: Math.floor(Date.now() / 1000) + 3600  // Expires in 1 hour
});

// Wait for a solver to fill your intent
const result = await client.waitForIntentFulfillment(intent.id);
console.log('Received DOGE:', result.amountOut);
```

***

## Supported Trading Pairs (V2)

| Pair       | Description                   |
| ---------- | ----------------------------- |
| BTC/ZEC    | Bitcoin ↔ Zcash               |
| BTC/DOGE   | Bitcoin ↔ Dogecoin            |
| ZEC/DOGE   | Zcash ↔ Dogecoin              |
| Any/NEP-20 | Any base asset ↔ NEXUS tokens |

<Info>
  Want to follow V2 development? Join the [Discord](https://discord.gg/nexus) for updates.
</Info>