From 0212b9b8b70ef11a7dba92728f5b2a10c53732a9 Mon Sep 17 00:00:00 2001 From: Jared-dz Date: Thu, 23 Jul 2026 10:23:28 -0400 Subject: [PATCH 1/2] remove DZ address instruction remove DZ address instruction --- docs/Edge Subscriber Connection.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/docs/Edge Subscriber Connection.md b/docs/Edge Subscriber Connection.md index 6746dac..147f7da 100644 --- a/docs/Edge Subscriber Connection.md +++ b/docs/Edge Subscriber Connection.md @@ -49,19 +49,6 @@ The reconciler monitors onchain state and automatically provisions tunnels when doublezero enable ``` -### 4. Retrieve the Server's DoubleZero Identity - -Review your DoubleZero Identity. This identity will be used to create the connection between your machine and DoubleZero. - -```bash -doublezero address -``` - -**Output:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## Step 2: Set Up Your Wallet From 752eca4250734eff364d1f7214574eb397d5fd3f Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 23 Jul 2026 14:34:47 +0000 Subject: [PATCH 2/2] chore: auto-translate docs --- docs/Edge Subscriber Connection.es.md | 115 ++++++++---------- docs/Edge Subscriber Connection.fr.md | 115 ++++++++---------- docs/Edge Subscriber Connection.it.md | 135 ++++++++++---------- docs/Edge Subscriber Connection.ja.md | 169 ++++++++++++-------------- docs/Edge Subscriber Connection.ko.md | 135 ++++++++++---------- docs/Edge Subscriber Connection.pt.md | 73 +++++------ docs/Edge Subscriber Connection.zh.md | 125 +++++++++---------- 7 files changed, 388 insertions(+), 479 deletions(-) diff --git a/docs/Edge Subscriber Connection.es.md b/docs/Edge Subscriber Connection.es.md index 715749c..56217aa 100644 --- a/docs/Edge Subscriber Connection.es.md +++ b/docs/Edge Subscriber Connection.es.md @@ -3,17 +3,17 @@ 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 solo para sus fines internos y no pueden ser retransmitidos (véase la 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 únicamente para sus fines internos y no pueden ser retransmitidos (ver Sección 2(e))." ## Paso 1: Configuración de DoubleZero ### 1. Completar la Configuración -Instale la [CLI de Solana](https://docs.anza.xyz/cli/install). +Instale el [Solana CLI](https://docs.anza.xyz/cli/install). Siga las instrucciones de [configuración](setup.md) para instalar y configurar el cliente de DoubleZero. -Si ha configurado DoubleZero previamente, asegúrese de tener la última versión de la CLI Doublezero-Solana con `sudo apt update && sudo apt install doublezero-solana` +Si ha configurado DoubleZero previamente, asegúrese de tener la última versión del CLI de Doublezero-Solana con `sudo apt update && sudo apt install doublezero-solana` ### 2. Configurar el Firewall @@ -43,51 +43,38 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. Habilitar el Reconciliador -El reconciliador monitorea el estado onchain y aprovisiona automáticamente los túneles cuando se le asigna su asiento. No está habilitado por defecto. +El reconciliador monitorea el estado onchain y aprovisiona túneles automáticamente cuando se asigna su asiento. No está habilitado por defecto. ```bash doublezero enable ``` -### 4. Obtener la Identidad DoubleZero del Servidor - -Revise su Identidad DoubleZero. Esta identidad se utilizará para crear la conexión entre su máquina y DoubleZero. - -```bash -doublezero address -``` - -**Salida:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- -## Paso 2: Configurar Su Wallet +## Paso 2: Configurar Su Billetera ### 1. Crear un Par de Claves de Solana -La CLI `doublezero-solana` utiliza un par de claves estándar de Solana para la gestión de asientos onchain. Si no tiene uno: +El CLI `doublezero-solana` utiliza un par de claves estándar de Solana para la gestión de asientos onchain. Si no tiene uno: ```bash solana-keygen new ``` -Esto se escribe en `~/.config/solana/id.json`. Para usar una ruta diferente, pase `--keypair ` a cualquier comando de `doublezero-solana`. +Esto escribe en `~/.config/solana/id.json`. Para usar una ruta diferente, pase `--keypair ` a cualquier comando de `doublezero-solana`. -Imprima la dirección de su wallet: +Imprima la dirección de su billetera: ```bash solana address ``` -### 2. Fondear Su Wallet +### 2. Fondear Su Billetera -Su wallet necesita dos tokens: +Su billetera necesita dos tokens: -- **SOL** — para las tarifas de transacción de Solana. Transfiera SOL a la dirección del wallet impresa anteriormente. -- **USDC** — para el fondeo del asiento. La CLI extrae de la Cuenta de Token Asociada (ATA) de su wallet para el mint de USDC en mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). +- **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`). --- @@ -105,7 +92,7 @@ Anote el código del dispositivo del resultado con menor latencia (por ejemplo, ### 2. Verificar Precios -Consulte los precios actuales del dispositivo antes de comprometer fondos. Los precios tienen dos componentes: un **precio base de metro** y una **prima por dispositivo**. Los precios se actualizan cada época. También puede ver precios y disponibilidad [aquí](https://data.malbeclabs.com/dz/shreds/devices). +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). **Todos los dispositivos:** @@ -128,7 +115,7 @@ 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 época es el costo total por época para un asiento en ese dispositivo (base + prima). Use `--wide` para mostrar las claves públicas completas, o `--json` para salida en JSON. +El precio por epoch es el costo total por epoch para un asiento en ese dispositivo (base + prima). Use `--wide` para mostrar las claves públicas completas, o `--json` para salida en JSON. ### 3. Comprar un Asiento @@ -148,34 +135,34 @@ 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 época. | -| `--source-token-account ` | Cuenta de origen USDC personalizada (por defecto usa la ATA de su wallet) | -| `--accept-partial-epoch` | Omitir la advertencia de época restante (ver más abajo) | -| `--fee-payer ` | Usar un wallet diferente para las tarifas de transacción en SOL | +| `--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 | | `--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 | -Una vez que su asiento sea asignado, el daemon establece el túnel GRE automáticamente. Verifique su conexión con: +Una vez que su asiento esté asignado, el daemon establece el túnel GRE automáticamente. Verifique su conexión con: ```bash doublezero status ``` -### Temporización de Épocas +### Temporización de Epoch -Los asientos se asignan por época de Solana (~2 días). Si queda menos del 10% de la época actual cuando usted paga, la CLI advierte que su asiento se asignará inmediatamente pero solo cubre el resto de la época actual. Se deducirá un pago separado de su escrow cuando comience la siguiente época. +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. -!!! 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/)." +!!! 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/)." Puede omitir esta advertencia con `--accept-partial-epoch`. -### Mantener Su Escrow Fondeado +### Mantenga Su Escrow Fondeado -!!! warning "Si el saldo de su escrow está por debajo del precio por época en el momento de la liquidación, su asiento no será asignado, el túnel será desconectado y perderá su antigüedad acumulada. La antigüedad determina su prioridad para épocas futuras — perderla significa que compite como un nuevo participante de nuevo." +!!! 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." -Puede sobrecargar esta cuenta para fondear múltiples épocas. Cada liquidación deduce el precio de una época de su escrow, y el saldo restante se transfiere. Por ejemplo, fondear 5 veces el precio por época mantiene su asiento activo hasta por 5 épocas sin necesidad de volver a fondear. +Puede sobrecargar esta cuenta para fondear múltiples epochs. Cada liquidación deduce el precio de un epoch de su escrow, y el saldo restante se traslada. Por ejemplo, fondear 5 veces el precio por epoch mantiene su asiento activo hasta por 5 epochs sin necesidad de re-fondear. -Para recargar su escrow, ejecute `shreds pay` nuevamente en cualquier momento: +Para recargar su escrow, ejecute `shreds pay` de nuevo en cualquier momento: ```bash doublezero-solana shreds pay \ @@ -184,11 +171,11 @@ doublezero-solana shreds pay \ --amount 500 ``` -Tenga en cuenta que la `Target_IP` debe ser una dirección IPv4 pública en la máquina que recibirá los shreds. Puede encontrarla ejecutando un comando como `curl -4 ifconfig.me` en la máquina destino. +Tenga en cuenta que `Target_IP` debe ser una dirección IPv4 pública en la máquina que recibirá los shreds. Puede encontrarla ejecutando un comando como `curl -4 ifconfig.me` en la máquina de destino. ### Monitorear Asientos -Esta sección detalla cómo ver asientos a través de la CLI. También puede usar [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs) para monitorear asientos y ayudar en la gestión de su cuenta escrow. +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. Vea sus asientos activos y saldos de escrow: @@ -210,7 +197,7 @@ doublezero-solana shreds list --device-code doublezero-solana shreds list --client-ip ``` -**Filtrar por wallet:** +**Filtrar por billetera:** ```bash doublezero-solana shreds list --withdraw-authority @@ -218,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ántas épocas cubre su saldo actual a los precios vigentes. Si los precios cambian, esta estimación se ajusta. +La columna "Est. Epochs Paid" muestra cuántos epochs cubre su saldo actual con los precios actuales. Si los precios cambian, esta estimación se ajusta. ### Retirar Fondos -Cierre su escrow y reembolse el USDC restante a su wallet: +Cierre su escrow y reembolse el USDC restante a su billetera: ```bash doublezero-solana shreds withdraw \ @@ -230,7 +217,7 @@ doublezero-solana shreds withdraw \ --client-ip ``` -Puede identificar el dispositivo mediante `--device ` o `--device-code `, igual que en otros comandos. +Puede identificar el dispositivo por `--device ` o `--device-code `, igual que en otros comandos. Para enviar el reembolso a una cuenta de token diferente: @@ -241,7 +228,7 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "Retirar significa que pierde su asiento y la antigüedad acumulada." +!!! warning "Retirar fondos significa que pierde su asiento y la antigüedad acumulada." --- @@ -262,7 +249,7 @@ doublezero multicast group list - `edge-solana-shreds`: `233.84.178.1:7733` -### Shreds de Raíz +### Shreds de Root - `edge-solana-root`: `233.84.178.16:7733` @@ -275,23 +262,23 @@ doublezero multicast group list ## Encabezado del Túnel GRE — XDP -!!! note "El tráfico de shreds entregado a través de la red está encapsulado en GRE. Es posible que necesite eliminar el encabezado GRE antes de alimentar los datos en su pipeline existente (por ejemplo, un deshredder basado en XDP)." +!!! 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)." --- ## Herramientas y Dashboards -### [Marcador Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) +### [Tabla de Puntuación Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) -El marcador compara la velocidad de entrega de shreds entre DoubleZero Edge y otros proveedores, utilizando datos a nivel de slot para comparar el rendimiento en tiempo real. Use este dashboard para ver las tasas de victoria de los shreds de Edge contra otros proveedores. Puede ver resultados solo para shreds de líder, además de la comparación del feed completo. También puede desglosar por región para ver el rendimiento esperado. +La tabla de puntuación compara la velocidad de entrega de shreds entre DoubleZero Edge y otros proveedores, usando datos a nivel de slot para comparar el rendimiento en tiempo real. Use este dashboard para ver las tasas de victoria de los shreds de Edge contra otros proveedores. Puede ver resultados solo para shreds de líder, además de la comparación de feed completo. También puede desglosar por región para ver el rendimiento esperado. ### [Publicadores Edge](https://data.malbeclabs.com/dz/shreds/publishers) -La métrica "Publishing Shreds" en la parte superior izquierda del dashboard muestra el porcentaje total del peso de stake de todos los validadores de Solana que publican shreds de líder en DoubleZero Edge. Puede ver los detalles de cada publicador en la red. +La métrica "Publishing Shreds" en la parte superior izquierda del dashboard muestra el porcentaje total de peso de stake de todos los validadores de Solana que publican shreds de líder en DoubleZero Edge. Puede ver los detalles de cada publicador en la red. -### [Suscriptores, Dispositivos y Actividad Edge](https://data.malbeclabs.com/dz/shreds/subscribers) +### [Suscriptores Edge, Dispositivos y Actividad](https://data.malbeclabs.com/dz/shreds/subscribers) -Puede buscar fácilmente su IP de Cliente en esta página para asientos suscritos y ver el estado. Haga clic en suscripciones de asientos específicos para ver el historial de pagos y la actividad. También puede ver los dispositivos disponibles en la página de [Dispositivos](https://data.malbeclabs.com/dz/shreds/devices) y toda la actividad reciente en la página de [Actividad](https://data.malbeclabs.com/dz/shreds/activity). +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). ### Documentación de la API de Datos @@ -309,35 +296,35 @@ Ejecute: `sudo apt update && sudo apt install doublezero-solana` ### Saldo de escrow insuficiente -Si el saldo de su escrow está por debajo del precio por época en el momento de la liquidación, el asiento no se asigna, el túnel se desconecta y la antigüedad se pierde. Recargue con `shreds pay` antes de la próxima liquidación. +Si el saldo de su escrow está por debajo del precio del epoch al momento de la liquidación, el asiento no se asigna, el túnel se derriba y se pierde la antigüedad. Recargue con `shreds pay` antes de la próxima liquidación. ### Asiento no asignado después de pagar -- Es posible que haya pagado tarde en la época — el asiento se activa en la siguiente época. -- Todos los asientos del dispositivo pueden estar ocupados por titulares con mayor antigüedad. Verifique los asientos disponibles con `shreds price`. +- Es posible que haya pagado tarde en el epoch — el asiento entra en efecto en el próximo epoch. +- Todos los asientos en el dispositivo pueden estar ocupados por titulares con mayor antigüedad. Verifique los asientos disponibles con `shreds price`. - Si retiró fondos antes de la liquidación, el asiento no era elegible. ### El túnel no se establece 1. Verifique que el daemon esté ejecutándose: `sudo systemctl status doublezerod` 2. Verifique que el reconciliador esté habilitado: `doublezero enable` -3. Verifique que las reglas del firewall estén configuradas (GRE, BGP, PIM, tráfico de shreds en `doublezero1`, puerto 44880 en `doublezero0`) -4. Verifique que su asiento esté activo para la época actual: `doublezero-solana shreds list` +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` 5. Verifique el estado de su conexión: `doublezero status` -La IP del cliente del daemon se descubre automáticamente desde la IP pública de su host — verifique que coincida con el `--client-ip` utilizado en sus comandos de asiento. +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. -### Aviso de época +### Advertencia de epoch -La CLI advierte cuando queda menos del 10% de la época. Sus opciones son: +El CLI advierte cuando queda menos del 10% del epoch. Sus opciones son: - Aceptar con `--accept-partial-epoch` si desea el asiento inmediatamente -- Esperar a la siguiente época para obtener la cobertura de una época completa +- Esperar al siguiente epoch para obtener la cobertura completa de un epoch ### "Amount is below the current price" -El comando `pay` valida su monto contra el precio mínimo por época (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 epoch (base del metro + prima del dispositivo). Use `shreds price` para verificar los precios actuales y aumente su monto. ### "Multicast user already exists" -Ya tiene una suscripción activa a través de una ruta diferente. Desconéctese primero con `doublezero disconnect`, luego vuelva a intentar `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 reintente `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 a8b521a..b03763f 100644 --- a/docs/Edge Subscriber Connection.fr.md +++ b/docs/Edge Subscriber Connection.fr.md @@ -1,5 +1,5 @@ --- -description: Configurez un abonné edge pour recevoir les flux de shreds DoubleZero, incluant la configuration du client et les règles de pare-feu pour GRE, BGP, PIM et le trafic de shreds. +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. --- # Connexion d'un abonné Edge @@ -7,17 +7,17 @@ description: Configurez un abonné edge pour recevoir les flux de shreds DoubleZ ## Étape 1 : Configuration de DoubleZero -### 1. Compléter la configuration +### 1. Effectuer la configuration Installez la [CLI Solana](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 de disposer de 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 de la CLI Doublezero-Solana avec `sudo apt update && sudo apt install doublezero-solana` ### 2. Configurer le pare-feu -Autorisez le trafic GRE, BGP, PIM et de shreds. +Autorisez le trafic GRE, BGP, PIM et les shreds. **iptables :** @@ -49,19 +49,6 @@ Le réconciliateur surveille l'état onchain et provisionne automatiquement les doublezero enable ``` -### 4. Récupérer l'identité DoubleZero du serveur - -Consultez votre identité DoubleZero. Cette identité sera utilisée pour créer la connexion entre votre machine et DoubleZero. - -```bash -doublezero address -``` - -**Sortie :** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## Étape 2 : Configurer votre portefeuille @@ -74,7 +61,7 @@ La CLI `doublezero-solana` utilise une paire de clés Solana standard pour la ge solana-keygen new ``` -Ceci é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 ` à n'importe quelle commande `doublezero-solana`. Affichez l'adresse de votre portefeuille : @@ -84,10 +71,10 @@ solana address ### 2. Approvisionner votre portefeuille -Votre portefeuille nécessite deux tokens : +Votre portefeuille a besoin de deux jetons : -- **SOL** — pour les frais de transaction Solana. Transférez des SOL à l'adresse du portefeuille affichée ci-dessus. -- **USDC** — pour le financement des sièges. La CLI prélève depuis le compte de token associé (ATA) de votre portefeuille pour le mint USDC mainnet (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`). +- **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`). --- @@ -101,7 +88,7 @@ Avant d'acheter un siège, identifiez l'appareil avec la latence la plus faible doublezero latency ``` -Notez le code de l'appareil du résultat ayant la latence la plus faible (par ex., ``). Vous l'utiliserez lors de l'achat d'un siège. +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. ### 2. Vérifier les tarifs @@ -132,7 +119,7 @@ Le prix par epoch est le coût total par epoch pour un siège sur cet appareil ( ### 3. Acheter un siège -Achetez un siège avec une seule commande. Ceci initialise votre siège, approvisionne l'escrow et demande l'attribution : +Achetez un siège avec une seule commande. Cela initialise votre siège, finance le séquestre et demande l'attribution : ```bash doublezero-solana shreds pay \ @@ -147,15 +134,15 @@ 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 ` | Adresse IPv4 publique de votre machine | -| `--amount ` | USDC à déposer (format décimal, par ex. `100` = 100 USDC). Doit respecter le prix minimum par epoch. | +| `--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 restant (voir ci-dessous) | +| `--accept-partial-epoch` | Ignorer l'avertissement d'epoch 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 période de congestion | +| `--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 daemon établit automatiquement le tunnel GRE. Vérifiez votre connexion avec : +Une fois votre siège attribué, le démon établit automatiquement le tunnel GRE. Vérifiez votre connexion avec : ```bash doublezero status @@ -163,19 +150,19 @@ doublezero status ### Timing des epochs -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 couvrira que le reste de l'epoch en cours. Un paiement séparé sera déduit de votre escrow au début de l'epoch suivant. +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. -!!! info "Il est conseillé de financer pour plus d'un epoch à la fois afin de ne pas perdre votre siège. Vous pouvez vérifier le temps restant dans un epoch [ici](https://explorer.solana.com/)." +!!! 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/)." -Vous pouvez contourner cet avertissement avec `--accept-partial-epoch`. +Vous pouvez ignorer cet avertissement avec `--accept-partial-epoch`. -### Maintenir votre escrow approvisionné +### Maintenir votre séquestre approvisionné -!!! warning "Si le solde de votre escrow est inférieur au prix de l'epoch lors 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 futurs — la perdre signifie que vous êtes à nouveau en concurrence en tant que nouveau venu." +!!! 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." -Vous pouvez surfinancer ce compte pour couvrir plusieurs epochs. Chaque règlement déduit le prix d'un epoch de votre escrow, et le solde restant est reporté. Par exemple, financer 5x le prix par epoch maintient votre siège actif pendant 5 epochs maximum sans réapprovisionnement. +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. -Pour réapprovisionner votre escrow, exécutez à nouveau `shreds pay` à tout moment : +Pour compléter votre séquestre, exécutez `shreds pay` à nouveau à tout moment : ```bash doublezero-solana shreds pay \ @@ -188,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 escrow. +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. -Consultez vos sièges actifs et les soldes escrow : +Consultez vos sièges actifs et les soldes de séquestre : **Tous vos sièges :** @@ -222,7 +209,7 @@ La colonne « Est. Epochs Paid » indique combien d'epochs votre solde actuel co ### Retirer des fonds -Fermez votre escrow et récupérez les USDC restants dans votre portefeuille : +Fermez votre séquestre et remboursez les USDC restants vers votre portefeuille : ```bash doublezero-solana shreds withdraw \ @@ -232,7 +219,7 @@ doublezero-solana shreds withdraw \ Vous pouvez identifier l'appareil par `--device ` ou `--device-code `, comme pour les autres commandes. -Pour envoyer le remboursement vers un compte de token différent : +Pour envoyer le remboursement vers un compte de jetons différent : ```bash doublezero-solana shreds withdraw \ @@ -241,32 +228,32 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "Retirer des fonds signifie que vous perdez votre siège et l'ancienneté accumulée." +!!! warning "Retirer signifie que vous perdez votre siège et l'ancienneté accumulée." --- -## Adresses de shreds (IP vs Port) +## Adresses des shreds (IP vs Port) -Les shreds Leader et les shreds Retransmit à haut stake 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 heartbeat provenant des éditeurs de shreds — il ne contiendra pas de shreds. +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. -Pour la consommation de shreds, l'**adresse IP** identifie le flux multicast et le **port** identifie le service UDP sur ce flux. +Pour la consommation des 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 IPs de n'importe quel groupe multicast avec : +Vous pouvez examiner les IP de n'importe quel groupe multicast avec : ```bash doublezero multicast group list ``` -### Shreds Leader +### Shreds de leader - `edge-solana-shreds`: `233.84.178.1:7733` -### Shreds Root +### Shreds de racine - `edge-solana-root`: `233.84.178.16:7733` -### Shreds Retransmit +### Shreds de retransmission - `edge-solana-retrans-eu`: `233.84.178.12:7733` - `edge-solana-retrans-apac`: `233.84.178.13:7733` @@ -275,68 +262,68 @@ 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 retirer 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 supprimer l'en-tête GRE avant d'injecter les données dans votre pipeline existant (par ex. un deshredder basé sur XDP)." --- ## Outils et tableaux de bord -### [Tableau de bord Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) +### [Tableau des scores Edge](https://data.malbeclabs.com/dz/shreds/scoreboard) -Le tableau de bord évalue la vitesse de livraison des shreds à travers 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 leader uniquement, en plus de la comparaison du flux complet. Vous pouvez également filtrer 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 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. ### [Éditeurs Edge](https://data.malbeclabs.com/dz/shreds/publishers) -La métrique « Publishing Shreds » en haut à gauche du tableau de bord montre le pourcentage total du poids de stake de tous les validateurs Solana publiant des shreds 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 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. ### [Abonnés, appareils et activité Edge](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 souscriptions 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). +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). ### Documentation de l'API de données -Pour un accès programmatique aux endpoints de données, consultez la documentation de l'API : [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). +Pour un accès programmatique aux points de terminaison de données, consultez la documentation de l'API : [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). --- ## Dépannage -Si vous rencontrez un problème non couvert ici, veuillez nous contacter via votre canal existant avant de tenter 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 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. ### Assurez-vous que votre client est à jour : Exécutez : `sudo apt update && sudo apt install doublezero-solana` -### Solde escrow insuffisant +### Solde de séquestre insuffisant -Si le solde de votre escrow est inférieur au prix de l'epoch lors du règlement, le siège n'est pas attribué, le tunnel est démonté et l'ancienneté est perdue. Réapprovisionnez avec `shreds pay` avant le prochain règlement. +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ège non attribué après paiement -- Vous avez peut-être payé tard dans l'epoch — le siège prend effet à l'epoch suivant. -- Tous les sièges de l'appareil peuvent être occupés par des titulaires ayant une ancienneté supérieure. Vérifiez les sièges disponibles avec `shreds price`. -- Si vous avez retiré vos fonds avant le règlement, le siège n'était pas éligible. +- 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`. +- Si vous avez retiré avant le règlement, le siège n'était pas éligible. ### Le tunnel ne s'établit pas -1. Vérifiez que le daemon est en cours d'exécution : `sudo systemctl status doublezerod` +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` -5. Vérifiez le statut de votre connexion : `doublezero status` +5. Vérifiez l'état de votre connexion : `doublezero status` -L'IP client du daemon 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. +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 La CLI vous avertit lorsqu'il reste moins de 10 % de l'epoch. Vos options : - Accepter avec `--accept-partial-epoch` si vous voulez le siège immédiatement -- Attendre l'epoch suivant pour obtenir une couverture complète d'un epoch +- Attendre l'epoch suivante pour obtenir une couverture complète d'epoch ### « 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 augmentez votre montant. +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. ### « Multicast user already exists » diff --git a/docs/Edge Subscriber Connection.it.md b/docs/Edge Subscriber Connection.it.md index b2be4db..a20aaf5 100644 --- a/docs/Edge Subscriber Connection.it.md +++ b/docs/Edge Subscriber Connection.it.md @@ -3,21 +3,21 @@ description: Configura un edge subscriber per ricevere i feed di shred DoubleZer --- # Connessione Edge Subscriber -!!! warning "Collegandomi 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))." +!!! 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))." -## Passaggio 1: Configurazione di DoubleZero +## Passaggio 1: Configurazione DoubleZero ### 1. Completare la Configurazione -Installare la [Solana CLI](https://docs.anza.xyz/cli/install). +Installa la [Solana CLI](https://docs.anza.xyz/cli/install). -Seguire le istruzioni di [configurazione](setup.md) per installare e configurare il client DoubleZero. +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` ### 2. Configurare il Firewall -Consentire il traffico GRE, BGP, PIM e shred. +Consenti il traffico GRE, BGP, PIM e shred. **iptables:** @@ -49,26 +49,13 @@ Il reconciler monitora lo stato onchain e provisiona automaticamente i tunnel qu doublezero enable ``` -### 4. Recuperare l'Identità DoubleZero del Server - -Verifica la tua Identità DoubleZero. Questa identità verrà utilizzata per creare la connessione tra la tua macchina e DoubleZero. - -```bash -doublezero address -``` - -**Output:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## Passaggio 2: Configurare il Wallet -### 1. Creare un Keypair Solana +### 1. Creare una Keypair Solana -La CLI `doublezero-solana` utilizza un keypair Solana standard per la gestione onchain dei seat. Se non ne hai uno: +La CLI `doublezero-solana` utilizza una keypair Solana standard per la gestione dei seat onchain. Se non ne hai una: ```bash solana-keygen new @@ -86,49 +73,49 @@ solana address Il tuo wallet necessita di due token: -- **SOL** — per le commissioni delle transazioni Solana. Trasferisci SOL all'indirizzo del wallet stampato sopra. +- **SOL** — per le commissioni di transazione 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 -### 1. Trovare il Device Più Vicino +### 1. Trovare il Dispositivo Più Vicino -Prima di acquistare un seat, identifica il device con la latenza più bassa dalla tua macchina: +Prima di acquistare un seat, identifica il dispositivo con la latenza più bassa dalla tua macchina: ```bash doublezero latency ``` -Annota il codice del device dal risultato con la latenza più bassa (es., ``). Lo utilizzerai durante l'acquisto di un seat. +Annota il codice del dispositivo dal risultato con la latenza più bassa (es., ``). Lo utilizzerai per l'acquisto di un seat. ### 2. Verificare i Prezzi -Visualizza i prezzi attuali dei device prima di impegnare fondi. I prezzi hanno due componenti: un **prezzo base metro** e un **sovrapprezzo per device**. I prezzi si aggiornano ad ogni epoch. Puoi anche visualizzare prezzi e disponibilità [qui](https://data.malbeclabs.com/dz/shreds/devices). +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). -**Tutti i device:** +**Tutti i dispositivi:** ```bash doublezero-solana shreds price ``` -**Device specifico:** +**Dispositivo specifico:** ```bash doublezero-solana shreds price --device-code doublezero-solana shreds price --device ``` -**Tutti i device in un metro:** +**Tutti i dispositivi in una metro:** ```bash doublezero-solana shreds price --metro ``` -Colonne di output: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. +Colonne dell'output: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. -Il prezzo per epoch è il costo totale per epoch per un seat su quel device (base + sovrapprezzo). Usa `--wide` per mostrare le pubkey complete, o `--json` per output JSON. +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. ### 3. Acquistare un Seat @@ -145,37 +132,37 @@ doublezero-solana shreds pay \ | Flag | Descrizione | |------|-------------| -| `--device ` | Device target per chiave pubblica (mutuamente esclusivo con `--device-code`) | -| `--device-code ` | Device target per codice leggibile (es., ``) | -| `--client-ip ` | Indirizzo IPv4 pubblico della tua macchina | +| `--device ` | Dispositivo di destinazione tramite chiave pubblica (mutuamente esclusivo con `--device-code`) | +| `--device-code ` | Dispositivo di destinazione 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 delle transazioni SOL | +| `--fee-payer ` | Usa un wallet diverso per le commissioni di transazione SOL | | `--dry-run` | Simula la transazione senza eseguirla | -| `--with-compute-unit-price ` | Imposta un prezzo per compute unit per un'inclusione più rapida durante la congestione | +| `--with-compute-unit-price ` | Imposta un prezzo per unità di calcolo per un'inclusione più rapida durante la congestione | -Una volta allocato il tuo seat, il daemon stabilisce automaticamente il tunnel GRE. Verifica la tua connessione con: +Una volta che il tuo seat è allocato, il daemon stabilisce il tunnel GRE automaticamente. Verifica la tua connessione con: ```bash doublezero status ``` -### Tempistica dell'Epoch +### Tempistiche dell'Epoch -I seat vengono allocati per epoch Solana (~2 giorni). Se rimane meno del 10% dell'epoch corrente quando effettui il 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 quando inizia l'epoch successivo. +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. -!!! info "È consigliabile finanziare per più di 1 epoch alla volta per non perdere il tuo seat. Puoi verificare il tempo rimanente in un epoch [qui](https://explorer.solana.com/)." +!!! 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 l'Escrow Finanziato +### Mantenere il Proprio Escrow Finanziato -!!! warning "Se il saldo del tuo escrow è inferiore al prezzo per epoch al momento del settlement, il tuo seat non verrà allocato, il tunnel verrà abbattuto 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 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 sovra-finanziare 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 per un massimo di 5 epoch senza ri-finanziamento. +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. -Per ricaricare il tuo escrow, esegui nuovamente `shreds pay` in qualsiasi momento: +Per ricaricare il tuo escrow, esegui di nuovo `shreds pay` in qualsiasi momento: ```bash doublezero-solana shreds pay \ @@ -184,7 +171,7 @@ 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 target. +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. ### Monitorare i Seat @@ -198,31 +185,31 @@ Visualizza i tuoi seat attivi e i saldi escrow: doublezero-solana shreds list ``` -**Filtrare per device:** +**Filtra per dispositivo:** ```bash doublezero-solana shreds list --device-code ``` -**Filtrare per IP client:** +**Filtra per IP client:** ```bash doublezero-solana shreds list --client-ip ``` -**Filtrare per wallet:** +**Filtra per wallet:** ```bash doublezero-solana shreds list --withdraw-authority ``` -Colonne di output: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. +Colonne dell'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. ### Prelevare Fondi -Chiudi il tuo escrow e ricevi il rimborso degli USDC rimanenti nel tuo wallet: +Chiudi il tuo escrow e rimborsa gli USDC rimanenti al tuo wallet: ```bash doublezero-solana shreds withdraw \ @@ -230,9 +217,9 @@ doublezero-solana shreds withdraw \ --client-ip ``` -Puoi identificare il device sia tramite `--device ` che `--device-code `, come per gli altri comandi. +Puoi identificare il dispositivo sia con `--device ` che con `--device-code `, come per gli altri comandi. -Per inviare il rimborso a un token account diverso: +Per inviare il rimborso a un account token diverso: ```bash doublezero-solana shreds withdraw \ @@ -241,15 +228,15 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "Prelevare significa perdere il tuo seat e la tenure accumulata." +!!! warning "Prelevare significa perdere il proprio seat e la tenure accumulata." --- ## Indirizzi Shred (IP vs Porta) -I Leader Shred e i Retransmit Shred ad alto stake arriveranno sulla porta `7733`, attraverso l'interfaccia `doublezero1`. L'interfaccia `doublezero0` è per il traffico unicast. La porta `5765` è un monitor heartbeat dai publisher degli shred — non conterrà shred. +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. -Per il consumo degli shred, l'**indirizzo IP** identifica lo stream multicast e la **porta** identifica il servizio UDP su quello stream. +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`. Puoi esaminare gli IP di qualsiasi gruppo multicast con: @@ -258,15 +245,15 @@ Puoi esaminare gli IP di qualsiasi gruppo multicast con: doublezero multicast group list ``` -### Leader Shred +### Shred Leader - `edge-solana-shreds`: `233.84.178.1:7733` -### Root Shred +### Shred Root - `edge-solana-root`: `233.84.178.16:7733` -### Retransmit Shred +### Shred Retransmit - `edge-solana-retrans-eu`: `233.84.178.12:7733` - `edge-solana-retrans-apac`: `233.84.178.13:7733` @@ -275,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 alimentare i dati nella tua pipeline esistente (es. un deshredder basato su 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)." --- @@ -283,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 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. +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. -### [Edge Publisher](https://data.malbeclabs.com/dz/shreds/publishers) +### [Edge Publishers](https://data.malbeclabs.com/dz/shreds/publishers) -La metrica "Publishing Shreds" in alto a sinistra della dashboard mostra la percentuale totale di peso dello stake di tutti i validatori Solana che pubblicano leader shred su DoubleZero Edge. Puoi vedere i dettagli per ogni publisher sulla rete. +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. -### [Edge Subscriber, Device e Attività](https://data.malbeclabs.com/dz/shreds/subscribers) +### [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 specifiche sottoscrizioni dei seat per visualizzare la cronologia dei pagamenti e l'attività. Puoi anche visualizzare i device disponibili nella pagina [Device](https://data.malbeclabs.com/dz/shreds/devices) e tutte le attività recenti nella 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 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). ### Documentazione API Dati -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). +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). --- ## Risoluzione dei Problemi -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. +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. ### Assicurati che il tuo Client sia aggiornato: @@ -309,13 +296,13 @@ Esegui: `sudo apt update && sudo apt install doublezero-solana` ### Saldo escrow insufficiente -Se il saldo del tuo escrow è inferiore al prezzo per epoch al momento del settlement, il seat non viene allocato, il tunnel viene abbattuto e la tenure viene persa. Ricarica con `shreds pay` prima del prossimo settlement. +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. ### Seat non allocato dopo il pagamento -- Potresti aver pagato tardi nell'epoch — il seat diventa effettivo nell'epoch successivo. -- Tutti i seat sul device potrebbero essere occupati da titolari con tenure superiore. Verifica i seat disponibili con `shreds price`. -- Se hai prelevato prima del settlement, il seat non era eleggibile. +- Potresti aver pagato in ritardo nell'epoch — il seat entra in vigore nell'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. ### Il tunnel non si attiva @@ -323,20 +310,20 @@ Se il saldo del tuo escrow è inferiore al prezzo per epoch al momento del settl 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 tua connessione: `doublezero status` +5. Controlla lo stato della connessione: `doublezero status` -L'IP client del daemon viene rilevato automaticamente dall'IP pubblico del tuo host — verifica che corrisponda al `--client-ip` utilizzato nei tuoi comandi seat. +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. -### Prompt di avviso sull'epoch +### Avviso relativo all'epoch La CLI avvisa quando rimane meno del 10% dell'epoch. Le tue opzioni sono: - Accettare con `--accept-partial-epoch` se vuoi il seat immediatamente -- Attendere l'epoch successivo per ottenere una copertura completa dell'epoch +- Attendere il prossimo epoch 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 + sovrapprezzo device). Usa `shreds price` per verificare i prezzi attuali e aumenta il tuo importo. +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. ### "Multicast user already exists" diff --git a/docs/Edge Subscriber Connection.ja.md b/docs/Edge Subscriber Connection.ja.md index a601962..eac76a9 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,51 +43,38 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. リコンサイラーの有効化 -リコンサイラーはオンチェーンの状態を監視し、シートが割り当てられたときに自動的にトンネルをプロビジョニングします。デフォルトでは有効になっていません。 +リコンサイラーはオンチェーン状態を監視し、シートが割り当てられたときに自動的にトンネルをプロビジョニングします。デフォルトでは有効になっていません。 ```bash doublezero enable ``` -### 4. サーバーの DoubleZero アイデンティティの取得 - -DoubleZero アイデンティティを確認します。このアイデンティティは、お使いのマシンと DoubleZero 間の接続を作成するために使用されます。 - -```bash -doublezero address -``` - -**出力:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## ステップ 2: ウォレットのセットアップ ### 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. ウォレットへの入金 -ウォレットには2種類のトークンが必要です: +ウォレットには 2 種類のトークンが必要です： -- **SOL** — Solana のトランザクション手数料用。上記で表示されたウォレットアドレスに SOL を送金してください。 -- **USDC** — シートの資金調達用。CLI はメインネット USDC ミント (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`) のウォレットの Associated Token Account (ATA) から引き出します。 +- **SOL** — Solana トランザクション手数料用。上記で表示されたウォレットアドレスに SOL を送金してください。 +- **USDC** — シートの資金用。CLI はメインネット USDC ミント（`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`）のウォレットの Associated Token Account（ATA）から引き出します。 --- @@ -95,44 +82,44 @@ solana address ### 1. 最寄りのデバイスを見つける -シートを購入する前に、お使いのマシンからレイテンシーが最も低いデバイスを特定します: +シートを購入する前に、お使いのマシンからのレイテンシが最も低いデバイスを特定します： ```bash doublezero latency ``` -最もレイテンシーが低い結果のデバイスコード（例: ``）をメモしてください。シート購入時に使用します。 +最も低いレイテンシの結果からデバイスコードをメモしてください（例：``）。シート購入時にこれを使用します。 -### 2. 料金の確認 +### 2. 価格の確認 -資金をコミットする前に、現在のデバイス料金を確認します。料金は**基本メトロ料金**と**デバイスごとのプレミアム**の2つの要素で構成されます。料金はエポックごとに更新されます。料金と空き状況は[こちら](https://data.malbeclabs.com/dz/shreds/devices)でも確認できます。 +資金を投入する前に、現在のデバイス価格を確認してください。価格は **基本メトロ価格** と **デバイスごとのプレミアム** の 2 つの要素で構成されます。価格はエポックごとに更新されます。価格と空き状況は[こちら](https://data.malbeclabs.com/dz/shreds/devices)でも確認できます。 -**全デバイス:** +**全デバイス：** ```bash doublezero-solana shreds price ``` -**特定のデバイス:** +**特定のデバイス：** ```bash doublezero-solana shreds price --device-code doublezero-solana shreds price --device ``` -**メトロ内の全デバイス:** +**メトロ内の全デバイス：** ```bash 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 \ @@ -141,21 +128,21 @@ doublezero-solana shreds pay \ --amount ``` -**パラメータ:** +**パラメータ：** | フラグ | 説明 | |------|-------------| -| `--device ` | 公開鍵でターゲットデバイスを指定（`--device-code` と排他） | -| `--device-code ` | 人間が読めるコードでターゲットデバイスを指定（例: ``） | +| `--device ` | 公開鍵でターゲットデバイスを指定（`--device-code` と排他的） | +| `--device-code ` | 人間が読めるコードでターゲットデバイスを指定（例：``） | | `--client-ip ` | お使いのマシンのパブリック IPv4 アドレス | -| `--amount ` | 投入する USDC（10進数形式、例: `100` = 100 USDC）。最低エポック料金を満たす必要があります。 | +| `--amount ` | 入金する USDC（10進数形式、例：`100` = 100 USDC）。最低エポック価格を満たす必要があります。 | | `--source-token-account ` | カスタム USDC ソースアカウント（デフォルトはウォレットの ATA） | -| `--accept-partial-epoch` | エポック残り時間の警告をスキップ（下記参照） | +| `--accept-partial-epoch` | エポック残量の警告をスキップ（下記参照） | | `--fee-payer ` | SOL トランザクション手数料に別のウォレットを使用 | -| `--dry-run` | 実行せずにトランザクションをシミュレート | -| `--with-compute-unit-price ` | 混雑時により早く含まれるようにコンピュートユニット価格を設定 | +| `--dry-run` | トランザクションを実行せずにシミュレーション | +| `--with-compute-unit-price ` | 混雑時に処理を高速化するためのコンピュートユニット価格を設定 | -シートが割り当てられると、デーモンが自動的に GRE トンネルを確立します。接続を確認するには: +シートが割り当てられると、デーモンが自動的に GRE トンネルを確立します。接続を確認するには： ```bash doublezero status @@ -163,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 \ @@ -188,41 +175,41 @@ 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) を使用してシートの監視やエスクローアカウントの管理を支援することもできます。 -アクティブなシートとエスクロー残高を表示: +アクティブなシートとエスクロー残高を表示： -**すべてのシート:** +**すべてのシート：** ```bash 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 \ @@ -232,7 +219,7 @@ doublezero-solana shreds withdraw \ 他のコマンドと同様に、`--device ` または `--device-code ` のいずれかでデバイスを指定できます。 -別のトークンアカウントに返金する場合: +別のトークンアカウントに返金を送る場合： ```bash doublezero-solana shreds withdraw \ @@ -241,18 +228,18 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "引き出しを行うと、シートおよび蓄積されたテニュアが失われます。" +!!! warning "引き出しを行うと、シートと蓄積されたテニュアが失われます。" --- -## シュレッドアドレス（IP vs ポート） +## シュレッドアドレス（IP とポート） -リーダーシュレッドおよび高ステークのリトランスミットシュレッドは、`doublezero1` インターフェースを介してポート `7733` で到着します。`doublezero0` インターフェースはユニキャストトラフィック用です。ポート `5765` はシュレッドパブリッシャーからのハートビートモニターであり、シュレッドは含まれません。 +リーダーシュレッドと高ステークのリトランスミットシュレッドは、`doublezero1` インターフェースのポート `7733` で到着します。`doublezero0` インターフェースはユニキャストトラフィック用です。ポート `5765` はシュレッドパブリッシャーからのハートビートモニターであり、シュレッドは含まれません。 -シュレッド消費において、**IP アドレス**はマルチキャストストリームを識別し、**ポート**はそのストリーム上の UDP サービスを識別します。 -以下のすべてのシュレッドストリームは `doublezero1` 上の UDP ポート `7733` を使用します。 +シュレッド消費において、**IP アドレス** はマルチキャストストリームを識別し、**ポート** はそのストリーム上の UDP サービスを識別します。 +以下のすべてのシュレッドストリームは、`doublezero1` 上の UDP ポート `7733` を使用します。 -マルチキャストグループの IP は以下のコマンドで確認できます: +マルチキャストグループの IP は以下のコマンドで確認できます： ```bash doublezero multicast group list @@ -275,7 +262,7 @@ doublezero multicast group list ## GRE トンネルヘッダー — XDP -!!! note "ネットワーク上で配信されるシュレッドトラフィックは GRE カプセル化されています。既存のパイプライン（例: XDP ベースのデシュレッダー）にデータを入力する前に、GRE ヘッダーを除去する必要がある場合があります。" +!!! note "ネットワーク経由で配信されるシュレッドトラフィックは GRE カプセル化されています。既存のパイプライン（例：XDP ベースのデシュレッダー）にデータを渡す前に、GRE ヘッダーを除去する必要がある場合があります。" --- @@ -283,61 +270,61 @@ doublezero multicast group list ### [Edge スコアボード](https://data.malbeclabs.com/dz/shreds/scoreboard) -スコアボードは、DoubleZero Edge と他のプロバイダー間のシュレッド配信速度をベンチマークし、スロットレベルのデータを使用してリアルタイムでパフォーマンスを比較します。このダッシュボードを使用して、他のプロバイダーに対する Edge シュレッドの勝率を確認できます。リーダーシュレッドのみの結果やフルフィード比較を表示できます。また、地域別にドリルダウンして予想されるパフォーマンスを確認することもできます。 +スコアボードは、スロットレベルのデータを使用して、DoubleZero Edge と他のプロバイダー間のシュレッド配信速度をリアルタイムで比較・ベンチマークします。このダッシュボードを使用して、他のプロバイダーに対する Edge シュレッドの勝率を確認できます。リーダーシュレッドのみの結果や、フルフィード比較を表示できます。また、リージョン別にドリルダウンして期待されるパフォーマンスを確認することもできます。 ### [Edge パブリッシャー](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 サブスクライバー、デバイス、アクティビティ](https://data.malbeclabs.com/dz/shreds/subscribers) -このページでクライアント IP を簡単に検索して、購読中のシートとステータスを確認できます。特定のシートサブスクリプションをクリックすると、支払い履歴とアクティビティを表示できます。また、利用可能なデバイスは [Devices](https://data.malbeclabs.com/dz/shreds/devices) ページで、最近のすべてのアクティビティは [Activity](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)。 +データエンドポイントへのプログラムによるアクセスについては、API ドキュメントを参照してください：[https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs)。 --- ## トラブルシューティング -ここでカバーされていない問題が発生した場合は、回避策を講じる前に既存のチャネルを通じてお問い合わせください。チャネルをお持ちでない場合は、[Discord](https://discord.gg/U2fEb4Jq) を検索し、必要に応じてチケットを開いてください。 +ここに記載されていない問題が発生した場合は、回避策を実行する前に、既存のチャネルを通じてお問い合わせください。チャネルをお持ちでない場合は、[Discord](https://discord.gg/U2fEb4Jq) で検索し、必要に応じてチケットを作成してください。 -### クライアントが最新であることを確認: +### クライアントが最新であることを確認： -実行: `sudo apt update && sudo apt install doublezero-solana` +実行：`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` -5. 接続状態を確認: `doublezero status` +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` で受け入れる -- フルエポック分のカバレッジを得るために次のエポックまで待つ +- シートをすぐに取得したい場合は `--accept-partial-epoch` で承認 +- フルエポック分のカバレッジを得るために次のエポックまで待機 ### 「Amount is below the current price」 -`pay` コマンドは、最低エポック料金（メトロ基本料金 + デバイスプレミアム）に対して金額を検証します。`shreds price` で現在の料金を確認し、金額を増やしてください。 +`pay` コマンドは、最低エポック価格（メトロ基本 + デバイスプレミアム）に対して金額を検証します。`shreds price` で現在の価格を確認し、金額を増やしてください。 ### 「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 b1a2f72..39808f9 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 설정 @@ -11,13 +11,13 @@ description: DoubleZero 쉬레드 피드를 수신하기 위한 엣지 구독자 [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. 방화벽 구성 -GRE, BGP, PIM 및 쉬레드 트래픽을 허용합니다. +GRE, BGP, PIM 및 시ュレド 트래픽을 허용합니다. **iptables:** @@ -41,27 +41,14 @@ 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 ``` -### 4. 서버의 DoubleZero ID 확인 - -DoubleZero ID를 확인합니다. 이 ID는 머신과 DoubleZero 간의 연결을 생성하는 데 사용됩니다. - -```bash -doublezero address -``` - -**출력:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## 2단계: 지갑 설정 @@ -74,7 +61,7 @@ YourDoubleZeroAddress11111111111111111111111111111 solana-keygen new ``` -이 명령은 `~/.config/solana/id.json`에 파일을 생성합니다. 다른 경로를 사용하려면 `doublezero-solana` 명령에 `--keypair `를 전달하세요. +이 명령은 `~/.config/solana/id.json`에 저장합니다. 다른 경로를 사용하려면 `doublezero-solana` 명령에 `--keypair `를 전달하세요. 지갑 주소 출력: @@ -82,12 +69,12 @@ solana-keygen new solana address ``` -### 2. 지갑 충전 +### 2. 지갑 자금 충전 지갑에 두 가지 토큰이 필요합니다: - **SOL** — Solana 트랜잭션 수수료용. 위에서 출력된 지갑 주소로 SOL을 전송하세요. -- **USDC** — 시트 펀딩용. CLI는 메인넷 USDC 민트(`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)에 대한 지갑의 Associated Token Account(ATA)에서 인출합니다. +- **USDC** — 시트 자금 충전용. CLI는 메인넷 USDC 민트(`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)에 대한 지갑의 연관 토큰 계정(ATA)에서 자금을 가져옵니다. --- @@ -95,17 +82,17 @@ solana address ### 1. 가장 가까운 장치 찾기 -시트를 구매하기 전에 머신에서 가장 낮은 지연 시간을 가진 장치를 확인합니다: +시트를 구매하기 전에, 머신에서 지연 시간이 가장 낮은 장치를 확인하세요: ```bash doublezero latency ``` -가장 낮은 지연 시간 결과에서 장치 코드(예: ``)를 기록하세요. 시트 구매 시 사용됩니다. +가장 낮은 지연 시간 결과의 장치 코드를 기록하세요(예: ``). 시트 구매 시 이 코드를 사용합니다. ### 2. 가격 확인 -자금을 투입하기 전에 현재 장치 가격을 확인합니다. 가격은 두 가지 구성 요소로 이루어집니다: **기본 메트로 가격**과 **장치별 프리미엄**. 가격은 각 에포크마다 업데이트됩니다. [여기](https://data.malbeclabs.com/dz/shreds/devices)에서 가격 및 가용성을 확인할 수도 있습니다. +자금을 투입하기 전에 현재 장치 가격을 확인하세요. 가격은 **기본 메트로 가격**과 **장치별 프리미엄** 두 가지 구성 요소로 되어 있습니다. 가격은 매 에포크마다 업데이트됩니다. [여기](https://data.malbeclabs.com/dz/shreds/devices)에서 가격과 가용성을 확인할 수도 있습니다. **모든 장치:** @@ -128,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 \ @@ -145,15 +132,15 @@ doublezero-solana shreds pay \ | 플래그 | 설명 | |------|-------------| -| `--device ` | 공개키로 대상 장치 지정(`--device-code`와 상호 배타적) | -| `--device-code ` | 사람이 읽을 수 있는 코드로 대상 장치 지정(예: ``) | +| `--device ` | 공개 키로 대상 장치 지정 (`--device-code`와 상호 배타적) | +| `--device-code ` | 사람이 읽을 수 있는 코드로 대상 장치 지정 (예: ``) | | `--client-ip ` | 머신의 공개 IPv4 주소 | -| `--amount ` | 펀딩할 USDC(소수점 형식, 예: `100` = 100 USDC). 최소 에포크 가격을 충족해야 합니다. | -| `--source-token-account ` | 사용자 정의 USDC 소스 계정(기본값: 지갑의 ATA) | -| `--accept-partial-epoch` | 에포크 잔여 경고 건너뛰기(아래 참조) | +| `--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 터널을 설정합니다. 다음 명령으로 연결을 확인하세요: @@ -163,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`로 이 경고를 무시할 수 있습니다. -### 에스크로 잔액 유지 +### 에스크로 자금 유지 -!!! warning "정산 시 에스크로 잔액이 에포크 가격 미만이면 시트가 할당되지 않고, 터널이 해제되며, 누적된 재직 기간이 소멸됩니다. 재직 기간은 향후 에포크에 대한 우선순위를 결정하므로, 이를 잃으면 신규 참가자와 동일하게 경쟁하게 됩니다." +!!! warning "정산 시 에스크로 잔액이 에포크 가격보다 낮으면, 시트가 할당되지 않고, 터널이 해제되며, 누적된 재직 기간(tenure)을 잃게 됩니다. 재직 기간은 향후 에포크에서의 우선순위를 결정합니다 — 이를 잃으면 신규 참가자로서 다시 경쟁해야 합니다." -이 계정에 초과 충전하여 여러 에포크를 펀딩할 수 있습니다. 각 정산 시 에스크로에서 1 에포크 가격이 차감되며, 나머지 잔액은 이월됩니다. 예를 들어, 에포크당 가격의 5배를 충전하면 재충전 없이 최대 5 에포크 동안 시트를 유지할 수 있습니다. +이 계정에 초과 충전하여 여러 에포크를 자금으로 충당할 수 있습니다. 각 정산 시 에스크로에서 1 에포크 가격이 차감되고, 나머지 잔액은 이월됩니다. 예를 들어, 에포크당 가격의 5배를 충전하면 재충전 없이 최대 5 에포크 동안 시트를 유지할 수 있습니다. -에스크로를 추가 충전하려면 언제든지 `shreds pay`를 다시 실행하세요: +에스크로를 충전하려면 언제든지 `shreds pay`를 다시 실행하세요: ```bash doublezero-solana shreds pay \ @@ -184,13 +171,13 @@ 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)를 사용하여 시트를 모니터링하고 에스크로 계정을 관리할 수도 있습니다. -활성 시트 및 에스크로 잔액 조회: +활성 시트와 에스크로 잔액을 확인하세요: **모든 시트:** @@ -218,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 \ @@ -230,9 +217,9 @@ doublezero-solana shreds withdraw \ --client-ip ``` -다른 명령과 동일하게 `--device ` 또는 `--device-code `로 장치를 식별할 수 있습니다. +다른 명령과 마찬가지로 `--device ` 또는 `--device-code `로 장치를 식별할 수 있습니다. -환불을 다른 토큰 계정으로 보내려면: +다른 토큰 계정으로 환불을 보내려면: ```bash doublezero-solana shreds withdraw \ @@ -241,16 +228,16 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "인출하면 시트와 누적된 재직 기간을 잃게 됩니다." +!!! 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를 확인할 수 있습니다: @@ -258,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` @@ -275,7 +262,7 @@ doublezero multicast group list ## GRE 터널 헤더 — XDP -!!! note "네트워크를 통해 전달되는 쉬레드 트래픽은 GRE로 캡슐화되어 있습니다. 기존 파이프라인(예: XDP 기반 디쉬레더)에 데이터를 공급하기 전에 GRE 헤더를 제거해야 할 수 있습니다." +!!! note "네트워크를 통해 전달되는 시ュ레ド 트래픽은 GRE로 캡슐화되어 있습니다. 기존 파이프라인(예: XDP 기반 디シュレダ)에 데이터를 공급하기 전에 GRE 헤더를 제거해야 할 수 있습니다." --- @@ -283,25 +270,25 @@ 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) 페이지에서 최근 활동을 확인할 수도 있습니다. -### 데이터 API 문서 +### Data API 문서 -데이터 엔드포인트에 대한 프로그래밍 방식 접근은 API 문서를 참조하세요: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). +데이터 엔드포인트에 프로그래밍 방식으로 접근하려면 API 문서를 참조하세요: [https://data.malbeclabs.com/api/v1/docs](https://data.malbeclabs.com/api/v1/docs). --- ## 문제 해결 -여기에서 다루지 않는 문제가 발생하면, 임시 해결 방법을 시도하기 전에 기존 채널을 통해 문의하세요. 채널이 없는 경우 [Discord](https://discord.gg/U2fEb4Jq)에서 검색하고 필요 시 티켓을 열어주세요. +여기에서 다루지 않은 문제가 발생하면, 우회 방법을 시도하기 전에 기존 채널을 통해 연락하세요. 채널이 없는 경우 [Discord](https://discord.gg/U2fEb4Jq)에서 검색하고 필요 시 티켓을 생성하세요. ### 클라이언트가 최신 버전인지 확인: @@ -309,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) +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`로 수락 +- 전체 에포크 커버리지를 위해 다음 에포크까지 대기 -### "Amount is below the current price" +### "금액이 현재 가격 미만입니다" `pay` 명령은 최소 에포크 가격(메트로 기본 + 장치 프리미엄)에 대해 금액을 검증합니다. `shreds price`로 현재 가격을 확인하고 금액을 늘리세요. -### "Multicast user already exists" +### "멀티캐스트 사용자가 이미 존재합니다" 다른 경로를 통한 활성 구독이 이미 있습니다. 먼저 `doublezero disconnect`로 연결을 해제한 후 `shreds pay`를 다시 시도하세요. \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.pt.md b/docs/Edge Subscriber Connection.pt.md index cbf4c89..d76c01a 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 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 shreds 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, eu concordo com os [Termos de Uso do DoubleZero](https://doublezero.xyz/terms-protocol). Observe que os dados são apenas para seus fins internos e não podem ser retransmitidos (consulte a Seção 2(e))." +!!! 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))." ## 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 a versão mais recente do Doublezero-Solana CLI com `sudo apt update && sudo apt install doublezero-solana` +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` ### 2. Configurar o Firewall @@ -43,25 +43,12 @@ sudo ufw allow in on doublezero0 to any port 44880 proto udp ### 3. Habilitar o Reconciliador -O reconciliador monitora o estado onchain e provisiona túneis automaticamente quando seu assento é alocado. Ele não é habilitado por padrão. +O reconciliador monitora o estado onchain e provisiona automaticamente os túneis quando seu assento é alocado. Ele não é habilitado por padrão. ```bash doublezero enable ``` -### 4. Recuperar a Identidade DoubleZero do Servidor - -Verifique sua Identidade DoubleZero. Esta identidade será usada para criar a conexão entre sua máquina e o DoubleZero. - -```bash -doublezero address -``` - -**Saída:** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## Passo 2: Configurar Sua Carteira @@ -86,14 +73,14 @@ solana address Sua carteira precisa de dois tokens: -- **SOL** — para taxas de transação Solana. Transfira SOL para o endereço da carteira exibido acima. +- **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`). --- ## Passo 3: Comprar um Assento -### 1. Encontrar o Dispositivo Mais Próximo +### 1. Encontre Seu Dispositivo Mais Próximo Antes de comprar um assento, identifique o dispositivo com a menor latência a partir da sua máquina: @@ -105,7 +92,7 @@ Anote o código do dispositivo com o resultado de menor latência (ex.: ` doublezero-solana shreds price --metro ``` -Colunas da saída: `Device Code`, `Metro Code`, `Metro Name`, `Status`, `Settled Seats`, `Available Seats`, `Base Price (USDC)`, `Premium (USDC)`, `Epoch Price (USDC)`. +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. @@ -148,8 +135,8 @@ 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 ao preço mínimo da época. | -| `--source-token-account ` | Conta USDC de origem personalizada (padrão é a ATA da sua carteira) | +| `--amount ` | USDC a financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender o preço mínimo da época. | +| `--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) | | `--fee-payer ` | Usar uma carteira diferente para taxas de transação SOL | | `--dry-run` | Simular a transação sem executá-la | @@ -163,7 +150,7 @@ doublezero status ### Temporização de Época -Os assentos são alocados por época Solana (~2 dias). Se restar menos de 10% da época atual quando você pagar, o CLI avisa que seu assento será alocado imediatamente, mas cobre 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 é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. !!! 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/)." @@ -171,11 +158,11 @@ 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 no momento da liquidação, seu assento não será alocado, o túnel será encerrado e você perderá sua antiguidade acumulada. A antiguidade determina sua prioridade para épocas futuras — perdê-la significa que você compete como um novato novamente." +!!! 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." -Você pode sobrefinanciar esta conta para financiar múltiplas épocas. Cada liquidação deduz o preço de uma época do seu escrow, e o saldo restante é transportado para a próxima. Por exemplo, financiar 5x o preço por época mantém seu assento ativo por até 5 épocas sem refinanciamento. +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. -Para reabastecer seu escrow, execute `shreds pay` novamente a qualquer momento: +Para recarregar seu escrow, execute `shreds pay` novamente a qualquer momento: ```bash doublezero-solana shreds pay \ @@ -216,13 +203,13 @@ doublezero-solana shreds list --client-ip doublezero-solana shreds list --withdraw-authority ``` -Colunas da saída: `Device Code`, `Client IP`, `Tenure`, `Balance (USDC)`, `Est. Epochs Paid`. +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 nos preços atuais. Se os preços mudarem, esta estimativa se ajusta. +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. -### Retirar Fundos +### Sacar Fundos -Feche seu escrow e reembolse o USDC restante para sua carteira: +Encerre seu escrow e reembolse o USDC restante para sua carteira: ```bash doublezero-solana shreds withdraw \ @@ -241,13 +228,13 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "Retirar significa que você perde seu assento e a antiguidade acumulada." +!!! warning "Sacar significa que você perde seu assento e a permanência acumulada." --- -## Endereços de Shred (IP vs Porta) +## Endereços de Shreds (IP vs Porta) -Shreds de Líder e Shreds de Retransmissão de alto stake chegarão pela porta `7733`, na interface `doublezero1`. A interface `doublezero0` é para tráfego unicast. A porta `5765` é um monitor de heartbeat dos publicadores de shreds — esta não conterá shreds. +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. 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`. @@ -283,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 em comparação com outros provedores. Você pode visualizar resultados apenas para shreds de líder, além de comparação do feed completo. 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 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. ### [Publicadores do Edge](https://data.malbeclabs.com/dz/shreds/publishers) -A métrica "Publishing Shreds" no canto superior esquerdo do painel mostra a porcentagem 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. +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 específicas de assentos para visualizar histórico de pagamentos e atividade. Você também pode visualizar dispositivos disponíveis na página [Dispositivos](https://data.malbeclabs.com/dz/shreds/devices) e toda a atividade recente na página [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í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). ### Documentação da API de Dados @@ -309,13 +296,13 @@ 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 no momento da liquidação, o assento não é alocado, o túnel é encerrado e a antiguidade é perdida. Recarregue com `shreds pay` antes da próxima liquidação. +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. ### Assento não alocado após 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 antiguidade. Verifique os assentos disponíveis com `shreds price`. -- Se você retirou antes da liquidação, o assento não era elegível. +- 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. ### Túnel não está subindo @@ -325,14 +312,14 @@ Se o saldo do seu escrow estiver abaixo do preço da época no momento da liquid 4. Verifique se seu assento está ativo para a época atual: `doublezero-solana shreds list` 5. Verifique o status da sua conexão: `doublezero status` -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. +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. ### Aviso de época O CLI avisa quando resta menos de 10% da época. Suas opções: - Aceitar com `--accept-partial-epoch` se você quiser o assento imediatamente -- Aguardar a próxima época para obter a cobertura de uma época completa +- Aguardar a próxima época para obter cobertura de uma época completa ### "Amount is below the current price" @@ -340,4 +327,4 @@ O comando `pay` valida seu valor contra o preço mínimo da época (base do metr ### "Multicast user already exists" -Você já possui uma assinatura ativa através de um caminho diferente. Desconecte primeiro com `doublezero disconnect`, depois tente `shreds pay` novamente. \ No newline at end of file +Você já tem uma assinatura ativa por um caminho diferente. Desconecte primeiro com `doublezero disconnect`, depois tente novamente `shreds pay`. \ No newline at end of file diff --git a/docs/Edge Subscriber Connection.zh.md b/docs/Edge Subscriber Connection.zh.md index a699e6d..c65cf04 100644 --- a/docs/Edge Subscriber Connection.zh.md +++ b/docs/Edge Subscriber Connection.zh.md @@ -13,13 +13,13 @@ description: 设置边缘订阅者以接收 DoubleZero 分片数据流，包括 按照[设置](setup.md)说明安装和配置 DoubleZero 客户端。 -如果您之前已经设置过 DoubleZero，请确保您拥有最新的 Doublezero-Solana CLI，运行 `sudo apt update && sudo apt install doublezero-solana` +如果您之前已设置过 DoubleZero，请确保您拥有最新的 Doublezero-Solana CLI，运行 `sudo apt update && sudo apt install doublezero-solana` ### 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 @@ -41,27 +41,14 @@ 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 ``` -### 4. 获取服务器的 DoubleZero 身份 - -查看您的 DoubleZero 身份。此身份将用于创建您的机器与 DoubleZero 之间的连接。 - -```bash -doublezero address -``` - -**输出：** -``` -YourDoubleZeroAddress11111111111111111111111111111 -``` - --- ## 步骤 2：设置您的钱包 @@ -74,7 +61,7 @@ YourDoubleZeroAddress11111111111111111111111111111 solana-keygen new ``` -这将写入 `~/.config/solana/id.json`。要使用不同的路径，请在任何 `doublezero-solana` 命令中传递 `--keypair `。 +这将写入 `~/.config/solana/id.json`。如需使用不同路径，请向任何 `doublezero-solana` 命令传递 `--keypair `。 打印您的钱包地址： @@ -86,14 +73,14 @@ solana address 您的钱包需要两种代币： -- **SOL** — 用于 Solana 交易费用。将 SOL 转账到上面打印的钱包地址。 -- **USDC** — 用于席位充值。CLI 从您钱包的关联代币账户 (ATA) 中提取主网 USDC 铸币 (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)。 +- **SOL** — 用于 Solana 交易费用。将 SOL 转入上面打印的钱包地址。 +- **USDC** — 用于席位资金。CLI 从您钱包的关联代币账户（ATA）中提取主网 USDC 铸币（`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`）。 --- ## 步骤 3：购买席位 -### 1. 找到最近的设备 +### 1. 查找最近的设备 在购买席位之前，找到距离您机器延迟最低的设备： @@ -101,11 +88,11 @@ solana address doublezero latency ``` -记下延迟最低结果中的设备代码（例如 ``）。购买席位时将用到它。 +记下延迟最低结果中的设备代码（例如 ``）。您在购买席位时将使用此代码。 ### 2. 查看定价 -在投入资金之前查看当前设备定价。定价由两部分组成：**基础都会区价格**和**每设备溢价**。价格每个纪元更新。您也可以在[这里](https://data.malbeclabs.com/dz/shreds/devices)查看定价和可用性。 +在投入资金之前查看当前设备定价。定价由两部分组成：**基础都会区价格**和**每设备溢价**。价格每个纪元更新。您也可以在[此处](https://data.malbeclabs.com/dz/shreds/devices)查看定价和可用性。 **所有设备：** @@ -120,7 +107,7 @@ doublezero-solana shreds price --device-code doublezero-solana shreds price --device ``` -**都会区内所有设备：** +**某个都会区的所有设备：** ```bash doublezero-solana shreds price --metro @@ -128,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 \ @@ -146,16 +133,16 @@ doublezero-solana shreds pay \ | 标志 | 描述 | |------|-------------| | `--device ` | 通过公钥指定目标设备（与 `--device-code` 互斥） | -| `--device-code ` | 通过人类可读代码指定目标设备（例如 ``） | -| `--client-ip ` | 您机器的公共 IPv4 地址 | -| `--amount ` | 充值的 USDC 金额（十进制格式，例如 `100` = 100 USDC）。必须达到最低纪元价格。 | -| `--source-token-account ` | 自定义 USDC 源账户（默认为您钱包的 ATA） | +| `--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 ` | 设置计算单元价格以在拥堵时加快交易确认 | +| `--with-compute-unit-price ` | 设置计算单元价格，以在拥堵时更快被包含 | -一旦您的席位被分配，守护进程将自动建立 GRE 隧道。使用以下命令检查您的连接： +一旦您的席位被分配，守护进程会自动建立 GRE 隧道。使用以下命令检查您的连接： ```bash doublezero status @@ -163,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 "如果在结算时您的托管账户余额低于纪元价格，您的席位将不会被分配，隧道将被拆除，您将失去累积的任期。任期决定您在未来纪元中的优先级——失去任期意味着您将作为新用户重新竞争。" -您可以超额充值此账户以支付多个纪元。每次结算从您的托管账户中扣除一个纪元的价格，剩余余额将结转。例如，充值 5 倍的每纪元价格可使您的席位在最多 5 个纪元内保持活跃而无需重新充值。 +您可以向此账户超额充值以资助多个纪元。每次结算从您的托管账户中扣除一个纪元的价格，剩余余额结转。例如，充值 5 倍的每纪元价格可以保持您的席位最多活跃 5 个纪元而无需再次充值。 -要随时追加托管账户余额，再次运行 `shreds pay`： +要随时为托管账户充值，请再次运行 `shreds pay`： ```bash doublezero-solana shreds pay \ @@ -184,11 +171,11 @@ 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) 来监控席位，并协助管理您的托管账户。 查看您的活跃席位和托管余额： @@ -218,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 \ @@ -232,7 +219,7 @@ doublezero-solana shreds withdraw \ 您可以通过 `--device ` 或 `--device-code ` 来指定设备，与其他命令相同。 -要将退款发送到不同的代币账户： +将退款发送到不同的代币账户： ```bash doublezero-solana shreds withdraw \ @@ -241,16 +228,16 @@ doublezero-solana shreds withdraw \ --refund-token-account ``` -!!! warning "提取资金意味着您将失去席位和累积的任期。" +!!! warning "提取意味着您将失去席位和累积的任期。" --- ## 分片地址（IP 与端口） -领导者分片和高质押转发分片将通过 `doublezero1` 接口的端口 `7733` 到达。`doublezero0` 接口用于单播流量。端口 `5765` 是来自分片发布者的心跳监控——不包含分片数据。 +Leader 分片和高质押 Retransmit 分片将通过 `doublezero1` 接口的端口 `7733` 到达。`doublezero0` 接口用于单播流量。端口 `5765` 是来自分片发布者的心跳监控——其中不包含分片数据。 对于分片消费，**IP 地址**标识组播流，**端口**标识该流上的 UDP 服务。 -以下所有分片流均使用 `doublezero1` 上的 UDP 端口 `7733`。 +以下所有分片流都使用 `doublezero1` 上的 UDP 端口 `7733`。 您可以使用以下命令查看任何组播组的 IP： @@ -258,15 +245,15 @@ doublezero-solana shreds withdraw \ 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` @@ -275,7 +262,7 @@ doublezero multicast group list ## GRE 隧道头部 — XDP -!!! note "通过网络传输的分片流量是 GRE 封装的。在将数据送入现有管道（例如基于 XDP 的反分片器）之前，您可能需要剥离 GRE 头部。" +!!! note "通过网络传输的分片流量是 GRE 封装的。在将数据送入您现有的处理管道（例如基于 XDP 的分片重组器）之前，您可能需要剥离 GRE 头部。" --- @@ -283,15 +270,15 @@ doublezero multicast group list ### [边缘排行榜](https://data.malbeclabs.com/dz/shreds/scoreboard) -排行榜使用插槽级数据对 DoubleZero Edge 和其他提供商的分片传输速度进行基准测试，实时比较性能。使用此仪表板查看 Edge 分片相对于其他提供商的胜率。您可以查看仅限领导者分片的结果，以及完整数据流对比。您还可以按区域深入查看预期性能。 +排行榜对比 DoubleZero Edge 和其他提供商之间的分片传输速度，使用槽级数据实时比较性能。使用此仪表板可以查看 Edge 分片相对于其他提供商的胜率。您可以仅查看 leader 分片的结果，也可以查看完整数据流的对比。您还可以按区域深入查看预期性能。 ### [边缘发布者](https://data.malbeclabs.com/dz/shreds/publishers) -仪表板左上角的"Publishing Shreds"指标显示在 DoubleZero Edge 上发布领导者分片的所有 Solana 验证者的总质押权重百分比。您可以查看网络上每个发布者的详细信息。 +仪表板左上角的"Publishing Shreds"指标显示在 DoubleZero Edge 上发布 leader 分片的所有 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 文档 @@ -301,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` +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