You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -8,47 +13,6 @@ La idea de este proyecto es brindar una herramienta que permita a los desarrolla
8
13
9
14
Este proyecto ofrece información útil que no está disponible en ningún otro lugar. Ya que el back end se encarga de obtener información relacionada con los saldos, transacciones y más, de los contratos que utilizan módulos Ink!. El explorador utiliza polkadot.js para comunicarse con las redes Substrate/Polkadot. Es seguro decir que este proyecto es imprescindible.
10
15
11
-
Blockcoders es un equipo que siempre está contribuyendo a los proyectos de blockchain para ayudar al crecimiento del ecosistema.
12
-
13
-
## **Sobre nosotros**
14
-
15
-
### Miembros del equipo
16
-
17
-
- Jose Ramirez
18
-
- Fernando Sirni
19
-
- Ruben Gutierrez
20
-
21
-
### Contacto
22
-
23
-
-**Nombre de contacto:** Jose Ramirez
24
-
-**Email de contacto:**jose@blockcoders.io
25
-
-**Sitio web:**http://blockcoders.io/
26
-
27
-
### Experiencia del equipo
28
-
29
-
Nuestro equipo ha estado contribuyendo con diferentes proyectos en blockchain durante algunos años, construyendo API, SDK y herramientas para desarrolladores. Nuestro objetivo es continuar impulsando el mundo crypto invirtiendo capital intelectual en proyectos, participando activamente para ayudar a dar forma a los ecosistemas en los que creemos.
@@ -62,49 +26,58 @@ Nuestro equipo ha estado contribuyendo con diferentes proyectos en blockchain du
62
26
63
27
### Instalar todas las dependencias
64
28
65
-
```
29
+
```sh
66
30
pnpm i --frozen-lockfile
67
31
```
68
32
69
33
### Configurar las variables de entorno
70
34
71
35
**Nota**: El archivo .env tiene la configuracion para GraphQL, la base de datos PostgreSQL, Node y la url del RPC de la blockchain basada en Substrate.
72
36
73
-
```
37
+
```sh
74
38
cp .env.sample .env
75
39
```
76
40
77
-
<spanstyle="color:#2a98db"> **Configuraciones del servicio** </span>
41
+
#### Configuraciones del servicio
78
42
79
-
-**NODE_ENV**=development
80
-
-**PORT**=8080
81
-
-**LOG_NAME**=ink-substrate-explorer-api
82
-
-**LOG_LEVEL**=debug
83
-
84
-
<spanstyle="color:#2a98db"> **Configuraciones de GraphQL** </span>
85
-
86
-
-**GRAPHQL_DEBUG**=true
87
-
-**GRAPHQL_PLAYGROUND**=true
88
-
-**GRAPHQL_SORT_SCHEMA**=true
89
-
-**GRAPHQL_INTROSPECTION**=true
43
+
```sh
44
+
NODE_ENV=development
45
+
PORT=8080
46
+
LOG_NAME=ink-substrate-explorer-api
47
+
LOG_LEVEL=debug
48
+
```
90
49
91
-
<spanstyle="color:#2a98db"> **Configuraciones de la base de datos** </span>
50
+
#### Configuraciones de GraphQL
92
51
93
-
-**DATABASE_HOST**=postgres
94
-
-**DATABASE_NAME**=ink
95
-
-**DATABASE_USERNAME**=root
96
-
-**DATABASE_PASSWORD**=password
97
-
-**DATABASE_RETRY_ATTEMPTS**=5
98
-
-**DATABASE_RETRY_DELAY**=3000
52
+
```sh
53
+
GRAPHQL_DEBUG=true
54
+
GRAPHQL_PLAYGROUND=true
55
+
GRAPHQL_SORT_SCHEMA=true
56
+
GRAPHQL_INTROSPECTION=true
57
+
```
99
58
100
-
<spanstyle="color:#2a98db"> **Configuraciones de la blockchain y la sincronizacion de datos** </span>
-**LOAD_ALL_BLOCKS**=false - <spanstyle="color:#2a98db"> Asignar el valor _true_ para procesar cada bloque desde FIRST_BLOCK_TO_LOAD hasta el ultimo bloque de la cadena. Asignar el valor _false_ para solo comenzar a procesar los bloques desde el ultimo bloque existente en la base de datos.</span>
61
+
```sh
62
+
DATABASE_HOST=postgres
63
+
DATABASE_NAME=ink
64
+
DATABASE_USERNAME=root
65
+
DATABASE_PASSWORD=password
66
+
DATABASE_RETRY_ATTEMPTS=5
67
+
DATABASE_RETRY_DELAY=3000
68
+
```
104
69
105
-
-**FIRST_BLOCK_TO_LOAD**=0 - <spanstyle="color:#2a98db"> Número de bloque a partir del cual el servicio comenzará a procesar bloques. (Puede ser génesis o algún otro bloque. Por ejemplo, el primer bloque admite contratos) </span>
70
+
#### Configuraciones de la blockchain y la sincronizacion de datos
106
71
107
-
-**BLOCK_CONCURRENCY**=1000 - <spanstyle="color:#2a98db"> Número de bloques a procesar simultáneamente. Esto puede acelerar o retrasar el proceso de sincronización.</span>
# Asignar el valor _true_ para procesar cada bloque desde FIRST_BLOCK_TO_LOAD hasta el ultimo bloque de la cadena. Asignar el valor _false_ para solo comenzar a procesar los bloques desde el ultimo bloque existente en la base de datos.
75
+
LOAD_ALL_BLOCKS=false
76
+
# Número de bloque a partir del cual el servicio comenzará a procesar bloques. (Puede ser génesis o algún otro bloque. Por ejemplo, el primer bloque admite contratos)
77
+
FIRST_BLOCK_TO_LOAD=0
78
+
# Número de bloques a procesar simultáneamente. Esto puede acelerar o retrasar el proceso de sincronización.
79
+
BLOCK_CONCURRENCY=1000
80
+
```
108
81
109
82
## **Levantando el servicio (DEV)**
110
83
@@ -113,7 +86,7 @@ cp .env.sample .env
113
86
Para levantar el servicio es necesario contar con una **BD PostgreSQL**. Para esto, el archivo **dev-docker-compose.yaml** ya tiene una imagen configurada lista para usar.
114
87
Ejecutando el siguiente comando tambien instanciara un contenedor para pgAdmin:
115
88
116
-
```
89
+
```sh
117
90
docker-compose -f dev-docker-compose.yaml up -d
118
91
```
119
92
@@ -145,7 +118,7 @@ Establezca las credenciales para la base de datos PostgreSQL (esto se puede enco
145
118
El servicio necesita conectarse a una blockchain basada en Substrate. Para esto, el archivo **dev-docker-compose.yaml** ya tiene una imagen configurada lista para usar.
146
119
Ejecute este comando:
147
120
148
-
```
121
+
```sh
149
122
docker-compose -f dev-docker-compose.yaml up -d
150
123
```
151
124
@@ -155,7 +128,9 @@ Otra forma de ejecutar un nodo local es con [esta guía de paritytech](https://g
155
128
156
129
### Levantando el servicio
157
130
158
-
-### `pnpm start:dev`
131
+
```sh
132
+
pnpm start:dev
133
+
```
159
134
160
135
Ejecuta el servicio en el modo de desarrollo.
161
136
El servicio se recargará si realiza ediciones.
@@ -168,23 +143,30 @@ El servicio se recargará si realiza ediciones.
docker run -it -p 5000:5000 --network ink-explorer-network --env-file {pathToEnvFile} blockcoders/ink-substrate-explorer-api:latest
181
158
```
159
+
160
+
161
+
#### Verifique que la imagen comenzó a ejecutarse
162
+
163
+
```sh
182
164
docker ps
183
165
```
184
166
185
167
El resultado debería verse así:
186
168
187
-
```
169
+
```sh
188
170
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
189
171
f31a7d0fd6c8 blockcoders/ink-substrate-explorer-api "docker-entrypoint.s…" 15 seconds ago Up 14 seconds 0.0.0.0:5000->5000/tcp, :::5000->5000/tcp funny_lumiere
190
172
```
@@ -193,23 +175,31 @@ Después de que se inició el servidor, los bloques deberían guardarse en la ba
193
175
194
176
Para iniciar tanto el contenedor del servicio de back-end como el contenedor de la base de datos, ejecute:
195
177
196
-
-### `docker-compose up -d`
178
+
```sh
179
+
docker-compose up -d
180
+
```
197
181
198
182
El servicio se conectará al contenedor DB y comenzará a procesar bloques.
199
183
200
184
## **Testing**
201
185
202
186
Ejecución de las pruebas unitarias.
203
187
204
-
-### `pnpm test`
188
+
```sh
189
+
pnpm test
190
+
```
205
191
206
192
Ejecución de la cobertura de pruebas.
207
193
208
-
-### `pnpm test:cov`
194
+
```sh
195
+
pnpm test:cov
196
+
```
209
197
210
198
Probando las consultas de GraphQL.
211
199
212
-
-### `{"level":30,"time":1664298430389,"pid":1388770,"hostname":"username","name":"ink-substrate-explorer-api","msg":"App listening on http://0.0.0.0:5000"}`
200
+
```sh
201
+
{"level":30,"time":1664298430389,"pid":1388770,"hostname":"username","name":"ink-substrate-explorer-api","msg":"App listening on http://0.0.0.0:5000"}
202
+
```
213
203
214
204
Una vez que el servicio back-end se está ejecutando, se puede acceder a GraphQL Playground en http://localhost:5000/graphql
215
205
@@ -659,3 +649,21 @@ En caso de un tiempo de inactividad del nodo, las suscripciones se reconectarán
659
649
- 1000 bloques en ~ 5 segundos
660
650
- 10000 bloques en ~ 3 minutos
661
651
- 100000 bloques en ~ 24 minutos
652
+
653
+
## Registro de cambios
654
+
655
+
Consulte [Changelog](CHANGELOG.md) para más información.
656
+
657
+
## Contribuye
658
+
659
+
¡Las contribuciones son bienvenidas! Consulte [Contributing](CONTRIBUTING.md).
0 commit comments