A bitcoin library in C, SPV wallet & more.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 2 commits ahead, 188 commits behind jgarzik:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
include
lib
src
test
.gitattributes
.gitignore
AUTHORS
COPYING
ChangeLog
Makefile.am
NEWS
README.md
TODO
autogen.sh
configure.ac

README.md

#Picocoin

Tiny bitcoin library, with lightweight client and utils

libccoin library dependencies: OpenSSL

picocoin client dependencies: OpenSSL libevent 2.x jansson 2.x (2.1 used for development)

block relay daemon (brd) dependencies: OpenSSL libevent 2.x

Command line and configuration file usage

In general, the program stores settings in a key/value map. These key=value parameters may be specified on the command line, or in a configuration file.

The command line is processed in-order. For example

$ ./picocoin value=1 list-settings value=2 list-settings

will execute the "list-settings" command twice, each with "value" setting initialized to a different parameter.

Similarly, you may read multiple configuration files into the settings map:

$ ./picocoin config=file1 config=file2 config=file3

Recognized parameters

addnode

Format: address SPACE port

Manually add P2P node to peer manager.

config (alias "c")

Specify a pathname to the configuration file.

wallet (alias "w")

Specify a pathname to the wallet data file. Default "picocoin.wallet"

AES encryption is applied to the wallet. Passphrase is specified via environment variable PICOCOIN_PASSPHRASE.

debug

Enable additional debug output.

net.connect.timeout

TCP connect(2) timeout.

Recognized commands

chain-set

Select blockchain and network. Reads the "chain" settings variable. Acceptable values are "chain=bitcoin" and "chain=testnet3". Updates internal parameters (pchMessageStart / network magic, genesis block, ...)

dns-seeds

Query and display bitcoin DNS seeds, for P2P node addresses.

help

Output these commands and recognized settings.

list-settings

Display settings map.

new-address

Generate a new bitcoin address (ECDSA keypair). Store it in the current wallet,

new-wallet

Initialize a new wallet. Refuses to initialize, if the filename already exists.

netsync

Synchronize with network: send any pending payments, and check for new incoming payments.

wallet-addr

List all bitcoin addresses in wallet.

wallet-dump

Dump entire wallet contents, including all private keys.

wallet-info

Informational summary of wallet data.