dwn-client

CLI client for DWN blockchain. You can connect to devnet, testnet, mainnet or your custom private/public DWN-derived blockchain.

Features:

• connection to network or a node,
• get stats of a network,
• create or get status of an account,
• create vanity accounts (multi-cpu supported),
• register a delegate,
• vote for a delegate,
• sign and verify message using your address.

Installation

You need to have node (version 7.6.0 or newer) installed. Then:

$> npm install -g dwn-client
$> dwn-client
    ____ _       ___   __        ___            __ 
   / __ \ |     / / | / /  _____/ (_)___  ___  / /_
  / / / / | /| / /  |/ /  / ___/ / / __ \/ _ \/ __/
 / /_/ /| |/ |/ / /|  /  / /__/ / / / / /  __/ /_  
/_____/ |__/|__/_/ |_/   \___/_/_/_/ /_/\___/\__/                                                    
dwn>

Usage

dwn> help

  Commands:

    help [command...]                     Provides help for a given command.
    exit                                  Exits application.
    connect <network>                     Connect to network. Network is testnet or devnet or mainnet
    connect node <url>                    Connect to a server. For example "connect node 5.39.9.251:4000"
    disconnect                            Disconnect from server or network
    network stats                         Get stats from network
    account status <address>              Get account status
    account vote <name>                   Vote for delegate <name>. Remove previous vote if needed. Leave empty to clear vote
    account send <amount> <recipient>     Send <amount> dwn to <recipient>. <amount> format examples: 10.4
    account delegate <username>           Register new delegate with <username>
    account create                        Generate a new random cold account
    account vanity <string>               Generate an address containing lowercased <string> (WARNING you could wait for long)
    message sign <message>                Sign a message
    message verify <message> <publickey>  Verify the <message> signed by the owner of <publickey> (you will be prompted to provide the signature)
    shARK                                 No you don't want to use this command

dwn> connect testnet
{ nethash: '1f036b473d04b6516178972d465e19ff342e649456918cb3dab71e68789cbdee',
  token: 'DWN',
  symbol: 'D',
  version: 23 }
Node: 45.76.182.181:3100, height: 556
dwn testnet>

dwn testnet> account create
Seed    - private: rely cup brand sentence wolf amateur clog knock execute avocado they ready
WIF     - private: SBHAcXWeCEBDaLVUm4B3idHoLde2qrmi2gkxz8KXtNYfjVMK16pH
Address - public : DMUeELFkFtN5obvStkV9Zt44GEjEaYgKhH

dwn testnet> account send 100 AMUeELFkFtN5obvStkV9Zt44GEjEaYgKhH
passphrase: ************************************************************************
Transaction sent successfully with id 7adbf890c88dd345eacbac63e94610fa5f3905528cdc1c36740c3ba3fa3db302

dwn testnet> account delegate rockingark
passphrase: **************************************************************************
Transaction sent successfully with id b857f302611e4f36a33ea886f7bcb951633406ba1f5e40393893234a46ce54eb

dwn testnet> account status DMUeELFkFtN5obvStkV9Zt44GEjEaYgKhH
{ address: 'DMUeELFkFtN5obvStkV9Zt44GEjEaYgKhH',
  unconfirmedBalance: '7500000000',
  balance: '7500000000',
  publicKey: '020cfc61215f2682bd70cce14aaa6cfa6fa3b0507771cb1943aee071a7dd57bcf6',
  username: 'rockingark',
  vote: '0',
  producedblocks: 0,
  missedblocks: 0,
  rate: 52,
  approval: 0,
  productivity: 0 }

License

MIT License

• Copyright © 2017 DWN.io
• Copyright © 2017 FX Thoorens

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.