Saltar al contenido

Referencia de configuración de Dingo v0.94.1

Esta página describe la configuración incluida en Dingo v0.94.1. La referencia completa de campos, descripciones, valores predeterminados, variables de entorno, opciones CLI, ajustes de proveedores y patrones de despliegue está en el archivo dingo.yaml.example de esa versión. También puedes consultarlo en el código de Dingo v0.94.1.

El ejemplo no contiene ajustes activos. Deja los valores comentados para utilizar los valores predeterminados de Dingo; descomenta un ajuste únicamente cuando quieras sustituir su valor predeterminado. No copies la configuración de otra versión sin revisar el ejemplo correspondiente, porque los campos y su comportamiento pueden cambiar.

Dingo busca cada ajuste primero en la línea de comandos, después en las variables de entorno, luego en el archivo YAML y finalmente en los valores predeterminados integrados. El ejemplo documenta las opciones CLI y variables de entorno junto a cada campo. Consulta Configuración del nodo y modos de almacenamiento para conocer las principales opciones de ejecución.

TxSubmissionLogicVersion pertenece al archivo de configuración del nodo Cardano. No es un ajuste nativo de Dingo y no tiene una opción CLI ni una variable de entorno equivalente.

ConfiguraciónClave del archivo CardanoOpción CLI de DingoVariable de entorno de DingoValor predeterminado y comportamiento
Estrategia de envío de transaccionesTxSubmissionLogicVersion——Cuando falta la clave, Dingo utiliza TxSubmissionLogicV1. Este es el único valor aceptado y corresponde a la estrategia heredada de recepción por par implementada por Dingo. Dingo rechaza TxSubmissionLogicV2 y cualquier valor desconocido durante la carga de la configuración.
Antelación mínima de oferta LeiosLeiosMinOfferLead——Clave del archivo de configuración del nodo Cardano. Indica cuántos slots debe estar un bloque endorser por encima de la punta inmutable para que Dingo lo ofrezca a un par. Dingo utiliza 3600 slots cuando la clave está ausente.

El archivo de configuración del nodo Cardano admite tanto el formato plano existente como el formato envolvente con Version: 2. En el formato envolvente, Version debe ser el entero 2 y Configuration debe ser un objeto. Un ejemplo compacto es:

Version: 2
Configuration:
Protocol:
ByronGenesisFile: byron-genesis.json
ShelleyGenesisFile: shelley-genesis.json
Testing:
DijkstraGenesisFile: dijkstra-genesis.json
Consensus:
ConsensusMode: GenesisMode
Network:
DeadlineTargetNumberOfRootPeers: 7
DeadlineTargetNumberOfKnownPeers: 80
DeadlineTargetNumberOfEstablishedPeers: 30
DeadlineTargetNumberOfActivePeers: 15

Dingo asigna las secciones Protocol, Testing, Consensus y Network a los campos existentes de configuración del nodo. Protocol contiene la configuración de los archivos y hashes de génesis; Testing contiene la configuración de génesis de Dijkstra y las anulaciones de épocas de bifurcación; Consensus contiene ConsensusMode; y Network contiene los ajustes de red, incluido PeerSharing y los objetivos de pares. En Network, Dingo asigna DeadlineTargetNumberOfRootPeers, DeadlineTargetNumberOfKnownPeers, DeadlineTargetNumberOfEstablishedPeers y DeadlineTargetNumberOfActivePeers respectivamente a TargetNumberOfRootPeers, TargetNumberOfKnownPeers, TargetNumberOfEstablishedPeers y TargetNumberOfActivePeers.

Dingo rechaza los datos del formato envolvente si falta Version o Configuration, si Version no es el entero 2, si Configuration o una sección admitida no es un objeto, o si el archivo usa una versión no admitida. Dingo también rechaza cualquier clave duplicada, incluidas las que aparecen en distintas secciones o las que establecen el mismo campo efectivo, como un objetivo TargetNumberOf*Peers y su alias DeadlineTargetNumberOf*Peers. Dentro del formato envolvente, Dingo aplica igualmente la validación de TxSubmissionLogicVersion: solo acepta TxSubmissionLogicV1 y rechaza los valores no válidos, incluido TxSubmissionLogicV2, durante la carga.

ZonaAjustes principalesPropósito
Redes y rutasnetwork, networkMagic, cardanoConfig, topology, databasePath, socketPath, socketModeSelecciona una red Cardano y las rutas de configuración del nodo, topología y datos.
Servicios y diagnósticosbindAddr, privateBindAddr, relayPort, privatePort, metricsBindAddr, metricsAuthToken, metricsPort, healthPort, debugPort, debugBindAddr, debugMutexProfileFraction, debugBlockProfileRate, tracing, tracingEndpoint, tracingServiceName, tracingSampleRatio, tracingAlwaysSamplePools, localStateQueryViewMaxLifetimeConfigura los servicios públicos y privados, métricas, sondas de estado, perfiles, trazas y duración de instantáneas LocalStateQuery.
Registro y TLSlogging, tlsCertFilePath, tlsKeyFilePath, api.tlsSelecciona la salida de registros y protege los servicios compatibles de API o Bark.
Almacenamiento y APIstorageMode, plugins.storage, plugins.mempool, plugins.api, corsAllowedOriginsElige el historial almacenado, proveedores de almacenamiento, orden de transacciones y API de aplicaciones.
Consenso y selección de pluginsplugins.consensusSeleccione el proveedor de consenso utilizado por el nodo.
Arranque y sincronizaciónmithril, mithril.downloadMaxBytes, mithril.server, mithril.server.aggregator, genesisBootstrap, genesisBootstrap.corroborationPeers, genesisBootstrap.controlGroups, genesisBootstrap.chainSyncJumping, intersectTip, immutableDbPath, chainsync, validateHistorical, strictUtxoValidationConfigura el arranque desde instantáneas o génesis, la sincronización y la validación histórica.
Gestión de los parestargetNumberOfKnownPeers, targetNumberOfEstablishedPeers, targetNumberOfActivePeers, targetNumberOfRootPeers, activePeersTopologyQuota, activePeersGossipQuota, activePeersLedgerQuota, inboundWarmTarget, inboundHotQuota, inboundMinTenure, inboundHotScoreThreshold, inboundPruneAfter, inboundDuplexOnlyForHot, inboundCooldownEstablece objetivos de pares, cuotas de origen y políticas de pares entrantes.
Producción de bloques y reglas del ledgerblockProducer, blockProducerPools, shelley*, forge*, validateForgedBlock, minPoolMargin, pledgeLeverage*, fullPotRewards*, delegatorInactivity*, ledgerApplyRowBatchingEnabled, ledgerPrefetchAheadEnabled, ledgerValidateAheadEnabledConfigura claves de forjado, umbrales de seguridad y comportamientos opcionales del ledger.
Archivo y ciclo de vida de bases de datosbark*, historyExpiry, databaseLifecycleSirve o consume datos de archivo, hace caducar el historial local y gestiona instantáneas.
Índices opcionales y diagnósticosmidnight, midnight.authTokenPolicyId, midnight.authTokenAssetName, tokenRegistry, tokenRegistry.manifestUrl, tokenRegistry.trustedManifestKey, tokenRegistry.allowRollback, koiosParity, cache, skipRewardLiveStakeBackfillCheckConfigura índices opcionales, actualizaciones autenticadas del registro, diagnósticos de paridad, caché y validación de inicio.
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Proveedor de consensoplugins.consensus.provider--consensusDINGO_PLUGINS_CONSENSUS_PROVIDERpraos de forma predeterminada. tachys también es válido para redes compatibles. Selecciona el proveedor para validar cabeceras, comparar cadenas y programar líderes.

