User Guides
Your path from a first swap to providing liquidity, managing positions, and launching a market.
grapl provides concentrated liquidity pools on Solana. Traders exchange tokens against liquidity supplied by position owners. An optional hook can add rules or fees to a particular pool.
Start with your goal, then follow the complete operation: prepare, review, sign, and verify. These guides explain the protocol through a compatible application without assuming a particular wallet interface or a publicly deployed market. Check current capabilities before starting.
Start here
Getting started
Prepare your wallet, verify assets, and know what a signature authorizes.
Choose a pool
Compare your trade size, active liquidity, costs, and pool rules.
Swap tokens
Choose ExactIn or ExactOut, set limits, and confirm the settled amounts.
Understand a pool
Learn how assets, price, liquidity, and fees fit together.
Become a liquidity provider
Providing liquidity changes your exposure to both tokens as people trade. Start by choosing a range and understanding the assets you may hold at its edges. Then review the deposit and the ongoing management it needs.
Choose your liquidity
Compare concentrated, full-range, and one-sided positions.
Add liquidity
Set your range and budget, then open and fund a position.
Full-range liquidity
Understand broad price coverage and its capital tradeoff.
One-sided liquidity and zaps
Distinguish an out-of-range deposit from a swap-and-deposit operation.
Manage and exit a position
Principal, earned fees, and account deposits are separate balances. Use the guide for the balance you want to manage; removing liquidity does not automatically finish every step of an exit.
| Task | Guide | Outcome to verify |
|---|---|---|
| Monitor an existing position | Manage your position | Range status, changing principal, and accrued fees |
| Claim trading income | Collect your fees | Confirmed transfers of the claimed assets |
| Withdraw part or all of the principal | Remove liquidity | Actual receipts and remaining liquidity |
| Close an emptied position | Position lifecycle | Cleared liquidity and fees, then returned position rent |
Create a market
Create a pool
Choose the assets, starting price, fee allocation, and initial liquidity.
Understand curve launches
Follow real inventory, the graduation target, and the transition to CLMM.
Costs, rules, and common problems
Read fees and account deposits to separate trading costs from SOL fees and recoverable deposits. Review hooks and risks for the policy and exposure of your chosen pool. If an operation fails or its outcome is unclear, follow troubleshooting before repeating it.
Building an application? Start with the dedicated grapl SDK guide or explore Developer Guides.