Developer reference
Constants for Garlicoin wallets, explorers, bots and pools, checked against the Garlicoin Core 0.18 source and our live node.
Network
| Parameter | Mainnet | Testnet |
|---|---|---|
| Ticker | GRLC. 1 GRLC = 100,000,000 base units (8 decimals). | |
| Max supply | 69,000,000 GRLC. Block reward started at 50 GRLC and halves every 690,000 blocks. | |
| Block time | 40 seconds target. Difficulty is retargeted every block with Dark Gravity Wave over the last 45 blocks. | |
| P2P port | 42069 | 42075 |
| RPC port (default) | 42068 | 42070 |
| Message start (magic) | d2 c6 b6 db | fd d2 c8 f2 |
| Genesis block | 2ada80bf415a89358d697569c96eb98cdbf4c3b8878ac5722c01284492e27228January 14, 2018 (time 1515925970) | b25004ec2dc27689999f9ee14856ee0464d7f73f3fae3cf43c1d40f89c141aea |
| Coinbase maturity | 100 blocks (about 67 minutes) | |
| Max block weight | 4,000,000 weight units, as in Bitcoin | |
| SegWit | Active since block 24,192 (January 31, 2018) | Active |
| Min relay fee | 0.001 GRLC per kB (Garlicoin Core 0.18 default; some nodes and Electrum servers accept down to 0.00005) | |
| Protocol version | 70017, user agent /GarlicoinCore:0.18.5/ for the current release (each node shows its own version) | |
Regtest uses P2P port 19444 and RPC port 42070. Live numbers like height and difficulty are in the data API.
Addresses and keys
| Kind | Mainnet | Testnet |
|---|---|---|
| P2PKH (legacy) | Version 38 (0x26). Addresses start with G. | 111 (0x6f) |
| P2SH (script) | Version 50 (0x32). Addresses start with M. | 58 (0x3a) |
| Bech32 (SegWit) | Prefix grlc. Addresses start with grlc1q. | tgrlc |
| WIF private key | Version 176 (0xb0). Compressed keys start with T, uncompressed with 6. | 239 (0xef) |
| BIP32 extended keys | Same version bytes as Bitcoin: 0488b21e (xpub) and 0488ade4 (xprv) on mainnet, 043587cf / 04358394 on testnet. | |
| BIP44 coin type | 69420 (SLIP-0044), so the first account is m/44'/69420'/0' | |
| Signed message prefix | "Garlicoin Signed Message:\n", hashed like Bitcoin's (varint length, double SHA-256) | |
| Payment links | garlicoin:<address>?amount=1.5&label=...&message=... (BIP21). Garlicoin Core opens them. Make one. | |
- Only witness version 0. Garlicoin Core 0.18 predates Taproot and bech32m, so it rejects
grlc1p…addresses. Don't generate them. - Message signing in Garlicoin Core works only with G addresses. For M and grlc1, tools use the BIP137 header bytes (35–38 and 39–42); our verifier accepts both.
Test vectors
Private key 1. Never send coins to these: anyone can spend them. Checked with Garlicoin Core's validateaddress and verifymessage.
More details
- WIF (compressed)
T33ydQRKp4FCW5LCLLUB7deioUMoveiwekdwUwyfRDeGZm76aUjV - G address
GUXByHDZLvU4DnVH9imSFckt3HEQ5cFgE5 - M address (P2SH-P2WPKH)
MR8UQSBr5ULwWheBHznrHk2jxyxkHQu8vB - grlc1 address (P2WPKH)
grlc1qw508d6qejxtdg4y5r3zarvary0c5xw7kh3dm3c - Signature of "garlicoin.org" by the G address
H9YqRVHzWvTzYSQZ4a7YCcL1/VPtgt3yCeGfyVAmDdglPrmvGNnXZPqRoX/FAMHz6dz3Qqvj0NbGyTMGNgen76o=
Proof of work
Garlicoin mined with scrypt at launch and switched to Allium after block 58,670 (February 16, 2018).
More details
Allium hashes the 80-byte block header through this chain:
- BLAKE-256
- Keccak-256
- Lyra2 (t=1, rows=8, cols=8)
- CubeHash-256
- Lyra2 again
- Skein-256
- Grøstl-256
The block ID is still the double SHA-256 of the header, as in Bitcoin. Only the proof-of-work check uses Allium. Source: allium.c ↗
Talk to a node
Add RPC login details to garlicoin.conf and restart. See run a node for where the file goes.
server=1 rpcuser=yourname rpcpassword=a-long-random-password
Then query it over 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/
The RPC is Bitcoin Core 0.18's. There's no getnodeaddresses and no transaction index unless you start with txindex=1.
Finding peers
Garlicoin Core's DNS seeds no longer answer (checked October 2026). Give a new node some addnode= lines from peers.txt, updated every minute.
Links
- Garlicoin Core source ↗, with the constants above in
src/chainparams.cpp. - Our data API: live network data as JSON, plus README badges.
- grlc.eu explorer API ↗ for transactions, addresses and blocks.