Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated Jup Swap guide with new flows and new screenshots #534

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 43 additions & 40 deletions guides/2-jupiter-spot/2-jupiter-swap/1-swap.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,14 +18,14 @@ There are no protocol fees on Jupiter. The only fees are transaction fees and DE

## Basic Swap User Flow

1. First, navigate to the [Jupiter Website](https://jup.ag/). **Double check** that the URL in your search bar is correct: https://jup.ag/
2. Next, connect your wallet by clicking the `Connect Wallet` button at the top right corner of the site.
1. Visit the Jupiter website [Jupiter Website](https://jup.ag/). **Double check** that the URL in your browser address bar is correct: https://jup.ag/
2. Connect your wallet by clicking the `Connect Wallet` button at the top right corner of the site.
3. Select the tokens that you want to swap from and into with the token selectors.
4. Enter the input amount of the selected token that you want to swap from.
5. Review the swap route and output token amounts. Checkout the full list of supported DEXes for routing [here](https://station.jup.ag/partners?category=DEXes).
6. Configure additional parameters to help with your trade, including: Priority Fees, Slippage Settings, and Swap Settings.
7. After you have confirmed all the parameters and inputs, click on the 'Swap' button, and you will be prompted with a confirmation from your wallet. If you 'Confirm', your swap will be sent to the blockchain, to be finalized.
8. A notification toast will appear in the lower left corner that will inform you of the current status of your transaction.
4. Enter the amount of the selected token that you want to swap from in the top selector.
5. Review output token amounts and the swap route. Checkout the full list of supported DEXes for routing [here](https://station.jup.ag/partners?category=DEXes).
6. Configure additional parameters to optimize your trade, including: Priority Fees, Slippage Settings, and Swap Settings.
7. After you have confirmed all the parameters and inputs, click on the 'Swap' button. You will be prompted with a confirmation from your wallet. If you 'Confirm', your swap will be sent to the blockchain, to be finalized.
8. A notification toast will appear in the lower left corner that will show the current status of your transaction.
9. You can view your swap history at the bottom of the page or click on the wallet at the top right corner.

**Let's go through Jupiter Settings in greater detail below.**
Expand All @@ -36,38 +36,32 @@ There are no protocol fees on Jupiter. The only fees are transaction fees and DE

![Jup Swap](../../img/jup-swap/jup-swap-1.png "Main jupiter swap screen showing basic user settings and configuration options.")

1. **Jupiter Swap:** [Jupiter Swap](https://jup.ag/) tab _(the current tab you are in)_ where you can instantly spot swap for any supported SPL token.
2. **Jupiter Limit Order:** [Jupiter Limit Order](https://jup.ag/limit) tab where you can place limit orders at a specific price and receive tokens directly in their wallet if the order is triggered and filled.
3. **Global Priority Fee:** [Transaction Priority Fees](https://docs.solana.com/proposals/fee_transaction_priority) is a Solana feature that allows users to bid for priority for their transactions in the leader's queue.
4. **Jupiter Global Settings:** Select your default settings like language, Solana explorer and RPC endpoint.
5. **Connect Wallet:** Connect to your preferred wallet to interact with Jupiter.
1. **Jupiter Spot:** In [Jupiter Spot](https://jup.ag/) tab _(the current tab you are in)_, the Jupiter Swap is available.
2. **Jupiter Global Settings:** Select your default settings like language, Solana explorer and RPC endpoint.
3. **Connect Wallet:** Connect your preferred wallet to interact with Jupiter.
4. **Jupiter Swap:** [Jupiter Swap](https://jup.ag/) tab _(the first tab)_ where you can instantly spot swap for any supported SPL token.
5. **Jupiter Swap Settings:** These settings impact the routing and pricing of the swaps. For beginners it is usually easier to go with Auto settings. We will see all the settings in detail in the below sections.
6. **Refresh Quote:** Refresh quote button to update the latest quote for the configured asset swap in the terminal.
7. **Slippage Settings:** Slippage settings configure your acceptable threshold for price change between when you submit a transaction and it executes.
8. **Swap Settings:** These settings will directly impact the routing and pricing of the swaps being performed. Typically, default settings works for beginners.

### Global Settings

:::tip The RPC Endpoint Selector now displays active end-point latency
Due to network traffic loads RPC endpoints can get overloaded, which can lead to latency issues that will directly impact your trade executions. Reviewing the RPC latency and selecting the lowest latency option is a best practice to ensure the fastest trade execution.
:::
![Jup Swap 5](../../img/jup-swap/jup-swap-2.png "Global settings for Jupiter Swap, including language, preferred explorer and RPC endpoint.")

1. **Language:** Pick your preferred language from English, Chinese, Vietnamese, Japanese, Indonesian, and Korean.
![Jup Swap 2|50%](../../img/jup-swap/jup-swap-2.png "Global settings for Jupiter Swap, including language, preferred explorer and RPC endpoint.")

1. **Language:** Pick your preferred language from English, Chinese, Vietnamese, Japanese, Indonesian, Korean, Spanish, French, ,Italian, Dutch, Portuguese and Turkish.
2. **Preferred Explorer:** Pick your preferred explorer from Solscan, SolanaFM, Solana Beach, Solana Explorer, XRAY, and OKLink.
3. **RPC Endpoint:** Pick your preferred public RPC endpoint from Triton RPC, Helius RPC, or use your own custom RPC endpoint.
3. **Versioned Transaction:** This allows for more advanced routing and better prices. Enabling [Versioned Transaction](https://station.jup.ag/docs/additional-topics/composing-with-versioned-transaction) improves composability so Jupiter will be able to fit in more routes.
4. **RPC Endpoint:** Pick your preferred public RPC endpoint from Triton RPC, Helius RPC, or use your own custom RPC endpoint.

### Transaction Priority Fees

:::info Transaction Priority Fees
Trades submitted to the blockchain are assigned a priority based on the fee bidding process. The higher the priority fee, the higher your transactions will be in the execution queue. During times of congestion, increasing your priority fee can help. Use with caution and remember to re-adjust the fee selection afterwards.
:::
![Jup Swap 4](../../img/jup-swap/jup-swap-3.png "Priority fee settings, including Jito tips, fee mode, and priority levels.")
### Swap Settings

1. **Transaction Broadcasting Selector:** Select your transaction broadcasting option. Choose from submitting to RPCs with priority fee, sending your transaction directly to Jito Validators via a bundle, or an Mixed, which fires both and see which lands first.
2. **Priority Level:** Specify the Priority Level, in increasing priority: Fast, Turbo, Ultra for the transactions you are executing.
3. **Fee Mode:** Pick your preferred Fee Mode. Either specify a Max Cap for your fee or an Exact Fee for your transactions.
![Jup Swap 3](../../img/jup-swap/jup-swap-4.png "Slippage settings allow you to change mode: Dynamic, Auto, Fixed and set the percentage.")

### Slippage Settings
#### Slippage Settings

::::info Slippage Settings

Expand All @@ -81,18 +75,25 @@ This is an advanced setting and should be used with caution.

::::

![Jup Swap 3](../../img/jup-swap/jup-swap-4.png "Slippage settings allow you to change mode: Dynamic, Auto, Fixed and set the percentage.")
1. **Slippage Mode:** Select the slippage mode you want to utilize. Dynamic mode optimises slippage between success rate, and sandwich protection through a series of simulations. Auto slippage will utilize Jupiters internal slippage calculations for the best setting. Fixed will adhere to your specificed slippage amount.
2. **Fixed Slippage:** Enter the maximum acceptable slippage rate for your swaps.

1. **Mode:** Select the slippage mode you want to utilize. Dynamic mode optimises slippage between success rate, and sandwich protection through a series of simulations. Auto slippage will utilize Jupiters internal slippage calculations for the best setting. Fixed will adhere to your specificed slippage amount.
2. **Slippage:** Enter the maximum acceptable slippage rate for your swaps.
#### Transaction Priority Fees

### Swap Settings
:::info Transaction Priority Fees
Trades submitted to the blockchain are assigned a priority based on the fee bidding process. The higher the priority fee, the higher your transactions will be in the execution queue. During times of congestion, increasing your priority fee can help. Use with caution and remember to re-adjust the fee selection afterwards.
:::

3. **Broadcast Mode:** Select your transaction broadcasting option. Choose from submitting to RPCs with priority fee, sending your transaction directly to Jito Validators via a bundle, or a Mixed, which fires both and see which lands first.
4. **Speed:** Specify the Priority Level, in increasing priority: Fast, Turbo, Ultra for the transactions you are executing. Controlling how fast the transaction will land, Turbo and ultra cost more SOL but they are faster.
5. **Fee Mode:** Pick your preferred Fee Mode. Either specify a Max Cap for your fee or an Exact Fee for your transactions.
6. **Set Max Cap:** When a max fee is set then the fee is adjusted based on market conditions up to the max value.

![Jup Swap 2](../../img/jup-swap/jup-swap-5.png "General swap settings for wSOL, versioned transactions, and utilizing direct routes.")
#### Advanced Settings

1. **Direct Route Only:** Using Direct Route Only ensures that the transaction will only be submitted to a single pool. This will limit a lot of intermediate tokens and filter out a lot of other viable routes that use intermediary tokens.
2. **Use wSOL:** Using [Wrapped SOL (wSOL)](../../12-general/5-wrapped-sol.md) makes using Jupiter faster and more convenient for traders who trade frequently with SOL, since it avoids having to wrap/unwrap SOL.
3. **Versioned Transaction:** Enabling [Versioned Transaction](/docs/additional-topics/composing-with-versioned-transaction) improves composability so Jupiter will be able to fit in more routes and get even better pricing all in a single transaction.
7. **Direct Route Only:** Using Direct Route Only ensures that the transaction will only be submitted to a single pool. This will limit a lot of intermediate tokens and filter out a lot of other viable routes that use intermediary tokens.
8. **Use wSOL:** Using [Wrapped SOL (wSOL)](../../12-general/5-wrapped-sol.md) makes using Jupiter faster and more convenient for traders who trade frequently with SOL, since it avoids having to wrap/unwrap SOL.
9. **AMM Exclusion:** This excludes certain AMMs when swapping.

---

Expand All @@ -114,8 +115,9 @@ This is an advanced setting and should be used with caution.
### Order Routings

:::info Order Routing
Clicking on the area marked number 9 from the Swap terminal above will show you the exact order routing path for the quoted transaction. You can also see the split trades and all market hops along the route.
Clicking on the area marked number 9 from the Swap terminal above will show you the exact order routing path for the quoted transaction. You can also see the split trades and all market hops along the route (if any).
:::

![Jup Swap 9](../../img/jup-swap/jup-swap-7.png "The order routing map shows how your tokens swapped through multiple liquidity pools.")

---
Expand All @@ -124,8 +126,9 @@ Clicking on the area marked number 9 from the Swap terminal above will show you

![Jup Swap 10](../../img/jup-swap/jup-swap-8.png 'The collapsable "Price Info" menu shows granular details for price impact, transaction fee, and deposit amount.')

1. **Exchange Rate for the Selected Tokens:** This is the current exchange rate, based on the on-chain prices for the selected input and output tokens, along with a comparison against Coingecko Price API.
2. **Price Impact:** Price Impact is influenced by the available liquidity to settle the trade. The larger the trade the larger the price impact on the selected assets.
3. **Minimum Received:** Minimum received takes into account the slippage setting and market liquidity to compute the minimum amount that the user will receive even with maximum price fluctuations during a successful swap.
4. **Max Transaction Fee** This is the maximum fee you will pay to execute the quoted transaction. This takes into account your selected fee settings.
5. **Deposit:** If you are transacting assets you have not owned before, Solana may require a small deposit amount to create the ATA account in your wallet to hold that asset. This will only occur with assets you have not owned previously.
1. **Exchange Rate for the Selected Tokens:** This is the current exchange rate, based on the on-chain prices for the selected input and output tokens.
2. **Minimum Received:** Minimum received takes into account the slippage setting and market liquidity to compute the minimum amount that the user will receive even with maximum price fluctuations during a successful swap.
3. **Max Transaction Fee:** This is the maximum fee you will pay to execute the quoted transaction. This takes into account your selected fee settings.
4. **Deposit:** If you are transacting assets you have not owned before, Solana may require a small deposit amount to create the ATA account in your wallet to hold that asset. This will only occur with assets you have not owned previously.
5. **Price Impact:** Price Impact is influenced by the available liquidity to settle the trade. The larger the trade the larger the price impact on the selected assets.
6. **Price Difference:** This is a comparison against the token prices on Coingecko.
Binary file modified guides/img/jup-swap/jup-swap-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified guides/img/jup-swap/jup-swap-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified guides/img/jup-swap/jup-swap-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified guides/img/jup-swap/jup-swap-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified guides/img/jup-swap/jup-swap-7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified guides/img/jup-swap/jup-swap-8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.