Un producto de custodia de Bitcoin tiene el mismo problema de datos que cualquier otro custodio de UTXO. El producto necesita detectar depósitos entrantes y retiros salientes en miles de direcciones de clientes, atribuir cada evento a la cuenta de cliente correcta y mantenerse sincronizado con la cadena sin operar bitcoind y una flota de indexadores. Este artículo describe la arquitectura de conciliación de depósitos utilizada por los custodios de Bitcoin en producción en Bitquery. Cubre la forma de consulta de entradas y salidas de Bitcoin, el latido de la punta de la cadena que impulsa al caminante, el patrón de lotes del corpus de direcciones, el filtro de tipo de script para billeteras P2PKH versus SegWit versus P2SH, el paso de conciliación del libro de direcciones, el pase de verificación de Coinpath para el cumplimiento de la fuente de fondos, el búfer de finalidad para la confirmación de depósito seguro y la portabilidad del mismo esqueleto a Litecoin y Dogecoin. Es el complemento de Bitcoin de la guía de depósitos de Cardano. Misma arquitectura de tres componentes, cadena diferente, detalles de modelo UTXO diferentes. ## La arquitectura de tres componentes Todo detector de depósitos de Bitcoin en producción se reduce a tres componentes. El primer componente es un latido de la punta de la cadena. Se activa en un cronograma fijo y devuelve la altura del bloque Bitcoin actual. Esto le indica al resto del pipeline cuánto ha avanzado la cadena desde el último barrido. El segundo componente es un caminante del corpus de direcciones. Llama a las consultas de entradas y salidas de Bitcoin con filtros de altura y un lote de direcciones de clientes, luego pagina los resultados. Cada iteración extiende el rango caminado en un tamaño de bloque fijo hasta que el cursor alcanza la punta. El tercer componente es un conciliador. Une la salida del caminante con el libro de direcciones interno del custodio, atribuye cada transacción a una cuenta de cliente, aplica el búfer de confirmación y escribe un evento de depósito o retiro en el libro mayor. Los tres componentes se ejecutan de forma independiente. El latido decide cuándo hay nuevo trabajo, el caminante realiza el trabajo y el conciliador convierte el trabajo en estado comercial. Los fallos en uno no se propagan a los demás. ## Latido de la punta de la cadena El latido es una consulta que devuelve la altura del bloque actual. Esta es la consulta más barata en el pipeline. Almacena en caché la respuesta por segundo en tu propio lado si el latido se activa con más frecuencia que eso. Bitcoin produce un bloque aproximadamente cada diez minutos, por lo que una cadencia más alta no compra nada para la frescura. El latido cumple dos funciones.Le indica al caminante el límite superior del siguiente fragmento a obtener. También señala la actividad de la cadena, por lo que un latido que falla repetidamente es el indicador más temprano de que algo está mal en la cadena. ## Caminante del Corpus de Direcciones El caminante es la consulta principal. Obtiene cada entrada y cada salida que toca un lote de direcciones de clientes dentro de un rango de bloques delimitado. Los filtros inputAddress y outputAddress toman un lote de direcciones de clientes, por lo que una llamada cubre a muchos usuarios. Lotes más pequeños significan más solicitudes, mientras que lotes más grandes corren el riesgo de alcanzar tiempos de espera en rangos de bloques ocupados o en billeteras con alta actividad. El filtro de altura limita el trabajo a un rango de bloques específico, lo que hace que la llamada sea determinista e idempotente. Volver a ejecutar la misma dirección y rango de altura devuelve el mismo resultado cada vez. El conciliador puede reintentar un fragmento de forma segura. El orden de altura de bloque garantiza que el caminante vea los eventos en el orden de la cadena. Los depósitos y los gastos que los consumen llegan en el mismo orden en que aparecen en la cadena, lo que simplifica la lógica de deduplicación del conciliador. ## Filtrado de tipo de script para direcciones Bitcoin P2PKH, SegWit y P2SH vienen en tres formatos comunes, cada uno vinculado a un tipo de script de salida diferente. El libro de direcciones de un custodio a menudo contiene los tres porque las direcciones antiguas todavía están en circulación, algunos flujos entrantes se originan en intercambios antiguos y las billeteras modernas por defecto son SegWit. El filtro outputScriptType restringe el walker a salidas P2PKH. Para direcciones nativas de SegWit, use witness_v0_keyhash para P2WPKH o witness_v1_taproot para Taproot. Eliminar el filtro por completo devuelve salidas coincidentes independientemente del tipo de script, lo que funciona cuando el corpus de direcciones es una lista blanca estricta. Para corpus mixtos, ejecute consultas walker separadas por tipo de script y combine los resultados en el conciliador. Para billeteras P2SH, use scripthash. Un custodio que administra los tres tipos de script ejecuta tres consultas walker por fragmento, una por tipo, y escribe la unión en el conciliador. El trabajo total es similar a ejecutar una consulta sin filtrar, con la ventaja de que cada flujo de tipo de script se puede monitorear por separado. ## Tamaño del fragmento, estado estable y puesta al día El tamaño del fragmento del rango de bloques es la palanca principal para el rendimiento. El intervalo de bloques de Bitcoin tiene un promedio de diez minutos, por lo que un fragmento de 100 bloques cubre aproximadamente 17 horas de historial de la cadena y un fragmento de 1000 bloques cubre aproximadamente una semana. El número correcto depende de cuán activo sea el corpus de direcciones y cuán agresivos sean los límites de tiempo de espera. El estado estable se ejecuta en la punta.El caminante monitorea el latido del corazón y, cuando aterriza un nuevo bloque, obtiene el fragmento desde la última altura caminada hasta la punta. La mayoría de las veces, este fragmento es pequeño y se resuelve en menos de un segundo. El modo de recuperación se ejecuta cuando el caminante está más de un fragmento por detrás de la punta. Esto sucede después de la implementación, después de un reinicio del servicio que perdió el cursor o después de un tiempo de inactividad prolongado. ## Conciliación de la libreta de direcciones El caminante devuelve datos a nivel de cadena. Cada salida contiene la dirección del destinatario, el hash de la transacción, el índice de salida y el valor. La cadena no tiene conocimiento de qué cliente posee esa dirección. Ese mapeo reside dentro de los propios sistemas del custodio. El conciliador es el componente que une los dos: toma cada salida que encontró el caminante y busca la dirección del destinatario en la libreta de direcciones interna del custodio para atribuir el depósito a un cliente. El conciliador contiene dos tablas. La primera es la libreta de direcciones, que mapea a cada cliente con las direcciones de depósito generadas para ellos. La segunda es el libro mayor, la fuente de verdad del custodio para depósitos y retiros. Para cada salida devuelta por el caminante, el conciliador busca la dirección del destinatario en la libreta de direcciones, atribuye el valor a un cliente y escribe un evento de depósito en el libro mayor basado en el hash de la transacción y el par índice de salida. La búsqueda en la libreta de direcciones es la ruta crítica; manténgala en memoria o en un almacén de clave-valor de baja latencia. ## Detección del origen de los fondos con Coinpath Un custodio regulado suele tener una segunda tarea después de la atribución. Antes de que el depósito se liquide en el saldo disponible del cliente, la oficina administrativa quiere saber de dónde provienen los fondos. ¿La dirección del remitente pertenecía a una entidad sancionada? ¿Los fondos pasaron por un mezclador conocido en los últimos saltos? La API Bitcoin Coinpath responde de dónde provienen los fondos. La consulta de detección más simple es un rastreo de entrada en profundidad uno. Canalice la dirección del remitente a través de la lista de sanciones interna y el registro de mezcladores conocidos. Un acierto pausa el crédito del depósito y dirige el caso a la cola de cumplimiento. Un fallo permite que el conciliador proceda al búfer de confirmación. Para una procedencia más profunda, agregue profundidad para rastrear los fondos N saltos hacia atrás. ## El búfer de seis confirmaciones Las transacciones de Bitcoin no son definitivas en el momento en que aparecen en un bloque. Una reorganización puede invalidar un bloque minado recientemente y revertir cualquier depósito acreditado dentro del mismo.La mitigación estándar es retrasar la confirmación del depósito por un número fijo de bloques, convencionalmente seis en Bitcoin. El caminante aún puede obtener cada bloque en la punta y alimentar al conciliador. El conciliador mantiene los eventos en un estado pendiente hasta que vacían el búfer, luego los promueve a confirmados. ## Bitquery vs. bitcoind autoalojado más indexador La alternativa natural es ejecutar bitcoind contra un indexador como Electrs, BTC RPC Explorer o Esplora, luego consultar ese indexador a través de RPC o HTTP. Esta es una opción legítima para algunos equipos, pero es la opción incorrecta para la mayoría de los custodios. Bitquery ofrece un tiempo más rápido para el primer depósito, no requiere disco y tiene filtrado de lotes de direcciones y decodificación de tipo de script incorporados. ## Portabilidad de UTXO múltiples: el mismo bucle en Litecoin y Dogecoin Todo el patrón de conciliación anterior se porta a otras cadenas UTXO sin cambios arquitectónicos. Cambie el argumento de red para Litecoin o Dogecoin, cambie el formato de dirección en el corpus, y el mismo latido más caminante más conciliador se ejecuta contra la nueva cadena. Un custodio que admite BTC, LTC, DOGE y BCH ejecuta cuatro instancias del bucle, una por cadena, contra la misma API subyacente de Bitquery. ## Integración El bucle completo del detector de depósitos es corto. Los flujos de depósitos y retiros del custodio ahora se basan en el estado de la cadena Bitcoin sin necesidad de operar una flota de nodos. Esta es la misma arquitectura que utilizan los custodios de Bitcoin en producción en Bitquery. Se combina con la guía de depósitos de Cardano y la guía de sondeo de saldo de Avalanche para proporcionar una capa completa de datos de custodia en las cadenas UTXO y EVM. ## Resumen Un producto de custodia de Bitcoin que detecta depósitos y retiros a gran escala tiene tres opciones reales: Construir y operar una flota de nodos Bitcoin y un indexador personalizado. Transmitir desde un proveedor RPC administrado y reconstruir los movimientos UTXO por llamada. O ejecutar un latido de propinas más un recorrido de corpus de direcciones contra Bitquery y dejar que el conciliador gestione la atribución. [Bitquery]