> For the complete documentation index, see [llms.txt](https://roguealiens.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roguealiens.gitbook.io/docs/roguealiens-docs.md).

# RogueAliens Docs

<figure><img src="https://3612550631-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOTkT47j9WeVNxnIXXc5W%2Fuploads%2Fyc8a2IJFN6V6LJMh2KYM%2FRogue%20Alien%20X%20Banner%20New.jpg?alt=media&amp;token=68708751-d51a-4abd-93f7-6ae1488ac7ea" alt=""><figcaption></figcaption></figure>

## 👽 Overview

Rogue Aliens is the first official Robin NFT trait group, with NFTs, games and DeFi tools, powered by Obsidian Finance and the OBS token.

Everything lives on one site, [roguealiens.app](https://www.roguealiens.app/), with one wallet connection that works on every page.

| Area              | What it is                                                    |
| ----------------- | ------------------------------------------------------------- |
| Rogue Aliens NFTs | The 1,000 piece collection, with Royalties you can claim      |
| Alien Robins      | Robin holders and donors who earn monthly OBS rewards         |
| Robin Burn Cache  | Burn a Robin and collect the OBS that has built up            |
| Games             | Alien Heist and Intergalactic Fugitive                        |
| AlienSwap         | A swap with XP, boosts, staking, missions, drops and contests |
| ROGUE             | The token that powers AlienSwap rewards                       |

## 🖼️ Rogue Aliens NFTs

Rogue Aliens is a collection of 1,000 NFTs that minted out in full.

The Rogue Aliens NFTs page opens with the Royalties claim panel at the top, with a MY ALIENS section below it that shows the Rogue Aliens in your connected wallet.

| Item          | Detail                                                |
| ------------- | ----------------------------------------------------- |
| Supply        | 1,000                                                 |
| Contract      | 0x9438414e747c9e2d60e381c3a585749039e69a25            |
| Buy or sell   | Ebisusbay, Crovia and MintPad (see Links)             |
| Discord roles | Holder tiers unlock roles in the Rogue Aliens Discord |

### Trait list

Every Rogue Alien has 7 traits. 995 aliens use the standard traits below, and 5 are one-of-one Legendaries. Counts are out of 995.

**Background**

| Trait            | Count | Rarity   |
| ---------------- | ----- | -------- |
| Deep Space Navy  | 190   | Common   |
| Moon Dust Gray   | 180   | Common   |
| Glitched Grid    | 150   | Common   |
| Martian Red      | 110   | Uncommon |
| Toxic Green      | 95    | Uncommon |
| Void Black       | 85    | Uncommon |
| Nebula Purple    | 68    | Rare     |
| Pixel Starfield  | 67    | Rare     |
| Solar Orange     | 25    | Epic     |
| OBS Signal Field | 25    | Epic     |

**Skin**

| Trait         | Count | Rarity   |
| ------------- | ----- | -------- |
| Original Blue | 230   | Common   |
| Lunar Gray    | 205   | Common   |
| Lavender      | 165   | Common   |
| Martian Green | 140   | Uncommon |
| Crimson       | 130   | Uncommon |
| Pearl White   | 85    | Rare     |
| Obsidian      | 20    | Epic     |
| Galaxy        | 20    | Epic     |

**Clothing**

| Trait           | Count | Rarity   |
| --------------- | ----- | -------- |
| Bare            | 189   | Common   |
| Black Tee       | 145   | Common   |
| OBS Tank        | 130   | Common   |
| Graphic Tee     | 100   | Uncommon |
| Hoodie          | 95    | Uncommon |
| Puffer Vest     | 85    | Uncommon |
| Lab Coat        | 80    | Uncommon |
| Bomber Jacket   | 45    | Rare     |
| Tactical Vest   | 43    | Rare     |
| Techwear Jacket | 43    | Rare     |
| Black Suit      | 20    | Epic     |
| Cyber Armor     | 20    | Epic     |

**Eyes**

| Trait            | Count | Rarity   |
| ---------------- | ----- | -------- |
| Cyan Glow        | 190   | Common   |
| Violet Focus     | 180   | Common   |
| Half-Asleep      | 155   | Common   |
| Angry            | 120   | Uncommon |
| Reptile Slits    | 110   | Uncommon |
| Heart Eyes       | 100   | Uncommon |
| Hollow Black     | 55    | Rare     |
| X Eyes           | 45    | Rare     |
| Laser Eyes       | 20    | Epic     |
| Holographic Eyes | 20    | Epic     |

**Head**

| Trait         | Count | Rarity   |
| ------------- | ----- | -------- |
| Bald          | 180   | Common   |
| Buzz Cut      | 155   | Common   |
| Beanie        | 120   | Common   |
| Backward Cap  | 110   | Common   |
| Bandana       | 80    | Uncommon |
| Antennae      | 75    | Uncommon |
| Pilot Cap     | 75    | Uncommon |
| Violet Mohawk | 60    | Rare     |
| Silver Spikes | 55    | Rare     |
| Neon Locs     | 45    | Rare     |
| Crystal Crown | 20    | Epic     |
| Energy Horns  | 20    | Epic     |

**Mouth**

| Trait       | Count | Rarity   |
| ----------- | ----- | -------- |
| Neutral     | 250   | Common   |
| Smirk       | 210   | Common   |
| Toothy Grin | 170   | Uncommon |
| Bubblegum   | 135   | Uncommon |
| Stitched    | 95    | Rare     |
| Fangs       | 95    | Rare     |
| Gold Grill  | 20    | Epic     |
| Respirator  | 20    | Epic     |

**Accessories**

| Trait               | Count | Rarity   |
| ------------------- | ----- | -------- |
| None                | 210   | Common   |
| Ear Studs           | 170   | Common   |
| Silver Chain        | 135   | Common   |
| OBS Tags            | 115   | Common   |
| Gold Hoops          | 105   | Uncommon |
| Crystal Pendant     | 95    | Uncommon |
| Gold OBS Chain      | 65    | Rare     |
| Cyber OBS Ear Piece | 60    | Rare     |
| Mini UFO            | 20    | Epic     |
| Floating Drone      | 20    | Epic     |

### Legendaries

| Rank | Token | Name               |
| ---- | ----- | ------------------ |
| 1    | #77   | OBS Void King      |
| 2    | #1000 | OBS Galaxy Emperor |
| 3    | #1    | OBS Overlord       |
| 4    | #777  | OBS Signal Breaker |
| 5    | #7    | OBS Prototype      |

## 💰 Royalties

Rogue Aliens holders earn Royalties in OBS, and you claim them yourself from the Rogue Aliens NFTs page.

The Rogue Aliens wallet holds its own OBS liquidity farm. On the 5th of every month the farm's OBS yield is split three ways, and the holders' share is paid into a claim contract in OBS for you to claim. The page shows the total Royalties collected so far, read from the OBS deposits into that contract.

1. Connect the wallet that holds your Rogue Aliens.
2. Open the Rogue Aliens NFTs page and find the Royalties claim panel at the top.
3. Press claim and approve the transaction in your wallet.

| Item           | Detail                                     |
| -------------- | ------------------------------------------ |
| Claim contract | 0xCC4f91188cA8cb522B7594f4735D323d17415647 |
| Paid in        | OBS                                        |

### Yield split

The Rogue Aliens farm yield is split like this every month.

| Share | Goes to                                           |
| ----- | ------------------------------------------------- |
| 80%   | Rogue Aliens holders, paid as Royalties you claim |
| 10%   | The Robin Burn Cache                              |
| 10%   | Compounded back into the OBS LP farm              |

## 🐦 Alien Robins

Alien Robins is where Robin holders and donors earn OBS rewards from the project's OBS farm, paid out by airdrop.

The Alien Robins wallet holds its own farm position in OBS liquidity, separate from the Rogue Aliens farm. Its rewards are airdropped on the 5th of every month to verified holders and to donors, and every payout is listed in the Rewards history inside the Alien Robins tab.

| Part     | What it covers                                                            |
| -------- | ------------------------------------------------------------------------- |
| Overview | The current state of the program                                          |
| Holders  | Verified Robin holders, who each receive the same equal amount per wallet |
| Donors   | Wallets that donate OBS to the program                                    |
| Rewards  | Past payouts                                                              |

Alien Skin Robins are Robins with the SKIN trait set to Alien. There are 140 of them in the collection of 2,500, and they carry special benefits across the ecosystem, including a boost on AlienSwap and the Rogue Alien role in Discord.

The Robin NFT collection contract is 0x1dBA58B1bdcaA3B0488065cCEFa057c52a963280.

## 🔥 Robin Burn Cache

Burn a Robin and collect all the OBS that has built up in the Cache at that moment.

The Cache is a pool of OBS that fills slowly, by a set amount every second. When a holder burns a Robin, the Robin is sent to the dead address for good and the holder collects whatever has built up. The pool then starts building again from what is left.

1. Open the Robin Burn Cache tab and connect the wallet that holds the Robin.
2. Check the amount currently available to collect.
3. Burn the Robin and approve the transaction.
4. The OBS arrives in your wallet.

| Item         | Detail                                     |
| ------------ | ------------------------------------------ |
| Contract     | 0x9FD13d63483AbeA9bAf48B9b325176cB4060479E |
| Collection   | Robin NFTs                                 |
| Reward token | OBS                                        |
| Burning      | Permanent, it cannot be undone             |

The pool is topped up by the project over time, so the amount available changes.

## 🎮 Games

There are two games on the Games tab: Alien Heist, where you try to fool a guard for a pot of OBS, and Intergalactic Fugitive, a free 3D shooter with monthly tournaments.

### Alien Heist

Talk Rogue Degenson into saying the secret phrase and win the pot.

Each round has a secret phrase that the guard must never say. Every attempt costs OBS and part of it goes into the pot. If your message tricks the guard into saying the phrase, the winning check is done by code and not by an AI's opinion, and the winner is paid from the pot automatically. A small part stays behind as the start of the next round.

| Item        | Detail                                                     |
| ----------- | ---------------------------------------------------------- |
| Cost        | Attempts cost OBS, with a minimum per attempt              |
| Balance     | Deposit a play balance so you do not sign every message    |
| Payout      | Automatic, straight to the winner's wallet                 |
| Leaderboard | VAULT BREAKERS lists the players who have fooled the guard |

When you deposit, your wallet approval is for exactly the amount you deposit and never unlimited. The pot shown is only OBS actually spent on attempts, not players' unspent balances. A failed AI reply is never charged.

### Intergalactic Fugitive

Fight through hostile robots across ten worlds in a 3D space shooter that is free to play, with optional paid boosters.

You play in the browser on the Games tab. One free signature signs you in for 24 hours. It costs no gas and moves no funds. Your scores are posted to the monthly leaderboard, and tournaments pay OBS prizes to top players.

| Item            | Detail                                                                                                     |
| --------------- | ---------------------------------------------------------------------------------------------------------- |
| Price           | Free to play                                                                                               |
| Boosters        | Optional, bought with OBS, such as Damage Surge, Rapid Fire, Ghost Shield, Extra Life and Score Multiplier |
| Permanent items | Upgrades you keep, bought with OBS                                                                         |
| Sign in         | One free signature, valid for 24 hours                                                                     |
| Leaderboard     | Monthly, with a selector for past months                                                                   |

Every purchase is checked on chain before the item is added, and each payment can only be used once. Boosters load into your next run automatically and are used up when triggered in play.

## 🔄 AlienSwap

AlienSwap is a swap where every trade earns XP, and every swap is routed through Obsidian.

The Swap tab opens with CRO in the From box and ROGUE in the To box. Type an amount and the dollar value shows as you type. You can also type in the To box to say how much you want to receive, and the From amount is worked out for you.

1. Connect your wallet. The swap button also works as Connect Wallet.
2. Pick your tokens. The token picker lists Recommended tokens first, then the tokens your wallet holds from highest to lowest dollar value, each with its logo, ticker, contract address and balance.
3. Enter an amount. Max accounts for gas.
4. If a token approval is needed, the button says Approve Token. Approve it, then press Swap.

| Setting             | Detail                                                                                   |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Fee                 | AlienSwap's own fee sits on top of Obsidian's, and is shown as one combined token amount |
| Route               | Whatever route Obsidian uses                                                             |
| Slippage            | Presets of 0.5, 1 and 2 percent, or a custom value, with 1 percent as the default        |
| Price impact        | An extreme price impact asks you to confirm instead of blocking the swap                 |
| Boost bar           | Rotates through boosted tokens every 3 seconds                                           |
| Recent transactions | Your last 25 trades with the XP each one earned                                          |

The Profile page holds your overview, activity, staking and weekly rewards, along with Claim All.

## ⚡ XP, boosts and the weekly Leaderboard

Every swap earns XP, and the traders with the most XP each week share a prize pool paid in ROGUE.

### How XP works

For a buy, XP is the dollar value of the swap times one plus the token boost, times one plus the NFT boost. Every sell scores 1 XP per dollar with no NFT boost. All trades count on the weekly Leaderboard, and there is no minimum to qualify.

| Token you receive     | Token boost |
| --------------------- | ----------- |
| ROGUE                 | +300%       |
| OBS                   | +100%       |
| Trading contest token | +50%        |
| Any other token       | None        |

### NFT boosts

Your NFT boost depends on the best NFT you hold, and boosts never stack, so only the best one applies. The boost applies to every buy.

| Holding                          | NFT boost |
| -------------------------------- | --------- |
| Rogue Alien ranked 1 to 5        | 100%      |
| Rogue Alien ranked 6 to 25       | 75%       |
| Rogue Alien ranked 26 to 100     | 50%       |
| Rogue Alien ranked 101 to 250    | 25%       |
| Rogue Alien ranked 251 to 500    | 15%       |
| Rogue Alien ranked 501 and below | 10%       |
| Alien Skin Robin                 | 90%       |

Your boost is checked from your wallet signature every time you use it.

### Weekly Leaderboard

The week resets every Sunday at 7:00 PM Central, and the new week starts right away. The top 50 traders are paid from a prize pool on a rank-weighted curve, so first place earns the most. Ranks that nobody fills are not paid and roll into the next week's pool.

The prize pool is funded by AlienSwap's fees. Prizes are paid in ROGUE and are claimable from the Leaderboard tab a couple of minutes after each reset. Claim them within 30 days, because anything unclaimed after that goes back to the project.

## 🌱 Earn

Stake ROGUE in a fixed lock pool and earn a fixed APR that is the same for every staker in that pool.

There are three pools, with lock periods of 6 months, 12 months and 24 months. Each deposit unlocks after its own lock period, counted from the day you deposited. Rewards can be claimed at any time. Withdrawals wait until each deposit unlocks.

Each pool has a total cap and a deposit cutoff date. It also has one fixed end date, and no rewards build up after that date, though withdrawals still wait for each deposit's own unlock.

| Pool | Lock      | APR                   | Pool cap              | Opens                 | Pool ends             |
| ---- | --------- | --------------------- | --------------------- | --------------------- | --------------------- |
| 6M   | 6 months  | To be added at launch | To be added at launch | To be added at launch | To be added at launch |
| 12M  | 12 months | To be added at launch | To be added at launch | To be added at launch | To be added at launch |
| 24M  | 24 months | To be added at launch | To be added at launch | To be added at launch | To be added at launch |

The APR is fixed in the contract, so it is exactly what the Earn tab shows. Your pending rewards, deposits and unlock dates are listed on the Earn tab and on your Profile under Staking.

To be added at launch: staking contract address, reward funding and how to read your position.

## 🎯 Missions and Saucers

Complete daily missions to earn Saucers, which you spend to open Alien Drops.

Each mission has its own Claim button, and Saucers are only added to your balance when you claim them. Missions reset every day at 7:00 PM Central, and Saucers you did not claim by then are lost. Saucers you have already claimed never expire. The Missions tab is the only place to earn Saucers, and only the project creates missions.

| Mission            | How it counts                                                                        |
| ------------------ | ------------------------------------------------------------------------------------ |
| Buy the new token  | Buys of ROGUE add up across all your swaps during the day                            |
| Buy OBS            | Buys of OBS add up across all your swaps during the day                              |
| Daily volume tiers | Your total daily volume at each tier adds up across swaps, and each tier is separate |
| $10 swap           | One single swap of at least $10                                                      |

#### Sponsored missions

Projects can sponsor their own daily missions on AlienSwap. A sponsored mission is built around one token, and you complete it by buying that token during the day.

Every sponsored mission has a daily buy target in dollars, a Saucer reward, and a start and end date. It works like every other mission: it has its own Claim button, it resets every day at 7:00 PM Central, and Saucers you did not claim by then are lost.

#### Missions for trading contest tokens

Any token with a trading contest running on AlienSwap gets its own daily mission while the contest is live. Buy the contest token to complete it and claim your Saucers. The mission ends when the contest ends.

## 🎁 Alien Drop

Spend 21 Saucers to open one Alien Drop and win a prize that is sent straight to your wallet.

There is no limit on how many Drops you can open. Prizes mix tokens and NFTs, and ROGUE and OBS are always included. The prize area shows everything available, and prizes that have been fully claimed are shown as claimed.

| Tier   | Chance | Example prizes      |
| ------ | ------ | ------------------- |
| Common | 80%    | Tokens              |
| Mid    | 15%    | Larger token prizes |
| Rare   | 4.5%   | A Rogue Alien NFT   |
| Chase  | 0.5%   | A Robin NFT         |

The odds are fixed and do not change with how much stock is left. If the Drop prizes run out, the page checks first and shows a clear restocking message, without asking you to sign and without charging any Saucers.

To be added at launch: the full prize list and the stock for each prize.

## 🏆 Trading Contests

Any project can host a sponsored trading contest on AlienSwap, and traders compete for the prizes the sponsor deposits.

### For traders

Contests are listed on the Contests tab as current, upcoming and finished. Each contest page shows its prizes, with 1st, 2nd and 3rd badges, and a leaderboard of the top 10. Your own row is marked (You), and if you rank below 10 it is pinned above rank 1. Prizes are paid out to winners automatically after the contest ends, so there is nothing to claim.

A contest credits any trade that involves its token, whatever the other side is. Buys count more than sells, and there is no NFT boost on contest boards, so everyone competes evenly. One swap counts on every contest board it touches, and on the weekly Leaderboard.

### For sponsors

Host a contest from the Contests tab. There is no hosting fee.

| Rule                | Detail                                                                  |
| ------------------- | ----------------------------------------------------------------------- |
| Token               | The contest token and every prize token must be whitelisted on Obsidian |
| Length              | 7 days or 14 days                                                       |
| Minimum prize value | $200 for 7 days, $400 for 14 days, measured when you deposit            |
| Winning positions   | Up to 5, with allocations that must add up                              |
| Prizes              | Any tokens, several tokens, or NFTs, valued by their floor price        |
| Deposit             | The full prize is deposited before the contest is created               |
| Logo                | You upload a logo, and the site generates the banner                    |
| Changes             | Contests cannot be edited or cancelled once created                     |
| Unclaimed positions | Ranks nobody fills go to the project                                    |

## 🪙 The ROGUE token

ROGUE is the token that powers AlienSwap's rewards, and it launches paired with OBS on Obsidian's launchpad.

ROGUE is used across AlienSwap: it earns the biggest buy boost, it pays the weekly Leaderboard, it is the token you stake on the Earn tab, and it is always among the prizes in Alien Drop.

| Item             | Detail                                                           |
| ---------------- | ---------------------------------------------------------------- |
| Ticker           | ROGUE                                                            |
| Paired with      | OBS                                                              |
| Launch           | On Obsidian's launchpad, with liquidity seeded when it graduates |
| Launch date      | To be added at launch                                            |
| Total supply     | To be added at launch                                            |
| Allocation       | To be added at launch                                            |
| Bonding curve    | To be added at launch                                            |
| Contract address | To be added at launch                                            |
| Liquidity        | To be added at launch                                            |

To be added at launch: where to buy, how to add ROGUE to your wallet, and how the project's share of the supply is used.

## 🔐 Wallets and safety

The team will never ask for your seed phrase, and no step on the site ever needs it.

You can connect any wallet that shows up in the Connect Wallet window. One connection works across the whole site: the main pages, AlienSwap and both games.

| Topic           | What to know                                                                                                                                       |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sign in         | Signing in asks for a free signature. It costs no gas and moves no funds                                                                           |
| Session         | A sign in lasts for a limited time, and switching wallets asks you to sign in again                                                                |
| Approvals       | When a deposit needs an approval, it is for exactly the amount you are depositing, never unlimited                                                 |
| Purchases       | Every game purchase is checked on chain, and each payment can only be used once                                                                    |
| Project wallets | The project's main wallets are secured behind hardware wallet signatures, and the project's treasury and farm wallets are listed on the Links page |
| Contracts       | The contracts that hold funds are owned by one admin wallet that also runs the admin tools                                                         |

If something looks wrong, do not sign anything. Open a ticket in the Rogue Aliens Discord and wait for a reply from the team.

## 🔗 Links and community

Everything official is listed here, and the Links page on the site is always the most up to date.

| Link                      | Where                                                                                        |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| Website                   | [roguealiens.app](https://www.roguealiens.app/)                                              |
| X                         | [@Rogue\_Aliens](https://x.com/Rogue_Aliens)                                                 |
| Discord                   | [discord.gg/roguealiens](https://discord.gg/roguealiens)                                     |
| Obsidian Finance          | [obsidian.finance](https://obsidian.finance/)                                                |
| Rogue Aliens on Ebisusbay | [Ebisusbay](https://app.ebisusbay.com/collection/cronos/rogue)                               |
| Rogue Aliens on Crovia    | [Crovia](https://crovia.app/collections/rogue-aliens)                                        |
| Robins on MintPad         | [MintPad](https://mintpad.app/collections/cronos/0x1dba58b1bdcaa3b0488065ccefa057c52a963280) |
| Robin on Ebisusbay        | [Ebisusbay](https://app.ebisusbay.com/collection/cronos/robin-nft)                           |

### Project wallets

The Rogue Aliens Treasury ends in a3cD (0x2Ad38A3ef7C51F7147aA660a3B7af11B97b8a3cD). The Rogue Aliens wallet holds the Rogue Aliens OBS farm position (0xC8E43E7430750D87F88a032c219BC46270Cd3845). The Alien Robins wallet holds the Alien Robins OBS farm position (0x6cc8fF745bE2b307555CDf6c5834c38Ef5a8465F). You can view each one on DeBank.

### Contracts

| Contract                     | Address                                    |
| ---------------------------- | ------------------------------------------ |
| Rogue Aliens NFT             | 0x9438414e747c9e2d60e381c3a585749039e69a25 |
| Robin NFT                    | 0x1dBA58B1bdcaA3B0488065cCEFa057c52a963280 |
| Robin Burn Cache             | 0x9FD13d63483AbeA9bAf48B9b325176cB4060479E |
| Rogue Aliens Royalties claim | 0xCC4f91188cA8cb522B7594f4735D323d17415647 |
| Alien Heist                  | 0x369E4Ef54109a38095232308a98326a6Daba279F |


---

# 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
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://roguealiens.gitbook.io/docs/roguealiens-docs.md?ask=<question>&goal=<user_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.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
