diff --git a/docs/Edge Subscriber Connection.es.md b/docs/Edge Subscriber Connection.es.md index 56217aa..473a768 100644 --- a/docs/Edge Subscriber Connection.es.md +++ b/docs/Edge Subscriber Connection.es.md @@ -3,21 +3,21 @@ description: Configure un suscriptor edge para recibir feeds de shreds de Double --- # 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 únicamente para sus fines internos y no pueden ser retransmitidos (ver Sección 2(e))." +!!! 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 (consulte la Sección 2(e))." ## Paso 1: Configuración de DoubleZero ### 1. Completar la Configuración -Instale el [Solana CLI](https://docs.anza.xyz/cli/install). +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 del CLI de Doublezero-Solana con `sudo apt update && sudo apt install doublezero-solana` +Si ha configurado DoubleZero previamente, asegúrese de tener la última versión de la 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. +Permita el tráfico de GRE, BGP, PIM y shreds. **iptables:** @@ -55,7 +55,7 @@ doublezero enable ### 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: +La CLI de `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 @@ -73,8 +73,8 @@ solana address 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`). +- **SOL** — para las tarifas de transacción de Solana. Transfiera SOL a la dirección de billetera impresa anteriormente. +- **USDC** — para el fondeo de asientos. La CLI extrae fondos de la Cuenta de Token Asociada (ATA) de su billetera para el mint de USDC de mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). --- @@ -82,17 +82,17 @@ Su billetera necesita dos tokens: ### 1. Encontrar Su Dispositivo Más Cercano -Antes de comprar un asiento, identifique el dispositivo con la menor latencia desde su máquina: +Antes de comprar un asiento, identifique el dispositivo con la latencia más baja desde su máquina: ```bash doublezero latency ``` -Anote el código del dispositivo del resultado con menor latencia (por ejemplo, ``). Lo usará al comprar un asiento. +Anote el código del dispositivo del resultado con la latencia más baja (por ejemplo, ``). 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í](https://data.malbeclabs.com/dz/shreds/devices). +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**. También puede ver precios y disponibilidad [aquí](https://data.malbeclabs.com/dz/shreds/devices). **Todos los dispositivos:** @@ -115,11 +115,11 @@ doublezero-solana shreds price --metro 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. +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 formato JSON. ### 3. Comprar un Asiento -Compre un asiento con un solo comando. Esto inicializa su asiento, fondea el escrow y solicita la asignación: +Compre un asiento con un solo comando. Esto inicializa su asiento, fondea el depósito en garantía y solicita la asignación: ```bash doublezero-solana shreds pay \ @@ -134,11 +134,11 @@ doublezero-solana shreds pay \ |------|-------------| | `--device ` | Dispositivo objetivo por clave pública (mutuamente excluyente con `--device-code`) | | `--device-code ` | Dispositivo objetivo por código legible (por ejemplo, ``) | -| `--client-ip ` | La dirección IPv4 pública de su máquina | -| `--amount ` | USDC a fondear (formato decimal, por ejemplo `100` = 100 USDC). Debe cumplir con el precio mínimo por epoch. | -| `--source-token-account ` | 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 ` | Usar una billetera diferente para las comisiones de transacción en SOL | +| `--client-ip ` | Dirección IPv4 pública de su máquina | +| `--amount ` | USDC a fondear (formato decimal, por ejemplo `100` = 100 USDC). Debe cumplir con el precio mínimo por época. | +| `--source-token-account ` | Cuenta de origen de USDC personalizada (por defecto usa la ATA de su billetera) | +| `--accept-partial-epoch` | Omitir la advertencia de época restante (ver más abajo) | +| `--fee-payer ` | Usar una billetera diferente para las tarifas de transacción en SOL | | `--dry-run` | Simular la transacción sin ejecutarla | | `--with-compute-unit-price ` | Establecer un precio de unidad de cómputo para una inclusión más rápida durante congestión | @@ -148,21 +148,21 @@ Una vez que su asiento esté asignado, el daemon establece el túnel GRE automá doublezero status ``` -### Temporización de Epoch +### Temporización de Épocas -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. +Los asientos se asignan por época de Solana (~2 días). Si queda menos del 10% de la época actual cuando paga, la CLI advierte que su asiento será asignado inmediatamente pero solo cubre el resto de la época actual. Se deducirá un pago separado de su depósito en garantía cuando comience la siguiente época. -!!! info "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í](https://explorer.solana.com/)." +!!! 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`. -### Mantenga Su Escrow Fondeado +### Mantenga Su Depósito en Garantía Fondeado -!!! warning "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." +!!! warning "Si el saldo de su depósito en garantía está por debajo del precio de la época en el momento de la liquidación, su asiento no será asignado, el túnel será desactivado y perderá su antigüedad acumulada. La antigüedad determina su prioridad para épocas futuras — perderla significa que compite 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. +Puede sobrefinanciar esta cuenta para fondear múltiples épocas. Cada liquidación deduce el precio de una época de su depósito en garantía, y el saldo restante se mantiene. Por ejemplo, fondear 5 veces el precio por época mantiene su asiento activo hasta por 5 épocas sin necesidad de re-fondear. -Para recargar su escrow, ejecute `shreds pay` de nuevo en cualquier momento: +Para recargar su depósito en garantía, ejecute `shreds pay` nuevamente en cualquier momento: ```bash doublezero-solana shreds pay \ @@ -171,13 +171,13 @@ doublezero-solana shreds pay \ --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. +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 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](https://data.malbeclabs.com/api/v1/docs) para monitorear asientos y ayudar a gestionar su cuenta de escrow. +Esta sección detalla cómo ver los 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 de depósito en garantía. -Vea sus asientos activos y saldos de escrow: +Vea sus asientos activos y saldos de depósito en garantía: **Todos sus asientos:** @@ -205,11 +205,11 @@ doublezero-solana shreds list --withdraw-authority 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. +La columna "Est. Epochs Paid" muestra cuántas épocas cubre su saldo actual a 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: +Cierre su depósito en garantía y reembolse los USDC restantes a su billetera: ```bash doublezero-solana shreds withdraw \ @@ -228,13 +228,13 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "Retirar fondos significa que pierde su asiento y la antigüedad acumulada." +!!! 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. +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 — 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`. @@ -260,25 +260,25 @@ doublezero multicast group list - `edge-solana-retrans-amer`: `233.84.178.14:7733` -## Encabezado del Túnel GRE — XDP +## Encabezado de 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 a su pipeline existente (por ejemplo, un deshredder basado en 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 +## Herramientas y Paneles -### [Tabla de Puntuación Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) +### [Tabla de Posiciones Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) -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. +La Tabla de Posiciones 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 panel para ver una vista de las tasas de victorias 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 profundizar 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 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. +La métrica "Publishing Shreds" en la parte superior izquierda del panel 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 detalles de cada publicador en la red. -### [Suscriptores Edge, Dispositivos y Actividad](https://data.malbeclabs.com/dz/shreds/subscribers) +### [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 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](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). +Puede buscar fácilmente su IP de Cliente en esta página para los asientos suscritos y ver el estado. Haga clic en suscripciones de asientos específicas 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 @@ -288,19 +288,19 @@ Para acceso programático a los endpoints de datos, consulte la documentación d ## 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. +Si encuentra un problema no cubierto aquí, por favor comuníquese a través de su canal existente antes de buscar soluciones alternativas. 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 +### Saldo insuficiente en el depósito en garantía -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. +Si el saldo de su depósito en garantía está por debajo del precio de la época en el momento de la liquidación, el asiento no se asigna, el túnel se desactiva 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. +- Es posible que haya pagado tarde en la época — el asiento se activa en la próxima época. - 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. @@ -308,23 +308,23 @@ Si el saldo de su escrow está por debajo del precio del epoch al momento de la 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 de 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 el epoch actual: `doublezero-solana shreds list` +3. Verifique que las reglas de firewall estén en su lugar (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` usado en sus comandos de asiento. +La IP del cliente del daemon se descubre automáticamente a partir de la IP pública de su host — verifique que coincida con la `--client-ip` utilizada en sus comandos de asiento. -### Advertencia de epoch +### Advertencia de época -El CLI advierte cuando queda menos del 10% del epoch. Sus opciones son: +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 al siguiente epoch para obtener la cobertura completa de un epoch +- Esperar a la próxima época para obtener cobertura completa de una época ### "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. +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 reintente `shreds pay`. \ No newline at end of file +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`. \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.fr.md b/docs/Edge Subscriber Connection.fr.md index b03763f..a5561d1 100644 --- a/docs/Edge Subscriber Connection.fr.md +++ b/docs/Edge Subscriber Connection.fr.md @@ -1,5 +1,5 @@ --- -description: Configurer un abonné edge pour recevoir les flux de shreds DoubleZero, y compris la configuration du client et les règles de pare-feu pour GRE, BGP, PIM et le trafic de shreds. +description: Configurez un abonné edge pour recevoir les flux de shreds DoubleZero, y compris la configuration du client et les règles de pare-feu pour GRE, BGP, PIM et le trafic de shreds. --- # Connexion d'un abonné Edge @@ -7,13 +7,13 @@ description: Configurer un abonné edge pour recevoir les flux de shreds DoubleZ ## Étape 1 : Configuration de DoubleZero -### 1. Effectuer la configuration +### 1. Configuration complète -Installez la [CLI Solana](https://docs.anza.xyz/cli/install). +Installez le [Solana CLI](https://docs.anza.xyz/cli/install). Suivez les instructions de [configuration](setup.md) pour installer et configurer le client DoubleZero. -Si vous avez déjà configuré DoubleZero, assurez-vous d'avoir la dernière version de la CLI Doublezero-Solana avec `sudo apt update && sudo apt install doublezero-solana` +Si vous avez déjà configuré DoubleZero, assurez-vous d'avoir la dernière version du CLI Doublezero-Solana avec `sudo apt update && sudo apt install doublezero-solana` ### 2. Configurer le pare-feu @@ -43,7 +43,7 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. Activer le réconciliateur -Le réconciliateur surveille l'état onchain et provisionne automatiquement les tunnels lorsque votre siège est attribué. Il n'est pas activé par défaut. +Le réconciliateur surveille l'état onchain et provisionne automatiquement les tunnels lorsque votre siège est alloué. Il n'est pas activé par défaut. ```bash doublezero enable @@ -55,13 +55,13 @@ doublezero enable ### 1. Créer une paire de clés Solana -La CLI `doublezero-solana` utilise une paire de clés Solana standard pour la gestion des sièges onchain. Si vous n'en avez pas : +Le CLI `doublezero-solana` utilise une paire de clés Solana standard pour la gestion des sièges onchain. Si vous n'en avez pas : ```bash solana-keygen new ``` -Cela écrit dans `~/.config/solana/id.json`. Pour utiliser un chemin différent, passez `--keypair ` à n'importe quelle commande `doublezero-solana`. +Cela écrit dans `~/.config/solana/id.json`. Pour utiliser un chemin différent, passez `--keypair ` à toute commande `doublezero-solana`. Affichez l'adresse de votre portefeuille : @@ -69,12 +69,12 @@ Affichez l'adresse de votre portefeuille : solana address ``` -### 2. Approvisionner votre portefeuille +### 2. Alimenter votre portefeuille Votre portefeuille a besoin de deux jetons : - **SOL** — pour les frais de transaction Solana. Transférez des SOL vers l'adresse du portefeuille affichée ci-dessus. -- **USDC** — pour le financement du siège. La CLI prélève depuis le compte de jetons associé (ATA) de votre portefeuille pour le mint USDC mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). +- **USDC** — pour le financement du siège. Le CLI prélève depuis le compte de jetons associé (ATA) de votre portefeuille pour le mint USDC du mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). --- @@ -82,17 +82,17 @@ Votre portefeuille a besoin de deux jetons : ### 1. Trouver votre appareil le plus proche -Avant d'acheter un siège, identifiez l'appareil avec la latence la plus faible depuis votre machine : +Avant d'acheter un siège, identifiez l'appareil ayant la latence la plus faible depuis votre machine : ```bash doublezero latency ``` -Notez le code de l'appareil du résultat avec la latence la plus faible (par ex., ``). Vous l'utiliserez lors de l'achat d'un siège. +Notez le code de l'appareil avec le résultat de latence le plus faible (par ex., ``). Vous l'utiliserez lors de l'achat d'un siège. ### 2. Vérifier les tarifs -Consultez les tarifs actuels des appareils avant d'engager des fonds. La tarification comporte deux composantes : un **prix de base métro** et une **prime par appareil**. Les prix sont mis à jour à chaque epoch. Vous pouvez également consulter les tarifs et la disponibilité [ici](https://data.malbeclabs.com/dz/shreds/devices). +Consultez les tarifs actuels des appareils avant d'engager des fonds. La tarification comporte deux composantes : un **prix de base métro** et une **prime par appareil**. Vous pouvez également consulter les tarifs et la disponibilité [ici](https://data.malbeclabs.com/dz/shreds/devices). **Tous les appareils :** @@ -115,11 +115,11 @@ doublezero-solana shreds price --metro Colonnes de sortie : `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. -Le prix par epoch est le coût total par epoch pour un siège sur cet appareil (base + prime). Utilisez `--wide` pour afficher les clés publiques complètes, ou `--json` pour une sortie JSON. +Le prix par époque est le coût total par époque pour un siège sur cet appareil (base + prime). Utilisez `--wide` pour afficher les clés publiques complètes, ou `--json` pour une sortie JSON. ### 3. Acheter un siège -Achetez un siège avec une seule commande. Cela initialise votre siège, finance le séquestre et demande l'attribution : +Achetez un siège avec une seule commande. Cela initialise votre siège, alimente le séquestre et demande l'allocation : ```bash doublezero-solana shreds pay \ @@ -134,35 +134,35 @@ doublezero-solana shreds pay \ |---------|-------------| | `--device ` | Appareil cible par clé publique (mutuellement exclusif avec `--device-code`) | | `--device-code ` | Appareil cible par code lisible (par ex., ``) | -| `--client-ip ` | L'adresse IPv4 publique de votre machine | -| `--amount ` | USDC à financer (format décimal, par ex. `100` = 100 USDC). Doit atteindre le prix minimum par epoch. | -| `--source-token-account ` | Compte source USDC personnalisé (par défaut l'ATA de votre portefeuille) | -| `--accept-partial-epoch` | Ignorer l'avertissement d'epoch restante (voir ci-dessous) | +| `--client-ip ` | Adresse IPv4 publique de votre machine | +| `--amount ` | USDC à déposer (format décimal, par ex. `100` = 100 USDC). Doit atteindre le prix minimum par époque. | +| `--source-token-account ` | Compte source USDC personnalisé (par défaut, l'ATA de votre portefeuille) | +| `--accept-partial-epoch` | Ignorer l'avertissement d'époque restante (voir ci-dessous) | | `--fee-payer ` | Utiliser un portefeuille différent pour les frais de transaction SOL | | `--dry-run` | Simuler la transaction sans l'exécuter | | `--with-compute-unit-price ` | Définir un prix d'unité de calcul pour une inclusion plus rapide en cas de congestion | -Une fois votre siège attribué, le démon établit automatiquement le tunnel GRE. Vérifiez votre connexion avec : +Une fois votre siège alloué, le démon établit automatiquement le tunnel GRE. Vérifiez votre connexion avec : ```bash doublezero status ``` -### Timing des epochs +### Synchronisation des époques -Les sièges sont attribués par epoch Solana (~2 jours). S'il reste moins de 10 % de l'epoch en cours lorsque vous payez, la CLI vous avertit que votre siège sera attribué immédiatement mais ne couvre que le reste de l'epoch en cours. Un paiement séparé sera déduit de votre séquestre au début de l'epoch suivante. +Les sièges sont alloués par époque Solana (~2 jours). S'il reste moins de 10 % de l'époque en cours lorsque vous payez, le CLI vous avertit que votre siège sera alloué immédiatement mais ne couvre que le reste de l'époque en cours. Un paiement séparé sera déduit de votre séquestre au début de la prochaine époque. -!!! info "Il est conseillé de financer pour plus d'une epoch à la fois afin de ne pas perdre votre siège. Vous pouvez vérifier le temps restant dans une epoch [ici](https://explorer.solana.com/)." +!!! info "Il est conseillé de financer plus d'une époque à la fois pour ne pas perdre votre siège. Vous pouvez vérifier le temps restant dans une époque [ici](https://explorer.solana.com/)." -Vous pouvez ignorer cet avertissement avec `--accept-partial-epoch`. +Vous pouvez contourner cet avertissement avec `--accept-partial-epoch`. -### Maintenir votre séquestre approvisionné +### Maintenir votre séquestre alimenté -!!! warning "Si le solde de votre séquestre est inférieur au prix de l'epoch au moment du règlement, votre siège ne sera pas attribué, le tunnel sera démonté et vous perdrez votre ancienneté accumulée. L'ancienneté détermine votre priorité pour les epochs futures — la perdre signifie que vous êtes en concurrence comme un nouvel arrivant." +!!! warning "Si le solde de votre séquestre est inférieur au prix de l'époque lors du règlement, votre siège ne sera pas alloué, le tunnel sera démonté et vous perdrez votre ancienneté accumulée. L'ancienneté détermine votre priorité pour les époques futures — la perdre signifie que vous êtes à nouveau en compétition comme un nouveau venu." -Vous pouvez sur-approvisionner ce compte pour financer plusieurs epochs. Chaque règlement déduit le prix d'une epoch de votre séquestre, et le solde restant est reporté. Par exemple, financer 5 fois le prix par epoch maintient votre siège actif pendant jusqu'à 5 epochs sans réapprovisionnement. +Vous pouvez surfinancer ce compte pour couvrir plusieurs époques. Chaque règlement déduit le prix d'une époque de votre séquestre, et le solde restant est reporté. Par exemple, financer 5 fois le prix par époque maintient votre siège actif pendant 5 époques maximum sans refinancement. -Pour compléter votre séquestre, exécutez `shreds pay` à nouveau à tout moment : +Pour recharger votre séquestre, exécutez `shreds pay` à nouveau à tout moment : ```bash doublezero-solana shreds pay \ @@ -175,9 +175,9 @@ Notez que le `Target_IP` doit être une adresse IPv4 publique sur la machine qui ### Surveiller les sièges -Cette section détaille comment visualiser les sièges via la CLI. Vous pouvez également utiliser [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) pour surveiller les sièges et vous aider à gérer votre compte séquestre. +Cette section détaille comment visualiser les sièges via le CLI. Vous pouvez également utiliser [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) pour surveiller les sièges et vous aider à gérer votre compte séquestre. -Consultez vos sièges actifs et les soldes de séquestre : +Consultez vos sièges actifs et soldes de séquestre : **Tous vos sièges :** @@ -205,7 +205,7 @@ doublezero-solana shreds list --withdraw-authority Colonnes de sortie : `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. -La colonne « Est. Epochs Paid » indique combien d'epochs votre solde actuel couvre aux tarifs en vigueur. Si les prix changent, cette estimation s'ajuste. +La colonne « Est. Epochs Paid » indique combien d'époques votre solde actuel couvre aux tarifs actuels. Si les prix changent, cette estimation s'ajuste. ### Retirer des fonds @@ -232,14 +232,14 @@ doublezero-solana shreds withdraw \ --- -## Adresses des shreds (IP vs Port) +## Adresses de shreds (IP vs Port) -Les shreds de leader et les shreds de retransmission à haute participation arriveront sur le port `7733`, via l'interface `doublezero1`. L'interface `doublezero0` est destinée au trafic unicast. Le port `5765` est un moniteur de battement de cœur des éditeurs de shreds — il ne contiendra pas de shreds. +Les shreds de leader et les shreds de retransmission à fort enjeu arriveront sur le port `7733`, via l'interface `doublezero1`. L'interface `doublezero0` est destinée au trafic unicast. Le port `5765` est un moniteur de battement de cœur des éditeurs de shreds — il ne contiendra pas de shreds. -Pour la consommation des shreds, l'**adresse IP** identifie le flux multicast et le **port** identifie le service UDP sur ce flux. +Pour la consommation de shreds, l'**adresse IP** identifie le flux multicast et le **port** identifie le service UDP sur ce flux. Tous les flux de shreds ci-dessous utilisent le port UDP `7733` sur `doublezero1`. -Vous pouvez examiner les IP de n'importe quel groupe multicast avec : +Vous pouvez examiner les IPs de tout groupe multicast avec : ```bash doublezero multicast group list @@ -249,7 +249,7 @@ doublezero multicast group list - `edge-solana-shreds`: `233.84.178.1:7733` -### Shreds de racine +### Shreds root - `edge-solana-root`: `233.84.178.16:7733` @@ -262,7 +262,7 @@ doublezero multicast group list ## En-tête du tunnel GRE — XDP -!!! note "Le trafic de shreds livré sur le réseau est encapsulé en GRE. Vous devrez peut-être supprimer l'en-tête GRE avant d'injecter les données dans votre pipeline existant (par ex. un deshredder basé sur XDP)." +!!! note "Le trafic de shreds livré sur le réseau est encapsulé en GRE. Vous devrez peut-être retirer l'en-tête GRE avant d'alimenter les données dans votre pipeline existant (par ex. un deshredder basé sur XDP)." --- @@ -270,13 +270,13 @@ doublezero multicast group list ### [Tableau des scores Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) -Le tableau des scores compare la vitesse de livraison des shreds entre DoubleZero Edge et d'autres fournisseurs, en utilisant des données au niveau des slots pour comparer les performances en temps réel. Utilisez ce tableau de bord pour voir les taux de victoire des shreds Edge par rapport aux autres fournisseurs. Vous pouvez consulter les résultats pour les shreds de leader uniquement, en plus de la comparaison du flux complet. Vous pouvez également explorer par région pour voir les performances attendues. +Le tableau des scores compare la vitesse de livraison des shreds entre DoubleZero Edge et d'autres fournisseurs, en utilisant des données au niveau des slots pour comparer les performances en temps réel. Utilisez ce tableau de bord pour voir les taux de victoire des shreds Edge par rapport aux autres fournisseurs. Vous pouvez consulter les résultats uniquement pour les shreds de leader, en plus de la comparaison du flux complet. Vous pouvez également affiner par région pour voir les performances attendues. ### [Éditeurs Edge](https://data.malbeclabs.com/dz/shreds/publishers) -La métrique « Publishing Shreds » en haut à gauche du tableau de bord affiche le pourcentage total du poids de participation de tous les validateurs Solana publiant des shreds de leader sur DoubleZero Edge. Vous pouvez voir les détails de chaque éditeur sur le réseau. +La métrique « Publishing Shreds » en haut à gauche du tableau de bord affiche le pourcentage total du poids de stake de tous les validateurs Solana publiant des shreds de leader sur DoubleZero Edge. Vous pouvez voir les détails de chaque éditeur sur le réseau. -### [Abonnés, appareils et activité Edge](https://data.malbeclabs.com/dz/shreds/subscribers) +### [Abonnés Edge, appareils et activité](https://data.malbeclabs.com/dz/shreds/subscribers) Vous pouvez facilement rechercher votre IP client sur cette page pour les sièges souscrits et consulter le statut. Cliquez sur des abonnements de sièges spécifiques pour voir l'historique des paiements et l'activité. Vous pouvez également consulter les appareils disponibles sur la page [Appareils](https://data.malbeclabs.com/dz/shreds/devices) et toute l'activité récente sur la page [Activité](https://data.malbeclabs.com/dz/shreds/activity). @@ -288,7 +288,7 @@ Pour un accès programmatique aux points de terminaison de données, consultez l ## Dépannage -Si vous rencontrez un problème non couvert ici, veuillez nous contacter via votre canal existant avant de chercher une solution de contournement. Si vous n'avez pas de canal, veuillez rechercher sur [Discord](https://discord.gg/U2fEb4Jq) et ouvrir un ticket si nécessaire. +Si vous rencontrez un problème non couvert ici, veuillez nous contacter via votre canal existant avant de tenter un contournement. Si vous n'avez pas de canal, veuillez rechercher sur [Discord](https://discord.gg/U2fEb4Jq) et ouvrir un ticket si nécessaire. ### Assurez-vous que votre client est à jour : @@ -296,12 +296,12 @@ Exécutez : `sudo apt update && sudo apt install doublezero-solana` ### Solde de séquestre insuffisant -Si le solde de votre séquestre est inférieur au prix de l'epoch au moment du règlement, le siège n'est pas attribué, le tunnel est démonté et l'ancienneté est perdue. Complétez avec `shreds pay` avant le prochain règlement. +Si le solde de votre séquestre est inférieur au prix de l'époque lors du règlement, le siège n'est pas alloué, le tunnel est démonté et l'ancienneté est perdue. Rechargez avec `shreds pay` avant le prochain règlement. -### Siège non attribué après paiement +### Siège non alloué après paiement -- Vous avez peut-être payé tard dans l'epoch — le siège prend effet à l'epoch suivante. -- Tous les sièges sur l'appareil peuvent être occupés par des titulaires ayant une ancienneté supérieure. Vérifiez les sièges disponibles avec `shreds price`. +- Vous avez peut-être payé tard dans l'époque — le siège prend effet à l'époque suivante. +- Tous les sièges de l'appareil peuvent être occupés par des titulaires ayant une ancienneté plus élevée. Vérifiez les sièges disponibles avec `shreds price`. - Si vous avez retiré avant le règlement, le siège n'était pas éligible. ### Le tunnel ne s'établit pas @@ -309,22 +309,22 @@ Si le solde de votre séquestre est inférieur au prix de l'epoch au moment du r 1. Vérifiez que le démon est en cours d'exécution : `sudo systemctl status doublezerod` 2. Vérifiez que le réconciliateur est activé : `doublezero enable` 3. Vérifiez que les règles de pare-feu sont en place (GRE, BGP, PIM, trafic de shreds sur `doublezero1`, port 44880 sur `doublezero0`) -4. Vérifiez que votre siège est actif pour l'epoch en cours : `doublezero-solana shreds list` +4. Vérifiez que votre siège est actif pour l'époque en cours : `doublezero-solana shreds list` 5. Vérifiez l'état de votre connexion : `doublezero status` L'IP client du démon est découverte automatiquement à partir de l'IP publique de votre hôte — vérifiez qu'elle correspond au `--client-ip` utilisé dans vos commandes de siège. -### Avertissement de prompt d'epoch +### Avertissement d'époque -La CLI vous avertit lorsqu'il reste moins de 10 % de l'epoch. Vos options : +Le CLI avertit lorsqu'il reste moins de 10 % de l'époque. Vos options : - Accepter avec `--accept-partial-epoch` si vous voulez le siège immédiatement -- Attendre l'epoch suivante pour obtenir une couverture complète d'epoch +- Attendre la prochaine époque pour obtenir une couverture d'époque complète ### « Amount is below the current price » -La commande `pay` valide votre montant par rapport au prix minimum par epoch (base métro + prime appareil). Utilisez `shreds price` pour vérifier les tarifs actuels et augmenter votre montant. +La commande `pay` valide votre montant par rapport au prix minimum par époque (base métro + prime appareil). Utilisez `shreds price` pour vérifier les tarifs actuels et augmenter votre montant. ### « Multicast user already exists » -Vous avez déjà un abonnement actif via un chemin différent. Déconnectez-vous d'abord avec `doublezero disconnect`, puis réessayez `shreds pay`. \ No newline at end of file +Vous avez déjà un abonnement actif via un autre chemin. Déconnectez-vous d'abord avec `doublezero disconnect`, puis réessayez `shreds pay`. \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.it.md b/docs/Edge Subscriber Connection.it.md index a20aaf5..99efb1b 100644 --- a/docs/Edge Subscriber Connection.it.md +++ b/docs/Edge Subscriber Connection.it.md @@ -1,19 +1,19 @@ --- -description: Configura un edge subscriber per ricevere i feed di shred DoubleZero, inclusa la configurazione del client e le regole firewall per GRE, BGP, PIM e il traffico shred. +description: Configura un edge subscriber per ricevere i feed di shred di DoubleZero, inclusa la configurazione del client e le regole del firewall per GRE, BGP, PIM e il traffico shred. --- # Connessione Edge Subscriber -!!! warning "Connettendomi a DoubleZero accetto i [Termini di Utilizzo di DoubleZero](https://doublezero.xyz/terms-protocol). Si prega di notare che i dati sono esclusivamente per uso interno e non possono essere ritrasmessi (vedere Sezione 2(e))." +!!! warning "Connettendomi a DoubleZero accetto i [Termini di utilizzo di DoubleZero](https://doublezero.xyz/terms-protocol). Si prega di notare che i dati sono esclusivamente per uso interno e non possono essere ritrasmessi (vedi Sezione 2(e))." -## Passaggio 1: Configurazione DoubleZero +## Passo 1: Configurazione di DoubleZero -### 1. Completare la Configurazione +### 1. Completare la configurazione Installa la [Solana CLI](https://docs.anza.xyz/cli/install). Segui le istruzioni di [configurazione](setup.md) per installare e configurare il client DoubleZero. -Se hai già configurato DoubleZero in precedenza, assicurati di avere l'ultima versione della CLI Doublezero-Solana con `sudo apt update && sudo apt install doublezero-solana` +Se hai precedentemente configurato DoubleZero, assicurati di avere l'ultima versione della Doublezero-Solana CLI con `sudo apt update && sudo apt install doublezero-solana` ### 2. Configurare il Firewall @@ -43,7 +43,7 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. Abilitare il Reconciler -Il reconciler monitora lo stato onchain e provisiona automaticamente i tunnel quando il tuo seat viene allocato. Non è abilitato di default. +Il reconciler monitora lo stato onchain e provvede automaticamente ai tunnel quando il tuo seat viene allocato. Non è abilitato di default. ```bash doublezero enable @@ -51,11 +51,11 @@ doublezero enable --- -## Passaggio 2: Configurare il Wallet +## Passo 2: Configurare il Wallet ### 1. Creare una Keypair Solana -La CLI `doublezero-solana` utilizza una keypair Solana standard per la gestione dei seat onchain. Se non ne hai una: +La CLI `doublezero-solana` utilizza una keypair Solana standard per la gestione dei seat onchain. Se non ne possiedi una: ```bash solana-keygen new @@ -73,14 +73,14 @@ solana address Il tuo wallet necessita di due token: -- **SOL** — per le commissioni di transazione Solana. Trasferisci SOL all'indirizzo del wallet stampato sopra. +- **SOL** — per le commissioni delle transazioni Solana. Trasferisci SOL all'indirizzo del wallet stampato sopra. - **USDC** — per il finanziamento del seat. La CLI preleva dall'Associated Token Account (ATA) del tuo wallet per il mint USDC mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). --- -## Passaggio 3: Acquistare un Seat +## Passo 3: Acquistare un Seat -### 1. Trovare il Dispositivo Più Vicino +### 1. Trovare il Dispositivo più Vicino Prima di acquistare un seat, identifica il dispositivo con la latenza più bassa dalla tua macchina: @@ -88,11 +88,11 @@ Prima di acquistare un seat, identifica il dispositivo con la latenza più bassa doublezero latency ``` -Annota il codice del dispositivo dal risultato con la latenza più bassa (es., ``). Lo utilizzerai per l'acquisto di un seat. +Prendi nota del codice dispositivo dal risultato con la latenza più bassa (es. ``). Lo utilizzerai al momento dell'acquisto di un seat. ### 2. Verificare i Prezzi -Visualizza i prezzi correnti del dispositivo prima di impegnare fondi. I prezzi hanno due componenti: un **prezzo base della metro** e un **premium per dispositivo**. I prezzi si aggiornano ad ogni epoch. Puoi anche visualizzare prezzi e disponibilità [qui](https://data.malbeclabs.com/dz/shreds/devices). +Visualizza i prezzi attuali dei dispositivi prima di impegnare fondi. I prezzi hanno due componenti: un **prezzo base metro** e un **premium per dispositivo**. Puoi anche visualizzare prezzi e disponibilità [qui](https://data.malbeclabs.com/dz/shreds/devices). **Tutti i dispositivi:** @@ -107,15 +107,15 @@ doublezero-solana shreds price --device-code doublezero-solana shreds price --device ``` -**Tutti i dispositivi in una metro:** +**Tutti i dispositivi in un metro:** ```bash doublezero-solana shreds price --metro ``` -Colonne dell'output: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. +Colonne di output: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. -Il prezzo epoch è il costo totale per epoch per un seat su quel dispositivo (base + premium). Usa `--wide` per mostrare le pubkey complete, o `--json` per output JSON. +Il prezzo per epoch è il costo totale per epoch di un seat su quel dispositivo (base + premium). Usa `--wide` per mostrare le pubkey complete, o `--json` per l'output in formato JSON. ### 3. Acquistare un Seat @@ -132,37 +132,37 @@ doublezero-solana shreds pay \ | Flag | Descrizione | |------|-------------| -| `--device ` | Dispositivo di destinazione tramite chiave pubblica (mutuamente esclusivo con `--device-code`) | -| `--device-code ` | Dispositivo di destinazione tramite codice leggibile (es., ``) | +| `--device ` | Dispositivo target tramite chiave pubblica (mutuamente esclusivo con `--device-code`) | +| `--device-code ` | Dispositivo target tramite codice leggibile (es. ``) | | `--client-ip ` | L'indirizzo IPv4 pubblico della tua macchina | | `--amount ` | USDC da finanziare (formato decimale, es. `100` = 100 USDC). Deve soddisfare il prezzo minimo per epoch. | -| `--source-token-account ` | Account sorgente USDC personalizzato (predefinito: ATA del tuo wallet) | -| `--accept-partial-epoch` | Salta l'avviso sull'epoch rimanente (vedi sotto) | -| `--fee-payer ` | Usa un wallet diverso per le commissioni di transazione SOL | +| `--source-token-account ` | Account sorgente USDC personalizzato (default: ATA del tuo wallet) | +| `--accept-partial-epoch` | Salta l'avviso di epoch rimanente (vedi sotto) | +| `--fee-payer ` | Usa un wallet diverso per le commissioni delle transazioni SOL | | `--dry-run` | Simula la transazione senza eseguirla | -| `--with-compute-unit-price ` | Imposta un prezzo per unità di calcolo per un'inclusione più rapida durante la congestione | +| `--with-compute-unit-price ` | Imposta un prezzo per compute unit per un'inclusione più rapida durante la congestione | -Una volta che il tuo seat è allocato, il daemon stabilisce il tunnel GRE automaticamente. Verifica la tua connessione con: +Una volta allocato il tuo seat, il daemon stabilisce automaticamente il tunnel GRE. Verifica la tua connessione con: ```bash doublezero status ``` -### Tempistiche dell'Epoch +### Tempistica degli Epoch -I seat vengono allocati per epoch Solana (~2 giorni). Se rimane meno del 10% dell'epoch corrente quando paghi, la CLI avvisa che il tuo seat verrà allocato immediatamente ma copre solo il resto dell'epoch corrente. Un pagamento separato verrà detratto dal tuo escrow quando inizia l'epoch successivo. +I seat vengono allocati per epoch Solana (~2 giorni). Se rimane meno del 10% dell'epoch corrente al momento del pagamento, la CLI avvisa che il tuo seat verrà allocato immediatamente ma coprirà solo il resto dell'epoch corrente. Un pagamento separato verrà detratto dal tuo escrow all'inizio dell'epoch successivo. !!! info "È consigliabile finanziare per più di 1 epoch alla volta per non perdere il proprio seat. Puoi verificare il tempo rimanente in un epoch [qui](https://explorer.solana.com/)." Puoi ignorare questo avviso con `--accept-partial-epoch`. -### Mantenere il Proprio Escrow Finanziato +### Mantenere l'Escrow Finanziato -!!! warning "Se il saldo del tuo escrow è inferiore al prezzo epoch al momento del settlement, il tuo seat non verrà allocato, il tunnel verrà dismesso e perderai la tenure accumulata. La tenure determina la tua priorità per gli epoch futuri — perderla significa competere nuovamente come nuovo arrivato." +!!! warning "Se il saldo del tuo escrow è inferiore al prezzo dell'epoch al momento del settlement, il tuo seat non verrà allocato, il tunnel verrà dismesso e perderai la tenure accumulata. La tenure determina la tua priorità per gli epoch futuri — perderla significa competere nuovamente come nuovo arrivato." -Puoi sovraccaricare questo account per finanziare più epoch. Ogni settlement detrae il prezzo di un epoch dal tuo escrow, e il saldo rimanente viene riportato. Ad esempio, finanziare 5 volte il prezzo per epoch mantiene il tuo seat attivo fino a 5 epoch senza ri-finanziare. +Puoi sovrafinanziare questo account per coprire più epoch. Ogni settlement detrae il prezzo di un epoch dal tuo escrow, e il saldo rimanente viene riportato. Ad esempio, finanziare 5 volte il prezzo per epoch mantiene il tuo seat attivo fino a 5 epoch senza necessità di rifinanziamento. -Per ricaricare il tuo escrow, esegui di nuovo `shreds pay` in qualsiasi momento: +Per ricaricare il tuo escrow, esegui `shreds pay` in qualsiasi momento: ```bash doublezero-solana shreds pay \ @@ -171,11 +171,11 @@ doublezero-solana shreds pay \ --amount 500 ``` -Nota che il `Target_IP` deve essere un indirizzo ipv4 pubblico sulla macchina che riceverà gli shred. Puoi trovarlo eseguendo un comando come `curl -4 ifconfig.me` sulla macchina di destinazione. +Nota che il `Target_IP` deve essere un indirizzo IPv4 pubblico sulla macchina che riceverà gli shred. Puoi trovarlo eseguendo un comando come `curl -4 ifconfig.me` sulla macchina target. ### Monitorare i Seat -Questa sezione descrive come visualizzare i seat tramite la CLI. Puoi anche utilizzare [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) per monitorare i seat e assistere nella gestione del tuo account escrow. +Questa sezione descrive come visualizzare i seat tramite la CLI. Puoi anche usare [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) per monitorare i seat e assistere nella gestione del tuo account escrow. Visualizza i tuoi seat attivi e i saldi escrow: @@ -203,13 +203,13 @@ doublezero-solana shreds list --client-ip doublezero-solana shreds list --withdraw-authority ``` -Colonne dell'output: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. +Colonne di output: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. -La colonna "Est. Epochs Paid" mostra quanti epoch copre il tuo saldo attuale ai prezzi correnti. Se i prezzi cambiano, questa stima si adegua. +La colonna "Est. Epochs Paid" mostra quanti epoch copre il tuo saldo attuale ai prezzi correnti. Se i prezzi cambiano, questa stima si aggiorna. ### Prelevare Fondi -Chiudi il tuo escrow e rimborsa gli USDC rimanenti al tuo wallet: +Chiudi il tuo escrow e ricevi il rimborso degli USDC rimanenti sul tuo wallet: ```bash doublezero-solana shreds withdraw \ @@ -234,10 +234,10 @@ doublezero-solana shreds withdraw \ ## Indirizzi Shred (IP vs Porta) -Gli Shred Leader e gli Shred Retransmit ad alto stake arriveranno sulla porta `7733`, tramite l'interfaccia `doublezero1`. L'interfaccia `doublezero0` è per il traffico unicast. La porta `5765` è un monitor heartbeat dai publisher di shred — non conterrà shred. +I Leader Shred e i Retransmit Shred ad alto stake arriveranno sulla porta `7733`, tramite l'interfaccia `doublezero1`. L'interfaccia `doublezero0` è per il traffico unicast. La porta `5765` è un monitor heartbeat dagli shred publisher — non conterrà shred. Per il consumo degli shred, l'**indirizzo IP** identifica lo stream multicast e la **porta** identifica il servizio UDP su quello stream. -Tutti gli stream shred sottostanti utilizzano la porta UDP `7733` su `doublezero1`. +Tutti gli stream shred seguenti utilizzano la porta UDP `7733` su `doublezero1`. Puoi esaminare gli IP di qualsiasi gruppo multicast con: @@ -245,15 +245,15 @@ Puoi esaminare gli IP di qualsiasi gruppo multicast con: doublezero multicast group list ``` -### Shred Leader +### Leader Shred - `edge-solana-shreds`: `233.84.178.1:7733` -### Shred Root +### Root Shred - `edge-solana-root`: `233.84.178.16:7733` -### Shred Retransmit +### Retransmit Shred - `edge-solana-retrans-eu`: `233.84.178.12:7733` - `edge-solana-retrans-apac`: `233.84.178.13:7733` @@ -262,7 +262,7 @@ doublezero multicast group list ## Header del Tunnel GRE — XDP -!!! note "Il traffico shred consegnato sulla rete è incapsulato in GRE. Potrebbe essere necessario rimuovere l'header GRE prima di inviare i dati alla pipeline esistente (es. un deshredder basato su XDP)." +!!! note "Il traffico shred consegnato attraverso la rete è incapsulato in GRE. Potrebbe essere necessario rimuovere l'header GRE prima di alimentare i dati nella tua pipeline esistente (es. un deshredder basato su XDP)." --- @@ -270,25 +270,25 @@ doublezero multicast group list ### [Edge Scoreboard](https://data.malbeclabs.com/dz/shreds/scoreboard) -Lo Scoreboard confronta la velocità di consegna degli shred tra DoubleZero Edge e altri provider, utilizzando dati a livello di slot per confrontare le prestazioni in tempo reale. Usa questa dashboard per visualizzare le percentuali di vittoria degli shred Edge rispetto ad altri provider. Puoi visualizzare i risultati solo per gli shred leader, oltre al confronto del feed completo. Puoi anche approfondire per regione per vedere le prestazioni attese. +Lo Scoreboard confronta la velocità di consegna degli shred tra DoubleZero Edge e altri provider, utilizzando dati a livello di slot per comparare le prestazioni in tempo reale. Usa questa dashboard per visualizzare i tassi di vittoria degli shred Edge rispetto ad altri provider. Puoi visualizzare i risultati solo per i leader shred, oltre al confronto del feed completo. Puoi anche approfondire per regione per vedere le prestazioni attese. ### [Edge Publishers](https://data.malbeclabs.com/dz/shreds/publishers) -La metrica "Publishing Shreds" in alto a sinistra della dashboard mostra la percentuale totale del peso di stake di tutti i validatori Solana che pubblicano shred leader su DoubleZero Edge. Puoi visualizzare i dettagli per ogni publisher sulla rete. +La metrica "Publishing Shreds" in alto a sinistra della dashboard mostra la percentuale totale di stake weight di tutti i validatori Solana che pubblicano leader shred su DoubleZero Edge. Puoi vedere i dettagli di ciascun publisher sulla rete. ### [Edge Subscribers, Dispositivi e Attività](https://data.malbeclabs.com/dz/shreds/subscribers) -Puoi facilmente cercare il tuo Client IP su questa pagina per i seat sottoscritti e visualizzarne lo stato. Clicca sulle sottoscrizioni specifiche dei seat per visualizzare lo storico dei pagamenti e l'attività. Puoi anche visualizzare i dispositivi disponibili sulla pagina [Dispositivi](https://data.malbeclabs.com/dz/shreds/devices) e tutte le attività recenti sulla pagina [Attività](https://data.malbeclabs.com/dz/shreds/activity). +Puoi facilmente cercare il tuo Client IP su questa pagina per i seat sottoscritti e visualizzarne lo stato. Clicca sulle specifiche sottoscrizioni dei seat per visualizzare lo storico dei pagamenti e l'attività. Puoi anche visualizzare i dispositivi disponibili sulla pagina [Devices](https://data.malbeclabs.com/dz/shreds/devices) e tutte le attività recenti sulla pagina [Activity](https://data.malbeclabs.com/dz/shreds/activity). ### Documentazione API Dati -Per l'accesso programmatico agli endpoint dei dati, consulta la documentazione API: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). +Per l'accesso programmatico agli endpoint dati, consulta la documentazione API: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). --- ## Risoluzione dei Problemi -Se riscontri un problema non trattato qui, contattaci tramite il tuo canale esistente prima di cercare soluzioni alternative. Se non hai un canale, cerca su [Discord](https://discord.gg/U2fEb4Jq) e apri un ticket se necessario. +Se riscontri un problema non trattato qui, contattaci attraverso il tuo canale esistente prima di cercare soluzioni alternative. Se non disponi di un canale, cerca su [Discord](https://discord.gg/U2fEb4Jq) e apri un ticket se necessario. ### Assicurati che il tuo Client sia aggiornato: @@ -296,11 +296,11 @@ Esegui: `sudo apt update && sudo apt install doublezero-solana` ### Saldo escrow insufficiente -Se il saldo del tuo escrow è inferiore al prezzo epoch al momento del settlement, il seat non viene allocato, il tunnel viene dismesso e la tenure viene persa. Ricarica con `shreds pay` prima del prossimo settlement. +Se il saldo del tuo escrow è inferiore al prezzo dell'epoch al momento del settlement, il seat non viene allocato, il tunnel viene dismesso e la tenure viene persa. Ricarica con `shreds pay` prima del prossimo settlement. ### Seat non allocato dopo il pagamento -- Potresti aver pagato in ritardo nell'epoch — il seat entra in vigore nell'epoch successivo. +- Potresti aver pagato tardi nell'epoch — il seat diventa effettivo dall'epoch successivo. - Tutti i seat sul dispositivo potrebbero essere occupati da incumbent con tenure superiore. Verifica i seat disponibili con `shreds price`. - Se hai prelevato prima del settlement, il seat non era idoneo. @@ -310,20 +310,20 @@ Se il saldo del tuo escrow è inferiore al prezzo epoch al momento del settlemen 2. Verifica che il reconciler sia abilitato: `doublezero enable` 3. Verifica che le regole del firewall siano configurate (GRE, BGP, PIM, traffico shred su `doublezero1`, porta 44880 su `doublezero0`) 4. Verifica che il tuo seat sia attivo per l'epoch corrente: `doublezero-solana shreds list` -5. Controlla lo stato della connessione: `doublezero status` +5. Controlla lo stato della tua connessione: `doublezero status` L'IP client del daemon viene scoperto automaticamente dall'IP pubblico del tuo host — verifica che corrisponda al `--client-ip` utilizzato nei comandi del seat. -### Avviso relativo all'epoch +### Avviso di epoch -La CLI avvisa quando rimane meno del 10% dell'epoch. Le tue opzioni sono: +La CLI avvisa quando rimane meno del 10% dell'epoch. Le tue opzioni: -- Accettare con `--accept-partial-epoch` se vuoi il seat immediatamente -- Attendere il prossimo epoch per ottenere una copertura completa dell'epoch +- Accetta con `--accept-partial-epoch` se vuoi il seat immediatamente +- Attendi l'epoch successivo per ottenere una copertura completa dell'epoch ### "Amount is below the current price" -Il comando `pay` valida l'importo rispetto al prezzo minimo per epoch (base metro + premium dispositivo). Usa `shreds price` per verificare i prezzi correnti e aumenta l'importo. +Il comando `pay` valida l'importo rispetto al prezzo minimo per epoch (base metro + premium dispositivo). Usa `shreds price` per verificare i prezzi attuali e aumenta il tuo importo. ### "Multicast user already exists" diff --git a/docs/Edge Subscriber Connection.ja.md b/docs/Edge Subscriber Connection.ja.md index eac76a9..52f6b6e 100644 --- a/docs/Edge Subscriber Connection.ja.md +++ b/docs/Edge Subscriber Connection.ja.md @@ -1,19 +1,19 @@ --- -description: DoubleZero シュレッドフィードを受信するためのエッジサブスクライバーのセットアップ（クライアント設定、GRE・BGP・PIM・シュレッドトラフィック用ファイアウォールルールを含む）。 +description: DoubleZero シュレッドフィードを受信するためのエッジサブスクライバーのセットアップ方法。クライアントのセットアップや GRE、BGP、PIM、シュレッドトラフィック用のファイアウォールルールを含みます。 --- # エッジサブスクライバー接続 -!!! warning "DoubleZero に接続することで、[DoubleZero 利用規約](https://doublezero.xyz/terms-protocol)に同意したものとみなされます。データは社内目的のみに使用可能であり、再送信することはできません（セクション 2(e) を参照）。" +!!! warning "DoubleZero に接続することにより、[DoubleZero 利用規約](https://doublezero.xyz/terms-protocol)に同意したものとみなされます。データはお客様の内部利用目的に限られ、再送信は許可されていません（セクション 2(e) を参照）。" -## ステップ 1: DoubleZero セットアップ +## ステップ 1: DoubleZero のセットアップ ### 1. セットアップの完了 [Solana CLI](https://docs.anza.xyz/cli/install) をインストールします。 -[セットアップ](setup.md)の手順に従って、DoubleZero クライアントをインストール・設定します。 +[セットアップ](setup.md)の手順に従って、DoubleZero クライアントをインストールおよび設定します。 -以前に DoubleZero をセットアップ済みの場合は、`sudo apt update && sudo apt install doublezero-solana` で最新の Doublezero-Solana CLI に更新してください。 +以前に DoubleZero をセットアップしたことがある場合は、`sudo apt update && sudo apt install doublezero-solana` で最新の Doublezero-Solana CLI をインストールしてください。 ### 2. ファイアウォールの設定 @@ -43,7 +43,7 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. リコンサイラーの有効化 -リコンサイラーはオンチェーン状態を監視し、シートが割り当てられたときに自動的にトンネルをプロビジョニングします。デフォルトでは有効になっていません。 +リコンサイラーはオンチェーンの状態を監視し、シートが割り当てられると自動的にトンネルをプロビジョニングします。デフォルトでは有効になっていません。 ```bash doublezero enable @@ -55,15 +55,15 @@ doublezero enable ### 1. Solana キーペアの作成 -`doublezero-solana` CLI は、オンチェーンシート管理に標準的な Solana キーペアを使用します。キーペアをお持ちでない場合： +`doublezero-solana` CLI は、オンチェーンのシート管理に標準的な Solana キーペアを使用します。まだお持ちでない場合： ```bash solana-keygen new ``` -これにより `~/.config/solana/id.json` に書き込まれます。別のパスを使用する場合は、`doublezero-solana` コマンドに `--keypair ` を渡してください。 +これにより `~/.config/solana/id.json` に書き込まれます。別のパスを使用する場合は、任意の `doublezero-solana` コマンドに `--keypair ` を渡してください。 -ウォレットアドレスを表示するには： +ウォレットアドレスを表示します： ```bash solana address @@ -73,7 +73,7 @@ solana address ウォレットには 2 種類のトークンが必要です： -- **SOL** — Solana トランザクション手数料用。上記で表示されたウォレットアドレスに SOL を送金してください。 +- **SOL** — Solana のトランザクション手数料用。上記で表示されたウォレットアドレスに SOL を送金してください。 - **USDC** — シートの資金用。CLI はメインネット USDC ミント（`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`）のウォレットの Associated Token Account（ATA）から引き出します。 --- @@ -82,17 +82,17 @@ solana address ### 1. 最寄りのデバイスを見つける -シートを購入する前に、お使いのマシンからのレイテンシが最も低いデバイスを特定します： +シートを購入する前に、お使いのマシンから最も低レイテンシーのデバイスを特定します： ```bash doublezero latency ``` -最も低いレイテンシの結果からデバイスコードをメモしてください（例：``）。シート購入時にこれを使用します。 +最低レイテンシーの結果からデバイスコードをメモしてください（例：``）。シートの購入時にこれを使用します。 ### 2. 価格の確認 -資金を投入する前に、現在のデバイス価格を確認してください。価格は **基本メトロ価格** と **デバイスごとのプレミアム** の 2 つの要素で構成されます。価格はエポックごとに更新されます。価格と空き状況は[こちら](https://data.malbeclabs.com/dz/shreds/devices)でも確認できます。 +資金を投入する前に、現在のデバイス価格を確認します。価格は **基本メトロ価格** と **デバイスごとのプレミアム** の 2 つの要素で構成されます。価格と空き状況は[こちら](https://data.malbeclabs.com/dz/shreds/devices)でも確認できます。 **全デバイス：** @@ -113,13 +113,13 @@ doublezero-solana shreds price --device doublezero-solana shreds price --metro ``` -出力カラム：`Device Code`、`Metro Code`、`Metro Name`、`Status`、`Settled Seats`、`Available Seats`、`Base Price (USDC)`、`Premium (USDC)`、`Epoch Price (USDC)`。 +出力列：`Device Code`、`Metro Code`、`Metro Name`、`Status`、`Settled Seats`、`Available Seats`、`Base Price (USDC)`、`Premium (USDC)`、`Epoch Price (USDC)`。 -エポック価格は、そのデバイスのシートあたりのエポックごとの合計コスト（基本 + プレミアム）です。`--wide` を使用すると完全な公開鍵が表示され、`--json` を使用すると JSON 出力になります。 +エポック価格は、そのデバイスのシートに対するエポックごとの合計コストです（基本 + プレミアム）。完全な公開鍵を表示するには `--wide` を、JSON 出力には `--json` を使用してください。 ### 3. シートの購入 -1 つのコマンドでシートを購入します。これによりシートの初期化、エスクローへの入金、割り当てリクエストが行われます： +1 つのコマンドでシートを購入します。これによりシートの初期化、エスクローへの入金、および割り当てリクエストが行われます： ```bash doublezero-solana shreds pay \ @@ -132,17 +132,17 @@ doublezero-solana shreds pay \ | フラグ | 説明 | |------|-------------| -| `--device ` | 公開鍵でターゲットデバイスを指定（`--device-code` と排他的） | +| `--device ` | 公開鍵でターゲットデバイスを指定（`--device-code` とは排他） | | `--device-code ` | 人間が読めるコードでターゲットデバイスを指定（例：``） | | `--client-ip ` | お使いのマシンのパブリック IPv4 アドレス | -| `--amount ` | 入金する USDC（10進数形式、例：`100` = 100 USDC）。最低エポック価格を満たす必要があります。 | +| `--amount ` | 入金する USDC（小数形式、例：`100` = 100 USDC）。最低エポック価格を満たす必要があります。 | | `--source-token-account ` | カスタム USDC ソースアカウント（デフォルトはウォレットの ATA） | | `--accept-partial-epoch` | エポック残量の警告をスキップ（下記参照） | | `--fee-payer ` | SOL トランザクション手数料に別のウォレットを使用 | | `--dry-run` | トランザクションを実行せずにシミュレーション | -| `--with-compute-unit-price ` | 混雑時に処理を高速化するためのコンピュートユニット価格を設定 | +| `--with-compute-unit-price ` | 混雑時のインクルージョンを高速化するためのコンピュートユニット価格を設定 | -シートが割り当てられると、デーモンが自動的に GRE トンネルを確立します。接続を確認するには： +シートが割り当てられると、デーモンが自動的に GRE トンネルを確立します。接続状況を確認するには： ```bash doublezero status @@ -150,19 +150,19 @@ doublezero status ### エポックのタイミング -シートは Solana エポック（約 2 日間）ごとに割り当てられます。支払い時に現在のエポックの残り時間が 10% 未満の場合、CLI はシートがすぐに割り当てられるものの、現在のエポックの残り期間のみカバーされることを警告します。次のエポック開始時にエスクローから別途支払いが差し引かれます。 +シートは Solana エポック（約 2 日間）ごとに割り当てられます。支払い時に現在のエポックの残りが 10% 未満の場合、CLI はシートが即座に割り当てられるものの、現在のエポックの残り期間のみをカバーすることを警告します。次のエポックが始まると、エスクローから別途支払いが差し引かれます。 -!!! info "シートを失わないよう、1 エポック以上の資金を入金することをお勧めします。エポックの残り時間は[こちら](https://explorer.solana.com/)で確認できます。" +!!! info "シートを失わないように、1 エポック分以上を入金しておくことをお勧めします。エポックの残り時間は[こちら](https://explorer.solana.com/)で確認できます。" -`--accept-partial-epoch` を使用してこの警告をバイパスできます。 +`--accept-partial-epoch` でこの警告をバイパスできます。 -### エスクローの資金を維持する +### エスクローの残高を維持する -!!! warning "決済時にエスクロー残高がエポック価格を下回っている場合、シートは割り当てられず、トンネルは切断され、蓄積されたテニュアが失われます。テニュアは将来のエポックでの優先順位を決定するため、テニュアを失うと新規参入者として再び競争することになります。" +!!! warning "決済時にエスクロー残高がエポック価格を下回っている場合、シートは割り当てられず、トンネルは切断され、蓄積されたテニュアが失われます。テニュアは将来のエポックにおける優先順位を決定するため、失うと新規参入者として再び競争することになります。" -複数エポック分の資金をこのアカウントに過剰入金することができます。各決済でエスクローから 1 エポック分の価格が差し引かれ、残りの残高は繰り越されます。例えば、エポックあたりの価格の 5 倍を入金すると、再入金なしで最大 5 エポック分シートがアクティブに維持されます。 +このアカウントに複数エポック分を超過入金することができます。各決済ではエスクローから 1 エポック分の価格が差し引かれ、残りの残高は繰り越されます。例えば、エポックあたりの価格の 5 倍を入金すれば、再入金なしで最大 5 エポック間シートをアクティブに保つことができます。 -エスクローに追加入金するには、いつでも `shreds pay` を再度実行してください： +エスクローを追加入金するには、いつでも `shreds pay` を再実行してください： ```bash doublezero-solana shreds pay \ @@ -175,9 +175,9 @@ doublezero-solana shreds pay \ ### シートの監視 -このセクションでは、CLI を使用してシートを表示する方法を説明します。[https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) を使用してシートの監視やエスクローアカウントの管理を支援することもできます。 +このセクションでは、CLI を使用してシートを表示する方法を説明します。[https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) を使用してシートを監視し、エスクローアカウントの管理を支援することもできます。 -アクティブなシートとエスクロー残高を表示： +アクティブなシートとエスクロー残高を表示します： **すべてのシート：** @@ -185,31 +185,31 @@ doublezero-solana shreds pay \ doublezero-solana shreds list ``` -**デバイスでフィルタ：** +**デバイスでフィルター：** ```bash doublezero-solana shreds list --device-code ``` -**クライアント IP でフィルタ：** +**クライアント IP でフィルター：** ```bash doublezero-solana shreds list --client-ip ``` -**ウォレットでフィルタ：** +**ウォレットでフィルター：** ```bash doublezero-solana shreds list --withdraw-authority ``` -出力カラム：`Device Code`、`Client IP`、`Tenure`、`Balance (USDC)`、`Est. Epochs Paid`。 +出力列：`Device Code`、`Client IP`、`Tenure`、`Balance (USDC)`、`Est. Epochs Paid`。 -「Est. Epochs Paid」カラムは、現在の価格設定で現在の残高がカバーするエポック数を表示します。価格が変更された場合、この見積もりは調整されます。 +「Est. Epochs Paid」列は、現在の価格設定で現在の残高が何エポック分をカバーするかを示します。価格が変更された場合、この見積もりは調整されます。 ### 資金の引き出し -エスクローを閉じ、残りの USDC をウォレットに返金します： +エスクローを閉じて、残りの USDC をウォレットに返金します： ```bash doublezero-solana shreds withdraw \ @@ -234,12 +234,12 @@ doublezero-solana shreds withdraw \ ## シュレッドアドレス（IP とポート） -リーダーシュレッドと高ステークのリトランスミットシュレッドは、`doublezero1` インターフェースのポート `7733` で到着します。`doublezero0` インターフェースはユニキャストトラフィック用です。ポート `5765` はシュレッドパブリッシャーからのハートビートモニターであり、シュレッドは含まれません。 +リーダーシュレッドと高ステークのリトランスミットシュレッドはポート `7733` 経由で `doublezero1` インターフェース上に到着します。`doublezero0` インターフェースはユニキャストトラフィック用です。ポート `5765` はシュレッドパブリッシャーからのハートビートモニターであり、シュレッドは含まれません。 -シュレッド消費において、**IP アドレス** はマルチキャストストリームを識別し、**ポート** はそのストリーム上の UDP サービスを識別します。 -以下のすべてのシュレッドストリームは、`doublezero1` 上の UDP ポート `7733` を使用します。 +シュレッドの消費において、**IP アドレス** はマルチキャストストリームを識別し、**ポート** はそのストリーム上の UDP サービスを識別します。 +以下のすべてのシュレッドストリームは `doublezero1` 上の UDP ポート `7733` を使用します。 -マルチキャストグループの IP は以下のコマンドで確認できます： +任意のマルチキャストグループの IP を確認するには： ```bash doublezero multicast group list @@ -262,25 +262,25 @@ doublezero multicast group list ## GRE トンネルヘッダー — XDP -!!! note "ネットワーク経由で配信されるシュレッドトラフィックは GRE カプセル化されています。既存のパイプライン（例：XDP ベースのデシュレッダー）にデータを渡す前に、GRE ヘッダーを除去する必要がある場合があります。" +!!! note "ネットワーク経由で配信されるシュレッドトラフィックは GRE カプセル化されています。既存のパイプライン（例：XDP ベースのデシュレッダー）にデータを入力する前に、GRE ヘッダーを除去する必要がある場合があります。" --- ## ツールとダッシュボード -### [Edge スコアボード](https://data.malbeclabs.com/dz/shreds/scoreboard) +### [Edge Scoreboard](https://data.malbeclabs.com/dz/shreds/scoreboard) -スコアボードは、スロットレベルのデータを使用して、DoubleZero Edge と他のプロバイダー間のシュレッド配信速度をリアルタイムで比較・ベンチマークします。このダッシュボードを使用して、他のプロバイダーに対する Edge シュレッドの勝率を確認できます。リーダーシュレッドのみの結果や、フルフィード比較を表示できます。また、リージョン別にドリルダウンして期待されるパフォーマンスを確認することもできます。 +Scoreboard は、スロットレベルのデータを使用して、DoubleZero Edge と他のプロバイダー間のシュレッド配信速度をリアルタイムで比較するベンチマークです。このダッシュボードを使用して、Edge シュレッドの他のプロバイダーに対する勝率を確認できます。リーダーシュレッドのみの結果や、フルフィードの比較を表示できます。リージョン別にドリルダウンして、期待されるパフォーマンスを確認することもできます。 -### [Edge パブリッシャー](https://data.malbeclabs.com/dz/shreds/publishers) +### [Edge Publishers](https://data.malbeclabs.com/dz/shreds/publishers) -ダッシュボード左上の「Publishing Shreds」メトリクスは、DoubleZero Edge でリーダーシュレッドを公開しているすべての Solana バリデーターの合計ステークウェイト割合を示しています。ネットワーク上の各パブリッシャーの詳細を確認できます。 +ダッシュボードの左上にある「Publishing Shreds」メトリックは、DoubleZero Edge 上でリーダーシュレッドを公開しているすべての Solana バリデーターのステークウェイトの合計パーセントを示します。ネットワーク上の各パブリッシャーの詳細を確認できます。 -### [Edge サブスクライバー、デバイス、アクティビティ](https://data.malbeclabs.com/dz/shreds/subscribers) +### [Edge Subscribers, Devices and Activity](https://data.malbeclabs.com/dz/shreds/subscribers) -このページでクライアント IP を簡単に検索し、サブスクリプション済みシートとそのステータスを確認できます。特定のシートサブスクリプションをクリックすると、支払い履歴とアクティビティを表示できます。また、[デバイス](https://data.malbeclabs.com/dz/shreds/devices)ページで利用可能なデバイスを、[アクティビティ](https://data.malbeclabs.com/dz/shreds/activity)ページで最近のすべてのアクティビティを確認できます。 +このページでクライアント IP を簡単に検索して、サブスクライブされたシートとステータスを確認できます。特定のシートサブスクリプションをクリックすると、支払い履歴とアクティビティを表示できます。利用可能なデバイスは [Devices](https://data.malbeclabs.com/dz/shreds/devices) ページで、最近のすべてのアクティビティは [Activity](https://data.malbeclabs.com/dz/shreds/activity) ページで確認できます。 -### データ API ドキュメント +### Data API ドキュメント データエンドポイントへのプログラムによるアクセスについては、API ドキュメントを参照してください：[https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs)。 @@ -288,9 +288,9 @@ doublezero multicast group list ## トラブルシューティング -ここに記載されていない問題が発生した場合は、回避策を実行する前に、既存のチャネルを通じてお問い合わせください。チャネルをお持ちでない場合は、[Discord](https://discord.gg/U2fEb4Jq) で検索し、必要に応じてチケットを作成してください。 +ここに記載されていない問題が発生した場合は、回避策を講じる前に既存のチャネルでお問い合わせください。チャネルがない場合は、[Discord](https://discord.gg/U2fEb4Jq) を検索し、必要に応じてチケットを作成してください。 -### クライアントが最新であることを確認： +### クライアントが最新であることを確認する： 実行：`sudo apt update && sudo apt install doublezero-solana` @@ -300,26 +300,26 @@ doublezero multicast group list ### 支払い後にシートが割り当てられない -- エポック後半に支払った可能性があります — シートは次のエポックから有効になります。 -- デバイスのすべてのシートが、より高いテニュアを持つ既存利用者によって占有されている可能性があります。`shreds price` で空きシートを確認してください。 -- 決済前に引き出しを行った場合、シートは対象外です。 +- エポックの遅い時期に支払った可能性があります — シートは次のエポックから有効になります。 +- デバイス上のすべてのシートが、より高いテニュアを持つ既存ユーザーによって占有されている可能性があります。`shreds price` で空きシートを確認してください。 +- 決済前に引き出しを行った場合、シートは対象外でした。 -### トンネルが起動しない +### トンネルが確立されない 1. デーモンが実行中であることを確認：`sudo systemctl status doublezerod` 2. リコンサイラーが有効であることを確認：`doublezero enable` 3. ファイアウォールルールが設定されていることを確認（GRE、BGP、PIM、`doublezero1` 上のシュレッドトラフィック、`doublezero0` 上のポート 44880） 4. 現在のエポックでシートがアクティブであることを確認：`doublezero-solana shreds list` -5. 接続状態を確認：`doublezero status` +5. 接続状況を確認：`doublezero status` -デーモンのクライアント IP はホストのパブリック IP から自動検出されます。シートコマンドで使用した `--client-ip` と一致していることを確認してください。 +デーモンのクライアント IP はホストのパブリック IP から自動検出されます — シートコマンドで使用した `--client-ip` と一致していることを確認してください。 ### エポック警告プロンプト -エポックの残り時間が 10% 未満の場合、CLI が警告を表示します。選択肢： +CLI はエポックの残りが 10% 未満の場合に警告します。選択肢は以下の通りです： -- シートをすぐに取得したい場合は `--accept-partial-epoch` で承認 -- フルエポック分のカバレッジを得るために次のエポックまで待機 +- シートをすぐに取得したい場合は `--accept-partial-epoch` で受け入れる +- フルエポック分のカバレッジを得るために次のエポックを待つ ### 「Amount is below the current price」 @@ -327,4 +327,4 @@ doublezero multicast group list ### 「Multicast user already exists」 -別の経路を通じてアクティブなサブスクリプションが既に存在します。まず `doublezero disconnect` で切断してから、`shreds pay` を再試行してください。 \ No newline at end of file +別のパスを通じてすでにアクティブなサブスクリプションがあります。まず `doublezero disconnect` で切断してから、`shreds pay` を再試行してください。 \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.ko.md b/docs/Edge Subscriber Connection.ko.md index 39808f9..8a59d5a 100644 --- a/docs/Edge Subscriber Connection.ko.md +++ b/docs/Edge Subscriber Connection.ko.md @@ -1,9 +1,9 @@ --- -description: DoubleZero 시ュレ드 피드를 수신하기 위한 엣지 구독자 설정, 클라이언트 설정 및 GRE, BGP, PIM, 시ュレ드 트래픽에 대한 방화벽 규칙 포함. +description: DoubleZero 슈레드 피드를 수신하기 위한 엣지 구독자 설정, 클라이언트 설정 및 GRE, BGP, PIM, 슈레드 트래픽에 대한 방화벽 규칙을 포함합니다. --- # 엣지 구독자 연결 -!!! warning "DoubleZero에 연결함으로써 [DoubleZero 이용약관](https://doublezero.xyz/terms-protocol)에 동의합니다. 데이터는 내부 목적으로만 사용 가능하며 재전송할 수 없습니다(섹션 2(e) 참조)." +!!! warning "DoubleZero에 연결함으로써 [DoubleZero 이용 약관](https://doublezero.xyz/terms-protocol)에 동의합니다. 데이터는 내부 목적으로만 사용 가능하며 재전송할 수 없습니다(섹션 2(e) 참조)." ## 1단계: DoubleZero 설정 @@ -13,11 +13,11 @@ description: DoubleZero 시ュレ드 피드를 수신하기 위한 엣지 구독 [설정](setup.md) 지침에 따라 DoubleZero 클라이언트를 설치하고 구성합니다. -이전에 DoubleZero를 설정한 적이 있다면, `sudo apt update && sudo apt install doublezero-solana`로 최신 Doublezero-Solana CLI가 설치되어 있는지 확인하세요. +이전에 DoubleZero를 설정한 적이 있다면, `sudo apt update && sudo apt install doublezero-solana` 명령으로 최신 Doublezero-Solana CLI가 설치되어 있는지 확인하세요. ### 2. 방화벽 구성 -GRE, BGP, PIM 및 시ュレド 트래픽을 허용합니다. +GRE, BGP, PIM 및 슈레드 트래픽을 허용합니다. **iptables:** @@ -41,9 +41,9 @@ 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. 리콘실러 활성화 +### 3. 리컨사일러 활성화 -리콘실러는 온체인 상태를 모니터링하고 시트가 할당되면 자동으로 터널을 프로비저닝합니다. 기본적으로 활성화되어 있지 않습니다. +리컨사일러는 온체인 상태를 모니터링하고 좌석이 할당되면 자동으로 터널을 프로비저닝합니다. 기본적으로 활성화되어 있지 않습니다. ```bash doublezero enable @@ -55,44 +55,44 @@ doublezero enable ### 1. Solana 키페어 생성 -`doublezero-solana` CLI는 온체인 시트 관리를 위해 표준 Solana 키페어를 사용합니다. 키페어가 없는 경우: +`doublezero-solana` CLI는 온체인 좌석 관리를 위해 표준 Solana 키페어를 사용합니다. 키페어가 없는 경우: ```bash solana-keygen new ``` -이 명령은 `~/.config/solana/id.json`에 저장합니다. 다른 경로를 사용하려면 `doublezero-solana` 명령에 `--keypair `를 전달하세요. +이 명령은 `~/.config/solana/id.json`에 파일을 생성합니다. 다른 경로를 사용하려면 `doublezero-solana` 명령에 `--keypair `를 전달하세요. -지갑 주소 출력: +지갑 주소를 출력합니다: ```bash solana address ``` -### 2. 지갑 자금 충전 +### 2. 지갑에 자금 충전 지갑에 두 가지 토큰이 필요합니다: -- **SOL** — Solana 트랜잭션 수수료용. 위에서 출력된 지갑 주소로 SOL을 전송하세요. -- **USDC** — 시트 자금 충전용. CLI는 메인넷 USDC 민트(`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)에 대한 지갑의 연관 토큰 계정(ATA)에서 자금을 가져옵니다. +- **SOL** — Solana 트랜잭션 수수료용. 위에서 출력된 지갑 주소로 SOL을 전송합니다. +- **USDC** — 좌석 자금 충전용. CLI는 메인넷 USDC 민트(`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)에 대한 지갑의 연관 토큰 계정(ATA)에서 자금을 인출합니다. --- -## 3단계: 시트 구매 +## 3단계: 좌석 구매 ### 1. 가장 가까운 장치 찾기 -시트를 구매하기 전에, 머신에서 지연 시간이 가장 낮은 장치를 확인하세요: +좌석을 구매하기 전에 머신에서 가장 낮은 지연 시간을 가진 장치를 확인합니다: ```bash doublezero latency ``` -가장 낮은 지연 시간 결과의 장치 코드를 기록하세요(예: ``). 시트 구매 시 이 코드를 사용합니다. +가장 낮은 지연 시간 결과의 장치 코드를 기록해 두세요(예: ``). 좌석 구매 시 이 코드를 사용합니다. ### 2. 가격 확인 -자금을 투입하기 전에 현재 장치 가격을 확인하세요. 가격은 **기본 메트로 가격**과 **장치별 프리미엄** 두 가지 구성 요소로 되어 있습니다. 가격은 매 에포크마다 업데이트됩니다. [여기](https://data.malbeclabs.com/dz/shreds/devices)에서 가격과 가용성을 확인할 수도 있습니다. +자금을 투입하기 전에 현재 장치 가격을 확인합니다. 가격은 **기본 메트로 가격**과 **장치별 프리미엄** 두 가지 요소로 구성됩니다. [여기](https://data.malbeclabs.com/dz/shreds/devices)에서도 가격 및 가용성을 확인할 수 있습니다. **모든 장치:** @@ -115,11 +115,11 @@ doublezero-solana shreds price --metro 출력 열: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. -에포크 가격은 해당 장치의 시트당 에포크 총 비용입니다(기본 + 프리미엄). 전체 공개 키를 표시하려면 `--wide`를, JSON 출력을 원하면 `--json`을 사용하세요. +에포크 가격은 해당 장치의 좌석당 에포크당 총 비용(기본 + 프리미엄)입니다. 전체 공개 키를 표시하려면 `--wide`를, JSON 출력을 원하면 `--json`을 사용하세요. -### 3. 시트 구매 +### 3. 좌석 구매 -단일 명령으로 시트를 구매합니다. 이 명령은 시트를 초기화하고, 에스크로에 자금을 충전하며, 할당을 요청합니다: +단일 명령으로 좌석을 구매합니다. 이 명령은 좌석을 초기화하고, 에스크로에 자금을 충전하고, 할당을 요청합니다: ```bash doublezero-solana shreds pay \ @@ -134,15 +134,15 @@ doublezero-solana shreds pay \ |------|-------------| | `--device ` | 공개 키로 대상 장치 지정 (`--device-code`와 상호 배타적) | | `--device-code ` | 사람이 읽을 수 있는 코드로 대상 장치 지정 (예: ``) | -| `--client-ip ` | 머신의 공개 IPv4 주소 | +| `--client-ip ` | 머신의 공용 IPv4 주소 | | `--amount ` | 충전할 USDC (소수점 형식, 예: `100` = 100 USDC). 최소 에포크 가격을 충족해야 합니다. | -| `--source-token-account ` | 사용자 정의 USDC 소스 계정 (기본값은 지갑의 ATA) | +| `--source-token-account ` | 사용자 지정 USDC 소스 계정 (기본값은 지갑의 ATA) | | `--accept-partial-epoch` | 에포크 잔여 경고 건너뛰기 (아래 참조) | | `--fee-payer ` | SOL 트랜잭션 수수료에 다른 지갑 사용 | -| `--dry-run` | 트랜잭션을 실행하지 않고 시뮬레이션 | -| `--with-compute-unit-price ` | 혼잡 시 더 빠른 포함을 위한 컴퓨트 유닛 가격 설정 | +| `--dry-run` | 실행하지 않고 트랜잭션 시뮬레이션 | +| `--with-compute-unit-price ` | 혼잡 시 빠른 포함을 위한 컴퓨트 유닛 가격 설정 | -시트가 할당되면 데몬이 자동으로 GRE 터널을 설정합니다. 다음 명령으로 연결을 확인하세요: +좌석이 할당되면 데몬이 자동으로 GRE 터널을 구축합니다. 다음 명령으로 연결을 확인하세요: ```bash doublezero status @@ -150,19 +150,19 @@ doublezero status ### 에포크 타이밍 -시트는 Solana 에포크(~2일)별로 할당됩니다. 결제 시 현재 에포크의 잔여 시간이 10% 미만이면, CLI는 시트가 즉시 할당되지만 현재 에포크의 나머지 기간만 커버한다는 경고를 표시합니다. 다음 에포크가 시작될 때 에스크로에서 별도의 결제가 차감됩니다. +좌석은 Solana 에포크(약 2일)별로 할당됩니다. 결제 시 현재 에포크의 10% 미만이 남아 있는 경우, CLI는 좌석이 즉시 할당되지만 현재 에포크의 나머지 기간만 적용된다는 경고를 표시합니다. 다음 에포크가 시작되면 에스크로에서 별도의 결제가 차감됩니다. -!!! info "시트를 잃지 않으려면 한 번에 1 에포크 이상의 자금을 충전하는 것이 좋습니다. [여기](https://explorer.solana.com/)에서 현재 에포크의 남은 시간을 확인할 수 있습니다." +!!! info "좌석을 잃지 않으려면 한 번에 1 에포크 이상의 자금을 충전하는 것이 좋습니다. [여기](https://explorer.solana.com/)에서 현재 에포크의 남은 시간을 확인할 수 있습니다." -`--accept-partial-epoch`로 이 경고를 무시할 수 있습니다. +`--accept-partial-epoch`를 사용하여 이 경고를 우회할 수 있습니다. ### 에스크로 자금 유지 -!!! warning "정산 시 에스크로 잔액이 에포크 가격보다 낮으면, 시트가 할당되지 않고, 터널이 해제되며, 누적된 재직 기간(tenure)을 잃게 됩니다. 재직 기간은 향후 에포크에서의 우선순위를 결정합니다 — 이를 잃으면 신규 참가자로서 다시 경쟁해야 합니다." +!!! warning "정산 시점에 에스크로 잔액이 에포크 가격보다 낮으면 좌석이 할당되지 않고, 터널이 해제되며, 누적된 재직 기간(tenure)을 잃게 됩니다. 재직 기간은 향후 에포크에서의 우선순위를 결정하므로, 잃게 되면 신규 참여자로서 다시 경쟁해야 합니다." -이 계정에 초과 충전하여 여러 에포크를 자금으로 충당할 수 있습니다. 각 정산 시 에스크로에서 1 에포크 가격이 차감되고, 나머지 잔액은 이월됩니다. 예를 들어, 에포크당 가격의 5배를 충전하면 재충전 없이 최대 5 에포크 동안 시트를 유지할 수 있습니다. +이 계정에 여러 에포크분의 자금을 초과 충전할 수 있습니다. 각 정산 시 에스크로에서 1 에포크 가격이 차감되며, 나머지 잔액은 이월됩니다. 예를 들어, 에포크당 가격의 5배를 충전하면 재충전 없이 최대 5 에포크 동안 좌석이 유지됩니다. -에스크로를 충전하려면 언제든지 `shreds pay`를 다시 실행하세요: +에스크로를 추가 충전하려면 언제든지 `shreds pay`를 다시 실행하세요: ```bash doublezero-solana shreds pay \ @@ -171,15 +171,15 @@ doublezero-solana shreds pay \ --amount 500 ``` -`Target_IP`는 シュレド를 수신할 머신의 공개 IPv4 주소여야 합니다. 대상 머신에서 `curl -4 ifconfig.me`와 같은 명령을 실행하여 확인할 수 있습니다. +`Target_IP`는 슈레드를 수신할 머신의 공용 IPv4 주소여야 합니다. 대상 머신에서 `curl -4 ifconfig.me`와 같은 명령을 실행하여 확인할 수 있습니다. -### 시트 모니터링 +### 좌석 모니터링 -이 섹션에서는 CLI를 통해 시트를 조회하는 방법을 설명합니다. [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs)를 사용하여 시트를 모니터링하고 에스크로 계정을 관리할 수도 있습니다. +이 섹션에서는 CLI를 통해 좌석을 확인하는 방법을 설명합니다. [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs)를 사용하여 좌석을 모니터링하고 에스크로 계정 관리를 지원받을 수도 있습니다. -활성 시트와 에스크로 잔액을 확인하세요: +활성 좌석 및 에스크로 잔액을 확인합니다: -**모든 시트:** +**모든 좌석:** ```bash doublezero-solana shreds list @@ -205,11 +205,11 @@ doublezero-solana shreds list --withdraw-authority 출력 열: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. -"Est. Epochs Paid" 열은 현재 가격 기준으로 현재 잔액이 커버하는 에포크 수를 보여줍니다. 가격이 변경되면 이 추정치도 조정됩니다. +"Est. Epochs Paid" 열은 현재 가격 기준으로 현재 잔액이 몇 에포크를 커버하는지 보여줍니다. 가격이 변경되면 이 추정치도 조정됩니다. ### 자금 인출 -에스크로를 종료하고 남은 USDC를 지갑으로 환불받으세요: +에스크로를 닫고 남은 USDC를 지갑으로 환불합니다: ```bash doublezero-solana shreds withdraw \ @@ -219,7 +219,7 @@ doublezero-solana shreds withdraw \ 다른 명령과 마찬가지로 `--device ` 또는 `--device-code `로 장치를 식별할 수 있습니다. -다른 토큰 계정으로 환불을 보내려면: +환불을 다른 토큰 계정으로 보내려면: ```bash doublezero-solana shreds withdraw \ @@ -228,16 +228,16 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "인출하면 시트와 누적된 재직 기간(tenure)을 잃게 됩니다." +!!! warning "인출하면 좌석과 누적된 재직 기간(tenure)을 잃게 됩니다." --- -## シュレド 주소 (IP vs 포트) +## 슈레드 주소 (IP vs 포트) -리더 시ュレド와 높은 스테이크 리트랜스밋 시ュレド는 `doublezero1` 인터페이스를 통해 포트 `7733`으로 수신됩니다. `doublezero0` 인터페이스는 유니캐스트 트래픽용입니다. 포트 `5765`는 シュレド 퍼블리셔의 하트비트 모니터로, シュレド를 포함하지 않습니다. +리더 슈레드와 고스테이크 재전송 슈레드는 `doublezero1` 인터페이스를 통해 포트 `7733`으로 도착합니다. `doublezero0` 인터페이스는 유니캐스트 트래픽용입니다. 포트 `5765`는 슈레드 퍼블리셔의 하트비트 모니터이며, 슈레드를 포함하지 않습니다. -シュレド 소비의 경우, **IP 주소**는 멀티캐스트 스트림을 식별하고 **포트**는 해당 스트림의 UDP 서비스를 식별합니다. -아래의 모든 시ュレド 스트림은 `doublezero1`에서 UDP 포트 `7733`을 사용합니다. +슈레드 소비의 경우, **IP 주소**는 멀티캐스트 스트림을 식별하고 **포트**는 해당 스트림의 UDP 서비스를 식별합니다. +아래의 모든 슈레드 스트림은 `doublezero1`에서 UDP 포트 `7733`을 사용합니다. 다음 명령으로 멀티캐스트 그룹의 IP를 확인할 수 있습니다: @@ -245,15 +245,15 @@ doublezero-solana shreds withdraw \ doublezero multicast group list ``` -### 리더 シュレド +### 리더 슈레드 - `edge-solana-shreds`: `233.84.178.1:7733` -### 루트 シュレド +### 루트 슈레드 - `edge-solana-root`: `233.84.178.16:7733` -### 리트랜스밋 シュレド +### 재전송 슈레드 - `edge-solana-retrans-eu`: `233.84.178.12:7733` - `edge-solana-retrans-apac`: `233.84.178.13:7733` @@ -262,7 +262,7 @@ doublezero multicast group list ## GRE 터널 헤더 — XDP -!!! note "네트워크를 통해 전달되는 시ュ레ド 트래픽은 GRE로 캡슐화되어 있습니다. 기존 파이프라인(예: XDP 기반 디シュレダ)에 데이터를 공급하기 전에 GRE 헤더를 제거해야 할 수 있습니다." +!!! note "네트워크를 통해 전달되는 슈레드 트래픽은 GRE 캡슐화되어 있습니다. 기존 파이프라인(예: XDP 기반 디슈레더)에 데이터를 전달하기 전에 GRE 헤더를 제거해야 할 수 있습니다." --- @@ -270,17 +270,17 @@ doublezero multicast group list ### [엣지 스코어보드](https://data.malbeclabs.com/dz/shreds/scoreboard) -스코어보드는 슬롯 수준 데이터를 사용하여 DoubleZero Edge와 다른 제공자 간의 シュレド 전송 속도를 실시간으로 비교 벤치마킹합니다. 이 대시보드를 사용하여 다른 제공자 대비 Edge シュレド 승률을 확인하세요. 리더 시ュレド만의 결과와 전체 피드 비교를 모두 확인할 수 있습니다. 지역별로 드릴다운하여 예상 성능을 확인할 수도 있습니다. +스코어보드는 슬롯 수준 데이터를 사용하여 DoubleZero Edge와 다른 제공업체 간의 슈레드 전달 속도를 실시간으로 비교 벤치마킹합니다. 이 대시보드를 사용하여 다른 제공업체 대비 Edge 슈레드 승률을 확인할 수 있습니다. 리더 슈레드만의 결과와 전체 피드 비교를 모두 볼 수 있습니다. 또한 지역별로 드릴다운하여 예상 성능을 확인할 수 있습니다. ### [엣지 퍼블리셔](https://data.malbeclabs.com/dz/shreds/publishers) -대시보드 왼쪽 상단의 "Publishing Shreds" 지표는 DoubleZero Edge에서 리더 시ュレド를 퍼블리싱하는 모든 Solana 밸리데이터의 총 스테이크 가중치 비율을 보여줍니다. 네트워크의 각 퍼블리셔에 대한 세부 정보를 확인할 수 있습니다. +대시보드 좌측 상단의 "Publishing Shreds" 지표는 DoubleZero Edge에서 리더 슈레드를 퍼블리싱하는 모든 Solana 밸리데이터의 총 스테이크 가중치 비율을 보여줍니다. 네트워크의 각 퍼블리셔에 대한 세부 정보를 확인할 수 있습니다. ### [엣지 구독자, 장치 및 활동](https://data.malbeclabs.com/dz/shreds/subscribers) -이 페이지에서 클라이언트 IP를 쉽게 검색하여 구독한 시트를 확인하고 상태를 볼 수 있습니다. 특정 시트 구독을 클릭하여 결제 내역과 활동을 확인하세요. [장치](https://data.malbeclabs.com/dz/shreds/devices) 페이지에서 사용 가능한 장치를, [활동](https://data.malbeclabs.com/dz/shreds/activity) 페이지에서 최근 활동을 확인할 수도 있습니다. +이 페이지에서 구독 좌석에 대한 클라이언트 IP를 쉽게 검색하고 상태를 확인할 수 있습니다. 특정 좌석 구독을 클릭하여 결제 내역 및 활동을 확인할 수 있습니다. [장치](https://data.malbeclabs.com/dz/shreds/devices) 페이지에서 사용 가능한 장치를 확인하고, [활동](https://data.malbeclabs.com/dz/shreds/activity) 페이지에서 최근 모든 활동을 확인할 수도 있습니다. -### Data API 문서 +### 데이터 API 문서 데이터 엔드포인트에 프로그래밍 방식으로 접근하려면 API 문서를 참조하세요: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). @@ -288,7 +288,7 @@ doublezero multicast group list ## 문제 해결 -여기에서 다루지 않은 문제가 발생하면, 우회 방법을 시도하기 전에 기존 채널을 통해 연락하세요. 채널이 없는 경우 [Discord](https://discord.gg/U2fEb4Jq)에서 검색하고 필요 시 티켓을 생성하세요. +여기에서 다루지 않은 문제가 발생하면, 해결을 시도하기 전에 기존 채널을 통해 문의해 주세요. 채널이 없는 경우 [Discord](https://discord.gg/U2fEb4Jq)에서 검색하고 필요한 경우 티켓을 열어 주세요. ### 클라이언트가 최신 버전인지 확인: @@ -296,35 +296,35 @@ doublezero multicast group list ### 에스크로 잔액 부족 -정산 시 에스크로 잔액이 에포크 가격보다 낮으면, 시트가 할당되지 않고, 터널이 해제되며, 재직 기간을 잃게 됩니다. 다음 정산 전에 `shreds pay`로 충전하세요. +정산 시점에 에스크로 잔액이 에포크 가격보다 낮으면 좌석이 할당되지 않고, 터널이 해제되며, 재직 기간이 상실됩니다. 다음 정산 전에 `shreds pay`로 추가 충전하세요. -### 결제 후 시트가 할당되지 않음 +### 결제 후 좌석이 할당되지 않음 -- 에포크 후반에 결제했을 수 있습니다 — 시트는 다음 에포크부터 적용됩니다. -- 해당 장치의 모든 시트가 더 높은 재직 기간을 가진 기존 사용자에게 점유되었을 수 있습니다. `shreds price`로 사용 가능한 시트를 확인하세요. -- 정산 전에 인출한 경우 시트 자격이 없습니다. +- 에포크 후반에 결제했을 수 있습니다 — 좌석은 다음 에포크에 적용됩니다. +- 장치의 모든 좌석이 재직 기간이 더 긴 기존 사용자에게 점유되었을 수 있습니다. `shreds price`로 사용 가능한 좌석을 확인하세요. +- 정산 전에 인출한 경우 좌석이 자격을 갖추지 못합니다. ### 터널이 연결되지 않음 1. 데몬이 실행 중인지 확인: `sudo systemctl status doublezerod` -2. 리콘실러가 활성화되어 있는지 확인: `doublezero enable` -3. 방화벽 규칙이 설정되어 있는지 확인 (GRE, BGP, PIM, `doublezero1`의 シュレド 트래픽, `doublezero0`의 포트 44880) -4. 현재 에포크에 시트가 활성 상태인지 확인: `doublezero-solana shreds list` +2. 리컨사일러가 활성화되어 있는지 확인: `doublezero enable` +3. 방화벽 규칙이 적용되어 있는지 확인 (GRE, BGP, PIM, `doublezero1`의 슈레드 트래픽, `doublezero0`의 포트 44880) +4. 현재 에포크에 좌석이 활성 상태인지 확인: `doublezero-solana shreds list` 5. 연결 상태 확인: `doublezero status` -데몬의 클라이언트 IP는 호스트의 공개 IP에서 자동 검색됩니다 — 시트 명령에서 사용한 `--client-ip`와 일치하는지 확인하세요. +데몬의 클라이언트 IP는 호스트의 공용 IP에서 자동으로 검색됩니다 — 좌석 명령에서 사용한 `--client-ip`와 일치하는지 확인하세요. ### 에포크 경고 프롬프트 -에포크 잔여 시간이 10% 미만일 때 CLI가 경고합니다. 선택지: +에포크의 10% 미만이 남아 있을 때 CLI가 경고합니다. 선택 사항: -- 시트를 즉시 원하면 `--accept-partial-epoch`로 수락 -- 전체 에포크 커버리지를 위해 다음 에포크까지 대기 +- 좌석을 즉시 원하면 `--accept-partial-epoch`로 수락 +- 전체 에포크를 적용받으려면 다음 에포크까지 대기 -### "금액이 현재 가격 미만입니다" +### "금액이 현재 가격보다 낮습니다" -`pay` 명령은 최소 에포크 가격(메트로 기본 + 장치 프리미엄)에 대해 금액을 검증합니다. `shreds price`로 현재 가격을 확인하고 금액을 늘리세요. +`pay` 명령은 최소 에포크 가격(메트로 기본 + 장치 프리미엄)에 대해 금액을 검증합니다. `shreds price`로 현재 가격을 확인하고 금액을 높이세요. ### "멀티캐스트 사용자가 이미 존재합니다" -다른 경로를 통한 활성 구독이 이미 있습니다. 먼저 `doublezero disconnect`로 연결을 해제한 후 `shreds pay`를 다시 시도하세요. \ No newline at end of file +다른 경로를 통해 이미 활성 구독이 있습니다. 먼저 `doublezero disconnect`로 연결을 해제한 후 `shreds pay`를 다시 시도하세요. \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.md b/docs/Edge Subscriber Connection.md index 147f7da..b7f4f59 100644 --- a/docs/Edge Subscriber Connection.md +++ b/docs/Edge Subscriber Connection.md @@ -92,7 +92,7 @@ Note the device code from the lowest-latency result (e.g., ``). You ### 2. Check Pricing -View current device pricing before committing funds. Pricing has two components: a **base metro price** and a **per-device premium**. Prices update each epoch. You can also view pricing and availability [here](https://data.malbeclabs.com/dz/shreds/devices). +View current device pricing before committing funds. Pricing has two components: a **base metro price** and a **per-device premium**. You can also view pricing and availability [here](https://data.doublezero.xyz/dz/shreds/devices). **All devices:** @@ -175,7 +175,7 @@ Note that the `Target_IP` must be a public ipv4 address on the machine which wil ### Monitor Seats -This section details how to view seats via the CLI. You may also use [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) to monitor seats, and assost in managing your escrow account. +This section details how to view seats via the CLI. You may also use [https://data.malbeclabs.com/api/v1/docs](https://data.doublezero.xyz/api/v1/docs) to monitor seats, and assost in managing your escrow account. View your active seats and escrow balances: @@ -278,11 +278,11 @@ The "Publishing Shreds" metric at the top left of the dashboard shows the total ### [Edge Subscribers, Devices and Activity](https://data.malbeclabs.com/dz/shreds/subscribers) -You can easily search your Client IP on this page for subscribed seats and view status. Click through specific seat subscriptions to view payment history and activity. You can also view available devices on the [Devices](https://data.malbeclabs.com/dz/shreds/devices) page and all recent activity on the [Activity](https://data.malbeclabs.com/dz/shreds/activity) page. +You can easily search your Client IP on this page for subscribed seats and view status. Click through specific seat subscriptions to view payment history and activity. You can also view available devices on the [Devices](https://data.doublezero.xyz/dz/shreds/devices) page and all recent activity on the [Activity](https://data.malbeclabs.com/dz/shreds/activity) page. ### Data API Docs -For programmatic access to data endpoints, see the API documentation: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). +For programmatic access to data endpoints, see the API documentation: [https://data.malbeclabs.com/api/v1/docs](https://data.doublezero.xyz/api/v1/docs). --- diff --git a/docs/Edge Subscriber Connection.pt.md b/docs/Edge Subscriber Connection.pt.md index d76c01a..7ffc99c 100644 --- a/docs/Edge Subscriber Connection.pt.md +++ b/docs/Edge Subscriber Connection.pt.md @@ -1,9 +1,9 @@ --- -description: Configure um assinante de borda para receber feeds de shreds do DoubleZero, incluindo configuração do cliente e regras de firewall para GRE, BGP, PIM e tráfego de shreds. +description: Configure um assinante de borda para receber feeds de shred do DoubleZero, incluindo configuração do cliente e regras de firewall para GRE, BGP, PIM e tráfego de shreds. --- -# Conexão de Assinante de Borda -!!! warning "Ao conectar-se ao DoubleZero, concordo com os [Termos de Uso do DoubleZero](https://doublezero.xyz/terms-protocol). Observe que os dados são apenas para seus propósitos internos e não podem ser retransmitidos (consulte a Seção 2(e))." +# Conexão do Assinante de Borda +!!! warning "Ao conectar-se ao DoubleZero, eu concordo com os [Termos de Uso do DoubleZero](https://doublezero.xyz/terms-protocol). Por favor, note que os dados são apenas para seus propósitos internos e não podem ser retransmitidos (veja a Seção 2(e))." ## Passo 1: Configuração do DoubleZero @@ -13,7 +13,7 @@ Instale o [Solana CLI](https://docs.anza.xyz/cli/install). Siga as instruções de [configuração](setup.md) para instalar e configurar o cliente DoubleZero. -Se você já configurou o DoubleZero anteriormente, certifique-se de ter o Doublezero-Solana CLI mais recente com `sudo apt update && sudo apt install doublezero-solana` +Se você já configurou o DoubleZero anteriormente, certifique-se de ter o CLI Doublezero-Solana mais recente com `sudo apt update && sudo apt install doublezero-solana` ### 2. Configurar o Firewall @@ -43,7 +43,7 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. Habilitar o Reconciliador -O reconciliador monitora o estado onchain e provisiona automaticamente os túneis quando seu assento é alocado. Ele não é habilitado por padrão. +O reconciliador monitora o estado onchain e provisiona automaticamente túneis quando seu assento é alocado. Ele não é habilitado por padrão. ```bash doublezero enable @@ -73,14 +73,14 @@ solana address Sua carteira precisa de dois tokens: -- **SOL** — para taxas de transação da Solana. Transfira SOL para o endereço da carteira impresso acima. -- **USDC** — para financiamento do assento. O CLI utiliza a Conta de Token Associada (ATA) da sua carteira para o mint USDC da mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). +- **SOL** — para taxas de transação Solana. Transfira SOL para o endereço da carteira impresso acima. +- **USDC** — para financiamento de assentos. O CLI retira da Conta de Token Associada (ATA) da sua carteira para o mint USDC da mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). --- ## Passo 3: Comprar um Assento -### 1. Encontre Seu Dispositivo Mais Próximo +### 1. Encontrar o Dispositivo Mais Próximo Antes de comprar um assento, identifique o dispositivo com a menor latência a partir da sua máquina: @@ -88,11 +88,11 @@ Antes de comprar um assento, identifique o dispositivo com a menor latência a p doublezero latency ``` -Anote o código do dispositivo com o resultado de menor latência (ex.: ``). Você usará isso ao comprar um assento. +Anote o código do dispositivo do resultado com menor latência (ex.: ``). Você usará isso ao comprar um assento. ### 2. Verificar Preços -Consulte os preços atuais dos dispositivos antes de comprometer fundos. Os preços têm dois componentes: um **preço base do metro** e um **prêmio por dispositivo**. Os preços são atualizados a cada época. Você também pode visualizar preços e disponibilidade [aqui](https://data.malbeclabs.com/dz/shreds/devices). +Visualize os preços atuais do dispositivo antes de comprometer fundos. Os preços têm dois componentes: um **preço base do metro** e um **prêmio por dispositivo**. Você também pode visualizar preços e disponibilidade [aqui](https://data.malbeclabs.com/dz/shreds/devices). **Todos os dispositivos:** @@ -115,7 +115,7 @@ doublezero-solana shreds price --metro Colunas de saída: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. -O preço da época é o custo total por época para um assento naquele dispositivo (base + prêmio). Use `--wide` para exibir chaves públicas completas, ou `--json` para saída em JSON. +O preço da epoch é o custo total por epoch para um assento naquele dispositivo (base + prêmio). Use `--wide` para mostrar chaves públicas completas, ou `--json` para saída em JSON. ### 3. Comprar um Assento @@ -135,34 +135,34 @@ doublezero-solana shreds pay \ | `--device ` | Dispositivo alvo por chave pública (mutuamente exclusivo com `--device-code`) | | `--device-code ` | Dispositivo alvo por código legível (ex.: ``) | | `--client-ip ` | Endereço IPv4 público da sua máquina | -| `--amount ` | USDC a financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender o preço mínimo da época. | +| `--amount ` | USDC para financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender ao preço mínimo da epoch. | | `--source-token-account ` | Conta de origem USDC personalizada (padrão é a ATA da sua carteira) | -| `--accept-partial-epoch` | Ignorar o aviso de época restante (veja abaixo) | +| `--accept-partial-epoch` | Pular o aviso de epoch restante (veja abaixo) | | `--fee-payer ` | Usar uma carteira diferente para taxas de transação SOL | | `--dry-run` | Simular a transação sem executá-la | | `--with-compute-unit-price ` | Definir um preço de unidade de computação para inclusão mais rápida durante congestionamento | -Assim que seu assento for alocado, o daemon estabelece o túnel GRE automaticamente. Verifique sua conexão com: +Uma vez que seu assento é alocado, o daemon estabelece o túnel GRE automaticamente. Verifique sua conexão com: ```bash doublezero status ``` -### Temporização de Época +### Timing da Epoch -Os assentos são alocados por época da Solana (~2 dias). Se restar menos de 10% da época atual quando você pagar, o CLI avisa que seu assento será alocado imediatamente, mas cobrirá apenas o restante da época atual. Um pagamento separado será deduzido do seu escrow quando a próxima época começar. +Os assentos são alocados por epoch Solana (~2 dias). Se menos de 10% da epoch atual restar quando você pagar, o CLI avisa que seu assento será alocado imediatamente, mas cobre apenas o restante da epoch atual. Um pagamento separado será deduzido do seu escrow quando a próxima epoch começar. -!!! info "É aconselhável financiar para mais de 1 época por vez para não perder seu assento. Você pode verificar o tempo restante na época atual [aqui](https://explorer.solana.com/)." +!!! info "É aconselhável financiar mais de 1 epoch por vez para não perder seu assento. Você pode verificar o tempo restante em uma epoch [aqui](https://explorer.solana.com/)." Você pode ignorar este aviso com `--accept-partial-epoch`. ### Mantenha Seu Escrow Financiado -!!! warning "Se o saldo do seu escrow estiver abaixo do preço da época na liquidação, seu assento não será alocado, o túnel será encerrado e você perderá sua permanência acumulada. A permanência determina sua prioridade para épocas futuras — perdê-la significa que você competirá como um novato novamente." +!!! warning "Se o saldo do seu escrow estiver abaixo do preço da epoch na liquidação, seu assento não será alocado, o túnel será encerrado e você perderá sua permanência acumulada. A permanência determina sua prioridade para epochs futuras — perdê-la significa que você compete como um novato novamente." -Você pode financiar esta conta a mais para cobrir múltiplas épocas. Cada liquidação deduz o preço de uma época do seu escrow, e o saldo restante é mantido. Por exemplo, financiar 5x o preço por época mantém seu assento ativo por até 5 épocas sem necessidade de refinanciamento. +Você pode sobrefinanciar esta conta para financiar múltiplas epochs. Cada liquidação deduz o preço de uma epoch do seu escrow, e o saldo restante é transferido. Por exemplo, financiar 5x o preço por epoch mantém seu assento ativo por até 5 epochs sem refinanciamento. -Para recarregar seu escrow, execute `shreds pay` novamente a qualquer momento: +Para reabastecer seu escrow, execute `shreds pay` novamente a qualquer momento: ```bash doublezero-solana shreds pay \ @@ -171,11 +171,11 @@ doublezero-solana shreds pay \ --amount 500 ``` -Observe que o `Target_IP` deve ser um endereço IPv4 público na máquina que receberá os shreds. Você pode encontrá-lo executando um comando como `curl -4 ifconfig.me` na máquina de destino. +Note que o `Target_IP` deve ser um endereço IPv4 público na máquina que receberá os shreds. Você pode encontrá-lo executando um comando como `curl -4 ifconfig.me` na máquina de destino. ### Monitorar Assentos -Esta seção detalha como visualizar assentos via CLI. Você também pode usar [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) para monitorar assentos e auxiliar no gerenciamento da sua conta de escrow. +Esta seção detalha como visualizar assentos via CLI. Você também pode usar [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) para monitorar assentos e auxiliar no gerenciamento da sua conta escrow. Visualize seus assentos ativos e saldos de escrow: @@ -205,11 +205,11 @@ doublezero-solana shreds list --withdraw-authority Colunas de saída: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. -A coluna "Est. Epochs Paid" mostra quantas épocas seu saldo atual cobre com os preços atuais. Se os preços mudarem, esta estimativa se ajusta. +A coluna "Est. Epochs Paid" mostra quantas epochs seu saldo atual cobre com os preços atuais. Se os preços mudarem, esta estimativa se ajusta. ### Sacar Fundos -Encerre seu escrow e reembolse o USDC restante para sua carteira: +Feche seu escrow e reembolse o USDC restante para sua carteira: ```bash doublezero-solana shreds withdraw \ @@ -217,7 +217,7 @@ doublezero-solana shreds withdraw \ --client-ip ``` -Você pode identificar o dispositivo por `--device ` ou `--device-code `, assim como nos outros comandos. +Você pode identificar o dispositivo por `--device ` ou `--device-code `, assim como outros comandos. Para enviar o reembolso para uma conta de token diferente: @@ -232,12 +232,12 @@ doublezero-solana shreds withdraw \ --- -## Endereços de Shreds (IP vs Porta) +## Endereços de Shred (IP vs Porta) -Shreds de Líder e Shreds de Retransmissão de alto stake chegarão pela porta `7733`, através da interface `doublezero1`. A interface `doublezero0` é para tráfego unicast. A porta `5765` é um monitor de heartbeat dos publicadores de shreds — isso não conterá shreds. +Shreds de Líder e Shreds de Retransmissão de alto stake chegarão pela porta `7733`, pela interface `doublezero1`. A interface `doublezero0` é para tráfego unicast. A porta `5765` é um monitor de heartbeat dos publicadores de shreds — isso não conterá shreds. Para consumo de shreds, o **endereço IP** identifica o fluxo multicast e a **porta** identifica o serviço UDP nesse fluxo. -Todos os fluxos de shreds abaixo usam a porta UDP `7733` em `doublezero1`. +Todos os fluxos de shred abaixo usam a porta UDP `7733` em `doublezero1`. Você pode examinar os IPs de qualquer grupo multicast com: @@ -249,7 +249,7 @@ doublezero multicast group list - `edge-solana-shreds`: `233.84.178.1:7733` -### Shreds de Raiz +### Shreds de Root - `edge-solana-root`: `233.84.178.16:7733` @@ -262,7 +262,7 @@ doublezero multicast group list ## Cabeçalho do Túnel GRE — XDP -!!! note "O tráfego de shreds entregue pela rede é encapsulado em GRE. Pode ser necessário remover o cabeçalho GRE antes de alimentar os dados no seu pipeline existente (ex.: um deshredder baseado em XDP)." +!!! note "O tráfego de shred entregue pela rede é encapsulado em GRE. Pode ser necessário remover o cabeçalho GRE antes de alimentar os dados no seu pipeline existente (ex.: um deshredder baseado em XDP)." --- @@ -270,15 +270,15 @@ doublezero multicast group list ### [Placar do Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) -O Placar compara a velocidade de entrega de shreds entre o DoubleZero Edge e outros provedores, usando dados em nível de slot para comparar o desempenho em tempo real. Use este painel para ver as taxas de vitória dos shreds do Edge contra outros provedores. Você pode visualizar resultados apenas para shreds de líder, além da comparação completa do feed. Você também pode detalhar por região para ver o desempenho esperado. +O Placar compara a velocidade de entrega de shreds entre o DoubleZero Edge e outros provedores, usando dados em nível de slot para comparar o desempenho em tempo real. Use este painel para ver as taxas de vitória dos shreds Edge contra outros provedores. Você pode visualizar resultados apenas para shreds de líder, além de comparação de feed completo. Você também pode detalhar por região para ver o desempenho esperado. -### [Publicadores do Edge](https://data.malbeclabs.com/dz/shreds/publishers) +### [Publicadores Edge](https://data.malbeclabs.com/dz/shreds/publishers) A métrica "Publishing Shreds" no canto superior esquerdo do painel mostra o percentual total de peso de stake de todos os validadores Solana publicando shreds de líder no DoubleZero Edge. Você pode ver detalhes de cada publicador na rede. ### [Assinantes, Dispositivos e Atividade do Edge](https://data.malbeclabs.com/dz/shreds/subscribers) -Você pode facilmente pesquisar seu IP de Cliente nesta página para assentos inscritos e visualizar o status. Clique em assinaturas de assentos específicos para ver o histórico de pagamentos e atividade. Você também pode visualizar dispositivos disponíveis na página de [Dispositivos](https://data.malbeclabs.com/dz/shreds/devices) e toda a atividade recente na página de [Atividade](https://data.malbeclabs.com/dz/shreds/activity). +Você pode facilmente pesquisar seu IP de Cliente nesta página para assentos inscritos e visualizar o status. Clique em assinaturas de assentos específicas para ver o histórico de pagamentos e atividade. Você também pode visualizar dispositivos disponíveis na página de [Dispositivos](https://data.malbeclabs.com/dz/shreds/devices) e toda a atividade recente na página de [Atividade](https://data.malbeclabs.com/dz/shreds/activity). ### Documentação da API de Dados @@ -286,9 +286,9 @@ Para acesso programático aos endpoints de dados, consulte a documentação da A --- -## Solução de Problemas +## Resolução de Problemas -Se você encontrar um problema não coberto aqui, entre em contato pelo seu canal existente antes de tentar contorná-lo. Se você não tiver um canal, pesquise no [Discord](https://discord.gg/U2fEb4Jq) e abra um ticket se necessário. +Se você encontrar um problema não coberto aqui, por favor entre em contato pelo seu canal existente antes de tentar uma solução alternativa. Se você não tiver um canal, por favor pesquise no [Discord](https://discord.gg/U2fEb4Jq) e abra um ticket se necessário. ### Certifique-se de que seu Cliente está atualizado: @@ -296,34 +296,34 @@ Execute: `sudo apt update && sudo apt install doublezero-solana` ### Saldo de escrow insuficiente -Se o saldo do seu escrow estiver abaixo do preço da época na liquidação, o assento não será alocado, o túnel será encerrado e a permanência será perdida. Recarregue com `shreds pay` antes da próxima liquidação. +Se o saldo do seu escrow estiver abaixo do preço da epoch na liquidação, o assento não é alocado, o túnel é encerrado e a permanência é perdida. Recarregue com `shreds pay` antes da próxima liquidação. -### Assento não alocado após pagamento +### Assento não alocado após o pagamento -- Você pode ter pago tarde na época — o assento entra em vigor na próxima época. -- Todos os assentos no dispositivo podem estar ocupados por titulares com maior permanência. Verifique os assentos disponíveis com `shreds price`. -- Se você sacou antes da liquidação, o assento não era elegível. +- Você pode ter pago tarde na epoch — o assento entra em vigor na próxima epoch. +- Todos os assentos no dispositivo podem estar ocupados por incumbentes com maior permanência. Verifique assentos disponíveis com `shreds price`. +- Se você sacou antes da liquidação, o assento não estava elegível. ### Túnel não está subindo 1. Verifique se o daemon está em execução: `sudo systemctl status doublezerod` 2. Verifique se o reconciliador está habilitado: `doublezero enable` -3. Verifique se as regras de firewall estão configuradas (GRE, BGP, PIM, tráfego de shreds em `doublezero1`, porta 44880 em `doublezero0`) -4. Verifique se seu assento está ativo para a época atual: `doublezero-solana shreds list` +3. Verifique se as regras de firewall estão em vigor (GRE, BGP, PIM, tráfego de shred em `doublezero1`, porta 44880 em `doublezero0`) +4. Verifique se seu assento está ativo para a epoch atual: `doublezero-solana shreds list` 5. Verifique o status da sua conexão: `doublezero status` -O IP do cliente do daemon é autodescoberto a partir do IP público do seu host — verifique se ele corresponde ao `--client-ip` usado nos seus comandos de assento. +O IP do cliente do daemon é descoberto automaticamente a partir do IP público do seu host — verifique se ele corresponde ao `--client-ip` usado nos seus comandos de assento. -### Aviso de época +### Aviso de prompt de epoch -O CLI avisa quando resta menos de 10% da época. Suas opções: +O CLI avisa quando menos de 10% da epoch resta. Suas opções: -- Aceitar com `--accept-partial-epoch` se você quiser o assento imediatamente -- Aguardar a próxima época para obter cobertura de uma época completa +- Aceite com `--accept-partial-epoch` se você quiser o assento imediatamente +- Aguarde a próxima epoch para obter cobertura de uma epoch completa ### "Amount is below the current price" -O comando `pay` valida seu valor contra o preço mínimo da época (base do metro + prêmio do dispositivo). Use `shreds price` para verificar os preços atuais e aumente seu valor. +O comando `pay` valida seu valor contra o preço mínimo da epoch (base do metro + prêmio do dispositivo). Use `shreds price` para verificar os preços atuais e aumente seu valor. ### "Multicast user already exists" diff --git a/docs/Edge Subscriber Connection.zh.md b/docs/Edge Subscriber Connection.zh.md index c65cf04..af62bbf 100644 --- a/docs/Edge Subscriber Connection.zh.md +++ b/docs/Edge Subscriber Connection.zh.md @@ -3,23 +3,23 @@ description: 设置边缘订阅者以接收 DoubleZero 分片数据流，包括 --- # 边缘订阅者连接 -!!! warning "连接到 DoubleZero 即表示我同意 [DoubleZero 使用条款](https://doublezero.xyz/terms-protocol)。请注意，数据仅供您内部使用，不得转发（参见第 2(e) 条）。" +!!! warning "连接到 DoubleZero 即表示我同意 [DoubleZero 使用条款](https://doublezero.xyz/terms-protocol)。请注意，数据仅供您内部使用，不得转发（参见第 2(e) 节）。" -## 步骤 1：DoubleZero 设置 +## 第 1 步：DoubleZero 设置 ### 1. 完成设置 安装 [Solana CLI](https://docs.anza.xyz/cli/install)。 -按照[设置](setup.md)说明安装和配置 DoubleZero 客户端。 +按照[设置](setup.md)说明安装并配置 DoubleZero 客户端。 -如果您之前已设置过 DoubleZero，请确保您拥有最新的 Doublezero-Solana CLI，运行 `sudo apt update && sudo apt install doublezero-solana` +如果您之前已设置过 DoubleZero，请确保使用 `sudo apt update && sudo apt install doublezero-solana` 获取最新的 Doublezero-Solana CLI。 ### 2. 配置防火墙 允许 GRE、BGP、PIM 和分片流量。 -**iptables:** +**iptables：** ```bash sudo iptables -A OUTPUT -p gre -j ACCEPT @@ -30,7 +30,7 @@ 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:** +**UFW：** ```bash sudo ufw allow proto gre from any to any @@ -43,7 +43,7 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. 启用协调器 -协调器监控链上状态，并在您的席位被分配时自动配置隧道。默认情况下未启用。 +协调器监控链上状态，并在您的席位被分配时自动配置隧道。它默认未启用。 ```bash doublezero enable @@ -51,7 +51,7 @@ doublezero enable --- -## 步骤 2：设置您的钱包 +## 第 2 步：设置钱包 ### 1. 创建 Solana 密钥对 @@ -61,7 +61,7 @@ doublezero enable solana-keygen new ``` -这将写入 `~/.config/solana/id.json`。如需使用不同路径，请向任何 `doublezero-solana` 命令传递 `--keypair `。 +这会写入 `~/.config/solana/id.json`。要使用不同的路径，请在任何 `doublezero-solana` 命令中传递 `--keypair `。 打印您的钱包地址： @@ -78,21 +78,21 @@ solana address --- -## 步骤 3：购买席位 +## 第 3 步：购买席位 ### 1. 查找最近的设备 -在购买席位之前，找到距离您机器延迟最低的设备： +在购买席位之前，确定从您的机器延迟最低的设备： ```bash doublezero latency ``` -记下延迟最低结果中的设备代码（例如 ``）。您在购买席位时将使用此代码。 +记下延迟最低的结果中的设备代码（例如 ``）。您在购买席位时将使用此代码。 ### 2. 查看定价 -在投入资金之前查看当前设备定价。定价由两部分组成：**基础都会区价格**和**每设备溢价**。价格每个纪元更新。您也可以在[此处](https://data.malbeclabs.com/dz/shreds/devices)查看定价和可用性。 +在投入资金之前查看当前设备定价。定价由两部分组成：**基础城域价格**和**每设备溢价**。您也可以在[此处](https://data.malbeclabs.com/dz/shreds/devices)查看定价和可用性。 **所有设备：** @@ -107,7 +107,7 @@ doublezero-solana shreds price --device-code doublezero-solana shreds price --device ``` -**某个都会区的所有设备：** +**城域内所有设备：** ```bash doublezero-solana shreds price --metro @@ -115,11 +115,11 @@ doublezero-solana shreds price --metro 输出列：`Device Code`、`Metro Code`、`Metro Name`、`Status`、`Settled Seats`、`Available Seats`、`Base Price (USDC)`、`Premium (USDC)`、`Epoch Price (USDC)`。 -纪元价格是该设备上每个纪元一个席位的总费用（基础 + 溢价）。使用 `--wide` 显示完整公钥，或使用 `--json` 输出 JSON 格式。 +纪元价格是该设备上每个席位每个纪元的总费用（基础价 + 溢价）。使用 `--wide` 显示完整公钥，或使用 `--json` 输出 JSON 格式。 ### 3. 购买席位 -通过一条命令购买席位。此操作将初始化您的席位、为托管账户充值并请求分配： +使用单个命令购买席位。此操作将初始化您的席位、为托管账户注资并请求分配： ```bash doublezero-solana shreds pay \ @@ -131,18 +131,18 @@ doublezero-solana shreds pay \ **参数：** | 标志 | 描述 | -|------|-------------| +|------|------| | `--device ` | 通过公钥指定目标设备（与 `--device-code` 互斥） | -| `--device-code ` | 通过可读代码指定目标设备（例如 ``） | -| `--client-ip ` | 您机器的公网 IPv4 地址 | -| `--amount ` | 充值的 USDC 金额（十进制格式，例如 `100` = 100 USDC）。必须满足最低纪元价格。 | +| `--device-code ` | 通过人类可读代码指定目标设备（例如 ``） | +| `--client-ip ` | 您机器的公共 IPv4 地址 | +| `--amount ` | 注资的 USDC 金额（十进制格式，例如 `100` = 100 USDC）。必须达到最低纪元价格。 | | `--source-token-account ` | 自定义 USDC 来源账户（默认为您钱包的 ATA） | | `--accept-partial-epoch` | 跳过纪元剩余时间警告（见下文） | | `--fee-payer ` | 使用不同的钱包支付 SOL 交易费用 | -| `--dry-run` | 模拟交易而不实际执行 | -| `--with-compute-unit-price ` | 设置计算单元价格，以在拥堵时更快被包含 | +| `--dry-run` | 模拟交易而不执行 | +| `--with-compute-unit-price ` | 设置计算单元价格以在拥堵时加快交易确认 | -一旦您的席位被分配，守护进程会自动建立 GRE 隧道。使用以下命令检查您的连接： +席位分配后，守护进程会自动建立 GRE 隧道。使用以下命令检查您的连接： ```bash doublezero status @@ -150,19 +150,19 @@ doublezero status ### 纪元时间 -席位按 Solana 纪元分配（约 2 天）。如果您付款时当前纪元剩余不足 10%，CLI 会警告您的席位将立即分配，但仅覆盖当前纪元的剩余部分。下一个纪元开始时，将从您的托管账户中单独扣除一笔费用。 +席位按 Solana 纪元分配（约 2 天）。如果您付款时当前纪元剩余不到 10%，CLI 会警告您的席位将立即分配，但仅覆盖当前纪元的剩余部分。下一个纪元开始时将从您的托管账户中扣除单独的付款。 -!!! info "建议一次性充值超过 1 个纪元的费用，以免失去您的席位。您可以在[此处](https://explorer.solana.com/)查看当前纪元的剩余时间。" +!!! info "建议一次性为多个纪元充值，以免失去席位。您可以在[此处](https://explorer.solana.com/)查看当前纪元的剩余时间。" 您可以使用 `--accept-partial-epoch` 跳过此警告。 -### 保持托管账户充足 +### 保持托管账户充值 -!!! warning "如果在结算时您的托管账户余额低于纪元价格，您的席位将不会被分配，隧道将被拆除，您将失去累积的任期。任期决定您在未来纪元中的优先级——失去任期意味着您将作为新用户重新竞争。" +!!! warning "如果您的托管账户余额在结算时低于纪元价格，您的席位将不会被分配，隧道将被拆除，并且您将失去累积的任期。任期决定您在未来纪元中的优先级——失去它意味着您将作为新用户重新竞争。" -您可以向此账户超额充值以资助多个纪元。每次结算从您的托管账户中扣除一个纪元的价格，剩余余额结转。例如，充值 5 倍的每纪元价格可以保持您的席位最多活跃 5 个纪元而无需再次充值。 +您可以向该账户超额注资以覆盖多个纪元。每次结算从您的托管账户中扣除一个纪元的价格，剩余余额结转。例如，注入 5 倍每纪元价格的资金可以让您的席位在无需再次充值的情况下保持最多 5 个纪元的活跃状态。 -要随时为托管账户充值，请再次运行 `shreds pay`： +要为托管账户追加资金，可随时再次运行 `shreds pay`： ```bash doublezero-solana shreds pay \ @@ -171,15 +171,15 @@ doublezero-solana shreds pay \ --amount 500 ``` -请注意，`Target_IP` 必须是接收分片数据的机器上的公网 IPv4 地址。您可以在目标机器上运行 `curl -4 ifconfig.me` 等命令来获取此地址。 +请注意，`Target_IP` 必须是将接收分片数据的机器上的公共 IPv4 地址。您可以在目标机器上运行 `curl -4 ifconfig.me` 等命令来获取此地址。 ### 监控席位 -本节详细介绍如何通过 CLI 查看席位。您也可以使用 [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) 来监控席位，并协助管理您的托管账户。 +本节详细介绍如何通过 CLI 查看席位。您也可以使用 [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) 来监控席位并协助管理您的托管账户。 查看您的活跃席位和托管余额： -**您的所有席位：** +**所有席位：** ```bash doublezero-solana shreds list @@ -205,7 +205,7 @@ doublezero-solana shreds list --withdraw-authority 输出列：`Device Code`、`Client IP`、`Tenure`、`Balance (USDC)`、`Est. Epochs Paid`。 -"Est. Epochs Paid" 列显示按当前定价，您的当前余额可覆盖多少个纪元。如果价格变动，此估算值会相应调整。 +"Est. Epochs Paid" 列显示按当前定价您的余额可覆盖多少个纪元。如果价格变化，此估算值会相应调整。 ### 提取资金 @@ -219,7 +219,7 @@ doublezero-solana shreds withdraw \ 您可以通过 `--device ` 或 `--device-code ` 来指定设备，与其他命令相同。 -将退款发送到不同的代币账户： +要将退款发送到不同的代币账户： ```bash doublezero-solana shreds withdraw \ @@ -228,16 +228,16 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "提取意味着您将失去席位和累积的任期。" +!!! warning "提取资金意味着您将失去席位和累积的任期。" --- ## 分片地址（IP 与端口） -Leader 分片和高质押 Retransmit 分片将通过 `doublezero1` 接口的端口 `7733` 到达。`doublezero0` 接口用于单播流量。端口 `5765` 是来自分片发布者的心跳监控——其中不包含分片数据。 +领导者分片和高质押权重的转发分片将通过 `doublezero1` 接口的端口 `7733` 到达。`doublezero0` 接口用于单播流量。端口 `5765` 是来自分片发布者的心跳监控——这不会包含分片数据。 对于分片消费，**IP 地址**标识组播流，**端口**标识该流上的 UDP 服务。 -以下所有分片流都使用 `doublezero1` 上的 UDP 端口 `7733`。 +以下所有分片流在 `doublezero1` 上使用 UDP 端口 `7733`。 您可以使用以下命令查看任何组播组的 IP： @@ -245,24 +245,24 @@ Leader 分片和高质押 Retransmit 分片将通过 `doublezero1` 接口的端 doublezero multicast group list ``` -### Leader 分片 +### 领导者分片 - `edge-solana-shreds`: `233.84.178.1:7733` -### Root 分片 +### 根分片 - `edge-solana-root`: `233.84.178.16:7733` -### Retransmit 分片 +### 转发分片 - `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` -## GRE 隧道头部 — XDP +## GRE 隧道头 — XDP -!!! note "通过网络传输的分片流量是 GRE 封装的。在将数据送入您现有的处理管道（例如基于 XDP 的分片重组器）之前，您可能需要剥离 GRE 头部。" +!!! note "通过网络传输的分片流量是 GRE 封装的。您可能需要在将数据送入现有处理管线（例如基于 XDP 的分片重组器）之前剥离 GRE 头。" --- @@ -270,15 +270,15 @@ doublezero multicast group list ### [边缘排行榜](https://data.malbeclabs.com/dz/shreds/scoreboard) -排行榜对比 DoubleZero Edge 和其他提供商之间的分片传输速度，使用槽级数据实时比较性能。使用此仪表板可以查看 Edge 分片相对于其他提供商的胜率。您可以仅查看 leader 分片的结果，也可以查看完整数据流的对比。您还可以按区域深入查看预期性能。 +排行榜使用槽级数据，实时比较 DoubleZero Edge 和其他提供商之间的分片传输速度。使用此仪表板查看 Edge 分片相对于其他提供商的胜率。您可以查看仅限领导者分片的结果，以及完整数据流的比较。您还可以按区域深入查看预期性能。 ### [边缘发布者](https://data.malbeclabs.com/dz/shreds/publishers) -仪表板左上角的"Publishing Shreds"指标显示在 DoubleZero Edge 上发布 leader 分片的所有 Solana 验证者的总质押权重百分比。您可以查看网络上每个发布者的详细信息。 +仪表板左上角的"Publishing Shreds"指标显示在 DoubleZero Edge 上发布领导者分片的所有 Solana 验证者的总质押权重百分比。您可以查看网络上每个发布者的详细信息。 ### [边缘订阅者、设备和活动](https://data.malbeclabs.com/dz/shreds/subscribers) -您可以在此页面轻松搜索您的客户端 IP 以查看已订阅的席位和状态。点击特定席位订阅可查看付款历史和活动。您还可以在[设备](https://data.malbeclabs.com/dz/shreds/devices)页面查看可用设备，在[活动](https://data.malbeclabs.com/dz/shreds/activity)页面查看所有最近的活动。 +您可以在此页面轻松搜索您的客户端 IP 以查看已订阅的席位和状态。点击特定的席位订阅可查看付款历史和活动记录。您还可以在[设备](https://data.malbeclabs.com/dz/shreds/devices)页面查看可用设备，以及在[活动](https://data.malbeclabs.com/dz/shreds/activity)页面查看所有近期活动。 ### 数据 API 文档 @@ -288,43 +288,43 @@ doublezero multicast group list ## 故障排除 -如果您遇到此处未涵盖的问题，请在尝试自行解决之前通过您现有的渠道联系我们。如果您没有渠道，请搜索 [Discord](https://discord.gg/U2fEb4Jq) 并在需要时提交工单。 +如果您遇到此处未涵盖的问题，请先通过现有渠道联系我们，不要自行解决。如果您没有联系渠道，请在 [Discord](https://discord.gg/U2fEb4Jq) 中搜索，如需要可提交工单。 -### 确保您的客户端是最新的： +### 确保客户端为最新版本： 运行：`sudo apt update && sudo apt install doublezero-solana` -### 托管余额不足 +### 托管账户余额不足 -如果在结算时您的托管余额低于纪元价格，席位将不会被分配，隧道将被拆除，任期将丢失。请在下次结算之前使用 `shreds pay` 充值。 +如果您的托管账户余额在结算时低于纪元价格，席位将不会被分配，隧道将被拆除，任期将丢失。请在下次结算前使用 `shreds pay` 进行充值。 ### 付款后席位未分配 -- 您可能在纪元后期才付款——席位将在下一个纪元生效。 -- 该设备上的所有席位可能已被更高任期的在位者占据。使用 `shreds price` 检查可用席位。 -- 如果您在结算前提取了资金，则该席位不符合条件。 +- 您可能在纪元后期付款——席位将在下一个纪元生效。 +- 该设备上的所有席位可能已被任期更长的在位者占据。使用 `shreds price` 检查可用席位。 +- 如果您在结算前进行了提取，则席位不符合分配条件。 ### 隧道未建立 -1. 验证守护进程正在运行：`sudo systemctl status doublezerod` -2. 验证协调器已启用：`doublezero enable` -3. 验证防火墙规则已就位（GRE、BGP、PIM、`doublezero1` 上的分片流量、`doublezero0` 上的端口 44880） -4. 验证您的席位在当前纪元中处于活跃状态：`doublezero-solana shreds list` +1. 验证守护进程是否正在运行：`sudo systemctl status doublezerod` +2. 验证协调器是否已启用：`doublezero enable` +3. 验证防火墙规则是否已配置（GRE、BGP、PIM、`doublezero1` 上的分片流量、`doublezero0` 上的端口 44880） +4. 验证您的席位在当前纪元是否处于活跃状态：`doublezero-solana shreds list` 5. 检查您的连接状态：`doublezero status` -守护进程的客户端 IP 从您主机的公网 IP 自动发现——请验证它与您在席位命令中使用的 `--client-ip` 一致。 +守护进程的客户端 IP 从您主机的公共 IP 自动发现——请验证它是否与席位命令中使用的 `--client-ip` 一致。 ### 纪元警告提示 -当纪元剩余不足 10% 时，CLI 会发出警告。您的选项： +当纪元剩余不到 10% 时，CLI 会发出警告。您的选择： - 如果您希望立即获得席位，使用 `--accept-partial-epoch` 接受 - 等待下一个纪元以获得完整纪元的覆盖 ### "金额低于当前价格" -`pay` 命令会根据最低纪元价格（都会区基础价格 + 设备溢价）验证您的金额。使用 `shreds price` 检查当前定价并增加您的金额。 +`pay` 命令会根据最低纪元价格（城域基础价 + 设备溢价）验证您的金额。使用 `shreds price` 检查当前定价并增加您的金额。 ### "组播用户已存在" -您已经通过其他路径拥有一个活跃的订阅。请先使用 `doublezero disconnect` 断开连接，然后重试 `shreds pay`。 \ No newline at end of file +您已通过其他路径有一个活跃订阅。请先使用 `doublezero disconnect` 断开连接，然后重试 `shreds pay`。 \ No newline at end of file