# WolfSwap — Complete Documentation

> WolfSwap is a decentralized trading platform and DEX aggregator on the Cronos blockchain. It aggregates liquidity from all major Cronos DEXs to deliver the best swap rates, lowest slippage, and most reliable trade execution. Built by MOONFLOW CLUB S.R.L., a Romanian-registered company. Community-first, no-VC project.

---

# What is WolfSwap

WolfSwap is a decentralized trading platform built on the Cronos blockchain, designed to deliver deep liquidity, low slippage, and reliable trade execution for Web3 users.

By aggregating liquidity across multiple leading Cronos decentralized exchanges, WolfSwap provides access to the largest combined liquidity available on Cronos, enabling efficient routing, tighter price impact, and consistent execution across both small and large trades.

## Liquidity Sources

WolfSwap sources liquidity from established Cronos protocols including:
- VVS Finance
- MM Finance
- Ferro Protocol
- Fulcrom
- Obsidian
- CroDex
- Additional Cronos-native and cross-protocol liquidity pools

## Core Capabilities

- Deepest aggregated liquidity on Cronos through multi-DEX routing
- Low-slippage trade execution, even for larger order sizes
- Fast and frictionless trading via an optimized user-friendly interface
- Security-first architecture designed to protect users and smart contracts
- Advanced trading tools for precision, automation, and strategy execution

## Planned Features

- Universal Token Trading (Aggregator DEX)
- Streamlined Token Whitelisting
- Limit Orders on Cronos
- Dollar-Cost Averaging (DCA) Module
- AI-Powered Token Contract Scanner
- Portfolio Tracking & Analytics
- Time-Weighted Automated Trading Strategies
- DeFi Portfolio Management

---

# Token Swap — Best DEX Trading on Cronos

WolfSwap's token swap scans all Cronos decentralized exchanges — including VVS Finance, MM Finance, Ferro Protocol, Fulcrom, Obsidian, and CroDex — to find the best rate for every trade automatically.

## How to Swap

1. Connect your wallet (MetaMask, Rabby, or any EVM-compatible wallet)
2. Select your tokens — choose the token to sell (PAY) and to buy (RECEIVE)
3. Enter the amount — USD value displays below each field
4. Review the quote — rate, price impact, estimated gas fee
5. Confirm the swap — tokens arrive in seconds

## Importing Custom Tokens

Paste a contract address in the token dropdown search field and click Import. Always verify contract addresses from official sources.

## Popular Cronos Tokens

- CRO — Native gas and staking token of Cronos
- USDC — Leading stablecoin
- $PACK — WolfSwap's ecosystem utility token backed by platform revenue
- LION — Popular Cronos community token
- CAW — Widely held multi-chain community token

## Auto Slippage

Auto Slippage dynamically calculates optimal slippage tolerance based on market volatility, token liquidity depth, and trade size. Recommended for most users.

Manual slippage ranges:
- 0.1–0.5% for stablecoin pairs
- 0.5–1% for major tokens
- 1–5% for newer or low-liquidity tokens

## Turbo Mode

Anti-MEV feature that submits transactions in a way that makes it harder for bots to exploit through sandwich attacks and front-running.

## Price Impact

WolfSwap minimizes price impact by splitting orders across multiple DEXs and routing through intermediary tokens when a direct path isn't optimal. Prices auto-refresh every 5 seconds.

---

# $PACK Token — Revenue-Backed Utility Token on Cronos

$PACK is the native utility token of WolfSwap on Cronos blockchain. 50% of all WolfSwap trading fees are used to buy back $PACK weekly.

## Token Details

- Token name: PACK
- Blockchain: Cronos (Chain ID: 25)
- Contract address: 0x0d0b4a6fc6e7f5635c2ff38de75af2e96d6d6804
- Decimals: 18
- Primary pair: $PACK / CRO
- Revenue allocation: 50% of all WolfSwap fees
- Buyback frequency: Weekly

## Revenue-Backed Buybacks

1. WolfSwap collects trading fees from every swap
2. 50% goes to $PACK buybacks on the open market
3. Buybacks happen weekly with full transparency
4. Every buyback transaction is public on the Cronos block explorer

## $PACK Utility

- Staking & Fee Sharing — Stake $PACK to earn a share of platform fees
- Wolfies NFT Backing (WOL) — $PACK is paired with $CRO to back every Wolfie NFT
- Amplify Social Rewards — Earn $PACK through social content creation
- Compoundr Vaults — $PACK LP pairs available for auto-compounding yield
- Trading Contest Prizes — Distributed as prizes in competitions

## Emissions & Supply

- Up to 20% annual emissions for 5 years to fund ecosystem growth
- After 5 years, $PACK becomes fixed-supply
- Offset by weekly buybacks from platform revenue

---

# Cross-Chain Bridge — Bridge & Swap in One Step

WolfSwap integrates bridging directly into the swap interface. Bridge and swap tokens in a single transaction.

## Supported Chains

