refactoring README.md

.gitignore

@@ -1 +1,2 @@
 .DS_Store
+/substreams/blockmeta-service-v0.1.0.spkg

README.md

@@ -1,20 +1,18 @@
 # BlockMeta Service 
 
-Welcome to the main repository of our project. This repository is organized into two main sub-repositories, each dedicated to a specific component of the project. 
-For detailed information on each component, please refer to the respective `README.md` files within the sub-repositories.
+This repository provides all the keys to run a block meta service that provides high-level data on blocks, for any blockchain supported by StreamingFast.
+To make such a service, you will have to extract block meta data first, store them in a kv store and then serve it.
 
-## Sub-Repositories
+## Extracting and Storing data 
 
-### Server
+To extract block meta data, you will need `substreams_spkg_path`. In order to get this package path, please visit the [substreams](./substreams/README.md). 
+Then you will need to run a substreams-sink-kv server, please refer to the [substreams-sink-kv](https://github.com/streamingfast/substreams-sink-kv) 
+repository that explains how to do so. 
 
-For information specific on the server, see the `README.md` in the `server` directory:
+This server will then be able to extract block meta data from the substreams and store it in a key-value store.
 
-- **Location**: [server/README.md](./server/README.md)
-- **Contents**: This README contains details on how to run a server which provides block meta data, and some examples queries and responses when querying this server.
+## Serving data
 
-### Substreams
+To serve block meta data, first be sure you have a substreams-sink-kv server running. 
+Then, you can run a block-meta server referring to the [block-meta documentation](./server/README.md).
 
-For information specific on the project's substreams, consult the `README.md` in the `substreams` directory:
-
-- **Location**: [substreams/README.md](./substreams/README.md)
-- **Contents**: This README provides details on the substreams created for this project.

server/README.md

@@ -17,9 +17,10 @@ convert block IDs to block numbers, fetch the latest block information, and quer
 
 ## Running 
 
-To run a block-meta server, you can use the `blockmeta` binary. 
-The following command will start a block-meta server which will listen a specified address and will be connected to a specified sink-server
-from which it will extract the block metadata.
+Running a block-meta server, uses the `blockmeta` binary. 
+In order to run properly, the server has to be connected to a [substreams-sink-kv](https://github.com/streamingfast/substreams-sink-kv) server.
+To connect to the sink server, you can provide the substreams-sink-kv server address within the `--sink-addr` flag. 
+The server will then connect to the sink server and start listening for gRPC requests on the address provided in the `--grpc-listen-addr` flag.
 
 ```bash 
 blockmeta --sink-addr  localhost:9000 --grpc-listen-addr localhost:50051 

substreams/README.md

@@ -0,0 +1,9 @@
+# BlockMeta Substreams 
+This substreams provides high level information on block data for any blockchain supported by StreamingFast.
+block number, hash or id and timestamp are the information provided by this substreams.
+
+## Substreams package
+- BlockMeta Substreams package is available here [releases](https://github.com/streamingfast/blockmeta-service/releases/) 
+- Package can also be built from source by running `make pack` in the substreams directory.
+
+for more information on the substreams package, please visit the [substreams documentation](https://substreams.streamingfast.io/documentation/develop/)