Dingo registra en el directorio de datos la identidad de base de datos del proveedor seleccionado. Si la identidad almacenada difiere de la del proveedor seleccionado, rechaza el inicio. tachys rechaza el arranque si se activa el bootstrap de Genesis o Mithril, el modo Leios, el inicio o la transición Dijkstra, si falta la configuración de génesis de Shelley, si las épocas de Shelley a Babbage no son cero o si activeSlotsCoeff no es 1/1.

Praos es el proveedor predeterminado. Por compatibilidad con las bases de datos Praos existentes, una base de datos no vacía y sin identificar se acepta cuando la identidad seleccionada es praos/v1, y Dingo registra esa identidad si la comprobación tiene éxito. Con cualquier otra identidad seleccionada, rechaza una base de datos no vacía y sin identificar; seleccionar Tachys para una base de datos identificada como Praos también falla. Una base de datos vacía puede adoptar la identidad del proveedor seleccionado antes de importar datos de la cadena.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Capacidad del mempoolplugins.mempool.config.capacity——1 MiB en los modos estándar y Praos. 25 MiB cuando el modo es Leios o la red es Musashi por nombre o por magic, incluso en serve. Un valor explícito prevalece sobre ambos valores predeterminados.
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Agrupación de filas del ledgerledgerApplyRowBatchingEnabled--ledger-apply-row-batching-enabledDINGO_LEDGER_APPLY_ROW_BATCHING_ENABLEDfalse, desactivado. En modo core, agrupa varias filas de los deltas de bloques sin validar que lo permiten. Se transmite a serve y dingo load; el modo API ya utiliza agrupación. No afecta al consenso.
Lectura anticipada del ledgerledgerPrefetchAheadEnabled--ledger-prefetch-ahead-enabledDINGO_LEDGER_PREFETCH_AHEAD_ENABLEDtrue, activado. Para bloques validados, lee por adelantado los UTxO de entrada del siguiente bloque desde una transacción de solo lectura mientras se aplica el actual. Desactivarlo también desactiva la validación anticipada. No afecta al consenso.
Validación anticipada del ledgerledgerValidateAheadEnabled--ledger-validate-ahead-enabledDINGO_LEDGER_VALIDATE_AHEAD_ENABLEDtrue, activado. Verifica las firmas de testigos de bloques validados antes de aplicarlos. Requiere ledgerPrefetchAheadEnabled; desactivar la lectura anticipada también desactiva esta validación. No afecta al consenso.
Umbral bajo de BlockfetchblockfetchLowWatermarkEnabled--blockfetch-low-watermark-enabledDINGO_BLOCKFETCH_LOW_WATERMARK_ENABLEDfalse, desactivado. Si la cabecera está lejos de la punta del par, inicia blockfetch tras encolar un rango de cabeceras en lugar de esperar a cuatro. No cambia la capacidad de la cola ni afecta al consenso.
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Dirección de escucha de métricasmetricsBindAddr--metrics-bind-addrDINGO_METRICS_BIND_ADDR127.0.0.1. Es independiente de bindAddr y utiliza loopback de forma predeterminada. Establece explícitamente una dirección comodín o accesible remotamente si el recopilador está fuera del contenedor o del host.
Token de autenticación de métricasmetricsAuthToken—DINGO_METRICS_AUTH_TOKENEntrada heredada que Dingo ignora y que no tiene efecto. Los extremos de métricas aceptan solicitudes anónimas y no requieren token, Authorization: Bearer ni TLS.
Puerto de métricasmetricsPort--metrics-port—12798 de forma predeterminada. 0 desactiva el servicio Prometheus.

El servicio de métricas utiliza HTTP sin cifrar. Dingo aplica controles de red cuando el tráfico atraviesa una red que no sea de confianza.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Fracción de muestreo de mutexdebugMutexProfileFraction--debug-mutex-profile-fractionDINGO_DEBUG_MUTEX_PROFILE_FRACTION0, desactivada. Muestrea, en promedio, un evento de contención de mutex de cada N para el perfil pprof de mutex.
Tasa de perfilado de bloqueosdebugBlockProfileRate--debug-block-profile-rateDINGO_DEBUG_BLOCK_PROFILE_RATE0, desactivada. Muestrea un evento de bloqueo por cada N nanosegundos bloqueado; 1 registra todos los eventos.

Dingo solo activa ambos muestreos cuando debugPort es distinto de cero. Dingo ignora una tasa configurada sin un puerto de depuración activo y muestra una advertencia.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Endpoint del recopiladortracingEndpoint--tracing-endpointDINGO_TRACING_ENDPOINTVacío de forma predeterminada. Establece la URL de un recopilador OTLP HTTP para activar las trazas. Si está vacío, tracing controla su activación y las variables estándar OTEL_EXPORTER_OTLP_* seleccionan el destino.
Nombre del servicio de trazastracingServiceName--tracing-service-nameDINGO_TRACING_SERVICE_NAME, OTEL_SERVICE_NAMEDingo utiliza primero tracingServiceName cuando se configura de forma explícita, después OTEL_SERVICE_NAME y finalmente dingo. Define el nombre del servicio de la telemetría exportada.
Proporción de muestreotracingSampleRatio--tracing-sample-ratioDINGO_TRACING_SAMPLE_RATIO1 de forma predeterminada. Admite valores de 0 a 1, ambos incluidos. La validación rechaza los valores fuera de ese intervalo.
Pools que Dingo siempre muestreatracingAlwaysSamplePools--tracing-always-sample-poolsDINGO_TRACING_ALWAYS_SAMPLE_POOLSLista vacía de forma predeterminada. Acepta identificadores de pool en Bech32, incluido Bech32 en mayúsculas, o hashes de clave hexadecimales de 56 caracteres. Dingo muestrea los bloques de los pools enumerados independientemente de tracingSampleRatio.
Atributos de recurso de OpenTelemetry——OTEL_RESOURCE_ATTRIBUTESDingo aplica a la telemetría exportada los atributos que puede analizar. Dingo avisa sobre las entradas que no puede analizar sin hacer fallar el inicio.
Exportador de registros OpenTelemetry——OTEL_LOGS_EXPORTERActiva la exportación OTLP opcional de registros. Un valor vacío o none la desactiva. Dingo avisa sobre una configuración de exportador no válida en lugar de hacer fallar el inicio y mantiene disponibles los registros de salida estándar.
Exportador de métricas OpenTelemetry——OTEL_METRICS_EXPORTERActiva la exportación OTLP opcional de las métricas del registro Prometheus. Un valor vacío o none la desactiva. Dingo avisa sobre una configuración de exportador no válida en lugar de hacer fallar el inicio; la exportación no altera el extremo Prometheus /metrics.
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y validación
Modo de permisos del socket CardanosocketMode--socket-modeCARDANO_SOCKET_MODE0600. Introduce un modo octal para el socket Unix del nodo.

