Developer reference

The constants you need to build Garlicoin wallets, explorers, bots and pool software, in one place. Checked against the Garlicoin Core 0.18 source and the live node that runs this site.

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	`2ada80bf415a89358d697569c96eb98cdbf4c3b8878ac5722c01284492e27228`January 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.00006 GRLC per kB (Garlicoin Core 0.18 default)
Protocol version	`70017`, user agent `/GarlicoinCore:0.18.0/`

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, the smallest possible key. Never send coins to these: anyone can spend them. Checked with Garlicoin Core's validateaddress and verifymessage.

WIF (compressed)T33ydQRKp4FCW5LCLLUB7deioUMoveiwekdwUwyfRDeGZm76aUjV
G addressGUXByHDZLvU4DnVH9imSFckt3HEQ5cFgE5
M address (P2SH-P2WPKH)MR8UQSBr5ULwWheBHznrHk2jxyxkHQu8vB
grlc1 address (P2WPKH)grlc1qw508d6qejxtdg4y5r3zarvary0c5xw7kh3dm3c
Signature of "garlicoin.org" by the G addressH9YqRVHzWvTzYSQZ4a7YCcL1/VPtgt3yCeGfyVAmDdglPrmvGNnXZPqRoX/FAMHz6dz3Qqvj0NbGyTMGNgen76o=

Proof of work

Garlicoin mined with scrypt at launch and switched to Allium after block 58,670 (February 16, 2018). 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 ask it anything 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

The DNS seeds built into Garlicoin Core no longer answer (checked October 2026), so a brand-new node may sit with no connections. Give it some addnode= lines from peers.txt, updated every minute.