bolt12-utils 0.1.0

package/dist/bech32.d.ts

@@ -0,0 +1,31 @@
+/**
+ * BOLT12 bech32 encoding/decoding.
+ *
+ * BOLT12 uses bech32-style encoding WITHOUT a checksum:
+ *   <hrp> "1" <bech32-data>
+ *
+ * The human-readable prefix (hrp) is one of: lno, lnr, lni, lnp.
+ * The data part uses the standard bech32 alphabet to encode 5-bit groups
+ * which are then converted to 8-bit bytes.
+ *
+ * BOLT12 also supports "+" continuation: a "+" followed by optional
+ * whitespace can join multiple lines.
+ */
+export type Bolt12HRP = 'lno' | 'lnr' | 'lni' | 'lnp';
+export interface Bolt12Decoded {
+    hrp: Bolt12HRP;
+    data: Uint8Array;
+}
+/**
+ * Convert 8-bit bytes to 5-bit bech32 groups.
+ */
+export declare function bytesToBech32(data: Uint8Array): number[];
+/**
+ * Decode a BOLT12 string into its hrp and raw TLV bytes.
+ */
+export declare function decodeBolt12(input: string): Bolt12Decoded;
+/**
+ * Encode raw TLV bytes into a BOLT12 bech32 string.
+ */
+export declare function encodeBolt12(hrp: Bolt12HRP, data: Uint8Array): string;
+//# sourceMappingURL=bech32.d.ts.map

package/dist/bech32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bech32.d.ts","sourceRoot":"","sources":["../src/bech32.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AA+CD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAGxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CA0FzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAOrE"}

