multichain-address-validator 0.7.9 → 0.8.1

package/dist/esm/validators/polkadot_validator.js

@@ -1,49 +1,5 @@
-import cryptoUtils from '../crypto/utils.js';
-import { getAddress } from '../helpers.js';
-// from https://github.com/paritytech/substrate/wiki/External-Address-Format-(SS58)
-const addressFormats = [
-    { addressLength: 3, accountIndexLength: 1, checkSumLength: 1 },
-    { addressLength: 4, accountIndexLength: 2, checkSumLength: 1 },
-    { addressLength: 5, accountIndexLength: 2, checkSumLength: 2 },
-    { addressLength: 6, accountIndexLength: 4, checkSumLength: 1 },
-    { addressLength: 7, accountIndexLength: 4, checkSumLength: 2 },
-    { addressLength: 8, accountIndexLength: 4, checkSumLength: 3 },
-    { addressLength: 9, accountIndexLength: 4, checkSumLength: 4 },
-    { addressLength: 10, accountIndexLength: 8, checkSumLength: 1 },
-    { addressLength: 11, accountIndexLength: 8, checkSumLength: 2 },
-    { addressLength: 12, accountIndexLength: 8, checkSumLength: 3 },
-    { addressLength: 13, accountIndexLength: 8, checkSumLength: 4 },
-    { addressLength: 14, accountIndexLength: 8, checkSumLength: 5 },
-    { addressLength: 15, accountIndexLength: 8, checkSumLength: 6 },
-    { addressLength: 16, accountIndexLength: 8, checkSumLength: 7 },
-    { addressLength: 17, accountIndexLength: 8, checkSumLength: 8 },
-    { addressLength: 34, accountIndexLength: 32, checkSumLength: 2 },
-];
-function verifyChecksum(address) {
-    try {
-        const preImage = '53533538505245';
-        const decoded = cryptoUtils.base58(address);
-        const addressType = cryptoUtils.byteArray2hexStr(decoded.slice(0, 1));
-        const addressAndChecksum = decoded.slice(1);
-        // get the address format
-        const addressFormat = addressFormats.find(af => af.addressLength === addressAndChecksum.length);
-        if (!addressFormat) {
-            throw new Error('Invalid address length');
-        }
-        const decodedAddress = cryptoUtils.byteArray2hexStr(addressAndChecksum.slice(0, addressFormat.accountIndexLength));
-        const checksum = cryptoUtils.byteArray2hexStr(addressAndChecksum.slice(-addressFormat.checkSumLength));
-        const calculatedHash = cryptoUtils
-            .blake2b(preImage + addressType + decodedAddress, 64)
-            .substr(0, addressFormat.checkSumLength * 2)
-            .toUpperCase();
-        return calculatedHash == checksum;
-    }
-    catch (err) {
-        return false;
-    }
-}
-export default {
-    isValidAddress(address) {
-        return verifyChecksum(getAddress(address));
-    },
-};
+import createSS58Validator from './ss58_validator.js';
+// Polkadot uses SS58 address format (Substrate-based)
+// SS58 Registry: https://github.com/paritytech/ss58-registry
+// Accepts any valid SS58 address (no network prefix restriction)
+export default createSS58Validator();

package/dist/esm/validators/ss58_validator.d.ts

@@ -0,0 +1,11 @@
+import { Validator } from '../types.js';
+interface SS58ValidatorOptions {
+    networkPrefix?: number;
+}
+/**
+ * Creates an SS58 validator with optional network prefix filtering
+ * @param options Configuration options including optional network prefix
+ * @returns Validator instance for SS58 addresses
+ */
+export default function createSS58Validator(options?: SS58ValidatorOptions): Validator;
+export {};

package/dist/esm/validators/ss58_validator.js

@@ -0,0 +1,64 @@
+import cryptoUtils from '../crypto/utils.js';
+import { getAddress } from '../helpers.js';
+// SS58 address format (Substrate-based)
+// SS58 Registry: https://github.com/paritytech/ss58-registry
+const addressFormats = [
+    { addressLength: 3, accountIndexLength: 1, checkSumLength: 1 },
+    { addressLength: 4, accountIndexLength: 2, checkSumLength: 1 },
+    { addressLength: 5, accountIndexLength: 2, checkSumLength: 2 },
+    { addressLength: 6, accountIndexLength: 4, checkSumLength: 1 },
+    { addressLength: 7, accountIndexLength: 4, checkSumLength: 2 },
+    { addressLength: 8, accountIndexLength: 4, checkSumLength: 3 },
+    { addressLength: 9, accountIndexLength: 4, checkSumLength: 4 },
+    { addressLength: 10, accountIndexLength: 8, checkSumLength: 1 },
+    { addressLength: 11, accountIndexLength: 8, checkSumLength: 2 },
+    { addressLength: 12, accountIndexLength: 8, checkSumLength: 3 },
+    { addressLength: 13, accountIndexLength: 8, checkSumLength: 4 },
+    { addressLength: 14, accountIndexLength: 8, checkSumLength: 5 },
+    { addressLength: 15, accountIndexLength: 8, checkSumLength: 6 },
+    { addressLength: 16, accountIndexLength: 8, checkSumLength: 7 },
+    { addressLength: 17, accountIndexLength: 8, checkSumLength: 8 },
+    { addressLength: 34, accountIndexLength: 32, checkSumLength: 2 },
+];
+/**
+ * Creates an SS58 validator with optional network prefix filtering
+ * @param options Configuration options including optional network prefix
+ * @returns Validator instance for SS58 addresses
+ */
+export default function createSS58Validator(options = {}) {
+    function verifyChecksum(address) {
+        try {
+            const preImage = '53533538505245';
+            const decoded = cryptoUtils.base58(address);
+            const addressType = cryptoUtils.byteArray2hexStr(decoded.slice(0, 1));
+            // If a specific network prefix is required, validate it
+            if (options.networkPrefix !== undefined) {
+                const expectedPrefix = options.networkPrefix.toString(16).padStart(2, '0').toUpperCase();
+                if (addressType.toUpperCase() !== expectedPrefix) {
+                    return false;
+                }
+            }
+            const addressAndChecksum = decoded.slice(1);
+            // get the address format
+            const addressFormat = addressFormats.find(af => af.addressLength === addressAndChecksum.length);
+            if (!addressFormat) {
+                throw new Error('Invalid address length');
+            }
+            const decodedAddress = cryptoUtils.byteArray2hexStr(addressAndChecksum.slice(0, addressFormat.accountIndexLength));
+            const checksum = cryptoUtils.byteArray2hexStr(addressAndChecksum.slice(-addressFormat.checkSumLength));
+            const calculatedHash = cryptoUtils
+                .blake2b(preImage + addressType + decodedAddress, 64)
+                .substr(0, addressFormat.checkSumLength * 2)
+                .toUpperCase();
+            return calculatedHash == checksum;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    return {
+        isValidAddress(address) {
+            return verifyChecksum(getAddress(address));
+        },
+    };
+}

package/dist/esm/validators/zcash_validator.d.ts

@@ -0,0 +1,5 @@
+import { Address, NetworkType } from '../types.js';
+declare const _default: (networkType: NetworkType) => {
+    isValidAddress(address: Address): boolean;
+};
+export default _default;

package/dist/esm/validators/zcash_validator.js

@@ -0,0 +1,47 @@
+import base58 from '../crypto/base58.js';
+import cryptoUtils from '../crypto/utils.js';
+import { NetworkType } from '../types.js';
+import { getAddress } from '../helpers.js';
+function getDecoded(address) {
+    try {
+        return base58.decode(address);
+    }
+    catch (e) {
+        // if decoding fails, assume invalid address
+        return null;
+    }
+}
+function getChecksum(payload) {
+    return cryptoUtils.sha256Checksum(payload);
+}
+function isValidTransparentAddress(address, networkType) {
+    // Zcash transparent addresses use 2-byte version prefixes
+    // Expected length: 26 bytes (2 bytes version + 20 bytes payload + 4 bytes checksum)
+    const expectedLength = 26;
+    const decoded = getDecoded(address);
+    if (!decoded || decoded.length !== expectedLength) {
+        return false;
+    }
+    const checksum = cryptoUtils.toHex(decoded.slice(expectedLength - 4, expectedLength));
+    const body = cryptoUtils.toHex(decoded.slice(0, expectedLength - 4));
+    const goodChecksum = getChecksum(body);
+    if (checksum !== goodChecksum) {
+        return false;
+    }
+    // Get the 2-byte version prefix
+    const versionPrefix = cryptoUtils.toHex(decoded.slice(0, 2));
+    // Define valid version prefixes for each network
+    // Only supporting transparent addresses (t1/t3 for mainnet, tm/t2 for testnet)
+    const validPrefixes = networkType === NetworkType.MainNet
+        ? ['1cb8', '1cbd'] // t1 (P2PKH) and t3 (P2SH) for mainnet
+        : ['1d25', '1cba']; // tm (P2PKH) and t2 (P2SH) for testnet
+    return validPrefixes.includes(versionPrefix);
+}
+export default (networkType) => ({
+    isValidAddress(address) {
+        const addr = getAddress(address);
+        // Only validate transparent addresses (t1/t3 for mainnet, tm/t2 for testnet)
+        // Sapling (zs) and Unified (u) addresses are NOT supported
+        return isValidTransparentAddress(addr, networkType);
+    }
+});

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "multichain-address-validator",
     "description": "Multichain address validator for Bitcoin and other blockchains.",
-    "version": "0.7.9",
+    "version": "0.8.1",
     "keywords": [
         "0x",
         "zrx",
@@ -344,7 +344,8 @@
         "build": "npm run clean && npm run build:esm && npm run build:cjs",
         "clean": "npx rimraf dist",
         "test": "mocha --import=tsx test/**.test.ts",
-        "start": "npm run build && npm test"
+        "start": "npm run build && npm test",
+        "release": "node scripts/release.mjs"
     },
     "dependencies": {
         "@noble/hashes": "^1.4.0",

package/.editorconfig

@@ -1,10 +0,0 @@
-# editorconfig.org
-root = true
-
-[*]
-indent_style = space
-indent_size = 4
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true

package/.travis.yml

@@ -1,11 +0,0 @@
-sudo: required
-addons:
-    chrome: stable
-language: node_js
-node_js:
-    - "16"
-    - "stable"
-before_install:
-    - npm install -g yarn --cache-min 999999999
-install:
-    - yarn

package/.vscode/launch.json

@@ -1,23 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "Mocha Tests",
-            "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
-            "args": [
-                "-u",
-                "tdd",
-                "--timeout",
-                "999999",
-                "--colors",
-                "${workspaceFolder}/test"
-            ],
-            "internalConsoleOptions": "openOnSessionStart"
-        }
-    ]
-}

