Skip to content

The go-lang wallet library & command-line wallet of the Qitmeer network

License

Notifications You must be signed in to change notification settings

Qitmeer/qitmeer-wallet

Repository files navigation

qitmeer-wallet

The command-line wallet of the Qitmeer network

download or build

you can download from release

if you have golang environment, you can build it by yourself

  1. install node
    https://nodejs.org

    Note:

    If you met network connectivity issue, please config HTTP or NPM proxy. See #37

    # HTTP proxy
    export HTTP_PROXY=http://proxy.example.com:8080
    
    # NPM proxy
    npm config set proxy http://proxy.example.com:8080
  2. install go
    https://golang.org/
    make sure go env is ready

    go env GOPATH

    Note: Minimum go version is above 1.12, see #47

    go version
    
    # Recommend for debian based OS to upgrade to the latest
    # https://github.com/golang/go/wiki/Ubuntu
     sudo add-apt-repository ppa:longsleep/golang-backports
     sudo apt update
     sudo apt install golang-go
  3. build

    git clone https://github.com/Qitmeer/qitmeer-wallet ~/github.com/Qitmeer/qitmeer-wallet
    cd ~/github.com/Qitmeer/qitmeer-wallet
    make

Usage

  1. qc

    ./qitmeer-wallet qc
    
    qitmeer wallet command
    
    Usage:
     qitmeer-wallet qc [command]
    
    Available Commands:
     create                create
     createnewaccount      create new account
     getaddressesbyaccount get addresses by account
     getbalance            getbalance
     getlisttxbyaddr       get all transactions for address
     getnewaddress         create new address by account
     gettx                 Access to transaction information
     gettxspendinfo        gettxspendinfo
     importprivkey         import priKey
     listaccountsbalance   list Accounts Balance
     sendtoaddress         send transaction
     setsyncedtonum         please use caution when specifying how many blocks to update from
     syncheight            Get the number of local synchronization blocks
     updateblock           Update local block data
    
    Flags:
     -a, --appdatadir string       wallet db path
     -c, --configfile string       config file (default "config.toml")
         --confirmations int       Number of block confirmations  (default 10)
         --create                  Create a new wallet
     -d, --debuglevel string       Logging level {trace, debug, info, warn, error, critical} (default "info")
     -h, --help                    help for qc
         --listeners stringArray   rpc listens (default [127.0.0.1:38130])
     -l, --logdir string           log data path
         --mintxfee int            The minimum transaction fee in QIT/kB default 20000 (aka. 0.0002 MEER/KB) (default 200000)
     -n, --network string          network (default "testnet")
     -P, --pubwalletpass string    data encryption password (default "public")
         --qcert string            Certificate path
         --qnotls                  disable TLS (default true)
     -p, --qpass string            qitmeer node password (default "123456")
     -s, --qserver string          qitmeer node server (default "127.0.0.1:8030")
         --qtlsskipverify          skip TLS verification (default true)
     -u, --quser string            qitmeer node user (default "admin")
          --rpcPass string          rpc pass,default by random (default "OkROTj7OdtUFm94DwAlzJ2Nm")
          --rpcUser string          rpc user,default by random (default "3tkpuiUE")
         --ui                      Start Wallet with RPC and webUI interface (default true)
    
    Use "qitmeer-wallet qc [command] --help" for more information about a command.
    
  2. qx

    ./qitmeer-wallet qx
    
    qitmeer wallet qx util
    
    Usage:
      qitmeer-wallet qc qx [command]
    
    Available Commands:
      generatemnemonic generate mnemonic
      mnemonictoaddr   mnemonic to address
      mnemonictoseed   mnemonic to seed
      pritoaddr        private key to address
      pritopub         private key to public key
      pubtoaddr        public key to address
      seedtoaddr       seed to address
      seedtopri        Seed private key
      wiftopri         WIF key to private key

How to use qitmeer-wallet console command model

1: Rename sample-config.toml to config.toml and modify the configuration parameters

   #configFile="" #Your config.toml profile directory
   #appDataDir="" # Your DB storage path
   #logDir="" # log path
   #network="mainnet" #network mainnet,testnet,privnet,mixnet default testnet
   network="testnet"
   #Qitmeerd
   QServer="127.0.0.1:8131"
   QUser="admin"
   QPass="123456"
   QNoTLS=true
   QTLSSkipVerify=true
   WalletPass="public" #Wallet encryption code default public
   
   MinTxFee=200000   # The minimum transaction fee in QIT/KB default 200000 (aka. 0.002 MEER/kB)
   
   #web model
   #listeners=["127.0.0.1:8130"]
   #rpcUser=""
   #rpcPass=""
   #ui=true

