signature=1496953fd63894e93bb2e5a2eab57ea5,GitHub - opensig/opensig at 68ab3f0026ee32defc23ac5fd57e1...

OpenSig CLI (opensig)

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.

Primary Features

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.

Secondary Features

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.

Installation

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

Install Node.js

Download the recommended version from nodejs.org and install it with the default installation options.

Install OpenSig

Open a command prompt then type:

npm install opensig -g

This will install the OpenSig command line client and all its dependencies.

Using OpenSig for the First Time

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

Usage: opensig [options] [args] # Try opensig --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 queries the blockchain and outputs the list of signees for the given file

sign [options] [key] signs the given file using the given key and outputs the transaction

send [options] 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 specify the output format (see documentation)

-w --wallet 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

Create

Creates a new private key and outputs its details, or creates a new wallet.

Usage: 1. create [-s ] [-w path/to/wallet]

2. create -k -s [-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 imports the given private key or WIF to the wallet. Requires -s.

-s --save saves the WIF and label to the wallet

Sign

Creates a signature transaction and optionally publishes it on the blockchain.

Usage: opensig sign [options] [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 spend the given amount in the transaction

--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)

Verify

Returns a list of signatures for the given file.

Usage: opensig verify [options]

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).

Info

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 ""

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)

Send

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]

creates a transaction

Options:

-h, --help output usage information

-p --publish publishes the signature on the blockchain

--to send to this label, public address, private key, WIF or file

--from send from this label, private key, WIF or file

--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)

Balance

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)

Examples

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

1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6RL2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXLMe

> opensig info Me

1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6RL2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXLMe

> opensig info wallet

1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6RL2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXLMe

> opensig info --format ""

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 ""

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: , wif: , private key: "

public key: 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R, wif: L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL, private key: a8556b1ca569679a17274299e02b4558eca4ac4f9252e7fb9221d4b99244a2b4

> opensig info --format "compressed keys: "

compressed keys: 1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R L2rvsCCDXhMkqQhZ2TRuyzjFw5FpkTM5hfczqEuYayidK2uKUnXL

> opensig info --format "uncompressed keys: "

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 GMTOPENSIG-1McwqRhXr6ns7X6d3TxP3MQhVbndKg5W6R-btcMe

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

Run the tests

$ npm test

$ npm run test-cov

Copyright

OpenSig (c) 2016 D N Potter

Released under the MIT license