|
1 | 1 | # Sirato
|
2 | 2 |
|
3 |
| -Blockchain Explorer for Besu, Quorum, VMBC and Ethereum |
| 3 | +Blockchain Explorer for Besu, Quorum, VMWare Blockchain and Ethereum compatible blockchains |
4 | 4 |
|
5 |
| - |
| 5 | + |
6 | 6 |
|
7 | 7 | ## Introduction
|
8 | 8 |
|
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. |
11 | 10 |
|
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. |
13 | 12 |
|
14 |
| -## Usage |
| 13 | +A free developer edition is available in this repo, we also provide hosted plans for it. They are outlined below. |
15 | 14 |
|
16 |
| -Clone the repo, navigate to the cloned directory and run the instance with: |
| 15 | +## Free plan |
17 | 16 |
|
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. |
22 | 19 |
|
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 | + |
24 | 21 |
|
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 |
26 | 23 |
|
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: |
30 | 25 |
|
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+) |
32 | 33 |
|
33 |
| -```bash |
34 |
| -NODE_ENDPOINT=http://host.docker.internal:8545 docker-compose up |
35 |
| -``` |
| 34 | + |
36 | 35 |
|
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. |
38 | 37 |
|
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). |
40 | 39 |
|
41 |
| -Append the `-d` argument to run the containers in the backgroud |
| 40 | +### Deployment instructions |
42 | 41 |
|
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. |
44 | 43 |
|
45 |
| -* http://localhost/ |
| 44 | +Follow the appropriate guide to run Sirato locally against an Ethereum, Quorum, Hyperledger Besu, or VMBC compatible network. |
46 | 45 |
|
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 |
| - |
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 |
| - |
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) |
97 | 48 |
|
98 | 49 | ## License
|
99 | 50 |
|
|
0 commit comments