@resvary/sdk 0.5.0-alpha.1

package/dist/pricing/rating.js

@@ -0,0 +1,109 @@
+import { creditUnitsToString, divideCeil, parseCreditUnits, toCreditUnits, } from '../credits/amount.js';
+export function createMeterDefinition(input) {
+    const dimensions = [...new Set(input.dimensions.map(assertIdentifier))];
+    if (dimensions.length === 0) {
+        throw new Error('A meter requires at least one dimension');
+    }
+    return {
+        id: assertIdentifier(input.id),
+        projectId: assertIdentifier(input.projectId),
+        key: assertIdentifier(input.key),
+        name: input.name?.trim() || input.key,
+        dimensions,
+        createdAt: input.createdAt ?? Date.now(),
+        metadata: input.metadata,
+    };
+}
+export function createPriceVersion(input) {
+    if (!Number.isSafeInteger(input.version) || input.version < 1) {
+        throw new Error('Price version must be a positive integer');
+    }
+    if (input.projectId !== input.meter.projectId) {
+        throw new Error('Price and meter must belong to the same project');
+    }
+    if (input.rates.length === 0) {
+        throw new Error('A price requires at least one rate');
+    }
+    const seen = new Set();
+    const rates = input.rates.map((rate) => {
+        const dimension = assertIdentifier(rate.dimension);
+        if (!input.meter.dimensions.includes(dimension)) {
+            throw new Error(`Unknown meter dimension: ${dimension}`);
+        }
+        if (seen.has(dimension)) {
+            throw new Error(`Duplicate price dimension: ${dimension}`);
+        }
+        seen.add(dimension);
+        const unitSize = parsePositiveInteger(rate.unitSize, 'unitSize').toString();
+        const amountUnits = toCreditUnits(rate.amount);
+        if (amountUnits <= 0n) {
+            throw new Error('Rate amount must be positive');
+        }
+        return {
+            dimension,
+            unitSize,
+            amount: creditUnitsToString(amountUnits),
+            amountUnits: amountUnits.toString(),
+        };
+    });
+    return {
+        id: assertIdentifier(input.id),
+        projectId: assertIdentifier(input.projectId),
+        meterId: input.meter.id,
+        meterKey: input.meter.key,
+        version: input.version,
+        currency: 'USD',
+        rates,
+        createdAt: input.createdAt ?? Date.now(),
+        metadata: input.metadata,
+    };
+}
+export function rateUsage(price, quantities) {
+    const lineItems = price.rates.map((rate) => {
+        const quantity = parseNonNegativeInteger(quantities[rate.dimension] ?? '0', rate.dimension);
+        const rateUnits = parseCreditUnits(rate.amountUnits, 'rate amount units');
+        const amountUnits = divideCeil(quantity * rateUnits, BigInt(rate.unitSize));
+        return {
+            dimension: rate.dimension,
+            quantity: quantity.toString(),
+            unitSize: rate.unitSize,
+            rateAmount: rate.amount,
+            rateUnits: rate.amountUnits,
+            amount: creditUnitsToString(amountUnits),
+            amountUnits: amountUnits.toString(),
+        };
+    });
+    for (const dimension of Object.keys(quantities)) {
+        if (!price.rates.some((rate) => rate.dimension === dimension)) {
+            throw new Error(`Usage contains an unpriced dimension: ${dimension}`);
+        }
+    }
+    const totalUnits = lineItems.reduce((total, item) => total + parseCreditUnits(item.amountUnits), 0n);
+    return {
+        priceId: price.id,
+        totalAmount: creditUnitsToString(totalUnits),
+        totalUnits: totalUnits.toString(),
+        lineItems,
+    };
+}
+function assertIdentifier(value) {
+    const normalized = value.trim();
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(normalized)) {
+        throw new Error(`Invalid identifier: ${value}`);
+    }
+    return normalized;
+}
+function parsePositiveInteger(value, label) {
+    const parsed = parseNonNegativeInteger(value, label);
+    if (parsed === 0n) {
+        throw new Error(`${label} must be positive`);
+    }
+    return parsed;
+}
+function parseNonNegativeInteger(value, label) {
+    if (!/^(0|[1-9]\d*)$/.test(value)) {
+        throw new Error(`${label} must be a non-negative integer`);
+    }
+    return BigInt(value);
+}
+//# sourceMappingURL=rating.js.map

