diff --git a/content/docs/en/tools/chainhooks/(chainhook-sdk)/secrets.mdx b/content/docs/en/tools/chainhooks/(chainhook-sdk)/secrets.mdx index 0fd554c02..85b73c675 100644 --- a/content/docs/en/tools/chainhooks/(chainhook-sdk)/secrets.mdx +++ b/content/docs/en/tools/chainhooks/(chainhook-sdk)/secrets.mdx @@ -35,7 +35,7 @@ const client = new ChainhooksClient({ }); // Store this value securely and use it to validate webhook requests -const secret = await client.rotateConsumerSecret(chainhookUuid).secret; +const secret = await client.rotateConsumerSecret().secret; ``` ### Example Fastify server diff --git a/content/docs/es/resources/archive/stacks-api.mdx b/content/docs/es/resources/archive/stacks-api.mdx index 83b12bf2d..2e34e09ee 100644 --- a/content/docs/es/resources/archive/stacks-api.mdx +++ b/content/docs/es/resources/archive/stacks-api.mdx @@ -1,94 +1,102 @@ --- -title: Usar el archivo de la API de la cadena de bloques de Stacks -description: Descubre cómo utilizar el Hiro Archive para poner en marcha una API de Stacks Blockchain. +title: Usar el archivo de la API de Blockchain de Stacks +description: Descubre cómo usar el Hiro Archive para configurar una API de Stacks Blockchain. --- -## Requisitos previos +## Prerrequisitos -Dado que la API de Stacks Blockchain depende de que un nodo de la cadena de bloques Stacks esté a la misma altura de bloque, primero deberá [restaurar un nodo de blockchain de Stacks utilizando el Archivo Hiro](/resources/archive/stacks-blockchain) antes de restaurar la API de Stacks Blockchain. De lo contrario, puede encontrar errores al ejecutar la API. +Dado que la API de Stacks Blockchain depende de que un nodo de blockchain de Stacks esté en la misma altura de bloque, primero necesitarás [restaurar un nodo de blockchain de Stacks usando el Archivo de Hiro](/resources/archive/stacks-blockchain) antes de restaurar la API de Stacks Blockchain. De lo contrario, es posible que encuentres errores al ejecutar la API. -Para que los archivos de la cadena de bloques Stacks y la API de la cadena de bloques Stacks sean compatibles, deben cumplir los siguientes criterios: +Para que la blockchain de Stacks y los archivos de la API de Stacks Blockchain sean compatibles, deben cumplir con los siguientes criterios: * Ambos archivos corresponden a la misma red de Stacks (mainnet/testnet). -* La versión del archivo API debe ser compatible con la versión del archivo de la cadena de bloques Stacks (Ver [Notas de la versión de la API](https://github.com/hirosystems/stacks-blockchain-api/releases) para orientación). +* La versión del archivo de la API debe ser compatible con la versión del archivo de la blockchain de Stacks (Ver [Notas de lanzamiento de la API](https://github.com/hirosystems/stacks-blockchain-api/releases) para orientación). * Ambos archivos fueron creados en la misma fecha. ## Métodos de restauración -Hay dos formas de restaurar una API de Stacks Blockchain utilizando el Archivo Hiro. El archivo que necesitará descargar dependerá de su método de restauración. No existe ningún escenario en el que necesite ambos métodos de restauración. +Hay dos formas de restaurar una API de Stacks Blockchain usando el Archivo Hiro. El archivo de archivo que necesitarás descargar dependerá de tu método de restauración. No hay ningún escenario en el que necesitarías ambos métodos de restauración. -**Restaurar mediante volcado de base de datos Postgres (Recomendado)** +**Restaurar a través del volcado de la base de datos Postgres (Recomendado)** -Este es el método más rápido y directo, y es adecuado para la mayoría de los escenarios. Consiste en una copia de seguridad de la base de datos Postgres de la API tomada utilizando `pg_dump`Por lo general, recomendamos comenzar con este método antes de intentar el método siguiente si este no funciona por alguna razón. +Este es el método más rápido y directo, y es adecuado para la mayoría de escenarios. Consiste en una copia de seguridad de la base de datos Postgres de la API tomada usando `pg_dump`. Generalmente recomendamos comenzar con este método antes de intentar el método siguiente si este no funciona por alguna razón. + +:::callout +type: info + +### Esquema de Postgres + +Necesitarás configurar la API `PG_SCHEMA` variable de entorno a: `PG_SCHEMA=stacks_blockchain_api` al restaurar desde un archivo. +::: **Restaurar mediante archivo de valores separados por tabulaciones (TSV)** -Este método es varias veces más lento que la restauración desde un volcado de Postgres. El archivo TSV de la API contiene los eventos sin procesar en bruto de un nodo de la cadena de bloques de Stacks. La API puede ingerir este archivo para procesar eventos en una base de datos Postgres. -La restauración desde un archivo TSV puede ser útil cuando no está disponible un archivo de base de datos Postgres para una versión particular de la API o cuando no se puede utilizar por cualquier motivo. +Este método es varias veces más lento que restaurar desde un volcado de Postgres. El archivo TSV de la API contiene los eventos en bruto no procesados de un nodo de blockchain de Stacks. La API puede ingerir este archivo para procesar eventos en una base de datos Postgres. +Restaurar desde un archivo TSV puede ser útil cuando un archivo de base de datos Postgres para una versión particular de la API no está disponible o cuando no se puede usar por alguna razón. ## Dónde descargar archivos -Dependiendo del método de restauración utilizado anteriormente, los archivos del Stacks Blockchain API para cada red se pueden encontrar en las siguientes ubicaciones: +Dependiendo del método de restauración utilizado anteriormente, los archivos de la API de Blockchain de Stacks para cada red se pueden encontrar en las siguientes ubicaciones: * Volcado de base de datos Postgres * mainnet: https://archive.hiro.so/mainnet/stacks-blockchain-api-pg/ * testnet: https://archive.hiro.so/testnet/stacks-blockchain-api-pg/ -* Archivo TSV +* archivo TSV * mainnet: https://archive.hiro.so/mainnet/stacks-blockchain-api/ * testnet: https://archive.hiro.so/testnet/stacks-blockchain-api/ -Los patrones de nombres de archivo son los siguientes: +Los patrones de nombres de archivos son los siguientes: * Volcado de base de datos Postgres * archivo: `stacks-blockchain-api-pg---.dump` * shasum: `stacks-blockchain-api-pg---.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api--.gz` * shasum: `-stacks-blockchain-api--.sha256` -Existe un archivo y un shasum que se actualizan continuamente y siempre apuntan a la carga más reciente: +Hay un archivo continuamente actualizado y shasum que siempre apunta a la carga más reciente: * Volcado de base de datos Postgres - * archivo: `stacks-blockchain-api-pg--latest.dump` + * archive: `stacks-blockchain-api-pg--latest.dump` * shasum: `stacks-blockchain-api-pg--latest.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api-latest.gz` * shasum: `-stacks-blockchain-api-latest.sha256` -o la carga más reciente para una versión en particular: +o la subida más reciente para una versión particular: * Volcado de base de datos Postgres * archivo: `stacks-blockchain-api-pg---latest.dump` * shasum: `stacks-blockchain-api-pg---latest.sha256` -* Archivo TSV +* archivo TSV * archivo: `-stacks-blockchain-api--latest.gz` * shasum: `-stacks-blockchain-api--latest.sha256` -## Restaurando la API de la cadena de bloques de Stacks utilizando el archivo de Hiro +## Restaurando la API de Blockchain de Stacks usando el Archivo de Hiro -**Si se restaura mediante un volcado de Postgres** +**Si se restaura mediante volcado de Postgres** -1. Descargue el archivo y el shasum para la red y el método de restauración apropiados. -2. Verifique el archivo usando los pasos en el [descargar guía](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). -3. Importe el archivo de archivo en una base de datos Postgres en ejecución (puede tardar hasta una hora dependiendo de las especificaciones y la configuración de la base de datos): +1. Descarga el archivo y el shasum para la red apropiada y el método de restauración. +2. Verifique el archivo usando los pasos en el [guía de descarga](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). +3. Importa el archivo de archivo en una base de datos Postgres en ejecución (puede tomar hasta una hora dependiendo de las especificaciones y configuración de la base de datos): ```terminal $ export PGPASSWORD= $ pg_restore --username postgres --verbose --jobs 4 --dbname stacks_blockchain_api /path/to/archive/file ``` -4. Inicie el servicio de API de Stacks Blockchain. -5. Verifique que el conjunto de datos se esté utilizando comparando sus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [De Hiro](https://api.hiro.so/extended/v1/status)Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. - 1. Es posible que el nodo local tarde unos minutos en responder en este punto final. - 2. Es posible que la altura de su bloque esté hasta unos cientos de bloques alejada de la de Hiro, dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. +4. Inicia el servicio API de Stacks Blockchain. +5. Verificar que el conjunto de datos esté siendo utilizado comparando tus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [Hiro's](https://api.hiro.so/extended/v1/status). Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. + 1. Puede tomar unos minutos para que el nodo local responda en este endpoint. + 2. La altura de tu bloque puede estar hasta unos pocos cientos de bloques alejada de la de Hiro dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. -**Si se restaura mediante archivo TSV** +**Si se restaura a través de archivo TSV** -1. Descargue el archivo y el shasum para la red y el método de restauración apropiados. -2. Verifique el archivo usando los pasos en el [descargar guía](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). -3. Extraiga el archivo en el directorio deseado: +1. Descarga el archivo y shasum para la red apropiada y el método de restauración. +2. Verifica el archivo usando los pasos en el [guía de descarga](/resources/archive/download-guide#verification-and-extraction) (note: API archives may not have SHA256 files available). +3. Extrae el archivo en el directorio deseado: ```terminal $ gzip -d --stdout > /path/to/extracted/file ``` -4. [Siga estas instrucciones](https://github.com/hirosystems/stacks-blockchain-api#export-and-import) para procesar e importar los eventos del archivo TSV en su base de datos Postgres. -5. Inicie el servicio de API de Stacks Blockchain. -6. Verifique que el conjunto de datos se esté utilizando comparando sus nodos [altura del bloque local](http://localhost:3999/extended/v1/status) con [De Hiro](https://api.hiro.so/extended/v1/status)Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. - 1. Es posible que el nodo local tarde unos minutos en responder en este punto final. - 2. Es posible que la altura de su bloque esté hasta unos cientos de bloques alejada de la de Hiro, dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. +4. [Sigue estas instrucciones](https://github.com/hirosystems/stacks-blockchain-api#export-and-import) para procesar e importar los eventos en el archivo TSV a tu base de datos Postgres. +5. Inicia el servicio de API de Stacks Blockchain. +6. Verificar que el conjunto de datos está siendo utilizado comparando sus nodos [altura de bloque local](http://localhost:3999/extended/v1/status) con [Hiro's](https://api.hiro.so/extended/v1/status). Si la altura del bloque coincide o está cerca de la altura del bloque de Hiro, la restauración fue exitosa. + 1. Puede tomar unos minutos para que el nodo local responda en este endpoint. + 2. La altura de tu bloque puede estar hasta unos cientos de bloques alejada de la de Hiro dependiendo de la antigüedad del archivo. Debería ponerse al día relativamente rápido. diff --git a/content/docs/es/tools/chainhooks/(chainhook-sdk)/secrets.mdx b/content/docs/es/tools/chainhooks/(chainhook-sdk)/secrets.mdx index 5b181ac36..2757e62fd 100644 --- a/content/docs/es/tools/chainhooks/(chainhook-sdk)/secrets.mdx +++ b/content/docs/es/tools/chainhooks/(chainhook-sdk)/secrets.mdx @@ -6,22 +6,22 @@ description: Rotar secretos de consumidor y validar cada entrega de Chainhooks :::objectives * Crear/rotar un secreto de consumidor de Chainhooks. -* Valida las solicitudes de webhook verificando la `Authorization` encabezado. +* Valida las solicitudes de webhook verificando el `Authorization` cabecera. ::: ## Requisitos previos :::prerequisites -* Clave de API de Hiro -* Node.js (el ejemplo del servidor utiliza Fastify). +* Clave API de Hiro +* Node.js (el ejemplo del servidor usa Fastify). ::: -## Validación de solicitudes de webhook con un secreto del consumidor +## Validando solicitudes de webhook con un secreto de consumidor -Cuando creas un secreto, nuestro servicio Chainhooks adjunta un `Authorization: Bearer ` encabezado a cada intento de webhook, proporcionándote un simple handshake de secreto compartido. Así es como empezar: +Cuando creas un secreto, nuestro servicio Chainhooks adjunta un `Authorization: Bearer ` encabezado a cada intento de webhook, proporcionándote un simple apretón de manos de secreto compartido. Así es como empezar: -1. Rotar el secreto con `rotateConsumerSecret` (o el `/chainhooks/{uuid}/secret` API) cada vez que necesites inicializar o crear un nuevo token. -2. Rechazar entregas de webhook cuyas `Authorization` el encabezado no es igual `Bearer `. +1. Rota el secreto con `rotateConsumerSecret` (o el `/chainhooks/{uuid}/secret` API) siempre que necesites inicializar o crear un nuevo token. +2. Rechazar entregas de webhook cuyas `Authorization` header no es igual `Bearer `. ### Crear/rotar secreto del consumidor @@ -34,10 +34,10 @@ const client = new ChainhooksClient({ }); // Store this value securely and use it to validate webhook requests -const secret = await client.rotateConsumerSecret(chainhookUuid).secret; +const secret = await client.rotateConsumerSecret().secret; ``` -### Servidor Fastify de ejemplo +### Ejemplo de servidor Fastify ```ts server.ts -n server.post('/webhook', async (request, reply) => { diff --git a/content/docs/es/tools/chainhooks/index.mdx b/content/docs/es/tools/chainhooks/index.mdx index 1b173ce68..de8d1bb59 100644 --- a/content/docs/es/tools/chainhooks/index.mdx +++ b/content/docs/es/tools/chainhooks/index.mdx @@ -3,35 +3,36 @@ title: Chainhooks sidebarTitle: Descripción general description: Chainhooks es un servicio de webhook para la blockchain de Stacks que te permite registrar flujos de eventos y definir filtros precisos para capturar datos en cadena mientras ocurren. llm: false +isBeta: true --- :::callout type: warn ### Chainhooks 2.0 (Beta) -Chainhooks está actualmente en beta. Si encuentras problemas o tienes comentarios, por favor contacta con [beta@hiro.so](mailto\:beta@hiro.so). +Chainhooks está actualmente en beta. Si encuentras problemas o tienes comentarios, por favor ponte en contacto con [beta@hiro.so](mailto\:beta@hiro.so). ::: -## Resumen +## Visión general -Chainhooks facilita la suscripción a la actividad de blockchain en Stacks registrando flujos de eventos, filtrando exactamente los datos que te interesan, y enviándolos directamente a tu aplicación en tiempo real. +Chainhooks facilita la suscripción a la actividad de blockchain en Stacks mediante el registro de flujos de eventos, filtrando exactamente los datos que te interesan y enviándolos directamente a tu aplicación en tiempo real. Con Chainhooks 2.0 (Beta), puedes gestionar chainhooks a través de: -* **[SDK de Chainhooks](/tools/chainhooks/introduction)** - Cliente TypeScript/JavaScript para gestión programática -* **[Plataforma Hiro](https://platform.hiro.so)** - Interfaz de usuario web para la creación visual de chainhooks +* **[Chainhooks SDK](/tools/chainhooks/introduction)** - Cliente TypeScript/JavaScript para gestión programática +* **[Plataforma Hiro](https://platform.hiro.so)** - Interfaz de usuario basada en web para la creación visual de chainhook * **[API de Chainhooks](/apis/chainhooks-api)** - Direct REST API access -## Características Clave +## Características Principales -* **Indexación consciente de reorganización** - Maneja automáticamente las bifurcaciones y reorganizaciones de blockchain +* **Indexación consciente de reorganización** - Maneja automáticamente bifurcaciones y reorganizaciones de blockchain * **Filtrado de eventos** - Define lógica personalizada para activar acciones en eventos específicos de blockchain * **Evaluación histórica** - Probar chainhooks contra bloques pasados para indexación o depuración -## Próximos pasos +## Siguientes pasos :::next-steps -* [Introducción del SDK](/tools/chainhooks/introduction): Comienza con el SDK de Chainhooks +* [Introducción del SDK](/tools/chainhooks/introduction): Comience con el SDK de Chainhooks * [Guía de migración](/tools/chainhooks/migration): Guía de migración para actualizar a Chainhooks 2.0 (Beta) ::: @@ -40,5 +41,5 @@ type: help ### ¿Necesitas ayuda con Chainhooks? -Contáctanos en el #chainhook canal encendido [Discord](https://stacks.chat/) bajo la sección Hiro Developer Tools. +Ponte en contacto con nosotros en el #chainhook canal encendido [Discord](https://stacks.chat/) bajo la sección de Herramientas para Desarrolladores de Hiro. ::: diff --git a/idioma.lock b/idioma.lock index 39b4aff84..7ab97a497 100644 --- a/idioma.lock +++ b/idioma.lock @@ -77,7 +77,7 @@ files: translations: es: true content/docs/en/resources/archive/stacks-api.mdx: - content: e6d8c822db7123a05d4673d4d560fdce + content: 2c7621f4c633e56a189da951687de5ae translations: es: true content/docs/en/resources/archive/index.mdx: @@ -1173,7 +1173,7 @@ files: translations: es: true content/docs/en/tools/chainhooks/index.mdx: - content: 0057c3bda3de7544372b73991277b040 + content: f86f0b9ddd9e124908a23f16884c721b translations: es: true content/docs/en/apis/chainhooks-api/usage.mdx: @@ -1317,7 +1317,7 @@ files: translations: es: true content/docs/en/tools/chainhooks/(chainhook-sdk)/secrets.mdx: - content: f62a2ccb038ddb3f174290c06adc719d + content: 507a79160002fbc80fa877eabf0a0f39 translations: es: true content/docs/en/apis/chainhooks-api/reference/secrets/get-secret.mdx: