# Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation This site has an agentic ask interface you may use to query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.gainzswap.xyz/index.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. --- # Welcome to GainzSwap Docs 🚀 GainzSwap is a decentralised exchange (DEX) designed for sustained liquidity within the EDU Chain ecosystem. It is community-driven and built for efficiency, security, and user-friendly interactions, GainzSwap enables users to swap tokens, provide liquidity, and earn rewards in a fully permissionless environment. Our mission is to simplify decentralised finance by providing an easy-to-use DEX that rewards active participation through **staking**, **governance**, and **referrals** — all while fuelling liquidity and adoption for real-world utility tokens. ### Why GainzSwap? * **Optimised for EDU Chain** – Tailored to support the ecosystem’s growth and liquidity. * **Fast & Low-Cost Transactions** – Leveraging the scalability of EDU Chain for smooth trading. * **Community-Driven** – Governance and incentives designed to benefit active participants. * **Referral Program** – Earn passive rewards by inviting your network to use GainzSwap. ### 🔗 Quick Links * **Website:** [gainzswap.xyz](https://gainzswap.xyz) * **Telegram Community:** [t.me/GainzSwap](https://t.me/gainzswap) * **Twitter (X):** [@GainzSwap](https://twitter.com/GainzSwap) ### 🧱 Built For the Future GainzSwap was part of the **Open Campus Incubator, Cohort One (OCI-1)**, building core DeFi infrastructure for on-chain education economies and beyond. Our roadmap includes cross-chain expansion, deeper token integrations, and improved governance tooling. *** Explore our documentation to understand how GainzSwap works, interact with smart contracts, and maximise your DeFi experience. ### Jump right in


Initial Launch Offering (ILO)	See how you can get liquidity support for your project's token	Screenshot 2025-04-15 at 11.05.37.png	Initial Liquidity Offering (ILO)
Swap Tokens	Explore our token swap feature	Screenshot 2025-03-05 at 13.19.08.png	Swap
Liquidity Staking	Learn how to earn rewards through staking liquidity	Screenshot 2025-03-05 at 13.27.41.png	Liquidity
Delegate $EDU	Learn how to earn Yuzu points	Screenshot 2025-03-05 at 13.29.38.png	Delegate $EDU

# Quick Start Welcome to **GainzSwap**, your entry point into the decentralised finance (DeFi) ecosystem on **EDU Chain**. This guide walks you through everything you need to get started, from setting up your wallet to making your first swap, earning through referrals, and more. *** #### 🧰 What You’ll Need Before you begin, here are the essentials: * **A Crypto Wallet**:\ Install [MetaMask](https://metamask.io/), [Trust Wallet](https://trustwallet.com/), or any compatible Web3 wallet. * **EDU Chain Network**:\ GainzSwap runs on EDU Chain. You’ll need to connect your wallet to this network.\ *Pro tip: If it's not automatically detected, you'll be prompted to add it.* * **Some $EDU Tokens**:\ These are required for swaps, staking, and paying transaction fees. You can get started by claiming [free tokens via our faucet](/mainnet-faucet) (details below). *** #### 🔗 Connect Your Wallet 1. Visit [**gainzswap.xyz**](https://gainzswap.xyz) 2. Click **“Connect Wallet”,** following the screenshot below. ![](https://2562436502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtUcdfluVvReSkuKrvvp%2Fuploads%2FoqYbe4WiwV5rN0Ow88wu%2Fconnect-wallet.png?alt=media\&token=4ad3ab6e-5196-4e3b-8642-f2ee47b919ef) 1. Approve the connection request in your wallet popup. 2. Ensure you’re on the **EDU Chain** network. *** #### 💱 Swap Tokens GainzSwap allows you to easily swap between any supported tokens. **Steps to swap:** 1. Navigate to the **Swap** section. 2. Choose the token you want to swap **from** and the one you want to receive. 3. Enter the amount. 4. Review slippage and expected output. 5. Click **Swap Now**, then confirm the transaction in your wallet. *💡 Fees are minimal, and swaps are processed instantly thanks to EDU Chain’s speed.* *** #### 💧 Stake Liquidity Provide liquidity to earn a share of trading fees and potential rewards. **Steps to add liquidity:** 1. Go to the **Liquidity Staking** tab. 2. Select a token pair (e.g., $EDU / $GAINZ). 3. Enter the amounts for both tokens. 4. Approve and confirm the transaction. *💡 Liquidity providers earn GTokens representing their pool share and governance rights. These can be optionally locked or withdrawn anytime.* *** #### 🧑‍🏫 Delegate $EDU This is our extended solution to allow staking $EDU while support liquidity growth on GainzSwap. **Steps to delegate:** 1. Visit the **Delegate $EDU** tab. 2. Enter the amount of $EDU to delegate. 3. Click **Delegate**, then approve the transaction. *💡 You’ll receive Gainz points every second based on your delegation, which can be eventually redeemed for $EDU tokens.* *** #### 🧴 Claim Free Tokens (Faucet) To help you get started, we offer a **mainnet faucet**. **How to claim:** 1. Go to the **Faucet** page. 2. Click **“Claim”** and confirm the transaction. 💡 Want more tokens? Share your **referral link**! When someone claims using your link, you both receive bonus faucet tokens. ***Note:** Your wallet address must be whitelisted on the telegram group* *** #### 📣 Refer and Earn Invite others and earn rewards every time they interact with GainzSwap. **How it works:** 1. Make your first swap on GainzSwap 2. Copy your generated on-chain referral link. 3. Share it with friends, communities, and on social media. 4. Earn referral rewards when they perform actions like swapping, staking or claiming the faucet. *💡 The more active your referrals, the higher your rewards. You get rewards even from the referrals of your referral.* *** #### 🚀 Launchpads and ILOs Participate in new token launches through **Initial Liquidity Offerings (ILO)**. * Discover promising new projects * Commit $EDU or other tokens during ILO rounds * Receive project tokens and GTokens at launch *** #### ✅ You’re Ready! Now that you’re all set, you can start: * Swapping tokens * Earning rewards by providing liquidity * Delegating $EDU to help boost liquidity * Growing your wallet through referrals Be sure to check other parts of the documentation for advanced features and FAQs. # Mainnet Faucet # Swap ## # Liquidity ## # Delegate $EDU # Initial Liquidity Offering (ILO) The GainzSwap **Initial Liquidity Offering (ILO)** is a fair and community-driven method for listing tokens on GainzSwap with deep, sustained liquidity from day one. We help project teams bootstrap liquidity in a transparent and effective way, while giving users early access to promising tokens — all without private sales or VC allocations. *** ### 🚀 What Is an ILO? An ILO is a decentralised token launch model where: * A project contributes a portion of their token supply * Users contribute accepted tokens (like $GAINZ or $EDU) * After the offering ends, both sides are **paired into a liquidity pool** on GainzSwap The result? Immediate trading, price discovery, and zero rug-pull risk. *** ### 💡 Why Use GainzSwap ILO? For Projects: * Launch with guaranteed liquidity * Community-driven price discovery For Participants: * Early access to new tokens * Transparent and permissionless launch process * Guaranteed listing post-campaign > Unlike traditional IDOs, the liquidity from ILO is locked at launch, preventing early dumps or rug pulls. ILO participants receive GTokens, hence allowing them participate in GainzSwap's and partner governance *** ### 🧾 How It Works 1. **Create an ILO campaign** * Projects submit details (token address, total allocation, soft/hard caps, duration) ![](https://2562436502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtUcdfluVvReSkuKrvvp%2Fuploads%2FFbDIpyVq71fXfvxliLVI%2Filo-form.png?alt=media\&token=18718730-7335-45b5-8e3f-402ad800b1bd) 2. **Users participate** * Contribute accepted token (e.g., $EDU) to the ILO pool ![](https://2562436502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbtUcdfluVvReSkuKrvvp%2Fuploads%2Fbu3PwSG2yzwc6y7QMdAQ%2Filo-contribute.png?alt=media\&token=1cfea5c1-4faf-49f1-a72f-4379f598be0c) 3. **Offering ends** * Tokens and accepted tokens are automatically paired as liquidity * Liquidity is locked for a set period (e.g., 6 months) 4. **Participants receive GTokens** * You can participate in governance and receive rewards *** ### 🪄 Want to Launch Your Token? We welcome early-stage projects aligned with DeFi, GameFi, RWA, and more. If you’re ready to launch an ILO, [contact us on telegram](https:t.me/GainzSwap) for further guidance and marketing support. *** > *Level the playing field. Launch with trust. Join the next ILO on GainzSwap.* # Referrals ## # Token Types in GainzSwap The GainzSwap protocol leverages a unique token system designed to power its ecosystem of decentralised trading, liquidity provisioning, and governance. Three primary tokens serve distinct but interconnected roles within the platform: *** ## 1. **$dEDU** – Delegated EDU $dEDU is the delegated, GainzSwap-native representation of $EDU, enabling users to delegate their $EDU staking while remaining active participants in the protocol. While still earning Yuzu rewards, $dEDU holders: * **Help grow protocol liquidity**, and * **Unlock deeper integration** across GainzSwap, including swapping and governance influence. Swaps involving EDU are settled in $dEDU, and withdrawals back to $EDU are available with a \~2-day unbonding period. *** ## 2. **$Gainz** – Native Protocol Token $Gainz is the lifeblood of GainzSwap, serving as the native utility and incentive token: * Distributed primarily to **GToken holders** as farming rewards * Capped at **21 million tokens** total supply * Used for **paying swap fees**, which are **burned**, reducing circulating supply * Grants **governance power** when staked indirectly through liquidity pools The tokenomics also allocates portions to team, growth initiatives, and ecosystem incentives, ensuring long-term protocol sustainability. *** ## 3. **GToken** – Staked Liquidity Representation GToken is a **semi-fungible token (SFT)** that represents staked LP positions on GainzSwap. It encodes both: * The amount of liquidity provided * The **yield-bearing** position status including lockup duration and value GToken holders receive $Gainz emissions and can optionally **lock their GTokens** for enhanced rewards. Locked positions can be unlocked at any time, but **early unlocks may incur penalties**. Future use cases include **governance staking**, **collateralisation**, and cross-platform integrations within the EDU Chain ecosystem.


