digirails 0.1.0

package/dist/network/params.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DigiByte network parameters for mainnet, testnet, and regtest.
+ */
+export interface NetworkParams {
+    readonly name: string;
+    readonly bech32Hrp: string;
+    readonly pubkeyVersion: number;
+    readonly scriptVersion: number;
+    readonly wifVersion: number;
+    readonly bip44CoinType: number;
+    readonly defaultRpcPort: number;
+    readonly defaultP2pPort: number;
+    readonly defaultRpcUrl: string;
+    readonly magic: Buffer;
+}
+export declare const MAINNET: NetworkParams;
+export declare const TESTNET: NetworkParams;
+export declare const REGTEST: NetworkParams;
+/** Lookup network by name */
+export declare function getNetwork(name: string): NetworkParams;
+//# sourceMappingURL=params.d.ts.map

package/dist/network/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/network/params.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,OAAO,EAAE,aAWrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,aAWrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,aAWrB,CAAC;AAEF,6BAA6B;AAC7B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAWtD"}

package/dist/network/params.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * DigiByte network parameters for mainnet, testnet, and regtest.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REGTEST = exports.TESTNET = exports.MAINNET = void 0;
+exports.getNetwork = getNetwork;
+exports.MAINNET = {
+    name: 'mainnet',
+    bech32Hrp: 'dgb',
+    pubkeyVersion: 0x1e,
+    scriptVersion: 0x3f,
+    wifVersion: 0x80,
+    bip44CoinType: 20,
+    defaultRpcPort: 14022,
+    defaultP2pPort: 12024,
+    defaultRpcUrl: 'https://rpc.digirails.org',
+    magic: Buffer.from([0xfa, 0xc3, 0xb6, 0xda]),
+};
+exports.TESTNET = {
+    name: 'testnet',
+    bech32Hrp: 'dgbt',
+    pubkeyVersion: 0x7e,
+    scriptVersion: 0x8c,
+    wifVersion: 0xfe,
+    bip44CoinType: 20,
+    defaultRpcPort: 14023,
+    defaultP2pPort: 12026,
+    defaultRpcUrl: 'https://rpc.digirails.org',
+    magic: Buffer.from([0xfd, 0xc8, 0xbd, 0xdd]),
+};
+exports.REGTEST = {
+    name: 'regtest',
+    bech32Hrp: 'dgbrt',
+    pubkeyVersion: 0x7e,
+    scriptVersion: 0x8c,
+    wifVersion: 0xfe,
+    bip44CoinType: 20,
+    defaultRpcPort: 18443,
+    defaultP2pPort: 18444,
+    defaultRpcUrl: 'http://127.0.0.1:18443',
+    magic: Buffer.from([0xfa, 0xbf, 0xb5, 0xda]),
+};
+/** Lookup network by name */
+function getNetwork(name) {
+    switch (name.toLowerCase()) {
+        case 'mainnet':
+            return exports.MAINNET;
+        case 'testnet':
+            return exports.TESTNET;
+        case 'regtest':
+            return exports.REGTEST;
+        default:
+            throw new Error(`Unknown network: ${name}`);
+    }
+}
+//# sourceMappingURL=params.js.map

package/dist/network/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/network/params.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAuDH,gCAWC;AAnDY,QAAA,OAAO,GAAkB;IACpC,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEW,QAAA,OAAO,GAAkB;IACpC,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,MAAM;IACjB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEW,QAAA,OAAO,GAAkB;IACpC,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,OAAO;IAClB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,EAAE;IACjB,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,6BAA6B;AAC7B,SAAgB,UAAU,CAAC,IAAY;IACrC,QAAQ,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,eAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,eAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,eAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/opreturn.d.ts

