Skip to content

Commit 6539a39

Browse files
committed
Add docker-compose directory structure and clean up readme
1 parent cf2fb7f commit 6539a39

22 files changed

+106
-97
lines changed

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# OS X
2+
.DS_Store

README.md

Lines changed: 26 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,99 +1,50 @@
11
# Sirato
22

3-
Blockchain Explorer for Besu, Quorum, VMBC and Ethereum
3+
Blockchain Explorer for Besu, Quorum, VMWare Blockchain and Ethereum compatible blockchains
44

5-
![alt text](https://raw.githubusercontent.com/blk-io/epirus-free/master/images/Contracts.png "Epirus Free")
5+
![alt text](https://raw.githubusercontent.com/web3labs/sirato-free/master/images/sirato-dashboard.png "Sirato dashboard")
66

77
## Introduction
88

9-
This dockerized environment is designed for viewing public and private Ethereum networks. It supports
10-
[Quorum](https://github.com/ConsenSys/quorum), [Hyperledger Besu](https://besu.hyperledger.org/en/stable/) and [Ethereum](https://github.com/ethereum/go-ethereum) networks.
9+
Sirato is a data and analytics platform for Ethereum compatible blockchains.
1110

12-
Instructions for Docker are below, instructions for Kubernetes are available [here](k8s/README.md).
11+
It provides a rich API, and easy to use interface to provide information on the various assets such as tokens, and smart contracts deployed on blockchains.
1312

14-
## Usage
13+
A free developer edition is available in this repo, we also provide hosted plans for it. They are outlined below.
1514

16-
Clone the repo, navigate to the cloned directory and run the instance with:
15+
## Free plan
1716

18-
```bash
19-
docker-compose pull
20-
NODE_ENDPOINT=http://<node_endpoint> docker-compose up
21-
```
17+
This distribution of Sirato is a free version designed for viewing public and private Ethereum networks. It supports
18+
[Quorum](https://github.com/ConsenSys/quorum), [Hyperledger Besu](https://besu.hyperledger.org/en/stable/), [VMWare Blockchain for Ethereum](https://www.vmware.com/products/blockchain.html) and [Ethereum](https://github.com/ethereum/go-ethereum) networks.
2219

23-
Note that if setting `NODE_ENDPOINT` to a local Ethereum instance, you may need to use the IP address associated with the Docker bridged interface.
20+
![alt text](https://raw.githubusercontent.com/web3labs/sirato-free/master/images/sirato-free.png "Sirato free")
2421

25-
On Linux, the bridged adapter should be 172.16.239.1, as denoted in docker-compose.yml. To connect to a local node, start with the command:
22+
## Hosted plans
2623

27-
```bash
28-
NODE_ENDPOINT=http://172.16.239.1:8545 docker-compose up
29-
```
24+
Web3 Labs provides hosted plans that provides additional functionality including:
3025

31-
On MacOS and Windows, a platform sepcific command is required due to limitations around the Docker network stack on MacOS. This is as follows:
26+
- Custom branding and hosting at a custom domain
27+
- Dedicated views of tokens
28+
- Smart contract management and source code upload
29+
- OpenAPI back-end
30+
- Integrations with business intelligence tools such as Tableau Microsoft PowerBI and Qlik
31+
- Production SLAs
32+
- Large transaction volumes (100,000,000+)
3233

33-
```bash
34-
NODE_ENDPOINT=http://host.docker.internal:8545 docker-compose up
35-
```
34+
![alt text](https://raw.githubusercontent.com/web3labs/sirato-free/master/images/palm-verified-sourcecode.png "Sirato customer instance Palm with verified source code")
3635

37-
Note that in both cases, your local instance of geth must be started with `--rpcaddr 0.0.0.0` and `--rpcvhosts="*"`, or Epirus will be unable to access it.
36+
The advantage of the hosted plan is that all you need to provide is a compatible web3 client endpoint and we will do the rest.
3837

39-
Also note that on Windows Epirus may take a long time to come up (sometimes up to 20 minutes) due to Windows filesystem performance issues with Linux VMs.
38+
You can view more information on these plans [here](https://www.web3labs.com/blockchain-explorer-sirato-plans), or contact Web3 Labs directly via [hi@web3labs.com](mailto:hi@web3labs.com?subject=Sirato%20hosted%20plans).
4039

41-
Append the `-d` argument to run the containers in the backgroud
40+
### Deployment instructions
4241

43-
You will be able to access the Explorer UI via:
42+
This repo contains configuration to run the free version using either Docker Compose or Kubernetes.
4443

45-
* http://localhost/
44+
Follow the appropriate guide to run Sirato locally against an Ethereum, Quorum, Hyperledger Besu, or VMBC compatible network.
4645

47-
To stop the containers use:
48-
49-
```bash
50-
docker-compose down
51-
```
52-
53-
To connect to new network you should remove the volumes associated with the old network
54-
55-
```bash
56-
docker-compose down -v
57-
```
58-
59-
## VMware Blockchain (VMBC)
60-
61-
Sirato supports [VMware Blockchain](https://vmware-samples.github.io/vmware-blockchain-samples/) platform. Follow this [guide](k8s/README.md) to start Sirato within VMWare Blockchain Kubernetes cluster,
62-
63-
## Quorum & Hyperledger Besu
64-
65-
To run the Quroum 7 node example with epirus free [follow these instructions](examples/Quorum_Example.md).
66-
67-
68-
To run the Pantheon-quickstart privacy network example [follow these instructions](examples/Pantheon_Privacy_Example.md).
69-
70-
71-
## Tokens and contract metadata
72-
73-
![Tokens screen](https://raw.githubusercontent.com/blk-io/epirus-free/master/images/Tokens.png)
74-
75-
This is a free version of our Sirato Blockchain Explorer. For additional features such as full tokens support,
76-
and contract metadata upload (so all transaction and events are decoded), please use our offering available on the
77-
[Azure Marketplace](https://web3labs.com/azure-offer).
78-
79-
![Azure offering](https://raw.githubusercontent.com/blk-io/epirus-free/master/images/Azure-offer.png)
80-
81-
We can also provide hosted Blockchain Explorer instances - these can be hosted within your cloud subscription or hosted by us.
82-
83-
Some of the features include:
84-
85-
- SSO authentication (Active Directory, SAML, Okta, etc)
86-
- Dedicated database
87-
- Data encryption at rest and in transit
88-
- Continuous backup and point in time data recovery
89-
- Full access to backups
90-
- Tableau integration support
91-
92-
For further information visit our [website](https://www.web3labs.com) or email <support@web3labs.com>.
93-
94-
## Limitations
95-
96-
- Due to a [limitation](https://github.com/moby/moby/issues/1143) with Docker, you may only have one instance of the Explorer running at a time.
46+
- [Docker Compose deployment](docker-compose/README.md)
47+
- [Kubernetes deployment](k8s/README.md)
9748

9849
## License
9950

File renamed without changes.

docker-compose/README.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
## Usage
2+
3+
Clone the repo, navigate to the cloned directory and run the instance with:
4+
5+
```bash
6+
cd docker-compose
7+
docker-compose pull
8+
NODE_ENDPOINT=http://<node_endpoint> docker-compose up
9+
```
10+
11+
Note that if setting `NODE_ENDPOINT` to a local Ethereum instance, you may need to use the IP address associated with the Docker bridged interface.
12+
13+
On Linux, the bridged adapter should be 172.16.239.1, as denoted in docker-compose.yml. To connect to a local node, start with the command:
14+
15+
```bash
16+
NODE_ENDPOINT=http://172.16.239.1:8545 docker-compose up
17+
```
18+
19+
On MacOS and Windows, a platform sepcific command is required due to limitations around the Docker network stack on MacOS. This is as follows:
20+
21+
```bash
22+
NODE_ENDPOINT=http://host.docker.internal:8545 docker-compose up
23+
```
24+
25+
Note that in both cases, your local instance of geth must be started with `--rpcaddr 0.0.0.0` and `--rpcvhosts="*"`, or Sirato will be unable to access it.
26+
27+
Also note that on Windows Sirato may take a long time to come up (sometimes up to 20 minutes) due to Windows filesystem performance issues with Linux VMs.
28+
29+
Append the `-d` argument to run the containers in the backgroud
30+
31+
You will be able to access the Explorer UI via:
32+
33+
* http://localhost/
34+
35+
To stop the containers use:
36+
37+
```bash
38+
docker-compose down
39+
```
40+
41+
To connect to new network you should remove the volumes associated with the old network
42+
43+
```bash
44+
docker-compose down -v
45+
```
46+
47+
## Quorum & Hyperledger Besu
48+
49+
To run the Quroum 7 node example with sirato free [follow these instructions](examples/Quorum_Example.md).
50+
51+
To run the Pantheon-quickstart privacy network example [follow these instructions](examples/Pantheon_Privacy_Example.md).
52+
53+
## Limitations
54+
55+
- Due to a [limitation](https://github.com/moby/moby/issues/1143) with Docker, you may only have one instance of the Explorer running at a time.
56+
File renamed without changes.

examples/Besu_Example.md renamed to docker-compose/examples/Besu_Example.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,25 @@
33
#### Set up Epirus-Free
44

55
```
6-
git clone https://github.com/web3labs/epirus-free.git
7-
cd epirus-free
6+
git clone https://github.com/web3labs/sirato-free.git
7+
cd sirato-free
88
```
99

10-
In order to start epirus you need to run the following command:
10+
In order to start sirato you need to run the following command:
1111

12-
`NODE_ENDPOINT=http://besu-node:8545 docker-compose -f docker-compose.yml -f epirus-extensions/docker-compose-besu.yml up`
12+
`NODE_ENDPOINT=http://besu-node:8545 docker-compose -f docker-compose.yml -f sirato-extensions/docker-compose-besu.yml up`
1313

1414
To run with [quorum-dev-quickstart](https://besu.hyperledger.org/en/stable/private-networks/tutorials/quickstart/#prerequisites) example run the following command:
1515

16-
`NODE_ENDPOINT=http://rpcnode:8545 docker-compose -f docker-compose.yml -f epirus-extensions/docker-compose-quorum-dev-quickstart.yml up`
16+
`NODE_ENDPOINT=http://rpcnode:8545 docker-compose -f docker-compose.yml -f sirato-extensions/docker-compose-quorum-dev-quickstart.yml up`
1717

1818
The command above does two things :
1919
* It sets up the node endpoint
2020
* Tells docker to run by using the two docker compose files provided.
2121

22-
The first docker-compose file in the command is the contains all the services required for epirus.
22+
The first docker-compose file in the command is the contains all the services required for sirato.
2323

24-
The second file named docker-compose-besu contains the network settings required to start epirus on the same network as Besu dev node.
24+
The second file named docker-compose-besu contains the network settings required to start sirato on the same network as Besu dev node.
2525

2626
> Note: TODO: add transaction examples
2727
@@ -51,7 +51,7 @@ To close Epirus or Besu you can execute the following line in your terminal:
5151

5252
#### Help & Additional Information
5353

54-
For more information on Epirus you can go [here](https://github.com/web3labs/epirus-free).
54+
For more information on Epirus you can go [here](https://github.com/web3labs/sirato-free).
5555

5656
For more information Besu setup example you can go [here](https://besu.hyperledger.org/en/stable/private-networks/get-started/install/run-docker-image/).
5757

examples/Pantheon_Privacy_Example.md renamed to docker-compose/examples/Pantheon_Privacy_Example.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -20,21 +20,21 @@ You should see the following happening in the terminal window.
2020
#### Set up Epirus-Free
2121

2222
```
23-
git clone https://github.com/blk-io/epirus-free.git
24-
cd epirus-free
23+
git clone https://github.com/web3labs/sirato-free.git
24+
cd sirato-free
2525
```
2626

27-
In order to start epirus you need to run the following command:
27+
In order to start sirato you need to run the following command:
2828

29-
`NODE_ENDPOINT=http://privacy_node1_1:8545 docker-compose -f docker-compose.yml -f epirus-extensions/docker-compose-pantheon.yml up`
29+
`NODE_ENDPOINT=http://privacy_node1_1:8545 docker-compose -f docker-compose.yml -f sirato-extensions/docker-compose-pantheon.yml up`
3030

3131
The command above does two things :
3232
* It sets up the node endpoint
3333
* Tells docker to run by using the two docker compose files provided.
3434

35-
The first docker-compose file in the command is the contains all the services required for epirus.
35+
The first docker-compose file in the command is the contains all the services required for sirato.
3636

37-
The second file named docker-compose-pantheon contains the network settings required to start epirus on the same network as pantheon.
37+
The second file named docker-compose-pantheon contains the network settings required to start sirato on the same network as pantheon.
3838

3939

4040
> Note: we are connecting to node 1 - you will only see private transactions for that node.
@@ -72,7 +72,7 @@ To close Pantheon you can execute the following line in your terminal:
7272

7373
#### Help & Additional Information
7474

75-
For more information on Epirus you can go [here](https://github.com/blk-io/epirus-free).
75+
For more information on Epirus you can go [here](https://github.com/web3labs/sirato-free).
7676

7777
For more information Pantheon-quickstart example you can go [here](https://github.com/PegaSysEng/pantheon-quickstart).
7878

examples/Quorum_Example.md renamed to docker-compose/examples/Quorum_Example.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,21 @@ You should see the following happening in the terminal window.
1717
#### Set up Epirus-Free
1818

1919
```
20-
git clone https://github.com/blk-io/epirus-free.git
21-
cd epirus-free
20+
git clone https://github.com/blk-io/Sirato-free.git
21+
cd Sirato-free
2222
```
2323

24-
In order to start epirus you need to run the following command:
24+
In order to start Sirato you need to run the following command:
2525

26-
`NODE_ENDPOINT=http://quorum-examples_node1_1:8545 docker-compose -f docker-compose.yml -f epirus-extensions/docker-compose-quorum.yml up`
26+
`NODE_ENDPOINT=http://quorum-examples_node1_1:8545 docker-compose -f docker-compose.yml -f Sirato-extensions/docker-compose-quorum.yml up`
2727

2828
The command above does two things :
2929
* It sets up the node endpoint
3030
* Tells docker to run by using the two docker compose files provided.
3131

32-
The first docker-compose file in the command is the contains all the services required for epirus.
32+
The first docker-compose file in the command is the contains all the services required for Sirato.
3333

34-
The second file named docker-compose-quorum contains the network settings required to start epirus on the same network as quorum.
34+
The second file named docker-compose-quorum contains the network settings required to start Sirato on the same network as quorum.
3535

3636
> Note: we are connecting to node 1 - you will only see private transactions for that node.
3737
@@ -61,7 +61,7 @@ To close Epirus or Quorum you can execute the following line in your terminal:
6161

6262
#### Help & Additional Information
6363

64-
For more information on Epirus you can go [here](https://github.com/blk-io/epirus-free).
64+
For more information on Epirus you can go [here](https://github.com/blk-io/Sirato-free).
6565

6666
For more information Quorum 7 Nodes example you can go [here](https://github.com/jpmorganchase/quorum-examples/blob/master/README.md).
6767

File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)