lbcd/database/README.md

database
========

[![ISC License](http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)

Package database provides a block and metadata storage database.

Please note that this package is intended to enable btcd to support different
database backends and is not something that a client can directly access as only
one entity can have the database open at a time (for most database backends),
and that entity will be btcd.

When a client wants programmatic access to the data provided by btcd, they'll
likely want to use the [rpcclient](https://github.com/btcsuite/btcd/tree/master/rpcclient)
package which makes use of the [JSON-RPC API](https://github.com/btcsuite/btcd/tree/master/docs/json_rpc_api.md).

However, this package could be extremely useful for any applications requiring
Bitcoin block storage capabilities.

The default backend, ffldb, has a strong focus on speed, efficiency, and
robustness.  It makes use of leveldb for the metadata, flat files for block
storage, and strict checksums in key areas to ensure data integrity.

## Feature Overview

- Key/value metadata store
- Bitcoin block storage
- Efficient retrieval of block headers and regions (transactions, scripts, etc)
- Read-only and read-write transactions with both manual and managed modes
- Nested buckets
- Iteration support including cursors with seek capability
- Supports registration of backend databases
- Comprehensive test coverage
Import btcdb repo into database directory. This commit contains the entire btcdb repository along with several changes needed to move all of the files into the database directory in order to prepare it for merging. This does NOT update btcd or any of the other packages to use the new location as that will be done separately. - All import paths in the old btcdb test files have been changed to the new location - All references to btcdb as the package name have been chagned to database - The coveralls badge has been removed since it unfortunately doesn't support coverage of sub-packages This is ongoing work toward #214. 2015-01-27 11:45:10 -06:00			`database`
			`========`
Initial commit. 2013-05-28 19:03:53 -05:00
multi: Update markdown files for GFM changes. The github markdown interpreter has been changed such that it no longer allows spaces in between the brackets and parenthesis of links and now requires a newline in between anchors and other formatting. This updates all of the markdown files accordingly. While here, it also corrects a couple of inconsistencies in some of the README.md files. 2017-05-25 11:29:23 -05:00			`[![ISC License](http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)`
Add support for TravisCI. Also add TravisCI build status badge to README.md. 2013-12-10 19:17:44 -06:00
database: Replace with new version. This commit removes the old database package, moves the new package into its place, and updates all imports accordingly. 2015-08-26 04:54:55 -05:00			`Package database provides a block and metadata storage database.`
Initial implementation. 2013-05-28 19:07:21 -05:00
Clarify how the database package is used. 2015-01-27 18:58:27 -06:00			`Please note that this package is intended to enable btcd to support different`
			`database backends and is not something that a client can directly access as only`
			`one entity can have the database open at a time (for most database backends),`
			`and that entity will be btcd.`

			`When a client wants programmatic access to the data provided by btcd, they'll`
database: Update rpcclient link in README.md. 2018-01-26 01:43:53 -03:00			`likely want to use the [rpcclient](https://github.com/btcsuite/btcd/tree/master/rpcclient)`
multi: Update markdown files for GFM changes. The github markdown interpreter has been changed such that it no longer allows spaces in between the brackets and parenthesis of links and now requires a newline in between anchors and other formatting. This updates all of the markdown files accordingly. While here, it also corrects a couple of inconsistencies in some of the README.md files. 2017-05-25 11:29:23 -05:00			`package which makes use of the [JSON-RPC API](https://github.com/btcsuite/btcd/tree/master/docs/json_rpc_api.md).`
Clarify how the database package is used. 2015-01-27 18:58:27 -06:00
database: Replace with new version. This commit removes the old database package, moves the new package into its place, and updates all imports accordingly. 2015-08-26 04:54:55 -05:00			`However, this package could be extremely useful for any applications requiring`
			`Bitcoin block storage capabilities.`

			`The default backend, ffldb, has a strong focus on speed, efficiency, and`
			`robustness. It makes use of leveldb for the metadata, flat files for block`
			`storage, and strict checksums in key areas to ensure data integrity.`

			`## Feature Overview`

			`- Key/value metadata store`
			`- Bitcoin block storage`
			`- Efficient retrieval of block headers and regions (transactions, scripts, etc)`
			`- Read-only and read-write transactions with both manual and managed modes`
			`- Nested buckets`
			`- Iteration support including cursors with seek capability`
			`- Supports registration of backend databases`
sanitizing readmes for lbcd 2021-08-31 15:53:55 -04:00			`- Comprehensive test coverage`