Learn more about $dEDU	$dEDU Token	dEDU.svg	$dEDU Token
Learn more about $Gainz	$GAINZ Token	Gainz.svg	$GAINZ Token
Learn more about GToken	GToken	4056.png	GToken

# $dEDU Token $dEDU is the delegated version of $EDU exclusively created on the GainzSwap protocol. It’s not just another token—it’s the conduit that enables you to delegate your $EDU and actively contribute to the platform’s liquidity, participate in Initial Liquidity Offerings (ILOs), and earn Gainz points over time. By converting, or engaging in activities that converts your $EDU to $dEDU, you become an integral part of a system that ensures sustained liquidity for the entire EDU Chain ecosystem. *** ## **Key Benefits of Holding $dEDU** * **Boost Protocol Liquidity:**\ Your $dEDU holdings are indirectly used to reinforce the liquidity on GainzSwap, through Yuzu points farming. This ensures protocol growth and sustained liquidity, benefiting every trader, liquidity provider and project tokens on the platform. * **Earn Gainz Points Through Activity:**\ Whether you convert your $EDU to $dEDU or engage in related activities, you earn Gainz points. These points reward your participation and can unlock exclusive opportunities and Yuzu points as you interact with the protocol. * **Streamlined Swaps:**\ All swaps that involve $EDU are settled in $dEDU. This mechanism ensures that your trading experience is both seamless and efficient, while ensuring sustained liquidity on the protocol. * **Flexible ILO Participation:**\ Not only can $dEDU be used directly for participation in ILOs, but even $EDU can be used for that purpose. This flexibility ensures you have multiple pathways to join new token launches and special events on GainzSwap. * **ERC20 Compatibility:**\ As an ERC20 token, $dEDU is fully fungible and transferable across the ecosystem. This means you can easily move your tokens, trade them, or use them as part of other engagements in the entire ecosystem. *** ## **Understanding the Unbonding Process** When it’s time to revert your $dEDU back to $EDU, you’ll experience an unbonding period of approximately 2 days. Here’s why this short wait is a boon for the entire ecosystem: * **Ensuring Liquidity Stability:**\ The unbonding period helps prevent sudden liquidity drains, ensuring that there’s always enough depth in the pools to support smooth trading. This safeguard stabilizes the market and enhances the overall performance of the protocol. * **Protecting the Ecosystem:**\ By implementing a brief wait, we protect against rapid, destabilizing transactions that could harm both the protocol and its users. This measured approach keeps the system robust and secure for long-term growth. * **A Commitment to Quality:**\ The delay isn’t a drawback—it’s a strategic feature. It reinforces our commitment to maintain a healthy, dynamic ecosystem where every action is balanced against the needs of the community. *** ## **How $dEDU Enhances Your GainzSwap Experience** When you convert your $EDU to $dEDU, you’re contributing to much more than your personal portfolio. Here’s how your participation impacts the broader community: * **Liquidity Growth:**\ The total supply of $dEDU is a critical factor in determining the emission rate of $GAINZ tokens, which are distributed to GToken holders (liquidity stakers). In essence, the more $dEDU in circulation, the stronger and more attractive our liquidity pools become. * **Community-Driven Value:**\ $dEDU is designed to empower you as a community member. It creates a direct link between personal participation and the overall health of GainzSwap. Every value of $dEDU reinforces the protocol, drives rewards, and paves the way for future innovations. *** **Ready to Get Started?** Embrace $dEDU as your active role in powering the GainzSwap ecosystem. By converting your $EDU and engaging with $dEDU, you’re not only optimizing your trading experience—you’re also contributing to a healthier, more dynamic decentralized platform. **Join the movement. Enhance liquidity, earn Gainz points, and unlock exclusive opportunities with $dEDU on GainzSwap.** # $GAINZ Token $Gainz is the **native reward and bootstrap liquidity** token for GainzSwap — a critical component in aligning incentives, facilitating governance, and ensuring sustainable growth within the EDU Chain ecosystem. The total supply is **21,000,000 $Gainz**, with a carefully designed emission schedule that decreases over time. ## Overview * **Token Name:** $Gainz * **Total Supply:** 21,000,000 * **Emission Model:** Deflationary, distributed primarily to liquidity stakers (via GToken). * **Key Utilities:** * Protocol Fees Payment (buy & burn mechanism) * Governance rights (when staked via liquidity pools / GToken) * Security deposit for projects ILOs (via GToken) * Incentivizing liquidity, user engagement, bounties, and quests ## Distribution Breakdown

