> ## Documentation Index
> Fetch the complete documentation index at: https://custodydocs-en.chainup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FIL Multisig Wallet

## Overview

The Filcoin mainnet provides functionality to manage wallet without private keys, known as FIL multi-signature (Multisig) wallets. Users can effectively manage these wallets by initiating proposals and voting on them.

FIL multi-signature wallets are suitable for the following business scenarios:

**1. Joint management of FIL assets by multiple shareholders:** Multiple shareholders can collectively manage FIL assets through multi-signature wallets. Manage and control your FIL assets scientifically based on the set number of shareholders and threshold.

**2. Multi-member management of FIL nodes:** You can use a multi-signature wallet as the owner or beneficiary of FIL nodes, achieving the functionality of multi-member management of FIL nodes.

### Terms and Definitions

**Signer:** Participants in the multi-signature wallet.

**Threshold:** Specific conditions that multi-signature wallet proposals need to meet to be recorded on the blockchain.

**Proposal:** Transactions initiated by members of the multi-signature wallet.

**Proposal Voting:** Members of the multi-signature wallet confirm valid proposals that have not reached the threshold.

**f1 Address:** Address generated based on the private key using the secp256k1 algorithm on the FIL mainnet.

**f3 Address:** Address generated based on the private key using the BLS algorithm on the FIL mainnet.

**f2 Address:** Address generated on the FIL mainnet using a specific algorithm without a private key.

**f0 Address:** Field identifier in the FIL mainnet for the different types of new addresses mentioned above, equivalent to a code.

## FIL Multi-Signature Wallet Transaction Flow

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/mpc-fil-msign1_en.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=66cca9263de56a0aab1e793c8b89653e)

Signers in the multi-signature wallet initiate proposal transactions to the multi-signature wallet. Once the proposal is on-chain, other multi-signature members vote on it and confirm it on the blockchain. The blockchain checks whether the proposal has reached the threshold set by the current multi-signature wallet. Once the threshold conditions are met, the proposal is executed.

## FIL Multi-Signature Features Supported by MPC system

ChainUp Custody's MPC system now supports various features, including creating and managing FIL multi-signature wallets, managing signers and thresholds for multi-signature wallets, and performing balance withdrawals and proposal handling for multi-signature wallets.

### Create and Manage Multi-Signature Wallets

**1. Open Functionality**

Log in to your ChainUp Custody account, select the MPC system, and choose the "Discovery" - "FIL Multi-Signature Wallet" function.

**2. Use FIL Multi-Signature Wallet Function**

In the FIL Multi-Signature Wallet Management function, you can choose to create a new multi-signature wallet or add an existing one:

**Create Multi-Signature Wallet:** If there is no suitable multi-signature wallet available, you can choose to create a brand new one.

> [!TIP]
>
> When creating a multi-signature wallet, make sure to choose the correct address for publishing the creation transaction and enter the required signer and threshold information accurately. Once the transaction is successfully on-chain, you will have successfully created a multi-signature wallet.

**Add Multi-Signature Wallet:** If an address in your MPC system has been set as a signer for a multi-signature wallet, you can use the MPC function to manage your multi-signature wallet.

> [!TIP]
>
> Enter the address of the multi-signature wallet you currently manage, and you can successfully add the multi-signature wallet you manage.

### Manage Signers and Thresholds for Multi-Signature Wallets

ChainUp Custody's MPC system supports users in proposing and voting on proposals to edit signers and thresholds for multi-signature wallets.

**Edit Signers**

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign1.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=7df0f13c16beeecea72dfd244d0858a4)

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign2.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=97ebfff3b59cfecaa28b535ca7e8e8b3)

In the multi-signature wallet page, click on "More," then select "Edit Signers" to initiate a proposal to edit the signers for that multi-signature wallet.
You can choose to add or remove signers. Once you have selected and entered the relevant parameters, the transaction is on-chain, and the proposal is successfully initiated.

**Edit Thresholds**

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign3.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=1015e1479498986b8503d1e5eaadc0bc)

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign4.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=90da18734459e8410baa3bdeab3cbf09)

In the multi-signature wallet page, click on "More," then select "Edit Thresholds" to initiate a proposal to edit the threshold for that multi-signature wallet.
Enter the new threshold that complies with the rules. Once the transaction is on-chain, the edit threshold proposal is successfully initiated.

### Balance Withdrawal for Multi-Signature Wallets

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign5.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=3c3254f10532cec8758c00341ef100b8)

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign6.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=f96f3304843f29ea3518a47bfc73313e)

![](https://mintcdn.com/zhp-9d4bf690/T9H5l7XSDZLBW2E9/images/help-center/filmsign7.png?fit=max\&auto=format\&n=T9H5l7XSDZLBW2E9\&q=85\&s=31a20e9fc24fcc7981ac1a28e4cd67cc)

ChainUp Custody's MPC system FIL multi-signature management tool supports initiating proposals for balance withdrawals from FIL multi-signature wallets.

You can directly click the "Withdraw" button on the multi-signature wallet page, or use the left swipe shortcut operation on the multi-signature wallet list page to choose the withdrawal operation.

Enter the amount you wish to withdraw and the target address. Wait for the transaction to successfully go on-chain. Your balance withdrawal proposal will be successfully initiated.

### Proposal Handling

ChainUp Custody's MPC system has FIL multi-signature management tools and supports the functionality of handling proposals for FIL multi-signature wallets.

**Proposal Voting**

After creating or adding a multi-signature wallet, proposals that require your vote will be presented as tasks. Completing these tasks allows you to vote and process related proposals.

**Manual Proposal Handling**

In the multi-signature wallet page, choose "More" and select "Handle Proposal."

Enter the TXID of the proposal you wish to handle, and you can vote on that proposal.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.