bitcoin-decoder 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { DecodedData, Input } from './types';
-declare function decode(input: Input): DecodedData;
+declare function decode(input: Input): Promise<DecodedData>;
 export { decode };
 export type { DecodedData, Destination, Metadata, Network, ParsedLNAddress, WellKnown } from './types';
 export { wellKnown } from './utils/lightning-address';

package/dist/index.js

@@ -48,8 +48,8 @@ function decodeBolt12(input, offer) {
         metadata: parsedDestination.metadata
     };
 }
-function decodeLightningAddress(input) {
-    const parsedDestination = lightningAddress(input);
+async function decodeLightningAddress(input) {
+    const parsedDestination = await lightningAddress(input);
     const destination = toDestination(parsedDestination.destination);
     return {
         input,
@@ -58,8 +58,8 @@ function decodeLightningAddress(input) {
         network: 'unknown'
     };
 }
-function decodeLnurl(input) {
-    const parsedDestination = lnurl(input);
+async function decodeLnurl(input) {
+    const parsedDestination = await lnurl(input);
     const destination = toDestination(parsedDestination.destination);
     return {
         input,
@@ -78,8 +78,8 @@ function decodeArk(input) {
         network: getNetwork(input) || 'unknown'
     };
 }
-function decodeBip321(input) {
-    const parsedDestinations = bip321(input);
+async function decodeBip321(input) {
+    const parsedDestinations = await bip321(input);
     const first = parsedDestinations[0];
     if (!first) {
         throw new DecodeError(`No supported payment methods in BIP-321 URI: ${input}`, 'NO_PAYMENT_METHODS');
@@ -104,7 +104,7 @@ function decodeBitcoin(input) {
         network: getNetwork(input) || 'unknown'
     };
 }
-function decodeInput(input) {
+async function decodeInput(input) {
     const lowerInput = input.toLowerCase();
     if (lowerInput.startsWith(BIP321_PREFIX)) {
         return decodeBip321(input);
@@ -119,13 +119,13 @@ function decodeInput(input) {
         return decodeBolt12(input, input);
     }
     if (lowerInput.startsWith(LNURL_PREFIX)) {
-        return decodeLnurl(input);
+        return await decodeLnurl(input);
     }
     if (ARK_PREFIXES.some((prefix) => lowerInput.startsWith(prefix))) {
         return decodeArk(input);
     }
     if (input.includes('@')) {
-        return decodeLightningAddress(input);
+        return await decodeLightningAddress(input);
     }
     if (BITCOIN_ADDRESS_PREFIXES.some((prefix) => lowerInput.startsWith(prefix))) {
         return decodeBitcoin(input);
@@ -149,9 +149,9 @@ function getErrorCode(error) {
         errorCode: 'UNKNOWN_FORMAT'
     };
 }
-function decode(input) {
+async function decode(input) {
     try {
-        return { valid: true, ...decodeInput(input) };
+        return { valid: true, ...(await decodeInput(input)) };
     }
     catch (error) {
         return { ...getErrorCode(error), input };

package/dist/utils/bip-321.d.ts

@@ -1,3 +1,3 @@
 import type { Input, ParsedDestination } from '../types';
-declare function bip321(input: Input): ParsedDestination[];
+declare function bip321(input: Input): Promise<ParsedDestination[]>;
 export { bip321 };

package/dist/utils/bip-321.js

@@ -3,6 +3,7 @@ import { ark } from './ark';
 import { bitcoin } from './bitcoin';
 import { bolt11 } from './bolt11';
 import { bolt12 } from './bolt12';
+import { lightningAddress } from './lightning-address';
 const SATS_PER_BTC = 100_000_000;
 /** Priority order: Lightning (0) > Ark (1) > On-chain (2) */
 const PROTOCOL_PRIORITY = {
@@ -25,8 +26,11 @@ function getMetadata(result) {
     }
     return { amount, description };
 }
-function mapPaymentMethod(paymentMethod, metadata) {
+async function mapPaymentMethod(paymentMethod, metadata) {
     if (paymentMethod.type === 'lightning') {
+        if (paymentMethod.value.includes('@')) {
+            return await lightningAddress(paymentMethod.value);
+        }
         return bolt11(paymentMethod.value);
     }
     if (paymentMethod.type === 'offer') {
@@ -38,19 +42,21 @@ function mapPaymentMethod(paymentMethod, metadata) {
     const parsed = bitcoin(paymentMethod.value);
     return { ...parsed, metadata };
 }
-function parse(result) {
+async function parse(result) {
     const metadata = getMetadata(result);
-    return result.paymentMethods
-        .filter((method) => (method.valid || method.type === 'offer') &&
+    return await Promise.all(result.paymentMethods
+        .filter((method) => (method.valid ||
+        method.type === 'offer' ||
+        (method.type === 'lightning' && method.value.includes('@'))) &&
         isSupportedType(method.type))
         .sort((a, b) => PROTOCOL_PRIORITY[a.type] - PROTOCOL_PRIORITY[b.type])
-        .map((method) => mapPaymentMethod(method, metadata));
+        .map((method) => mapPaymentMethod(method, metadata)));
 }
-function bip321(input) {
+async function bip321(input) {
     const result = parseBIP321(input);
     if (!result.valid) {
         throw new Error(`Invalid BIP-321 URI: ${result.errors.join(', ')}`);
     }
-    return parse(result);
+    return await parse(result);
 }
 export { bip321 };

package/dist/utils/lightning-address.d.ts

@@ -1,5 +1,5 @@
 import type { Input, ParsedDestination, ParsedLNAddress, WellKnown } from '../types';
 declare function parse(input: Input): ParsedLNAddress;
-declare function lightningAddress(input: Input): ParsedDestination;
+declare function lightningAddress(input: Input): Promise<ParsedDestination>;
 declare function wellKnown(lnaddress: string, needsParse?: boolean): Promise<WellKnown | false>;
 export { lightningAddress, parse, wellKnown };

package/dist/utils/lightning-address.js

@@ -13,8 +13,12 @@ function parse(input) {
     }
     return { username, domain };
 }
-function lightningAddress(input) {
-    parse(input);
+async function lightningAddress(input) {
+    const parsed = parse(input);
+    const result = await wellKnown(`${BASE_URL}${parsed.domain}/.well-known/lnurlp/${parsed.username}`, false);
+    if (!result) {
+        throw new DecodeError(`Lightning address not found: ${input}`, 'INVALID_LNADDRESS');
+    }
     return {
         destination: {
             value: input,

package/dist/utils/lnurl.d.ts

@@ -1,4 +1,4 @@
 import type { Input, ParsedDestination } from '../types';
 declare const LNURL_PREFIX = "lnurl";
-declare function lnurl(input: Input): ParsedDestination;
+declare function lnurl(input: Input): Promise<ParsedDestination>;
 export { lnurl, LNURL_PREFIX };

package/dist/utils/lnurl.js

@@ -1,7 +1,7 @@
 import { bech32 } from '@scure/base';
 import { DecodeError } from '../types';
 const LNURL_PREFIX = 'lnurl';
-function lnurl(input) {
+async function lnurl(input) {
     let words;
     try {
         const decoded = bech32.decode(input, 2000);
@@ -21,6 +21,19 @@ function lnurl(input) {
     if (!url.startsWith('https://')) {
         throw new DecodeError('LNURL does not contain a valid URL', 'INVALID_LNURL');
     }
+    try {
+        const response = await fetch(url, { method: 'GET' });
+        const json = (await response.json());
+        if (!json.callback) {
+            throw new DecodeError('LNURL endpoint returned invalid response', 'INVALID_LNURL');
+        }
+    }
+    catch (error) {
+        if (error instanceof DecodeError) {
+            throw error;
+        }
+        throw new DecodeError(`LNURL endpoint unreachable: ${url}`, 'INVALID_LNURL');
+    }
     return {
         destination: {
             value: input,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitcoin-decoder",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Decode bitcoin QR codes, URIs, and raw strings",
   "type": "module",
   "exports": {
@@ -52,13 +52,13 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Psycarlo/bitcoin-decode"
+    "url": "https://github.com/Psycarlo/bitcoin-decoder"
   },
   "bugs": {
     "email": "psycarlo1@gmail.com",
-    "url": "https://github.com/Psycarlo/bitcoin-decode/issues"
+    "url": "https://github.com/Psycarlo/bitcoin-decoder/issues"
   },
-  "homepage": "https://github.com/Psycarlo/bitcoin-decode#readme",
+  "homepage": "https://github.com/Psycarlo/bitcoin-decoder#readme",
   "workspaces": [
     "website"
   ]