### Primary Allocation of 21 Million $Gainz The total mint of **21 000 000 $Gainz** is split into four main buckets. The **Ecosystem Distribution** (65%) is held in the $Gainz token contract and programmatically allocated according to the rules below.

Category	% of Total	Amount (Tokens)	Notes
Ecosystem Distribution	65%	13 650 000	Held in‑contract and emitted per protocol rules
Liquidity Incentive	18%	3 780 000	Stablecoin or $EDU pool(s) to bootstrap new and critical pairs with $Gainz token
Public Sale	7%	1 470 000	Strategic community sale for Council SFTs (council members)
Strategic Investments	10%	2 100 000	Partnerships, grants, ecosystem expansion
Protocol & Core Team	—	(see Ecosystem)	Allocated from Ecosystem Distribution through a decay function

### Ecosystem Distribution (13 650 000 $Gainz) This 65% tranche is controlled by the $Gainz token contract and dispensed automatically through a decay function:

Sub‑Category	% of Ecosystem	Amount (Tokens)	Mechanism
Staking Rewards	70%	9 555 000	Emitted to GToken holders, throttled by real‑time $dEDU supply (see below)
Liquidity Incentives	15%	2 047 500	Bootstrap liquidity for external projects’ pools and select pair incentives
Bounties, Airdrops & Quests	5%	682 500	Community engagement, marketing campaigns, and special event rewards
Team & Protocol	10%	1 365 000	Emitted following the decay function.

