Skip to content

Commit

Permalink
Merge remote-tracking branch 'upstream/main'
Browse files Browse the repository at this point in the history
  • Loading branch information
johnnymatthews committed Oct 12, 2023
2 parents 90ccf33 + bdd03aa commit 45f2a17
Show file tree
Hide file tree
Showing 9 changed files with 25 additions and 58 deletions.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
45 changes: 20 additions & 25 deletions basics/assets/metamask-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@ description: >-

# Metamask setup

## Using Chainlist
## Using ChainID

Chainlist is a website that lets users easily connect their wallets to EVM-compatible blockchains. Chainlist is managed by [DeFi Llama](https://defillama.com/). Chainlist is the simplest way to add the Filecoin network to your MetaMask wallet.
ChainID.network is a website that lets users easily connect their wallets to EVM-compatible blockchains. ChainID is the simplest way to add the Filecoin network to your MetaMask wallet.

{% tabs %}
{% tab title="Mainnet" %}
1. Navigate to [chainlist.network](https://chainlist.network).
1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Mainnet`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to _Allow this site to add a network_.
Expand All @@ -25,7 +25,7 @@ You can now use MetaMask to interact with the Filecoin network.
{% endtab %}

{% tab title="Calibration" %}
1. Navigate to [chainlist.network](https://chainlist.network).
1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Calibration`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to _Allow this site to add a network_.
Expand All @@ -37,7 +37,7 @@ You can now use MetaMask to interact with the Filecoin network.
{% endtab %}

{% tab title="Local testnet" %}
1. Navigate to [chainlist.network](https://chainlist.network).
1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Local testnet`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to _Allow this site to add a network_.
Expand All @@ -51,7 +51,7 @@ You can now use MetaMask to interact with the Filecoin network.

## Manual process

If you can't or don't want to use Chainlist, you can add the Filecoin network to your MetaMask manually.
If you can't or don't want to use ChainID, you can add the Filecoin network to your MetaMask manually.

### Prerequisites

Expand Down Expand Up @@ -85,7 +85,7 @@ The process for configuring MetaMask to use Filecoin is fairly simple but has so
{% endtab %}
{% endtabs %}

7. Pick one block explorer from the [Networks section](../../networks/mainnet/README.md), and enter the URL into the **Block explorer (optional)** field.
7. Pick one block explorer from the [Networks section](../../networks/mainnet/), and enter the URL into the **Block explorer (optional)** field.
8. Review the values in the fields and click **Save**.
9. The Filecoin network should now be shown in your MetaMask window.
10. Done!
Expand All @@ -101,46 +101,41 @@ MetaMask is compatible with the Ledger hardware wallet. Follow these instruction
Before you can connect MetaMask to your Ledger, you must install the Filecoin Ledger app on your Ledger device.

1. Open Ledger Live and navigate to **My Ledger**.
1. Connect your Ledger device and unlock it.
1. Confirm that you allow My Ledger to access your Ledger device. You can do that by clicking both buttons on your Ledger device simultaneously.
1. Go back to Ledger Live on your computer.
1. In **My Ledger**, head over to **App catalog** and search for **Filecoin**.
1. Click **Install**.
2. Connect your Ledger device and unlock it.
3. Confirm that you allow My Ledger to access your Ledger device. You can do that by clicking both buttons on your Ledger device simultaneously.
4. Go back to Ledger Live on your computer.
5. In **My Ledger**, head over to **App catalog** and search for **Filecoin**.
6. Click **Install**.

For more details on the official Filecoin Ledger app, [check out the Ledger documentation](https://support.ledger.com/hc/en-us/articles/4402721277329-Filecoin-FIL-?docs=true).
For more details on the official Filecoin Ledger app, [check out the Ledger documentation](https://support.ledger.com/hc/en-us/articles/4402721277329-Filecoin-FIL-?docs=true).

### Enable expert-mode

MetaMask requires that the Filecoin app on your Ledger device is set to _Expert mode_.

1. Open the Filecoin app on your Ledger device.
1. Open the Filecoin app on your Ledger device.

![A Ledger with the Filecoin app open.](../../.gitbook/assets/basics-assets-metamask-ledger-1-filecoin-app.jpg)

1. Use the buttons on your device to navigate to **Expert mode**.
2. Use the buttons on your device to navigate to **Expert mode**.

![A Ledger showing the expert mode option.](../../.gitbook/assets/basics-assets-metamask-ledger-2-expert-mode.jpg)

1. Press both buttons simultaneously to _enable_ **Expert mode**.
3. Press both buttons simultaneously to _enable_ **Expert mode**.

### Connect to MetaMask

Once you have installed the Filecoin app on your Ledger device and enabled expert mode, you can connect your device to MetaMask.

1. Open your browser and open the MetaMask extension.
1. In the **Accounts** menu, select **Add hardware wallet**.
2. In the **Accounts** menu, select **Add hardware wallet**.

![MetaMask with the 'Add hardware wallet' option highlighted.](../../.gitbook/assets/basics-assets-metamask-ledger-3-add-hw-wallet.jpg)

1. Select **Ledger**
3. Select **Ledger**

![MetaMask showing the available hardware wallet options.](../../.gitbook/assets/basics-assets-metamask-ledger-4-select-ledger.jpg)

1. A list of accounts should appear. Select an `0x...` account.
4. A list of accounts should appear. Select an `0x...` account.

![MetaMask showing multiple accounts from a Ledger device.](../../.gitbook/assets/basics-assets-metamask-ledger-5-select-account.jpg)

1. Done!
5. Done!

That's it! You've now successfully connected your Ledger device to MetaMask. When you submit any transactions through MetaMask using this account, the Filecoin Ledger app will prompt you for a confirmation on the Ledger device.

Expand Down
36 changes: 4 additions & 32 deletions basics/assets/transfer-fil.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,39 +43,11 @@ The process for sending FIL from a Filecoin `f` address to an Ethereum-style `0x

### Ledger device

Currently, Ledger Live has not supported `0x` or `f4` addresses yet, so you cannot directly use it to send FIL tokens to a `0x` or `f4` address. However, you can connect your Ledger device to the [Glif.io](https://glif.io) wallet and transfer FIL from a Filecoin `f1/f3` address to an Ethereum-style `0x` address. This method is more secure than the [Hot wallet](transfer-fil.md#hot-wallet) method detailed below since your private keys never leave your Ledger device.
Ledger Live supports sending to a Filecoin `f4` address, which has an automatic `0x` equivalent that you can look up on any [block explorer](../../networks/mainnet/explorers.md). This allows you to directly transfer your FIL to an Ethereum-style `0x` address using its `f4` equivalent.

In this method, you will connect your Ledger device to the [Glif.io](https://www.glif.io/) website and send FIL from your `f` address on the Ledger to an Ethereum-style `0x` address.

1. Ensure your Ledger device is connected to your computer, then log in to the Ledger Live dashboard and update your Ledger device’s Filecoin app to version `0.22.9`.

<figure><img src="../../.gitbook/assets/basics-assets-transfer-fil-ledger-live.webp" alt=""><figcaption></figcaption></figure>

2. Make sure the Filecoin app is open on your Ledger wallet. Your Ledger should display **Filecoin ready**.
3. Go to [Glif](https://glif.io) and click **Connect Wallet**.

<figure><img src="../../.gitbook/assets/basics-assets-transfer-fil-connect-wallet.webp" alt=""><figcaption></figcaption></figure>

4. Select **Ledger (Filecoin)** and unlock your Ledger device, selecting the Filecoin application.

![Choose Ledger(Filecoin)](../../.gitbook/assets/basics-assets-transfer-fil-ledger-filecoin.webp)

5. Once connected, you should see the details of your Filecoin account stored on your Ledger. Click **Send FIL**.

![Send FIL](../../.gitbook/assets/basics-assets-transfer-fil-send-fil.webp)

6. Enter the `0x` address you wish to send to. Glif will automatically convert the `0x` address into an `f4` address.

![Transfer details](../../.gitbook/assets/basics-assets-transfer-fil-send-detail.webp)

7. Enter the amount of FIL you want to send. Click **Send**.
8. Verify the information is correct and accept the transaction on your hardware device.
9. The transferred FIL will show up at the Eth-style `0x` address once this transaction is finalized on-chain, which will take 60 - 90 seconds.
10. You can check the status of this transfer by clicking the transaction ID link.

![Transaction Detail on Filfox](../../.gitbook/assets/basics-assets-transfer-fil-transaction-detail.webp)

You can also follow this [Guide: How to transfer FIL from Ledger to MetaMask (0x)](https://blog.filecointldr.io/guide-how-to-transfer-fil-from-ledger-to-metamask-0x-9760f869b28e).
{% hint style="warning" %}
Sending directly to a `0x` address does not work in Ledger Live. You must use the `f4` equivalent.
{% endhint %}

### Hot wallet

Expand Down
2 changes: 1 addition & 1 deletion reference/general/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ Developer tools, API clients & storage services that developers can use to build
### Wallet-related tools

* [Filecoin Rosetta API Proxy](https://github.com/Zondax/rosetta-filecoin) - [Rosetta](https://www.rosetta-api.org/) is an API standard created by Coinbase for a consistent interface to many chains for wallets and exchanges.
* [FilSnap MetaMask Plugin](https://metamask.io/flask/) - MetaMask has a new plugin system currently still in beta that developers can try out. The MM UI will not change but Filecoin keys are in the MM vault. Try it with [https://filsnap.chainsafe.io/](https://filsnap.chainsafe.io/)
* [FilSnap MetaMask Plugin](https://metamask.io/flask/) - MetaMask has a new plugin system currently still in beta that developers can try out. The MM UI will not change but Filecoin keys are in the MM vault.

### Node Infrastructure & APIs

Expand Down

0 comments on commit 45f2a17

Please sign in to comment.