VarInt
A VarInt or "Variable Integer" is an integer format used widely in Bitcoin to indicate the lengths of fields within transaction and block data.
A VarInt is a variable length field 1, 3, 5 or 9 bytes in length dependent on the size of the object being defined. The VarInt format is used as it is space efficient over simply using an 8-byte field where variable length objects are used.
Using VarInts
When expressing an integer value less than or equal to 0xFC
(252) the value itself can be used.
When expressing an integer value greater than 0xFC
but less than or equal to 0xFFFF
(65,535), the varint is 0xFDXXXX
where XXXX represents the two byte integer
When expressing an integer value greater than 0xFFFF
but less than or equal to 0xFFFFFFFF
(4,294,967,295), the varint is 0xFEXXXXXXXX
where XXXXXXXX represents the 4 byte integer
When expressing an integer value greater than 0xFFFFFFFF
but less than or equal to 0xFFFFFFFFFFFFFFFF
(18,446,744,073,709,551,615), the varint is 0xFFXXXXXXXXXXXXXXXX
where XXXXXXXXXXXXXXXX represents the 8 byte integer
Examples
Value | Size | VarInt |
---|---|---|
187 (0xBB )
|
1 byte | 0xBB
|
255 (0xFF )
|
1 byte but greater than 0xFC
|
0xFD00FF
|
13,337 (0x3419 )
|
2 bytes | 0xFD3419
|
134,250,981 (0x80081e5 )
|
4 bytes | 0xFE080081e5
|
198,849,843,832,919 (0xB4DA564E2857 )
|
6 bytes | 0xFF00B4DA564E2857
|