malbeclabs · Jared-dz · Jul 20, 2026 · Jul 20, 2026 · Jul 20, 2026
diff --git a/docs/Edge Subscriber Connection.es.md b/docs/Edge Subscriber Connection.es.md
@@ -0,0 +1,343 @@
+---
+description: Configure un suscriptor edge para recibir feeds de shreds de DoubleZero, incluyendo la configuración del cliente y las reglas de firewall para GRE, BGP, PIM y tráfico de shreds.
+---
+
+# Conexión de Suscriptor Edge
+!!! warning "Al conectarme a DoubleZero acepto los [Términos de Uso de DoubleZero](https://doublezero.xyz/terms-protocol). Tenga en cuenta que los datos son solo para sus fines internos y no pueden ser retransmitidos (véase la Sección 2(e))."
+
+## Paso 1: Configuración de DoubleZero
+
+### 1. Completar la Configuración
+
+Instale la [CLI de Solana](https://docs.anza.xyz/cli/install).
+
+Siga las instrucciones de [configuración](setup.md) para instalar y configurar el cliente de DoubleZero.
+
+Si ha configurado DoubleZero previamente, asegúrese de tener la última versión de la CLI Doublezero-Solana con `sudo apt update && sudo apt install doublezero-solana`
+
+### 2. Configurar el Firewall
+
+Permita el tráfico GRE, BGP, PIM y de shreds.
+
+**iptables:**
+
+```bash
+sudo iptables -A OUTPUT -p gre -j ACCEPT
+sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
+sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
+sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
+sudo iptables -A INPUT -i doublezero1 -p udp --dport 7733 -j ACCEPT
+sudo iptables -A INPUT -i doublezero0 -p udp --dport 44880 -j ACCEPT
+```
+
+**UFW:**
+
+```bash
+sudo ufw allow proto gre from any to any
+sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
+sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
+sudo ufw allow out on doublezero1 proto pim from any to any
+sudo ufw allow in on doublezero1 to any port 7733 proto udp
+sudo ufw allow in on doublezero0 to any port 44880 proto udp
+```
+
+### 3. Habilitar el Reconciliador
+
+El reconciliador monitorea el estado onchain y aprovisiona automáticamente los túneles cuando se le asigna su asiento. No está habilitado por defecto.
+
+```bash
+doublezero enable
+```
+
+### 4. Obtener la Identidad DoubleZero del Servidor
+
+Revise su Identidad DoubleZero. Esta identidad se utilizará para crear la conexión entre su máquina y DoubleZero.
+
+```bash
+doublezero address
+```
+
+**Salida:**
+```
+YourDoubleZeroAddress11111111111111111111111111111
+```
+
+---
+
+## Paso 2: Configurar Su Wallet
+
+### 1. Crear un Par de Claves de Solana
+
+La CLI `doublezero-solana` utiliza un par de claves estándar de Solana para la gestión de asientos onchain. Si no tiene uno:
+
+```bash
+solana-keygen new
+```
+
+Esto se escribe en `~/.config/solana/id.json`. Para usar una ruta diferente, pase `--keypair <path>` a cualquier comando de `doublezero-solana`.
+
+Imprima la dirección de su wallet:
+
+```bash
+solana address
+```
+
+### 2. Fondear Su Wallet
+
+Su wallet necesita dos tokens:
+
+- **SOL** — para las tarifas de transacción de Solana. Transfiera SOL a la dirección del wallet impresa anteriormente.
+- **USDC** — para el fondeo del asiento. La CLI extrae de la Cuenta de Token Asociada (ATA) de su wallet para el mint de USDC en mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`).
+
+---
+
+## Paso 3: Comprar un Asiento
+
+### 1. Encontrar Su Dispositivo Más Cercano
+
+Antes de comprar un asiento, identifique el dispositivo con la menor latencia desde su máquina:
+
+```bash
+doublezero latency
+```
+
+Anote el código del dispositivo del resultado con menor latencia (por ejemplo, `<Device_Name>`). Lo usará al comprar un asiento.
+
+### 2. Verificar Precios
+
+Consulte los precios actuales del dispositivo antes de comprometer fondos. Los precios tienen dos componentes: un **precio base de metro** y una **prima por dispositivo**. Los precios se actualizan cada época. También puede ver precios y disponibilidad [aquí](https://data.malbeclabs.com/dz/shreds/devices).
+
+**Todos los dispositivos:**
+
+```bash
+doublezero-solana shreds price
+```
+
+**Dispositivo específico:**
+
+```bash
+doublezero-solana shreds price --device-code <Device_Name>
+doublezero-solana shreds price --device <PUBKEY>
+```
+
+**Todos los dispositivos en un metro:**
+
+```bash
+doublezero-solana shreds price --metro <PUBKEY>
+```
+
+Columnas de salida: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`.
+
+El precio por época es el costo total por época para un asiento en ese dispositivo (base + prima). Use `--wide` para mostrar las claves públicas completas, o `--json` para salida en JSON.
+
+### 3. Comprar un Asiento
+
+Compre un asiento con un solo comando. Esto inicializa su asiento, fondea el escrow y solicita la asignación:
+
+```bash
+doublezero-solana shreds pay \
+  --device-code <Device_Name> \
+  --client-ip <Target_IP> \
+  --amount <Cost_Of_Seat>
+```
+
+**Parámetros:**
+
+| Flag | Descripción |
+|------|-------------|
+| `--device <PUBKEY>` | Dispositivo objetivo por clave pública (mutuamente excluyente con `--device-code`) |
+| `--device-code <CODE>` | Dispositivo objetivo por código legible (por ejemplo, `<Device_Name>`) |
+| `--client-ip <IP>` | La dirección IPv4 pública de su máquina |
+| `--amount <USDC>` | USDC a fondear (formato decimal, por ejemplo `100` = 100 USDC). Debe cumplir con el precio mínimo por época. |
+| `--source-token-account <PUBKEY>` | Cuenta de origen USDC personalizada (por defecto usa la ATA de su wallet) |
+| `--accept-partial-epoch` | Omitir la advertencia de época restante (ver más abajo) |
+| `--fee-payer <PATH>` | Usar un wallet diferente para las tarifas de transacción en SOL |
+| `--dry-run` | Simular la transacción sin ejecutarla |
+| `--with-compute-unit-price <PRICE>` | Establecer un precio de unidad de cómputo para una inclusión más rápida durante congestión |
+
+Una vez que su asiento sea asignado, el daemon establece el túnel GRE automáticamente. Verifique su conexión con:
+
+```bash
+doublezero status
+```
+
+### Temporización de Épocas
+
+Los asientos se asignan por época de Solana (~2 días). Si queda menos del 10% de la época actual cuando usted paga, la CLI advierte que su asiento se asignará inmediatamente pero solo cubre el resto de la época actual. Se deducirá un pago separado de su escrow cuando comience la siguiente época.
+
+!!! info "Es recomendable fondear para más de 1 época a la vez para no perder su asiento. Puede verificar el tiempo restante en una época [aquí](https://explorer.solana.com/)."
+
+Puede omitir esta advertencia con `--accept-partial-epoch`.
+
+### Mantener Su Escrow Fondeado
+
+!!! warning "Si el saldo de su escrow está por debajo del precio por época en el momento de la liquidación, su asiento no será asignado, el túnel será desconectado y perderá su antigüedad acumulada. La antigüedad determina su prioridad para épocas futuras — perderla significa que compite como un nuevo participante de nuevo."
+
+Puede sobrecargar esta cuenta para fondear múltiples épocas. Cada liquidación deduce el precio de una época de su escrow, y el saldo restante se transfiere. Por ejemplo, fondear 5 veces el precio por época mantiene su asiento activo hasta por 5 épocas sin necesidad de volver a fondear.
+
+Para recargar su escrow, ejecute `shreds pay` nuevamente en cualquier momento:
+
+```bash
+doublezero-solana shreds pay \
+  --device-code <Device_Name> \
+  --client-ip <Target_IP> \
+  --amount 500
+```
+
+Tenga en cuenta que la `Target_IP` debe ser una dirección IPv4 pública en la máquina que recibirá los shreds. Puede encontrarla ejecutando un comando como `curl -4 ifconfig.me` en la máquina destino.
+
+### Monitorear Asientos
+
+Esta sección detalla cómo ver asientos a través de la CLI. También puede usar [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) para monitorear asientos y ayudar en la gestión de su cuenta escrow.
+
+Vea sus asientos activos y saldos de escrow:
+
+**Todos sus asientos:**
+
+```bash
+doublezero-solana shreds list
+```
+
+**Filtrar por dispositivo:**
+
+```bash
+doublezero-solana shreds list --device-code <Device_Name>
+```
+
+**Filtrar por IP del cliente:**
+
+```bash
+doublezero-solana shreds list --client-ip <Target_IP>
+```
+
+**Filtrar por wallet:**
+
+```bash
+doublezero-solana shreds list --withdraw-authority <PUBKEY>
+```
+
+Columnas de salida: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`.
+
+La columna "Est. Epochs Paid" muestra cuántas épocas cubre su saldo actual a los precios vigentes. Si los precios cambian, esta estimación se ajusta.
+
+### Retirar Fondos
+
+Cierre su escrow y reembolse el USDC restante a su wallet:
+
+```bash
+doublezero-solana shreds withdraw \
+  --device-code <Device_Name> \
+  --client-ip <Target_IP>
+```
+
+Puede identificar el dispositivo mediante `--device <PUBKEY>` o `--device-code <CODE>`, igual que en otros comandos.
+
+Para enviar el reembolso a una cuenta de token diferente:
+
+```bash
+doublezero-solana shreds withdraw \
+  --device-code <Device_Name> \
+  --client-ip <Target_IP> \
+  --refund-token-account <PUBKEY>
+```
+
+!!! warning "Retirar significa que pierde su asiento y la antigüedad acumulada."
+
+---
+
+## Direcciones de Shreds (IP vs Puerto)
+
+Los Shreds de Líder y los Shreds de Retransmisión de alto stake llegarán por el puerto `7733`, a través de la interfaz `doublezero1`. La interfaz `doublezero0` es para tráfico unicast. El puerto `5765` es un monitor de heartbeat de los publicadores de shreds — este no contendrá shreds.
+
+Para el consumo de shreds, la **dirección IP** identifica el flujo multicast y el **puerto** identifica el servicio UDP en ese flujo.  
+Todos los flujos de shreds a continuación usan el puerto UDP `7733` en `doublezero1`.
+
+Puede examinar las IPs de cualquier grupo multicast con:
+
+```bash
+doublezero multicast group list
+```
+
+### Shreds de Líder
+
+- `edge-solana-shreds`: `233.84.178.1:7733`
+
+### Shreds de Raíz
+
+- `edge-solana-root`: `233.84.178.16:7733`
+
+### Shreds de Retransmisión
+
+- `edge-solana-retrans-eu`: `233.84.178.12:7733`
+- `edge-solana-retrans-apac`: `233.84.178.13:7733`
+- `edge-solana-retrans-amer`: `233.84.178.14:7733`
+
+
+## Encabezado del Túnel GRE — XDP
+
+!!! note "El tráfico de shreds entregado a través de la red está encapsulado en GRE. Es posible que necesite eliminar el encabezado GRE antes de alimentar los datos en su pipeline existente (por ejemplo, un deshredder basado en XDP)."
+
+---
+
+## Herramientas y Dashboards
+
+### [Marcador Edge](https://data.malbeclabs.com/dz/shreds/scoreboard)
+
+El marcador compara la velocidad de entrega de shreds entre DoubleZero Edge y otros proveedores, utilizando datos a nivel de slot para comparar el rendimiento en tiempo real. Use este dashboard para ver las tasas de victoria de los shreds de Edge contra otros proveedores. Puede ver resultados solo para shreds de líder, además de la comparación del feed completo. También puede desglosar por región para ver el rendimiento esperado.
+
+### [Publicadores Edge](https://data.malbeclabs.com/dz/shreds/publishers)
+
+La métrica "Publishing Shreds" en la parte superior izquierda del dashboard muestra el porcentaje total del peso de stake de todos los validadores de Solana que publican shreds de líder en DoubleZero Edge. Puede ver los detalles de cada publicador en la red.
+
+### [Suscriptores, Dispositivos y Actividad Edge](https://data.malbeclabs.com/dz/shreds/subscribers)
+
+Puede buscar fácilmente su IP de Cliente en esta página para asientos suscritos y ver el estado. Haga clic en suscripciones de asientos específicos para ver el historial de pagos y la actividad. También puede ver los dispositivos disponibles en la página de [Dispositivos](https://data.malbeclabs.com/dz/shreds/devices) y toda la actividad reciente en la página de [Actividad](https://data.malbeclabs.com/dz/shreds/activity).
+
+### Documentación de la API de Datos
+
+Para acceso programático a los endpoints de datos, consulte la documentación de la API: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs).
+
+---
+
+## Solución de Problemas
+
+Si encuentra un problema no cubierto aquí, comuníquese a través de su canal existente antes de intentar solucionarlo por su cuenta. Si no tiene un canal, busque en [Discord](https://discord.gg/U2fEb4Jq) y abra un ticket si es necesario.
+
+### Asegúrese de que su Cliente esté actualizado:
+
+Ejecute: `sudo apt update && sudo apt install doublezero-solana`
+
+### Saldo de escrow insuficiente
+
+Si el saldo de su escrow está por debajo del precio por época en el momento de la liquidación, el asiento no se asigna, el túnel se desconecta y la antigüedad se pierde. Recargue con `shreds pay` antes de la próxima liquidación.
+
+### Asiento no asignado después de pagar
+
+- Es posible que haya pagado tarde en la época — el asiento se activa en la siguiente época.
+- Todos los asientos del dispositivo pueden estar ocupados por titulares con mayor antigüedad. Verifique los asientos disponibles con `shreds price`.
+- Si retiró fondos antes de la liquidación, el asiento no era elegible.
+
+### El túnel no se establece
+
+1. Verifique que el daemon esté ejecutándose: `sudo systemctl status doublezerod`
+2. Verifique que el reconciliador esté habilitado: `doublezero enable`
+3. Verifique que las reglas del firewall estén configuradas (GRE, BGP, PIM, tráfico de shreds en `doublezero1`, puerto 44880 en `doublezero0`)
+4. Verifique que su asiento esté activo para la época actual: `doublezero-solana shreds list`
+5. Verifique el estado de su conexión: `doublezero status`
+
+La IP del cliente del daemon se descubre automáticamente desde la IP pública de su host — verifique que coincida con el `--client-ip` utilizado en sus comandos de asiento.
+
+### Aviso de época
+
+La CLI advierte cuando queda menos del 10% de la época. Sus opciones son:
+
+- Aceptar con `--accept-partial-epoch` si desea el asiento inmediatamente
+- Esperar a la siguiente época para obtener la cobertura de una época completa
+
+### "Amount is below the current price"
+
+El comando `pay` valida su monto contra el precio mínimo por época (base del metro + prima del dispositivo). Use `shreds price` para verificar los precios actuales y aumente su monto.
+
+### "Multicast user already exists"
+
+Ya tiene una suscripción activa a través de una ruta diferente. Desconéctese primero con `doublezero disconnect`, luego vuelva a intentar `shreds pay`.