# What is XSwap?

In a rapidly evolving decentralized finance (DeFi) landscape, seamless interoperability between diverse blockchain networks has emerged as a critical need. XSwap takes center stage, promising fluid cross-chain liquidity movements.

**Key Highlights:**

* **First Mover Advantage:** XSwap is proud to be one of the first platforms leveraging Chainlink's Cross-Chain Interoperability Protocol (CCIP). This pioneering step sets XSwap apart from other DeFi platforms and is positioned to become a leader in the field of cross-chain swaps.
* **Chainlink's Technological Backbone:** Chainlink, renowned for its decentralized oracle network, introduces the Cross-Chain Interoperability Protocol (CCIP) as a breakthrough in blockchain interoperability. CCIP is designed to optimize and simplify moving assets across diverse blockchains.
* **Enhanced User Experience:** No longer do we have to deal with intricate, time-consuming, and hazardous cross-chain swaps. With XSwap powered by CCIP, users can expect a streamlined and user-friendly experience, cutting down on multiple transaction steps and reducing wait times.
* **Ease of Integration:** XSwap introduces a spectrum of tools allowing third-party projects to integrate cross-chain liquidity movements with minimal effort. This innovative approach makes it possible to transform single-chain applications to handle cross-chain messages with ease.
* **Broadened Accessibility:** As DeFi continues its upward trajectory, many users are spread across various networks, maintaining assets across multiple chains. XSwap's integration with CCIP ensures that these users can effortlessly access and move their assets, expanding the scope of decentralized finance.
* **Security and Trust:** Leveraging Chainlink's reputation for secure and reliable protocols, XSwap ensures that users' assets are always safe during swaps. The combination of XSwap's inherent security features and Chainlink's robust CCIP protocol minimizes the risks often associated with cross-chain transfers.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FwOkLzGtMONvFdk1rUuMX%2Fxswap%2030.png?alt=media&amp;token=a3e8fc04-abc9-4711-9f0b-09aa5c728f10" alt=""><figcaption></figcaption></figure>

**In Conclusion:**

XSwap's integration with Chainlink's Cross-Chain Interoperability Protocol introduces a new age in DeFi, where boundaries between blockchains become more permeable, and users enjoy unparalleled ease in liquidity transfers. As the first project to embark on this journey with Chainlink, XSwap does not simply follow trends, it sets them.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FDlOLD3IyEuQrG811kU9j%2Fxswap%2014.png?alt=media&amp;token=01ac9d91-87a8-48c8-9096-0968fc650f70" alt=""><figcaption></figcaption></figure>


# Target Audience

Different user segments have distinct needs and challenges. XSwap has identified and tailored its offerings to these specific audiences:

***

**1. Individual Clients:**

These are the everyday users, cryptocurrency enthusiasts, traders, and investors. They range from novices just dipping their toes into the world of crypto to seasoned traders looking for efficient tools to maximize their trading potential. For them, ease of use, speed, and security are paramount.

What XSwap Offers for Individual Clients:

* Custom User Interface (UI): A thoughtfully designed, intuitive UI ensures that even those new to the crypto world can navigate with ease. Each aspect, from the layout to on-screen instructions, simplifies the process of cross-chain transactions.
* Versatile Chain Support: With the rising number of blockchains and assets, XSwap's expansive support ensures that individual clients have the flexibility to move their funds across a diverse range of chains.

***

**2. Protocols:**

Protocols form the foundational layers upon which many decentralized applications and platforms are built. These are typically more complex entities, needing solutions that can be integrated into their existing systems to add new functionalities or enhance current ones. Their concerns revolve around seamless integration, scalability, and transaction fluidity.

What XSwap Offers for Protocols:

* SDK (Software Development Kit): Tailored for protocols, XSwap's SDK facilitates the seamless incorporation of cross-chain liquidity movements, allowing these entities to broaden their offerings without undergoing extensive overhauls.
* Cross-Chain Smart Contracts Execution: Protocols can utilize XSwap’s smart contracts to handle the intricacies of cross-chain exchanges. These contracts facilitate swaps and transfers by using established DEXs and CCIP messages. The partner's protocol smart contract execution can happen before and after the token swap. Example: Buying an NFT on the destination chain using the swapped tokens, all of that with one transaction.


# Problems and Solutions

XSwap's Solutions to Main Cross-Chain Swap Challenges

In our quest to offer an unparalleled cross-chain swap experience, we've identified main industry challenges and designed precise solutions for them.

**1. Problem: Poor User Experience**

* Complex Cross-Chain Transactions: Users often encounter multiple steps and additional transactions resulting in a poor user experience.

<mark style="color:green;">**XSwap's Solution:**</mark>

* **Simplified Process:** We've streamlined the swap process to reduce the required steps, making it user-friendly for both novices and experts.
* **Unified Interface:** Our platform showcases an intuitive interface, drastically cutting down the need for subsequent transactions once the assets are on the destination chain.

**2. Problem: Integration Difficulties**

* Reinventing The Wheel: Current methods of integrating cross-chain payments into existing protocols are intricate, often forcing developers to start from scratch.

<mark style="color:green;">**XSwap's Solution:**</mark>

* **Flexible APIs and SDK:** Our APIs, crafted for effortless integration, empower developers to connect with our platform without having to modify their current systems extensively.
* **Compatibility Modules:** XSwap provides modules that ensure harmonization with a vast array of existing protocols. This not only saves invaluable time but also minimizes potential integration mishaps.

**3. Problem: Security Vulnerabilities**

* Bridge Weaknesses: A significant number of bridges, especially centralized ones, are vulnerable to theft because of inadequate security measures.

<mark style="color:green;">**XSwap's Solution:**</mark>

* **Chainlink's CCIP Integration:** At the heart of our solution is the integration of the Cross-Chain Interoperability Protocol (CCIP) developed by Chainlink. This protocol is not just cutting-edge but has undergone rigorous audits. Adopting CCIP assures our users of a robust and secure infrastructure, given Chainlink's impeccable track record in blockchain security.
* **Decentralized Architecture:** Leveraging decentralization, our platform reduces single points of failure and is strategically structured to deter centralized threats.

At XSwap, challenges are not deterrents but catalysts, propelling us to innovate and ensure our users benefit from the most efficient, secure, and user-centric cross-chain swapping experience available.

<br>


# Revenue Streams of XSwap

XSwap's revenue model is rooted in its functionality as a cross-chain swapping platform, strategically designed to monetize its services while providing value to its users and partners. Here's a more detailed look at its core revenue streams:

***

**1. Transaction Fees on Swaps:**

Each time a user conducts a swap operation on the XSwap platform, a transaction fee is applied. This fee isn't just a revenue stream, but it's also integral to the platform's sustainability and growth:

* Operational Coverage: These fees contribute significantly to covering the platform's operational overheads.&#x20;
* Innovation and Upgrades: A segment of the transaction fees is allocated to research and development. This commitment ensures that XSwap stays ahead of the curve, introducing innovative features, refining user experience, and ensuring compatibility with new blockchains and tokens.
* Stability and Scalability: As the crypto landscape experiences flux and growth, these fees provide the financial backing for XSwap to scale its services.

***

**2. Partner-Driven Revenue Growth:**

The strategic integration of XSwap's technology into various partner platforms offers a promising expansion to its revenue channels:

* Extended Reach: Each partner integration brings along its user base, expanding the potential number of transactions taking place on XSwap. This directly correlates to increased transaction fees and, subsequently, heightened revenue.
* Collaborative Fee Models: Based on the specifics of partnerships, XSwap might introduce collaborative fee structures. For instance, partners delivering high-volume transactions could benefit from a mutually agreed discounted rate, ensuring both parties see increased profitability.
* Affiliate or Referral Earnings: Depending on partnership terms, XSwap could also benefit from affiliate or referral structures, where a small commission is earned for every new user directed to XSwap through partner platforms.

***

In essence, XSwap's revenue streams are meticulously structured to ensure both immediate income and potential for future growth. This balance allows the platform to remain financially healthy while continuously evolving its offerings in the dynamic crypto market.

<br>


# Market Potential of XSwap

In the world of blockchain, a project's potential can be gauged by examining the performance metrics of its contemporaries or competitors. The transaction data from Squid on Axelar Protocol and Stargate on Layer0 Protocol provides insights into the potential market reach XSwap could achieve.

***

**1. Transaction Volume Overview (2023):**

* **Squid (Axelar Protocol):** \~100,000 transactions/month
* **Stargate (Layer0 Protocol):** \~3,000,000 transactions/month

***

**2. Analysis and Implications for XSwap:**

**Squid's Modest Performance:** With 110,019 monthly transactions, Squid has secured a niche but notable presence in its domain. Such a number suggests there's an audience actively seeking and using cross-chain swapping solutions.

**Stargate's Outstanding Volume:** Stargate's wide adoption and efficacy is evident in its impressive volume of over 4 million monthly transactions. Such a significant number indicates a well-established trust within its user base and potentially a wider array of use cases or functionalities.&#x20;

***

**3. Determining XSwap's Potential:**

* **Baseline Engagement:** If XSwap manages to introduce functionalities and user experience on par with or superior to Squid, it could reasonably aim to achieve a similar or better monthly transaction volume.
* **Scaling Possibilities:** Stargate's numbers show that there's an immense audience seeking cross-chain solutions. XSwap, with the right strategies, partnerships, and technological innovations, can aim to tap into this massive pool of users.
* **Growth Trajectory:** Given the transaction volumes of both projects, it's reasonable to position XSwap's potential growth trajectory somewhere between Squid's modest engagement and Stargate's outstanding performance. With effective market positioning, XSwap can target capturing a significant portion of the market shared by these two entities.

***

**Conclusion:**

If XSwap can strike the right balance between usability, security, and innovative features, there's substantial room for growth. The figures from Squid and Stargate serve not only as benchmarks but also as indicators of the immense potential waiting to be harnessed in the cross-chain swapping arena. With the right strategies, XSwap stands a chance to secure its place as a formidable player in this domain.


# Roadmap

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2F0tNzYeJ8JbJw0wPIpTnm%2FLinkSwap.io.png?alt=media&amp;token=b695f8b7-0480-417d-beff-d105da930383" alt=""><figcaption></figcaption></figure>

**Phase 1 Q1 2024**

* Smart contracts for connecting DEX'es cross-chain with CCIP
* Bridge and Swap platform for users
* Support for executing contracts on the destination chain
* Custom swap route support with main route splits
* Integrate multicalls for smart contracts on the destination chain

**Phase 2 Q2 2024**

* SDK release
* Instant cross-chain swaps
* XSwap widget implementation

**Phase 3 Q3/Q4**

* Non-EVM ecosystem integration
* XSwap Payment Tool integration in numerous web3 projects


# $XSWAP

### XSwap Tokenomics

XSwap is the first Cross-Chain Swaps Protocol powered by Chainlink CCIP.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FSgNZ8ayaJLcF7mzhvfD3%2FTokenomics.png?alt=media&amp;token=1d644865-239e-49aa-acca-edf4a6cc417f" alt=""><figcaption><p>$XSWAP Tokenomics</p></figcaption></figure>

### Token Info

* Ticker: $XSWAP
* Total Supply: 350,000,000
* Token Address: 0x8fe815417913a93ea99049fc0718ee1647a2a07c

### Token Allocations

