# How to Bind a Miner in FILLiquid

## Overview

Before borrowing from Filliquid, it is necessary to transfer the beneficiary of the Miner to the Filliquid  contract([f03157492](https://filfox.info/zh/address/f03157492)) and bind the Miner to the designated F4 wallet address as the Family.Then, the F4 address can perform the necessary operations on the protocol, such as borrowing, repayment, and unbinding for the Miner.Transferring the beneficiary of the Miner to the contract is a pledge operation, so the tokens held by the Miner cannot be withdrawn to any address other than the contract, which can effectively prevent the loss of funds and damage to the user's interests.

> Note: After changing the beneficiary address to the Filliquid contract, please refrain from directly using the Owner to perform a withdraw operation. Once a withdraw operation occurs, the involved tokens cannot be retrieved, so it's crucial to avoid accidental withdrawals as much as possible.

## Prerequisite

Binding the F4 address requires the specified signature of the Miner's Owner, thus ensuring the security of the operation process.

Before binding a Miner, users need a basic understanding of Filecoin's consensus mechanism and the ability to operate corresponding tools, including—but not limited to—changing Miner beneficiaries, information signing, etc.

Additionally, due to Filecoin's restrictions, a Miner with an Owner that is a multi-signature address is not supported. The Owner address must be an F3 address and cannot be an F1 or F4 address.

## Let's go

The following introduces the detailed process of binding Miner. Assuming that the user already owns a Miner and its Owner address, and the current Owner and Beneficiary addresses are consistent:

Enter the Filliquid dApp interface ( <http://dapp.filliquid.io>), click Connect Wallet, and bind the wallet.

<figure><img src="/files/oYmhTvP89OLf0wxr4EDw" alt=""><figcaption></figcaption></figure>

Next, click the Borrow tab, scroll down to the My Family tab, and click "Add Miner."

<div><figure><img src="https://j4etg0b7zhr.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=NmEzNjBlNDRhOTNmY2ZkM2E1MDIwYTIwOWZlY2RmMGJfRGNpb25JWEVzTkdsY1NvbzdFSU5QeVRDVTBkaXhJS1RfVG9rZW46WnR3VmJaTkwyb0t2Q3B4eDM1cWxyWnlVZ0VmXzE3MDc5OTYxMTk6MTcwNzk5OTcxOV9WNA" alt=""><figcaption></figcaption></figure> <figure><img src="/files/2KRAoHWM5oxhwcAbJtqh" alt=""><figcaption></figcaption></figure></div>

### Step 1

In the "Miner Address" input field, enter the miner address you want to bind (an address starting with f0), then click "Next."

<figure><img src="/files/mP5DgJNaE4i7X6diwLMZ" alt="" width="563"><figcaption></figcaption></figure>

### Step 2

Here, two binding methods will be displayed. Method 1 involves the miner completing the beneficiary transfer themselves. Method 2 involves authorizing Filliquid to complete the beneficiary transfer on behalf of the miner owner. Below, both methods are described separately.

<figure><img src="/files/yt6kRpi8DEjgT8krjKbv" alt="" width="563"><figcaption></figcaption></figure>

**Method 1:** Use the miner management tool to perform the operation yourself (recommended).

When modifying the Beneficiary, you need to provide three parameters: NewBeneficiary, Quota, and Expiration. These represent the new beneficiary address, the amount of the beneficiary, and the block height of expiration, respectively. You must fill in these values according to the table below; otherwise, the binding will fail.

| **NewBeneficiary** | [f03157492](https://filfox.info/zh/address/f03157492)                |
| ------------------ | -------------------------------------------------------------------- |
| **Quota**          | 99999999999999999999999999999999999999999999999999000000000000000000 |
| **Expiration**     | 9223372036854776000                                                  |

**Lotus**

{% code overflow="wrap" %}

```sh
#lotus-miner shell
lotus-miner actor propose-change-beneficiary --overwrite-pending-change --really-do-it f03157492 99999999999999999999999999999999999999999999999999000000000000000000 9223372036854776000 

#lotus-shed shell
lotus-shed actor propose-change-beneficiary --really-do-it --overwrite-pending-change [beneficiaryAddress quota expiration minerID]
```

{% endcode %}

**Venus**

{% code overflow="wrap" %}

```sh
damocles-manager util sealer actor --miner f0137621 propose-change-beneficiary  f03157492 99999999999999999999999999999999999999999999999999000000000000000000  9223372036854776000 
```

{% endcode %}

By using the above command, you can submit the beneficiary change proposal. Once the transaction is confirmed on the blockchain, you can click "Next" to proceed to Step 3.

###

**Method 2:** Authorize Filliquid to complete the beneficiary transfer on behalf of the Owner.

> Before proceeding, make sure the Owner address holds a sufficient amount of tokens, otherwise, the operation will fail. This step may take some time, so please be patient while waiting for the transaction to be confirmed on the blockchain.

In the interface, copy the Keys, and use the Owner address with a miner or other tool to sign this string. Then, paste the result into the input field and click "Next." [#how-to-complete-the-signature](#how-to-complete-the-signature "mention")

<figure><img src="/files/CAD5ZE88obdmM7Z63qxI" alt="" width="563"><figcaption></figcaption></figure>

### Step 3

In the interface, copy the Keys and use a miner or other tool to sign the string with the Owner address. Then, paste the result into the input field and click "Next." [#how-to-complete-the-signature](#how-to-complete-the-signature "mention")

<figure><img src="/files/RNkHp7Bz72Y3NbCGbmyr" alt="" width="563"><figcaption></figcaption></figure>

This step will activate the wallet.

Taking metamask as an example, please click confirm to continue.

Before this step, please ensure that the wallet address holds a certain number of tokens, otherwise the execution will fail. This step will take some time, so please be patient and wait for the transaction to be confirmed on the chain.

<figure><img src="/files/M67CCOG4kQBGj5nkFvRE" alt="" width="355"><figcaption></figcaption></figure>

Once the execution is successful, click OK.

<div><figure><img src="https://j4etg0b7zhr.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=ZmQ0NTQ5ZmQwOGRmMzM3Mjc0YjM2ZDcwMTIxY2M4YjhfY3p0cUN5TjFkVXRORWZpMHlHQUxqMnRiQzBadmVzcDlfVG9rZW46UVBKRGJFTnJNb3VJSVB4Z3NQT2w0cHlWZ3FkXzE3MDc5OTYyMTA6MTcwNzk5OTgxMF9WNA" alt=""><figcaption></figcaption></figure> <figure><img src="/files/TfiuJzh7OElWHW4tS7IN" alt=""><figcaption></figcaption></figure></div>

The binding is now complete.

## Exiting the Miner Family

In addition, users can also exit the Family if conditions permit. For this to occur, the miner must have zero debt, the bound Family has no bad debts, and the ratio of the remaining miner's debt to balance after exiting the Family is less than 50%, etc.

Go to the Filliquid dApp interface, click the Borrow tab , scroll down to the My Family tab, and click Unbind.

<figure><img src="/files/OyQQ6DCCxpNqFUfWkFBN" alt="" width="563"><figcaption></figcaption></figure>

On the next page, click "Next."

<figure><img src="/files/0NNbrFgsGGtXSR8gN9rV" alt="" width="563"><figcaption></figcaption></figure>

In the following interface, copy the Keys, sign the string with the Owner address through a miner or other tool, copy the result to the text box, and click Next.

Before this step, please make sure that the Owner's address holds a certain token. Otherwise, the execution will fail. This step will take some time; please be patient and wait for the transaction to be on the chain.

<figure><img src="/files/ku85zOZQrkZbZxHJPg3Z" alt="" width="563"><figcaption></figcaption></figure>

Click Confirm in the following interface.

<div><figure><img src="https://j4etg0b7zhr.sg.larksuite.com/space/api/box/stream/download/asynccode/?code=NDJiMjBkYTMyOGQwNjRlYjg3ZWI4NmU0Nzg4ZGY0YTBfT0l2NUVUZm51QXNqS210WWllS2llYkxLSFdIRXlVd1dfVG9rZW46U3VVWmI3bHdsbzZLQ2d4YW5pWmxHWHZOZ3JmXzE3MDc5OTYzNTA6MTcwNzk5OTk1MF9WNA" alt=""><figcaption></figcaption></figure> <figure><img src="/files/xZkO0B1sF7wxdEM7Y8OR" alt=""><figcaption></figcaption></figure></div>

This step will activate the wallet.

## How to complete the signature?

Try the corresponding command based on your miner type. The signature needs to be completed using the miner Owner's private key.

**Lotus**

```
lotus wallet sign [Owner wallet address] [Keys]
```

**Venus**

```
venus-wallet sign [Owner wallet address] [Keys]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.filliquid.io/storage-provider-guide/borrowing-filecoin/how-to-bind-a-miner-in-filliquid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.