OpenSig Command Line Interface. A javascript implementation of the OpenSig standard providing command line functions to digitally sign and verify files, recording signatures on the bitcoin blockchain.
OpenSig is built using opensig-lib.
- Create: generate a new private key and optionally add it to your wallet.
- Sign: sign any file with your private key and record your signature on the blockchain.
- Verify: display a file's signatures from the blockchain.
- Info: obtain private key, WIF and public keys from any private key, WIF or file, or from a key in your wallet.
- Send: create and publish a transaction to spend any amount (or amounts) from one address to another.
- Balance: retrieve the balance of your key (or any public key) from the blockchain.
The steps to install are:
- Install Node.js
- Use the Node.js Package Manager to install the opensig command line client and all its dependencies
Download the recommended version from nodejs.org and install it with the default installation options.
Open a command prompt then type:
npm install opensig -g
This will install the OpenSig command line client and all its dependencies.
From the command prompt create a new wallet in the default location (~/.opensig/wallet)...
opensig create wallet
Create a new key and save it to the wallet with your name or whatever label you want (the -s option saves the new key to your wallet with the given label)...
opensig create -s "My Name"
List your new OpenSig address...
opensig info -i
To sign files you will need to transfer some bitcoin funds to your public key.
However you don't need any funds to verify files so try...
opensig verify some_file
You should get no output meaning there are no signatures.
Try downloading the OpenSig white paper and verifying that..
opensig verify opensig-whitepaper.pdf
You should see my public identity (OPENSIG-121GfwxgvdEUck7Xb4d5wbMnf7Xm2b4zw3-btc) and the date I signed the file.
When you have some funds you can try signing files...
opensig sign some_file
You should see a 'receipt' giving you detailed information about the blockchain transaction that OpenSig has generated. Note, since you didn't specify the -p option the transaction hasn't been published on the blockchain and the response field in the receipt states 'Not Published'. This means you haven't actually signed the file or spent any funds - it was just a dry run. Run the same command with the -p option added and you should see 'Transaction Submitted' in the response field.
You can get the balance of your OpenSig address by typing...
opensig balance
Usage: opensig <command> [options] [args] # Try opensig <command> --help
Commands:
info [options] [item] outputs information about the given WIF, private key or wallet.
create [options] [wallet] creates a new private key and outputs its details or creates a new wallet
verify <file> queries the blockchain and outputs the list of signees for the given file
sign [options] <file> [key] signs the given file using the given key and outputs the transaction
send [options] <amount> creates a transaction
balance [item] displays the balance for the given public key, WIF, label or private key
Options:
-h, --help output usage information
-V, --version output the version number
-a --address limit output to compressed public blockchain address(es) only. Overrides -f
-i --id limit output to public id(s) only. Overrides -f and -a
-f --format <format> specify the output format (see documentation)
-w --wallet <file> use the specified wallet file instead of the default wallet
-v --verbose display verbose error information
--test-blockchain-api places the blockchain api interface into test mode
Creates a new private key and outputs its details, or creates a new wallet.
Usage: 1. create [-s <label>] [-w path/to/wallet]
2. create -k <key> -s <label> [-w path/to/wallet]
3. create wallet [-w path/to/wallet]
1. creates a new private key and outputs its details, optionally saving it to the wallet with the
given label.
2. imports the given private key or WIF into the wallet with the given label.
3. creates a new wallet. If -w is not given then the default wallet is created (~/.opensig/wallet)
Options:
-h, --help output usage information
-k --key <key> imports the given private key or WIF to the wallet. Requires -s.
-s --save <label> saves the WIF and label to the wallet
Creates a signature transaction and optionally publishes it on the blockchain.
Usage: opensig sign [options] <file> [key]
Signs the given file using the given key and outputs the transaction
Options:
-h, --help output usage information
-p --publish publishes the signature on the blockchain
--amount <amount> spend the given amount in the transaction
--fee <fee> include the given miner's fee in the transaction
file
File to sign. (string containing a file path or a file's hex64 private key or WIF..
key
Key to sign with. (string containing a wallet key label, hex64 private key, a WIF or a file. If not present the default (first) key in the wallet is used.)
publish
If present the transaction will be published on the blockchain. Defaults to false - output the transaction to the command line only. (boolean)
amount
Optional amount to send in the transaction. Defaults to the minimum 5430 satoshis. (positive integer)
fee
Optional amount to include as the miner's fee. Defaults to 10000 satoshis. (positive integer)
Returns a list of signatures for the given file.
Usage: opensig verify [options] <file>
queries the blockchain and outputs the list of signatures for the given file
Options:
-h, --help output usage information
file
File to verify. (string containing a file path or a file's public key, hex64 private key or WIF).
Outputs information about the given WIF, private key, wallet label or wallet.
Usage: 1. opensig info [options] [item]
2. opensig info [options] wallet
1. outputs information about the given label, WIF, private key or file.
2. outputs information for all keys in the wallet.
Options:
-h, --help output usage information
--full outputs full information. Equivalent to --format "<full>"
item
The item to display information about. With no arguments info outputs the default key (first key in the wallet).
By default info outputs the public key, private WIF and label of the item requested. Use the -f option to control the output format, where is a string containing free text and any of the following fields:
label
the key's label
pub
the public key (blockchain address)
priv
the private key (hex64)
wif
the Wallet Import Format version of the private key
pubc
public key (compressed form)
pubu
public key (uncompressed form)
wifc
WIF (compressed form)
wifu
WIF (uncompressed form)
Returns a receipt containing a transaction to send the given amount or amounts from the from
key to the to
address, and, optionally, to publish the transaction on the blockchain. Change is returned to the from
address.
Usage: opensig send [options] <amount ...>
creates a transaction
Options:
-h, --help output usage information
-p --publish publishes the signature on the blockchain
--to <to> send to this label, public address, private key, WIF or file
--from <from> send from this label, private key, WIF or file
--fee <fee> use the given miner's fee
from
Wallet key label, private key or WIF of the address to spend from. (string containing a label, hex64 private key or WIF. Also accepts a file).
to
Wallet key label, public key, private key or WIF of the address to send to. (string containing a label, public key, hex64 private key or WIF. Also accepts a file)
amount
Amount to spend in the transaction or "all" to empty the address. Defaults to 5430 satoshis. If multiple amounts are given then separate transaction outputs will be created for each amount. (positive integer)
fee
Amount to include as the miner's fee in addition to the amount. Defaults to 10000 satoshis. (positive integer)
publish
If present the transaction will be published on the blockchain (boolean)
Returns the blockchain balance for the given public address (the sum of unspent transaction outputs)
Usage: opensig balance [options] [item]
displays the balance for the given label, public key, WIF, private key or file
Options:
-h, --help output usage information
key
Public key. (string containing a label, public key, hex64 private key, WIF or file)
Create a new wallet in the default location (~/.opensig/wallet)...
> opensig create wallet
Create a new key and save it to the wallet with the label "Me"...
> opensig create -s Me
Get your public OpenSig address for sharing with others...
> opensig info --id
OPENSIG-1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R-btc
Top up your new key from another account...
> opensig send 100000 --to Me --from "MyWellFundedWIF00FpYdbmJ4dbgJmr5Y1h5eX9LmsPWKBZBqkUg" --publish
Receipt {
from:
{ address: '1M9jofAErijG4eiPUy19Qxot1KkPRRzyet',
label: undefined },
to:
{ address: '1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R',
label: 'Me' },
input: 2100000000000000,
payment: 100000,
fee: 10000,
change: 2099999999890000,
response: 'Transaction Submitted',
txnID: '4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b',
txnHex: '04ffff001d0104455468652054696d65732030332f4a616e2f32303039204368616e63656c6c6f72206f6e206272696e6b206f66207365636f6e64206261696c6f757420666f722062616e6b73' }
Check the blockchain balance of your new key...
> opensig balance
100000
Get information about your new key in various formats...
> opensig info
1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL Me
> opensig info Me
1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL Me
> opensig info wallet
1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL Me
> opensig info --format "<full>"
label : Me
identity : OPENSIG-1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R-btc
private key : a8556b1ca569679a17274299e02b4558eca4ac4f9252e7fb9221d4b99244a2b4
wif compressed : L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL
wif uncompressed : 5K6RSRHb73oPctb7MGWD1E5bCLzjY9EcW9kVxnkAskD9gXgzo8P
public key compressed : 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R
public key uncompressed : 1KxRFn875MpKYKEUEFDdZXTVxSpcjqhsNf
> opensig info --format "<pub>"
1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R
> opensig info -a
1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R
> opensig info --full
label : Me
identity : OPENSIG-1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R-btc
private key : a8556b1ca569679a17274299e02b4558eca4ac4f9252e7fb9221d4b99244a2b4
wif compressed : L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL
wif uncompressed : 5K6RSRHb73oPctb7MGWD1E5bCLzjY9EcW9kVxnkAskD9gXgzo8P
public key compressed : 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R
public key uncompressed : 1KxRFn875MpKYKEUEFDdZXTVxSpcjqhsNf
> opensig info --format "public key: <pub>, wif: <wif>, private key: <priv>"
public key: 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R, wif: L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL, private key: a8556b1ca569679a17274299e02b4558eca4ac4f9252e7fb9221d4b99244a2b4
> opensig info --format "compressed keys: <pubc> <wifc>"
compressed keys: 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL
> opensig info --format "uncompressed keys: <pubu> <wifu>"
uncompressed keys: 1KxRFn875MpKYKEUEFDdZXTVxSpcjqhsNf 5K6RSRHb73oPctb7MGWD1E5bCLzjY9EcW9kVxnkAskD9gXgzo8P
Sign a document...
> opensig sign my_file.doc --publish
Receipt {
from:
{ address: '1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R',
label: Me },
to:
{ address: '16uozUn4X1yppn1nS1iQXT5u6BsqheGpUq',
label: 'my_file.doc' },
input: 100000,
payment: 5430,
fee: 10000,
change: 84570,
response: 'Transaction Submitted',
txnID: '0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098',
txnHex: '010000000109882232243a0ff09bf0fe98f3be6130935642d11508c38d22724a81a24cd813010000006a47304402200c1a88c408a29c6a192bea5fa5881113d7736b373d211809b411856fecde5fb102204f86a8e5ef8864633410d19a1a76dab72bd105275a3d06bcb222236bd88a8d96012103ef12ef92ab520c62061e07186faac5ef43e835a3ef63ddd1437d15e9fcb0dab30000000002204e0000000000001976a9141d8abe268642dda7228be625e425749f0fc5467988acf1a40000000000001976a914dd09932106e2fd0f296b726da9cb5cf142648e9588ac00000000' }
Verify the document...
> opensig verify my_file.doc
Thu, 14 Apr 2016 00:43:39 GMT OPENSIG-1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R-btc Me
Get information about a file's blockchain key, check its balance and send all its funds to your address...
> opensig info my_file.doc --full
label : my_file.doc
identity : OPENSIG-16uozUn4X1yppn1nS1iQXT5u6BsqheGpUq-btc
private key : 773a388fbbecea7f05053b0c55dd6b5cb76e7a330e75abda01fdcf6227b6060b
wif compressed : L1DUQpv8LHWsNiDaDzvMVugqd73Kgit3YNPVw5dEvNpXUcnAmRTT
wif uncompressed : 5Jio5wovmhSoJcAeS9bHsxSLdGsNTDfJLo5eNKGTiYgKEbMP4f3
public key compressed : 16uozUn4X1yppn1nS1iQXT5u6BsqheGpUq
public key uncompressed : 15DVgHc5YXLsxQMU1qrcFbhoyKdqymUvgx
> opensig balance my_file.doc
5430
> opensig send all --from my_file.doc --to me --publish
insufficient funds
$ npm test
$ npm run test-cov
OpenSig (c) 2016 D N Potter
Released under the MIT license