// Copyright (c) 2017, 2021 Pieter Wuille // Distributed under the MIT software license, see the accompanying // file COPYING or http://www.opensource.org/licenses/mit-license.php. #include #include /* * IMPORTANT NOTE: Comments below may largely pertain for bech32, not blech32. * Some of these magic constants have changes. * See liquid_addr.py for compact difference from bech32 * TODO: Update comments */ namespace blech32 { typedef std::vector data; /** The Blech32 and Blech32m character set for encoding. */ const char* CHARSET = "qpzry9x8gf2tvdw0s3jn54khce6mua7l"; /** The Blech32 and Blech32m character set for decoding. */ const int8_t CHARSET_REV[128] = { -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 15, -1, 10, 17, 21, 20, 26, 30, 7, 5, -1, -1, -1, -1, -1, -1, -1, 29, -1, 24, 13, 25, 9, 8, 23, -1, 18, 22, 31, 27, 19, -1, 1, 0, 3, 16, 11, 28, 12, 14, 6, 4, 2, -1, -1, -1, -1, -1, -1, 29, -1, 24, 13, 25, 9, 8, 23, -1, 18, 22, 31, 27, 19, -1, 1, 0, 3, 16, 11, 28, 12, 14, 6, 4, 2, -1, -1, -1, -1, -1 }; // ELEMENTS: this encoding constant is a random 60-byte number generated // in sage. For bech32m, Pieter did a fair bit of grinding to choose // an optimal constant. For blech32m we did no such grinding ... but // having said this, our only hard design constraint is that we need to // avoid 1, which has special algebraic structure that leads to extension // attacks. // // Further, because blech32m is a longer code than bech32m, doing an // analogous grinding project would be intractable, even if we were // willing to put the time and effort in. /* Determine the final constant to use for the specified encoding. */ uint64_t EncodingConstant(Encoding encoding) { assert(encoding == Encoding::BLECH32 || encoding == Encoding::BLECH32M); return encoding == Encoding::BLECH32 ? 1 : 0x455972a3350f7a1; } /** Concatenate two byte arrays. */ data Cat(data x, const data& y) { x.insert(x.end(), y.begin(), y.end()); return x; } /** This function will compute what 6 5-bit values to XOR into the last 6 input values, in order to * make the checksum 0. These 6 values are packed together in a single 30-bit integer. The higher * bits correspond to earlier values. */ uint64_t PolyMod(const data& v) { // The input is interpreted as a list of coefficients of a polynomial over F = GF(32), with an // implicit 1 in front. If the input is [v0,v1,v2,v3,v4], that polynomial is v(x) = // 1*x^5 + v0*x^4 + v1*x^3 + v2*x^2 + v3*x + v4. The implicit 1 guarantees that // [v0,v1,v2,...] has a distinct checksum from [0,v0,v1,v2,...]. // The output is a 30-bit integer whose 5-bit groups are the coefficients of the remainder of // v(x) mod g(x), where g(x) is the Blech32 generator, // x^6 + {29}x^5 + {22}x^4 + {20}x^3 + {21}x^2 + {29}x + {18}. g(x) is chosen in such a way // that the resulting code is a BCH code, guaranteeing detection of up to 3 errors within a // window of 1023 characters. Among the various possible BCH codes, one was selected to in // fact guarantee detection of up to 4 errors within a window of 89 characters. // Note that the coefficients are elements of GF(32), here represented as decimal numbers // between {}. In this finite field, addition is just XOR of the corresponding numbers. For // example, {27} + {13} = {27 ^ 13} = {22}. Multiplication is more complicated, and requires // treating the bits of values themselves as coefficients of a polynomial over a smaller field, // GF(2), and multiplying those polynomials mod a^5 + a^3 + 1. For example, {5} * {26} = // (a^2 + 1) * (a^4 + a^3 + a) = (a^4 + a^3 + a) * a^2 + (a^4 + a^3 + a) = a^6 + a^5 + a^4 + a // = a^3 + 1 (mod a^5 + a^3 + 1) = {9}. // During the course of the loop below, `c` contains the bitpacked coefficients of the // polynomial constructed from just the values of v that were processed so far, mod g(x). In // the above example, `c` initially corresponds to 1 mod g(x), and after processing 2 inputs of // v, it corresponds to x^2 + v0*x + v1 mod g(x). As 1 mod g(x) = 1, that is the starting value // for `c`. uint64_t c = 1; for (const auto v_i : v) { // We want to update `c` to correspond to a polynomial with one extra term. If the initial // value of `c` consists of the coefficients of c(x) = f(x) mod g(x), we modify it to // correspond to c'(x) = (f(x) * x + v_i) mod g(x), where v_i is the next input to // process. Simplifying: // c'(x) = (f(x) * x + v_i) mod g(x) // ((f(x) mod g(x)) * x + v_i) mod g(x) // (c(x) * x + v_i) mod g(x) // If c(x) = c0*x^5 + c1*x^4 + c2*x^3 + c3*x^2 + c4*x + c5, we want to compute // c'(x) = (c0*x^5 + c1*x^4 + c2*x^3 + c3*x^2 + c4*x + c5) * x + v_i mod g(x) // = c0*x^6 + c1*x^5 + c2*x^4 + c3*x^3 + c4*x^2 + c5*x + v_i mod g(x) // = c0*(x^6 mod g(x)) + c1*x^5 + c2*x^4 + c3*x^3 + c4*x^2 + c5*x + v_i // If we call (x^6 mod g(x)) = k(x), this can be written as // c'(x) = (c1*x^5 + c2*x^4 + c3*x^3 + c4*x^2 + c5*x + v_i) + c0*k(x) // First, determine the value of c0: uint8_t c0 = c >> 55; // ELEMENTS: 25->55 // Then compute c1*x^5 + c2*x^4 + c3*x^3 + c4*x^2 + c5*x + v_i: c = ((c & 0x7fffffffffffff) << 5) ^ v_i; // ELEMENTS 0x1ffffff->0x7fffffffffffff // Finally, for each set bit n in c0, conditionally add {2^n}k(x): if (c0 & 1) c ^= 0x7d52fba40bd886; // ELEMENTS if (c0 & 2) c ^= 0x5e8dbf1a03950c; // ELEMENTS if (c0 & 4) c ^= 0x1c3a3c74072a18; // ELEMENTS if (c0 & 8) c ^= 0x385d72fa0e5139; // ELEMENTS if (c0 & 16) c ^= 0x7093e5a608865b; // ELEMENTS } return c; } /** Convert to lower case. */ inline unsigned char LowerCase(unsigned char c) { return (c >= 'A' && c <= 'Z') ? (c - 'A') + 'a' : c; } /** Expand a HRP for use in checksum computation. */ data ExpandHRP(const std::string& hrp) { data ret; ret.reserve(hrp.size() + 90); ret.resize(hrp.size() * 2 + 1); for (size_t i = 0; i < hrp.size(); ++i) { unsigned char c = hrp[i]; ret[i] = c >> 5; ret[i + hrp.size() + 1] = c & 0x1f; } ret[hrp.size()] = 0; return ret; } /** Verify a checksum. */ Encoding VerifyChecksum(const std::string& hrp, const data& values) { // PolyMod computes what value to xor into the final values to make the checksum 0. However, // if we required that the checksum was 0, it would be the case that appending a 0 to a valid // list of values would result in a new valid list. For that reason, Blech32 requires the // resulting checksum to be 1 instead. In Blech32m, this constant was amended. const uint64_t check = PolyMod(Cat(ExpandHRP(hrp), values)); if (check == EncodingConstant(Encoding::BLECH32)) return Encoding::BLECH32; if (check == EncodingConstant(Encoding::BLECH32M)) return Encoding::BLECH32M; return Encoding::INVALID; } /** Create a checksum. */ data CreateChecksum(Encoding encoding, const std::string& hrp, const data& values) { data enc = Cat(ExpandHRP(hrp), values); enc.resize(enc.size() + 12); // ELEMENTS: Append 6->12 zeroes uint64_t mod = PolyMod(enc) ^ EncodingConstant(encoding); // Determine what to XOR into those 6 zeroes. data ret(12); // ELEMENTS: 6->12 for (size_t i = 0; i < 12; ++i) { // ELEMENTS: 6->12 // Convert the 5-bit groups in mod to checksum values. ret[i] = (mod >> (5 * (11 - i))) & 31; // ELEMENTS: 5->11 } return ret; } /** Encode a Blech32 or Blech32m string. */ std::string Encode(Encoding encoding, const std::string& hrp, const data& values) { // First ensure that the HRP is all lowercase. BIP-173 and BIP350 require an encoder // to return a lowercase Blech32/Blech32m string, but if given an uppercase HRP, the // result will always be invalid. for (const char& c : hrp) assert(c < 'A' || c > 'Z'); data checksum = CreateChecksum(encoding, hrp, values); data combined = Cat(values, checksum); std::string ret = hrp + '1'; ret.reserve(ret.size() + combined.size()); for (const auto c : combined) { ret += CHARSET[c]; } return ret; } /** Decode a Blech32 or Blech32m string. */ DecodeResult Decode(const std::string& str) { bool lower = false, upper = false; for (size_t i = 0; i < str.size(); ++i) { unsigned char c = str[i]; if (c >= 'a' && c <= 'z') lower = true; else if (c >= 'A' && c <= 'Z') upper = true; else if (c < 33 || c > 126) return {}; } if (lower && upper) return {}; size_t pos = str.rfind('1'); if (str.size() > 1000 || pos == str.npos || pos == 0 || pos + 13 > str.size()) { // ELEMENTS: 90->1000, 7->13 return {}; } data values(str.size() - 1 - pos); for (size_t i = 0; i < str.size() - 1 - pos; ++i) { unsigned char c = str[i + pos + 1]; int8_t rev = CHARSET_REV[c]; if (rev == -1) { return {}; } values[i] = rev; } std::string hrp; for (size_t i = 0; i < pos; ++i) { hrp += LowerCase(str[i]); } Encoding result = VerifyChecksum(hrp, values); if (result == Encoding::INVALID) return {}; return {result, std::move(hrp), data(values.begin(), values.end() - 12)}; } } // namespace blech32