GLIF Agent Website Tutorial Part I— Preparation Setup

Understand the main components of GLIF Agents, and get prepared to create an Agent on the GLIF website

In Part I of the GLIF Agent Setup Tutorial, we’re covering two topics:

1. Understand the different components of GLIF Agents and the basics of how they work.

2. Prepare to create an Agent on the GLIF website.

If you already understand the basics and you’re ready to get started creating your Agent on the website, you can skip Part I and go directly to Part II.

GLIF Agents — The Basics

1. Agent — An Agent is a smart contract that borrows FIL from GLIF. You will deploy, own, and operate your Agent smart contract yourself (covered in Part II of the tutorial). In order to borrow FIL, your Agent needs collateral, which it gets by taking ownership of your Filecoin miner(s). A more detailed description of Agents can be found here.

2. Agent owner wallet — The Agent’s owner wallet is the wallet that controls your Agent. Whoever is in control of your Agent’s owner wallet can operate your Agent. It is very important to keep the Agent’s owner wallet secure, which GLIF will help you do automatically.

When creating an Agent on the GLIF website, your Agent owner wallet will be a Filecoin multisig wallet with at least 2 signers, though 3 signers are recommended. This is the most secure type of wallet you can use to own your Agent.

Multisig wallets

A multisig wallet is a smart contract wallet with multiple signing parties (“signers”) attached to it. Multisigs enforce a minimum number of signers to approve a specific proposal before executing the transaction. Multisig wallets have a proposal/approval flow where:

• One of the multisig signers submits a proposal to execute a transaction

• The other multisig signers must approve the proposal

• Once the minimum number of signatures have approved the proposal, the transaction executes

GLIF Agent Multisig Owner Wallet Configuration

Multisig wallets on Filecoin are generally very flexible in their configuration, however, GLIF recommends a specific, more secure configuration with 3 signers:

1. Signer 1 — “the proposer” — is a Filecoin Snap wallet, also called “FILSnap wallet” (more on this in section 2)

2. Signer 2 — “the approver” — is a Filecoin Ledger wallet or another FilSnap Wallet

3. Signer 3 — “backup” — is another (different) Filecoin ledger wallet or another FilSnap Wallet

The GLIF Agent Multisig Owner Wallet is recommended to have a signing threshold of 2 — meaning, 2 signatures are required in order to execute a transaction. In other words:

1. Signer 1 (“the proposer”) proposes a transaction to the Agent Multisig Owner Wallet to perform some action (like borrow FIL from GLIF)

2. Signer 2 (“the approver”) approves the transaction proposed in step 1

3. The transaction executes successfully

If you lose any of your signer keys (either Ledger devices or the Filecoin Snap wallet) then you can easily replace it with a new one! This is why Multisig wallets are a more secure way to own your Agent.

Prepare to Create an Agent

In order to prepare for Agent creation, you’ll need 3 addresses:

1. FILSnap Wallet Address

2. FILSnap Wallet Address 2 or Ledger Address 1

3. FILSnap Wallet Address 3 or Ledger Address 2

For added security, it’s recommended that you use two separate Ledger devices, but it is OK to start with 1 Ledger Device and then switch to use 2 separate Ledger devices soon after.

Step 1: Generate FilSnap wallet addresses

To obtain a FilSnap wallet, you will need to:

1. Install MetaMask chrome extension https://metamask.io/download/. Please make sure that no other wallet chrome extensions are installed (this is a small usability issue in FILSnap that is currently being fixed).

2. Setup MetaMask by creating a seed phrase. Ensure you securely backup your seed phrase somewhere safe.

3. Once installed and configured, go to https://glif.io and click “Connect Wallet” in the top right corner. Select “Filecoin Snap” option:

1. Approve GLIF to install and connect to your FILSnap

This will come as 2 separate approvals in the MetaMask:

1. After creating the new FilSnap wallet, copy your newly created address from the top right corner of the GLIF website.

Step 2: Generate two Ledger addresses:

1. Setup your Ledger device (Nano S, Nano X)

2. Install the Filecoin app on your Ledger device (help)

3. Plug in your Ledger device to your computer, and click “connect wallet” in the top right of GLIF website

4. Select the Ledger option:

1. Copy the f1 address from the top right corner of the GLIF website as well. This will be your first Ledger address.

2. Click “Wallet” in the top left navigation bar:

1. To generate a second address, click “Add account” on the left side of the screen:

1. Copy the second address, and you’re all set for the next steps!

If you do not want to use your Ledger, you can set up another FilSnap address as your second or third address. It could work, but using a Ledger is recommended to enhance security.

Next steps

Once you have 3 Filecoin wallet addresses:

1. FILSnap wallet address

2. 2 Ledger wallet addresses

Then you are ready to move on to Part II of this tutorial.