Dirk Key Converter (dkc)

Transform wallets between distributed type and non-deterministic type.

‼️ It is highly recommended to refrain from any operations on the validation keys and use the provided script only in critical situations to avoid any ponential risks of slashing.

Table of Contents

• Install
  • Binaries
  • Source
• Usage
  • Config
  • Combine
  • Split
• Maintainers
• Contribute
• License

Install

Binaries

Binaries for the latest version of dkc can be obtained from the releases page.

Source

dkc can be built locally using the command

go build .

Usage

‼️ Before you begin, make sure you backup keys and store recovered wallets and passwords securely.

dkc uses herumi/bls-eth-go-binary. Some research code of using herumi/bls-eth-go-binary in dkc is available here

You can also test dkc on predefiened inputs here.

Config

An example config can be found here

distributed-wallets:                #Distributed-wallets section
  path: ./wallet                    #Path to distributed wallet (Default: None)
  passphrases: ./passphrases.txt    #Path to file containing passphrases for unlocking/locking accounts (Default: None)
  threshold: 2                      #Threshlod value (Default: None)
  peers:                            #Peers dict, number of peers must be greater than threshold value (Default: None)
    10: old1:9091
    20: old2:9091
    30: old3:9091
nd-wallets:                         #Non-determenistic-wallets section                    
  path: ND_WALLETS                  #Path to non-determenistic wallet (Default: None)
  passphrases: ./passphrases.txt    #Path to file containing passphrases for unlocking/locking accounts (Default: None)
log-level: debug                    #Log-level (Default: INFO)

Combine

Combine distributed type to non-deterministic type.

./dkc combine --config=config.yaml

Split

Split non-deterministic type to distributed type

./dkc split --config=config.yaml

Maintainers

Sergey Yakovlev: @selfuryon.

SpontaneousOverthrow: @SpontaneousOverthrow.

Contribute

Contributions welcome. Please check out the issues.

License

License