Skip to content

Commit f82b60e

Browse files
authored
Chapter 15 Translated wait for review
1 parent fbe0862 commit f82b60e

5 files changed

+620
-0
lines changed
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Capítulo três: Compreendendo a configuração do seu node Bitcoin
2+
3+
Agora que você está pronto para começar a trabalhar com a interface de linha de comando `bitcoin-cli`. Mas isso requer primeiro que você entenda 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 você tenha uma VPS com Bitcoin instalado, executando `bitcoind`. Também presumimos que você está conectado à testnet, permitindo o acesso a bitcoins sem usar fundos reais. Você pode fazer isso com Bitcoin Standup em linode.com, por [2.1: Configurando um Bitcoin-Core no VPS c Bitcoin Standup](02_1_Setting_Up_a_Bitcoin-Core_VPS_with_StackScript.md), ou por outros métodos, por [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 fundos de Bitcoin
13+
* Usar os comandos básicos da carteira
14+
* Criar um endereço a partir de um descritor
15+
16+
Os objetivos de apoio 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+
## Índice
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: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
# 3.1: Verificando a configuração do seu node Bitcoin
2+
3+
Antes de começar a brincar com Bitcoin, você deve se certificar de que tudo está configurado corretamente.
4+
5+
## Crie seus aliases
6+
7+
Sugerimos a criação de alguns aliases para facilitar o uso do Bitcoin
8+
9+
Você pode fazer isso colocando-os em seu `.bash_profile`,` .bashrc` ou `.profile`.
10+
```
11+
cat >> ~/.bash_profile <<EOF
12+
alias btcdir="cd ~/.bitcoin/" #linux default bitcoind path
13+
alias bc="bitcoin-cli"
14+
alias bd="bitcoind"
15+
alias btcinfo='bitcoin-cli getwalletinfo | egrep "\"balance\""; bitcoin-cli getnetworkinfo | egrep "\"version\"|connections"; bitcoin-cli getmininginfo | egrep "\"blocks\"|errors"'
16+
EOF
17+
```
18+
Depois de inserir esses apelidos, você pode usar `source .bash_profile` para inseri-los ou apenas efetuar logout e logar novamente.
19+
20+
Observe que esses apelidos incluem atalhos para executar `bitcoin-cli`, para executar` bitcoind` e para ir para o diretório Bitcoin. Esses apelidos têm como objetivo principal tornar sua vida mais fácil. Sugerimos que você crie outros apelidos para facilitar o uso de comandos frequentes (e argumentos) e para minimizar erros. Aliases desse tipo podem ser ainda mais úteis se você tiver uma configuração complexa onde regularmente executa comandos associados a Mainnet, com Testnet, _e_ com Regtest, conforme explicado mais adiante.
21+
22+
Dito isso, o uso desses aliases _este_ documento pode acidentalmente obscurecer as lições centrais sendo ensinadas sobre Bitcoin, então o único alias usado diretamente aqui é `btcinfo` porque encapsula um comando muito mais longo e complexo. Caso contrário, mostramos os comandos completos; ajuste para seu próprio uso conforme apropriado.
23+
24+
## Rodando o Bitcoind
25+
26+
Você começará sua exploração da rede Bitcoin com o comando `bitcoin-cli`. No entanto, bitcoind _deve_ estar em execução para usar bitcoin-cli, pois bitcoin-cli envia comandos JSON-RPC para o bitcoind. Se você usou nossa configuração padrão, o bitcoind já deve estar instalado e funcionando. Você pode verificar olhando a tabela de processos.
27+
```
28+
$ ps auxww | grep bitcoind
29+
standup 455 1.3 34.4 3387536 1392904 ? SLsl Jun16 59:30 /usr/local/bin/bitcoind -conf=/home/standup/.bitcoin/bitcoin.conf
30+
```
31+
32+
Se não estiver rodando, você pode rodar `/usr/local/bin/bitcoind -daemon` manualmente e também colocá-lo em seu crontab.
33+
34+
## Verifique seus blocos
35+
36+
Você deve ter baixado todo o blockchain antes de começar a brincar. Basta executar o comando `bitcoin-cli getblockcount` para ver se está tudo carregado.
37+
```
38+
$ bitcoin-cli getblockcount
39+
1772384
40+
```
41+
Isso indica que está carregado; você precisará verificar isso em um serviço online que informa a altura atual do bloco.
42+
43+
> :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 um blockchain.
44+
45+
Você pode fazer isso olhando para um explorador, como [Mempool Space Explorer](https://mempool.space/pt/testnet). O número mais recente corresponde ao `getblockcount`? Se sim, você está atualizado.
46+
47+
Se você quiser que um alias veja tudo de uma vez, o seguinte funciona atualmente para Testnet, mas pode desaparecer em algum momento no futuro:
48+
```
49+
$ cat >> ~/.bash_profile << EOF
50+
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\\\`"
51+
EOF
52+
$ source .bash_profile
53+
$ btcblock
54+
1804372/1804372
55+
```
56+
57+
> :link: **TESTNET vs MAINNET:** Lembre-se de que este tutorial geralmente assume que você está usando testnet. Se você estiver usando a mainnet, pode recuperar a altura do bloco atual com: `wget -O - https://mempool.space/testnet/api/blocks/tip/height 2> /dev/ null`. Você pode substituir a última metade do alias `btblock` (após `/`) por isso.
58+
59+
Se você não está atualizado, mas seu `getblockcount` está aumentando, não há problema. O tempo total de download pode levar de uma hora a várias horas, dependendo da configuração.
60+
61+
## Opcional: Conheça os tipos de servidores
62+
63+
> **TESTNET vs MAINNET:** Ao configurar seu node Bitcoin, você escolhe criá-lo como um Mainnet, Testnet ou Regtest. Embora este documento presuma uma configuração de rede de teste, vale a pena entender como você pode acessar e usar os outros tipos de configuração - mesmo todos na mesma máquina! Mas, se você for um usuário iniciante, pule isso, pois não é necessário para uma configuração básica.
64+
65+
O tipo de configuração é controlado principalmente por meio do arquivo `~/.bitcoin/bitcoin.conf`. Se você estiver executando o testnet, provavelmente contém esta linha:
66+
```
67+
testnet=1
68+
```
69+
Se você estiver executando o regtest, provavelmente contém esta linha:
70+
```
71+
regtest=1
72+
```
73+
No entanto, se você deseja executar vários tipos diferentes de nós simultaneamente, deve deixar o sinalizador testnet (ou regtest) fora de seu arquivo de configuração. Você pode então escolher se está usando mainnet, testnet ou regtest toda vez que executar bitcoind ou bitcoin-cli.
74+
75+
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 bitcoin-cli, para cada mainnet (que não tem sinalizadores extras), o testnet (que é -testnet), ou seu regtest (que é -regtest).
76+
```
77+
cat >> ~/.bash_profile <<EOF
78+
alias bcstart="bitcoind -daemon"
79+
alias btstart="bitcoind -testnet -daemon"
80+
alias brstart="bitcoind -regtest -daemon"
81+
82+
alias bcstop="bitcoin-cli stop"
83+
alias btstop="bitcoin-cli -testnet stop"
84+
alias brstop="bitcoin-cli -regtest stop"
85+
86+
alias bcdir="cd ~/.bitcoin/" #linux default bitcoin path
87+
alias btdir="cd ~/.bitcoin/testnet" #linux default bitcoin testnet path
88+
alias brdir="cd ~/.bitcoin/regtest" #linux default bitcoin regtest path
89+
90+
alias bc="bitcoin-cli"
91+
alias bt="bitcoin-cli -testnet"
92+
alias br="bitcoin-cli -regtest"
93+
EOF
94+
```
95+
Para ainda mais complexidade, você pode fazer com que cada um de seus 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 suas explorações de Bitcoin atingirem o próximo nível.
96+
97+
## Resumo: Verificando a configuração do seu node Bitcoin
98+
99+
Antes de começar a brincar com bitcoin, você deve se certificar de que seus aliases estão configurados, seu bitcoind está rodando e seus blocos foram baixados. Você também pode querer configurar algum acesso a configurações alternativas de Bitcoin, se você for um usuário avançado.
100+
101+
## Oque vem a seguir?
102+
103+
Continue "Understanding Your Bitcoin Setup" com [3.2: Knowing Your Bitcoin Setup](03_2_Knowing_Your_Bitcoin_Setup.md).

0 commit comments

Comments
 (0)