API del Indexador Auto-Alojada
Esta guía te llevará a través de la configuración de una API del Indexador auto-alojada.
Prerrequisitos
Sección titulada «Prerrequisitos»- 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 datosindexer
. - Si deseas usar Docker, debes tener Docker instalado. Guía de Instalación.
Configuración
Sección titulada «Configuración»Para ejecutar el servicio necesitamos definir un archivo de configuración. Comenzaremos con esta plantilla:
health_check_port: 8084server_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.
processor_name
Sección titulada «processor_name»Este es el procesador que quieres ejecutar. Puedes ver qué procesadores están disponibles aquí. Algunos ejemplos:
coin_processor
ans_processor
token_v2_processor
postgres_connection_string
Sección titulada «postgres_connection_string»Esta es la cadena de conexión a tu base de datos PostgreSQL. Debe estar en el formato postgresql://<username>:<password>@<host>:<port>/<database>
.
indexer_grpc_data_service_address
Sección titulada «indexer_grpc_data_service_address»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
.
auth_token
Sección titulada «auth_token»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.
Ejecutar con código fuente
Sección titulada «Ejecutar con código fuente»Clona el repositorio:
# SSHgit clone git@github.com:aptos-labs/aptos-indexer-processors-v2.git
# HTTPSgit clone https://github.com/aptos-labs/aptos-indexer-processors-v2.git
Navega al directorio para el servicio:
cd aptos-indexer-processorscd rust/processor
Ejecuta el servicio:
cargo run --release -- -c config.yaml