package/index.html

@@ -1,12 +0,0 @@
-<html>
-    <body>
-        <script src="./dist/multichain-address-validator.bundle.min.js"></script>
-        <script type="module">
-            const valid = MCAV.validate('1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck', 'BTC');
-            if (valid)
-                console.log('This is a valid address');
-            else
-                console.log('Address INVALID');
-        </script>
-    </body>
-</html>

package/src/chain-validators.ts

@@ -1,161 +0,0 @@
-import type {Chain, Validator} from './types.js'
-import { NetworkType } from './types.js'
-
-import {
-    AlgorandValidator,
-    BCHValidator,
-    BTCValidator,
-    CardanoValidator,
-    EOSValidator,
-    ETHValidator,
-    HederaValidator,
-    MoneroValidator,
-    MoveValidator,
-    NanoValidator,
-    NemValidator,
-    PolkadotValidator,
-    RippleValidator,
-    SiaValidator,
-    SolanaValidator,
-    TezosValidator,
-    TronValidator,
-    XLMValidator,
-} from './validators/index.js'
-
-
-type ChainValidators = Record<string, {
-    alternatives?: string[],
-    validator: Validator | {
-        mainnet: Validator,
-        testnet: Validator,
-    },
-}>
-
-const chainValidators: ChainValidators = {
-    algorand: {validator: AlgorandValidator},
-    aptos: {validator: MoveValidator},
-    bitcoin: {
-        alternatives: ['btc', 'omni'],
-        validator: {
-            mainnet: BTCValidator({
-                addressTypes: ['00', '05'],
-                bech32Hrp: ['bc'],
-            }),
-            testnet: BTCValidator({
-                addressTypes: ['6f', 'c4', '3c', '26'],
-                bech32Hrp: ['tb'],
-            }),
-        },
-    },
-    'bitcoincash': {
-        alternatives: ['bch', 'bitcoin-cash', 'bitcoin cash'],
-        validator: {
-            mainnet: BCHValidator({
-                addressTypes: ['00', '05'],
-                bech32Hrp: ['bc'],
-                networkType: NetworkType.MainNet,
-            }),
-            testnet: BCHValidator({
-                addressTypes: ['6f', 'c4', '3c', '26'],
-                bech32Hrp: ['tb'],
-                networkType: NetworkType.TestNet,
-            }),
-        }
-    },
-    cardano: {
-        alternatives: ['ada'],
-        validator: CardanoValidator,
-    },
-    doge: {
-        alternatives: ['dogecoin'],
-        validator: {
-            mainnet: BTCValidator({addressTypes: ['1e', '16']}),
-            testnet: BTCValidator({addressTypes: ['71', 'c4']}),
-        }
-    },
-    eos: {validator: EOSValidator},
-    ethereum: {
-        alternatives: [
-            'arbitrum',
-            'avalanche',
-            'avalanche-c',
-            'base',
-            'berachain',
-            'binance',
-            'BinanceSmartChain',
-            'bnb',
-            'bsc',
-            'eth',
-            'EthereumClassic',
-            'EthereumPow',
-            'erc20',
-            'flare',
-            'optimism',
-            'sonic',
-            'story',
-        ],
-        validator: ETHValidator
-    },
-    hedera: {
-        alternatives: ['hbar'],
-        validator: HederaValidator
-    },
-    litecoin: {
-        alternatives: ['ltc'],
-        validator: {
-            mainnet: BTCValidator({
-                addressTypes: ['30', '32'],
-                bech32Hrp: ['ltc'],
-            }),
-            testnet: BTCValidator({
-                addressTypes: ['6f', 'c4', '3a'],
-                bech32Hrp: ['tltc']
-            })
-        }
-    },
-    monero: {
-        validator: {
-            mainnet: MoneroValidator(NetworkType.MainNet),
-            testnet: MoneroValidator(NetworkType.TestNet),
-        }
-    },
-    nem: {validator: NemValidator},
-    nano: {validator: NanoValidator},
-    polkadot: {validator: PolkadotValidator},
-    ripple: {
-        alternatives: ['xrp'],
-        validator: RippleValidator,
-    },
-    sia: {
-        alternatives: ['SiaCoin'],
-        validator: SiaValidator
-    },
-    solana: {
-        alternatives: ['sol','spl'],
-        validator: SolanaValidator,
-    },
-    sui: {validator: MoveValidator},
-    tron: {
-        alternatives: ['trc20'],
-        validator: TronValidator(),
-    },
-    tezos: {validator: TezosValidator},
-    xlm: {
-        alternatives: ['stellar', 'stellarlumens'],
-        validator: XLMValidator,
-    },
-}
-
-export function getValidatorForChain(chain: Chain): Validator | undefined {
-    const chainName = (chain as any).chain || chain
-    const networkType = (chain as any).networkType || NetworkType.MainNet
-
-    const key = Object.keys(chainValidators).find(key =>
-        key.toUpperCase() === chainName.toUpperCase() || chainValidators[key]
-            ?.alternatives
-            ?.map(alternative => alternative.toUpperCase())
-            ?.includes(chainName.toUpperCase())
-    )
-
-    return chainValidators[key]?.validator[networkType] || chainValidators[key]?.validator
-}