Dingo aplica a socketMode y dmq.socketMode un valor predeterminado de 0600 independiente de umask. En Unix, Dingo rechaza los modos que permiten escritura a otros usuarios. El directorio padre de cada socket debe pertenecer al usuario actual o a root. Dingo acepta la escritura del grupo o de otros usuarios únicamente cuando el directorio tiene el sticky bit; rechaza un directorio padre escribible sin ese bit. Para corregirlo, ejecuta chmod +t o elimina el permiso de escritura del grupo y de otros usuarios.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminadoValidación y comportamiento
Activacióndmq.enabled--dmq-enabledDINGO_DMQ_ENABLEDfalseValor booleano; false desactiva la función.
Temadmq.topic--dmq-topicDINGO_DMQ_TOPICmithrilSi está activado, Dingo exige mithril; ningún otro valor es válido.
Identificador de reddmq.networkMagic--dmq-network-magicDINGO_DMQ_NETWORK_MAGICDerivado del tema y la red Cardano si no se establece.Si se omite, se deriva del tema y de la red Cardano. Un valor explícito lo sustituye. Debe configurarse si la red no tiene un valor predeterminado para el tema.
Ruta del socketdmq.socketPath--dmq-socket-pathDINGO_DMQ_SOCKET_PATHdingo-dmq.socketSi está activado, exige un valor no vacío y distinto de socketPath de Cardano.
TTL de los mensajesdmq.messageTtl--dmq-message-ttlDINGO_DMQ_MESSAGE_TTL1800 segundosSi está activado, exige un valor positivo no mayor que 9223372036 segundos.
Tamaño máximo del mempooldmq.maxMempoolSize--dmq-max-mempool-sizeDINGO_DMQ_MAX_MEMPOOL_SIZE128 MBSi está activado, exige un valor positivo no mayor que 8796093022207 MB.
Puerto de pares N2Ndmq.n2nPort--dmq-n2n-portDINGO_DMQ_N2N_PORT00 desactiva el puerto N2N. Un puerto distinto de cero activa la escucha entre nodos DMQ y la gestión de pares cuando dmq.maxPeers también es distinto de cero.
Dirección IPv4 de escuchadmq.listenAddress--dmq-listen-addressDINGO_DMQ_LISTEN_ADDRESS0.0.0.0Si dmq.n2nPort no es cero y se configura este campo, exige un literal IPv4.
Dirección IPv6 de escuchadmq.listenIpv6Address--dmq-listen-ipv6-addressDINGO_DMQ_LISTEN_IPV6_ADDRESS::Si dmq.n2nPort no es cero y se configura este campo, exige un literal IPv6.
Modo de permisos del socket DMQdmq.socketMode--dmq-socket-modeDINGO_DMQ_SOCKET_MODE0600Introduce un modo octal para el socket DMQ.
Archivo de topología DMQdmq.topologyFile--dmq-topology-fileDINGO_DMQ_TOPOLOGY_FILESin configurarSi se configura, la ruta no puede incluir recorridos .. y debe identificar un archivo regular existente. Dingo lo carga y valida antes de abrir el socket DMQ.
Mínimo de pares DMQdmq.minPeers--dmq-min-peersDINGO_DMQ_MIN_PEERS3Exige dmq.minPeers <= dmq.maxPeers; 0 permite no requerir pares. Solo las conexiones salientes cuentan para cumplir este mínimo; las conexiones entrantes no lo satisfacen.
Máximo de pares DMQdmq.maxPeers--dmq-max-peersDINGO_DMQ_MAX_PEERS10Exige dmq.minPeers <= dmq.maxPeers; 0 no permite pares cuando minPeers también es 0. Limita el total de conexiones y reserva espacio para las conexiones salientes según minPeers y la valencia total de las raíces locales.

Dingo valida estos seis ajustes de pares al iniciar DMQ. Con dmq.n2nPort: 0, omite la validación de las direcciones de escucha. Si dmq.n2nPort no es cero, cada dirección debe utilizar su versión IP correspondiente. Cuando dmq.n2nPort y dmq.maxPeers son distintos de cero, Dingo escucha en las direcciones configuradas y el gestor mantiene los pares dentro de dmq.minPeers y dmq.maxPeers. El archivo de topología configurado proporciona pares al gestor, que intenta primero las raíces locales y después las raíces públicas. El tema activado también puede descubrir pares relay del ledger mediante registros SRV de DNS asociados al prefijo del tema.

La pila DMQ cuenta únicamente las conexiones salientes para alcanzar dmq.minPeers; las conexiones entrantes no satisfacen ese mínimo. Para admitir conexiones entrantes, la pila reserva el mayor valor entre dmq.minPeers y la valencia total de las raíces locales, sin superar dmq.maxPeers. La pila calcula internamente el límite de conexiones entrantes como la capacidad restante de dmq.maxPeers; Dingo no expone ese límite como un parámetro YAML, una opción CLI ni una variable de entorno. Cuando la reserva saliente alcanza dmq.maxPeers, la pila rechaza las nuevas conexiones entrantes.

Cuando se configura dmq.topologyFile, Dingo aplica estas reglas antes de abrir el socket DMQ:

  • El archivo debe ser un objeto JSON de un máximo de 10 MiB. Dingo rechaza el JSON mal formado, JSON null y las claves de objeto que solo difieran en mayúsculas y minúsculas.
  • Cada punto de acceso de localRoots o publicRoots debe tener un host no vacío y un puerto entre 1 y 65535. Dingo elimina los espacios alrededor del host y los corchetes IPv6.
  • Una raíz utiliza valency, o hotValency como alias si falta valency. Si aparecen ambas, valency tiene prioridad. warmValency utiliza el mismo valor que valency de forma predeterminada y debe ser mayor o igual. La valencia puede superar el número de puntos de acceso.
  • Dingo cuenta una vez cada combinación distinta de host y puerto. La comparación de nombres ignora mayúsculas, minúsculas y el punto final. Normaliza los literales IP sin resolver los nombres de host.
  • Cuando bootstrapPeers o peerSnapshotFile contienen un valor, Dingo advierte y descarta ambos campos. También ignora useLedgerAfterSlot.

