Skip to content

Commit 30efac7

Browse files
authored
Update docs (#5)
* Update docs * Update spanish docs
1 parent 73baa3a commit 30efac7

6 files changed

Lines changed: 224 additions & 165 deletions

File tree

.github/workflows/pr.yaml

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,12 @@ name: Pulll Request App Build
22

33
# Controls when the action will run.
44
on:
5-
# Triggers the workflow pull request events but only for the main and develop branch
5+
# Triggers the workflow pull request events
66
pull_request:
7-
branches: [main, develop, staging]
7+
branches: ['**']
8+
# Triggers the workflow push events but only for the main
9+
push:
10+
branches: [main]
811

912
# Allows you to run this workflow manually from the Actions tab
1013
workflow_dispatch:
@@ -59,4 +62,9 @@ jobs:
5962
# run: pnpm test:e2e
6063

6164
- name: Build source code.
62-
run: pnpm build
65+
run: pnpm build
66+
67+
- name: Coveralls
68+
uses: coverallsapp/github-action@master
69+
with:
70+
github-token: ${{ secrets.GITHUB_TOKEN }}

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Changelog
2+
3+
## 1.0.0
4+
Published by **[blockcoders](https://github.com/blockcoders)** on **2022/09/28**
5+
- [#1](https://github.com/blockcoders/ink-substrate-explorer-api/pull/1) Release v1.0.0 - Milestone 1 Ink Explorer API

CONTRIBUTING.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Contributing
2+
3+
1. [Fork it](https://help.github.com/articles/fork-a-repo/)
4+
2. Install dependencies (`pnpm i --frozen-lockfile`)
5+
3. Create your feature branch (`git checkout -b my-new-feature`)
6+
4. Commit your changes (`git commit -am 'Added some feature'`)
7+
5. Test your changes (`pnpm test`)
8+
6. Push to the branch (`git push origin my-new-feature`)
9+
7. [Create new Pull Request](https://help.github.com/articles/creating-a-pull-request/)
10+
11+
## Testing
12+
13+
We use [Jest](https://github.com/facebook/jest) to write tests. Run our test suite with this command:
14+
15+
```
16+
pnpm test
17+
```
18+
19+
## Code Style
20+
21+
We use [Prettier](https://prettier.io/) and tslint to maintain code style and best practices.
22+
Please make sure your PR adheres to the guides by running:
23+
24+
```
25+
pnpm format
26+
```
27+
28+
and
29+
```
30+
pnpm lint
31+
```

README-es.md

Lines changed: 88 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# **Ink! Explorer**
1+
Ink! Explorer API
2+
=================
3+
4+
[![App Build](https://github.com/blockcoders/ink-substrate-explorer-api/actions/workflows/pr.yaml/badge.svg)](https://github.com/blockcoders/ink-substrate-explorer-api/actions/workflows/pr.yaml)
5+
[![Coverage Status](https://coveralls.io/repos/github/blockcoders/ink-substrate-explorer-api/badge.svg?branch=main)](https://coveralls.io/github/blockcoders/ink-substrate-explorer-api?branch=main)
6+
[![Known Vulnerabilities](https://snyk.io/test/github/blockcoders/ink-substrate-explorer-api/badge.svg)](https://snyk.io/test/github/blockcoders/ink-substrate-explorer-api)
27

38
## **Acerca del explorador**
49

@@ -8,47 +13,6 @@ La idea de este proyecto es brindar una herramienta que permita a los desarrolla
813

914
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.
1015

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.
30-
31-
### Repositorios del equipo
32-
33-
- https://github.com/blockcoders
34-
- https://github.com/blockcoders/nestjs-ethers
35-
- https://github.com/blockcoders/harmony-marketplace-sdk
36-
- https://github.com/blockcoders/near-rpc-providers
37-
- https://github.com/athenafarm/athena-vault-contracts
38-
- https://github.com/athenafarm/athena-sdk
39-
40-
### Githubs de los miembros del equipo
41-
42-
- https://github.com/0xslipk
43-
- https://github.com/fersirni
44-
- https://github.com/RubenGutierrezC
45-
46-
### Perfiles de linkedIn de los miembros del equipo
47-
48-
- https://www.linkedin.com/in/jarcodallo/
49-
- https://www.linkedin.com/in/fernando-sirni-1931ba122/
50-
- https://www.linkedin.com/in/rubengutierrezc/
51-
5216
## **Introduccion**
5317

5418
## Levantando el servicio localmente
@@ -62,49 +26,58 @@ Nuestro equipo ha estado contribuyendo con diferentes proyectos en blockchain du
6226

6327
### Instalar todas las dependencias
6428

65-
```
29+
```sh
6630
pnpm i --frozen-lockfile
6731
```
6832

6933
### Configurar las variables de entorno
7034

7135
**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.
7236

73-
```
37+
```sh
7438
cp .env.sample .env
7539
```
7640

77-
<span style="color:#2a98db"> **Configuraciones del servicio** </span>
41+
#### Configuraciones del servicio
7842

79-
- **NODE_ENV**=development
80-
- **PORT**=8080
81-
- **LOG_NAME**=ink-substrate-explorer-api
82-
- **LOG_LEVEL**=debug
83-
84-
<span style="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+
```
9049

91-
<span style="color:#2a98db"> **Configuraciones de la base de datos** </span>
50+
#### Configuraciones de GraphQL
9251

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+
```
9958

100-
<span style="color:#2a98db"> **Configuraciones de la blockchain y la sincronizacion de datos** </span>
59+
#### Configuraciones de la base de datos
10160

102-
- **WS_PROVIDER**=wss://rococo-contracts-rpc.polkadot.io
103-
- **LOAD_ALL_BLOCKS**=false - <span style="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+
```
10469

105-
- **FIRST_BLOCK_TO_LOAD**=0 - <span style="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
10671

107-
- **BLOCK_CONCURRENCY**=1000 - <span style="color:#2a98db"> Número de bloques a procesar simultáneamente. Esto puede acelerar o retrasar el proceso de sincronización.</span>
72+
```sh
73+
WS_PROVIDER=wss://rococo-contracts-rpc.polkadot.io
74+
# 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+
```
10881

10982
## **Levantando el servicio (DEV)**
11083

@@ -113,7 +86,7 @@ cp .env.sample .env
11386
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.
11487
Ejecutando el siguiente comando tambien instanciara un contenedor para pgAdmin:
11588

116-
```
89+
```sh
11790
docker-compose -f dev-docker-compose.yaml up -d
11891
```
11992

@@ -145,7 +118,7 @@ Establezca las credenciales para la base de datos PostgreSQL (esto se puede enco
145118
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.
146119
Ejecute este comando:
147120

148-
```
121+
```sh
149122
docker-compose -f dev-docker-compose.yaml up -d
150123
```
151124

@@ -155,7 +128,9 @@ Otra forma de ejecutar un nodo local es con [esta guía de paritytech](https://g
155128

156129
### Levantando el servicio
157130

158-
- ### `pnpm start:dev`
131+
```sh
132+
pnpm start:dev
133+
```
159134

160135
Ejecuta el servicio en el modo de desarrollo.
161136
El servicio se recargará si realiza ediciones.
@@ -168,23 +143,30 @@ El servicio se recargará si realiza ediciones.
168143

169144
### Descarga la imagen de DockerHub
170145

171-
```
146+
```sh
172147
docker pull blockcoders/ink-substrate-explorer-api:latest
173148
```
174149

175150
### Run
176151

177-
- ### `docker run -it -p 5000:5000 --network ink-explorer-network --env-file {pathToEnvFile} blockcoders/ink-substrate-explorer-api:latest`
178-
179-
Verifique que la imagen comenzó a ejecutarse
152+
```sh
153+
# Crear la red de docker
154+
docker network create ink-explorer-network
180155

156+
# Correr servicio
157+
docker run -it -p 5000:5000 --network ink-explorer-network --env-file {pathToEnvFile} blockcoders/ink-substrate-explorer-api:latest
181158
```
159+
160+
161+
#### Verifique que la imagen comenzó a ejecutarse
162+
163+
```sh
182164
docker ps
183165
```
184166

185167
El resultado debería verse así:
186168

187-
```
169+
```sh
188170
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
189171
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
190172
```
@@ -193,23 +175,31 @@ Después de que se inició el servidor, los bloques deberían guardarse en la ba
193175

194176
Para iniciar tanto el contenedor del servicio de back-end como el contenedor de la base de datos, ejecute:
195177

196-
- ### `docker-compose up -d`
178+
```sh
179+
docker-compose up -d
180+
```
197181

198182
El servicio se conectará al contenedor DB y comenzará a procesar bloques.
199183

200184
## **Testing**
201185

202186
Ejecución de las pruebas unitarias.
203187

204-
- ### `pnpm test`
188+
```sh
189+
pnpm test
190+
```
205191

206192
Ejecución de la cobertura de pruebas.
207193

208-
- ### `pnpm test:cov`
194+
```sh
195+
pnpm test:cov
196+
```
209197

210198
Probando las consultas de GraphQL.
211199

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+
```
213203

214204
Una vez que el servicio back-end se está ejecutando, se puede acceder a GraphQL Playground en http://localhost:5000/graphql
215205

@@ -659,3 +649,21 @@ En caso de un tiempo de inactividad del nodo, las suscripciones se reconectarán
659649
- 1000 bloques en ~ 5 segundos
660650
- 10000 bloques en ~ 3 minutos
661651
- 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).
660+
661+
## Colaboradores
662+
663+
* [__Jose Ramirez__](https://github.com/0xslipk)
664+
* [__Fernando Sirni__](https://github.com/fersirni)
665+
* [__Ruben Gutierrez__](https://github.com/RubenGutierrezC)
666+
667+
## Licencia
668+
669+
Con licencia de Apache 2.0 - consulte el archivo [LICENSE](LICENSE) para obtener más información.

0 commit comments

Comments
 (0)