A Tour of the Glif Safe
What is the Glif Safe? A Filecoin Multisig Wallet
If you're familiar with multisig wallets, you may want to skip this section. You might also be looking for how to use Glif with MetaMask or Ledger.
The Glif Safe (name inspired by Gnosis Safe), is a multisig wallet for the Filecoin network. At its core, a multisig wallet is a mechanism for securely managing crypto-assets. A multisig wallet has a few aspects:
- Rules - The rules govern how a multisigs assets are managed by its owners (see below).
- Owners - The owners (aka "signers") are those who have the required privilege to propose, approve, and cancel multisig transactions.
- Balance - The amount of liquid funds available to withdraw from a multisig wallet
Imagine a multisig wallet like a shared bank account with your friends or your family. The rules for how assets are spent from that bank account are predetermined. For example, if you share a bank account with 5 family members, maybe 3 out of 5 of the family members have to "approve" a withdrawal of funds in order for it to "execute". Multisig wallets do this on the blockchain, programmatically and autonomously.
Create up a Safe
To set up a new Safe, follow these instructions:
- Make sure you're connected to https://safe.glif.io
2. Choose a login option (Ledger or MetaMask FILSnap).
3. Connect a wallet account that you'd like to make the original owner of your Safe.
4. When prompted to enter your Safe ID (the address of your Filecoin Multisig wallet), click "Create one" in purple below the input field.
Next, you'll be ready to configure your Safe! Continue to the section below.
Configuring your Safe
There are 5 variables to consider when creating a safe:
- The owners (signers).
- The required approval threshold (the number of signatures required in total for a transaction to "pass" and consequently "execute").
- The initial funding amount (in FIL).
- The vesting duration (determines the duration, in blocks, to distribute the initial funding amount).
- The start epoch of vesting (determines the block the vesting amount should begin at). Note - the Safe creator interface will populate the form field with the latest Filecoin block (vesting starts now).
The Safe creator interface will guide you through each, step by step, to create your desired Safe configuration. Here's an example of what your Safe might look like right before you create it:
Withdraw Filecoin from your Safe
First, from your Safe dashboard, click the green "Withdraw" button. Note, the screenshots below display a hypothetical Safe on a testnet.
Next, enter the recipient who should receive the Filecoin withdrawal.
Add the amount of Filecoin to withdraw.
Review the transaction fee.
Lastly, accept the transaction with your connected wallet.
If your Safe requires more than one approval in order to execute a transaction, another Safe owner(s) will have to approve your proposal to withdraw Filecoin in order for it to take effect.
Adding Safe owners
To add an owner to your Safe, first visit the Admin page and click "Add Signer". Note, the screenshots below display a hypothetical Safe on a testnet.
After accepting the warning, add a Filecoin address to make a new owner of your Safe.
Next, review the transaction fee.
Lastly, accept the transaction with your connected wallet.
If your Safe requires more than one approval in order to execute a transaction, another Safe owner(s) will have to approve your proposal to add a signer in order for it to take effect.
Removing Safe owners
To remove an owner from your Safe, first visit the Admin page and click the "X" button next to the owner you wish to remove. Note, the screenshots below display a hypothetical Safe on a testnet.
After accepting the warning, review the transaction fee and click "Next".
Lastly, accept the transaction with your connected wallet.
If your Safe requires more than one approval in order to execute a transaction, another Safe owner(s) will have to approve your proposal to remove a signer in order for it to take effect.
Changing a Safe owner
Instead of removing an owner and adding another, you can change ownership of your Safe in a single transaction. To change an owner of your Safe, first visit the Admin page and click the pencil icon next to the owner you wish to change. Note, the screenshots below display a hypothetical Safe on a testnet.
After accepting the warning, enter a Filecoin address to make a new owner of your Safe.
Next, review the transaction fee.
Lastly, accept the transaction with your connected wallet.
If your Safe requires more than one approval in order to execute a transaction, another Safe owner(s) will have to approve your proposal to change a signer in order for it to take effect.
Approving a proposal
If your safe has more than one owner, and a required number of approvals greater than 1, you'll have to approve proposals in order for them to take effect. To do this, first head to the Proposals tab in your Safe. Note, the screenshots below display a hypothetical Safe on a testnet.
See how the proposals that require your approval are highlighted with "Action required" text on the right side.
Next, click into the proposal you wish to approve.
Click the green "Approve" button.
Review the transaction fee.
Lastly, accept the transaction with your connected wallet.
You've successfully approved a proposal! Note that other safe owners may also need to approve a proposal in order for it to take effect.
Canceling a proposal
If you created a proposal in your Safe, you have the ability to cancel it. In order to do this, first head to the Proposals tab in your Safe. Note, the screenshots below display a hypothetical Safe on a testnet.
Next, click on the proposal you'd like to cancel. Note, you can only cancel proposals that your owner address proposed.
Next, click the red "Cancel" button.
Lastly, accept the transaction with your connected wallet.
We hope you enjoyed the tour of the Glif Safe!