Dingo registra el número de pares distintos tras cargar el archivo y advierte si no contiene ninguno. Una topología no válida hace fallar el inicio antes de abrir el socket DMQ.

El ajuste immutableDbPath y el argumento posicional de dingo load aceptan un directorio local o una URL remota. Los orígenes remotos requieren https://; http:// solo funciona con hosts de loopback. Dingo rechaza los destinos HTTPS privados o de uso especial en la URL inicial, tras cada redirección y en cada resolución DNS al conectarse. Las importaciones remotas ignoran los ajustes de proxy HTTP del entorno. Las raíces remotas deben proporcionar tip.json y tríadas numeradas de archivos .chunk, .primary y .secondary; se rechazan los datos publicados incompletos o con formato incorrecto. Dingo calcula límites agregados de transferencia, caché, datos temporales, espacio libre reservado y concurrencia según el rango de fragmentos solicitado. Si se supera un límite o falta espacio libre, la importación falla con un error y se eliminan los archivos temporales. Si la reproducción de confianza o el procesamiento fallan después de copiar bloques inmutables más allá de la punta aplicada del ledger, Dingo retrocede los bloques sin aplicar hasta esa punta antes de devolver el error original. La limpieza no deja bloques sin aplicar por delante del ledger. Si el backend rechaza el retroceso, se devuelven ambos errores y la base de datos requiere recuperación antes de otra carga. Consulta la guía de arranque y mantenimiento de datos para los requisitos de origen remoto, fragmentos e integridad.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Pares de corroboracióngenesisBootstrap.corroborationPeers--genesis-bootstrap-corroboration-peersDINGO_GENESIS_BOOTSTRAP_CORROBORATION_PEERS0 de forma predeterminada. El valor predeterminado desactiva la barrera de corroboración. El operador debe configurar un valor positivo explícito cuando necesite exigir pares de corroboración antes de permitir que una fuente rápida impulse la selección Genesis.
Grupos de control de GenesisgenesisBootstrap.controlGroups——Dingo ya no proporciona grupos de control específicos de red de forma implícita. Los operadores deben configurar este campo explícitamente cuando necesiten un conjunto fijo de grupos de control.
ChainSync Jumping de GenesisgenesisBootstrap.chainSyncJumping--genesis-csjDINGO_GENESIS_CSJtrue, activado. Controla ChainSync Jumping mientras la selección Genesis está activa.

En Musashi, una configuración Cardano con ConsensusMode: PraosMode desactiva la selección de cadena Genesis aunque genesisBootstrap esté activado y el nodo comience desde el origen sin punto de intersección. Dingo sigue la configuración Cardano en lugar de aplicar selección por densidad, corroboración o paciencia de Genesis.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Validación históricavalidateHistorical--validate-historicalCARDANO_VALIDATE_HISTORICALtrue de forma predeterminada. false omite la validación histórica completa, pero Dingo mantiene las comprobaciones del sobre de entrada y del contador del certificado operativo para bloques históricos recibidos de pares no confiables. Solo el replay confiable y el historial certificado por Mithril omiten esas comprobaciones.

Configura explícitamente el host cuando el proveedor deba aceptar conexiones UTxO RPC desde otro host o interfaz.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Hostplugins.api.utxorpc.config.host——127.0.0.1 de forma predeterminada. El acceso remoto o desde fuera de loopback requiere un host explícito.

El proveedor integrado de Blockfrost escucha en loopback de forma predeterminada. Las solicitudes de solo lectura no están sujetas a los límites de admisión de modificaciones.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y validación
Hostplugins.api.blockfrost.config.host——127.0.0.1 de forma predeterminada. Un valor explícitamente vacío utiliza el bindAddr raíz. Configura un host para exponer el proveedor en otra interfaz.
Token de autenticaciónplugins.api.blockfrost.config.authToken——Entrada heredada que Dingo ignora y que no tiene efecto; no es obligatoria. El envío y la evaluación de transacciones aceptan solicitudes anónimas.
Modificaciones concurrentes globalesplugins.api.blockfrost.config.maxConcurrentMutations——Sin configurar o con 0, no impone un límite. Un valor positivo activa el límite global para el envío y la evaluación de transacciones.
Modificaciones concurrentes por clienteplugins.api.blockfrost.config.maxConcurrentMutationsPerClient——Sin configurar o con 0, no impone un límite. Un valor positivo activa el límite por cliente. Un límite positivo por cliente puede coexistir con maxConcurrentMutations: 0; cuando el límite global es positivo, el límite por cliente no puede superarlo.

Dingo no exige TLS para el acceso de modificación de Blockfrost. Antes de leer el cuerpo, aplica los límites de modificaciones que tengan un valor positivo. Si se agota un límite configurado y activo, devuelve HTTP 429 con Retry-After: 1 sin leer el cuerpo.

El agente de usuario HTTP saliente compartido no tiene clave YAML ni opción CLI.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Agente de usuario HTTP compartido——DINGO_HTTP_USER_AGENTdingo/<version> (<GOOS>/<GOARCH>) de forma predeterminada. Dingo utiliza un valor válido de esta variable de entorno cuando se establece e ignora un valor no válido. Los ajustes de userAgent específicos de cada componente para metadatos fuera de la cadena y el registro de tokens tienen prioridad sobre este valor.

Duración de las instantáneas LocalStateQuery

Sección titulada «Duración de las instantáneas LocalStateQuery»
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminadoValidación y comportamiento
Duración máxima de una instantánea adquiridalocalStateQueryViewMaxLifetime--local-state-query-view-max-lifetimeDINGO_LOCAL_STATE_QUERY_VIEW_MAX_LIFETIME5mUsa una duración positiva, como 5m. La validación de configuración o de inicio rechaza los valores no válidos, cero o negativos. Al alcanzar el límite, Dingo cierra la instantánea retenida. La siguiente consulta la reabre en el punto adquirido y responde desde ella; las adquisiciones de punta utilizan sus puntas capturadas. Si un retroceso o la poda eliminan el punto adquirido, Dingo no puede reabrirla y cierra la conexión.
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Sincronización Mithril gestionadamithril.enabled--mithril-enabledDINGO_MITHRIL_ENABLEDfalse, desactivada. En serve con almacenamiento core puede sincronizar desde una punta certificada de Mithril v2 y recurrir a Ouroboros si falla. Los comandos manuales funcionan independientemente de este ajuste.
Limpieza después de cargar Mithrilmithril.cleanupAfterLoad--mithril-cleanup-after-loadDINGO_MITHRIL_CLEANUPtrue. Después de que Dingo confirma de forma duradera cada lote de bloques, retira los fragmentos extraídos anteriores y conserva como ancla el fragmento que contiene el bloque comprometido más reciente. Si la sincronización se interrumpe, Dingo reanuda desde el primer fragmento conservado mediante el marcador interno mithril_immutable_retired_below; este marcador solo sirve para reanudar y no requiere edición manual.
Backend de artefactos Mithrilmithril.backend--mithril-backendDINGO_MITHRIL_BACKENDv2; un valor vacío también selecciona v2. Dingo rechaza v1 y sus rutas CLI. El backend v2 utiliza artefactos incrementales de bases de datos Cardano y requiere estado auxiliar del ledger y resúmenes de inmutables verificados durante el arranque. La estructura v2 es la referencia autoritativa.
Resumen fijado de Mithrilmithril.pinnedDigest--mithril-pinned-digestDINGO_MITHRIL_PINNED_DIGESTVacío de forma predeterminada. Si se configura para un arranque nuevo, debe identificar un artefacto v2 de base de datos Cardano. Dingo rechaza las fijaciones y resúmenes de instantáneas v1.

