Reverting SOL and SPL Transactions
How to revert eligible Solana and SPL transactions.
Important Notes
Solana reverts require both a Solana wallet signature and payment of a HYPE fee on HyperEVM. Read the guide below and the Special Note if encountering issues with a Solana wallet EVM address.
Generally, it is recommended to use the Phantom wallet for reverts, but other wallets may be compatible. This guide assumes use of Phantom.
Step-by-Step: Reverting a Solana Transaction
Locate the Failed Deposit Transaction Signature
Find the failed Solana deposit in your transaction history. You will need the transaction signature. You can find it by viewing the transaction in the Solana wallet confirmation, or by looking up the transaction on a Solana block explorer such as Solscan.
Copy the full transaction signature.
Open Revert UI and Select Solana and the Asset
Go to the Revert UI and select Solana as the source chain, and choose the asset you are reverting.
You should be prompted to connect your Solana wallet. Connect the wallet associated with your original failed deposit. It is recommended to use a popular extension such as Phantom.
Once connected, your deposit address and destination address should auto-populate in the UI.
Enter the Transaction Signature and Confirm Validation
Paste the transaction signature from Step 1 into the Transaction Signature field.
Wait for the validation indicator to turn green. The UI also displays a "Formatted for contract" field showing the signature combined with the deposit address. This is derived automatically.
Review Funding Transaction Requirement
You must send a small SOL transfer to your Unit deposit address from Step 2 before proceeding. The UI displays the specific funding amount and accepted range.
Note: Your funding transaction must be within the range provided in the UI for the revert to process.
These values may vary, so always confirm the range displayed in the UI before sending.
Warning: If avoidable, do not use an exchange wallet to send the funding transaction. Exchange fees may cause the transfer amount to fall outside the required range, causing validation to fail.
Send the Funding Transfer and Submit Funding Transaction Signature
From your Solana wallet, send the required funding amount to your Unit deposit address shown in Step 2.
Note: This is not the destination address, but the deposit address of the original failed transaction.
Once the funding transaction confirms, copy the funding transaction signature. This typically entails selecting the transaction from your wallet interface and copying the transaction signature, or you can use a popular explorer like Solscan.
Paste the funding transaction signature into the Funding Transaction Hash field and wait for funding validation to pass (green indicator).
Sign the Revert Payload with Solana Wallet
The UI should now display a Phantom Signature Status section with the status set to "Pending." Below it, a Payload to sign field shows the full JSON payload encoding the revert details, including the transaction signature, destination address, mint address, funding transaction signature, and a timestamp.
Click Sign with Phantom Wallet. Your Solana wallet should open a "Sign Message" prompt asking you to confirm the signature. Review the details and confirm.
Confirm HYPE Fee Availability on HyperEVM
After signing the revert payload, the Phantom Signature status should update to Complete and the signed signature string should be displayed. You should also be able to select "Submit Revert."
Before submitting, confirm your connected wallet holds sufficient HYPE on HyperEVM. The UI displays the exact amount required and your current balance. Ensure your balance meets or exceeds the stated requirement. This HYPE is burned as part of the revert submission.
Confirm which wallet's balance is displayed: The HYPE balance shown is for the EVM address associated with your connected wallet, not any other EVM wallet you may have.
If the UI shows 0 HYPE despite you owning HYPE on another EVM address, you may need to change wallets to the relevant address.
See more in the Special Note below if you encounter this issue.
Submit the Revert Request
Click Submit Revert. Your wallet will prompt you to confirm the transaction on HyperEVM.
Network Requirement: Ensure your wallet is set to the HyperEVM network. If it is set to a different network, the transaction will fail with a "coalesce" error. Add HyperEVM via chainlist.org/chain/999 if you have not already.
Confirm Submission Success and Verify Return of Funds
After the transaction confirms on HyperEVM, the UI displays "Revert Submitted" with a green confirmation message and the submission transaction hash. Processing continues automatically.
After the required block confirmations, the reverted assets should appear in your Solana wallet at the destination address.
Special Note on HYPE Fee Balance Issues
Solana reverts may involve two wallets working together, which is a common source of confusion:
Solana wallet (e.g. Phantom): Used for the Solana side. Signs the revert payload and provides the destination address.
EVM wallet on HyperEVM: Used to pay the HYPE fee and actually submit the revert transaction.
Note: Using the built-in EVM addresses of some native Solana wallets may result in revert compatibility issues.
HYPE balance and potential wallet mismatch: When you connect a Solana wallet and also use the associated EVM address for that wallet, the UI will read your HYPE balance from the EVM address associated with that wallet.
If you do not have HYPE in that EVM address, the UI will show a balance of 0 HYPE. You will also not see a HYPE balance if the EVM address associated with the connected Solana wallet differs from the original deposit address. In that case, the HYPE on the original deposit address will not be reflected in the UI.
To resolve this, you must connect the original EVM wallet or transfer HYPE to the EVM address associated with your Solana wallet.
Common Errors
Invalid Hashes: If you provide an invalid original transaction signature or invalid funding transaction signature, the UI shows validation errors (red indicators) and the request will not proceed. Double-check that you are pasting the correct signatures for the correct transaction type.
HYPE balance shows 0 despite having HYPE: This typically means the HYPE is on a different EVM wallet than the wallet you are connected with. See Step 7 and the Special Note.
"Coalesce" error on submission: Your wallet submitting the transaction may not be set to the HyperEVM network. Add the network via chainlist.org/chain/999, switch to it, and retry.
Last updated