Documentation

What is PlotSwap?

PlotSwap is a decentralized exchange (DEX) for tokenized real-world assets. It uses an automated market maker (AMM) model — the same approach as Uniswap — to enable instant token swaps without order books.

How do I connect?

Click 'Connect Wallet' and select your browser wallet (MetaMask, Rabby, etc.). PlotSwap will automatically add the correct network to your wallet if it's not already configured.

How do I get test tokens?

Use the Wrap page to convert your native gas token (IRL) to WIRL for trading. Most tokens are pre-listed — you can also add any token by pasting its contract address.

How do swaps work?

PlotSwap uses constant product (x*y=k) liquidity pools. When you swap, you trade against the pool's reserves. The price adjusts based on the ratio of tokens in the pool.

What is slippage?

Slippage is the difference between the expected price and the actual execution price. You can set a slippage tolerance in swap settings (gear icon). If the price moves beyond your tolerance, the swap reverts.

What is the swap fee?

0.3% per trade. Of that, 0.25% goes to liquidity providers and 0.05% is an optional protocol fee.

Why do I need to approve tokens?

ERC-20 tokens require an approval transaction before they can be transferred by a smart contract. This is a one-time step per token — you approve the Router to spend your tokens on your behalf.

What is a liquidity pool?

A pool holds reserves of two tokens. Traders swap against these reserves. As a liquidity provider (LP), you deposit equal value of both tokens and receive LP tokens representing your share.

How do I add liquidity?

Go to the Pool page, select two tokens, enter amounts, and click Supply. You'll need to approve both tokens first. You'll receive LP tokens that track your share of the pool.

How do I remove liquidity?

On the Pool page, find your position, click Remove, select the percentage to withdraw, and confirm. Your LP tokens are burned and you receive both tokens proportional to your share.

What is impermanent loss?

When token prices change after you deposit, you may end up with less value than if you had simply held the tokens. This is called impermanent loss. It's 'impermanent' because it reverses if prices return to the original ratio.

What is XP?

XP (experience points) tracks your activity on PlotSwap. Every qualifying swap and add-liquidity action emits an XP event recorded against your wallet on the Integra XP Kit. XP is the basis for reputation, rewards, and potential future airdrops.

How much XP do I earn?

1,000 XP per qualifying action (swap or supply liquidity). Caps: 5 rewarded actions per wallet per day, 30 rewarded actions per wallet lifetime. Actions beyond the caps still succeed on-chain but do not mint additional XP.

Where do I see my XP?

Your XP balance, history, and standing across Integra dApps live on the Integra Dashboard at dashboard.integralayer.com. When an action earns XP, PlotSwap pops a toast with a direct link to your dashboard.

What if XP didn't show up after a swap?

Either you hit the daily or lifetime cap for that action, or the XP relay briefly failed — in the latter case the on-chain swap is unaffected and XP simply isn't credited for that specific action. Check the dashboard to see which one applied.

What is IRL?

IRL is the native gas token of the network — used for transaction fees, similar to ETH on Ethereum.

What is WIRL?

WIRL (Wrapped IRL) is an ERC-20 version of the native IRL token. Since AMM contracts require ERC-20 tokens, you need to wrap your IRL before trading. It's always 1:1.

How do I wrap IRL?

Go to the Wrap page in the navigation. Enter the amount of IRL you want to wrap and click 'Wrap'. You can unwrap back to IRL at any time.

What are ERC-1404 tokens?

ERC-1404 is a standard for security tokens with built-in transfer restrictions. Token issuers can enforce compliance rules like whitelisting, jurisdiction checks, and holding period requirements.

How does PlotSwap handle them?

Before any swap involving an ERC-1404 token, PlotSwap calls detectTransferRestriction() on-chain. If your address isn't on the whitelist, you'll see the exact restriction reason in the UI — the transaction is blocked before it reaches your wallet.

How do I get whitelisted?

Contact the token issuer directly. Whitelisting is managed at the token contract level, not by PlotSwap.

Creates and tracks all trading pairs. Deploys new Pair contracts on demand.

User-facing contract for swaps and liquidity. Handles ERC-1404 compliance checks and XP emission.

AMM pool contract (x*y=k). Deployed per token pair by the Factory.

Wrapped IRL (WETH-style). Deposit native IRL to mint WIRL, withdraw to unwrap.