ipld-eth-server/README.md

# Vulcanize DB

[![Build Status](https://travis-ci.org/vulcanize/VulcanizeDB.svg?branch=master)](https://travis-ci.org/vulcanize/VulcanizeDB)

### Dependencies

 - Go 1.9+
 - Postgres 10 
 - Ethereum Node
   - [Go Ethereum](https://ethereum.github.io/go-ethereum/downloads/) (1.8+)
   - [Parity 1.8.11+](https://github.com/paritytech/parity/releases)
   
### Installation 
`go get github.com/vulcanize/vulcanizedb`

### Setting up the Databases

1. Install Postgres
1. Create a superuser for yourself and make sure `psql --list` works without prompting for a password.
1. `createdb vulcanize_private`
1. `cd $GOPATH/src/github.com/vulcanize/vulcanizedb`
1. Import the schema: `psql vulcanize_private < db/schema.sql`

   or run the migrations: `make migrate HOST_NAME=localhost NAME=vulcanize_public PORT=5432`
    * See below for configuring additional environments
    
### IPC File Paths

The default location for Ethereum is:
 - `$HOME/Library/Ethereum` for Mac
 - `$HOME/.ethereum` for Ubuntu
 - `$GOPATH/src/gihub.com/vulcanize/vulcanizedb/test_data_dir/geth.ipc` for private node.

**Note the location of the ipc file is printed to the console when you start geth. It is needed to for configuration**

## Start syncing with postgres
1. Start geth node (**if fast syncing wait for geth to finsh initial sync**)
1. In a separate terminal start vulcanize_db
    - `vulcanizedb sync --config <config.toml> --starting-block-number <block-number>`
    
   * see `./environments` for example config 

## Running the Tests

### Unit Tests

1. `go test ./pkg/...`

### Integration Test

1. Setup a test database and import the schema: 

   `createdb vulcanize_private`
   
    `psql vulcanize_private < db/schema.sql`
1. `go test ./...` to run all tests.
Add Travis indicator to readme 2017-10-19 14:45:37 +00:00			`# Vulcanize DB`
WIP 2018-01-25 23:19:15 +00:00
Add vendor dir (#16) (#4) * Add vendor dir so builds dont require dep * Pin specific version go-eth version 2018-01-29 19:44:18 +00:00			`[![Build Status](https://travis-ci.org/vulcanize/VulcanizeDB.svg?branch=master)](https://travis-ci.org/vulcanize/VulcanizeDB)`
Add README 2017-10-19 14:38:47 +00:00
Updates to readme 2017-10-25 14:01:13 +00:00			`### Dependencies`

			`- Go 1.9+`
Block categorization (#110) * Add block categorization (is_final=) * Add godo task for vulcanizeDB (Example of how everything could work together) * Add unique constraint on block_number and node * Add index on block_id for transactions_table * Add node_id index on blocks table * Sort transactions returned from FindBlock by tx_hash * lowercase tx_to, tx_from like etherscan 2017-12-20 20:06:22 +00:00			`- Postgres 10`
Update README.md 2018-03-07 21:34:55 +00:00			`- Ethereum Node`
			`- [Go Ethereum](https://ethereum.github.io/go-ethereum/downloads/) (1.8+)`
			`- [Parity 1.8.11+](https://github.com/paritytech/parity/releases)`
Allow Parity as ingest node (#36) * Upgrade go-ethereum to v1.8 * Add Node Info for parity nodes * Upgrade start_private_blockchain to use v1.8 2018-03-07 21:29:21 +00:00
Remove godo (#136) 2018-01-25 21:46:55 +00:00			`### Installation`
Add vendor dir (#16) (#4) * Add vendor dir so builds dont require dep * Pin specific version go-eth version 2018-01-29 19:44:18 +00:00			`go get github.com/vulcanize/vulcanizedb`

Add the concept of multiple environments * Right now, the two environments are Public and Private * This was to reflect the two blockchains we run against 2017-11-01 15:17:01 +00:00			`### Setting up the Databases`
Add instructions for creating the database and the initial table 2017-10-25 15:05:29 +00:00
			`1. Install Postgres`
Remove geth --dev dep 2018-03-21 18:44:01 +00:00			1. Create a superuser for yourself and make sure `psql --list` works without prompting for a password.
			1. `createdb vulcanize_private`
			1. `cd $GOPATH/src/github.com/vulcanize/vulcanizedb`
			1. Import the schema: `psql vulcanize_private < db/schema.sql`
Update README, add State sync test (#1) 2018-01-26 19:38:14 +00:00
			or run the migrations: `make migrate HOST_NAME=localhost NAME=vulcanize_public PORT=5432`
Update README to account for environment based changes 2017-11-03 21:52:19 +00:00			`* See below for configuring additional environments`
Remove godo (#136) 2018-01-25 21:46:55 +00:00
Update README 2018-01-26 19:51:13 +00:00			`### IPC File Paths`

			`The default location for Ethereum is:`
			- `$HOME/Library/Ethereum` for Mac
			- `$HOME/.ethereum` for Ubuntu
			- `$GOPATH/src/gihub.com/vulcanize/vulcanizedb/test_data_dir/geth.ipc` for private node.

			`Note the location of the ipc file is printed to the console when you start geth. It is needed to for configuration`
Add instructions for creating the database and the initial table 2017-10-25 15:05:29 +00:00
Remove godo (#136) 2018-01-25 21:46:55 +00:00			`## Start syncing with postgres`
Update README, add State sync test (#1) 2018-01-26 19:38:14 +00:00			`1. Start geth node (if fast syncing wait for geth to finsh initial sync)`
Remove geth --dev dep 2018-03-21 18:44:01 +00:00			`1. In a separate terminal start vulcanize_db`
Update README 2018-01-26 19:51:13 +00:00			- `vulcanizedb sync --config <config.toml> --starting-block-number <block-number>`
Remove godo (#136) 2018-01-25 21:46:55 +00:00
Update README 2018-01-26 19:51:13 +00:00			* see `./environments` for example config
Block categorization (#110) * Add block categorization (is_final=) * Add godo task for vulcanizeDB (Example of how everything could work together) * Add unique constraint on block_number and node * Add index on block_id for transactions_table * Add node_id index on blocks table * Sort transactions returned from FindBlock by tx_hash * lowercase tx_to, tx_from like etherscan 2017-12-20 20:06:22 +00:00
Add Travis indicator to readme 2017-10-19 14:45:37 +00:00			`## Running the Tests`
Add README 2017-10-19 14:38:47 +00:00
Block categorization (#110) * Add block categorization (is_final=) * Add godo task for vulcanizeDB (Example of how everything could work together) * Add unique constraint on block_number and node * Add index on block_id for transactions_table * Add node_id index on blocks table * Sort transactions returned from FindBlock by tx_hash * lowercase tx_to, tx_from like etherscan 2017-12-20 20:06:22 +00:00			`### Unit Tests`
Add integration test * Update Travis to run integration tests 2017-10-24 14:24:07 +00:00
Block categorization (#110) * Add block categorization (is_final=) * Add godo task for vulcanizeDB (Example of how everything could work together) * Add unique constraint on block_number and node * Add index on block_id for transactions_table * Add node_id index on blocks table * Sort transactions returned from FindBlock by tx_hash * lowercase tx_to, tx_from like etherscan 2017-12-20 20:06:22 +00:00			1. `go test ./pkg/...`
Add integration test * Update Travis to run integration tests 2017-10-24 14:24:07 +00:00
Block categorization (#110) * Add block categorization (is_final=) * Add godo task for vulcanizeDB (Example of how everything could work together) * Add unique constraint on block_number and node * Add index on block_id for transactions_table * Add node_id index on blocks table * Sort transactions returned from FindBlock by tx_hash * lowercase tx_to, tx_from like etherscan 2017-12-20 20:06:22 +00:00			`### Integration Test`
Add integration test * Update Travis to run integration tests 2017-10-24 14:24:07 +00:00
Remove geth --dev dep 2018-03-21 18:44:01 +00:00			`1. Setup a test database and import the schema:`
Update README, add State sync test (#1) 2018-01-26 19:38:14 +00:00
			`createdb vulcanize_private`

			`psql vulcanize_private < db/schema.sql`
Remove geth --dev dep 2018-03-21 18:44:01 +00:00			1. `go test ./...` to run all tests.