# 1Sol Doc | Home


# What is 1Sol

1Sol Protocol is a cross-chain DEX aggregator for decentralized protocols on Solana, enabling the most seamless, efficient and protected operations in DeFi. With DeFi infrastructure rapidly growing, aggregators in high demand, cross-chain transactions being the future, 1Sol is born to bring together liquidity from both DeFi and CeFi (swaps, orderbook DEX(s), OTC, etc.) for multi-chains.


# How to use 1Sol


# 1Sol DEX Aggregator

**Step 1: Link 1Sol to the wallet**

Open <https://app.1sol.io> directly or open the link: <https://1sol.io/>, and select “**launch APP**” in the upper right corner of the homepage.

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FNLUdch1irjrrd8yTCNs4%2F%E5%9B%BE%E7%89%87%201.png?alt=media\&token=6e582b4b-6cf8-402a-a7ff-b0e91c641a16)

Then click “**connect wallet** “in the upper right corner, 1Sol supports linking 8 wallets now , **Solong plugin wallet**: <https://solongwallet.com/>

**MathWallet:** <https://mathwallet.org/en-us/>

**Phantom wallet:** <https://phantom.app/>

**Sollet web wallet:** <https://www.sollet.io/>

**Solfare wallet:** <https://solflare.com/>

**Safepal wallet:** <https://www.safepal.io/>

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FtcHhp546SsSFLOTcbxkh%2F%E5%9B%BE%E7%89%87%202.png?alt=media\&token=4abc78fd-4a52-4d2d-8cc4-3676d2b9530c)

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FhTZunD9vxclPTnIWQZCm%2F%E5%9B%BE%E7%89%87%203.png?alt=media\&token=d64a1645-fda5-48e8-a3cf-2d45e389e9c1)

&#x20;

**Step 2: Create and use wallet**

If you don’t have a wallet, you can click on the wallet option and create a wallet belongs to you. Just follow the wallet operation instructions to create it; if you already have a wallet, for example, we take the commonly used phantom wallet as an example, select phantom wallet and click on phantom wallet and enter the password on the wallet page.

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FYEU65PciHDOr6L1m1Nhd%2F%E5%9B%BE%E7%89%87%204.png?alt=media\&token=9741e6c7-0c40-4524-a5f1-98190b9c9003)

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FJFB2ntdqTFnMe3Zi33ru%2F%E5%9B%BE%E7%89%87%205png.png?alt=media\&token=9e65950d-be32-488e-97ae-dc417ba483f1)

**Step 3: Use the Swap function**

Every transaction requires SOL as gas, so please confirm there is enough SOL in your wallet to pay for gas before using swap, otherwise the transaction will fail.

After click the wallet link, you will enter the “**Trade** “page, then click the gear icon in the upper right corner, and the setting slippage interface will appear. The first three are fixed values, 0.1%, 0.5%, 1%, and the last space can be customized Click and enter the value according to your needs.

&#x20;

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FEexVCYLwfyVUwE123XgL%2F%E5%9B%BE%E7%89%87%207.png?alt=media\&token=edef7dd1-e28f-424d-95a7-bd4ff4728a8d)

We will use SOL to buy GYZ as an example to show the process of Swap, fill in the amount of SOL, the amount of GYZ that can be obtained automatically appears, and then click Swap to confirm the exchange.

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2F8XJPlCjuuYAowsGCoejs%2F%E5%9B%BE%E7%89%87%208.png?alt=media\&token=d44fef70-389d-4454-a945-fd6af2da7932)

The wallet authorization page pops up, click Approve to confirm the exchange, and the transaction can be completed.

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FYIcE2llmvmjMu3VZErgh%2F%E5%9B%BE%E7%89%87%209.png?alt=media\&token=449bfff7-45ce-4186-a629-1b9728db53f2)

&#x20;

PS: If there are frequent transaction failure prompts in the transaction, you can check the following aspects:

**1. Is the slippage set too low?**

**Solution: increase the setting parameters of slippage**

**2. There may be no tokens in your wallet.**

**Solution: Go back to your wallet and add tokens. For example, the GYZ transaction is a prompt error, and you need to check whether GYZ tokens are added to the wallet.**

**3.Gas fee is insufficient and there is no SOL in your wallet**

**Solution:transfer enough SOL to your wallet**

**4. SOL related transactions failed.**

**Solution: Don't use all the SOL in your wallet,and make sure you have enough SOL as the gas fee.**

&#x20;

**That’s all for the user guide. If you have any questions about 1Sol, please feel free to reach out to us via social media here:**

**Official Website**: <https://1sol.io/>

**Twitter:**<https://twitter.com/1solprotocol>

**Discord:** <https://discord.com/invite/6gHmS8Tsv4>

**Github page:** <https://github.com/1sol-io>

**Official Telegram :** <https://t.me/onesolcommunity>


# Intro


# Ethereum 1Sol Token

### Contract Address

{% embed url="<https://etherscan.io/address/0x009178997aff09a67d4caccfeb897fb79d036214>" %}

### Code

{% embed url="<https://etherscan.io/address/0x009178997aff09a67d4caccfeb897fb79d036214#code>" %}

### Audit

{% embed url="<https://file.1sol.io/static/[1Sol.io_25112021]SCAudit_Report.pdf>" %}


# Solana 1Sol Token

### Contract Address

{% embed url="<https://solscan.io/token/4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF>" %}

### Code

{% embed url="<https://github.com/1sol-io/1sol-protocol>" %}

### Audit

{% embed url="<https://file.1sol.io/static/1Sol-Audit-Report-111121.pdf>" %}


# Cross-chain Bridge

1Sol use Wormhole as the cross-chain bridge between Ethereum and Solana.

### How to use Wormhole

{% embed url="<https://docs.wormholenetwork.com/wormhole/tutorial-how-to-transfer-tokens>" %}

### Cross-bridge link

{% embed url="<https://wormholebridge.com/#/transfer>" %}

### Examples

#### Transfer 1SOL From Ethereum to Solana

#### Transfer 1Sol From Solana to Ethereum


# Token Metrics

## DETAILED TOKEN METRICS <a href="#detailed_token_metrics" id="detailed_token_metrics"></a>

### Seed Sale

<table data-header-hidden><thead><tr><th width="150">Seed Sale</th><th></th></tr></thead><tbody><tr><td>Fundraised:</td><td>$750,000</td></tr><tr><td>Price:</td><td>$0.15</td></tr><tr><td>Lock-up:</td><td>8.33% unlocked one week after TGE, then 8.33% on a monthly basis</td></tr></tbody></table>

### Private Round 1

<table data-header-hidden><thead><tr><th width="150">Private Round 1</th><th></th></tr></thead><tbody><tr><td>Fundraised:</td><td>$750,000</td></tr><tr><td>Price:</td><td>$0.35</td></tr><tr><td>Lock-up:</td><td>8.33% unlocked one week after TGE, then 8.33% on a monthly basis</td></tr></tbody></table>

### Private Round 2

<table data-header-hidden><thead><tr><th width="150">Private Round 2</th><th></th></tr></thead><tbody><tr><td>Fundraised:</td><td>$700,000</td></tr><tr><td>Price:</td><td>$0.38</td></tr><tr><td>Lock-up:</td><td>8.33% unlocked one week after TGE, then 8.33% on a monthly basis</td></tr></tbody></table>

### Public Sale

<table data-header-hidden><thead><tr><th width="181.83828682890328">Public Sale</th><th></th></tr></thead><tbody><tr><td>Fundraised:</td><td>$380,000</td></tr><tr><td>Platform Raise:</td><td>$147,000 + $5,000 Community Round </td></tr><tr><td>Price:</td><td>$0.38</td></tr><tr><td>Lock-up:</td><td>25% on TGE, then 25% on a quarterly basis</td></tr></tbody></table>