package/dist/bech32.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * BOLT12 bech32 encoding/decoding.
+ *
+ * BOLT12 uses bech32-style encoding WITHOUT a checksum:
+ *   <hrp> "1" <bech32-data>
+ *
+ * The human-readable prefix (hrp) is one of: lno, lnr, lni, lnp.
+ * The data part uses the standard bech32 alphabet to encode 5-bit groups
+ * which are then converted to 8-bit bytes.
+ *
+ * BOLT12 also supports "+" continuation: a "+" followed by optional
+ * whitespace can join multiple lines.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bytesToBech32 = bytesToBech32;
+exports.decodeBolt12 = decodeBolt12;
+exports.encodeBolt12 = encodeBolt12;
+const BECH32_ALPHABET = 'qpzry9x8gf2tvdw0s3jn54khce6mua7l';
+const ALPHABET_MAP = {};
+for (let i = 0; i < BECH32_ALPHABET.length; i++) {
+    ALPHABET_MAP[BECH32_ALPHABET[i]] = i;
+}
+/**
+ * Convert between bit groups (e.g., 5-bit to 8-bit).
+ * Padding bits (if any) must be zero.
+ */
+function convertBits(data, fromBits, toBits, strict = true) {
+    let value = 0;
+    let bits = 0;
+    const maxV = (1 << toBits) - 1;
+    const result = [];
+    for (let i = 0; i < data.length; i++) {
+        value = (value << fromBits) | data[i];
+        bits += fromBits;
+        while (bits >= toBits) {
+            bits -= toBits;
+            result.push((value >> bits) & maxV);
+        }
+    }
+    if (strict) {
+        // Check that padding bits are zero
+        if (bits > 0) {
+            const pad = (value << (toBits - bits)) & maxV;
+            if (bits >= fromBits) {
+                throw new Error('Excess padding in bech32 data');
+            }
+            if (pad !== 0) {
+                throw new Error('Non-zero padding in bech32 data');
+            }
+        }
+    }
+    else {
+        if (bits > 0) {
+            result.push((value << (toBits - bits)) & maxV);
+        }
+    }
+    return result;
+}
+/**
+ * Convert 8-bit bytes to 5-bit bech32 groups.
+ */
+function bytesToBech32(data) {
+    const arr = Array.from(data);
+    return convertBits(arr, 8, 5, false);
+}
+/**
+ * Decode a BOLT12 string into its hrp and raw TLV bytes.
+ */
+function decodeBolt12(input) {
+    if (typeof input !== 'string') {
+        throw new Error('Input must be a string');
+    }
+    // Handle "+" continuation: "+" optionally followed by whitespace joins parts
+    let str = '';
+    let i = 0;
+    while (i < input.length) {
+        if (input[i] === '+') {
+            // The character before '+' must be a valid bech32 char
+            if (i === 0) {
+                throw new Error('Invalid "+" at start');
+            }
+            const prevChar = str[str.length - 1].toLowerCase();
+            if (!(prevChar in ALPHABET_MAP)) {
+                throw new Error('Invalid character before "+"');
+            }
+            i++; // skip '+'
+            // skip optional whitespace (space, newline, carriage return)
+            while (i < input.length && (input[i] === ' ' || input[i] === '\n' || input[i] === '\r')) {
+                i++;
+            }
+            if (i >= input.length) {
+                throw new Error('Invalid "+" at end');
+            }
+            // The character after whitespace must be a valid bech32 char
+            const nextChar = input[i].toLowerCase();
+            if (!(nextChar in ALPHABET_MAP)) {
+                throw new Error('Invalid character after "+"');
+            }
+            continue;
+        }
+        if (input[i] === '\n' || input[i] === '\r') {
+            i++;
+            continue;
+        }
+        str += input[i];
+        i++;
+    }
+    if (str.indexOf(' ') !== -1) {
+        throw new Error('Invalid whitespace in bolt12 string');
+    }
+    // Must not be mixed case
+    if (str !== str.toLowerCase() && str !== str.toUpperCase()) {
+        throw new Error('Mixed case in bolt12 string');
+    }
+    str = str.toLowerCase();
+    // Must start with "ln"
+    if (!str.startsWith('ln')) {
+        throw new Error('Not a lightning payment request');
+    }
+    // Find separator "1"
+    const sepIdx = str.lastIndexOf('1');
+    if (sepIdx === -1) {
+        throw new Error('No separator found');
+    }
+    const hrp = str.slice(0, sepIdx);
+    const dataStr = str.slice(sepIdx + 1);
+    if (!['lno', 'lnr', 'lni', 'lnp'].includes(hrp)) {
+        throw new Error(`Unknown prefix: ${hrp}`);
+    }
+    if (dataStr.length === 0) {
+        throw new Error('Empty data section');
+    }
+    // Decode bech32 characters to 5-bit values
+    const words = [];
+    for (let j = 0; j < dataStr.length; j++) {
+        const c = dataStr[j];
+        if (!(c in ALPHABET_MAP)) {
+            throw new Error(`Invalid bech32 character: ${c}`);
+        }
+        words.push(ALPHABET_MAP[c]);
+    }
+    // Convert 5-bit to 8-bit
+    const bytes = convertBits(words, 5, 8, true);
+    return {
+        hrp: hrp,
+        data: new Uint8Array(bytes),
+    };
+}
+/**
+ * Encode raw TLV bytes into a BOLT12 bech32 string.
+ */
+function encodeBolt12(hrp, data) {
+    const words = bytesToBech32(data);
+    let result = hrp + '1';
+    for (const w of words) {
+        result += BECH32_ALPHABET[w];
+    }
+    return result;
+}
+//# sourceMappingURL=bech32.js.map

package/dist/bech32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bech32.js","sourceRoot":"","sources":["../src/bech32.ts"],"names":[],"mappings":"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"}

package/dist/bigsize.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BigSize encoding/decoding as defined in BOLT 1.
+ *
+ * BigSize is a variable-length unsigned integer encoding:
+ *   0x00-0xfc:       1 byte (value itself)
+ *   0xfd + u16:      3 bytes (values 0xfd-0xffff)
+ *   0xfe + u32:      5 bytes (values 0x10000-0xffffffff)
+ *   0xff + u64:      9 bytes (values 0x100000000+)
+ */
+export interface BigSizeResult {
+    value: bigint;
+    bytesRead: number;
+}
+/**
+ * Read a BigSize value from a buffer at the given offset.
+ */
+export declare function readBigSize(buf: Uint8Array, offset?: number): BigSizeResult;
+/**
+ * Encode a BigSize value into bytes.
+ */
+export declare function writeBigSize(value: bigint): Uint8Array;
+//# sourceMappingURL=bigsize.d.ts.map

package/dist/bigsize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigsize.d.ts","sourceRoot":"","sources":["../src/bigsize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,GAAE,MAAU,GAAG,aAAa,CA8C9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA2BtD"}

