Multi‑Signature Wallet Help & User Guide
Multi‑signature (multi‑sig) wallets provide an extra layer of security by requiring multiple signatures to authorize transactions. Instead of a single key being able to spend funds, you can distribute signing authority across multiple wallets or users, with each signer carrying a configurable weight. A transaction is only valid once the sum of the weights reaches the configured threshold.
Use this guide to understand each component of the multi‑sig manager and learn how to configure, fund and use multi‑sig accounts securely.
Key Concepts
- 📍 Signer: an XRPL address authorised to sign on behalf of the multi‑sig account. Each signer has an associated weight.
- ⚖️ Weight: an integer representing the relative importance of a signer. Higher weights contribute more toward meeting the threshold.
- 🎯 Threshold: the total weight required to approve a transaction. For example, if your threshold is 3 and you have three signers with weights 2, 1 and 1, you could approve a payment with the first signer (weight 2) plus any one of the others (2 + 1 ≥ 3).
- 🔑 Master Key: the primary key of the multi‑sig account. By default the master key can authorise transactions by itself. For extra security you can disable the master key so that only your configured signers can spend funds.
- 🌐 External Signer: some signers may use an external wallet (outside of Gopnik). You can flag a signer as external by checking the External checkbox when adding them. External signers will need to scan a QR code or sign manually; no user token is required.
- 💰 Funding Amount: when you create a multi‑sig wallet, you must fund it with enough XRP to meet the base reserve and transaction fees. Consider funding it with more XRP if you plan to send multiple transactions.
Creating a Multi‑Sig Wallet: Step‑by‑Step
- Add signers: use the Add Signer from Your Wallets dropdown to pick any of your own wallets, or type a manual address. Assign a weight to each signer. If a signer uses an external wallet, check the External box to mark them as such. External signers do not require a user token.
- Review & edit signers: after adding signers they appear in a table below. You can adjust weights or remove signers before creating the account.
- Configure threshold & funding: choose the minimum total weight required to approve transactions. Set the funding amount in XRP and select which of your wallets will fund the new account. If you check Disable Master Key, the original account key will no longer be able to sign—only your designated signers will.
- Create your multi‑sig wallet: once at least one signer is added, click Create Multi‑Sig. Gopnik will generate a fresh XRPL account, fund it and attach your signers. If you disabled the master key, this will be done automatically. Each signer flagged for Xaman will receive a notification.
After creating the account you can see it listed in the Multi‑Signature Accounts table on the main page. From there you can view balances, toggle the master key and send multi‑sig payments.
Using Your Multi‑Sig Wallet
The multi‑sig manager shows each account’s status and provides tools to send payments.
- 💼 Account list: displays the address, threshold, signers and current XRPL status. Use the View button to fetch balances (XRP and tokens) or Hide to collapse them.
- 🔘 Toggle master key: click the Enable or Disable button to control whether the master key can sign.
- 📨 Send payment: fill out the destination and amount, then click Prepare & Sign. Gopnik will gather signatures from all locally available signers and generate QR codes for any external signers. Once the required weight is met, the transaction is submitted to the XRPL.
For more advanced workflows, such as adjusting signers or importing accounts from CSV/JSON, use the dedicated sections on the main page. Remember to keep your signers’ private keys secure—once set up, multi‑sig wallets distribute trust and help prevent single‑point failures.