Quickstart

Prerequisites

1. Use a wallet that supports RISE Mainnet, chain ID 4153.
2. Hold the ERC-20 input asset and enough native gas token to submit transactions.
3. Verify token and contract addresses. Symbols and names are not unique.
4. Review the experimental-software notice before signing.

Swap tokens

1. Open the Abyss application and connect a wallet.
2. Select an input token, output token, and amount.
3. The routing service searches connected routes containing one to four pools. Each pool is identified by its complete PoolKey, not only by its token pair.
4. Review the quoted output, route, slippage tolerance, and deadline.
5. If allowance is insufficient, submit Approve TOKEN to authorize the router. Approval is a separate transaction.
6. After the approval receipt, request a fresh quote and submit Swap.
7. Confirm the transaction on the RISE explorer.

A quote is a current-state estimate. It can expire or become stale and does not guarantee execution. Price movement, liquidity changes, RPC failure, allowance changes, or a passed deadline can cause the transaction to revert.

Supply liquidity

1. Select the token and quote asset.
2. Select a profile: Standard, Beacon, Stream, or Lighthouse.
3. Select an enabled fee tier.
4. For Beacon or Lighthouse, select an oracle profile.
5. If the pool does not exist, enter its initial price. Initialization can occur only once.
6. Select a full-range, custom-range, or single-sided position.
7. Approve each nonzero token amount for the position manager in separate transactions.
8. Create and initialize the pool if necessary.
9. Mint the position NFT.

The exact action sequence is state dependent:

validate inputs
  -> approve token A if needed
  -> approve token B if needed
  -> create and initialize the pool if absent
  -> mint the position

Each arrow is a separate wallet action. Existing pools use their current onchain price for range calculations. New pools use the submitted initialization price.

Manage a position

The position NFT controls an immutable custody account that owns the pool position. Transferring the NFT transfers control without moving the underlying pool position.

• Increase liquidity adds liquidity to the existing tick range.
• Decrease liquidity burns liquidity and records the principal as tokens owed to the position.
• Collect transfers owed principal and fees to a selected recipient.
• Burn position destroys the NFT only after liquidity and both owed balances are zero.

Liquidity is removable at the pool-core level. A separate optional position locker can custody position NFTs for a finite term or permanently, but locking is not required by the protocol.