package/src/crypto/base32.ts

@@ -1,66 +0,0 @@
-const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
-
- /**
-* Encode a string to base32
-*/
-const b32encode = function(s: string) {
-    const parts = [];
-    let quanta = Math.floor((s.length / 5));
-    const leftover = s.length % 5;
-
-     if (leftover != 0) {
-        for (let i = 0; i < (5 - leftover); i++) {
-            s += '\x00';
-        }
-        quanta += 1;
-    }
-
-     for (let i = 0; i < quanta; i++) {
-        parts.push(alphabet.charAt(s.charCodeAt(i * 5) >> 3));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5) & 0x07) << 2) | (s.charCodeAt(i * 5 + 1) >> 6)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 1) & 0x3F) >> 1)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 1) & 0x01) << 4) | (s.charCodeAt(i * 5 + 2) >> 4)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 2) & 0x0F) << 1) | (s.charCodeAt(i * 5 + 3) >> 7)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 3) & 0x7F) >> 2)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 3) & 0x03) << 3) | (s.charCodeAt(i * 5 + 4) >> 5)));
-        parts.push(alphabet.charAt(((s.charCodeAt(i * 5 + 4) & 0x1F))));
-    }
-
-    let replace = 0;
-    if (leftover == 1) replace = 6;
-    else if (leftover == 2) replace = 4;
-    else if (leftover == 3) replace = 3;
-    else if (leftover == 4) replace = 1;
-
-    for (let i = 0; i < replace; i++) parts.pop();
-    for (let i = 0; i < replace; i++) parts.push("=");
-
-     return parts.join("");
-}
-
-/**
-* Decode a base32 string.
-* This is made specifically for our use, deals only with proper strings
-*/
-const b32decode = function(s: string) {
-    const r = new ArrayBuffer(s.length * 5 / 8);
-    const b = new Uint8Array(r);
-    for (let j = 0; j < s.length / 8; j++) {
-        const v = [0, 0, 0, 0, 0, 0, 0, 0];
-        for (let i = 0; i < 8; ++i) {
-            v[i] = alphabet.indexOf(s[j * 8 + i]);
-        }
-        const i = 0;
-        b[j * 5 + 0] = (v[i + 0] << 3) | (v[i + 1] >> 2);
-        b[j * 5 + 1] = ((v[i + 1] & 0x3) << 6) | (v[i + 2] << 1) | (v[i + 3] >> 4);
-        b[j * 5 + 2] = ((v[i + 3] & 0xf) << 4) | (v[i + 4] >> 1);
-        b[j * 5 + 3] = ((v[i + 4] & 0x1) << 7) | (v[i + 5] << 2) | (v[i + 6] >> 3);
-        b[j * 5 + 4] = ((v[i + 6] & 0x7) << 5) | (v[i + 7]);
-    }
-    return b;
-}
-
-export default {
-    b32decode,
-    b32encode
-};