5%- Private (TGE: 15%, Cliff: 1 month, Vesting: 16 months)\
\
8%- Public:\
\- IDO (TGE: 50%, Vesting: 1 month)\
\- LBP Launch (TGE: 100%)\
\
20%- Ecosystem ( TGE: 0%, Vesting: 24 months)\
\
23%- Operational (TGE: 0%, Vesting: 18 months)\
\
12,5%- Marketing (TGE: 5%, Vesting: 18 months)\
\
9,5%- Advisors (TGE: 0%, Cliff: 6 months, Vesting: 18 months)\
\
5%- Liquidity (TGE: 100%)\
\
2%- Airdrop (TGE: 50%, Vesting: 1 month)\
\
15%- Team (TGE: 0%, Cliff: 6 months, Vesting: 18 months)

### Token Utility

STAKING

Staking in XSwap involves active users of the platform holding their XSwap tokens to earn rewards in the form of additional XSwap tokens.

BUY & BURN

XSwap intends to purchase its own tokens on the secondary market and then burns them, reducing the overall token supply. This strategy aims to control inflation and increase the value of tokens held by investors. <br>

$XSWAP Chart: \
<https://coinmarketcap.com/currencies/xswap/>\
<https://www.dextools.io/app/en/base/pair-explorer/0x7101fa70e5d071004ad5a7000dc46ff8a8c24199>

<br>


# Staking

$XSWAP Staking

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FdqzNt1cEN4eE1TXNNfQG%2Fstaking%20(5).png?alt=media&amp;token=166fb1c8-540f-4107-9638-0235dc8fb120" alt=""><figcaption></figcaption></figure>

\
Introducing **$XSWAP staking** – your opportunity to secure maximized returns and a powerful edge on the cross-chain market. This program is designed for those wanting to not just participate, but drive the growth of our XSwap ecosystem.

**Blockchain: BASE**