- Cronos (home chain)
- Ethereum
- Polygon
- Base
- Blast
- Linea
- Abstract
- zkCronos
- Avalanche
- BSC
- Chilliz

## Supported Tokens

ETH/WETH, USDC/USDT, DAI, WBTC/BTC, CRO/WCRO, POL, and additional tokens depending on chain liquidity.

## How to Bridge

1. Go to the swap page and click Bridge tab
2. Select source chain and token
3. Select destination chain and token
4. Enter the amount
5. Review and confirm

## Fees

- Standard gas fee on source chain
- Bridge protocol fees (displayed before confirmation)
- No WolfSwap markup on bridge costs
- Most bridges complete in 1–5 minutes

---

# Token Launcher — Launch Tokens with Zero Liquidity

Launch tokens on Cronos with zero upfront liquidity using a bonding curve model (similar to pump.fun). Tokens are instantly tradeable upon creation.

## How It Works

1. Create Your Token — Set name, symbol, description, image, social links, graduation target, target DEX
2. Token Goes Live — Instantly tradeable on the bonding curve
3. Community Trades — Price rises as more people buy
4. Token Graduates — When reserve and volume targets are met, migrates to a real DEX pool (VVS Finance, Chronos, etc.)

Every token launches with a fixed supply of 1 billion tokens.

## Bonding Curve

- Starts at a low price, rises with each buy
- No pre-sales, no rug pulls (liquidity locked in contract)
- Transparent on-chain pricing

## Hyped Launch (Anti-Snipe)

- 10x creation fee
- Buy limits enforced in early blocks
- Prevents bot sniping

## Supported Chains

Cronos, Abstract, zkCronos, Polygon, Base, Blast, Linea, Ethereum.

---

# Compoundr Vaults — Auto-Compounding Yield Optimizer

Set-and-forget DeFi vault system that auto-compounds LP farming rewards every 30 minutes (48 times per day).

## How It Works

1. Harvest — Collects pending farming rewards from underlying DEX
2. Swap — Converts rewards back into LP pair tokens
3. Re-add Liquidity — Creates more LP tokens
4. Reinvest — Deposits new LP tokens back into the farm

## Fees

- Deposit fee: 0%
- Withdrawal fee: 0%
- Performance fee: Small percentage of harvested rewards (already deducted from displayed APY)

## Supported Platforms

### Cronos
- VVS Finance
- Ebisus Bay
- H2 Finance
- Marswap

### Other Chains
zkCronos, Polygon, Base, Blast, Linea, Abstract, Ethereum.

## Risk Levels

- Level 1: Blue-chip pairs with deep liquidity
- Level 2–3: Established pairs with moderate liquidity
- Level 4–5: Newer or smaller pairs with higher yield but more risk

---

# Staking — Stake $PACK & Partner Tokens

Earn yield by depositing $PACK or partner project tokens into on-chain staking pools.

## Pool Types

### Core Pools
- Operated by WolfSwap, powered by platform revenue
- Stake $PACK → Earn $PACK
- APR tied to platform usage

### Community Pools
- Created and managed by partner projects
- WolfSwap provides infrastructure only
- No endorsement implied

## Features

- Fixed APR, hourly rewards, or dynamic APR models
- Lock periods with early withdrawal fees (some pools)
- NFT Boosters — stake eligible NFTs to increase APR
- Multi-chain support: Cronos, zkCronos, Polygon, Base, Blast, Linea, Abstract, Ethereum

---

# Wolfies NFTs — First Revenue-Backed NFTs on Cronos

5,212 unique NFTs on Cronos, backed by real on-chain DEX liquidity ($PACK-$CRO LP tokens) through Wolfies Owned Liquidity (WOL).

## Collection Details

- Blockchain: Cronos
- Token Standard: ERC-721
- Total Supply: 5,212
- Contract Address: 0x719FDfb0ba006747A83438cc8900c8a2b35e0afF
- Traits: Background, Skin, Mouth, Eyes, Clothes, Accessories
- Backing: $PACK-$CRO LP (Wolfies Owned Liquidity)
- Burn Contract: 0x23c02d4882ba6d39567d9868F2771684B516EA55

## What Makes Wolfies Different

- Revenue-backed — Platform revenue flows into $PACK buybacks that grow the WOL reserve
- Floor only goes up — LP backing per Wolfie increases as revenue accumulates
- Burn for rewards — Burn your Wolfie to claim $PACK and partner token rewards
- Trait-gated perks — Exclusive benefits unlocked by specific traits
- Limited supply — Only 5,212 will ever exist

## Burning

Burn a Wolfie to claim on-chain token rewards from the WOL reserve. Burns permanently remove the NFT from circulation, increasing per-Wolfie backing for remaining holders.

## Perks

Holders unlock exclusive perks based on traits. Perks rotate every 3 months: trading fee discounts, exclusive access, partner rewards.

## Staking

Wolfies can be staked on Ebisus Bay, Minted, Ryoshi, Forest, and as Earn Boosters.

## Marketplaces