package/src/crypto/base58.ts

@@ -1,46 +0,0 @@
-// Base58 encoding/decoding
-// Originally written by Mike Hearn for BitcoinJ
-// Copyright (c) 2011 Google Inc
-// Ported to JavaScript by Stefan Thomas
-// Merged Buffer refactorings from base58-native by Stephen Pair
-// Copyright (c) 2013 BitPay Inc
-
-const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-const ALPHABET_MAP = {};
-for (let i = 0; i < ALPHABET.length; ++i) {
-    ALPHABET_MAP[ALPHABET.charAt(i)] = i;
-}
-const BASE = ALPHABET.length;
-
-export default {
-    decode: function(string: string) {
-        if (string.length === 0) return [];
-
-        var i, j, bytes = [0];
-        for (i = 0; i < string.length; ++i) {
-            var c = string[i];
-            if (!(c in ALPHABET_MAP)) throw new Error('Non-base58 character');
-
-            for (j = 0; j < bytes.length; ++j) bytes[j] *= BASE
-            bytes[0] += ALPHABET_MAP[c];
-
-            var carry = 0;
-            for (j = 0; j < bytes.length; ++j) {
-                bytes[j] += carry;
-                carry = bytes[j] >> 8;
-                bytes[j] &= 0xff
-            }
-
-            while (carry) {
-                bytes.push(carry & 0xff);
-                carry >>= 8;
-            }
-        }
-        // deal with leading zeros
-        for (i = 0; string[i] === '1' && i < string.length - 1; ++i){
-            bytes.push(0);
-        }
-
-        return bytes.reverse();
-    }
-};