**Place:** [**https://xswap.link/staking**](https://xswap.link/staking)

***

$XSWAP Staking comes with multiple utilities and perks:

**•Cashback Rewards:** Stakers receive a portion of the transaction volume as cashback, boosting participation and engagement within the XSwap ecosystem.\
\
**•Reduced Transaction Fees:** Exclusive access to lower transaction fees makes staking attractive for frequent traders, helping optimize costs.\
\
**•Airdrops from Ecosystem Projects**: By staking $XSWAP, users may become eligible for potential airdrops of tokens from affiliated projects.\
\
**•Buyback and Burn:** A part of the platform’s revenue and tax fees are used to buy back and burn $XSWAP tokens, reducing supply and potentially driving up the token's value, indirectly benefiting stakers. <br>

***

## Staking Pools

How does it work?

Depending on your preferences and strategy, you can choose to stake your tokens in one of **3 available staking pools.**

## •Intergalactic Command

-Multiplier to XPower: 7X\
-Unbonding Time: 90 days\
-Compounding APY: 10%&#x20;

## •Solar Division

-Multiplier to XPower: 3X\
-Unbonding Time: 50 days\
-CompoundingAPY: 6%&#x20;

## •Cosmic Cadets

-Multiplier to XPower: 1X\
-Unbonding Time: 15 days\
-Compounding APY: 3%<br>

Stakers can withdraw their tokens before the unbonding period ends by paying an early withdrawal fee.

***

## What is XPower?

XPower is a point system that gives you the ability to go up in staking Tiers and gain additional bonuses. The more XPower you have, the more you benefit.\
\
How is your XPower counted?

**XPower = Number of Tokens x Multiplier**\
\
*Example: You want to stake 1000 $XSWAP tokens in the “Intergalactic Command” pool with a 7X multiplier. Your XPower will be equal to 7000 (1000 x 7 = 7000).*

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FEr2FJDu9uFAq2PMGMuM9%2Fxswap%20161.png?alt=media&amp;token=d46e9475-4991-422d-9982-78d1682bc341" alt=""><figcaption></figcaption></figure>

There are 4 $XSWAP staking tiers:\
\
Each tier is designed to maximize your returns and enhance your participation in our community. Choose the tier that best suits your investment strategy and reap a host of benefits:

## Tier 4 - Recruit (>0 XPower)

* Earn bonus XSwap tokens proportional to the amount you stake.

## Tier 3 - Sergeant (>15000 XPower)

* Earn bonus XSwap tokens proportional to your staked amount.
* Benefit from a **15%** reduction in slippage fees, lowering your transaction costs&#x20;

## Tier 2 - Officer (>75000 XPower tokens)

* Gain bonus XSwap tokens proportional to the stake amount.
* Get a significant **20%** reduction in slippage fees, reducing your costs
* Cashback: receive 0.05% of your transaction volume back in USDC.
* Zero native fees
* Chances to receive airdrops, providing substantial value and engagement

## Tier 1 - Admiral (>150000 XPower & only top 100)

* Gain bonus XSwap tokens proportional to the stake amount.
* Get a significant **25%** reduction in slippage fees, reducing your costs
* Cashback: receive **0.1%** of your transaction volume back in USDC
* Zero native fees&#x20;
* Guaranteed participation in **airdrops** of our various ecosystem projects, offering you exclusive access to new opportunities.

Each tier is tailored to adapt to varying levels of investment, making sure that every member of our community can find a fit that suits their crypto strategy.&#x20;

As you climb the tiers, the benefits amplify, rewarding your commitment and contribution to the XSwap ecosystem. Start staking today and unlock the full potential of your assets!

[**https://xswap.link/staking**](https://xswap.link/staking)

<br>


# $WOLF Airdrop

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2F7CkTFAHrefTiOeJ8OeHl%2FFINAL%20AIRDORP%20WOLFA.png?alt=media&amp;token=df3b60a4-ec68-4e0a-a952-099db8edaf64" alt=""><figcaption></figcaption></figure>

#### $WOLF Token Airdrop: First Ecosystem Airdrop for $XSWAP Stakers

We’re excited to announce that the first ecosystem airdrop of **$WOLF** tokens has been successfully completed for XSwap stakers. We’re distributing over 310,000,000 $WOLF tokens, **worth \~$50,000**.\
\
Landwolf is one of the hottest memes in the crypto space known as Pepe’s most degenerate friend.

### Here's **what you need to know:**

* Total Distributed: 310,000,000 $WOLF (\~50,000) tokens are airdropped to eligible stakers.
* Eligibility: The airdrop was distributed to all **Admirals** (proportionally to XSwap Power) and 32 randomly drawn **Officers** (fixed amount of 663789 $WOLF).&#x20;
* Check Eligibility: You can verify your eligibility by visiting this sheet: <https://docs.google.com/spreadsheets/d/1ELIGLKgGCay1Ok0yofAS6tsHIOV870wlU-0jmi5vFTw/edit?usp=sharing>
* Claim here: <https://xswap.link/staking/airdrops>&#x20;
* Claim ends 27.01, 17:00 UTC

### Official $WOLF Links:

•X: <https://x.com/Wolf0x67>

•Telegram: [t.me/BoysClubWolf](http://t.me/BoysClubWolf)&#x20;

•Dextools: <https://www.dextools.io/app/en/ether/pair-explorer/0x67324985b5014b36b960273353deb3d96f2f18c2?t=1736781834168>

•Contract: 0x67466be17df832165f8c80a5a120ccc652bd7e69

Stay hyped Marines. More airdrops are on the way!

<br>


# $BOBO Airdrop

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FqQMN0wjcnZ05yWcEUSCB%2FBOBO%20AIRDROP%20DISTRIBUTION.png?alt=media&amp;token=0f717daf-9e40-48ae-a4df-b9834bbaf448" alt=""><figcaption></figcaption></figure>

### $**BOBO Token Airdrop: Second Ecosystem Airdrop for $XSWAP Stakers**

We're thrilled to announce the successful completion of the $BOBO token airdrop for **XSwap stakers**! 55,500,000,000 $BOBO tokens, valued at approximately **$35,000**, have been distributed.<br>

### About $BOBO

Bobo the Bear ($BOBO) is a well-known meme character that originated in 2018, often used to mock poor investment choices and express bearish sentiment in crypto and traditional markets. Created by rekt\_tekashi, it has since become both a community token and an NFT collection, purely for entertainment purposes.

### Airdrop Details

* Total Tokens Airdropped: 55,500,000,000 $BOBO (\~$35,000)
* Who Received It? All Admirals (distributed based on XSwap Power) and 42 randomly selected Officers (fixed amount).
* How to Check Eligibility? Verify your status in this sheet: <https://docs.google.com/spreadsheets/d/1XgoAXAV3Rljy9a4RjuXWQbccO7LqtBtMHDFBJFqMhaw/edit?usp=sharing>
* Claim Here:[ xswap.link/staking/airdrops](https://xswap.link/staking/airdrops)
* Claim Deadline: February 13, 17:00 UTC

### Official $BOBO Links

* Twitter:[ ](https://twitter.com/bobocoineth)<https://twitter.com/bobocoineth>
* Telegram:[ ](https://t.me/bobocoineth)<https://t.me/bobocoineth>
* Contract Address (ETH): 0xb90b2a35c65dbc466b04240097ca756ad2005295

\
More airdrops are coming, stay ready, Marines!

<br>


# Airdrop

XSwap Airdrop Season #1

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FXQuaallM7fDK61G185tk%2Fairdrop.png?alt=media&amp;token=0fbfb549-51d1-459a-a4ef-fdf1edbc4c9d" alt=""><figcaption></figcaption></figure>

We’re thrilled to announce the **Season #1 $XSWAP airdrop**.

This airdrop is our way of showing appreciation to the community members who have actively participated in and supported the growth of the XSwap ecosystem.

\
We want to extend our deepest gratitude to all users who have utilized our Cross-Chain solutions. Your engagement has been a driving force in shaping XSwap into a leading platform in the interoperability space. We are committed to constant innovation and providing value to our community.\
\
With that in mind, let’s dive into the exciting details of our upcoming airdrop.

## Eligibility criteria

\
Your airdrop allocation is dependent on your activity in different fields. In total, you can collect up to 100 points. The minimal amount to classify for an airdrop is **14 points.**

Here's how the points are distributed:

**•Leaderboard position (max 44 points)**

Top 10,000 users: 2 points

Top 5,000 users: additional 2 points (total of 4 points)

Top 2,000 users: additional 4 points (total of 8 points)

Top 500 users: additional 4 points (total of 12 points)

Top 100 users: additional 12 points (total of 24 points)

Top 10 users: additional 20 points (total of 44 points)

\
To reward the most faithful marines, we are distributing additional bonus for the top 3 users in leaderboard.\
\
1st place- 10,000 $XSWAP\
2nd place- 6,000 $XSWAP\
3rd place- 4,000 $XSWAP

\
**•Transaction count (max 13 points)**\
-Make at least 3 Cross-Chain swaps: 2 points\
-Make at least 10 Cross-Chain swaps: additional 4 points (total of 6 points)\
-Make at least 50 Cross-Chain swaps: additional 7 points (total of 13 points)\
\
**•Blockchains count (max 10 points)**\
-Make swaps from at least 2 blockchains: 2 points\
-Make swaps from at least 3 blockchains: additional 3 points (total of 5 points)\
-Make swaps from at least 4 blockchains: additional 5 points (total of 10 points)\
\
**•Early adopters (max 20 points)**\
-Make swap before 01.04.2024 (April 1st): 4 points\
-Make swap before 01.03.2024 (March 1st): additional 16 points (total of 20 points)\
\
**•Consistency (max 13 points)**\
-Make swaps over 2 different weeks: 2 points\
-Make swaps over 3 different weeks: additional 4 points (total of 6 points)\
-Make swaps over 6 different weeks: additional 7 points (total of 13 points)\
\
You can check your eligibility [here](https://xswap.link/airdrop)\
\
To provide fair airdrop distribution across organic users, we’ve been cooperating with Trusta Labs - An Open, Trusted Global ID and Reputation Network.

## Airdrop distribution rules and claiming period

\
You’ll be able to claim your airdrop for the period of **14 days.**\
starting at TGE (06.05.2024 14:00 UTC - May 6th).\
Claim portal:[ ](https://xswap.link/airdrop)<https://xswap.link/airdrop>

All unclaimed tokens will be distributed in the **next seasons**.\
\
There are 2 ways to claim your tokens:

1. Get a **20% Bonus**: Claim 25% of your airdrop immediately and receive the remaining 75% through a three-month linear vesting period.
2. Immediate claim: Loose the additional 20% bonus but claim all of your tokens right away.

\
**Snapshot**\
The snapshot was taken on April 25th, 2024 at 7:00 AM UTC.\
\
We appreciate your patience and continued support.

… and remember that every point matters. #Season2

<br>


# Airdrop Season #2

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FPvcTnNnD7RsGOWCv4Vcn%2Fairdrop%20sezon%202.png?alt=media&amp;token=c5eafcb7-1115-4f22-a143-d10d33969ee9" alt=""><figcaption></figcaption></figure>

We're thrilled to announce the launch of **Season #2 $XSWAP airdrop**, our way of showing love to the community members who have supported and participated in the growth of the XSwap ecosystem.

In Season #2 we defined all eligibility criteria and rewards for each winner and the only thing that matters is your **position in the Leaderboard!**&#x20;

Earning XPoints is crucial to moving up the Sesson #2 Leaderboard and claiming your share of the massive **2,185,000 $XSWAP (\~$300,000)** prize pool!

Staking XSwap not only reduces your transaction fees, but also boosts your XPoints score, making it easier to climb the leaderboard!

***

## Season #2 Airdrop:  \~$300,000 Prize Pool&#x20;

* Total of **2,185,000 $XSWAP** in rewards, which equals \~$300,000 at the current $XSWAP price.
* **200,000 $XSWAP (\~ $25,000)** for the **top 1 participant**.
* **Top 500 participants** on the [Leaderboard ](https://xswap.link/leaderboard)will be eligible.

***

#### Eligibility Criteria

The allocation for this airdrop depends entirely on your leaderboard position, which is gained from activity and engagement in using our XSwap ecosystem. Here’s how you can earn your spot on the leaderboard and qualify for the airdrop:

**How to Earn Points**

Accumulate points through the following activities to improve your leaderboard position:

* Cross-Chain Swaps: Execute cross-chain swaps on the XSwap platform. <https://xswap.link/swap>&#x20;
* Referral System: Invite new users to join the XSwap ecosystem. <https://xswap.link/points>&#x20;
* Swap Count Bonus: Increase your number of swaps to earn additional points.

\
Swap Count Bonus:&#x20;

1-4 transactions: 500 points \
5-14 transactions: 1,500 points \
15-49 transactions: 5,000 points \
50-99 transactions: 10,000 points \
100-249 transactions: 15,000 points \
250-499 transactions: 30,000 points \
500-999 transactions: 50,000 points \
More than 1000 transactions: 100,000 points

***

**XPower Points and Staking boost**

Staking the XSwap token offers significant benefits, including reduced transaction fees. Additionally, staking can help boost your leaderboard position:

* Sergeants receive a **10%** point boost
* Officers receive a **15%** point boost
* Admirals receive a **20%** point boost

Stake now: <https://xswap.link/staking>&#x20;

Make sure to monitor your XPoints earnings to always be ahead of the curve: <https://xswap.link/points>&#x20;

***

## Leaderboard Rewards

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FCDN6uc3YgKqVbwEHVNCl%2Fphoto_2024-05-29_16-02-54.jpg?alt=media&amp;token=628e694d-ada0-4d5f-948d-23dd876a9214" alt=""><figcaption></figcaption></figure>

Top participants will receive the following rewards from the total pool of 2,185,000 $XSWAP:

* **1st place: 200,000 $XSWAP**
* **2nd place: 100,000 $XSWAP**
* **3rd place: 60,000 $XSWAP**
* **4th-5th places: 30,000 $XSWAP each**
* **6th-10th places: 20,000 $XSWAP each**
* **11th-20th places: 15,000 $XSWAP each**
* **21st-50th places: 8,000 $XSWAP each**
* **51st-100th places: 6,000 $XSWAP each**
* **101st-150th places: 5,000 $XSWAP each**
* **151st-225th places: 3,500 $XSWAP each**
* **226th-325th places: 2,000 $XSWAP each**
* **326th-500th places: 1,500 $XSWAP each**

The points are counted from April 25th, 2024 7:00 AM UTC which marks the snapshot of airdrop season #1

***

Claiming and Distribution

You will have two options for claiming your airdrop rewards:

1. 3-Month Linear Vesting: Distributed evenly over a three-month period.
2. Immediate Claim and Stake: Choose to claim **100%** of your airdrop tokens right away and stake them in an Intergalactic Command Staking Pool. By staking, you can immediately benefit from reduced transaction fees, earn additional rewards, and participate in our ecosystem token airdrops.

Select the option that best suits your strategy and maximize your benefits in the XSwap ecosystem. You’ll be able to decide on how you want to claim your airdrop for the period of 14 days.

***

Stay tuned as we unveil the full details of Season #2 distribution and timeline. In the meantime, let's dive into the action. Exciting rewards await, so gear up and join us in the journey to shape the future of DeFi!

Let’s continue to grow together, Marines! #Season2

<br>


# Treasure Hunt

XSwap Treasure Hunt: Swap and Earn!

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FVxYak1cdj6z7b7xODHOm%2Farticule2.png?alt=media&amp;token=eec710bc-e7c8-466e-beed-b983031f6f70" alt=""><figcaption></figcaption></figure>

The **XSwap Treasure Hunt** launches on September 26, 2024, offering users a new and exciting way to earn rewards by swapping tokens on the XSwap platform.&#x20;

## **What is XSwap Treasure Hunt?**

The XSwap Treasure Hunt is a gamified rewards program where users earn **Credits** for completing Cross-Chain swaps on XSwap or/and inviting friends. These Credits can be used to unlock different levels of mystery boxes, each packed with token rewards up to **$40,000**. The more you trade, the more Credits you accumulate, allowing you to open higher-tier chests with bigger rewards.

## How to Earn Credits

1. Earning Credits is simple: for every $1 in transaction volume (through Cross-Chain swaps or USDC bridges), you earn 1 Credit. As you increase your trading volume, you earn more Credits to spend on chests containing token prizes.\
   \
   *Example:*\
   *If you swap tokens worth $1,000, you’ll earn 1,000 Credits. These Credits can be saved up and spent on chests with greater rewards.*
2. Second option for earning credits in the referral program. Invite your friends and get 15% of the credits your friends make by swapping or bridging.

## Mystery Box Tiers and Credit Costs

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FC24TvxeFLB4iJA38d8ui%2F22xswap22.png?alt=media&amp;token=303a2a44-b7b6-4397-90d2-a204b0ca684f" alt=""><figcaption></figcaption></figure>

The XSwap Treasure Hunt offers a range of mystery boxes that scale in rewards as the tier increases. Each tier presents a chance to win token prizes like **ETH, LINK, XSWAP, CREDITS, and WBTC**. Here's the updated breakdown of each chest and the rewards:

**1. Common Chest – 1,000 Credits**\
It contains small token rewards with a high chance of landing an empty chest.

* ETH: 0.004 - 5% chance
* LINK: 0.5 - 10% chance
* XSWAP: 60 - 15% chance
* Empty: 70% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FrBlXlfZEyG759NstERqz%2Flevel%202%20(2).jpg?alt=media&amp;token=c7140ba0-c2d8-4b9e-84f6-32f38b08152b" alt=""><figcaption></figcaption></figure>

**2. Basic Chest – 3,000 Credits**\
A higher-tier chest with better token rewards.

* ETH: 0.012 - 3% chance
* Credits: 5,000 - 5% chance
* WBTC: 0.0002 - 8% chance
* LINK: 0.75 - 15% chance
* XSWAP: 75 - 25% chance
* Empty: 44% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2Fw5DFItH6Q08D90i3NWAk%2Flevel%201%20(2).jpg?alt=media&amp;token=f41b1452-e6a0-4c00-b08b-5fd3c45243f3" alt=""><figcaption></figcaption></figure>

**3. Advanced Chest – 10,000 Credits**\
Mid-tier chest offering more significant token rewards.

* ETH: 0.03 - 3% chance
* Credits: 15,000 - 7% chance
* LINK: 2.5 - 15% chance
* ETH (lower value): 0.0075 - 15% chance
* XSWAP: 175 - 50% chance
* Empty: 20% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FONO2K175IJuM7qRiSBDD%2Flevel%203%20(2).jpg?alt=media&amp;token=472c8834-29d9-4767-9dc3-dc2c152f027d" alt=""><figcaption></figcaption></figure>

**4. Enhanced Chest – 30,000 Credits**\
Substantial rewards with higher token values.

* ETH: 0.15 - 1% chance
* WBTC: 0.004 - 4% chance
* Credits: 45,000  - 10% chance
* LINK: 7 - 10% chance
* XSWAP: 700 - 25% chance
* ETH (lower value): 0.008 - 50% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FyD55HaeDOgKTOtUF7HQ8%2Flevel%204%20(2).jpg?alt=media&amp;token=4f213d80-00b2-4f70-a353-8fc591f8df8e" alt=""><figcaption></figcaption></figure>

**5. Epic Chest – 100,000 Credits**\
Epic-level chest with significant token rewards.

* LINK: 100 - 2% chance
* Credits: 175,000 - 10% chance
* WBTC: 0.007 - 10% chance
* ETH: 0.08 - 18% chance
* XSWAP: 1,000 - 60% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FuwJ6II5UEHL9QoWgJaQn%2Flevel%205%20(2).jpg?alt=media&amp;token=0fa42c1b-59ef-4910-9fad-fd2f74b158f0" alt=""><figcaption></figcaption></figure>

**6. Legendary Chest – 300,000 Credits**\
Legendary-tier chest with large token rewards.

* ETH: 2.0 - 2% chance
* WBTC: 0.04 - 5% chance
* Credits: 500,000 - 5% chance
* LINK: 65 - 8% chance
* ETH (lower value): 0.175 - 30% chance
* XSWAP: 3,333 - 50% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2Fkh760tldSzXPPMQecSxU%2Flevel%206%20(2).jpg?alt=media&amp;token=0f43fd51-9453-4299-aacf-6b83415b082d" alt=""><figcaption></figcaption></figure>

**7. Mythic Chest – 1,000,000 Credits**\
The ultimate chest with the highest rewards possible.

* WBTC: 0.6 - 1% chance
* ETH: 6 - 1% chance
* LINK: 800 - 1% chance
* ETH (mid value): 3,5 - 2% chance
* Credits: 1,750,000 - 6% chance
* ETH (lower value): 0.8 - 20% chance
* LINK (lower value): 50 - 70% chance

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2Fdbs1e88ZbZ9Wb1parrFc%2Flevel%207%20.jpg?alt=media&amp;token=80d659ca-cefe-4131-bc28-35e51efd3680" alt=""><figcaption></figcaption></figure>

The higher the chest tier, the more valuable the potential rewards, with up to **$40,000** in prizes to be won. Don’t miss your chance to unlock these valuable rewards by swapping tokens on XSwap!

The more Credits you collect, the better the chests you can unlock, with higher-tier chests offering much larger token rewards.

*\*Prize sizes may change during the campaign.*

#### Prizes to Be Won

Win up to $40,000 in rewards, the XSwap Treasure Hunt offers users a chance to win the following token rewards:

* ETH (Ethereum)
* LINK (Chainlink)
* XSWAP (XSwap’s native token)
* CREDITS (Bonus Credits to unlock more chests)
* WBTC (Wrapped Bitcoin)

These tokens can help boost your portfolio and enhance your trading experience on XSwap. The more you swap, the more chances you have to unlock valuable prizes.

## Key Dates and Information

* Campaign Launch Date: September 26, 2024
* Launch Time: 16:00 UTC
* [ ](https://xswap.link/rewards)<https://xswap.link/rewards>

## How to Get Involved

Getting started with the XSwap Treasure Hunt is easy:

1. Start Swapping and Bridging: Visit XSwap to begin trading and earning Credits for each transaction. [https://xswap.link/swap](https://xswap.link/swap?fromChain=1\&toChain=8453\&fromToken=ETH\&toToken=XSWAP)
2. Redeem Your Credits: Use your accumulated Credits to purchase mystery boxes at the Mystery Box Store. <https://xswap.link/rewards>
3. Participate in Special Events: Keep an eye out for events where you can earn more Credits or buy discounted chests.

## Conclusion

The **XSwap Treasure Hunt** is an exciting opportunity to earn real value simply by swapping tokens on XSwap. With seven tiers of mystery boxes, this is your chance to get rewarded for trading. Don’t miss the launch on September 26, 2024, and start collecting Credits to unlock your rewards!

Start Swapping Now: XSwap Treasure Hunt\
Visit the Mystery Box Store: Redeem Your Credits

<https://xswap.link/rewards>

Happy hunting!


# Staking Bonus

XSwap Treasure Hunt Staking Bonus! Earn Free Credits for Staking $XSWAP!

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2Fbdjz7IvWH0oTC5qtvy9Z%2Fxs.png?alt=media&amp;token=f6a5cf99-da66-464f-939a-6d7e5c342594" alt=""><figcaption></figcaption></figure>

To show our appreciation for your support, we’re launching a special bonus for our stakers! Whether you’re a long-time staker or just getting started, you can now earn extra Credits and unlock Mystery Boxes in the XSwap Treasure Hunt. These Mystery Boxes are filled with massive rewards in **ETH, LINK, WBTC, XSWAP**, and more!

**Here’s everything you need to know:**

We’ve conducted a snapshot of all current stakers, and the distribution of bonus Credits is based on your staking amount and rank. Here’s how you can benefit:&#x20;

## **🎖 Credits Distribution Based on Rank**

If you’re already staking, you’ll receive FREE Credits according to your rank:

* **Admiral**: 10,000 Credits\
  Top 10 Admirals get an extra 10,000 Credits!
* **Officer**: 6,500 Credits
* **Sergeant**: 4,000 Credits
* **Recruit (minimum of 5,000 XPower)**: 2,500 Credits
* **All other Recruits**: 1,000 Credits

If you decide to stake more tokens now, you’ll also earn bonus Credits based on your additional amount staked!

## **🆕 Earn More Credits When You Stake Additional Tokens**&#x20;

(This is available to new stakers and those seeking to add more to their existing staking amount.)

For every 1 $XSWAP staked in **Intergalactic Command Staking Pool**, during the bonus, you’ll earn 0.25 Credits.

*Example:*\
*If you stake a 1,000 $XSWAP, you’ll receive 250 Credits.*

It’s that simple! The more you stake, the more Credits you’ll accumulate. [**https://xswap.link/staking/intergalactic-command**](https://xswap.link/staking/intergalactic-command)

## How to Use Your Credits?

All Credits can be used to unlock various Mystery Boxes, ranging from Common to Mythic, offering valuable rewards like ETH, LINK, WBTC, and XSWAP tokens. The more Credits you collect, the better chests you can unlock! <https://xswap.link/rewards>

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2F936GrgNVZiA7U19JYuCy%2Fhow%20to%20use.png?alt=media&amp;token=e232a6b9-941b-4c0c-98dd-27a57facb1c3" alt=""><figcaption></figcaption></figure>

\
**🔥 Join the Hunt Today!**

Whether you’re an existing staker or joining now, there’s no better time to take advantage of these bonus. Don’t miss out on your chance to earn exclusive rewards and be a part of the XSwap Treasure Hunt!

👉 **Stake now and collect your bonus Credits!** [**https://xswap.link/staking/intergalactic-command**](https://xswap.link/staking/intergalactic-command)

<br>


# Direct Staking

XSwap Direct Staking Overview

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FYlpkLt7wDz7Bj2BvW90V%2Fimage.png?alt=media&amp;token=8feb38d9-088f-40e1-8be6-7266631c9975" alt=""><figcaption></figcaption></figure>

In collaboration with Chainlink we developed a direct staking solution designed to simplify the process of staking cryptocurrencies from any chain through liquid staking tokens. It integrates front-end systems with smart contracts to enable users to stake tokens such as Wrapped Ethereum (WETH) seamlessly across both Layer 1 (L1) and Layer 2 (L2) blockchains. The platform automates complex backend operations, ensuring that users can easily stake tokens and receive corresponding LSTs, all while keeping the technical complexities hidden from the user.\
\
The direct staking is available here: <https://xswap.link/direct-staking>

### How XSwap Direct Staking Works: User Experience

**Staking Example: Stake WETH for wstETH (Lido Protocol)**

The platform provides a seamless user experience for staking WETH (Wrapped Ethereum) on Layer 2 networks like Arbitrum or Optimism and Base. Here’s how it works:

**Stake WETH on L2:**

Users stake WETH they hold on a supported L2 network.

Using the Fast Stake Option, users immediately receive LST tokens like wstETH (Lido’s staked Ethereum) from a liquidity pool in their wallet.

**Backend Automation:**

XSwap Direct Staking automatically handles the background operations of transferring WETH from Layer 2 to Layer 1 (Ethereum mainnet).

It then deposits this WETH into the chosen staking protocol (e.g., Lido), and bridges the resulting LST tokens (like wstETH) back to the user’s L2 wallet.

**L1 and L2 Transfers:**

This entire process is automated, and users can continue using their tokens while the backend manages the bridging between L1 and L2 using Chainlink's CCIP (Cross-Chain Interoperability Protocol) for efficient and secure cross-chain transactions.

### Two Staking Methods on XSwap Direct Staking

XSwap Direct Staking offers users two distinct methods for staking their tokens, catering to both fast and high-volume needs:

1. **Fast Staking via Liquidity Pool:**\
   This method provides immediate receipt of LSTs. Once users stake their WETH on L2, they receive their LST (like wstETH) instantly from a liquidity pool. This is a fast and efficient process, recommended for transfers where liquidity is available. This option ensures that users can begin utilizing their staked tokens immediately, without waiting for cross-chain transfers.
2. **Slow Staking via Native Bridges:**\
   For larger transactions or when liquidity pools are limited, XSwap Direct Staking offers a second method.In this process, the staked tokens (like WETH) are transferred from L2 to L1, staked in the respective protocol (e.g., Lido), and the resulting LST tokens are bridged back to L2 using the native bridge. This method takes longer, and users will only receive their LST tokens after the full cross-chain transfer is completed. While slower, this option removes limits on the amount of tokens that can be staked, making it ideal for larger-scale staking operations.

**Real-Time Updates:**

Users can see their wallet balances in real time, including both their staked WETH and the LST they receive. The process is quick, usually taking about an hour for L2-L1 transfers (in Slow Staking Method), and users can monitor the progress.

### How XSwap Direct Staking Ensures Efficiency

**Bridging and Smart Contracts**

XSwap Direct Staking leverages advanced smart contracts to manage transactions across different blockchains:

**Custom Sender and Receiver Contracts**: These contracts manage the flow of tokens between users, liquidity pools, and staking protocols. Each supported protocol, such as Lido, has its own unique smart contract for interaction.

**Cross-Chain Bridging**: The platform uses Chainlink’s CCIP to bridge assets across L1 and L2 securely and efficiently. This ensures smooth transfers without any disruption to user experience.

**Supported Bridges**

Depending on the user’s needs, different bridges are used to manage transfers between L1 and L2:

**Arbitrum, Optimism, and Base Bridges**: For users on these Layer 2 solutions, specific encoding methods are used for cross-chain transfers, ensuring that the process is fast and cost-effective.

**Native L2 Bridges**: XSwap Direct Staking also supports the use of native L2 bridges, adding further flexibility to how users can stake their assets.

### Use Cases

XSwap Direct Staking is designed to cater to various staking needs and scenarios:

**Direct Staking (Lido Protocol Example)**: Users can stake WETH/ETH and receive wstETH/stETH instantly in their wallet without worrying about the complex operations of cross-chain transfers. This process is fully automated and user-friendly.

**Future Use Cases**: The platform is designed with flexibility in mind, allowing for new staking tokens, protocols, and even custom token transfers to be integrated as the space evolves. More use cases can be powered by the smart contracts used on the platform.

### Why XSwap Direct Staking?

XSwap Direct Staking provides a seamless, intuitive experience for users looking to stake tokens and receive liquid staking tokens (LSTs) without dealing with the technical complexities of cross-chain operations. The platform offers:

**Instant Staking Rewards** through LST tokens.

**Full Automation** of backend operations.

**Cross-Chain Compatibility** between L1 and L2 solutions.

**Transparent Fees** and secure wallet integration.

With its advanced smart contract architecture and integration of Chainlink’s CCIP, XSwap Direct Staking is the go-to solution for anyone looking to stake their crypto assets simply and efficiently.

### Conclusion

XSwap Direct Staking combines ease of use with powerful backend technology to deliver an efficient staking solution across multiple blockchains. Whether you’re a beginner or an advanced user, the platform's simplicity, automation, and support for popular protocols like Lido make it an excellent choice for staking and managing your crypto assets securely and transparently.

\ <br>


# Referral Program

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FZ92VANuMgNEe2Wa0vd2x%2FZrzut%20ekranu%202025-05-27%20o%2010.29.33.png?alt=media&amp;token=fe9e30dc-2924-424a-8154-c4e67dfd429d" alt=""><figcaption></figcaption></figure>

### Overview

The XSwap Referral Program allows users to earn passive income by referring others to trade on XSwap.

* Every user can generate a unique referral link.
* When a referred user completes cross-chain swaps on XSwap, the referrer earns 30% of the protocol fees generated from those trades.
* Rewards are uncapped and unlimited in duration.

### How It Works

1. Go to: <https://xswap.link/referrals>
2. Connect your wallet.
3. Your unique referral link will be automatically generated.
4. Share this link with friends, communities, or audiences.
5. When someone swaps using your link, you earn 30% of their trading fees.

You can track your referral stats, such as number of referred users and earned rewards, directly in the referral dashboard.

### Key Details

* &#x20;Reward Rate: 30% of all trading fees paid by your referred users
* &#x20;Duration: Lifetime. You keep earning as long as they keep swapping.
* &#x20;Who can join: Anyone with a wallet connected to XSwap
* &#x20;Where to use: Share anywhere—socials, websites, newsletters, communities

### When and How Are Rewards Distributed?

Rewards are accumulated after each eligible referral swap and are processed through weekly update cycles to ensure accurate data synchronization between smart contracts and leaderboards. Your referral earnings are reliably calculated and made available for claiming through the dashboard once each weekly processing cycle is complete, providing consistent and trustworthy reward distribution for all participants.

### Tips for Maximizing Rewards

* Create educational content about how to use XSwap
* Share your link in crypto forums, discords, telegrams and relevant X spaces
* Target emerging projects and chains that attract high trading volume

\
**Support**

If you have questions, contact the XSwap team on:

* Telegram: <https://t.me/xswap_community>
* Twitter: <https://x.com/xswap_link>

Let your network work for you. Start earning today at <https://xswap.link/referrals>

\
\ <br>


# XSwap Trading League - Official Rules

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2Fy1vkTHXSJOEUhDVlN0su%2FPRIZES.png?alt=media&amp;token=26c8952e-a691-4327-ace0-4898ed7fe244" alt=""><figcaption></figcaption></figure>

### Overview

The XSwap Monthly League is an ongoing trading campaign rewarding the most active users in the XSwap ecosystem.

\
Every month, participants compete on a public leaderboard for a share of 100,000 $XSWAP tokens.

This month we reward the most active traders of the $XSWAP token.

\
The more you trade, the higher you rank.

### 🗓️ Campaign Overview

* Ongoing campaign - no fixed end date.
* The leaderboard resets on the 9th day of each month.
* Monthly rewards distributed in $XSWAP tokens.
* The total monthly pool is 100,000 $XSWAP, awarded to the Top 50 traders.

### 💰 Rewards

* Total Monthly Pool: 100,000 $XSWAP
* Winners: Top 50 traders ranked on the monthly leaderboard
* Reward Breakdown: Announced at the end of each month

🌀 Stay tuned — reward distribution for each position will be revealed after each competition round.

### 🎯 How to Participate

1️⃣ Trade at least 100$ of the $XSWAP token using the official [xswap.link/swap](https://xswap.link/swap) interface.\
2️⃣ Each trade automatically counts toward your trading volume.\
3️⃣ Earn points and climb the leaderboard - no registration required.

### 🧮 Scoring System

Your position on the leaderboard is determined by your total trading volume for the $XSWAP token.

1 USD traded = 30 points

All points are calculated based on the USD value of your $XSWAP trades at the time of execution.<br>

### 🏆 Leaderboard

* Updated automatically.
* Displays cumulative points.
* Publicly visible on xswap.link/swap.
* After each monthly reset, all points return to zero.

### 📜 Terms & Adjustments

* Rewards distributed within 10 business days after each month ends.
* Sent directly to the wallet addresses used for the qualifying trades.
* The reward structure (per position) is announced publicly before payout.

### 🌟 Rewards Distribution

* Rewards distributed within 10 business days after each month ends.
* Sent directly to the wallet addresses used for the qualifying trades.
* The reward structure (per position) is announced publicly b

### 📜 Terms & Adjustments

* XSwap reserves the right to adjust campaign rules or scoring mechanics monthly to ensure fairness.
* Updated competition details will be published at the start of each new round.
* By participating, users agree to the terms outlined in this document.

\
\
🚀 Start Trading Now

### &#x20;🔗 Useful Links

* 🟦 [Join the Trading League!](https://xswap.link/swap)&#x20;
* 🧠 [Learn about XSwap](https://blog.xswap.link/)


# Token Creation Platform (TCP)

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FNNdGjFGngl1adthrGzqi%2FXSWAP%20CHAINLINK%20BASE.png?alt=media&amp;token=3cfe2d45-434d-4ede-9d65-4ab1931c4870" alt=""><figcaption></figcaption></figure>

## XSwap Token Creation Platform (TCP) – Documentation

XSwap Token Creation Platform (TCP) is a no-code platform that enables anyone - creators, protocols, and communities to launch fully interoperable, cross-chain tokens in just a few seconds.

Powered by Chainlink and Base, the TCP platform transforms token creation into a seamless, secure, and scalable experience. By leveraging Chainlink CCIP infrastructure and Base's high-performance Layer 2 (L2) network, TCP allows builders to create tokens once and deploy them everywhere, laying the foundation for a unified token economy without boundaries.

### Key Features

* **No-Code Platform:** An intuitive interface allows for the configuration and deployment of a cross-chain token without writing a single line of code, drastically lowering the barrier to entry.
* **Instant Deployment:** Tokens are deployed by default on the Base network, providing a scalable, efficient, and low-cost starting environment.
* **Native Cross-Chain Interoperability:** Thanks to Chainlink CCIP integration, tokens can be seamlessly expanded to additional blockchains, enabling native growth and multi-chain liquidity from day one.
* **Built-in Liquidity:** The platform integrates XSWAP as its native liquidity token, helping to establish active markets for newly created assets.
* **Creator-Centric Model:** The Creator Recognition Program ensures that the value generated by the platform flows back to its creators.

### How It Works (Workflow)

TCP simplifies the token creation process into a few intuitive steps:

1. **Configuration:** The user navigates to the TCP platform at `xswap.link` and uses the no-code interface to configure their token's parameters (e.g., name, symbol, total supply).
2. **Deployment on Base:** With one click, the token is deployed natively on the Base network. This provides immediate utility in a high-performance, low-transaction-cost environment.
3. **Cross-Chain Expansion (CCIP):** After deployment, creators can seamlessly connect their token to other blockchain networks via Chainlink CCIP. This enables secure token transfers and access to a wider ecosystem without the need to implement complex bridges.

### Rewards for Creators

XSwap is committed to supporting real builders. The TCP platform is designed so that the platform's success is directly linked to creator outcomes.

* **Creator Participation Share:** Every project launched via TCP allocates a 0.6% share of its trading activity to the creator.
* **$1000 Builder Grant:** Projects that reach the "graduated" milestone (defined in the program documentation, based on community traction and on-chain engagement) may qualify for a $1,000 builder grant.

### XSWAP Token Integration

The XSWAP token is the liquidity foundation of the TCP. Instead of leaving creators with the problem of sourcing liquidity after launch, XSWAP is built into the creation process to help establish active markets from the very beginning.

### Getting Started

The Token Creation Platform (TCP) is available to all builders at: [**xswap.link**](https://xswap.link/)


# XSwap AI Insights

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FmgYNKqhCrMiLA8WpYW7O%2FAI%20INSIGHTS.png?alt=media&amp;token=9c4e2915-57e5-462d-b129-b630ffadcae3" alt=""><figcaption></figcaption></figure>

## XSwap AI Insights – Documentation

### Overview

XSwap AI Insights is an advanced analytics feature designed to provide users with real-time, AI-powered token intelligence. It enables traders and investors to better understand market dynamics, social sentiment, on-chain behavior, and token security—directly from the XSwap interface.

Developed in collaboration with Chainlink and powered by decentralized data feeds, XSwap AI Insights helps users make smarter decisions without leaving the DEX.

### Key Features

#### 1. Token Summary & Ranking

* Each supported token has a dedicated profile that includes:
  * Real-time trend classification (e.g. DEX, Cross-Chain, Meme, RWA, etc.)
  * Market rank (based on aggregated trading metrics and sentiment)
  * Summary analysis describing the token's positioning within broader narratives

#### 2. Market Metrics (Live Data)

* **Price (USD)**: Real-time token price
* **24h Volume**: Total swap volume over the last 24 hours
* **Circulating Supply (%)**: Tracked vs. total supply if available
* **Holders**: Total number of wallet addresses holding the token (+30d change)
* **Market Cap**: Dynamic based on price × circulating supply
* **Price Position**: Current price relative to ATL and ATH (with dates)

#### 3. Sentiment Analysis

* **Social Sentiment**: Aggregated from on-chain and off-chain signals (X, forums, analytics feeds)
  * Rating: Positive / Neutral / Negative
  * Emoticon indicators for quick sentiment scanning

#### 4. Security Assessment

* A holistic security score is generated using:
  * On-chain risk checks
  * Contract audits (if available)
  * Historical exploit history
  * Wallet distribution stability
* Statuses: High / Medium / Low

#### 5. Market Context

* **Fear & Greed Score**: Real-time index on market psychology
* **Commentary**: Explains context around recent token performance (e.g., outperforming ETH/BTC, trending signals, volatility flags)

#### 6. Bullish vs Bearish Signals

* **Bullish signals** may include:
  * Price momentum
  * Growth in holders
  * Stable liquidity
  * Positive sentiment spikes
* **Bearish signals** may include:
  * High concentration among top wallets
  * Recent underperformance
  * Drop in engagement or sentiment

#### 7. Actionable Insights (AI Suggestions)

XSwap's model combines short-term metrics (price change, sentiment, volatility) to issue insights such as:

* "Now may be an opportune moment to consider swaps"
* "Token may be approaching critical resistance"
* "Recent holder growth suggests possible trend continuation"

### Supported Tokens

As of now, the following tokens are supported:

1INCH, XSWAP, TOSHI, GALA, AXL, LINK, SHIB, PEPE, BRETT, AAVE, ARB, BNB, LDO, TON, FET, AXS, ETH, DOGE, LEO, WBTC, AVAX, BCH, LTC, DOT, ONDO, ETC, POL, GRT, FIL, ATOM, DEXE, MKR, EOS, BONK, CRV, QNT, INJ, PAXG, IMX, JASMY, NEXO, SAND, BTT, XCN, PENDLE

New tokens are regularly reviewed and added based on liquidity, traction, and user demand.

### Access & Integration

* Available directly within the swap panel UI at XSwap.link/swap
* No wallet connection required to view insights
* Updated dynamically every 10–15 minutes

### Best Practices

* Use AI Insights to supplement (not replace) your due diligence
* Cross-reference social sentiment and price action to spot early signals
* Track holder metrics for insights on long-term token health
* Rely on security scores when evaluating new or lesser-known tokens

### Disclaimer

AI Insights are provided for educational purposes only. They do not constitute financial advice. Always conduct your own research before making investment decisions.

For integration partners or third-party developers seeking to embed XSwap AI Insights into their own dApps or platforms, please contact us directly via email.


# XLine

Stablecoin infrastructure layer.

## What is XLine?

XLine is the CCIP-orchestrated stablecoin infrastructure layer. It routes USDC across every chain Chainlink CCIP supports, any-to-any, including multi-hop paths when no direct lane exists.

USDC exists on most major chains, but it does not move freely between them. Each chain holds isolated liquidity, and moving value means selecting a bridge, evaluating its security model, and often accepting a wrapped variant. XLine removes that step. A chain or protocol integrates once and gains USDC movement to and from every other connected chain.

Key Features:

* Any-to-Any Routing: Route USDC between any two CCIP-enabled chains, resolved into a single path per transfer.
* Multi-Hop Paths: Where a direct lane exists, XLine routes through it. Where it does not, XLine constructs a multi-hop path across intermediate chains.
* Full Connectivity from One Integration: A chain connects to CCIP once. XLine maps the full network and handles reachability to every other connected chain. No need to establish individual lanes.
* Secured by Chainlink CCIP: Every path XLine constructs settles over CCIP and inherits its security model.

### How it works

XLine maps the full set of Chainlink CCIP lanes that exist between chains and treats them as a single routing network.

For each transfer, XLine resolves the path between the source and destination chain:

* Direct route when a CCIP lane exists between the two chains.
* Multi-hop route across intermediate chains when no direct lane exists.

Route selection, settlement, and completion happen inside the layer. The user or integrating protocol submits one transaction. The result is full network reachability without every chain pair requiring a direct connection.

### Secured by Chainlink CCIP

Every transfer routed through XLine settles over Chainlink CCIP.

CCIP is a cross-chain interoperability protocol built on Chainlink's decentralized oracle networks with a defense-in-depth security model. Cross-chain messages are independently verified by multiple oracle networks rather than a single bridge operator, and a separate Risk Management Network monitors transfers and halts execution on detection of an anomaly.

Because XLine does not operate a custom bridge, it adds no new trusted component. Transfers move over infrastructure that is already audited and in production use.

### For chains

A chain that integrates XLine gains bridgeable USDC and movement across the network without building or maintaining cross-chain infrastructure itself.&#x20;

For a newer chain, this provides mobile stablecoin liquidity from day one. For an established chain, it consolidates fragmented stablecoin variants into a single asset with a path to native USDC.

\ <br>


# Bridge & Swap

Bridge & Swap Feature on XSwap

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FrMzeVu7zrjQV4AgIUqmj%2Fxswap%2018%20(2).png?alt=media&amp;token=819aa475-cda0-4e74-86a6-bb5758648670" alt=""><figcaption></figcaption></figure>

XSwap offers users the dual capability of not only swapping but also bridging native assets between different blockchains. These features aim to simplify the complexities inherent to cross-chain transfers and bridge operations, fostering a more interconnected and fluid decentralized ecosystem.

**Key Aspects:**

1. **Intuitive Asset Swapping:**
   * Directly swap popular assets across major chains without intricate routes or steps. Simply select the source asset and the target chain, and let XSwap handle the rest.
2. **Token Bridging Capability:**
   * Beyond just swapping, XSwap enables users to bridge tokens from one blockchain to another. This means that assets can be ported to other chains, expanding their utility and reach.
3. **User-Friendly Process:**
   * Whether swapping or bridging, the platform's interface is streamlined for ease of use, ensuring even newcomers can navigate the process with confidence.
4. **Example Use Case:**
   * Assume you have USDC on the Ethereum network and you wish to obtain USDT on the Binance Smart Chain (BNB). With XSwap, you can either directly swap USDC for USDT or bridge the USDC token to its equivalent representation on the BNB chain, depending on your needs.
5. **Safety, Security, and Efficiency:**
   * Both the swap and bridge functionalities emphasize speed, with advanced interoperability protocols facilitating rapid transfers. Moreover, each operation, whether a swap or bridge, is secured by CCIP.

XSwap distinguishes itself in the decentralized finance landscape by offering dynamic fee rates for its swap services. The fee is subject to adjustment based on network conditions and market dynamics. This flexibility ensures that the fee remains competitive and fair, adapting to the ever-changing demands of the blockchain environment.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FhgCbr1QUoXcjJ83IrjV9%2FXSwap%20Swap%20page.png?alt=media&amp;token=7002eabd-b63e-4201-a4c3-6538d3c9a7c7" alt=""><figcaption></figcaption></figure>


# Governance

XSwap Governance Model & DAO

**Governance Through Tokenization:**

**XSwap Token Role:** The very essence of XSwap's governance lies in its native token. Token holders are not just protocol members; they play an active role in the protocol's decision-making processes. By holding the XSwap token, they earn the right to participate in and shape the future direction of the platform. Further details regarding DAO mechanisms will be introduced in the near future.


# Overview

Introducig XPay is a powerful payment tool designed to simplify cross-chain transactions. Built on Chainlink's CCIP, XPay ensures top security and simple integration across multiple blockchains.

XPay offers a variety of tools designed to leverage the advanced cross-chain routing solutions provided by XSwap. This SDK enables other projects to seamlessly integrate cross-chain interactions into their platforms, utilizing the same robust backend infrastructure as XSwap, but with the flexibility to define custom interactions tailored to specific needs.

### Key Features

* **Cross-Chain Compatibility:** Facilitate seamless asset movements across different blockchain networks.
* **Framework Agnostic:** Easily integrate with any JavaScript environment or framework.
* **User-Friendly Integration:** Simplified setup and usage to minimize development time and effort.
* **Enhanced Security:** Built on Chainlink's secure and reliable Cross-Chain Interoperability Protocol (CCIP), ensuring safe cross-chain transactions.

### How it works

Our solution enables the execution of any smart contract on the destination chain while ensuring an exceptional user experience. Below, you will find a visual representation of the process, illustrated with a cross-chain token purchase example.<br>

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FfbmLXZyASVAFe69LNDc4%2Fimage.png?alt=media&amp;token=da78f9a8-7453-4ee4-a39b-16c72a0a3efb" alt=""><figcaption></figcaption></figure>

### Interoperability Made Easy

At XSwap, we understand that the primary challenge in achieving interoperability is the complexity of underlying technology. With XPay, we streamline this process, converting single-chain applications into cross-chain applications within minutes. Our framework-agnostic user interface ensures a seamless experience when selecting chains and tokens for transactions, making the process intuitive and user-friendly.


# Quick Start

How to start with XPay

XPay is framework-agnostic so you can use it in any javascript environment.

### Install library

Installation via node package manager npm:&#x20;

```bash
npm i @xswap-link/sdk
```

### Basic Setup

To set up XPay in your project, follow these steps:

```typescript
import { openTransactionModal } from "@xswap-link/sdk";
```

Open XPay modal with example configuration

```typescript
await openTransactionModal({
  integratorId: "xxxxx", // XSwap Integrator ID
  dstChain: "8453", // Base
  dstToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c", // XSWAP Token
});
```

Execute transactions and enjoy the power of interoperability!&#x20;

**NOTE** if you need integratorId then [**Apply Here**](https://forms.gle/Y6kh19Bghtayt6FZ7)

For a more detailed example please check the example project on [**Github** ](https://github.com/xswap-link/Cross-Chain-Token-Purchase)


# Core Concepts

XPay core concepts

## Interoperability

Interoperability between blockchain networks is a significant challenge due to the complexity of underlying technologies. XPay simplifies this by providing a seamless interface for cross-chain transactions. By leveraging Chainlink's CCIP, XPay ensures secure and reliable interoperability, enabling the execution of smart contracts on different chains.

## XPay UI

Our project recognizes the effort needed to create a solution that will be capable of handling multiple networks at once and fully take advantage of cross-chain technologies like the chainlinks CCIP. That is why we are dedicated to delivering various UI for broad use cases to streamline the integration process. The UI is written in pure JavaScript and can be implemented on any website. Below you will find our modal UI that can be used for Cross-chain Token purchases.  &#x20;

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FEak1EZ8xDoWQIvSjb9VB%2Fimage.png?alt=media&amp;token=6236ce22-bab2-4e00-bf68-9dd51d7a7840" alt=""><figcaption></figcaption></figure>

## Programmable Token Transfers

The Chainlink Cross-Chain Interoperability Protocol (CCIP) is far more than a simple token bridging solution. It’s a generalized cross-chain messaging protocol for transferring tokens (value), messages (data), or both tokens and messages simultaneously within a single cross-chain transaction—referred to as Programmable Token Transfers.

In effect, XPay Programmable Token Transfers enable smart contracts to transfer tokens cross-chain along with instructions on what the receiving smart contract should do with those tokens once they arrive on the destination chain. This revolutionary concept of wrapping value and instructions together allows tokenized value to interact automatically and dynamically once it arrives at a destination, opening up a world of new possibilities.

XPay Programmable Token Transfers enable to interact with smart contracts on other blockchain networks without needing to integrate or directly interact with that blockchain. All they need to do is send instructions to using XPay on how to interact with the selected blockchain smart contracts.


# XPay API Reference

This page describes XPay methods, components and types

## Components

### TxWidget

The `TxWidget` component offers the swap functionality embedded directly into your website as a widget without opening a modal. It’s ideal for seamless integration of cross-chain swaps on your site.

```tsx
<TxWidget
  integratorId="YOUR_INTEGRATOR_ID"
  dstChain="8453"
  dstToken="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
  defaultWalletPicker={true}
/>
```

**Parameters:** for the full list of properties check the [WidgetIntegrationPayload](#widgetintegrationpayload)&#x20;

### Usage of TxWidget as a Web Component

In addition to the React-based example, the `TxWidget` can also be embedded into any HTML page by including it as a web component using a simple `<script>` tag. This method is ideal for projects that are not using React or any other JavaScript framework and just need to add cross-chain swap functionality to their website.

#### Including the widget script

To include the widget as a web component, make sure to load the script using the following URL:

```javascript
<script src="https://unpkg.com/@xswap-link/sdk"></script>
```

#### HTML Example

Here’s an example of how to use the `TxWidget` as a web component within a plain HTML page:

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>XPay Widget Example</title>
  <script src="https://unpkg.com/@xswap-link/sdk"></script>
</head>
<body>
  <h1>XPay Cross-Chain Swap</h1>
  <xpay-widget
    integrator-id="YOUR_INTEGRATOR_ID"
    dst-chain="8453"
    dst-token="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
  ></xpay-widget>
</body>
</html>
```

**NOTE:** All parameter names passed to the web component widget must be in the **kebab-case** format, as shown in the examples above.

## Methods

### openTransactionModal

```typescript
const openTransactionModal = async (payload: ModalIntegrationPayload): Promise<void>
```

**Description**: This method opens an XPay modal for selecting tokens and communicating with the XSwap backend to get the routes and required transactions calldata to make the cross-chain transaction possible. The modal implements transaction execution by default.

For a detailed description of parameters check [ModalIntegrationPayload](#modalintegrationpayload)

**Example**:

```typescript
const transactions = await openTransactionModal({
      integratorId: "YOUR_INTEGRATOR_ID",
      dstChain: "8453", // Base
      dstToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c", // XSWAP Token
});
```

If needed, the modal will execute the approval for the user's tokens and send the cross-chain swap transaction. For a more detailed example please check the example project on [**Github** ](https://discord.com/invite/zkJneqksvM)

## Types

### WidgetIntegrationPayload

```typescript
type ModalIntegrationPayload = {
  integratorId: string;
  dstChain: string;
  dstToken: string;
  srcChain?: string;
  srcToken?: string;
  customContractCalls?: ContractCall[];
  desc?: string;
  dstDisplayToken?: string;
  lightTheme?: boolean;
  defaultWalletPicker?: boolean;
  styles?: string;
  dstTokenLocked?: boolean;
  dstChainLocked?: boolean;
  srcTokenLocked?: boolean;
  srcChainLocked?: boolean;
  bridge?: boolean;
  integratorFee?: number;
  integratorFeeReceiverAddress?: string;
};
```

Properties:

* `integratorId` (string): The ID of the integrator using the SDK. [**Apply Here**](https://forms.gle/Y6kh19Bghtayt6FZ7)
* `dstChain` (string, optional): The destination chain ID.
* `dstToken` (string, optional): The destination token address to which the user funds will be swapped.
* `srcChain` (string, optional): The source chain ID where the initial token swap will occur.
* `srcToken` (string, optional): The source token address that the user wishes to swap.
* `customContractCalls` (ContractCall\[], optional): An array of custom contract calls to be executed during the transaction on the destination chain after the swap.
* `desc` (string, optional): A description of the transaction displayed for the user.
* `lightTheme` (boolean, optional): If set to true, the modal will use a light theme interface.
* `defaultWalletPicker` (boolean, optional): When set to true, the SDK handles connecting SDK to user's wallet. Do not use this option if your app already can be connected to wallets.
* `styles` (string, optional): Custom styling options for the modal, provided as JSON string. These styles extend the base theme while allowing overrides for specific UI components. The structure of the styles should follow the same format as the `ModalIntegrationStyles` type.\
  You must pass the styles as a stringified object using `JSON.stringify()`.\
  Example usage:

  ```tsx
  styles={JSON.stringify({
    mainAccentLight: '#ff69b4',
  })}
  ```
* `dstTokenLocked`(boolean, optional): If true, the destination token cannot be changed.&#x20;
* `dstChainLocked`(boolean, optional): If true, the destination chain cannot be changed.
* <kbd>srcTokenLocked</kbd>(boolean, optional): If true, the source token cannot be changed.&#x20;
* <kbd>srcChainLocked</kbd>(boolean, optional):  If true, the source chain cannot be changed.
* <kbd>bridge</kbd> (boolean, optional): If true, enables bridge UI and enforces the bridge rules.
* <kbd>integratorFee</kbd> (number, optional): Fee percentage for the integrator in a range from 1 to 1000 where the max value of 1000 represents 1% fee.
* <kbd>integratorFeeReceiverAddress</kbd> (string, optional): Address to receive the integrator fee.

### ModalIntegrationPayload

```typescript
type ModalIntegrationPayload = {
  integratorId: string;
  dstChain: string;
  dstToken: string;
  srcChain?: string;
  srcToken?: string;
  customContractCalls?: ContractCall[];
  desc?: string;
  dstDisplayToken?: string;
  lightTheme?: boolean;
  defaultWalletPicker?: boolean;
  styles: ModalIntegrationStyles;
  dstTokenLocked?: boolean;
  dstChainLocked?: boolean;
  srcTokenLocked?: boolean;
  srcChainLocked?: boolean;
  bridge?: boolean;
  integratorFee?: number;
  integratorFeeReceiverAddress?: string;
};
```

**Properties**:

* `integratorId` (string): The ID of the integrator using the SDK. [**Apply Here**](https://forms.gle/Y6kh19Bghtayt6FZ7)
* `dstChain` (string, optional): The destination chain ID.
* `dstToken` (string, optional): The destination token address to which the user funds will be swapped.
* `srcChain` (string, optional): The source chain ID where the initial token swap will occur.
* `srcToken` (string, optional): The source token address that the user wishes to swap.
* `customContractCalls` (ContractCall\[], optional): An array of custom contract calls to be executed during the transaction on the destination chain after the swap.
* `desc` (string, optional): A description of the transaction displayed for the user.&#x20;
* `lightTheme` (boolean, optional): If set to true, the modal will use a light theme interface.
* `defaultWalletPicker` (boolean, optional): When set to true, the SDK handles connecting SDK to user's wallet. Do not use this option if your app already can be connected to wallets.
* `styles` (ModalIntegrationStyles, optional): Custom styling options for the modal. These styles extend the base theme while allowing overrides for specific UI components.
* `dstChainLocked`(boolean, optional): If true, the destination chain cannot be changed.
* <kbd>srcTokenLocked</kbd>(boolean, optional): If true, the source token cannot be changed.&#x20;
* <kbd>srcChainLocked</kbd>(boolean, optional):  If true, the source chain cannot be changed.
* <kbd>bridge</kbd> (boolean, optional): If true, enables bridge UI and enforces the bridge rules.
* <kbd>integratorFee</kbd> (number, optional): Fee percentage for the integrator in a range from 1 to 1000 where the max value of 1000 represents 1% fee.
* <kbd>integratorFeeReceiverAddress</kbd> (string, optional): Address to receive the integrator fee.

### ModalIntegrationStyles

```typescript
type ModalIntegrationStyles = {
    mainAccentLight?: string;
    mainAccentDark?: string;
    textSecondary?: string;
    width?: string;
}
```

Properties:

* `mainAccentLight` (string, optional): Defines the primary accent color used in the theme. This color is typically used for icons and accent backgrounds. The value should be provided in hex format.\
  *Example:* `"#3681C6"`
* `mainAccentDark` (string, optional): Supplementary accent color to create gradient color with `mainAccentLight`. If you prefer a single-color design, set this to the same value as `mainAccentLight`. The value should be provided in hex format.\
  *Example:* `"#2B4A9D"`
* `textSecondary` (string, optional): The color used for secondary text elements. It is recommended to align this color with `mainAccentLight` for visual consistency. The value should be provided in hex format.\
  *Example:* `"#3681C6"`
* `width` (string, optional) : Sets the width of the modal, allowing for responsive or fixed-width designs. The value should be a valid CSS width string.\
  *Example:* `"400px"`


# API v1 Reference

A minimal overview of our REST endpoints. Click any resource for full details.

### API v1 Reference

Base URL: [https://xswap.link/api/](https://xswap.link/api/{resource}/v1)

All query parameters are passed as a JSON payload in the `data` query parameter, URL-encoded.

***

### Resources

* [Route](/xswap/xpay/api-v1-reference/route) - POST */route/v1*
* [Chains](/xswap/xpay/api-v1-reference/chains) - GET */chains/v1*
* [Tokens](/xswap/xpay/api-v1-reference/tokens) - GET */tokens/v1*


# Route

The XSwap Route Generation API provides optimal cross-chain and single-chain swap routes with integrated bridging capabilities. This endpoint calculates the most efficient path for token swaps across supported blockchain networks.

***

### Endpoint

```http
POST https://xswap.link/api/route/v1
Content-Type: application/json
```

All query parameters are passed as a JSON payload in the `data` query parameter, URL-encoded.

***

### Authentication

All requests **must** include your registered `integratorId` in the JSON body.\
[Contact the XSwap team](<https://forms.gle/Y6kh19Bghtayt6FZ7&#xA;>) to obtain your credentials.

***

### Request

#### Required Parameters

| Field             | Type    | Description                                                                                                                                                                                    |
| ----------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `integratorId`    | string  | Your registered integrator ID                                                                                                                                                                  |
| `fromChain`       | string  | Source chain ID (e.g. `"1"`, `"137"`, `"42161"`)                                                                                                                                               |
| `toChain`         | string  | Destination chain ID (e.g. `"1"`, `"43114"`)                                                                                                                                                   |
| `fromToken`       | string  | Contract address of source token                                                                                                                                                               |
| `toToken`         | string  | Contract address of destination token                                                                                                                                                          |
| `fromAmount`      | string  | Amount in smallest unit (e.g. `"1000000000000000000"`)                                                                                                                                         |
| `fromAddress`     | string  | Wallet initiating the swap                                                                                                                                                                     |
| `toAddress`       | string  | Recipient address on destination chain                                                                                                                                                         |
| `paymentToken`    | string  | <p>Token used for paying cross-chain fees</p><blockquote><p><strong>Note:</strong> this field is only required in cross-chain transactions (<code>fromChain ≠ toChain</code>)</p></blockquote> |
| `slippage`        | number  | Max slippage % (e.g. `0.5` = 0.5%)                                                                                                                                                             |
| `expressDelivery` | boolean | Instant execution on destination (extra fee)                                                                                                                                                   |

#### Optional Parameters

| Field                          | Type    | Description                                                          |
| ------------------------------ | ------- | -------------------------------------------------------------------- |
| `infiniteApproval`             | boolean | Approve max uint256 allowance (default: `true`)                      |
| `integratorFeeReceiverAddress` | string  | <p>Address to receive</p><p><code>integratorFee</code></p>           |
| `integratorFee`                | number  | Extra fee in bps (1–10,000), requires `integratorFeeReceiverAddress` |

***

### Response

| Field                          | Type   | Description                                                      |
| ------------------------------ | ------ | ---------------------------------------------------------------- |
| `estAmountOut`                 | string | Estimated output amount in the destination token’s smallest unit |
| `minAmountOut`                 | string | Minimum guaranteed output after slippage                         |
| `transactions`                 | object | Contains transaction payloads (e.g., `swap`)                     |
| `transactions.swap.to`         | string | Target contract address for the swap                             |
| `transactions.swap.data`       | string | Encoded calldata for the swap                                    |
| `transactions.swap.value`      | string | ETH value to send with the transaction                           |
| `xSwapFees.ccipFee`            | string | Fee paid to the CCIP network                                     |
| `xSwapFees.xSwapFee.tokenFee`  | string | Fee paid in tokens                                               |
| `xSwapFees.xSwapFee.nativeFee` | string | Fee paid in native chain currency                                |
| `xSwapFees.expressDeliveryFee` | string | Additional fee if `expressDelivery` is enabled                   |

***

### Example Request

```javascript
;(async () => {
  const payload = {
    integratorId: "xxx",
    fromChain: "8453",
    toChain: "1",
    fromToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c",
    toToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c",
    fromAmount: "100000000000000000",
    fromAddress: "0x123...abc",
    toAddress: "0x123...abc",
    paymentToken: "0x0000000000000000000000000000000000000000",
    slippage: 1.5,
    expressDelivery: false,
  };

  const encoded = encodeURIComponent(JSON.stringify(payload));
  const url = `https://xswap.link/api/route/v1?data=${encoded}`;

  const res = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
  });

  if (!res.ok) {
    throw new Error(`HTTP ${res.status}: ${await res.text()}`);
  }

  const route = await res.json();
  console.log("Generated route:", route);
})();
```

### Example Response

```json
{
    "estAmountOut": "100000000000000000",
    "minAmountOut": "100000000000000000",
    "transactions": {
        "swap": {
            "to": "...",
            "data": "...",
            "value": "..."
        }
    },
    "xSwapFees": {
        "ccipFee": "1929371550307947",
        "xSwapFee": {
            "tokenFee": "0",
            "nativeFee": "246913580246913"
        },
        "expressDeliveryFee": "0"
    }
}
```


# Chains

The XSwap Chains Metadata API provides detailed information on supported blockchains - you can fetch all chains, filter by ecosystem, or retrieve a single chain by its ID.

***

### Endpoint

```http
GET https://xswap.link/api/chains/v1
Content-Type: application/json
```

All query parameters are passed as a JSON payload in the `data` query parameter, URL-encoded.

***

### Request

#### Required Parameters

| Field          | Type   | Description                   |
| -------------- | ------ | ----------------------------- |
| `integratorId` | string | Your registered integrator ID |

#### Optional Parameters

| Field       | Type      | Description                                                                                                          |
| ----------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
| `ecosystem` | string    | <p>Filter by ecosystem (e.g. "EVM").</p><blockquote><p>Currently only <code>EVM</code> is supported</p></blockquote> |
| `chainIds`  | string\[] | Chain IDs (e.g. `["1", "56"]`)                                                                                       |

***

### Response

The endpoint returns a JSON array of objects matching the model defined in the table below.

| Field                   | Type      | Description                                                       |
| ----------------------- | --------- | ----------------------------------------------------------------- |
| `ecosystem`             | string    | Chain ecosystem identifier (currently only "EVM" supported)       |
| `chainId`               | string    | Chain ID (e.g. `"1"`, `"56"`, `"137"`)                            |
| `name`                  | string    | Human-readable name (e.g. `"Ethereum"`)                           |
| `ccipChainId`           | number    | CCIP chain ID for cross-chain messaging                           |
| `tokenSymbol`           | string    | Native token symbol (e.g. `"ETH"`, `"MATIC"`)                     |
| `bridgeSupported`       | boolean   | `true` if cross-chain bridging is supported                       |
| `swapSupported`         | boolean   | `true` if single-chain swaps are supported                        |
| `supportedDstForBridge` | string\[] | List of chain IDs you can **bridge** **to** (e.g. `["56","137"]`) |
| `supportedDstForSwap`   | string\[] | List of chain IDs you can **swap** **to** (e.g. `["56","137"]`)   |

***

### Example Request

```javascript
;(async () => {
  const payload = {
    integratorId: "xxx"
  };

  const encoded = encodeURIComponent(JSON.stringify(payload));
  const url = `https://xswap.link/api/chains/v1?data=${encoded}`;

  const res = await fetch(url, {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  });
  const chains = await res.json();
  console.log("All chains:", chains);
})();
```

### Example Response

```json
[
    {
        "ecosystem": "evm",
        "chainId": "1",
        "name": "ethereum",
        "ccipChainId": "5009297550715157269",
        "tokenSymbol": "ETH",
        "bridgeSupported": true,
        "swapSupported": true,
        "supportedDstForBridge": ["42161", "592", ...],
        "supportedDstForSwap": ["1", "42161", ...]
    },
    {
        "ecosystem": "solana",
        "chainId": "mainnet-beta",
        "name": "solana",
        "ccipChainId": "124615329519749607",
        "tokenSymbol": "SOL",
        "bridgeSupported": true,
        "swapSupported": true,
        "supportedDstForBridge": ["56", "8453", ...],
        "supportedDstForSwap": ["mainnet-beta", ...]
    },
    ...
]
```


# Tokens

The XSwap Tokens API returns token metadata for a given chain—or a single token if you supply its address.

***

### Endpoint

```http
GET https://xswap.link/api/tokens/v1
Content-Type: application/json
```

All query parameters are passed as a JSON payload in the `data` query parameter, URL-encoded.

***

### Request

#### Required Parameters

| Name           | Type      | Description                    |
| -------------- | --------- | ------------------------------ |
| `integratorId` | string    | Your registered integrator ID  |
| `chainIds`     | string\[] | Chain IDs (e.g. `["1", "56"]`) |

#### Optional Parameters

| Name        | Type      | Description                                                                                                                 |
| ----------- | --------- | --------------------------------------------------------------------------------------------------------------------------- |
| `ecosystem` | string    | <p></p><p>Filter by ecosystem (e.g. "EVM").</p><blockquote><p>Currently only <code>EVM</code> is supported</p></blockquote> |
| `addresses` | string\[] | Token contract addresses                                                                                                    |

***

### Response

| Field      | Type   | Description                            |
| ---------- | ------ | -------------------------------------- |
| `address`  | string | Token contract address                 |
| `symbol`   | string | Token symbol (e.g. `"ETH"`)            |
| `name`     | string | Token name (e.g. `"Ether"`)            |
| `decimals` | number | Number of decimals                     |
| `image`    | string | URL to token’s rounded 64x64 webp logo |

***

### Example Requests

```javascript
;(async () => {
  const payload = {
    integratorId: "xxx"
    chainId: "1"
  };

  const encoded = encodeURIComponent(JSON.stringify(payload));
  const url = `https://xswap.link/api/tokens/v1?data=${encoded}`;

  const res = await fetch(url, {
    method: "GET",
    headers: { "Content-Type": "application/json" },
  });
  const tokens = await res.json();
  console.log("All tokens for given chainId:", tokens);
})();
```

### Example Response

```json
[
    {
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "decimals": 18,
        "name": "Ether",
        "image": "https://xswap.link/assets/tokens/1_0x0000000000000000000000000000000000000000_ETH.webp"
    },
    {
        "address": "0x8fe815417913a93ea99049fc0718ee1647a2a07c",
        "symbol": "XSWAP",
        "decimals": 18,
        "name": "XSWAP Token",
        "image": "https://xswap.link/assets/tokens/1_0x8fe815417913a93ea99049fc0718ee1647a2a07c_XSWAP.webp"
    },
    ...
]
```


# Usage Examples

This page is dedicated to example usages of the XPay.

Cross-chain Token Purchase

{% content-ref url="/pages/VGIYdaV5sjpy8wwu7Gl2" %}
[Cross-chain Token Purchase](/xswap/xpay/usage-examples/cross-chain-token-purchase)
{% endcontent-ref %}


# Cross-chain Token Purchase

This page describes the repository with an example of the cross-chain token purchase.

In this example, we will take a look at a simple project which can be found here: [**GitHub**](https://github.com/xswap-link/Cross-Chain-Token-Purchase)

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FUNlM75k0FqJZqYU4Nhhi%2Fimage.png?alt=media&amp;token=7b5606d1-8e65-48d6-bdb9-bc9345f2cb3f" alt=""><figcaption><p>Cross-chain Token Purchase</p></figcaption></figure>

## Overview

This application is extremely simple, to demonstrate how easy it is to integrate XPay. Assuming that the Dapp already has integration with the web3 wallet provider we will focus more on the XPay. For this example, the application is using RainboKit to connect the wallet. In the next section let's take a look at the XPay integration.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FHzuUE4Ll8BZQn10gPzeb%2Fezgif-5-d7ffb3f5d5.gif?alt=media&amp;token=597dac32-d9b2-4e11-9085-e26f2c45d948" alt=""><figcaption><p>Cross-chain Token Purchase Demo</p></figcaption></figure>

## Quick Start

To run the demo locally clone the repository, create a `.env` file by coping the `.env.sample`, and set the variables `VITE_INTEGRATOR_ID` (the framework requires the prefix VITE\_). If you don't have an integrator Id please [**Apply Here**](https://forms.gle/Y6kh19Bghtayt6FZ7)**.**

&#x20;Then using the npm package manager run the following command

```
npm install
```

After installing the dependencies start the dev server

```
npm run dev
```

## XPay Integration

In this demo, we use just one function from XPay, `openTransactionModal``.`

### openTransactionModal

Here is the function call from the project

```typescript
const transactions = await openTransactionModal({
  integratorId, // integrator Id from .env
  dstChain: "8453", // Base
  dstToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c", // XSWAP Token
});
```

Here we defined the `chain` and `token` that users will be able to buy as well as the `integratorId`. This function opens a modal for the user where they will be able to select the source chain and token for the transaction.&#x20;

Once the user approves the swap form, the modal will move to the execution view. The transactions contain optional approve and swap transactions which need to be signed by the user.&#x20;

After the swap transaction was confirmed on the source blockchain the cross-chain swap is in motion and we can monitor the transaction progress. Once the transaction is being delivered a notification will appear in the corner of the browser.

After the cross-chain message is delivered and executed the notification will change to green and disappear.&#x20;


# Usages with embedded widget

Embedded Swap using TxWidget with customization options

XPay Integration using TxWidget

This example demonstrates how to integrate swap functionality directly into your website using the `TxWidget` component. By embedding the widget, users can interact with the swap interface directly on the page without needing a modal pop-up. Here's an example of how the component is implemented within the project:

```tsx
<TxWidget
  integratorId="YOUR_INTEGRATOR_ID"
  dstChain="8453"
  dstToken="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
  defaultWalletPicker={true}
/>
```

\
**On-Page Chain and Token Selection**

Users can directly choose the source chain and token on the page. After confirming the transaction details, the component seamlessly manages transaction approval and execution.

#### **Wallet Connection Workflow:**

By default, the button displays "Connect wallet first," indicating that XPay expects the wallet to already be connected within the app. If an external provider is unavailable, you can set the `defaultWalletProvider` to `true`, allowing the widget to use a built-in wallet picker.

For example:

```tsx
<TxWidget
    integratorId="YOUR_INTEGRATOR_ID"
    dstChain="8453"
    dstToken="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
    defaultWalletPicker={true}
/>
```

When configured this way, the SDK handles connecting to user's wallet directly within the XPay interface. Do not use this option if your app already can be connected to wallets.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FDIsmIHvoGrmRK5Q7ejTp%2FScreen%20Recording%202024-08-16%20at%2013.22.40.gif?alt=media&amp;token=72b0a1ec-d5c9-4fc6-b208-e6be05528180" alt=""><figcaption><p>Connecting wallet within XPay interface</p></figcaption></figure>

#### Enabling light mode

For a more versatile user experience, you can switch the swap widget to a light theme by enabling the `lightMode` prop. This is useful if your website predominantly uses a light color scheme, ensuring a consistent look and feel.

To activate the light mode, simply include the `lightMode={true}` prop in your component configuration:

```tsx
<TxWidget
  integratorId="YOUR_INTEGRATOR_ID"
  dstChain="8453"
  dstToken="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
  lightMode={true}
/>
```

By setting `lightMode={true}`, the swap widget automatically transitions to a clean and bright design, offering a consistent user experience across your platform.

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2F1HxGgvV8FtMTk0ctivSr%2Fimage.png?alt=media&amp;token=eec4a6ad-de51-4729-96d1-69cae20a67d3" alt=""><figcaption><p>Light mode view</p></figcaption></figure>

#### Theme customization

In addition to enabling light mode, you can fully customize the appearance of the widget using the `styles` prop. The `styles` property allows you to pass a JSON string with custom styling options, following the same format as `ModalIntegrationStyles`. This gives you control over key UI elements such as colors and text styles.

For example:

```tsx
<TxWidget
  integratorId="YOUR_INTEGRATOR_ID"
  dstChain="8453"
  dstToken="0x8fe815417913a93ea99049fc0718ee1647a2a07c"
  styles={JSON.stringify({
    mainAccentLight: '#ff69b4',
    mainAccentDark: '#aa336a',
    textSecondary: '#ff69b4',
  })}
/>
```

<figure><img src="https://414195869-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8GfGlqN7HJqh4TgCZFv4%2Fuploads%2FG136i7owoYcfRtrU9ZBg%2Fimage.png?alt=media&amp;token=bc532e63-8ea4-47c2-b5c9-b0b9d88d7ef5" alt="" width="188"><figcaption><p>Customized widget theme</p></figcaption></figure>

In this example, the widget applies a  pink accent color and customizes the secondary text color to align with your branding. The structure of the `styles` object should match the `ModalIntegrationStyles` type.\
\
**Note:** When using `openTransactionModal`, the `styles` object does not need to be stringified. You can directly pass the styles as a standard object.\
For example:

```tsx
openTransactionModal({
  integratorId: "YOUR_INTEGRATOR_ID",
  dstChain: "8453",
  dstToken: "0x8fe815417913a93ea99049fc0718ee1647a2a07c",
  styles: {
    mainAccentLight: '#ff69b4',
    mainAccentDark: '#aa336a',
    textSecondary: '#ff69b4',
  }
});
```

#### Using Props Across `TxWidget` and `openTransactionModal`

The customization options, such as enabling light mode or setting the default wallet picker, are available across both the `TxWidget` component and the `openTransactionModal` function. This consistency allows you to seamlessly integrate the swap functionality in different ways based on your application’s needs.


# FAQ

This page is dedicated to the frequently asked question of XPay

### What if my token is not listed?

Contact our team by using the following [**form** ](https://docs.google.com/forms/d/e/1FAIpQLScGafCsO10LDZE6T-qrCAWnjPcLJwxgvH9Q1XpwwcjmAnvrCQ/viewform)

***

### Do I need integratorId?

Yes, to provide the highest standards we require each integrator to use a dedicated integratorId. Contact our team by using the following [**form** ](https://docs.google.com/forms/d/e/1FAIpQLScGafCsO10LDZE6T-qrCAWnjPcLJwxgvH9Q1XpwwcjmAnvrCQ/viewform)

***

### I have experienced some problems with the integration

To connect with our dev team please join our [discord ](https://discord.com/invite/zkJneqksvM)and start a ticket. This is the fastest way to receive support.

***


# Supported Blockchains

### Blockchains

* Ethereum
* Base
* Arbitrum
* Optimism
* Polygon
* Avalanche

Additional chains will gradually be added over time.


# Information

XSwap Website: <https://xswap.link/> \
XSwap Twitter: <https://twitter.com/xswap_link>\
CCIP Explorer: <https://ccip.chain.link/>