Las importaciones de estados del ledger admiten Conway y las eras posteriores. Dingo rechaza los estados de Shelley a Babbage antes de persistirlos y devuelve el error ErrPreConwaySnapshotUnsupported.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Límite comprimido por objeto Mithrilmithril.downloadMaxBytes--mithril-download-max-bytesDINGO_MITHRIL_DOWNLOAD_MAX_BYTES0 utiliza los límites integrados por objeto. Un valor positivo sustituye el límite de cada objeto descargado. La validación de configuración o de inicio rechaza los valores negativos.

Cuando mithril.downloadMaxBytes es 0, Dingo utiliza estos límites integrados de tamaño comprimido:

Objeto MithrilLímite incorporado
Archivo inmutable v21 GiB
Lista de resúmenes v2256 MiB
Datos auxiliares v264 GiB

Los ajustes de mithril.server controlan dingo mithril snapshot create y dingo mithril serve. La lectura de los artefactos de instantáneas es pública. El registro de firmantes y el cierre del registro del agregador aceptan solicitudes anónimas. Dingo conserva mithril.server.aggregator.operatorTokenFile y sus entradas CLI y de entorno por compatibilidad, pero ignora sus valores y no exige el token. El agregador no exige TLS. Establece mithril.server.publicBaseUrl en el origen público de las descargas.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Puerto del servidor de artefactosmithril.server.port--mithril-server-portDINGO_MITHRIL_SERVER_PORT8081. dingo mithril serve escucha en este puerto y en el bindAddr raíz.
Origen público de las instantáneasmithril.server.publicBaseUrl--mithril-server-public-base-urlDINGO_MITHRIL_SERVER_PUBLIC_BASE_URLObligatorio para dingo mithril serve. Acepta un origen absoluto HTTP o HTTPS sin credenciales, ruta, consulta ni fragmento.
Almacén de artefactosmithril.server.artifactStore--mithril-server-artifact-storeDINGO_MITHRIL_SERVER_ARTIFACT_STOREVacío. Configura un directorio, s3://bucket/prefix o gcs://bucket/prefix. Los dos últimos requieren una compilación con dingo_extra_plugins.
URL base de redirecciónmithril.server.redirectBaseUrl--mithril-server-redirect-base-urlDINGO_MITHRIL_SERVER_REDIRECT_BASE_URLVacía. Si se configura, las solicitudes de archivos se redirigen a esta URL base más la clave del objeto, en lugar de transmitir el objeto. Úsala solo si los objetos remotos son públicos.
Retención de instantáneasmithril.server.keepSnapshots--mithril-server-keep-snapshotsDINGO_MITHRIL_SERVER_KEEP_SNAPSHOTS0 conserva todas las instantáneas producidas. Un valor positivo conserva esa cantidad de las más recientes.
Clave de firma auxiliarmithril.server.ancillarySigningKeyFile--mithril-server-ancillary-signing-key-fileDINGO_MITHRIL_SERVER_ANCILLARY_SIGNING_KEY_FILEVacío. Configura la clave Ed25519 de Mithril en formato JSON hexadecimal que firma cada manifiesto auxiliar.
TLS del servidor de artefactosmithril.server.tlsEnabled--mithril-server-tls-enabledDINGO_MITHRIL_SERVER_TLS_ENABLEDfalse. Si se activa, utiliza tlsCertFilePath y tlsKeyFilePath compartidos.
Endpoints del agregadormithril.server.aggregator.enabled--mithril-aggregator-enabledDINGO_MITHRIL_AGGREGATOR_ENABLEDfalse. Activa el registro de firmantes, la recopilación de firmas y la certificación de instantáneas.
Época de registro de firmantesmithril.server.aggregator.epoch--mithril-aggregator-epochDINGO_MITHRIL_AGGREGATOR_EPOCH0 no selecciona una época utilizable; configura al menos 1 al activar el agregador. El certificado de génesis utiliza la época anterior.
Quórum STMmithril.server.aggregator.k--mithril-aggregator-kDINGO_MITHRIL_AGGREGATOR_K0 hasta configurarlo. Debe ser positivo y no superar m.
Tamaño de la lotería STMmithril.server.aggregator.m--mithril-aggregator-mDINGO_MITHRIL_AGGREGATOR_M0 hasta configurarlo. Debe ser positivo si el agregador está activo.
Probabilidad de victoria STMmithril.server.aggregator.phiF--mithril-aggregator-phi-fDINGO_MITHRIL_AGGREGATOR_PHI_F0 hasta configurarlo. Debe ser mayor que 0 y menor o igual que 1.
Clave de firma de génesis del agregadormithril.server.aggregator.genesisSigningKeyFile--mithril-aggregator-genesis-signing-key-fileDINGO_MITHRIL_AGGREGATOR_GENESIS_SIGNING_KEY_FILEObligatoria si el agregador está activo. Configura una clave Ed25519 de Mithril en formato JSON hexadecimal.
Token del operador del agregadormithril.server.aggregator.operatorTokenFile--mithril-aggregator-operator-token-fileDINGO_MITHRIL_AGGREGATOR_OPERATOR_TOKEN_FILEEntrada heredada que Dingo ignora y que no tiene efecto. No es obligatoria y no requiere un archivo con un token.

Validación del almacenamiento de metadatos SQLite

Sección titulada «Validación del almacenamiento de metadatos SQLite»

Cuando plugins.storage.metadata.provider es sqlite, o se omite y Dingo utiliza sqlite de forma predeterminada, la raíz databasePath no puede estar vacía. Dingo rechaza el inicio si está vacía en cualquiera de esos casos.

Las conexiones PostgreSQL generadas por el proveedor utilizan sslMode: verify-full de forma predeterminada para verificar el certificado y el nombre del servidor. Las conexiones MySQL generadas utilizan tls=true si no se establece sslMode y el host no es de loopback; localhost, 127.0.0.1 y ::1 están exentos. Un dsn explícito tiene prioridad y evita estos valores predeterminados generados.

