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

# Quickstart: Swap tokens on a blockchain

> Use the App Kit SDK to swap one token for another on the same blockchain

This quickstart walks you through how to use the App Kit SDK's
[Swap](/app-kit/swap) capability to swap tokens on the same blockchain. The
example swaps USDC for EURC on Arc Testnet with the Circle Wallets adapter, but
you can use other
[supported tokens or blockchains](/app-kit/references/supported-blockchains).

## Prerequisites

Before you begin, ensure that you have:

* Installed [Node.js v22+](https://nodejs.org/).
* Obtained a
  [Circle API Key](https://developers.circle.com/w3s/circle-developer-account#creating-an-api-key-for-developer-services)
  and
  [Entity Secret](https://developers.circle.com/wallets/dev-controlled/register-entity-secret)
  from the
  [Circle Console](https://developers.circle.com/w3s/circle-developer-account).
* Obtained a free kit key from the [Circle Console](https://console.circle.com).
* Created a developer-controlled wallet on Arc Testnet using the Circle Console.
* Funded your Arc Testnet wallet with testnet USDC and native tokens for fees
  from the [Circle Faucet](https://faucet.circle.com/).

## Step 1. Set up the project

### 1.1. Create the project and install dependencies

Create a new directory and install the App Kit SDK with the Circle Wallets
adapter and supporting tools:

```bash theme={null}
# Set up your directory and initialize a Node.js project
mkdir app-kit-swap-circle-wallets
cd app-kit-swap-circle-wallets
npm init -y
npm pkg set type=module

# Set up module type and start command
npm pkg set scripts.start="tsx --env-file=.env index.ts"

# Install runtime dependencies
npm install @circle-fin/app-kit @circle-fin/adapter-circle-wallets tsx

# Install dev dependencies
npm install --save-dev typescript @types/node
```

<Tip>
  Only need to swap and want a lighter install than the full App Kit SDK? Install
  the standalone Swap Kit instead: `@circle-fin/swap-kit`.

  For server-side scripts, you can use any compatible EVM adapter, including the
  private key adapter. Keep private keys on the server and configure the adapter
  in the [wallet adapter setup guide](/app-kit/tutorials/adapter-setups).
</Tip>

### 1.2. Configure TypeScript (optional)

<Info>
  This step is optional. It helps prevent missing types in your IDE or editor.
</Info>

Create a `tsconfig.json` file:

```bash Shell theme={null}
npx tsc --init
```

Then, update the `tsconfig.json` file:

```bash Shell theme={null}
cat <<'EOF' > tsconfig.json
{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "types": ["node"]
  }
}
EOF
```

### 1.3. Set environment variables

Create an `.env` file in the project directory:

```bash Shell theme={null}
touch .env
```

Add your server-side credentials. Replace `YOUR_API_KEY` with your Circle
Developer API key, `YOUR_ENTITY_SECRET` with your entity secret, and
`YOUR_KIT_KEY` with your kit key from the Circle Console:

```text .env theme={null}
CIRCLE_API_KEY=YOUR_API_KEY
CIRCLE_ENTITY_SECRET=YOUR_ENTITY_SECRET
KIT_KEY=YOUR_KIT_KEY
```

<Tip>
  Edit `.env` files in your IDE or editor so credentials are not leaked to your
  shell history.
</Tip>

## Step 2. Swap tokens

### 2.1. Create the script

Create an `index.ts` file in the project directory and add the following code.
This code swaps 1.00 USDC for EURC from your Circle Wallets-controlled Arc
Testnet wallet. Replace `YOUR_SOURCE_WALLET_ADDRESS` with the wallet address
from the
[Circle Developer Console](https://developers.circle.com/w3s/circle-developer-account)
or the
[list wallets](https://developers.circle.com/api-reference/wallets/developer-controlled-wallets/get-wallets)
endpoint:

<Info>
  Using another
  [token pair](/app-kit/references/supported-blockchains#supported-tokens) or
  [blockchain](/app-kit/references/supported-blockchains)? Change the `tokenIn`,
  `tokenOut`, and `chain` values in `kit.swap()` and ensure the source wallet has
  enough input tokens and gas.
</Info>

```typescript TypeScript theme={null}
import { AppKit } from "@circle-fin/app-kit";
import { createCircleWalletsAdapter } from "@circle-fin/adapter-circle-wallets";
import type { SwapParams } from "@circle-fin/app-kit";

const kit = new AppKit();

const sourceWalletAddress = "YOUR_SOURCE_WALLET_ADDRESS";

const adapter = createCircleWalletsAdapter({
  apiKey: process.env.CIRCLE_API_KEY!,
  entitySecret: process.env.CIRCLE_ENTITY_SECRET!,
});

const swapParams: SwapParams = {
  from: {
    adapter,
    chain: "Arc_Testnet",
    address: sourceWalletAddress, // Omit the address if using Viem or Ethers adapters.
  },
  tokenIn: "USDC",
  tokenOut: "EURC",
  amountIn: "1.00",
  config: {
    kitKey: process.env.KIT_KEY!,
  },
};

const estimate = await kit.estimateSwap(swapParams);
const result = await kit.swap(swapParams);

console.dir({ estimate, result }, { depth: null, colors: true });
```

<Tip>
  Customize your swaps to
  [collect a custom fee](/app-kit/tutorials/swap/collect-swap-fee),
  [set a slippage tolerance or stop limit](/app-kit/tutorials/swap/set-slippage-tolerance-or-stop-limit),
  or [get a pre-swap estimate](/app-kit/tutorials/swap/estimate-swap-rate).
</Tip>

### 2.2. Run the script

Save the `index.ts` file and run the script in your terminal:

```bash Shell theme={null}
npm run start
```

### 2.3. Verify the transaction

After the script finishes, inspect the returned result in the terminal output.
Use the transaction explorer URL to verify the swap transaction and confirm the
output amount.

The following is an example of how the result of a successful swap might look in
the terminal output.

```text Terminal output theme={null}
{
  estimate: {
    tokenIn: 'USDC',
    tokenOut: 'EURC',
    amountIn: '1.00',
    chain: 'Arc_Testnet',
    fromAddress: '0xabcd...1234',
    toAddress: '0xabcd...1234',
    stopLimit: { amount: '0.959901', token: 'EURC' },
    estimatedOutput: { amount: '0.989589', token: 'EURC' },
    fees: [
      { token: 'USDC', amount: '0.0002', type: 'provider' },
      { token: 'USDC', amount: '0.021106828371967574', type: 'gas' }
    ]
  },
  result: {
    tokenIn: 'USDC',
    tokenOut: 'EURC',
    chain: 'Arc_Testnet',
    amountIn: '1.0',
    amountOut: '0.989589',
    fromAddress: '0xabcd...1234',
    toAddress: '0xabcd...1234',
    txHash: '0x43cb...c801',
    explorerUrl: 'https://testnet.arcscan.app/tx/0x43cb...c801',
    fees: [{ token: 'USDC', amount: '0.0002', type: 'provider' }]
  }
}
```