Skip to content

Latest commit

 

History

History
74 lines (39 loc) · 5.2 KB

NON_BITGO_RECOVERY.md

File metadata and controls

74 lines (39 loc) · 5.2 KB
Raw

Non BitGo Recovery Instructions

Build a transaction from a hot wallet using the KeyCard in order to recover funds without using any BitGo services.

What happens in a Non-BitGo recovery?

  1. You are asked to provide the Coin Name that you want to recover.

  2. You are asked to provide the Key Recovery Service. This is the key recovery service that you choose to manage your backup key. If you have the encrypted backup key, you may leave this blank. There are 3 options Keyternal, BitGo KRS, and Coincover. Keyternal and BitGo KRS support BTC and ETH only. Coincover supports BTC, ETH, XLM, XRP, DASH, ZEC, LTC, BCH.

  3. You are asked to provide the Box A Value. This is your encrypted user key as found on your recovery KeyCard.

  4. You are asked to provide the Box B Value. This is your encrypted backup key as found on your recovery KeyCard if you have kept Key Recovery Service as blank. This is your backup public key for the wallet if you have selected a value in Key Recovery Service.

  5. The next field will be different based on coin type

    1. For UTXO based coins, you are asked to provide the BitGo Public Key as found on your recovery KeyCard.

    2. For Coins like Stellar, Ripple, and EOS, Root Address of the wallet needs to be provided.

    3. For Ethereum, Ethereum Proof of Work, ERC20 Token, and Avalanche C-Chain, Wallet Contract Address needs to be provided. This is the ETH or AVAXC address of the wallet contract. This is also the wallet's base address. For ERC20 Token, Token Contract Address needs to be provided. This is the address of the smart contract of the token to recover. This is unique to each token and is NOT your wallet address

  6. You are asked to provide Wallet Passphrase. This is the password that you had set at the time of wallet creation.

  7. You are asked to provide the Destination Address (The address where you want to receive your recovered funds).

  8. For Solana, you may optionally provide a Public Key and a Secret Key for a durable nonce. If provided, the broadcast 60 second broadcast window of Solana transactions will be extended.

  9. For Bitcoin, Litecoin, Dash, Zcash, Bitcoin Gold, Tron, Bitcoin Cash, Near, Polkadot, and Solana, Address Scanning Factor needs to be provided. By default, it's value is 20 and can be changed if needed. The tool scans the addresses of the wallet to find the unspents. If it doesn't find unspents in 20 consecutive addresses, then it will stop scanning and generate a recovery transaction. For eg: If your funds are stuck in addresses with indices 10, 25 and 50 and you keep scanning factor as 20. Then the tool will stop after scanning till 46th index, because it didn't find unspents for 20 consecutive addresses from 26th address onwards. So in order to recover the funds in the address with 50th index, you will have to increase the scanning factor to a higher value.

  10. For Near, Polkadot, and Solana, Starting Scan Index needs to be provided. By default, it's value is 0 and can be changed if needed. The field specifies the starting index within a wallet to begin scanning for unspents.

  11. For Ethereum, Ethereum Proof of Work, and ERC20 Token, Max Fee Per Gas Price and Max Priority Fee Per Gas in Gwei needs to be provided. The value should be between 1 Gwei and 2500 Gwei. The default is 20 Gwei for Max Fee Per Gas and 10 Gwei for Max Priority Fee Per Gas. If there is not enough Gwei in the backup key address gas tank, you will need to fund your backup key address. WRW will report the backup key address if there is not enough Gwei in it.

  12. For Ethereum, Ethereum Proof of Work, ERC20 Token, and Avalanche C-Chain, Gas Limit needs to be provided. The value should be between 30,000 and 20,000,000. The default is 500,000 units of gas.

  13. For Avalanche C-Chain, Gas Price needs to be provided. The value should be between 1 Gwei and 2500 Gwei. The default is 30 Gwei.

  14. An API Key token from etherscan.com needs to be provided for certain recoveries.

  15. For UTXO based coins like Bitcoin, Litecoin, Dash, Zcash, Bitcoin Gold, and Bitcoin Cash, the key is from https://blockchair.com/.

  16. For Ethereum and ERC20 token, the key is from https://etherscan.io/.

  17. For Avalanche C-Chain, the key is from https://snowtrace.io/.

  18. For Algorand, you must use your own node to broadcast recovery transactions.

  19. The SDK determines the amount of an asset that you can recover, and then builds a fully-signed transaction to a destination address.

  20. To finish the recovery, broadcast the fully-signed transaction on the network using a blockchain explorer. Some blockchain explorers to broadcast the transaction are as follows:

    Avalanche C-Chain transactions: https://snowtrace.io/pushTx

    Blockchair (Supports multiple coins): https://blockchair.com/broadcast

    Bitcoin Gold transactions: https://btgexplorer.com/sendtx

    EOS transactions: EOS.md

    Ethereum and ERC20 Token transactions: https://etherscan.io/pushTx

    Ethereum Proof of Work transactions: ETHW.md

    Near transactions: NEAR.md

    Ripple transactions: https://bithomp.com/submit/

    Stellar transactions: https://laboratory.stellar.org/#txsubmitter?network=public

    Tron transactions: https://www.btcschools.net/tron/tron_broadcast_tx.php