package/src/crypto/bech32.js

@@ -1,132 +0,0 @@
-// Copyright (c) 2017, 2021 Pieter Wuille
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-var CHARSET = 'qpzry9x8gf2tvdw0s3jn54khce6mua7l';
-var GENERATOR = [0x3b6a57b2, 0x26508e6d, 0x1ea119fa, 0x3d4233dd, 0x2a1462b3];
-
-const encodings = {
-    BECH32: "bech32",
-    BECH32M: "bech32m",
-};
-
-export default {
-    decode: decode,
-    encode: encode,
-    encodings: encodings,
-    verifyChecksum: verifyChecksum
-};
-
-function getEncodingConst (enc) {
-    if (enc == encodings.BECH32) {
-        return 1;
-    } else if (enc == encodings.BECH32M) {
-        return 0x2bc830a3;
-    } else {
-        return null;
-    }
-}
-
-function polymod (values) {
-    var chk = 1;
-    for (var p = 0; p < values.length; ++p) {
-        var top = chk >> 25;
-        chk = (chk & 0x1ffffff) << 5 ^ values[p];
-        for (var i = 0; i < 5; ++i) {
-            if ((top >> i) & 1) {
-                chk ^= GENERATOR[i];
-            }
-        }
-    }
-    return chk;
-}
-
-function hrpExpand (hrp) {
-    var ret = [];
-    var p;
-    for (p = 0; p < hrp.length; ++p) {
-        ret.push(hrp.charCodeAt(p) >> 5);
-    }
-    ret.push(0);
-    for (p = 0; p < hrp.length; ++p) {
-        ret.push(hrp.charCodeAt(p) & 31);
-    }
-    return ret;
-}
-
-function verifyChecksum (hrp, data, enc) {
-    return polymod(hrpExpand(hrp).concat(data)) === getEncodingConst(enc);
-}
-
-function createChecksum (hrp, data, enc) {
-    var values = hrpExpand(hrp).concat(data).concat([0, 0, 0, 0, 0, 0]);
-    var mod = polymod(values) ^ getEncodingConst(enc);
-    var ret = [];
-    for (var p = 0; p < 6; ++p) {
-        ret.push((mod >> 5 * (5 - p)) & 31);
-    }
-    return ret;
-}
-
-function encode (hrp, data, enc) {
-    var combined = data.concat(createChecksum(hrp, data, enc));
-    var ret = hrp + '1';
-    for (var p = 0; p < combined.length; ++p) {
-        ret += CHARSET.charAt(combined[p]);
-    }
-    return ret;
-}
-
-function decode (bechString, enc) {
-    var p;
-    var has_lower = false;
-    var has_upper = false;
-    for (p = 0; p < bechString.length; ++p) {
-        if (bechString.charCodeAt(p) < 33 || bechString.charCodeAt(p) > 126) {
-            return null;
-        }
-        if (bechString.charCodeAt(p) >= 97 && bechString.charCodeAt(p) <= 122) {
-            has_lower = true;
-        }
-        if (bechString.charCodeAt(p) >= 65 && bechString.charCodeAt(p) <= 90) {
-            has_upper = true;
-        }
-    }
-    if (has_lower && has_upper) {
-        return null;
-    }
-    bechString = bechString.toLowerCase();
-    var pos = bechString.lastIndexOf('1');
-    if (pos < 1 || pos + 7 > bechString.length || bechString.length > 110) {
-        return null;
-    }
-    var hrp = bechString.substring(0, pos);
-    var data = [];
-    for (p = pos + 1; p < bechString.length; ++p) {
-        var d = CHARSET.indexOf(bechString.charAt(p));
-        if (d === -1) {
-            return null;
-        }
-        data.push(d);
-    }
-    if (!verifyChecksum(hrp, data, enc)) {
-        return null;
-    }
-    return {hrp: hrp, data: data.slice(0, data.length - 6)};
-}