# Quick Start

This section is the shortest path from an empty project to a working swap. The guides here help you pick the right runtime, initialize the SDK, connect wallets or signers, request a quote, and execute the route.

info

The Quick Start pages are meant for the default high-level SDK flow. If your integration later needs custom persistence, event handling, or manual transaction signing, continue with the [Advanced](https://docs.atomiq.exchange/sdk-guide/advanced.md) section after the basic flow is working.

## Usage

Most integrations use this section in the following order:

### Environment Setup

* Use [Quick Start - Browser](https://docs.atomiq.exchange/sdk-guide/quick-start/quick-start-browser.md) for browser-based web apps that connect user wallets directly through wallet adapters, injected wallets, or browser wallet connection flows.
* Use [Quick Start - Node.js](https://docs.atomiq.exchange/sdk-guide/quick-start/quick-start-nodejs.md) for Node.js backends that require explicit storage setup to run the SDK outside the browser and typically use keypair-based signers.

### Swap Flow

1. Start with [Creating Quotes](https://docs.atomiq.exchange/sdk-guide/quick-start/creating-quotes.md) once you have the swapper instance initialized and are ready to get your first swap quote.
2. Continue with [Executing Swaps](https://docs.atomiq.exchange/sdk-guide/quick-start/executing-swaps.md) once you are ready to move from inspecting the quote to the full swap flow and need to understand the expected signer or wallet inputs for each swap protocol.

### Swap Management

info

This is still a core responsibility of an app integrating the SDK. The common swap path may complete automatically, but real integrations still need to detect when a saved swap requires explicit user action and guide the user through refund or claim recovery flows.

1. Use [Historical Swaps](https://docs.atomiq.exchange/sdk-guide/swap-management/historical-swaps.md) to load previously created swaps from storage, either by ID or as a filtered list for a chain or signer.
2. Check whether any saved **Smart Chain → Bitcoin/Lightning** swaps have become refundable, then use [Refunds](https://docs.atomiq.exchange/sdk-guide/swap-management/refunds.md) to return those funds to the source wallet.
3. Check whether any saved **Bitcoin/Lightning → Smart Chain** swaps have become claimable, then use [Claiming](https://docs.atomiq.exchange/sdk-guide/swap-management/claiming.md) to settle those funds to the destination wallet.

## Network Availability

Not all chains are available on all Bitcoin testnets. Use the table below to pick the right `bitcoinNetwork` setting for your chain combination:

| Chain            | Mainnet      | Testnet4 | Testnet3 |
| ---------------- | ------------ | -------- | -------- |
| **Solana**       | Mainnet-beta | Devnet   | Devnet   |
| **Starknet**     | Mainnet      | Sepolia  | Sepolia  |
| **Citrea**       | Mainnet      | Testnet  | -        |
| **Alpen**        | -            | Testnet  | -        |
| **GOAT Network** | -            | Testnet  | -        |

The `bitcoinNetwork` setting determines both the Bitcoin network and which smart chain network is used by the chain initializers.

tip

* **Bitcoin Testnet3/Testnet4** - Use a [Bitcoin testnet faucet](https://bitcoinfaucet.uo1.net) or [Bitcoin testnet4 faucet](https://mempool.space/testnet4/faucet)
* **Solana Devnet** - Use Solana CLI's `solana airdrop 1` or the [Solana faucet](https://faucet.solana.com)
* **Starknet Sepolia** - Use the [Starknet faucet](https://starknet-faucet.vercel.app)
* **Alpen Testnet** - Use the [Alpen CLI](https://docs.alpenlabs.io/welcome/using-the-alpen-cli#user-content-request-btc)

## Topics

### Quick Start - Browser

Install the browser SDK packages, initialize the swapper, and connect supported browser wallets.

**[Quick Start - Browser →](https://docs.atomiq.exchange/sdk-guide/quick-start/quick-start-browser.md)**

***

### Quick Start - Node.js

Install the Node.js SDK packages, configure storage, initialize the swapper, and construct server-side signers.

**[Quick Start - Node.js →](https://docs.atomiq.exchange/sdk-guide/quick-start/quick-start-nodejs.md)**

***

### Creating Quotes

Request quotes from LPs and inspect the resulting swap object before moving on to execution.

**[Creating Quotes →](https://docs.atomiq.exchange/sdk-guide/quick-start/creating-quotes.md)**

***

### Executing Swaps

Execute the swap and understand which signer or wallet type is needed for each route direction.

**[Executing Swaps →](https://docs.atomiq.exchange/sdk-guide/quick-start/executing-swaps.md)**

***