package/dist/pricing/rating.js.map

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

package/dist/receipts/amount.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stablecoin amount helpers.
+ */
+export declare const STABLECOIN_DECIMALS = 6;
+export declare function toStablecoinUnits(amount: string, decimals?: number): bigint;
+export declare function stablecoinUnitsToString(units: bigint, decimals?: number): string;
+export declare function isAmountAtLeast(received: string, required: string): boolean;
+//# sourceMappingURL=amount.d.ts.map

package/dist/receipts/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../../src/receipts/amount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAcxF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAO7F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/dist/receipts/amount.js

@@ -0,0 +1,27 @@
+/**
+ * Stablecoin amount helpers.
+ */
+export const STABLECOIN_DECIMALS = 6;
+export function toStablecoinUnits(amount, decimals = STABLECOIN_DECIMALS) {
+    const normalized = amount.trim();
+    if (!/^\d+(\.\d+)?$/.test(normalized)) {
+        throw new Error(`Invalid stablecoin amount: ${amount}`);
+    }
+    const [whole, fraction = ''] = normalized.split('.');
+    if (fraction.length > decimals) {
+        throw new Error(`Stablecoin amount exceeds ${decimals} decimals: ${amount}`);
+    }
+    return BigInt(whole) * 10n ** BigInt(decimals)
+        + BigInt(fraction.padEnd(decimals, '0'));
+}
+export function stablecoinUnitsToString(units, decimals = STABLECOIN_DECIMALS) {
+    const divisor = 10n ** BigInt(decimals);
+    const whole = units / divisor;
+    const fraction = units % divisor;
+    const fractionText = fraction.toString().padStart(decimals, '0').replace(/0+$/, '');
+    return fractionText ? `${whole}.${fractionText}` : whole.toString();
+}
+export function isAmountAtLeast(received, required) {
+    return toStablecoinUnits(received) >= toStablecoinUnits(required);
+}
+//# sourceMappingURL=amount.js.map

package/dist/receipts/amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.js","sourceRoot":"","sources":["../../src/receipts/amount.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAQ,GAAG,mBAAmB;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,cAAc,MAAM,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC;UAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,QAAQ,GAAG,mBAAmB;IACnF,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACjC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpF,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IAChE,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC"}

package/dist/receipts/index.d.ts