@@ -0,0 +1,25 @@
+import { SubProtocol } from './network/constants';
+/** Encode the 5-byte DigiRails header. Set test=true to mark as a test transaction. */
+export declare function encodeHeader(subProtocol: SubProtocol, messageType: number, test?: boolean): Buffer;
+/** Decoded header result: [version, subProtocol, messageType, payload, isTest] */
+export type DecodedHeader = [number, SubProtocol, number, Uint8Array, boolean];
+/** Decode header from raw data. Returns [version, subProtocol, messageType, payload, isTest] or null. */
+export declare function decodeHeader(data: Uint8Array): DecodedHeader | null;
+/** Encode an identity declaration: header + optional UTF-8 label (up to 75 bytes) */
+export declare function encodeIdentityDeclaration(label?: string, test?: boolean): Buffer;
+/** Encode an identity transfer: header + new address hash (20 or 32 bytes) */
+export declare function encodeIdentityTransfer(newAddressHash: Uint8Array, test?: boolean): Buffer;
+/** Encode a service declaration: header + category(2B) + flags(2B) + manifestHash(32B) + [domain] */
+export declare function encodeServiceDeclaration(category: number, flags: number, manifestHashBytes: Uint8Array, { test, manifestDomain }?: {
+    test?: boolean;
+    manifestDomain?: string;
+}): Buffer;
+/** Encode a payment memo: header + invoiceId(16B) + optional serviceRef(0-59B) */
+export declare function encodePaymentMemo(invoiceId: Uint8Array, serviceRef?: Uint8Array, test?: boolean): Buffer;
+/** Encode a refund memo: header + invoiceId(16B) = 21B total */
+export declare function encodeRefundMemo(invoiceId: Uint8Array, test?: boolean): Buffer;
+/** Encode an attestation: header + targetAddressHash(20B) + score(1B) + nonce(4B) = 30B total */
+export declare function encodeAttestation(targetAddressHash: Uint8Array, score: number, nonce: number, test?: boolean): Buffer;
+/** Compute SHA-256 hash of a manifest JSON string */
+export declare function manifestHash(manifestJson: string): Buffer;
+//# sourceMappingURL=opreturn.d.ts.map

