Conexión de Suscriptor Edge

Al conectarme a DoubleZero, acepto los Términos de Uso de DoubleZero. Tenga en cuenta que los datos son únicamente para sus fines internos y no pueden ser retransmitidos (ver Sección 2(e)).

Paso 1: Configuración de DoubleZero

1. Completar la Configuración

Instale el Solana CLI.

Siga las instrucciones de configuración para instalar y configurar el cliente de DoubleZero.

Si ha configurado DoubleZero previamente, asegúrese de tener la última versión del CLI de 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:

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:

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 túneles automáticamente cuando se asigna su asiento. No está habilitado por defecto.

doublezero enable

Paso 2: Configurar Su Billetera

1. Crear un Par de Claves de Solana

El CLI doublezero-solana utiliza un par de claves estándar de Solana para la gestión de asientos onchain. Si no tiene uno:

solana-keygen new

Esto 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 billetera:

solana address

2. Fondear Su Billetera

Su billetera necesita dos tokens:

SOL — para las comisiones de transacción de Solana. Transfiera SOL a la dirección de billetera impresa arriba.
USDC — para fondear el asiento. El CLI extrae fondos de la Cuenta de Token Asociada (ATA) de su billetera para el mint de USDC de 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:

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 de los dispositivos antes de comprometer fondos. Los precios tienen dos componentes: un precio base de metro y una prima por dispositivo. Los precios se actualizan en cada epoch. También puede ver precios y disponibilidad aquí.

Todos los dispositivos:

doublezero-solana shreds price

Dispositivo específico:

doublezero-solana shreds price --device-code <Device_Name>
doublezero-solana shreds price --device <PUBKEY>

Todos los dispositivos en un metro:

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 epoch es el costo total por epoch 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:

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 epoch.
`--source-token-account <PUBKEY>`	Cuenta de origen USDC personalizada (por defecto usa la ATA de su billetera)
`--accept-partial-epoch`	Omitir la advertencia de epoch restante (ver más abajo)
`--fee-payer <PATH>`	Usar una billetera diferente para las comisiones 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 esté asignado, el daemon establece el túnel GRE automáticamente. Verifique su conexión con:

doublezero status

Temporización de Epoch

Los asientos se asignan por epoch de Solana (~2 días). Si queda menos del 10% del epoch actual cuando paga, el CLI advierte que su asiento se asignará inmediatamente pero solo cubre el resto del epoch actual. Se deducirá un pago separado de su escrow cuando comience el siguiente epoch.

Es recomendable fondear para más de 1 epoch a la vez para no perder su asiento. Puede verificar el tiempo restante en un epoch aquí.

Puede omitir esta advertencia con --accept-partial-epoch.

Mantenga Su Escrow Fondeado

Si el saldo de su escrow está por debajo del precio del epoch al momento de la liquidación, su asiento no será asignado, el túnel se derribará y perderá su antigüedad acumulada. La antigüedad determina su prioridad para futuros epochs — perderla significa que competirá como un recién llegado nuevamente.

Puede sobrecargar esta cuenta para fondear múltiples epochs. Cada liquidación deduce el precio de un epoch de su escrow, y el saldo restante se traslada. Por ejemplo, fondear 5 veces el precio por epoch mantiene su asiento activo hasta por 5 epochs sin necesidad de re-fondear.

Para recargar su escrow, ejecute shreds pay de nuevo en cualquier momento:

doublezero-solana shreds pay \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --amount 500

Tenga en cuenta que 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 de destino.

Monitorear Asientos

Esta sección detalla cómo ver asientos a través del CLI. También puede usar https://data.malbeclabs.com/api/v1/docs para monitorear asientos y ayudar a gestionar su cuenta de escrow.

Vea sus asientos activos y saldos de escrow:

Todos sus asientos:

doublezero-solana shreds list

Filtrar por dispositivo:

doublezero-solana shreds list --device-code <Device_Name>

Filtrar por IP del cliente:

doublezero-solana shreds list --client-ip <Target_IP>

Filtrar por billetera:

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ántos epochs cubre su saldo actual con los precios actuales. Si los precios cambian, esta estimación se ajusta.

Retirar Fondos

Cierre su escrow y reembolse el USDC restante a su billetera:

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP>

Puede identificar el dispositivo por --device <PUBKEY> o --device-code <CODE>, igual que en otros comandos.

Para enviar el reembolso a una cuenta de token diferente:

doublezero-solana shreds withdraw \
  --device-code <Device_Name> \
  --client-ip <Target_IP> \
  --refund-token-account <PUBKEY>

Retirar fondos 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:

doublezero multicast group list

Shreds de Líder

edge-solana-shreds: 233.84.178.1:7733

Shreds de Root

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

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 a su pipeline existente (por ejemplo, un deshredder basado en XDP).

Herramientas y Dashboards

Tabla de Puntuación Edge

La tabla de puntuación compara la velocidad de entrega de shreds entre DoubleZero Edge y otros proveedores, usando 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 de feed completo. También puede desglosar por región para ver el rendimiento esperado.

Publicadores Edge

La métrica "Publishing Shreds" en la parte superior izquierda del dashboard muestra el porcentaje total de 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 Edge, Dispositivos y Actividad

Puede buscar fácilmente su IP de Cliente en esta página para ver los asientos suscritos y su estado. Haga clic en suscripciones de asientos específicos para ver el historial de pagos y actividad. También puede ver los dispositivos disponibles en la página de Dispositivos y toda la actividad reciente en la página de Actividad.

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.

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 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 del epoch al momento de la liquidación, el asiento no se asigna, el túnel se derriba y se pierde la antigüedad. 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 el epoch — el asiento entra en efecto en el próximo epoch.
Todos los asientos en el 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

Verifique que el daemon esté ejecutándose: sudo systemctl status doublezerod
Verifique que el reconciliador esté habilitado: doublezero enable
Verifique que las reglas de firewall estén configuradas (GRE, BGP, PIM, tráfico de shreds en doublezero1, puerto 44880 en doublezero0)
Verifique que su asiento esté activo para el epoch actual: doublezero-solana shreds list
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 usado en sus comandos de asiento.

Advertencia de epoch

El CLI advierte cuando queda menos del 10% del epoch. Sus opciones son:

Aceptar con --accept-partial-epoch si desea el asiento inmediatamente
Esperar al siguiente epoch para obtener la cobertura completa de un epoch

"Amount is below the current price"

El comando pay valida su monto contra el precio mínimo por epoch (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 reintente shreds pay.