2: create a wallet

  • The old create method

       $ ./build/bin/qitmeer-wallet qc create
    
  • The new create method . this will be same with rule with kahf wallet app

       $ ./build/bin/qitmeer-wallet qc create mnemonic
    
    ./qitmeer-wallet qc create 
    
    
    #output
    
     # Wallet Password
     Enter the private passphrase for your new wallet:
     Confirm passphrase:
     # Wallet data encryption password, default public
     Do you want to add an additional layer of encryption for public data? (n/no/y/yes) [no]:y
     Enter the public passphrase for your new wallet:
     Confirm passphrase:
     NOTE: Use the -- wallet pass option to configure your public passphrase.
     PubPass: 123
     # Whether to import wallet seeds
     Do you have an existing wallet seed you want to use? (n/no/y/yes) [no]: n
     Your wallet generation seed is:
     17e28af99e36ff4527c95f91e13d3ecd82349864d23b9ff2d4f9d446ea078291
     IMPORTANT: Keep the seed in a safe place as you
     Will NOT be able to restore your wallet without it.
     Please keep in mind that any who has access
     To the seed can also restore your wallet thus
     Give them access to all your funds, so it is
     Imperative that you keep it in a secure location.
     Once you have stored the seed in a safe and secure location, enter "OK" to continue: OK
     Creating the wallet...
     INFO [0021] Opened Wallet
     Pri: 6eb6bbcd7ded317abc4ed5e373c2c8630dc4ad069470ad7ae72f5fb854423006
     INFO [0022] Imported payment address TmmC1hUN5A2RJzX9ZWFZqHaDbKUf6NaA4D
     The wallet has been created successfully.

3: update db (update to the specified block or update all,syncheight can view the current DB synchronization height)

    ./qitmeer-wallet qc updateblock
    ./qitmeer-wallet qc updateblock 130 

4: when creating a wallet, you can import seeds or import private keys using importprivkey.

    ./qitmeer-wallet qc importprivkey 6eb6bbcd7ded317abc4ed5e373c2c8630dc4ad069470ad7ae72f5fb854423006` 
    
    #output
    
    ImportPrivKey: OK

5: must use updateblock to see the balance change after the transfer transaction

    ./qitmeer-wallet qc sendtoaddress TmbsdsjwzuGboFQ9GcKg6EUmrr3tokzozyF 0.01 youpassword
    
    #output
    
    0e441ecee44defe28711103eef0cc3d01c187c257738150869c032fbbf96d4c9

    ./qitmeer-wallet qc updateblock

Web client

./qitmeer-wallet web

desktop wallet

Interactive console

./qitmeer-wallet console

wallet-cli:help
Usage:
        <command> [arguments]
        The commands are:
        <createNewAccount> : Create a new account. Parameter: [account]
        <getBalance> : Query the specified address balance. Parameter: [address]
        <getListTxByAddr> : Gets all transaction records at the specified address. Parameter: [address] [stype:in,out,all]
        <getNewAddress> : Create a new address under the account. Parameter: [account]
        <getAddressesByAccount> : Check all addresses under the account. Parameter: [account]
        <getAccountByAddress> : Inquire about the account number of the address. Parameter: [address]
        <importPrivKey> : Import private key. Parameter: [priKey]
        <importWifPrivKey> : Import wif format private key. Parameter: [priKey]
        <dumpPrivKey> : Export wif format private key by address. Parameter: [address]
        <getAccountAndAddress> : Check all accounts and addresses. Parameter: []
        <sendToAddress> : Transfer transaction. Parameter: [address] [num]
        <updateblock> : Update Wallet Block. Parameter: []
        <syncheight> : Current Synchronized Data Height. Parameter: []
        <unlock> : Unlock Wallet. Parameter: [password]
        <help> : help
        <exit> : Exit command mode

wallet-cli:

About

The go-lang wallet library & command-line wallet of the Qitmeer network

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published