envio-linux-x64 0.0.9 → 0.0.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -5
- package/bin/envio +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
@@ -4,12 +4,13 @@ A fast, reliable, customizable indexing blockchain solution.
|
|
4
4
|
|
5
5
|
Envio is a reliable real-time indexing solution designed to simplify the ingestion of events from EVM-compatible chains and transform this data into custom GraphQL APIs. These APIs play a pivotal role in enabling seamless user experiences in blockchain application front-ends. With Envio, the emphasis is on refining the developer's experience when using an indexer, ensuring the service is swift, secure, and trustworthy.
|
6
6
|
|
7
|
-
|
7
|
+
_Note: For a thorough understanding and to dive deeper into each feature, refer to the original [documentation website](https://docs.envio.dev)._
|
8
8
|
|
9
9
|
## Table of Contents
|
10
10
|
|
11
11
|
<!-- TODO: features summary will be nice to add -->
|
12
12
|
<!-- - [Features](#features) -->
|
13
|
+
|
13
14
|
- [Quickstart](#quickstart)
|
14
15
|
- [Installation](#installation)
|
15
16
|
- [Usage](#usage)
|
@@ -17,14 +18,16 @@ Envio is a reliable real-time indexing solution designed to simplify the ingesti
|
|
17
18
|
- [Logging](#logging)
|
18
19
|
- [Contribution & Support](#contribution-&-support)
|
19
20
|
|
20
|
-
|
21
|
+
_Note: Envio is built for javascript, typescirpt and rescript. However in this readme we will only use typescript for examples. Refer to the [documentation website](https://docs.envio.dev) for full docs._
|
21
22
|
|
22
23
|
## [Quickstart](https://docs.envio.dev/docs/quickstart)
|
23
24
|
|
24
25
|
For a slightly larger tutorial please see the [Greeter contract tutorial](https://docs.envio.dev/docs/greeter-tutorial).
|
25
26
|
|
26
27
|
## [Installation](https://docs.envio.dev/docs/installation)
|
28
|
+
|
27
29
|
### Prerequisites
|
30
|
+
|
28
31
|
- [Node.js](https://nodejs.org/en/download/current)
|
29
32
|
- [pnpm](https://pnpm.io/installation) on [npm](https://www.npmjs.com/get-npm)
|
30
33
|
- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
@@ -44,12 +47,13 @@ envio --help
|
|
44
47
|
## Usage
|
45
48
|
|
46
49
|
**Important Commands Overview:**
|
50
|
+
|
47
51
|
- `envio`
|
48
52
|
- `envio init` - Auto-generates configuration, GraphQL schema, and event handlers based on the Greeter template.
|
49
53
|
- `envio codegen` - Generates code after setting configuration and schema files.
|
50
54
|
- `envio start` - Start the indexer.
|
51
|
-
- `envio dev
|
52
|
-
- `envio
|
55
|
+
- `envio dev` - Starts all the processes required for local development of the indexer.
|
56
|
+
- `envio stop` - Delete the database and stop all processes
|
53
57
|
|
54
58
|
For a detailed breakdown of commands, refer to the [documentation](https://docs.envio.dev/docs/cli-commands).
|
55
59
|
|
@@ -62,6 +66,7 @@ npx envio codegen
|
|
62
66
|
```
|
63
67
|
|
64
68
|
Custom code to make it easy to retrieve and process events from our contract is generated. More specifically every event necessitates the registration of two core functions from our generated code:
|
69
|
+
|
65
70
|
- Loader function
|
66
71
|
- Handler function
|
67
72
|
|
@@ -72,6 +77,7 @@ Loader functions are responsible for loading specific entities (defined in `sche
|
|
72
77
|
```typescript
|
73
78
|
<ContractName>Contract_ < EventName > _loader;
|
74
79
|
```
|
80
|
+
|
75
81
|
**NOTE**: the syntax is slightly different for javascript and rescript. See [loader docs](https://docs.envio.dev/docs/event-handlers#loader-function).
|
76
82
|
|
77
83
|
### Handler Function
|
@@ -81,6 +87,7 @@ Handler functions modify the entities loaded by the loader function. They incorp
|
|
81
87
|
```typescript
|
82
88
|
<ContractName>Contract_ < EventName > _handler;
|
83
89
|
```
|
90
|
+
|
84
91
|
**NOTE**: the syntax is slightly different for javascript and rescript. See [handler docs](https://docs.envio.dev/docs/event-handlers#handler-function).
|
85
92
|
|
86
93
|
For a comprehensive guide on Event Handlers, please refer to the [provided documentation](https://docs.envio.dev/docs/event-handlers).
|
@@ -90,6 +97,7 @@ For a comprehensive guide on Event Handlers, please refer to the [provided docum
|
|
90
97
|
Logging is integral for tracking the progress and debugging issues in the indexer. Envio utilizes the [pino](https://github.com/pinojs/pino/) logging library, which can be integrated with tools like [kibana](https://www.elastic.co/what-is/kibana) to extract metrics and insights.
|
91
98
|
|
92
99
|
For user-level logging, context-based functions are provided:
|
100
|
+
|
93
101
|
- `<context>.log.debug`
|
94
102
|
- `<context>.log.info`
|
95
103
|
- `<context>.log.warn`
|
@@ -102,7 +110,7 @@ Further details about developer logging, including log levels, can be found in t
|
|
102
110
|
|
103
111
|
🔧 This product under active development. Please always refer to the main documentation for the latest updates.
|
104
112
|
|
105
|
-
For support and updates, follow Envio on [Twitter](https://twitter.com/envio_indexer) or join the [Discord community](https://discord.gg/DhfFhzuJQh).
|
113
|
+
For support and updates, follow Envio on [Twitter](https://twitter.com/envio_indexer) or join the [Discord community](https://discord.gg/DhfFhzuJQh).
|
106
114
|
|
107
115
|
If you have specific suggestions or requirements, kindly reach out and contribute to the development of Envio.
|
108
116
|
|
package/bin/envio
CHANGED
Binary file
|