### **Staking Rewards Throttled by $dEDU Supply** * The **Staking Rewards** pool (9 555 000 $Gainz) is distributed to GToken holders (liquidity stakers). * However, the **actual emission rate** at any given time is **dependent on the circulating supply of $dEDU**, as enforced by the Governance contract via the $dEDU contract. * **More $dEDU → higher staking emissions**; **less $dEDU → lower emissions**, ensuring that rewards scale with community participation and liquidity growth. ### How It Works in Practice 1. **Upfront Allocations**\ All allocations, except **Ecosystem Distribution**, are distributed and held in separate addresses pending when they will be used for their purpose. 2. **Ecosystem Distribution Lockup**\ All 13.65 M tokens reside in the $Gainz contract. They are not released upfront but emitted per the above schedule. 3. **Automated Emissions** * **Staking rewards** flow to GToken balances each second, dynamically adjusted by the on‑chain $dEDU supply. * **Liquidity incentives**, **bounties**, and **team** are released based on the decay function following certain milestone triggers. 4. **Supply Cap & Deflation**\ Once the 21 M cap is reached, no new $Gainz can be emitted. Meanwhile, protocol fees are used to **supply the decay function**, creating a sustainable ecosystem tokens distribution. This two‑tiered distribution model aligns long‑term value accrual with active community participation, rewarding those who stake, delegate (via $dEDU), and contribute to GainzSwap’s liquidity and governance. ## Utility & Governance ### Governance * **Staking $Gainz via GToken:**\ Liquidity providers who stake their LP tokens receive **GToken**, which entitles them to governance rights. Because $Gainz is distributed to GToken holders, it indirectly grants greater say in protocol proposals to those most invested in the ecosystem. * **ILO Listings**\ Only GTokens having $Gainz liquidity pools can be used as security deposits for creating ILO listings. Though all tokens listed on GainzSwap becomes governance tokens through GToken, only $Gainz will have the power to influence new token listings. * **Protocol Upgrades & Decisions:**\ Future on-chain voting mechanisms may use staked $Gainz (or GToken) balances to determine voting power, enabling a **community-centric decision process**. ### Protocol Fees & Buy-Burn * **Swap Fee Payments in $Gainz:**\ A portion (or all) of the fees collected from trading on GainzSwap are used to **purchase and burn $Gainz**, creating a **deflationary pressure** that benefits long-term holders. * **Long-Term Sustainability:**\ This buy-and-burn model aligns platform growth with token value, reducing sell pressure and fostering a more balanced supply-demand dynamic. ### Incentives & Rewards * **Liquidity Mining:**\ Stakers of GToken (which represents locked LP tokens) receive $Gainz emissions proportionate to their share. * **Bootstrap Liquidity**\ To foster ecosystem wide growth, GainzSwap will support projects, through governance, with liquidity allocation from token distribution (see Ecosystem Distribution above) * **Bounties, Airdrops, & Quests:**\ A percentage of $Gainz is reserved for marketing, development bounties, and quest-based user engagement. This encourages active participation and user-driven innovation. *** ## Putting It All Together $Gainz is engineered to: 1. **Reward Positive Action:** Users who contribute liquidity or engage with the protocol can earn $Gainz, creating a virtuous cycle of expansion. 2. **Empower Governance:** $Gainz fosters a community-led environment where those contributing the most hold the most influence. 3. **Protect Long-Term Value:** Through daily emission reductions and a robust buy-and-burn mechanism, the protocol safeguards against uncontrolled inflation. 4. **Expand the EDU Chain Ecosystem:** A portion of $Gainz is dedicated to partnerships, bounties, and quests, driving growth beyond just GainzSwap. Whether you’re a liquidity provider, a project partner, or simply a trader intrigued by the potential of DeFi on the EDU Chain ecosystem, $Gainz offers both **tangible incentives** and **long-term strategic value**. By aligning rewards with contributions, $Gainz ensures that GainzSwap’s community and token holders thrive together — laying a strong foundation for the future of decentralised finance on EDU Chain. # GToken **GToken** is the core **staking and governance token** of the GainzSwap ecosystem. It is not minted directly but rather **derived** from locking LP tokens in the protocol’s governance staking contract. GToken holders represent the **most committed liquidity providers**, as they lock capital and earn long-term influence — they are the true Gainerz.

*** ## How GToken Works | Feature | Details | | --------------------- | ----------------------------------------------------------------------------------------------------- | | **Minting** | GToken is **created by optionally locking LP tokens** in the Governance contract | | **Burning** | GToken is **burned** when LP tokens are unstaked | | **Semi-Fungible** | GToken is **transferable,** and can be merged or split | | **Governance Rights** | Holders **vote on proposals**, including token listings and upgrades | | **Staking Rewards** | GToken holders receive **$Gainz staking rewards**, **throttled** by $dEDU supply | | **Vote Weight** | The amount and number of epochs locked of GToken a user holds directly **affects their voting power** | *** ## Entry & Exit Governance Conditions | Action | Requirement | Result | | --------- | -------------------------------------------------------- | -------------------------------------------------------------------------- | | **Enter** | Stake liquidity by optionally locking LP tokens | Receive GToken encoded with appropriate attributes | | **Exit** | Unstake liquidity by burning GToken, and hence LP tokens | Retrieve corresponding LP pair tokens, with upto 30% loss if early unstake | *** ## Role in Governance * **Proposal Access:**\ Only users holding GToken, with specific attributes, can propose new pair listings or protocol upgrades. * **Voting Power:**\ GToken holders cast votes weighted by their GToken balances and epochs locked. For sensitive proposals (e.g., protocol fees, council elections), **GToken** is the exclusive mechanism of decision-making. * **Incentive Alignment:**\ Since GToken requires LP locking, it ensures governance participants are **economically aligned** with the platform’s long-term success. *** ## Staking Rewards Emission * Rewards come from the **Staking Rewards** pool (9.55 M $Gainz). * However, actual emission is **dynamically throttled** based on the **$dEDU circulating supply** (delegated governance participation). * This creates a three-way balance: * LP Token Holders → stake and mint GToken * GToken Holders → earn rewards, vote * $dEDU Holders → throttle how fast rewards flow This system ensures that not just capital (via LP tokens), but also **community trust and reputation** (via delegation) plays a role in reward distribution. ####