## TOKEN DISTRIBUTION <a href="#token_distribution" id="token_distribution"></a>

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FM4AfR4VVwO9RjqdZ2nJL%2Fimage.png?alt=media\&token=832c7402-ec41-48fd-8658-4f8217fa37c1)

## TOKEN RELEASE SCHEDULE <a href="#token_release_schedule" id="token_release_schedule"></a>

![](https://2313691186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkpHjiFRKqltcj3g4C4%2Fuploads%2FyOcCrU1JjZx0uGc5GDOX%2Fimage.png?alt=media\&token=80d68dae-8ad6-4f19-ad55-f51d3de269d4)


# Trade 1SOL

Where to buy 1SOL token?

## Centralized Exchanges

* Huobi

### DEX(s)

* app.1sol.io
* Orca
* Dexlab


# SDKs


# TypeScript

You can make your own swap UI/service based on our SDK:

{% embed url="<https://github.com/1sol-io/1sol-sdk-ts>" %}


# Rust

{% embed url="<https://github.com/1sol-io/1sol-protocol>" %}


# API

### Api V2 document

Endpoint: `https://api.1sol.io`

## `GET` /2/101/token-list

\*\*

#### Request:

* Headers: No specific headers needed.
* Url Params: No specific query parameters needed.
* Body: No specific body attributes needed.

***

#### Response:

* Status: **200**
* Body:

```json
{
  "name": "1Sol Token List",
  "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF/logo.png",
  "tokens": [
    {
      "chainId": 101,
      "address": "4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF",
      "symbol": "1SOL",
      "name": "1sol.io Token",
      "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF/logo.png",
      "decimals": 8,
      "feeAccount": "2h2Z8YkECHyDKamQt6B7hTqX6m8ANV3pwSa2CjYsss5x",
      "tags": [],
      "extensions": {
          "coingeckoId": "1sol",
          "coingeckoName": "1Sol"
      }
    }
  ]
}
```

## `POST` /2/101/routes

\*\*

#### Request:

* Headers: No specific headers needed.
* Url Params: No specific query parameters needed.
* Body:

```json
{
    "amountIn": 100000,
    "sourceTokenMintKey": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "destinationTokenMintKey": "4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF",
    "programs": [
        "SwaPpA9LAaLfeLi3a68M4DjnLqgtticKg6CnyNwgAC8",
        "SSwpkEEcbUqx4vtoEByFjSkhKdCT862DNVb52nZg1UZ",
        "9W959DqEETiGZocYWCQPaJ6sBmUzgfxXfqGeTEdp3aQP",
        "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
        "DESVgJVGajEgKGXhb6XmqDHGz3VjdgP7rEVESBgxmroY",
        "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "1MooN32fuBBgApc8ujknKJw5sef3BVwPGgz3pto1BAh"
    ],
    "size": 4,
    "onlyDirect": false,
    "experiment": false,
    "bridgeMints": []
}
```

***

#### Description:

* If the length of response.distributions.routes is `1`, it's a direct exchange.
* If the length of response.distributions.routes is `2`, it's exchanged with a bridge token.

#### Response:

* Type: **Direct**
* Body:

```json
{
    "amountIn": 100000,
    "chainId": 101,
    "sourceTokenMint": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "decimals": 6
    },
    "destinationTokenMint": {
        "address": "4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF",
        "decimals": 8
    },
    "distributions": [
      {
        "routeType": "Direct",
        "sourceTokenMint": {
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6
        },
        "destinationTokenMint": {
          "address": "4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF",
          "decimals": 8
        },
        "amountIn": 100000,
        "amountOut": 15122510,
        "routes": [
          [
            {
              "exchangerFlag": "OneMoon",
              "pubkey": "6XXjau4dgEw6mJ9xjy6QWkzTiQYDn3FgWRfYXpANku4G",
              "extPubkeys": [],
              "programId": "1MooN32fuBBgApc8ujknKJw5sef3BVwPGgz3pto1BAh",
              "sourceTokenMint": {
                "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "decimals": 6
              },
              "destinationTokenMint": {
                "address": "4ThReWAbAVZjNVgs5Ui9Pk3cZ5TYaD9u6Y89fp6EFzoF",
                "decimals": 8
              },
              "amountIn": 100000,
              "amountOut": 15122510
            }
          ]
        ]
      }
    ]
}
```

***

#### Response:

* Type: **WithBridgeMint**
* Body:

```json
{
  "amount_in": 1000000000,
  "chain_id": 101,
  "source_token_mint": {
    "pubkey": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "decimals": 6
  },
  "destination_token_mint": {
    "pubkey": "So11111111111111111111111111111111111111112",
    "decimals": 9
  },
  "distributions": [
    {
      "source_token_mint": {
        "pubkey": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "decimals": 6
      },
      "destination_token_mint": {
        "pubkey": "So11111111111111111111111111111111111111112",
        "decimals": 9
      },
      "amount_in": 1000000000,
      "amount_out": 8676914691,
      "routes": [
        [
          {
            "exchanger_flag": "SerumDex",
            "pubkey": "6oGsL2puUgySccKzn9XA9afqF217LfxP5ocq4B3LWsjy",
            "program_id": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
            "ext_pubkeys": [],
            "source_token_mint": {
              "pubkey": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "decimals": 6
            },
            "destination_token_mint": {
              "pubkey": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
              "decimals": 9
            },
            "amount_in": 999948424,
            "amount_out": 8438000000
          }
        ],
        [
          {
            "exchanger_flag": "SaberStableSwap",
            "pubkey": "Lee1XZJfJ9Hm2K1qTyeCz1LXNc1YBZaKZszvNY4KCDw",
            "program_id": "SSwpkEEcbUqx4vtoEByFjSkhKdCT862DNVb52nZg1UZ",
            "ext_pubkeys": [],
            "source_token_mint": {
              "pubkey": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
              "decimals": 9
            },
            "destination_token_mint": {
              "pubkey": "So11111111111111111111111111111111111111112",
              "decimals": 9
            },
            "amount_in": 8438000000,
            "amount_out": 8676914691
          }
        ]
      ],
    }
  ]
}
```

***

## `POST` /2/101/transactions

\*\*

#### Request:

* Headers: No specific headers needed.
* Url Params: No specific query parameters needed.
* Body:

```json
{
    "route": {
        "sourceTokenMint": {
            "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        },
        "destinationTokenMint": {
            "address": "So11111111111111111111111111111111111111112"
        },
        "amountIn": 1000000000,
        "amountOut": 8674918662,
        "routes": [
            [
                {
                    "pubkey": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
                    "programId": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
                    "extPubkeys": [
                        "9wFFyRfZBsuAha4YcuxcXLKwMxJR43S7fPfQLusDBzvT"
                    ],
                    "sourceTokenMint": {
                        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
                    },
                    "destinationTokenMint": {
                        "address": "So11111111111111111111111111111111111111112"
                    },
                    "amountIn": 1000000000,
                    "amountOut": 8674918662
                }
            ]
        ]
    },
    "minimumAmountOut": 8674910000,
    "wallet": "DTc6DFAH2Jf349NcPLxYCspQcCM44EwByTFrFrQVFeLs",
    "protocolSwapInfo": null,
    "sourceTokenAccount": null,
    "destinationTokenAccount": null,
    "bridgeTokenAccount": null,
    "openOrders": {}
}
```

***

#### Response:

* Status: **200**
* Body:

```json
{
    "transactions": [
        "base64_string_1",
        "base64_string_2",
        "base64_string_3",
    ],
}
```

***


