This can be used to operate Bitcoin and Bitcoin Cash wallets.
# Use -h or BWS_HOST to setup the BWS URL (defaults to localhost:3001)## Start a local BWS instance be doing:# git clone bws# cd bws; npm install; npm startcd bin# Create a 2-of-2 wallet (~/.wallet.dat is the default filename where the wallet critical data will be stored)## TIP: add -t for testnet, and -p to encrypt the credentials filewallet create 'my wallet' 2-2* Secret to share:JevjEwaaxW6gdAZjqgWcimL525DR8zQsAXf4cscWDa8u1qKTN5eFGSFssuSvT1WySu4YYLYMUPT# Check the status of your walletwallet status* Wallet my wallet [livenet]: 2-of-2 pendingMissing copayers: 1# Use -f or WALLET_FILE to setup the wallet data file# Join the wallet as another copayer (add -p to encrypt credentials file)wallet -f pete.dat join JevjEwaaxW6gdAZjqgWcimL525DR8zQsAXf4cscWDa8u1qKTN5eFGSFssuSvT1WySu4YYLYMUPTexport WALLET_FILE=pete.datwallet status# Generate addresses to receive moneywallet address* New Address 3xxxxxx# Check your balancewallet balance# Spend coins. Amount can be specified in btc, bit or sat (default)wallet send 1xxxxx 1000bit "1000 bits to mother"* Tx created: ID 01425517364314b9ac6017-e97d-46d5-a12a-9d4e5550abef [pending]RequiredSignatures: 2# You can use 1000bit or 0.0001btc or 100000sat. (Set BIT_UNIT to btc/sat/bit to select output unit).It is also possible to use Payment Protocol or BIP21. Examples:wallet send 'bitcoin:?r='wallet send 'bitcoin:1N4zjmp1ojRborDiAu62MyCpaz9wjhPLM?amount=1'# List pending TX Proposalswallet txproposals* TX Proposals:abef ["1000 bits to mother" by pete] 1,000 bit => 1xxxxxMissing signatures: 2# Sign or reject TXs from other copayerswallet -f pete.dat reject <id>wallet -f pete.dat sign <id># List transaction historywallet historya few minutes ago: => sent 1,000 bit ["1000 bits to mother" by pete]a day ago: <= received 1,400 bita day ago: <= received 300 bit# List all commands:wallet --help
It is possible (and recommeded) to encrypt the wallet's credentials (.dat file). this is done be adding the
-p parameter to
genkey. The password will be asked interactively. Following commands that use the crendetials will require the password to work.
Air gapped (non connected) devices are supported. This setup can be useful if maximum security is needed, to prevent private keys from being compromised. In this setup, a device is installed without network access, and transactions are signed off-line. Transactions can be pulled from BWS using a
proxy device, then downloaded to a pendrive to be moved to the air-gapped device, signed there, and then moved back the
proxy device to be sent back to BWS. Note that Private keys are generated off-line in the airgapped device.
# On the Air-gapped device# Generate extended private key (add -t for testnet)airgapped$ wallet genkey* Livenet Extended Private Key Created.airgapped$ wallet export -o toproxy --nosign* Wallet data saved at toproxy without signing capability.# On the proxy machineproxy$ wallet import toproxy* Wallet Imported without signing capability.proxy$ wallet join <secret> # Or wallet createproxy$ wallet addressproxy$ wallet balance# It is not possible to sign transactions from the proxy deviceproxy$ wallet sign[Error: You do not have the required keys to sign transactions]# Export pending transaction to be signed offlineproxy$ wallet txproposals -o txproposals.dat## Back to air-gapped device# Sign themairgapped$ wallet airsign txproposals.dat -o signatures.dat# NOTE: To allow the airgapped device to check the transaction proposals being signed, the public keys of the copayers will be imported from the txproposals archive. That information is exported automatically by the proxy machine, and encrypted using copayer's xpriv derivatives.## Back to proxy machine# Send signatures to BWSproxy$ wallet sign -i signatures.datTransaction 014255.... signed by you.
See CONTRIBUTING.md on the main bitcore repo for information about how to contribute.
Code released under the MIT license.
Copyright 2013-2019 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.