@@ -0,0 +1,16 @@
+export { STABLECOIN_DECIMALS, isAmountAtLeast, stablecoinUnitsToString, toStablecoinUnits, } from './amount.js';
+export { createInvoice, createInvoiceId, createPaymentUri, createReceipt, isInvoiceExpired, matchPaymentToInvoice, } from './invoice.js';
+export { ReceiptLedger, type LedgerFilter } from './ledger.js';
+export { createInvoiceMemo, parseInvoiceMemo, type ParsedInvoiceMemo, createInvoiceMemoData, createInvoiceMemoId, } from './memo.js';
+export { ARC_MEMO_ABI, ERC20_TRANSFER_ABI, createMemoPaymentRequest, type MemoPaymentRequestOptions, } from './memo-payment.js';
+export { ReceiptWatcher, type ReceiptWatcherConfig, type ReceiptWatcherLifecycleEvent, type ReceiptWatcherClient, } from './watcher.js';
+export { MemoPaymentProofError, findMemoPaymentProof, verifyMemoPaymentProof, type FindMemoPaymentProofInput, type FindMemoPaymentProofResult, type ProofClient, type ProofMemoLog, type ProofPollingClient, type ProofTransactionReceipt, type VerifyMemoPaymentProofFailureReason, type VerifyMemoPaymentProofInput, type VerifyMemoPaymentProofResult, } from './proof.js';
+export { createWebhookEvent, serializeWebhookPayload, signWebhookEvent, verifyWebhookSignature, type WebhookSignature, } from './webhooks.js';
+export { WebhookInbox, type ReceiveWebhookInput, type ReplayWebhookInput, type WebhookDeliveryFilter, } from './webhook-inbox.js';
+export { PersistentReceiptLedger, type PersistentReceiptLedgerConfig, } from './persistent-ledger.js';
+export { PersistentWebhookInbox, type PersistentReceiveWebhookInput, type PersistentReplayWebhookInput, type PersistentWebhookInboxConfig, } from './persistent-webhook-inbox.js';
+export { InMemoryReceiptStore, createWatcherCursorKey, type ReceiptStore, type ReceiptStoreDeliveryFilter, type ReceiptStoreEventFilter, type ReceiptStoreInvoiceFilter, type WatcherCursor, type WatcherCursorKeyInput, } from './store.js';
+export { parseReceiptStoreValue, serializeReceiptStoreValue, } from './serialization.js';
+export { createWebhookRouteHandler, type WebhookRouteHandlerConfig, type WebhookRouteResult, } from './webhook-route.js';
+export type { PaymentInvoice, PaymentReceipt, ReceiptOnchainProof, CreateInvoiceInput, InvoiceStatus, MemoPaymentRequest, ObservedPayment, PaymentMatchResult, ReceiptStatus, StablecoinSymbol, WebhookDeliveryAttempt, WebhookDeliveryStatus, WebhookEvent, WebhookEventType, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/receipts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,mCAAmC,EACxC,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,GAClC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,6BAA6B,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/receipts/index.js

@@ -0,0 +1,15 @@
+export { STABLECOIN_DECIMALS, isAmountAtLeast, stablecoinUnitsToString, toStablecoinUnits, } from './amount.js';
+export { createInvoice, createInvoiceId, createPaymentUri, createReceipt, isInvoiceExpired, matchPaymentToInvoice, } from './invoice.js';
+export { ReceiptLedger } from './ledger.js';
+export { createInvoiceMemo, parseInvoiceMemo, createInvoiceMemoData, createInvoiceMemoId, } from './memo.js';
+export { ARC_MEMO_ABI, ERC20_TRANSFER_ABI, createMemoPaymentRequest, } from './memo-payment.js';
+export { ReceiptWatcher, } from './watcher.js';
+export { MemoPaymentProofError, findMemoPaymentProof, verifyMemoPaymentProof, } from './proof.js';
+export { createWebhookEvent, serializeWebhookPayload, signWebhookEvent, verifyWebhookSignature, } from './webhooks.js';
+export { WebhookInbox, } from './webhook-inbox.js';
+export { PersistentReceiptLedger, } from './persistent-ledger.js';
+export { PersistentWebhookInbox, } from './persistent-webhook-inbox.js';
+export { InMemoryReceiptStore, createWatcherCursorKey, } from './store.js';
+export { parseReceiptStoreValue, serializeReceiptStoreValue, } from './serialization.js';
+export { createWebhookRouteHandler, } from './webhook-route.js';
+//# sourceMappingURL=index.js.map

package/dist/receipts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/receipts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAEhB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,GAIf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GAUvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,GAIvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GAOvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,GAG1B,MAAM,oBAAoB,CAAC"}

package/dist/receipts/invoice.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Invoice and receipt creation helpers.
+ */
+import type { PaymentInvoice, PaymentReceipt, CreateInvoiceInput, ObservedPayment, PaymentMatchResult } from './types.js';
+export declare function createInvoice(input: CreateInvoiceInput): PaymentInvoice;
+export declare function createPaymentUri(params: {
+    payTo: `0x${string}`;
+    amount: string;
+    currency: string;
+    network: string;
+    memo: string;
+    scheme?: string;
+}): string;
+export declare function isInvoiceExpired(invoice: PaymentInvoice, now?: number): boolean;
+export declare function matchPaymentToInvoice(invoice: PaymentInvoice, payment: ObservedPayment, now?: number): PaymentMatchResult;
+export declare function createReceipt(invoice: PaymentInvoice, payment: ObservedPayment, createdAt?: number): PaymentReceipt;
+export declare function createInvoiceId(size?: number): string;
+//# sourceMappingURL=invoice.d.ts.map

package/dist/receipts/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../src/receipts/invoice.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CAkCvE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAUT;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,OAAO,CAEnF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,EACxB,GAAG,SAAa,GACf,kBAAkB,CAkCpB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,eAAe,EACxB,SAAS,SAAmC,GAC3C,cAAc,CA4BhB;AAED,wBAAgB,eAAe,CAAC,IAAI,SAAK,GAAG,MAAM,CAEjD"}

package/dist/receipts/invoice.js

@@ -0,0 +1,112 @@
+/**
+ * Invoice and receipt creation helpers.
+ */
+import { randomBytes } from 'node:crypto';
+import { DEFAULTS } from '../constants.js';
+import { isAmountAtLeast, toStablecoinUnits } from './amount.js';
+import { createInvoiceMemo, createInvoiceMemoData, createInvoiceMemoId } from './memo.js';
+const DEFAULT_PAYMENT_URI_SCHEME = 'arc';
+export function createInvoice(input) {
+    const id = input.id ?? createInvoiceId();
+    const currency = input.currency ?? 'USDC';
+    const network = input.network ?? DEFAULTS.network;
+    const createdAt = input.createdAt ?? Date.now();
+    const memo = createInvoiceMemo(id);
+    const memoId = createInvoiceMemoId(id);
+    const memoData = createInvoiceMemoData(memo);
+    const amountUnits = toStablecoinUnits(input.amount).toString();
+    return {
+        id,
+        status: 'open',
+        amount: input.amount,
+        amountUnits,
+        currency,
+        payTo: input.payTo,
+        network,
+        memo,
+        memoId,
+        memoData,
+        paymentUri: createPaymentUri({
+            payTo: input.payTo,
+            amount: input.amount,
+            currency,
+            network,
+            memo,
+        }),
+        createdAt,
+        expiresAt: input.expiresAt,
+        customerId: input.customerId,
+        description: input.description,
+        metadata: input.metadata,
+    };
+}
+export function createPaymentUri(params) {
+    const search = new URLSearchParams({
+        to: params.payTo,
+        amount: params.amount,
+        currency: params.currency,
+        network: params.network,
+        memo: params.memo,
+    });
+    return `${params.scheme ?? DEFAULT_PAYMENT_URI_SCHEME}://pay?${search.toString()}`;
+}
+export function isInvoiceExpired(invoice, now = Date.now()) {
+    return invoice.expiresAt !== undefined && now > invoice.expiresAt;
+}
+export function matchPaymentToInvoice(invoice, payment, now = Date.now()) {
+    if (isInvoiceExpired(invoice, now)) {
+        return { success: false, reason: 'invoice_expired' };
+    }
+    if (payment.to.toLowerCase() !== invoice.payTo.toLowerCase()) {
+        return { success: false, reason: 'wrong_recipient' };
+    }
+    if ((payment.currency ?? invoice.currency) !== invoice.currency) {
+        return { success: false, reason: 'wrong_currency' };
+    }
+    if ((payment.network ?? invoice.network) !== invoice.network) {
+        return { success: false, reason: 'wrong_network' };
+    }
+    if (payment.memo !== undefined && payment.memo !== invoice.memo) {
+        return { success: false, reason: 'wrong_memo' };
+    }
+    if (payment.memoId !== undefined
+        && invoice.memoId !== undefined
+        && payment.memoId.toLowerCase() !== invoice.memoId.toLowerCase()) {
+        return { success: false, reason: 'wrong_memo_id' };
+    }
+    if (!isAmountAtLeast(payment.amount, invoice.amount)) {
+        return { success: false, reason: 'insufficient_amount' };
+    }
+    return { success: true };
+}
+export function createReceipt(invoice, payment, createdAt = payment.observedAt ?? Date.now()) {
+    const match = matchPaymentToInvoice(invoice, payment, createdAt);
+    if (!match.success) {
+        throw new Error(`Payment does not match invoice: ${match.reason}`);
+    }
+    const amount = payment.amount;
+    return {
+        id: `rcpt_${createInvoiceId(12)}`,
+        invoiceId: invoice.id,
+        status: 'paid',
+        amount,
+        amountUnits: toStablecoinUnits(amount).toString(),
+        currency: payment.currency ?? invoice.currency,
+        network: payment.network ?? invoice.network,
+        payTo: invoice.payTo,
+        payer: payment.from,
+        memo: payment.memo ?? invoice.memo,
+        txHash: payment.txHash,
+        createdAt,
+        blockNumber: payment.blockNumber,
+        onchainProof: payment.onchainProof,
+        metadata: {
+            ...invoice.metadata,
+            ...payment.metadata,
+        },
+    };
+}
+export function createInvoiceId(size = 16) {
+    return randomBytes(size).toString('hex');
+}
+//# sourceMappingURL=invoice.js.map

package/dist/receipts/invoice.js.map

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

package/dist/receipts/ledger.d.ts

@@ -0,0 +1,30 @@
+/**
+ * In-memory invoice and receipt ledger.
+ */
+import type { PaymentInvoice, PaymentReceipt, CreateInvoiceInput, InvoiceStatus, ObservedPayment, WebhookEvent } from './types.js';
+export interface LedgerFilter {
+    status?: InvoiceStatus;
+    customerId?: string;
+}
+export declare class ReceiptLedger {
+    private readonly invoices;
+    private readonly receipts;
+    private readonly events;
+    createInvoice(input: CreateInvoiceInput): PaymentInvoice;
+    addInvoice(invoice: PaymentInvoice): void;
+    getInvoice(id: string): PaymentInvoice | undefined;
+    listInvoices(filter?: LedgerFilter): PaymentInvoice[];
+    recordPayment(invoiceId: string, payment: ObservedPayment): PaymentReceipt;
+    markExpired(invoiceId: string, now?: number): PaymentInvoice;
+    markRefunded(invoiceId: string, refund?: {
+        txHash?: `0x${string}`;
+        refundedAt?: number;
+    }): PaymentReceipt;
+    getReceipt(id: string): PaymentReceipt | undefined;
+    getReceiptByTxHash(txHash: `0x${string}`, invoiceId?: string): PaymentReceipt | undefined;
+    listReceipts(): PaymentReceipt[];
+    listWebhookEvents(): WebhookEvent[];
+    private requireInvoice;
+    private updateInvoice;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/dist/receipts/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/receipts/ledger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc;IAOxD,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAQzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,EAAE;IAcrD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc;IAmB1E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,cAAc;IAYhE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,cAAc;IAyB7G,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlD,kBAAkB,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAOzF,YAAY,IAAI,cAAc,EAAE;IAIhC,iBAAiB,IAAI,YAAY,EAAE;IAInC,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;CAMtB"}

package/dist/receipts/ledger.js

@@ -0,0 +1,109 @@
+/**
+ * In-memory invoice and receipt ledger.
+ */
+import { createInvoice, createReceipt, isInvoiceExpired } from './invoice.js';
+import { createWebhookEvent } from './webhooks.js';
+export class ReceiptLedger {
+    invoices = new Map();
+    receipts = new Map();
+    events = [];
+    createInvoice(input) {
+        const invoice = createInvoice(input);
+        this.addInvoice(invoice);
+        this.events.push(createWebhookEvent('invoice.created', { invoice }));
+        return invoice;
+    }
+    addInvoice(invoice) {
+        if (this.invoices.has(invoice.id)) {
+            throw new Error(`Invoice already exists: ${invoice.id}`);
+        }
+        this.invoices.set(invoice.id, invoice);
+    }
+    getInvoice(id) {
+        return this.invoices.get(id);
+    }
+    listInvoices(filter) {
+        return [...this.invoices.values()].filter((invoice) => {
+            if (filter?.status && invoice.status !== filter.status) {
+                return false;
+            }
+            if (filter?.customerId && invoice.customerId !== filter.customerId) {
+                return false;
+            }
+            return true;
+        });
+    }
+    recordPayment(invoiceId, payment) {
+        const existingReceipt = payment.txHash
+            ? this.getReceiptByTxHash(payment.txHash, invoiceId)
+            : undefined;
+        if (existingReceipt) {
+            return existingReceipt;
+        }
+        const invoice = this.requireInvoice(invoiceId);
+        const observedInvoice = this.updateInvoice(invoice.id, { status: 'observed' });
+        this.events.push(createWebhookEvent('invoice.observed', { invoice: observedInvoice, payment }));
+        const receipt = createReceipt(observedInvoice, payment);
+        this.receipts.set(receipt.id, receipt);
+        const paidInvoice = this.updateInvoice(invoice.id, { status: 'paid' });
+        this.events.push(createWebhookEvent('invoice.paid', { invoice: paidInvoice, receipt }));
+        return receipt;
+    }
+    markExpired(invoiceId, now = Date.now()) {
+        const invoice = this.requireInvoice(invoiceId);
+        if (!isInvoiceExpired(invoice, now)) {
+            throw new Error(`Invoice is not expired: ${invoiceId}`);
+        }
+        const expiredInvoice = this.updateInvoice(invoiceId, { status: 'expired' });
+        this.events.push(createWebhookEvent('invoice.expired', { invoice: expiredInvoice }));
+        return expiredInvoice;
+    }
+    markRefunded(invoiceId, refund = {}) {
+        const invoice = this.requireInvoice(invoiceId);
+        const receipt = [...this.receipts.values()].find((item) => item.invoiceId === invoiceId);
+        if (!receipt) {
+            throw new Error(`Cannot refund invoice without a paid receipt: ${invoiceId}`);
+        }
+        const refundedReceipt = {
+            ...receipt,
+            id: `rfnd_${receipt.id}`,
+            status: 'refunded',
+            txHash: refund.txHash ?? receipt.txHash,
+            createdAt: refund.refundedAt ?? Date.now(),
+        };
+        this.receipts.set(refundedReceipt.id, refundedReceipt);
+        const refundedInvoice = this.updateInvoice(invoice.id, { status: 'refunded' });
+        this.events.push(createWebhookEvent('invoice.refunded', {
+            invoice: refundedInvoice,
+            receipt: refundedReceipt,
+        }));
+        return refundedReceipt;
+    }
+    getReceipt(id) {
+        return this.receipts.get(id);
+    }
+    getReceiptByTxHash(txHash, invoiceId) {
+        return [...this.receipts.values()].find((receipt) => (receipt.txHash?.toLowerCase() === txHash.toLowerCase()
+            && (invoiceId === undefined || receipt.invoiceId === invoiceId)));
+    }
+    listReceipts() {
+        return [...this.receipts.values()];
+    }
+    listWebhookEvents() {
+        return [...this.events];
+    }
+    requireInvoice(id) {
+        const invoice = this.invoices.get(id);
+        if (!invoice) {
+            throw new Error(`Invoice not found: ${id}`);
+        }
+        return invoice;
+    }
+    updateInvoice(id, patch) {
+        const invoice = this.requireInvoice(id);
+        const next = { ...invoice, ...patch };
+        this.invoices.set(id, next);
+        return next;
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/receipts/ledger.js.map

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

package/dist/receipts/memo-payment.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Helpers for Arc Memo-wrapped USDC invoice payments.
+ */
+import type { PaymentInvoice, MemoPaymentRequest } from './types.js';
+export declare const ERC20_TRANSFER_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}];
+export declare const ARC_MEMO_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "memo";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "target";
+        readonly type: "address";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }, {
+        readonly name: "memoId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "memoData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "BeforeMemo";
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly name: "memoIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Memo";
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "target";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "callDataHash";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "memoId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "memo";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }, {
+        readonly name: "memoIndex";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}];
+export interface MemoPaymentRequestOptions {
+    usdcAddress?: `0x${string}`;
+    memoContract?: `0x${string}`;
+}
+export declare function createMemoPaymentRequest(invoice: PaymentInvoice, options?: MemoPaymentRequestOptions): MemoPaymentRequest;
+//# sourceMappingURL=memo-payment.d.ts.map

package/dist/receipts/memo-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo-payment.d.ts","sourceRoot":"","sources":["../../src/receipts/memo-payment.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBP,CAAC;AAEzB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCD,CAAC;AAEzB,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA8BpB"}