bip-321 0.0.6 → 0.0.8

package/README.md

@@ -53,6 +53,49 @@ console.log(result.address); // "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
 console.log(result.paymentMethods); // Array of payment methods
 ```
 
+## Validation Functions
+
+The library also exports standalone validation functions that can be used independently:
+
+```typescript
+import {
+  validateBitcoinAddress,
+  validateLightningInvoice,
+  validateBolt12Offer,
+  validateSilentPaymentAddress,
+  validateArkAddress,
+  validatePopUri,
+} from "bip-321";
+
+// Validate a Bitcoin address
+const btcResult = validateBitcoinAddress("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa");
+console.log(btcResult.valid); // true
+console.log(btcResult.network); // "mainnet"
+
+// Validate a Lightning invoice
+const lnResult = validateLightningInvoice("lnbc15u1p3xnhl2pp5...");
+console.log(lnResult.valid); // true
+console.log(lnResult.network); // "mainnet"
+
+// Validate a BOLT12 offer
+const offerResult = validateBolt12Offer("lno1qqqq02k20d");
+console.log(offerResult.valid); // true
+
+// Validate a Silent Payment address
+const spResult = validateSilentPaymentAddress("sp1qq...");
+console.log(spResult.valid); // true
+console.log(spResult.network); // "mainnet"
+
+// Validate an Ark address
+const arkResult = validateArkAddress("ark1p...");
+console.log(arkResult.valid); // true
+console.log(arkResult.network); // "mainnet"
+
+// Validate a pop URI
+const popResult = validatePopUri("myapp://callback");
+console.log(popResult.valid); // true
+```
+
 ## Usage Examples
 
 ### Basic On-Chain Payment
@@ -192,23 +235,98 @@ Parses a BIP-321 URI and returns detailed information about the payment request.
 **Parameters:**
 - `uri` - The Bitcoin URI string to parse
 - `expectedNetwork` (optional) - Expected network for all payment methods. If specified, all payment methods must match this network or the URI will be marked invalid.
-</text>
 
-<old_text line=240>
-## Validation Rules
+**Returns:** `BIP321ParseResult` object
 
-The parser enforces BIP-321 validation rules:
+### Validation Functions
 
-1. ✅ URI must start with `bitcoin:` (case-insensitive)
-2. ✅ Address in URI path must be valid or empty
-3. ✅ `amount` must be decimal BTC (no commas)
-4. ✅ `label`, `message`, and `amount` cannot appear multiple times
-5. ✅ `pop` and `req-pop` cannot both be present
-6. ✅ Required parameters (`req-*`) must be understood or URI is invalid
-7. ✅ Network-specific parameters (`bc`, `tb`, etc.) must match address network
-8. ✅ `pop` URI scheme must not be forbidden (http, https, file, javascript, mailto)
+The library exports individual validation functions for each payment method type:
+
+#### `validateBitcoinAddress(address: string)`
+
+Validates a Bitcoin address and returns network information.
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  network?: "mainnet" | "testnet" | "regtest" | "signet";
+  error?: string;
+}
+```
+
+#### `validateLightningInvoice(invoice: string)`
+
+Validates a BOLT11 Lightning invoice and detects the network.
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  network?: "mainnet" | "testnet" | "regtest" | "signet";
+  error?: string;
+}
+```
 
-**Returns:** `BIP321ParseResult` object containing:
+#### `validateBolt12Offer(offer: string)`
+
+Validates a BOLT12 offer. Note: BOLT12 offers are network-agnostic.
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  error?: string;
+}
+```
+
+#### `validateSilentPaymentAddress(address: string)`
+
+Validates a BIP-352 Silent Payment address.
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  network?: "mainnet" | "testnet";
+  error?: string;
+}
+```
+
+**Note:** For Silent Payments, `testnet` covers testnet, signet, and regtest.
+
+#### `validateArkAddress(address: string)`
+
+Validates an Ark address (BOAT-0001).
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  network?: "mainnet" | "testnet";
+  error?: string;
+}
+```
+
+**Note:** For Ark, `testnet` covers testnet, signet, and regtest.
+
+#### `validatePopUri(uri: string)`
+
+Validates a proof-of-payment URI and checks for forbidden schemes.
+
+**Returns:**
+```typescript
+{
+  valid: boolean;
+  error?: string;
+}
+```
+</text>
+
+<old_text line=240>
+### BIP321ParseResult
+
+The `parseBIP321` function returns a `BIP321ParseResult` object containing:
 
 ```typescript
 interface BIP321ParseResult {
@@ -309,9 +427,16 @@ The library automatically detects the network from:
 - **Regtest**: `lnbcrt...`
 - **Signet**: `lntbs...`
 
+### Silent Payment Addresses
+- **Mainnet**: `sp1q...`
+- **Testnet**: `tsp1q...` (covers testnet, signet, and regtest)
+
 ### Ark Addresses
 - **Mainnet**: `ark1...`
-- **Testnet**: `tark1...`
+- **Testnet**: `tark1...` (covers testnet, signet, and regtest)
+
+### BOLT12 Offers
+- **Network-agnostic**: `lno...` (no network-specific prefix)
 
 ## Validation Rules
 

package/index.ts

@@ -7,6 +7,16 @@ import {
   validatePopUri,
 } from "./validators";
 
+// Re-export validation functions for public API
+export {
+  validateBitcoinAddress,
+  validateLightningInvoice,
+  validateBolt12Offer,
+  validateSilentPaymentAddress,
+  validateArkAddress,
+  validatePopUri,
+};
+
 export interface PaymentMethod {
   type: "onchain" | "lightning" | "offer" | "silent-payment" | "ark";
   value: string;
@@ -222,7 +232,12 @@ export function parseBIP321(
         const decodedValue = decodeURIComponent(value);
         const validation = validateBitcoinAddress(decodedValue);
         const networkMatches =
-          validation.valid && validation.network === expectedNetwork;
+          validation.valid &&
+          (validation.network === expectedNetwork ||
+            // Testnet and signet are interchangeable for onchain
+            (validation.network === "testnet" &&
+              expectedNetwork === "signet") ||
+            (validation.network === "signet" && expectedNetwork === "testnet"));
 
         result.paymentMethods.push({
           type: "onchain",
@@ -264,12 +279,16 @@ export function parseBIP321(
     for (const method of result.paymentMethods) {
       if (method.network && method.network !== expectedNetwork) {
         // For Ark and Silent Payments, testnet covers testnet/signet/regtest
+        // For onchain, testnet and signet are interchangeable
         const isTestnetCompatible =
-          (method.type === "ark" || method.type === "silent-payment") &&
-          method.network === "testnet" &&
-          (expectedNetwork === "testnet" ||
-            expectedNetwork === "signet" ||
-            expectedNetwork === "regtest");
+          ((method.type === "ark" || method.type === "silent-payment") &&
+            method.network === "testnet" &&
+            (expectedNetwork === "testnet" ||
+              expectedNetwork === "signet" ||
+              expectedNetwork === "regtest")) ||
+          (method.type === "onchain" &&
+            ((method.network === "testnet" && expectedNetwork === "signet") ||
+              (method.network === "signet" && expectedNetwork === "testnet")));
 
         if (!isTestnetCompatible) {
           result.errors.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bip-321",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "A TypeScript/JavaScript library for parsing BIP-321 Bitcoin URI scheme with support for multiple payment methods",
   "type": "module",
   "main": "./index.ts",