Troubleshooting Tips
Swap Execution
Common transaction error:
Program log: Custom program error: 0x1771
Program Jupiter Aggregator v6 consumed 67018 of 200000 compute units
Program returned error: custom program error: 0x1771
0x1771
occurs when the slippage tolerance is exceeded, so when the final out amount is less than the minimum out amount.
Wrap and Unwrap SOL
You can refer to the documentation here. For the Jupiter API, there is also a wrapAndUnwrapSol
parameter that you can use as well.
Transaction Confirmation Timeout
From time to time, you may see an error message like Transaction was not confirmed in 60.00 seconds.
, this means that your transaction expires without being confirmed. Each block on Solana has a fixed compute unit allocation. Each account can only take up certain compute units in the block. So, if you are swapping through a very hot pair, that means that many people will compete with you for those limited compute units. You will have to outbid others to get your transaction in. This usually happens if you are consistently being outbid by others to get your transaction in.
To learn how to mitigate this problem, you should read this article about Solana transaction here
The Jupiter API cannot fix this for you but we do have a few things that can help you:
prioritizationFeeLamports
on/swap
: You can set this toauto
which will call thegetRecentPrioritizationFees
RPC and get 2x of 75 percentile of all the writable accounts involved in your transaction. This is usually enough to outbid everyone but sometimes during high congestion, it may not be enough. If that is not enough, you can also do{"autoMultiplier": 2}
, which will 2x of the auto fees. In order to protect user from setting a very high fee, the fee is always capped at 0.005 SOL.
const { swapTransaction } = await (
await fetch('https://quote-api.jup.ag/v6/swap', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
// quoteResponse from /quote api
quoteResponse,
// user public key to be used for the swap
userPublicKey: wallet.publicKey.toString(),
// auto wrap and unwrap SOL. default is true
dynamicComputeUnitLimit: true,
prioritizationFeeLamports: "auto",
// prioritizationFeeLamports: {
// autoMultiplier: 2,
// },
})
})
).json();
- If the
prioritizationFeeLamports
doesn't work, you can always set your own fee by using the/swap-instructions
endpoint. dynamicComputeUnitLimit
on/swap
: By default, the Jupiter API assumes that each swap will take up 1.4m compute units. By setting this to true it will adjust the compute unit to be dynamic. Jupiter runs a simulation to estimate the compute units the swap will take then we add an extra 40% margin. By having lower compute units used we can set a higher priority fee. This will help to get a transaction through since now you are bidding with a higher priority fee.maxRetries
onsendRawTransaction
: This can be useful to retry sending your transaction and increase the chance of your transaction landing.- You can check out how we send transaction on https://jup.ag here.
- Also, the Solana documentation has some very good tips.
const txid = await connection.sendRawTransaction(rawTransaction, {
skipPreflight: true,
maxRetries: 2
});
Blockhash is Invalid/Not Found
This can happen because of the decentralized nature of the chain. My local chain can be faster than your chain but they will eventually sync up. If you run into this problem, we suggest using processed
commitment when submitting the transaction and use confirmed
commitment to confirm your transaction. Setting skipPreflight
to true
can be very helpful too when submitting the transaction. This will mean that you will skip transaction simulation entirely.
If this problem persists, you can always set your own blockhash before submitting the transaction. You can check out a very helpful article here.
const txid = await connection.sendRawTransaction(rawTransaction, {
maxRetries: 2,
skipPreflight: true, // If you set this to true, you can skip the next one.
preflightCommitment: 'processed'
});
Updated 11 days ago