Skip to content

Commit c97b2d8

Browse files
authored
Merge pull request #245 from lukedevj/portuguese-translation-chapter-03
Chapter 3 Translated
2 parents 0ca4a04 + 0301a29 commit c97b2d8

5 files changed

+623
-0
lines changed
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Capítulo 3: Compreendendo a configuração do node Bitcoin
2+
3+
Agora que estamos prontos para começar a trabalhar com a interface de linha de comando `bitcoin-cli`. Mas isso requer primeiro que entendamos a configuração do Bitcoin e os recursos da carteira, que é o que será explicado neste capítulo.
4+
5+
Neste e nos próximos capítulos, presumimos que uma VPS com Bitcoin instalado esteja sendo utilizada, e que iremos executar o `bitcoind`. Também presumimos que estamos conectados à testnet, permitindo o acesso a bitcoins sem usar fundos reais. Podemos fazer isso com Bitcoin Standup em linode.com, como vimos na sessão [2.1: Configurando um Bitcoin-Core no VPS c Bitcoin Standup](02_1_Setting_Up_a_Bitcoin-Core_VPS_with_StackScript.md), ou usando os demais métodos, descritos na sessão [2.2: Configurando um node Bitcoin Core por outros métodos](02_2_Setting_Up_Bitcoin_Core_Other.md).
6+
7+
## Objetivos deste Capítulo
8+
9+
Depois de trabalhar neste capítulo, um desenvolvedor será capaz de:
10+
11+
* Demonstrar que o node Bitcoin está instalado e atualizado;
12+
* Criar um endereço para receber bitcoins;
13+
* Usar os comandos básicos da carteira;
14+
* Criar um endereço a partir de um descritor.
15+
16+
Os objetivos secundários incluem a capacidade de:
17+
18+
* Compreender o layout básico do arquivo Bitcoin;
19+
* Usar comandos informativos básicos;
20+
* Entender o que é um endereço Bitcoin;
21+
* Entender o que é uma carteira;
22+
* Entender como importar endereços.
23+
24+
## Tabela de Conteúdo
25+
26+
* [Seção Um: Verificando a configuração do seu node Bitcoin](03_1_Verifying_Your_Bitcoin_Setup.md)
27+
* [Seção Dois: conhecendo a configuração do seu node Bitcoin](03_2_Knowing_Your_Bitcoin_Setup.md)
28+
* [Seção Três: Configurando sua carteira](03_3_Setting_Up_Your_Wallet.md)
29+
* [Usando variável de linha de comando](03_3__Interlude_Using_Command-Line_Variables.md)
30+
* [Seção Quatro: Recebendo uma transação](03_4_Receiving_a_Transaction.md)
31+
* [Seção Cinco: Entendendo um descritor](03_5_Understanding_the_Descriptor.md)
Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
2+
# 3.1: Verificando a configuração do node Bitcoin
3+
4+
Antes de começarmos a brincar com Bitcoin, devemos nos certificar de que tudo está configurado corretamente.
5+
6+
## Crie os aliases
7+
8+
Sugerimos a criação de alguns aliases (um tipo de atalho) para facilitar o uso do Bitcoin.
9+
10+
Podemos fazer isso colocando-os em nosso `.bash_profile`, `.bashrc` ou no `.profile`.
11+
```
12+
cat >> ~/.bash_profile <<EOF
13+
alias btcdir="cd ~/.bitcoin/" #linux default bitcoind path
14+
alias bc="bitcoin-cli"
15+
alias bd="bitcoind"
16+
alias btcinfo='bitcoin-cli getwalletinfo | egrep "\"balance\""; bitcoin-cli getnetworkinfo | egrep "\"version\"|connections"; bitcoin-cli getmininginfo | egrep "\"blocks\"|errors"'
17+
EOF
18+
```
19+
Depois de inserir os aliases, podemos usar o comando `source .bash_profile` para inseri-los ou apenas efetuar logout/login novamente.
20+
21+
Observe que os aliases incluem atalhos para executar o `bitcoin-cli`, o `bitcoind` e para ir ao diretório Bitcoin. Esses aliases têm como objetivo principal tornar a nossa vida mais fácil, por isso que damos a sugestão de criar outros apelidos para facilitar o uso de comandos frequentes (e argumentos) e também para minimizar erros. Os aliases desse tipo podem ser ainda mais úteis se tivermos uma configuração complexa onde regularmente executamos comandos associados a Mainnet, com Testnet, _e_ com Regtest, conforme explicaremos mais à frente.
22+
23+
Dito isso, o uso desses aliases _neste_ documento pode acidentalmente deixar algumas das lições principais onde ensinamos sobre o Bitcoin no escuro, então o único alias que usaremos diretamente aqui é `btcinfo` porque ele encapsula um comando muito mais longo e complexo. Caso contrário, iremos mostrar os comandos completos, por isso, podemos ajustar os aliases para nosso próprio uso conforme apropriado.
24+
25+
## Executando o Bitcoind
26+
27+
Começaremos nossa exploração da rede Bitcoin com o comando `bitcoin-cli`. No entanto, o `bitcoind` _deve_ estar em execução para conseguirmos usar o bitcoin-cli, pois ele envia comandos JSON-RPC para o bitcoind. Se estivermos usando a configuração padrão, o bitcoind já deve estar instalado e funcionando. Podemos verificar olhando a tabela de processos.
28+
```
29+
$ ps auxww | grep bitcoind
30+
standup 455 1.3 34.4 3387536 1392904 ? SLsl Jun16 59:30 /usr/local/bin/bitcoind -conf=/home/standup/.bitcoin/bitcoin.conf
31+
```
32+
33+
Se ele não estiver listado, podemos executar o `/usr/local/bin/bitcoind -daemon` manualmente e também colocá-lo em crontab.
34+
35+
## Verificando os blocos
36+
37+
Vamos partir do pressuposto que já tenhamos baixado todo o blockchain antes de começarmos a brincar. Basta executar o comando `bitcoin-cli getblockcount` para ver tudo está carregado corretamente.
38+
```
39+
$ bitcoin-cli getblockcount
40+
1772384
41+
```
42+
Isso indica que está carregado. Precisamos verificar isso em um serviço online que informa a altura atual do bloco.
43+
44+
> :book: ***O que é a altura do bloco?*** A altura do bloco é a distância que um bloco particular está do bloco de gênese. A altura do bloco atual é a altura do bloco mais recente adicionado a blockchain.
45+
46+
Podemos fazer isso olhando um explorador, como o [Mempool Space Explorer](https://mempool.space/pt/testnet). É o número mais recente corresponde ao `getblockcount`? Se sim, nossa blockchain está atualizada.
47+
48+
Se quisermos que um alias veja tudo de uma vez, o código abaixo funciona normalmente no Testnet, mas pode desaparecer em algum momento no futuro:
49+
```
50+
$ cat >> ~/.bash_profile << EOF
51+
alias btcblock="echo \\\`bitcoin-cli getblockcount 2>&1\\\`/\\\`wget -O - https://blockstream.info/testnet/api/blocks/tip/height 2> /dev/null | cut -d : -f2 | rev | cut -c 1- | rev\\\`"
52+
EOF
53+
$ source .bash_profile
54+
$ btcblock
55+
1804372/1804372
56+
```
57+
58+
> :link: **TESTNET vs MAINNET:** Lembre-se de que este tutorial geralmente assume que estamos usando a Testnet. Se estivermos usando a mainnet, podemos recuperar a altura do bloco atual usando a seguinte linha de comando: `wget -O - https://mempool.space/testnet/api/blocks/tip/height 2> /dev/ null`. Podemos substituir a última metade do alias `btblock` (após `/`) por isso.
59+
60+
Se a nossa blockchain não estiver atualizada, mas nosso `getblockcount` estiver aumentando, não há problema. O tempo total de download pode levar de uma a várias horas, dependendo da configuração.
61+
62+
## Opcional: Conhecendo os tipos de servidores
63+
64+
> **TESTNET vs MAINNET:** Ao configurar o node Bitcoin, precisamos escolher se vamos criá-lo como sendo um Mainnet, Testnet ou Regtest. Embora este documento presuma uma configuração de Testnet, vale a pena entender como podemos acessar e usar os outros tipos de configuração, inclusive, como ter todos na mesma máquina! Mas, se formos iniciantes, podemos pular isso, pois não é necessário para uma configuração básica.
65+
66+
O tipo de configuração é controlado principalmente por meio do arquivo `~/.bitcoin/bitcoin.conf`. Se estivermos executando o Testnet, provavelmente teremos a seguinte linha:
67+
```
68+
testnet=1
69+
```
70+
Se estivermos executando a Regtest, provavelmente teremos essa linha:
71+
```
72+
regtest=1
73+
```
74+
No entanto, se desejarmos executar vários tipos diferentes de nós simultaneamente, devemos deixar o um sinalizador Testnet (ou Regtest) fora do nosso arquivo de configuração. Podemos então escolher se estamos usando a Mainnet, Testnet ou Regtest toda vez que executarmos o bitcoind ou o bitcoin-cli.
75+
76+
Aqui está um conjunto de aliases que tornariam isso mais fácil, criando um alias específico para iniciar e parar o bitcoind, para ir para o diretório bitcoin e para executar o bitcoin-cli, na Mainnet (que não tem sinalizadores extras), no Testnet (que é -testnet), ou no nosso Regtest (que é -regtest).
77+
```
78+
cat >> ~/.bash_profile <<EOF
79+
alias bcstart="bitcoind -daemon"
80+
alias btstart="bitcoind -testnet -daemon"
81+
alias brstart="bitcoind -regtest -daemon"
82+
83+
alias bcstop="bitcoin-cli stop"
84+
alias btstop="bitcoin-cli -testnet stop"
85+
alias brstop="bitcoin-cli -regtest stop"
86+
87+
alias bcdir="cd ~/.bitcoin/" #linux default bitcoin path
88+
alias btdir="cd ~/.bitcoin/testnet" #linux default bitcoin testnet path
89+
alias brdir="cd ~/.bitcoin/regtest" #linux default bitcoin regtest path
90+
91+
alias bc="bitcoin-cli"
92+
alias bt="bitcoin-cli -testnet"
93+
alias br="bitcoin-cli -regtest"
94+
EOF
95+
```
96+
Para ainda mais complexidade, podemos fazer com que cada um dos aliases 'start' use o sinalizador -conf para carregar a configuração de um arquivo diferente. Isso vai muito além do escopo deste tutorial, mas o oferecemos como um ponto de partida para quando nossas explorações de Bitcoin atingirem o próximo nível.
97+
98+
## Resumo do Verificando a configuração do seu node Bitcoin
99+
100+
Antes de começar a brincar com o Bitcoin, devemos nos certificar de que nossos aliases estão configurados, nosso bitcoind está rodando e os blocos foram baixados. Também podemos querer configurar algum acesso a configurações alternativas de Bitcoin, se formos usuários mais avançados.
101+
102+
## O Que Vem Depois?
103+
104+
Continue "Understanding Your Bitcoin Setup" com [3.2: Knowing Your Bitcoin Setup](03_2_Knowing_Your_Bitcoin_Setup.md).

0 commit comments

Comments
 (0)