Saltearse al contenido

API del Indexador Auto-Alojada

Esta guía te llevará a través de la configuración de una API del Indexador auto-alojada.

  • Se requiere una instancia de PostgreSQL ejecutándose, con un usuario y base de datos válidos. En este ejemplo llamamos al usuario postgres y a la base de datos indexer.
  • Si deseas usar Docker, debes tener Docker instalado. Guía de Instalación.

Para ejecutar el servicio necesitamos definir un archivo de configuración. Comenzaremos con esta plantilla:

health_check_port: 8084
server_config:
processor_config:
type: default_processor
postgres_connection_string: postgresql://postgres:@localhost:5432/indexer
indexer_grpc_data_service_address: 127.0.0.1:50051
indexer_grpc_http2_ping_interval_in_secs: 60
indexer_grpc_http2_ping_timeout_in_secs: 10
auth_token: AUTH_TOKEN

Desde aquí probablemente querrás cambiar los valores de algunos de estos campos. Vamos a revisar algunos de ellos.

Este es el procesador que quieres ejecutar. Puedes ver qué procesadores están disponibles aquí. Algunos ejemplos:

  • coin_processor
  • ans_processor
  • token_v2_processor

Esta es la cadena de conexión a tu base de datos PostgreSQL. Debe estar en el formato postgresql://<username>:<password>@<host>:<port>/<database>.

Esta es la URL para el Servicio de Stream de Transacciones. Si estás usando la instancia alojada por Labs puedes encontrar las URLs para cada red en esta página. Asegúrate de seleccionar la URL correcta para la red que quieres indexar. Si estás ejecutando este servicio localmente el valor debe ser 127.0.0.1:50051.

Este es el token de autenticación usado para conectarse al Servicio de Stream de Transacciones. Si estás usando la instancia alojada por Labs puedes usar la API Gateway para obtener una API key. Aprende más en esta página.

Clona el repositorio:

Ventana de terminal
# SSH
git clone git@github.com:aptos-labs/aptos-indexer-processors-v2.git
# HTTPS
git clone https://github.com/aptos-labs/aptos-indexer-processors-v2.git

Navega al directorio para el servicio:

Ventana de terminal
cd aptos-indexer-processors
cd rust/processor

Ejecuta el servicio:

Ventana de terminal
cargo run --release -- -c config.yaml