Recovering funds stuck on a Trezor or Electrum address

Using Send All to recover tokens stuck on a Trezor/Ledger/Electrum Address

The Omni protocol has a special send type called 'Send All' Which will sweep any and all tokens of a given ecosystem (Production or Test ecosystems) from one address to another specified address. Since Electrum has support for Recovering Trezor hardware wallet seeds we can use Electrum to create this special transaction which will recover/sweep all the stuck funds to an address of your choosing.

Note: Electrum may be able to use recovery seeds from other wallets but at the time of this writing only Trezor and Ledger are known. Please Proceed with caution

If your funds are on a Trezor/Ledger address

In order to recover funds from your Trezor/Ledger you will need to use electrum. It has support for hardware wallets.

• Create a new electrum wallet and choose the option to restore/link it to a hardware wallet. Connect your Ledger/Trezor device and follow the Electrum instructions to connect/link the two together. Once completed make sure the address you are recovering from is displayed.

If your funds are on an Electrum 2FA address. Multisig Special Preparation Step (Generally if your Electrum Address starts with 3)

Electrum wallets that use 2FA or a third party Multisig signing service will automatically 'append' an address onto your transaction before sending it. This disrupts the normal flow of Omni protocol transactions and will cause your funds to be sent somewhere undesired so you must take the following special preparation steps to ensure funds are not sent somewhere unexpected and permanently lost.

• Create a new electrum 2FA wallet and choose the option to recover it from your recovery seed. It should ask you to disable 2fa and have the master keys in the restored wallet. This is what you want. Once created make sure the address you are recovering from is displayed.

Recover Tokens using Electrum

IMPORTANT! IMPORTANT! IMPORTANT! If your Electrum wallet is 2FA/Multisig/uses a third party signing service you MUST perform the 'Electrum 2FA/Multisig Special Preparation Step' first otherwise your funds could be permanently lost.

• Prerequisite: The following recovery method utilizes the Omni Protocol 'sendall' transaction which may not be supported by some exchanges. Unless you know what you are doing you should create (or login) to your Omniwallet.org account and use an address that was created by or imported with a private key into your Omniwallet for the recovery destination below. (These addresses are displayed in your Omniwallet account with a 'padlock' next to them)

• Make sure you have about 0.001 BTC on the address you need to recover/send the tokens from (Important, it has to be on the same address your the tokens are on otherwise it will not work)

• If you do not have an "Addresses" Tab displayed in your Electrum window goto the menu "Wallet->Addresses" to enable the address tab.

• On the Addresses tab, "Freeze" EVERY Address that has a BTC balance EXCEPT the Address you are recovering from (right click the address and choose freeze)

• Go to electrum settings window and open the preferences.

  • Go to the "Transactions" tab and make sure to UNCHECK both "use change address" and "use multiple change addresses"
  • Next go to the 'General' tab and change Base Units to 'BTC' . You can revert all these settings later if you want.

• Go to the 'Tools-> Pay To Many' option.

  • Carefully Paste in the following two lines
    • Ensure the OP_RETURN line is not changed/modified
    • Ensure you replace Your-Omni-Protocol-Enabled-Recovery-Destination-address with your actual recovery destination address:

OP_RETURN 6f6d6e690000000401, 0
Your-Omni-Protocol-Enabled-Recovery-Destination-address, 0.00000546

• Click the 'Pay' button and Adjust the fee's tab for desired confirmation speed (~5 blocks should be good) then click 'Finalize'
• Review the transaction for the following key points (example image displayed below)
  • Under Inputs:
    • TheAddressYourTokensAreStuckOn will be highlighted and displayed (there may be more than 1 inputs for that address, that is ok)
  • Under Outputs
    • First, you should see SCRIPT 6f6d6e690000000401 0. displayed
    • Next, you should see YouOmniEnabledRecover/DestiantionAddresshere 0.00000546 displayed
    • Last, you may see TheAddressYourTokensAreStuckOnDisplayedHere some#ofBTC displayed
      • This last field is a change output and optional depending on how much BTC your address has/spends creating this tx
    • WARNING If you see ANY OTHER ADDRESS except TheAddressYourTokensAreStuckOnDisplayedHere under the YouOmniEnabledRecover/DestiantionAddresshere immediately STOP and contact us for further assistance. Failure to stop could cause your funds to be sent somewhere unrecoverable. WARNING
  • 
• If everything checks out so far, click the 'Finalize' Button then the 'Sign' Button
  • Now Rerun/Recheck Everything you just did from the previous step after the transaction has been 'signed'
    • WARNING This is the last chance to check. If you see ANY OTHER ADDRESS except TheAddressYourTokensAreStuckOnDisplayedHere under the YouOmniEnabledRecover/DestiantionAddresshere immediately STOP and contact us for further assistance. Failure to stop could cause your funds to be sent somewhere unrecoverable. WARNING
• (Optional) If you are uncomfortable or unsure of anything you have done then BEFORE broadcasting the final tx contact the Omni Foundation support team for additional assistance/review
  • Include a screenshot of the final signed tx, as well as confirming what address your funds are stuck on and what address you wish to recover/send them to
• If everything still checks out click 'Broadcast' to complete the process