Available on Ebisus Bay, Minted, and Crypto.com NFT.

---

# Wolfies Owned Liquidity (WOL)

WOL replaces single-token NFT backing with $PACK-$CRO LP token backing. LP tokens represent paired DEX liquidity, so the backing can never go to zero.

## How WOL Works

1. WolfSwap generates revenue from swap fees, launch fees, and platform activity
2. Revenue is used to buy $PACK weekly
3. $PACK is paired with $CRO to create LP tokens
4. LP tokens enter the WOL reserve
5. Per-Wolfie backing increases

## Key Properties

- LP tokens always retain value from both sides of the pair
- LP tokens earn trading fees passively
- LP provides actual DEX trading liquidity for $PACK
- Grows from buybacks AND trading fees

## WOL Wallet

0x72aea18e031C15f1ab9180820DFF5222191Ea30B (publicly verifiable on Cronos block explorer)

## Launch Stats

- 90 million $PACK tokens migrated from previous backing
- ~$18,000 committed by team to pair with $PACK
- Initial WOL value: ~$40,800

---

# Amplify — SocialFi Rewards on Cronos

Earn AWOO and PACK tokens by creating social content about the Cronos ecosystem.

## How It Works

1. Connect Twitter/X account to WolfSwap
2. Create content about Cronos, WolfSwap, DeFi
3. Submit tweet link on Amplify page
4. Earn points from engagement (impressions, likes, retweets, comments, bookmarks)
5. Claim AWOO and PACK token rewards

## Seasons & Leaderboard

- Fixed-period seasons with point resets
- Leaderboard rankings by engagement points
- Bonus rewards for top performers

## Missions

Specific tasks for bonus points: topic-specific tweets, partner engagement, milestone goals.

---

# Trading Contests — Compete & Win Prizes

Time-limited, token-specific competitions where traders earn points for swapping.

## How It Works

1. Browse active contests on the Leaderboard page
2. Click Participate — pre-loads contest token on swap page
3. Trade to earn points (buys typically 2x, sells 1x)
4. Win token prizes based on final leaderboard position

## Seasonal Leaderboards

- Every swap during a season earns points
- Top 100 traders win prizes each season
- Multi-chain support

## For Projects

Teams can host contests by submitting a ticket on Discord. Prizes must be provided by the sponsoring project.

---

# Mystery Boxes — Win Prizes When You Swap

Every swap over $10 USD gives a chance to win a mystery box with token or NFT prizes worth up to $1,000.

## How It Works

1. Swap on WolfSwap ($10+ value)
2. Automatic win check after swap confirms
3. Mystery box animation if you win
4. Claim prizes in your profile

## Prize Types

- Token prizes: USDC, WETH, ecosystem tokens
- NFT prizes from WolfSwap and partners

---

# How to Trade on Cronos

## Why Cronos?

- Low fees: sub-$0.01 per transaction
- Fast: 500ms block times
- Deep DeFi ecosystem
- EVM compatible (use MetaMask)
- Crypto.com ecosystem: 150M+ users

## Getting Started

1. Set up wallet (MetaMask, Crypto.com Onchain Wallet, or Rabby)
2. Add Cronos network (RPC: https://evm.cronos.org, Chain ID: 25)
3. Fund with CRO for gas
4. Connect to wolfswap.app
5. Swap tokens

## DEX Aggregator Advantage

WolfSwap scans all Cronos DEXs simultaneously, splits orders across pools, routes through intermediary tokens, and reduces slippage by tapping into deepest available liquidity.

---

# WolfSwap Partners API

REST API for developers to integrate DEX aggregation into dApps.

## Flow

1. Request a quote
2. Receive quote data with best route
3. Get execution data (calldata)
4. Execute with user's wallet

## Features

- Multi-DEX routing (Uniswap V2/V3, Saddle, GMX, etc.)
- Split execution across routes
- Custom fee collector
- Slippage control (basis points)
- Taxed token support

## Authentication

Test API Key: wcoDe1kG6tvJMBVdn_uYxq6DJdW9Om2Ef_izmJE3ckE

Production keys: Contact WolfSwap on Discord.

Full docs: https://wolfswap.app/docs/api

---

# Key Contract Addresses

- $PACK Token: 0x0d0b4a6fc6e7f5635c2ff38de75af2e96d6d6804 (Cronos)
- Wolfies NFT: 0x719FDfb0ba006747A83438cc8900c8a2b35e0afF (Cronos, ERC-721)
- Wolfies Burn Contract: 0x23c02d4882ba6d39567d9868F2771684B516EA55 (Cronos)
- WOL Wallet: 0x72aea18e031C15f1ab9180820DFF5222191Ea30B (Cronos)

---

# Links

- Website: https://wolfswap.app
- Documentation: https://wolfswap.app/docs
- API Docs: https://wolfswap.app/docs/api
- Discord: https://wolfswap.app/invite-discord
- Twitter: https://twitter.com/WolfSwapApp
- Cronos Explorer: https://cronoscan.com