Skip to content

remove DZ address instruction #187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Jared-dz merged 2 commits into from
Jul 23, 2026
Merged

remove DZ address instruction #187

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0212b9b
remove DZ address instruction
Jared-dz Jul 23, 2026
752eca4
chore: auto-translate docs
github-actions[bot] Jul 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 51 additions & 64 deletions docs/Edge Subscriber Connection.es.md
View file
Open in desktop

Large diffs are not rendered by default.

115 changes: 51 additions & 64 deletions docs/Edge Subscriber Connection.fr.md
View file
Open in desktop

Large diffs are not rendered by default.

135 changes: 61 additions & 74 deletions docs/Edge Subscriber Connection.it.md
View file
Open in desktop

Large diffs are not rendered by default.

169 changes: 78 additions & 91 deletions docs/Edge Subscriber Connection.ja.md
View file
Open in desktop

Large diffs are not rendered by default.

135 changes: 61 additions & 74 deletions docs/Edge Subscriber Connection.ko.md
View file
Open in desktop

Large diffs are not rendered by default.

13 changes: 0 additions & 13 deletions docs/Edge Subscriber Connection.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
73 changes: 30 additions & 43 deletions docs/Edge Subscriber Connection.pt.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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

Expand Down Expand Up @@ -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
Expand All @@ -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:

Expand All @@ -105,7 +92,7 @@ Anote o código do dispositivo com o resultado de menor latência (ex.: `<Device

### 2. Verificar Preços

Consulte os preços atuais dos dispositivos antes de comprometer fundos. Os preços têm dois componentes: um **preço base do metro** e um **prêmio por dispositivo**. Os preços são atualizados a cada época. Você também pode consultar preços e disponibilidade [aqui](https://data.malbeclabs.com/dz/shreds/devices).
Consulte os preços atuais dos dispositivos antes de comprometer fundos. Os preços têm dois componentes: um **preço base do metro** e um **prêmio por dispositivo**. Os preços são atualizados a cada época. Você também pode visualizar preços e disponibilidade [aqui](https://data.malbeclabs.com/dz/shreds/devices).

**Todos os dispositivos:**

Expand All @@ -126,7 +113,7 @@ doublezero-solana shreds price --device <PUBKEY>
doublezero-solana shreds price --metro <PUBKEY>
```

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.

Expand All @@ -148,8 +135,8 @@ doublezero-solana shreds pay \
| `--device <PUBKEY>` | Dispositivo alvo por chave pública (mutuamente exclusivo com `--device-code`) |
| `--device-code <CODE>` | Dispositivo alvo por código legível (ex.: `<Device_Name>`) |
| `--client-ip <IP>` | Endereço IPv4 público da sua máquina |
| `--amount <USDC>` | USDC a financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender ao preço mínimo da época. |
| `--source-token-account <PUBKEY>` | Conta USDC de origem personalizada (padrão é a ATA da sua carteira) |
| `--amount <USDC>` | USDC a financiar (formato decimal, ex.: `100` = 100 USDC). Deve atender o preço mínimo da época. |
| `--source-token-account <PUBKEY>` | 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 <PATH>` | Usar uma carteira diferente para taxas de transação SOL |
| `--dry-run` | Simular a transação sem executá-la |
Expand All @@ -163,19 +150,19 @@ 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/)."

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 \
Expand Down Expand Up @@ -216,13 +203,13 @@ doublezero-solana shreds list --client-ip <Target_IP>
doublezero-solana shreds list --withdraw-authority <PUBKEY>
```

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 \
Expand All @@ -241,13 +228,13 @@ doublezero-solana shreds withdraw \
--refund-token-account <PUBKEY>
```

!!! 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`.
Expand Down Expand Up @@ -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

Expand All @@ -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

Expand All @@ -325,19 +312,19 @@ 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"

O comando `pay` valida seu valor contra o preço mínimo da época (base do metro + prêmio do dispositivo). Use `shreds price` para verificar os preços atuais e aumente seu valor.

### "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.
Você já tem uma assinatura ativa por um caminho diferente. Desconecte primeiro com `doublezero disconnect`, depois tente novamente `shreds pay`.
Loading