Referência para desenvolvedores

Constantes para carteiras, exploradores, bots e pools do Garlicoin, conferidas com o código-fonte do Garlicoin Core 0.18 e com o nosso nó ao vivo.

Rede

Parâmetro	Mainnet	Testnet
Ticker	GRLC. 1 GRLC = 100.000.000 unidades base (8 casas decimais).
Suprimento máximo	69.000.000 GRLC. A recompensa por bloco começou em 50 GRLC e cai pela metade a cada 690.000 blocos.
Tempo de bloco	Meta de 40 segundos. A dificuldade é reajustada a cada bloco com Dark Gravity Wave sobre os últimos 45 blocos.
Porta P2P	`42069`	`42075`
Porta RPC (padrão)	`42068`	`42070`
Início de mensagem (magic)	`d2 c6 b6 db`	`fd d2 c8 f2`
Bloco gênese	`2ada80bf415a89358d697569c96eb98cdbf4c3b8878ac5722c01284492e27228`14 de janeiro de 2018 (horário 1515925970)	`b25004ec2dc27689999f9ee14856ee0464d7f73f3fae3cf43c1d40f89c141aea`
Maturidade da coinbase	100 blocos (cerca de 67 minutos)
Peso máximo de bloco	4.000.000 unidades de peso, como no Bitcoin
SegWit	Ativo desde o bloco 24.192 (31 de janeiro de 2018)	Ativo
Taxa mínima de retransmissão	0,001 GRLC por kB (padrão do Garlicoin Core 0.18; alguns nós e servidores Electrum aceitam até 0,00005)
Versão do protocolo	`70017`, user agent `/GarlicoinCore:0.18.5/` para a versão atual (cada nó mostra a própria versão)

O regtest usa a porta P2P 19444 e a porta RPC 42070. Números ao vivo, como altura e dificuldade, estão na API de dados.

Endereços e chaves

Tipo	Mainnet	Testnet
P2PKH (legado)	Versão `38` (0x26). Os endereços começam com G.	`111` (0x6f)
P2SH (script)	Versão `50` (0x32). Os endereços começam com M.	`58` (0x3a)
Bech32 (SegWit)	Prefixo `grlc`. Os endereços começam com grlc1q.	`tgrlc`
Chave privada WIF	Versão `176` (0xb0). As chaves comprimidas começam com T, as não comprimidas com 6.	`239` (0xef)
Chaves estendidas BIP32	Os mesmos bytes de versão do Bitcoin: `0488b21e` (xpub) e `0488ade4` (xprv) na mainnet, `043587cf` / `04358394` na testnet.
Coin type BIP44	`69420` (SLIP-0044), então a primeira conta é `m/44'/69420'/0'`
Prefixo de mensagem assinada	`"Garlicoin Signed Message:\n"`, com hash como o do Bitcoin (comprimento varint, duplo SHA-256)
Links de pagamento	`garlicoin:<address>?amount=1.5&label=...&message=...` (BIP21). O Garlicoin Core os abre. Crie um.

Só witness versão 0. O Garlicoin Core 0.18 é anterior ao Taproot e ao bech32m, então rejeita endereços grlc1p…. Não os gere.
A assinatura de mensagens no Garlicoin Core só funciona com endereços G. Para M e grlc1, as ferramentas usam os bytes de cabeçalho BIP137 (35–38 e 39–42); nosso verificador aceita os dois.

Vetores de teste

Chave privada 1. Nunca envie moedas para estes endereços: qualquer pessoa pode gastá-las. Conferido com validateaddress e verifymessage.

Mais detalhes

WIF (comprimida)T33ydQRKp4FCW5LCLLUB7deioUMoveiwekdwUwyfRDeGZm76aUjV
Endereço GGUXByHDZLvU4DnVH9imSFckt3HEQ5cFgE5
Endereço M (P2SH-P2WPKH)MR8UQSBr5ULwWheBHznrHk2jxyxkHQu8vB
Endereço grlc1 (P2WPKH)grlc1qw508d6qejxtdg4y5r3zarvary0c5xw7kh3dm3c
Assinatura de "garlicoin.org" pelo endereço GH9YqRVHzWvTzYSQZ4a7YCcL1/VPtgt3yCeGfyVAmDdglPrmvGNnXZPqRoX/FAMHz6dz3Qqvj0NbGyTMGNgen76o=

Prova de trabalho

O Garlicoin era minerado com scrypt no lançamento e mudou para Allium depois do bloco 58.670 (16 de fevereiro de 2018).

Mais detalhes

O Allium passa o cabeçalho de bloco de 80 bytes por esta cadeia:

BLAKE-256
Keccak-256
Lyra2 (t=1, rows=8, cols=8)
CubeHash-256
Lyra2 de novo
Skein-256
Grøstl-256

O ID do bloco continua sendo o duplo SHA-256 do cabeçalho, como no Bitcoin. Só a verificação da prova de trabalho usa Allium. Código-fonte: allium.c ↗

Converse com um nó

Adicione os dados de login RPC ao garlicoin.conf e reinicie. Veja rodar um nó para saber onde fica o arquivo.

server=1
rpcuser=yourname
rpcpassword=a-long-random-password

Depois consulte-o via JSON-RPC:

curl --user yourname --data-binary \
  '{"jsonrpc":"1.0","id":1,"method":"getblockcount","params":[]}' \
  -H 'content-type: text/plain' http://127.0.0.1:42068/

O RPC é o do Bitcoin Core 0.18. Não há getnodeaddresses nem índice de transações, a não ser que você inicie com txindex=1.

Encontrar peers

As seeds DNS do Garlicoin Core não respondem mais (verificado em outubro de 2026). Dê a um nó novo algumas linhas addnode= de peers.txt, atualizado a cada minuto.