package/dist/bigsize.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * BigSize encoding/decoding as defined in BOLT 1.
+ *
+ * BigSize is a variable-length unsigned integer encoding:
+ *   0x00-0xfc:       1 byte (value itself)
+ *   0xfd + u16:      3 bytes (values 0xfd-0xffff)
+ *   0xfe + u32:      5 bytes (values 0x10000-0xffffffff)
+ *   0xff + u64:      9 bytes (values 0x100000000+)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBigSize = readBigSize;
+exports.writeBigSize = writeBigSize;
+/**
+ * Read a BigSize value from a buffer at the given offset.
+ */
+function readBigSize(buf, offset = 0) {
+    if (offset >= buf.length) {
+        throw new Error('Truncated bigsize: no data');
+    }
+    const first = buf[offset];
+    if (first < 0xfd) {
+        return { value: BigInt(first), bytesRead: 1 };
+    }
+    if (first === 0xfd) {
+        if (offset + 3 > buf.length) {
+            throw new Error('Truncated bigsize: expected 2 more bytes');
+        }
+        const val = (buf[offset + 1] << 8) | buf[offset + 2];
+        if (val < 0xfd) {
+            throw new Error('Non-minimal bigsize encoding');
+        }
+        return { value: BigInt(val), bytesRead: 3 };
+    }
+    if (first === 0xfe) {
+        if (offset + 5 > buf.length) {
+            throw new Error('Truncated bigsize: expected 4 more bytes');
+        }
+        const dv = new DataView(buf.buffer, buf.byteOffset + offset + 1, 4);
+        const val = dv.getUint32(0);
+        if (val < 0x10000) {
+            throw new Error('Non-minimal bigsize encoding');
+        }
+        return { value: BigInt(val), bytesRead: 5 };
+    }
+    // first === 0xff
+    if (offset + 9 > buf.length) {
+        throw new Error('Truncated bigsize: expected 8 more bytes');
+    }
+    const dv = new DataView(buf.buffer, buf.byteOffset + offset + 1, 8);
+    const hi = BigInt(dv.getUint32(0)) << 32n;
+    const lo = BigInt(dv.getUint32(4));
+    const val = hi | lo;
+    if (val < 0x100000000n) {
+        throw new Error('Non-minimal bigsize encoding');
+    }
+    return { value: val, bytesRead: 9 };
+}
+/**
+ * Encode a BigSize value into bytes.
+ */
+function writeBigSize(value) {
+    if (value < 0xfdn) {
+        return new Uint8Array([Number(value)]);
+    }
+    if (value <= 0xffffn) {
+        const buf = new Uint8Array(3);
+        buf[0] = 0xfd;
+        buf[1] = Number((value >> 8n) & 0xffn);
+        buf[2] = Number(value & 0xffn);
+        return buf;
+    }
+    if (value <= 0xffffffffn) {
+        const buf = new Uint8Array(5);
+        buf[0] = 0xfe;
+        const dv = new DataView(buf.buffer, 1, 4);
+        dv.setUint32(0, Number(value));
+        return buf;
+    }
+    const buf = new Uint8Array(9);
+    buf[0] = 0xff;
+    const dv = new DataView(buf.buffer, 1, 8);
+    dv.setUint32(0, Number(value >> 32n));
+    dv.setUint32(4, Number(value & 0xffffffffn));
+    return buf;
+}
+//# sourceMappingURL=bigsize.js.map

package/dist/bigsize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigsize.js","sourceRoot":"","sources":["../src/bigsize.ts"],"names":[],"mappings":"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"}

package/dist/fields.d.ts

@@ -0,0 +1,61 @@
+/**
+ * High-level typed field extraction for BOLT12 messages.
+ *
+ * Provides a convenient API to access decoded offer fields by name
+ * instead of manually searching TLV records by type number.
+ *
+ * @deprecated Use the auto-generated types from `./generated.js` instead.
+ * The generated module provides spec-compliant field names (e.g. `offer_description`
+ * instead of `description`) and covers offer, invoice_request, invoice, and
+ * invoice_error message types. This hand-written module only covers offers.
+ *
+ * Migration:
+ *   import { extractOfferFields, type OfferFields } from './generated.js';
+ */
+import type { TlvRecord } from './tlv.js';
+/**
+ * Parsed chain hash with known name.
+ * @deprecated Use `Uint8Array[]` from generated `OfferFields.offer_chains` instead.
+ */
+export interface Chain {
+    hash: string;
+    name: string;
+}
+/**
+ * Typed offer fields extracted from TLV records.
+ * @deprecated Use `GeneratedOfferFields` from `./generated.js` instead.
+ */
+export interface OfferFields {
+    /** Chain hashes this offer is valid for (default: bitcoin mainnet). */
+    chains?: Chain[];
+    /** Arbitrary metadata bytes (hex). */
+    metadata?: string;
+    /** ISO 4217 currency code if amount is not in msat. */
+    currency?: string;
+    /** Amount in msat (or currency minor units if currency is set). */
+    amount?: bigint;
+    /** Human-readable description. */
+    description?: string;
+    /** Feature bits as raw bytes (hex). */
+    features?: string;
+    /** Absolute expiry as seconds since Unix epoch. */
+    absolute_expiry?: bigint;
+    /** Whether blinded paths are present. */
+    has_paths: boolean;
+    /** Raw paths data (hex). */
+    paths?: string;
+    /** Human-readable issuer name. */
+    issuer?: string;
+    /** Maximum quantity a payer can request. */
+    quantity_max?: bigint;
+    /** Issuer's compressed public key (hex, 33 bytes). */
+    issuer_id?: string;
+    /** The raw TLV records for advanced access. */
+    records: TlvRecord[];
+}
+/**
+ * Extract typed fields from offer TLV records.
+ * @deprecated Use `extractOfferFields` from `./generated.js` instead.
+ */
+export declare function extractOfferFields(records: TlvRecord[]): OfferFields;
+//# sourceMappingURL=fields.d.ts.map

package/dist/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAsB1C;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,CAgDpE"}

package/dist/fields.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * High-level typed field extraction for BOLT12 messages.
+ *
+ * Provides a convenient API to access decoded offer fields by name
+ * instead of manually searching TLV records by type number.
+ *
+ * @deprecated Use the auto-generated types from `./generated.js` instead.
+ * The generated module provides spec-compliant field names (e.g. `offer_description`
+ * instead of `description`) and covers offer, invoice_request, invoice, and
+ * invoice_error message types. This hand-written module only covers offers.
+ *
+ * Migration:
+ *   import { extractOfferFields, type OfferFields } from './generated.js';
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractOfferFields = extractOfferFields;
+/** Read a truncated big-endian unsigned integer. */
+function tu64(data) {
+    if (data.length === 0) {
+        return 0n;
+    }
+    let val = 0n;
+    for (let i = 0; i < data.length; i++) {
+        val = (val << 8n) | BigInt(data[i]);
+    }
+    return val;
+}
+function toHex(buf) {
+    let hex = '';
+    for (let i = 0; i < buf.length; i++) {
+        hex += ('0' + buf[i].toString(16)).slice(-2);
+    }
+    return hex;
+}
+const KNOWN_CHAINS = {
+    '6fe28c0ab6f1b372c1a6a246ae63f74f931e8365e15a089c68d6190000000000': 'bitcoin',
+    '43497fd7f826957108f4a30fd9cec3aeba79972084e90ead01ea330900000000': 'testnet',
+    '06226e46111a0b59caaf126043eb5bbf28c34f3a5e332a1fc7b2b73cf188910f': 'regtest',
+};
+function parseChains(data) {
+    const chains = [];
+    for (let i = 0; i < data.length; i += 32) {
+        const hash = toHex(data.slice(i, i + 32));
+        chains.push({ hash, name: KNOWN_CHAINS[hash] || 'unknown' });
+    }
+    return chains;
+}
+/**
+ * Extract typed fields from offer TLV records.
+ * @deprecated Use `extractOfferFields` from `./generated.js` instead.
+ */
+function extractOfferFields(records) {
+    const fields = {
+        has_paths: false,
+        records,
+    };
+    const utf8 = new TextDecoder('utf-8', { fatal: false });
+    for (const rec of records) {
+        switch (rec.type) {
+            case 2n:
+                fields.chains = parseChains(rec.value);
+                break;
+            case 4n:
+                fields.metadata = toHex(rec.value);
+                break;
+            case 6n:
+                fields.currency = utf8.decode(rec.value);
+                break;
+            case 8n:
+                fields.amount = tu64(rec.value);
+                break;
+            case 10n:
+                fields.description = utf8.decode(rec.value);
+                break;
+            case 12n:
+                fields.features = toHex(rec.value);
+                break;
+            case 14n:
+                fields.absolute_expiry = tu64(rec.value);
+                break;
+            case 16n:
+                fields.has_paths = true;
+                fields.paths = toHex(rec.value);
+                break;
+            case 18n:
+                fields.issuer = utf8.decode(rec.value);
+                break;
+            case 20n:
+                fields.quantity_max = tu64(rec.value);
+                break;
+            case 22n:
+                fields.issuer_id = toHex(rec.value);
+                break;
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=fields.js.map

package/dist/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../src/fields.ts"],"names":[],"mappings":"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"}

package/dist/generated.d.ts

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Auto-generated BOLT12 TLV types, constants, and field extractors.
+ * @generated from specs/bolt12.csv by tools/generate-ts.ts
+ *
+ * DO NOT EDIT — changes will be overwritten on next generation.
+ *
+ * Re-generate with:
+ *   npx tsx tools/generate-ts.ts --spec specs/bolt12.csv --output js/src/generated.ts
+ *
+ * Source: lightning-rfc/12-offer-encoding.md (https://github.com/lightning/bolts)
+ */
+import type { TlvRecord } from './tlv.js';
+/** Subtype: blinded_payinfo */
+export interface BlindedPayinfo {
+    fee_base_msat: number;
+    fee_proportional_millionths: number;
+    cltv_expiry_delta: number;
+    htlc_minimum_msat: bigint;
+    htlc_maximum_msat: bigint;
+    features: Uint8Array;
+}
+/** Subtype: fallback_address */
+export interface FallbackAddress {
+    version: number;
+    address: Uint8Array;
+}
+export declare const OFFER_CHAINS = 2n;
+export declare const OFFER_METADATA = 4n;
+export declare const OFFER_CURRENCY = 6n;
+export declare const OFFER_AMOUNT = 8n;
+export declare const OFFER_DESCRIPTION = 10n;
+export declare const OFFER_FEATURES = 12n;
+export declare const OFFER_ABSOLUTE_EXPIRY = 14n;
+export declare const OFFER_PATHS = 16n;
+export declare const OFFER_ISSUER = 18n;
+export declare const OFFER_QUANTITY_MAX = 20n;
+export declare const OFFER_ISSUER_ID = 22n;
+export declare const KNOWN_OFFER_TYPES: Set<bigint>;
+/** Map from TLV type number to field name for offer. */
+export declare const OFFER_TLV_NAMES: ReadonlyMap<bigint, string>;
+/** Typed fields for a decoded offer. */
+export interface OfferFields {
+    offer_chains?: Uint8Array[];
+    offer_metadata?: Uint8Array;
+    offer_currency?: string;
+    offer_amount?: bigint;
+    offer_description?: string;
+    offer_features?: Uint8Array;
+    offer_absolute_expiry?: bigint;
+    offer_paths?: Uint8Array;
+    offer_issuer?: string;
+    offer_quantity_max?: bigint;
+    offer_issuer_id?: Uint8Array;
+    /** Raw TLV records for advanced access. */
+    records: TlvRecord[];
+}
+/**
+ * Extract typed fields from offer TLV records.
+ */
+export declare function extractOfferFields(records: TlvRecord[]): OfferFields;
+export declare const INVREQ_METADATA = 0n;
+export declare const INVREQ_CHAIN = 80n;
+export declare const INVREQ_AMOUNT = 82n;
+export declare const INVREQ_FEATURES = 84n;
+export declare const INVREQ_QUANTITY = 86n;
+export declare const INVREQ_PAYER_ID = 88n;
+export declare const INVREQ_PAYER_NOTE = 89n;
+export declare const INVREQ_PATHS = 90n;
+export declare const INVREQ_BIP_353_NAME = 91n;
+export declare const SIGNATURE = 240n;
+export declare const KNOWN_INVOICE_REQUEST_TYPES: Set<bigint>;
+/** Map from TLV type number to field name for invoice_request. */
+export declare const INVOICE_REQUEST_TLV_NAMES: ReadonlyMap<bigint, string>;
+/** Typed fields for a decoded invoice_request. */
+export interface InvoiceRequestFields {
+    invreq_metadata?: Uint8Array;
+    offer_chains?: Uint8Array[];
+    offer_metadata?: Uint8Array;
+    offer_currency?: string;
+    offer_amount?: bigint;
+    offer_description?: string;
+    offer_features?: Uint8Array;
+    offer_absolute_expiry?: bigint;
+    offer_paths?: Uint8Array;
+    offer_issuer?: string;
+    offer_quantity_max?: bigint;
+    offer_issuer_id?: Uint8Array;
+    invreq_chain?: Uint8Array;
+    invreq_amount?: bigint;
+    invreq_features?: Uint8Array;
+    invreq_quantity?: bigint;
+    invreq_payer_id?: Uint8Array;
+    invreq_payer_note?: string;
+    invreq_paths?: Uint8Array;
+    invreq_bip_353_name?: {
+        name: Uint8Array;
+        domain: Uint8Array;
+    };
+    signature?: Uint8Array;
+    /** Raw TLV records for advanced access. */
+    records: TlvRecord[];
+}
+/**
+ * Extract typed fields from invoice_request TLV records.
+ */
+export declare function extractInvoiceRequestFields(records: TlvRecord[]): InvoiceRequestFields;
+export declare const INVOICE_PATHS = 160n;
+export declare const INVOICE_BLINDEDPAY = 162n;
+export declare const INVOICE_CREATED_AT = 164n;
+export declare const INVOICE_RELATIVE_EXPIRY = 166n;
+export declare const INVOICE_PAYMENT_HASH = 168n;
+export declare const INVOICE_AMOUNT = 170n;
+export declare const INVOICE_FALLBACKS = 172n;
+export declare const INVOICE_FEATURES = 174n;
+export declare const INVOICE_NODE_ID = 176n;
+export declare const KNOWN_INVOICE_TYPES: Set<bigint>;
+/** Map from TLV type number to field name for invoice. */
+export declare const INVOICE_TLV_NAMES: ReadonlyMap<bigint, string>;
+/** Typed fields for a decoded invoice. */
+export interface InvoiceFields {
+    invreq_metadata?: Uint8Array;
+    offer_chains?: Uint8Array[];
+    offer_metadata?: Uint8Array;
+    offer_currency?: string;
+    offer_amount?: bigint;
+    offer_description?: string;
+    offer_features?: Uint8Array;
+    offer_absolute_expiry?: bigint;
+    offer_paths?: Uint8Array;
+    offer_issuer?: string;
+    offer_quantity_max?: bigint;
+    offer_issuer_id?: Uint8Array;
+    invreq_chain?: Uint8Array;
+    invreq_amount?: bigint;
+    invreq_features?: Uint8Array;
+    invreq_quantity?: bigint;
+    invreq_payer_id?: Uint8Array;
+    invreq_payer_note?: string;
+    invreq_paths?: Uint8Array;
+    invreq_bip_353_name?: {
+        name: Uint8Array;
+        domain: Uint8Array;
+    };
+    invoice_paths?: Uint8Array;
+    invoice_blindedpay?: Uint8Array;
+    invoice_created_at?: bigint;
+    invoice_relative_expiry?: bigint;
+    invoice_payment_hash?: Uint8Array;
+    invoice_amount?: bigint;
+    invoice_fallbacks?: Uint8Array;
+    invoice_features?: Uint8Array;
+    invoice_node_id?: Uint8Array;
+    signature?: Uint8Array;
+    /** Raw TLV records for advanced access. */
+    records: TlvRecord[];
+}
+/**
+ * Extract typed fields from invoice TLV records.
+ */
+export declare function extractInvoiceFields(records: TlvRecord[]): InvoiceFields;
+export declare const ERRONEOUS_FIELD = 1n;
+export declare const SUGGESTED_VALUE = 3n;
+export declare const ERROR = 5n;
+export declare const KNOWN_INVOICE_ERROR_TYPES: Set<bigint>;
+/** Map from TLV type number to field name for invoice_error. */
+export declare const INVOICE_ERROR_TLV_NAMES: ReadonlyMap<bigint, string>;
+/** Typed fields for a decoded invoice_error. */
+export interface InvoiceErrorFields {
+    erroneous_field?: bigint;
+    suggested_value?: Uint8Array;
+    error?: string;
+    /** Raw TLV records for advanced access. */
+    records: TlvRecord[];
+}
+/**
+ * Extract typed fields from invoice_error TLV records.
+ */
+export declare function extractInvoiceErrorFields(records: TlvRecord[]): InvoiceErrorFields;
+//# sourceMappingURL=generated.d.ts.map