Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add remote ledger tutorial #624

Merged
merged 1 commit into from
Sep 26, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 77 additions & 0 deletions content/en/tutorials/lotus/remote-ledger.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
title: "Using Ledger on a remote machine"
description: "This is a step-by-step guide on how to use Ledger on a remote machine"
lead: "This is a step-by-step guide on how to use Ledger on a remote machine"
draft: false
menu:
tutorials:
parent: "tutorials-lotus"
weight: 230
toc: true
---

Lotus users might want to use a Ledger device for the owner-address of an SPs for higher security. Often This tutorial is based on a setup with two different servers, one to run the `lotus daemon` while the other runs the `lotus-wallet` application.

## Prerequisites

- A lotus daemon running and being in-sync on a separate server, hereafter called `lotus-node operator`.
- A machine where you plan to plug in and use the Ledger device, hereafter called `ledger-provider`.

## As the "Ledger-provider" (Linux specific)

1. Install `lotus-shed` and `lotus-wallet` (Linux specific):

```shell
sudo apt install
```

## As the "Ledger-provider" (Mac specific)

1. Install `lotus-shed` and `lotus-wallet` (Mac specific):

Install the required depencies with:

```shell
brew install go jq pkg-config hwloc
```

Clone the Lotus-repo with:

```shell
git clone https://github.com/filecoin-project/lotus
```

Change directory to Lotus with:

```shell
cd lotus
```

Install `lotus-shed` and `lotus-wallet`

```shell
make lotus-shed lotus-wallet
```

## As the “lotus-node operator”

1. On your node that is in sync with the chain, setup a remote wallet backend:

In your `.lotus/config.toml` file:

```shell
[Wallet]
RemoteBackend = "http://127.0.0.1:1777"
```

2. Import the wallet:

```shell
lotus wallet import --format json-lotus
```

And paste the JSON-line that was given to you in the third step in the `As the "Ledger-provider"` section.

3. That is it! 🚀

As long as the ssh reverse-tunnel is alive, you will be required to confirm transactions on the Ledger whenever the Lotus node makes them.