Las operaciones de instantánea y restauración MySQL rechazan tls=skip-verify en lugar de degradar la conexión a TLS oportunista. Utiliza un modo explícito admitido, como tls=false, tls=true o tls=preferred, si la operación requiere otra configuración.

Configura los campos de token de autorización de Midnight bajo midnight cuando el registro deba utilizar una política y un activo concretos.

ConfiguraciónClave YAMLValor predeterminadoValidación y comportamiento
Política del token de autorizaciónmidnight.authTokenPolicyIdVacíoDebe tener exactamente 56 caracteres hexadecimales y decodificar a 28 bytes.
Nombre de activo del token de autorizaciónmidnight.authTokenAssetNameVacíoDingo lo utiliza junto con el identificador de política al validar el token de autorización.

Establece ambos campos o deja ambos vacíos. Un par incompleto hace fallar la validación de configuración y de inicio. Cuando están configurados, Dingo solo acepta un token si el identificador de política y el nombre del activo coinciden exactamente.

Configura estas claves YAML bajo plugins.storage.blob.config para el proveedor Badger. No añaden opciones CLI ni variables de entorno de nivel superior.

Dingo utiliza 1 MiB como valor predeterminado de plugins.storage.blob.config.valueThreshold, salvo durante sync en modo core y la sincronización Mithril, donde utiliza 1 KiB. Un valor YAML explícito sustituye cualquiera de esos valores, incluido un 0 explícito.

ConfiguraciónClave YAML del proveedorValor predeterminadoValidación y comportamiento
Caché de bloquesplugins.storage.blob.config.blockCacheSize0 en almacenamiento core; 256 MiB en modo API.Configura el tamaño de la caché de bloques en bytes. No existen opción CLI ni variable de entorno de nivel superior.
Caché de índicesplugins.storage.blob.config.indexCacheSize0 en almacenamiento core y en modo API.Configura el tamaño de la caché de índices en bytes. No existen opción CLI ni variable de entorno de nivel superior.
Compresiónplugins.storage.blob.config.compressionDesactivada en almacenamiento core; activada en modo API.En Badger en disco, la compresión requiere un blockCacheSize positivo. blockCacheSize: 0 hace fallar la carga de la configuración cuando la compresión está activada. Los valores cero de las cachés siguen siendo válidos cuando la compresión está desactivada.
Tamaño de memtableplugins.storage.blob.config.memTableSize512 MiB únicamente en almacenamiento core y ejecución sync; las demás combinaciones utilizan 128 MiB cuando se omite o vale 0.Configura un número de bytes. Un valor explícito sustituye el predeterminado integrado. No existen opción CLI ni variable de entorno de nivel superior.
Intervalo de GC del registro de valoresplugins.storage.blob.config.gcInterval5mUn intervalo cero selecciona 5m. Se rechazan los intervalos negativos.
Proporción de descarte de GCplugins.storage.blob.config.gcDiscardRatio0.5Debe ser estrictamente mayor que 0 y menor que 1.

Dingo mantiene desactivada la recolección del registro de valores tanto en load como en sync, aunque plugins.storage.blob.config.gc esté establecido en true.

Límite de pausa de las instantáneas de base de datos

Sección titulada «Límite de pausa de las instantáneas de base de datos»
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminadoValidación y alcance
Límite de pausa de commit de instantáneasdatabaseLifecycle.snapshotMaxCommitPause--db-snapshot-max-commit-pauseDINGO_DB_LIFECYCLE_SNAPSHOT_MAX_COMMIT_PAUSE30s; 0s elimina el límite.Admite una duración no negativa; la validación rechaza valores negativos. Un valor positivo limita las instantáneas manuales sin conexión, en vivo y automáticas de límite de época después de adquirir la barrera de commit. Si se supera, cancela la instantánea, elimina la salida parcial y devuelve un error que envuelve ErrCommitPauseExceeded.

Directorio de instantáneas de base de datos

Sección titulada «Directorio de instantáneas de base de datos»
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y requisitos
Directorio local de instantáneasdatabaseLifecycle.snapshotDir--db-snapshot-dir—Vacío de forma predeterminada. Cuando se configura, Dingo valida que el directorio sea propiedad del usuario que ejecuta el proceso o de root en Unix y que pueda escribirse; fija permisos privados 0700. Las carpetas de instantáneas utilizan 0700 y sus archivos 0600. En Windows, Dingo aplica una ACL protegida de propietario único.

Clave de confianza de las instantáneas de base de datos

Sección titulada «Clave de confianza de las instantáneas de base de datos»
ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y validación
Archivo de clave de confianzadatabaseLifecycle.snapshotTrustKeyFile--db-snapshot-trust-key-fileDINGO_DB_LIFECYCLE_SNAPSHOT_TRUST_KEY_FILEVacío de forma predeterminada. Debe ser un archivo regular, sin enlace simbólico, de al menos 16 bytes y no más de 1024 bytes.

En Unix, el archivo debe pertenecer al usuario actual y no conceder acceso al grupo ni a otros usuarios. Windows admite al usuario actual o a BUILTIN\Administrators como propietario si el proceso pertenece a ese grupo. La DACL solo puede incluir al propietario, Administrators, SYSTEM, Creator Owner y Owner Rights, además de la ACE local restringida de Administrator cuando Administrators sea el propietario. Dingo rechaza los archivos no válidos al autenticar instantáneas y en cualquier operación de ciclo de vida que necesite la clave.

Al activar la duplicación de instantáneas en la nube, proporciona una clave de confianza válida. Dingo rechaza las instantáneas heredadas no firmadas para la duplicación en la nube; no las firma automáticamente.

Las restauraciones locales sin una clave de confianza requieren un directorio de instantáneas privado y de confianza en Unix, y un manifiesto autenticado en Windows. Consulta la guía de arranque y mantenimiento de datos para realizar las comprobaciones operativas necesarias.

El servicio remoto de ciclo de vida de Bark está desactivado de forma predeterminada. Al activarlo, ofrece Stop, Restart y GetStatus. Bark escucha en 127.0.0.1 de forma predeterminada cuando se monta este servicio; configura barkHost para exponerlo en otra interfaz.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y requisitos
Activar el servicio de ciclo de vidabarkLifecycleEnabled--bark-lifecycle-enabledDINGO_BARK_LIFECYCLE_ENABLEDfalse. Requiere barkPort distinto de cero.
Certificados de operadores de ciclo de vidabarkLifecycleOperatorCertificateFingerprints--bark-lifecycle-operator-certificate-fingerprintsDINGO_BARK_LIFECYCLE_OPERATOR_CERTIFICATE_FINGERPRINTSEntrada heredada sin efecto. No configura autorización ni requiere huellas para el ciclo de vida.
Direcciones privadas o especiales para descargasbarkBlockDownloadAllowPrivateAddresses--bark-block-download-allow-private-addressesDINGO_BARK_BLOCK_DOWNLOAD_ALLOW_PRIVATE_ADDRESSESfalse. Con true, permite direcciones resueltas privadas o de uso especial para las descargas de bloques Bark. Mantiene la lista de orígenes permitidos, HTTPS, la validación de redirecciones y la desactivación de proxies. Solo afecta a las descargas, no al tráfico RPC.