package/dist/opreturn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opreturn.d.ts","sourceRoot":"","sources":["../src/opreturn.ts"],"names":[],"mappings":"AASA,OAAO,EAOL,WAAW,EAIZ,MAAM,qBAAqB,CAAC;AAI7B,uFAAuF;AACvF,wBAAgB,YAAY,CAC1B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,IAAI,UAAQ,GACX,MAAM,CAGR;AAED,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAE/E,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAYnE;AAID,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,KAAK,SAAK,EAAE,IAAI,UAAQ,GAAG,MAAM,CAS1E;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,UAAQ,GAAG,MAAM,CAOvF;AAID,qGAAqG;AACrG,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,UAAU,EAC7B,EAAE,IAAY,EAAE,cAAmB,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,MAAM,CAmBR;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,UAAU,EACrB,UAAU,GAAE,UAA4B,EACxC,IAAI,UAAQ,GACX,MAAM,CAYR;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,UAAQ,GAAG,MAAM,CAO5E;AAID,iGAAiG;AACjG,wBAAgB,iBAAiB,CAC/B,iBAAiB,EAAE,UAAU,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,UAAQ,GACX,MAAM,CAeR;AAID,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/opreturn.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeHeader = encodeHeader;
+exports.decodeHeader = decodeHeader;
+exports.encodeIdentityDeclaration = encodeIdentityDeclaration;
+exports.encodeIdentityTransfer = encodeIdentityTransfer;
+exports.encodeServiceDeclaration = encodeServiceDeclaration;
+exports.encodePaymentMemo = encodePaymentMemo;
+exports.encodeRefundMemo = encodeRefundMemo;
+exports.encodeAttestation = encodeAttestation;
+exports.manifestHash = manifestHash;
+/**
+ * OP_RETURN header encoding/decoding for all DigiRails sub-protocols.
+ *
+ * Header format (5 bytes):
+ *   DR_MAGIC (2B) + version byte (1B) + SubProtocol (1B) + MessageType (1B)
+ *
+ * The version byte's MSB (bit 7) is a test flag. Lower 7 bits = version number.
+ */
+const sha256_1 = require("@noble/hashes/sha256");
+const constants_1 = require("./network/constants");
+// ---------- Header ----------
+/** Encode the 5-byte DigiRails header. Set test=true to mark as a test transaction. */
+function encodeHeader(subProtocol, messageType, test = false) {
+    const versionByte = test ? constants_1.DR_VERSION | constants_1.DR_TEST_FLAG : constants_1.DR_VERSION;
+    return Buffer.from([0x44, 0x52, versionByte, subProtocol, messageType]);
+}
+/** Decode header from raw data. Returns [version, subProtocol, messageType, payload, isTest] or null. */
+function decodeHeader(data) {
+    if (data.length < constants_1.DR_HEADER_SIZE)
+        return null;
+    if (data[0] !== 0x44 || data[1] !== 0x52)
+        return null;
+    const rawVersion = data[2];
+    const isTest = (rawVersion & constants_1.DR_TEST_FLAG) !== 0;
+    const version = rawVersion & 0x7f;
+    const subProtocol = data[3];
+    const messageType = data[4];
+    const payload = data.slice(constants_1.DR_HEADER_SIZE);
+    return [version, subProtocol, messageType, payload, isTest];
+}
+// ---------- DR-Core (0x00) ----------
+/** Encode an identity declaration: header + optional UTF-8 label (up to 75 bytes) */
+function encodeIdentityDeclaration(label = '', test = false) {
+    const header = encodeHeader(constants_1.SubProtocol.DR_CORE, constants_1.CoreMessageType.IDENTITY_DECLARATION, test);
+    const labelBytes = Buffer.from(label, 'utf-8');
+    if (labelBytes.length > constants_1.DR_MAX_PAYLOAD) {
+        throw new Error(`Label exceeds ${constants_1.DR_MAX_PAYLOAD} bytes: ${labelBytes.length}`);
+    }
+    return Buffer.concat([header, labelBytes]);
+}
+/** Encode an identity transfer: header + new address hash (20 or 32 bytes) */
+function encodeIdentityTransfer(newAddressHash, test = false) {
+    if (newAddressHash.length !== 20 && newAddressHash.length !== 32) {
+        throw new Error(`Address hash must be 20 or 32 bytes, got ${newAddressHash.length}`);
+    }
+    const header = encodeHeader(constants_1.SubProtocol.DR_CORE, constants_1.CoreMessageType.IDENTITY_TRANSFER, test);
+    return Buffer.concat([header, newAddressHash]);
+}
+// ---------- DR-Pay (0x01) ----------
+/** Encode a service declaration: header + category(2B) + flags(2B) + manifestHash(32B) + [domain] */
+function encodeServiceDeclaration(category, flags, manifestHashBytes, { test = false, manifestDomain = '' } = {}) {
+    if (manifestHashBytes.length !== 32) {
+        throw new Error(`Manifest hash must be 32 bytes, got ${manifestHashBytes.length}`);
+    }
+    const domainBytes = manifestDomain ? Buffer.from(manifestDomain, 'utf-8') : Buffer.alloc(0);
+    if (domainBytes.length > constants_1.DR_MAX_PAYLOAD - 36) {
+        throw new Error(`Domain too long: ${domainBytes.length} bytes (max ${constants_1.DR_MAX_PAYLOAD - 36})`);
+    }
+    const header = encodeHeader(constants_1.SubProtocol.DR_PAY, constants_1.PayMessageType.SERVICE_DECLARATION, test);
+    const payload = Buffer.alloc(36);
+    payload.writeUInt16BE(category, 0);
+    payload.writeUInt16BE(flags, 2);
+    payload.set(manifestHashBytes, 4);
+    return Buffer.concat([header, payload, domainBytes]);
+}
+/** Encode a payment memo: header + invoiceId(16B) + optional serviceRef(0-59B) */
+function encodePaymentMemo(invoiceId, serviceRef = Buffer.alloc(0), test = false) {
+    if (invoiceId.length !== 16) {
+        throw new Error(`Invoice ID must be 16 bytes, got ${invoiceId.length}`);
+    }
+    const maxRef = constants_1.DR_MAX_PAYLOAD - 16; // 59 bytes
+    if (serviceRef.length > maxRef) {
+        throw new Error(`Service ref exceeds ${maxRef} bytes: ${serviceRef.length}`);
+    }
+    const header = encodeHeader(constants_1.SubProtocol.DR_PAY, constants_1.PayMessageType.PAYMENT_MEMO, test);
+    return Buffer.concat([header, invoiceId, serviceRef]);
+}
+/** Encode a refund memo: header + invoiceId(16B) = 21B total */
+function encodeRefundMemo(invoiceId, test = false) {
+    if (invoiceId.length !== 16) {
+        throw new Error(`Invoice ID must be 16 bytes, got ${invoiceId.length}`);
+    }
+    const header = encodeHeader(constants_1.SubProtocol.DR_PAY, constants_1.PayMessageType.REFUND_MEMO, test);
+    return Buffer.concat([header, invoiceId]);
+}
+// ---------- DR-Rep (0x02) ----------
+/** Encode an attestation: header + targetAddressHash(20B) + score(1B) + nonce(4B) = 30B total */
+function encodeAttestation(targetAddressHash, score, nonce, test = false) {
+    if (targetAddressHash.length !== 20) {
+        throw new Error(`Target address hash must be 20 bytes, got ${targetAddressHash.length}`);
+    }
+    if (score < 0 || score > 255) {
+        throw new Error(`Score must be 0-255, got ${score}`);
+    }
+    const header = encodeHeader(constants_1.SubProtocol.DR_REP, constants_1.RepMessageType.ATTESTATION, test);
+    const payload = Buffer.alloc(25);
+    payload.set(targetAddressHash, 0);
+    payload[20] = score;
+    payload.writeUInt32BE(nonce, 21);
+    return Buffer.concat([header, payload]);
+}
+// ---------- Utilities ----------
+/** Compute SHA-256 hash of a manifest JSON string */
+function manifestHash(manifestJson) {
+    return Buffer.from((0, sha256_1.sha256)(Buffer.from(manifestJson, 'utf-8')));
+}
+//# sourceMappingURL=opreturn.js.map

package/dist/opreturn.js.map

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

package/dist/payment/buyer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Buyer-side payment flow: request service, pay invoice, receive delivery.
+ */
+import { Wallet } from '../wallet/wallet';
+import { ConfirmationTier } from '../models/enums';
+import { PaymentInvoice, ServiceDelivery } from '../models/messages';
+/**
+ * Send a SERVICE_REQUEST and receive a PAYMENT_INVOICE.
+ * Returns [invoice, requestEndpointUrl].
+ */
+export declare function requestService(params: {
+    wallet: Wallet;
+    sellerUrl: string;
+    serviceId: string;
+    serviceParams?: Record<string, unknown>;
+    maxAmount?: string;
+    confirmationTier?: ConfirmationTier;
+    sellerAddress?: string;
+}): Promise<[PaymentInvoice, string]>;
+/**
+ * Pay an invoice: build TX, broadcast, send PAYMENT_BROADCAST, receive SERVICE_DELIVERY.
+ */
+export declare function payInvoice(params: {
+    wallet: Wallet;
+    invoice: PaymentInvoice;
+    sellerUrl: string;
+    test?: boolean;
+}): Promise<ServiceDelivery>;
+//# sourceMappingURL=buyer.d.ts.map

package/dist/payment/buyer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer.d.ts","sourceRoot":"","sources":["../../src/payment/buyer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,cAAc,EAEd,eAAe,EAKhB,MAAM,oBAAoB,CAAC;AAG5B;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CA2DpC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsE3B"}

package/dist/payment/buyer.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestService = requestService;
+exports.payInvoice = payInvoice;
+const utxo_1 = require("../wallet/utxo");
+const opreturn_1 = require("../opreturn");
+const script_1 = require("../crypto/script");
+const enums_1 = require("../models/enums");
+const messages_1 = require("../models/messages");
+const exceptions_1 = require("../exceptions");
+/**
+ * Send a SERVICE_REQUEST and receive a PAYMENT_INVOICE.
+ * Returns [invoice, requestEndpointUrl].
+ */
+async function requestService(params) {
+    const { wallet, sellerUrl, serviceId, serviceParams, maxAmount = '0.01', confirmationTier = enums_1.ConfirmationTier.MEMPOOL, sellerAddress = '', } = params;
+    const requestUrl = `${sellerUrl.replace(/\/$/, '')}/drpay/request`;
+    const request = (0, messages_1.createPaymentRequest)({
+        fromAddress: wallet.address,
+        toAddress: sellerAddress,
+        serviceId,
+        serviceParams,
+        maxAmount,
+        confirmationTier,
+    });
+    let response;
+    try {
+        response = await fetch(requestUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (err) {
+        throw new exceptions_1.NetworkError(`Failed to reach seller: ${err.message}`);
+    }
+    const data = await response.json();
+    // Check for error response
+    if (data.type === 'error') {
+        const errResp = messages_1.ErrorResponseSchema.parse(data);
+        throw new exceptions_1.PaymentError(`Seller error: ${errResp.error.code} — ${errResp.error.message}`);
+    }
+    const invoice = messages_1.PaymentInvoiceSchema.parse(data);
+    // Validate invoice
+    const now = Math.floor(Date.now() / 1000);
+    if (invoice.payment.expires_at <= now) {
+        throw new exceptions_1.InvoiceExpiredError();
+    }
+    // Validate amount doesn't exceed max
+    const invoiceAmountSat = (0, utxo_1.dgbToSat)(invoice.payment.amount);
+    const maxAmountSat = (0, utxo_1.dgbToSat)(maxAmount);
+    if (invoiceAmountSat > maxAmountSat) {
+        throw new exceptions_1.PaymentError(`Invoice amount ${invoice.payment.amount} DGB exceeds max ${maxAmount} DGB`);
+    }
+    return [invoice, requestUrl];
+}
+/**
+ * Pay an invoice: build TX, broadcast, send PAYMENT_BROADCAST, receive SERVICE_DELIVERY.
+ */
+async function payInvoice(params) {
+    const { wallet, invoice, sellerUrl, test = false } = params;
+    // Check expiry
+    const now = Math.floor(Date.now() / 1000);
+    if (invoice.payment.expires_at <= now) {
+        throw new exceptions_1.InvoiceExpiredError();
+    }
+    const amountSat = (0, utxo_1.dgbToSat)(invoice.payment.amount);
+    // Encode payment memo in OP_RETURN
+    // Use first 16 bytes of invoice ID as the memo invoice_id
+    const invoiceIdBytes = Buffer.alloc(16);
+    const idStr = invoice.id.replace(/^inv_/, '');
+    const idBuf = Buffer.from(idStr, 'utf-8');
+    idBuf.copy(invoiceIdBytes, 0, 0, Math.min(idBuf.length, 16));
+    const opReturnData = (0, opreturn_1.encodePaymentMemo)(invoiceIdBytes, Buffer.alloc(0), test);
+    // Build and sign transaction
+    const tx = await wallet.buildPayment({
+        toAddress: invoice.payment.address,
+        amountSat,
+        opReturnData,
+    });
+    // Broadcast
+    const txid = await wallet.broadcast(tx);
+    // Find the payment output vout
+    const expectedScript = (0, script_1.addressToScriptPubkey)(invoice.payment.address, wallet.getNetwork());
+    let paymentVout = 0;
+    for (let i = 0; i < tx.outputs.length; i++) {
+        if (Buffer.compare(tx.outputs[i].scriptPubkey, expectedScript) === 0) {
+            paymentVout = i;
+            break;
+        }
+    }
+    // Send PAYMENT_BROADCAST
+    const broadcastUrl = `${sellerUrl.replace(/\/$/, '')}/drpay/broadcast`;
+    const broadcast = (0, messages_1.createPaymentBroadcast)({
+        invoiceId: invoice.id,
+        txid,
+        vout: paymentVout,
+        rawTx: invoice.terms.confirmation_tier === 'mempool' ? tx.hex() : undefined,
+    });
+    let deliveryResponse;
+    try {
+        deliveryResponse = await fetch(broadcastUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(broadcast),
+        });
+    }
+    catch (err) {
+        throw new exceptions_1.NetworkError(`Failed to send broadcast to seller: ${err.message}`);
+    }
+    const deliveryData = await deliveryResponse.json();
+    if (deliveryData.type === 'error') {
+        const errResp = messages_1.ErrorResponseSchema.parse(deliveryData);
+        throw new exceptions_1.PaymentError(`Seller error on broadcast: ${errResp.error.code} — ${errResp.error.message}`);
+    }
+    return messages_1.ServiceDeliverySchema.parse(deliveryData);
+}
+//# sourceMappingURL=buyer.js.map

package/dist/payment/buyer.js.map

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

package/dist/payment/flow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PaymentFlow: high-level orchestrator combining buyer operations.
+ */
+import { Wallet } from '../wallet/wallet';
+import { ConfirmationTier } from '../models/enums';
+import { ServiceDelivery } from '../models/messages';
+/**
+ * Complete a full payment flow in one call:
+ * discover → request → pay → receive delivery.
+ */
+export declare function buy(params: {
+    wallet: Wallet;
+    sellerUrl: string;
+    serviceId: string;
+    serviceParams?: Record<string, unknown>;
+    maxAmount?: string;
+    confirmationTier?: ConfirmationTier;
+    test?: boolean;
+}): Promise<ServiceDelivery>;
+//# sourceMappingURL=flow.d.ts.map

package/dist/payment/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/payment/flow.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;;GAGG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CA4B3B"}

package/dist/payment/flow.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buy = buy;
+const enums_1 = require("../models/enums");
+const buyer_1 = require("./buyer");
+/**
+ * Complete a full payment flow in one call:
+ * discover → request → pay → receive delivery.
+ */
+async function buy(params) {
+    const { wallet, sellerUrl, serviceId, serviceParams, maxAmount = '0.01', confirmationTier = enums_1.ConfirmationTier.MEMPOOL, test = false, } = params;
+    // Step 1: Request service (sends SERVICE_REQUEST, receives PAYMENT_INVOICE)
+    const [invoice] = await (0, buyer_1.requestService)({
+        wallet,
+        sellerUrl,
+        serviceId,
+        serviceParams,
+        maxAmount,
+        confirmationTier,
+    });
+    // Step 2: Pay invoice (builds TX, broadcasts, sends PAYMENT_BROADCAST, receives SERVICE_DELIVERY)
+    return (0, buyer_1.payInvoice)({
+        wallet,
+        invoice,
+        sellerUrl,
+        test,
+    });
+}
+//# sourceMappingURL=flow.js.map

package/dist/payment/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/payment/flow.ts"],"names":[],"mappings":";;AAYA,kBAoCC;AA5CD,2CAAmD;AAEnD,mCAAqD;AAErD;;;GAGG;AACI,KAAK,UAAU,GAAG,CAAC,MAQzB;IACC,MAAM,EACJ,MAAM,EACN,SAAS,EACT,SAAS,EACT,aAAa,EACb,SAAS,GAAG,MAAM,EAClB,gBAAgB,GAAG,wBAAgB,CAAC,OAAO,EAC3C,IAAI,GAAG,KAAK,GACb,GAAG,MAAM,CAAC;IAEX,4EAA4E;IAC5E,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAA,sBAAc,EAAC;QACrC,MAAM;QACN,SAAS;QACT,SAAS;QACT,aAAa;QACb,SAAS;QACT,gBAAgB;KACjB,CAAC,CAAC;IAEH,kGAAkG;IAClG,OAAO,IAAA,kBAAU,EAAC;QAChB,MAAM;QACN,OAAO;QACP,SAAS;QACT,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/dist/payment/index.d.ts

@@ -0,0 +1,5 @@
+export { requestService, payInvoice } from './buyer';
+export { SellerFlow, ServiceHandler } from './seller';
+export { buy } from './flow';
+export { verifyRawTxSimple } from './verification';
+//# sourceMappingURL=index.d.ts.map

package/dist/payment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/payment/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyRawTxSimple = exports.buy = exports.SellerFlow = exports.payInvoice = exports.requestService = void 0;
+var buyer_1 = require("./buyer");
+Object.defineProperty(exports, "requestService", { enumerable: true, get: function () { return buyer_1.requestService; } });
+Object.defineProperty(exports, "payInvoice", { enumerable: true, get: function () { return buyer_1.payInvoice; } });
+var seller_1 = require("./seller");
+Object.defineProperty(exports, "SellerFlow", { enumerable: true, get: function () { return seller_1.SellerFlow; } });
+var flow_1 = require("./flow");
+Object.defineProperty(exports, "buy", { enumerable: true, get: function () { return flow_1.buy; } });
+var verification_1 = require("./verification");
+Object.defineProperty(exports, "verifyRawTxSimple", { enumerable: true, get: function () { return verification_1.verifyRawTxSimple; } });
+//# sourceMappingURL=index.js.map

package/dist/payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":";;;AAAA,iCAAqD;AAA5C,uGAAA,cAAc,OAAA;AAAE,mGAAA,UAAU,OAAA;AACnC,mCAAsD;AAA7C,oGAAA,UAAU,OAAA;AACnB,+BAA6B;AAApB,2FAAA,GAAG,OAAA;AACZ,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA"}

package/dist/payment/seller.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Seller-side payment flow: handle requests, verify payments, deliver services.
+ */
+import { RpcClient } from '../rpc/client';
+import { Wallet } from '../wallet/wallet';
+import { PaymentInvoice, ServiceDelivery, ErrorResponse } from '../models/messages';
+import { Service } from '../models/manifest';
+import { NetworkParams } from '../network/params';
+/** Service handler function type */
+export type ServiceHandler = (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
+export declare class SellerFlow {
+    private wallet;
+    private rpc;
+    private network;
+    private autoRefund;
+    private services;
+    private pendingInvoices;
+    constructor(wallet: Wallet, network?: NetworkParams, rpc?: RpcClient, autoRefund?: boolean);
+    /** Register a service with its handler */
+    registerService(service: Service, handler: ServiceHandler): void;
+    /** Handle a SERVICE_REQUEST → return PAYMENT_INVOICE or ErrorResponse */
+    handleRequest(data: unknown): PaymentInvoice | ErrorResponse;
+    /** Handle a PAYMENT_BROADCAST → verify payment → execute handler → return ServiceDelivery or ErrorResponse */
+    handleBroadcast(data: unknown): Promise<ServiceDelivery | ErrorResponse>;
+    private attemptRefund;
+}
+//# sourceMappingURL=seller.d.ts.map

package/dist/payment/seller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller.d.ts","sourceRoot":"","sources":["../../src/payment/seller.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,OAAO,EAKL,cAAc,EACd,eAAe,EACf,aAAa,EAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAAE,aAAa,EAAW,MAAM,mBAAmB,CAAC;AAI3D,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACxC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAUtC,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,QAAQ,CAAyE;IACzF,OAAO,CAAC,eAAe,CAA0C;gBAErD,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAuB,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,GAAE,OAAc;IAOzG,0CAA0C;IAC1C,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhE,yEAAyE;IACzE,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,aAAa;IA2C5D,8GAA8G;IACxG,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,GAAG,aAAa,CAAC;YAwGhE,aAAa;CAiC5B"}