wallet:multisig:dkg:create
Performs the entire process of creating a multisignature account using the Distributed Key Generation (DKG) protocol.
This CLI command is a shortcut for running the following commands in sequence:
This command has built in retry logic to handle failures and will not create the account until the DKG process is successfully run.
Further more, a primary benefit of this command is when using the --ledger
flag, the command will retrieve the identities from the Ledger device and handle retries/ failures for you.
Usage
ironfish wallet:multisig:dkg:create
The example below demonstrates how to run the entire DKG process for a group of two participants, a minimum of two signers, and creating an identity using a Ledger device.
> ironfish wallet:multisig:dkg:create \ --ledger \ --name MyMultisigAccount \ --minSigners 2 \ --totalParticipants 2
Getting Ledger Identity... done Collecting Participant Info and Performing Round 1... Identity for ledger: 72b58... Enter 1 identities of all other participants (excluding yours) Participant Identity #1: 72f9ec850... Round1 on Ledger... Ledger Locked ? Ledger Locked. Unlock and press enter to retry: Retry Round1 on Ledger... done ============================================ Round 1 Public Package for multisigLedgerDkg: 72b58... ============================================ Share your Round 1 Public Package with other participants. Enter 1 Round 1 Public Packages (excluding yours) Round 1 Public Package #1: 72f9ec... Performing DKG Round 2... Round2 on Ledger... done ============================================ Round 2 Public Package for multisigLedgerDkg: 72b58... ============================================ Share your Round 2 Public Package with other participants. Enter 1 Round 2 Public Packages (excluding yours) Round 2 Public Package #1: 72f9ec... Round3 on Ledger... done Getting Ledger DKG keys... done Getting Ledger Public Package... done Account multisigLedgerDkg imported with public address: 89fcb... Creating an encrypted backup of multisig keys from your Ledger device... Backup DKG Keys... done Encrypted Ledger Multisig Backup: 40734b... Please save the encrypted keys shown above. Use `ironfish wallet:multisig:ledger:restore` if you need to restore the keys to your Ledger. A copy of your encrypted keys have been saved at /Users/dev/.ironfish/ironfish-ledger-multisigLedgerDkg.txt Multisig account created successfully using DKG!
Flags
Flag | Description | Default |
---|---|---|
-n, --participant | The name of the secret to use for encryption during DKG | |
-a, --name | The name to set for the multisig account to be created | |
--ledger | Perform operation with a ledger device | false |
--createdAt | Block sequence to begin scanning from for the created account | Node's chain head |
--server | Connect to a multisig broker server | |
-c, --connection | Connection string for a multisig server session | |
--hostname | Hostname of the multisig broker server to connect to | "multisig.ironfish.network" |
--port | Port to connect to on the multisig broker server | 9035 |
--sessionId | Unique ID for a multisig server session to join | |
--passphrase | Passphrase to join the multisig server session | |
--tls | Connect to the multisig server over TLS (requires --server) | true |
--minSigners | Minimum signers required to sign a transaction | |
--totalParticipants | The total number of participants for the multisig account |