GetStatus, Stop y Restart aceptan solicitudes HTTP anónimas sin cifrar. Dingo ignora las entradas heredadas barkClientCaFilePath, barkOperatorCertificateFingerprints y barkLifecycleOperatorCertificateFingerprints; no requiere certificados de cliente, certificados ni claves de servidor, ni huellas de operadores para estas operaciones. Restart está disponible únicamente en Unix; las demás plataformas devuelven un error de operación no admitida.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y validación
Consultas globales de archivo por segundobarkArchiveLookupsPerSecond--bark-archive-lookups-per-secondDINGO_BARK_ARCHIVE_LOOKUPS_PER_SECONDSin configurar o con 0, no impone un límite. Un valor positivo limita las consultas de todos los llamadores anónimos de ArchiveService. Se rechazan los valores negativos.
Consultas de archivo por llamador y segundobarkArchiveCallerLookupsPerSecond--bark-archive-caller-lookups-per-secondDINGO_BARK_ARCHIVE_CALLER_LOOKUPS_PER_SECONDSin configurar o con 0, no impone un límite. Un valor positivo limita las consultas de un llamador identificado por dirección IPv4 o prefijo IPv6 /64. Se rechazan los valores negativos.

Dingo cobra en ambos presupuestos un cargo base por cada referencia de FetchBlock. Cuando el lote contiene referencias por altura, reserva por adelantado en ambos presupuestos, una sola vez, el coste de resolver el límite superior (66 unidades de consulta). Después, reserva en ambos presupuestos el trabajo de búsqueda binaria de cada referencia según el límite resuelto. Los reintentos por un tramo final obsoleto del índice y los saltos de entradas interiores obsoletas también reservan por adelantado, en ambos presupuestos, el coste de cada operación. Si alguno de los dos presupuestos no cubre el siguiente trabajo, Dingo rechaza la solicitud con RESOURCE_EXHAUSTED antes de iniciar la resolución, búsqueda o lectura correspondiente del archivo o del almacenamiento en nube. Los lotes grandes que contienen referencias por altura pueden necesitar dividirse.

Secretos y entradas de paridad desde archivos

Sección titulada «Secretos y entradas de paridad desde archivos»

Las entradas desde archivos son alternativas a los valores literales. Se aplica la misma prioridad de CLI, entorno, YAML y valores predeterminados descrita anteriormente. Dingo rechaza una fuente que establezca simultáneamente la forma literal y la forma de archivo.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Clave API de paridad Koios de DingokoiosParity.apiKeyEliminada; no válida: --koios-parity-api-keyDINGO_KOIOS_PARITY_API_KEYVacía de forma predeterminada. YAML y esta variable de entorno siguen aceptando claves API literales.
Archivo de clave API de paridad Koios de DingokoiosParity.apiKeyFile--koios-parity-api-key-fileDINGO_KOIOS_PARITY_API_KEY_FILEVacío de forma predeterminada. La entrada CLI utiliza esta opción respaldada por archivo. El archivo se lee como una cadena de clave API.
Archivo de campo genérico de configuración de plugins——DINGO_PLUGINS_<CAPABILITY>_CONFIG_<FIELD>_FILESustituye a DINGO_PLUGINS_<CAPABILITY>_CONFIG_<FIELD>. Dingo lee el archivo como una cadena de texto, sin interpretarlo como YAML.
Archivo de clave API de koios-parity—--api-key-fileKOIOS_API_KEY_FILESustituye a --api-key o KOIOS_API_KEY. Las opciones CLI tienen prioridad sobre las variables de entorno.
Archivo de DSN de metadatos de koios-parity—--metadata-dsn-file—Sustituye a --metadata-dsn. Aporta la cadena de conexión como texto.
Archivo de clave Koios de node-parity from-genesis—--koios-api-key-file—Sustituye a --koios-api-key. Aporta la clave API de la solicitud Koios.
Tamaño de lote de transacciones de node-parity from-genesis—--koios-tx-info-batch-size—40 de forma predeterminada. Solo node-parity from-genesis admite esta opción. Controla el número de hashes de transacción por solicitud /tx_info y acepta valores de 1 a 999. El host público rechaza cuerpos de solicitud de más de 5120 bytes.
Concurrencia de transacciones de node-parity from-genesis—--koios-tx-info-concurrency—8 de forma predeterminada. Solo node-parity from-genesis admite esta opción. Controla el número de solicitudes /tx_info que Dingo mantiene simultáneamente y acepta valores de 1 a 64.
Directorio de captura de límites de node-parity from-genesis—--boundary-capture-dir—El operador puede indicar un directorio de capturas de límites para la comparación de UTxO desde génesis.

Cada valor respaldado por archivos debe cumplir estos requisitos:

  • La ruta debe identificar un archivo regular. Dingo rechaza directorios, dispositivos y otros caminos no regulares.
  • Dingo acepta como máximo 64 KiB de contenido. Elimina los caracteres CR y LF finales y rechaza el contenido vacío o compuesto únicamente de espacios.
  • El archivo y cada entrada ancestral de su ruta deben tener una propiedad confiable. En Unix, deben pertenecer al usuario que ejecuta el proceso o a root; además, Dingo rechaza los directorios no sticky que permitan escritura al grupo o a otros usuarios. Unix permite acceso al propietario y al grupo en el archivo, pero no a otros usuarios. Windows solo permite al propietario, Administrators y SYSTEM mediante la ACL correspondiente.
  • Los errores identifican el valor o la ruta, pero nunca incluyen el contenido del archivo.

Autenticación de manifiestos del registro de tokens

Sección titulada «Autenticación de manifiestos del registro de tokens»

La sincronización del registro de tokens admite un archivo público sin manifiesto firmado y réplicas con manifiesto firmado.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
URL del archivo del registrotokenRegistry.sourceUrl--token-registry-source-urlDINGO_TOKEN_REGISTRY_SOURCE_URLVacía de forma predeterminada. Dingo selecciona el archivo público correspondiente a la red. Un valor explícito debe ser una URL HTTPS absoluta.
URL del manifiesto firmadotokenRegistry.manifestUrl--token-registry-manifest-urlDINGO_TOKEN_REGISTRY_MANIFEST_URLVacía de forma predeterminada. Una réplica firmada requiere esta URL y trustedManifestKey; debe ser una URL HTTPS absoluta.
Clave de confianza del manifiestotokenRegistry.trustedManifestKey--token-registry-trusted-manifest-keyDINGO_TOKEN_REGISTRY_TRUSTED_MANIFEST_KEYVacía de forma predeterminada. Una réplica firmada requiere esta clave junto con manifestUrl; configura una clave pública Ed25519 de 32 bytes codificada en hexadecimal.
Permitir retroceso del manifiestotokenRegistry.allowRollback--token-registry-allow-rollbackDINGO_TOKEN_REGISTRY_ALLOW_ROLLBACKfalse de forma predeterminada. Dingo aplica este ajuste solo cuando verifica la instantánea mediante un manifiesto firmado; utiliza true únicamente para un retroceso intencional del editor.

