Peg using Ledger

Summary

This document explains how to try the 2-way peg mechanism using Ledger.

• General requirements
• Lock: From BTC to RBTC
• Release: From RBTC to BTC

General Requirements

• Clone this project.
• You need a Ledger with Bitcoin and RSK Apps installed. We recommend you to have Ledger Live and review this tutorial Use the Manager.
• You need to have Electrum. Install it and configure it to be used with Ledger.
• Set the correct RSK public node in the config.json file depending on the network you are going to use.

From BTC to RBTC

❗ Before start: read lock requirements

1. Set a derivation path in the key derivationPath in config.json file. You should use BTC mainnet/testnet derivation path 44'/0'/0'/0/0.

2. Unlock Ledger and open the Bitcoin App.

3. In your terminal exec node ./utils.js. After that, you'll get the BTC address derived from the derivation path that you've specified, and also the RSK Federation Address. Here is a response example:

Using web3 https://public-node.testnet.rsk.co
Federation Address: 2M...4B
BTC Address
Derivation Path: 44'/1'/0'/0/0
{ 
  publicKey: '0404e3afdccf84c4b80e3eaab5664fc9814e283f9a16da32fca99d099df4857bc4baad8a78bf5aa60d14e5f6ad8650bede1c2347aceb4a2efe6afb461047f2bfb0',
  bitcoinAddress: 'mow8mDqiUCf17DxE9uV97SvDvzfYjrBzEG',
  chainCode: '491bf74110805f8f118f92d66abc92cbee5ce57bd24ab426bf00dd6b913f5348' 
}

3. Send some funds to the address bitcoinAddress obtained.

4. You need to whitelist the bitcoinAddress in the RSK network (what's to be whitelisted?)

5. Use Electrum to send some BTC to the Federation Address (you got it in step 2) from bitcoinAddress obtained. To do that:

   • Open Electrum
   • Go to Addresses Tab
   • Find the whitelisted address (your bitcoinAddress)
   • Right click over it
   • Select the option "Spend From":
   • Finally do a payment to the RSK Federation Address The minimum amount to send is 0.01 BTC

6. Wait the stipulated time.

7. Then use our Testnet Explorer or Mainnet Explorer to see your RBTC balance.

From RBTC to BTC

❗ Before start: read release requirements.

1. Set a derivation path in the key derivationPath in ./config.json file. You should use BTC mainnet/testnet derivation path 44'/0'/0'/0/0.

2. Set the correct chainId in the config.json file. It depends on the network you are going to use (See EIP-155).

3. Choose the value to send and set it in hexa in valueToSend in config.json file. The minimum amount to send is 0.005 RBTC for Testnet and 0.008 RBTC for Mainnet

4. Unlock Ledger and open RSK App.

5. Exec node ./to-btc.js. Here is an output example:

   Using web3 https://public-node.testnet.rsk.co
   Sender address:  0x4820a5D22c3Ba3DA1606756DC85b14cdEcf098d0
   Account 0x0000000000000000000000000000000001000006
   Gas 0xABE0
   Gasprice 0x1
   Nonce 0x1
   { nonce: '0x1',
     gasPrice: '0x1',
     gas: '0xABE0',
     value: '0x16345785D8A0000',
     to: '0x0000000000000000000000000000000001000006',
     v: 31,
     r: 0,
     s: 0,
     data: '' }
   Raw tx:  f867010182abe094000000000000000000000000000000000100000688016345785d8a00008061a056c169b8a889e4b1352b89808d1315e7bb23b1dbec81299d076b4a6879bd0b45a005a9979c7684e49c9d6b0fe5f40289910606b4cee09a3431ed85ce77fb223fd1
   0x570f61b0f9e8a3d8f044b059e9c0386778df2ed1a74f18cea46d2d02dcb3b77a
   

6. Wait the stipulated time for your funds to arrive to your BTC address. This address is the same that you generated in the previous section.