Para sincronizar el archivo público, Dingo requiere que tokenRegistry.manifestUrl y tokenRegistry.trustedManifestKey permanezcan vacíos. Dingo utiliza tokenRegistry.sourceUrl o el archivo público predeterminado de la red sin exigir un manifiesto firmado. Para una réplica firmada, Dingo requiere ambos campos y rechaza una configuración que establezca solo uno.

En el flujo con manifiesto firmado, Dingo verifica el manifiesto frente a la URL del archivo configurada, el tamaño comprimido exacto y el resumen BLAKE2b-256. El manifiesto aporta la secuencia para las comprobaciones de retroceso. Dingo rechaza una instantánea cuando falta la autenticación, cuando sus datos no coinciden o cuando está incompleta; también rechaza una secuencia inferior salvo que allowRollback sea true, y rechaza un cambio de resumen con la misma secuencia. Una instantánea rechazada no sustituye la última aceptada.

Credenciales de encabezados del registro de tokens

Sección titulada «Credenciales de encabezados del registro de tokens»

Utiliza tokenRegistry.headerSecrets para las credenciales de una réplica autenticada del registro de tokens. En YAML, es un mapa de nombres de encabezado a valores secretos:

tokenRegistry:
headerSecrets:
Authorization: "Bearer <token>"

La variable de entorno es DINGO_TOKEN_REGISTRY_HEADER_SECRETS y utiliza pares name:value separados por comas. Cada par se divide en el primer signo de dos puntos; el valor puede incluir más signos de dos puntos, pero no comas. No existe opción CLI porque expondría las credenciales en la lista de procesos.

Dingo oculta los valores de los encabezados en la configuración presentada y en los errores. Las solicitudes con credenciales deben utilizar un origen HTTPS o de loopback. Rechaza los nombres y valores de encabezado mal formados y los nombres reservados para el transporte o la solicitud. Si una redirección cambia el esquema o el host, elimina las credenciales antes de seguirla.

Dingo v0.94.0 no admite ForgePrimaryChainTipToleranceSlots ni forgePrimaryChainTipToleranceSlots en YAML, CLI o variables de entorno. Elimina esos ajustes sin sustituirlos por otro campo.

Configura opcionalmente forgeAppliedTipStalenessSlots en YAML, --forge-applied-tip-staleness-slots en CLI o DINGO_FORGE_APPLIED_TIP_STALENESS_SLOTS en el entorno. El valor predeterminado 0 desactiva el límite. Dingo solo lo evalúa cuando existe un objetivo de origen corroborado y lo ignora si el objetivo es desconocido.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y comportamiento
Pools de productores de bloquesblockProducerPools——Solo YAML. Si falta la lista o está vacía, Dingo mantiene la configuración de un solo pool en las claves de nivel superior. Una lista con elementos reemplaza las claves de nivel superior shelley* y los ajustes de origen KES relacionados; cada entrada define su propio pool.

Cada entrada de blockProducerPools requiere shelleyVrfKey, shelleyOperationalCertificate y exactamente un origen KES: shelleyKesKey, shelleyKesAgentSocket o shelleyKesAgentAddress/shelleyKesAgentAddresses. shelleyKesAgentSignTimeout y shelleyKeyWatchInterval de nivel superior se aplican a todos los pools. Las entradas anidadas no tienen opciones CLI ni variables de entorno independientes.

Dingo rechaza una lista con ajustes de pool único heredados de nivel superior, rutas duplicadas de certificados operativos y configuraciones remotas compartidas sin perfiles distintos. Varios pools pueden usar el mismo listener remoto cuando cada uno define un valor diferente para shelleyKesAgentProfile; Dingo rechaza un perfil ausente o repetido para ese listener.

La opción --shelley-kes-agent-socket admite rutas de sockets del sistema de archivos y direcciones abstractas de Linux. Dingo resuelve las rutas relativas una vez al construir el cliente y reutiliza la ruta resuelta al reconectar. Conserva las direcciones abstractas con prefijo @, rechaza las direcciones literales con prefijo NUL al construir el cliente y aplica los límites de longitud de sockets de la plataforma.

ConfiguraciónClave YAMLOpción CLIVariable de entornoValor predeterminado y validación
Dirección del agente KES remotoshelleyKesAgentAddress o blockProducerPools[].shelleyKesAgentAddress--shelley-kes-agent-addressSHELLEY_KES_AGENT_ADDRESSSin configurar. Introduce una dirección host:port para firmar mediante un agente remoto. En cada entrada de blockProducerPools, esta clave es una de las fuentes KES mutuamente excluyentes.
Direcciones del agente KES remotoshelleyKesAgentAddresses o blockProducerPools[].shelleyKesAgentAddresses--shelley-kes-agent-addressesSHELLEY_KES_AGENT_ADDRESSESSin configurar. Introduce una lista ordenada de direcciones host:port; Dingo valida cada entrada y utiliza la lista para el cambio ordenado entre agentes. No combines este campo con shelleyKesAgentAddress en el mismo nivel.
Perfil del agente KES remotoshelleyKesAgentProfile o blockProducerPools[].shelleyKesAgentProfile--shelley-kes-agent-profileSHELLEY_KES_AGENT_PROFILESin configurar. El perfil selecciona la sesión de firma del agente remoto. Un perfil requiere shelleyKesAgentAddress o shelleyKesAgentAddresses del mismo nivel; los pools que comparten un listener remoto deben usar perfiles distintos.

Las opciones CLI y las variables de entorno de estos campos configuran únicamente los ajustes de nivel superior; las entradas de blockProducerPools utilizan sus claves YAML correspondientes.

El proveedor Kupo opcional se configura bajo plugins.api.kupo. Utiliza provider: "builtin" para seleccionar el integrado. Kupo requiere storageMode: api; --kupo-provider selecciona el proveedor desde CLI. Un valor 0 en plugins.api.kupo.config.port desactiva el servicio.

El ejemplo también contiene patrones de despliegue comentados para nodos relay, API/datos, productores, archivos, caducidad del historial y desarrollo. Revisa sus advertencias antes de activar ajustes que alteren el consenso, el forjado o la exposición a la red.


Doc Holiday logo

Docs authored by Doc Holiday