@resvary/sdk 0.5.0-alpha.1

package/dist/receipts/memo-payment.js

@@ -0,0 +1,91 @@
+/**
+ * Helpers for Arc Memo-wrapped USDC invoice payments.
+ */
+import { encodeFunctionData, keccak256, } from 'viem';
+import { ARC_TESTNET_CONTRACTS } from '../constants.js';
+import { createInvoiceMemoData, createInvoiceMemoId } from './memo.js';
+export const ERC20_TRANSFER_ABI = [
+    {
+        type: 'function',
+        name: 'transfer',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        type: 'event',
+        name: 'Transfer',
+        anonymous: false,
+        inputs: [
+            { name: 'from', type: 'address', indexed: true },
+            { name: 'to', type: 'address', indexed: true },
+            { name: 'value', type: 'uint256', indexed: false },
+        ],
+    },
+];
+export const ARC_MEMO_ABI = [
+    {
+        type: 'function',
+        name: 'memo',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'target', type: 'address' },
+            { name: 'data', type: 'bytes' },
+            { name: 'memoId', type: 'bytes32' },
+            { name: 'memoData', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'event',
+        name: 'BeforeMemo',
+        anonymous: false,
+        inputs: [{ name: 'memoIndex', type: 'uint256', indexed: true }],
+    },
+    {
+        type: 'event',
+        name: 'Memo',
+        anonymous: false,
+        inputs: [
+            { name: 'sender', type: 'address', indexed: true },
+            { name: 'target', type: 'address', indexed: true },
+            { name: 'callDataHash', type: 'bytes32', indexed: false },
+            { name: 'memoId', type: 'bytes32', indexed: true },
+            { name: 'memo', type: 'bytes', indexed: false },
+            { name: 'memoIndex', type: 'uint256', indexed: false },
+        ],
+    },
+];
+export function createMemoPaymentRequest(invoice, options = {}) {
+    const target = options.usdcAddress ?? ARC_TESTNET_CONTRACTS.usdc;
+    const memoContract = options.memoContract ?? ARC_TESTNET_CONTRACTS.memo;
+    const memoId = invoice.memoId ?? createInvoiceMemoId(invoice.id);
+    const memoData = invoice.memoData ?? createInvoiceMemoData(invoice.memo);
+    const data = encodeFunctionData({
+        abi: ERC20_TRANSFER_ABI,
+        functionName: 'transfer',
+        args: [invoice.payTo, BigInt(invoice.amountUnits)],
+    });
+    const callDataHash = keccak256(data);
+    const txData = encodeFunctionData({
+        abi: ARC_MEMO_ABI,
+        functionName: 'memo',
+        args: [target, data, memoId, memoData],
+    });
+    return {
+        invoiceId: invoice.id,
+        memoContract,
+        target,
+        data,
+        txData,
+        memoId,
+        memoData,
+        callDataHash,
+        amountUnits: invoice.amountUnits,
+        payTo: invoice.payTo,
+    };
+}
+//# sourceMappingURL=memo-payment.js.map

package/dist/receipts/memo-payment.js.map

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

package/dist/receipts/memo.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Arc transaction memo helpers for invoice correlation.
+ */
+export interface ParsedInvoiceMemo {
+    namespace: string;
+    version: 'v1';
+    kind: 'invoice';
+    invoiceId: string;
+}
+export declare function createInvoiceMemo(invoiceId: string, namespace?: string): string;
+export declare function createInvoiceMemoId(invoiceId: string): `0x${string}`;
+export declare function createInvoiceMemoData(memo: string): `0x${string}`;
+export declare function parseInvoiceMemo(memo: string): ParsedInvoiceMemo | null;
+//# sourceMappingURL=memo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../src/receipts/memo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAY,GAAG,MAAM,CAalF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAmBvE"}

package/dist/receipts/memo.js

@@ -0,0 +1,39 @@
+/**
+ * Arc transaction memo helpers for invoice correlation.
+ */
+import { keccak256, stringToHex } from 'viem';
+const SAFE_ID = /^[a-zA-Z0-9_-]+$/;
+export function createInvoiceMemo(invoiceId, namespace = 'resvary') {
+    const cleanInvoiceId = invoiceId.trim();
+    const cleanNamespace = namespace.trim();
+    if (!SAFE_ID.test(cleanInvoiceId)) {
+        throw new Error('Invoice id can only contain letters, numbers, underscores, and dashes');
+    }
+    if (!SAFE_ID.test(cleanNamespace)) {
+        throw new Error('Memo namespace can only contain letters, numbers, underscores, and dashes');
+    }
+    return `${cleanNamespace}:invoice:v1:${cleanInvoiceId}`;
+}
+export function createInvoiceMemoId(invoiceId) {
+    return keccak256(stringToHex(invoiceId));
+}
+export function createInvoiceMemoData(memo) {
+    return stringToHex(memo);
+}
+export function parseInvoiceMemo(memo) {
+    const [namespace, kind, version, invoiceId, ...extra] = memo.split(':');
+    if (!namespace
+        || kind !== 'invoice'
+        || version !== 'v1'
+        || !invoiceId
+        || extra.length > 0) {
+        return null;
+    }
+    return {
+        namespace,
+        kind,
+        version,
+        invoiceId,
+    };
+}
+//# sourceMappingURL=memo.js.map

package/dist/receipts/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../src/receipts/memo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAS9C,MAAM,OAAO,GAAG,kBAAkB,CAAC;AAEnC,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,SAAS,GAAG,SAAS;IACxE,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAExC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,GAAG,cAAc,eAAe,cAAc,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAExE,IACE,CAAC,SAAS;WACP,IAAI,KAAK,SAAS;WAClB,OAAO,KAAK,IAAI;WAChB,CAAC,SAAS;WACV,KAAK,CAAC,MAAM,GAAG,CAAC,EACnB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,SAAS;QACT,IAAI;QACJ,OAAO;QACP,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/receipts/persistent-ledger.d.ts

@@ -0,0 +1,27 @@
+import type { PaymentInvoice, PaymentReceipt, CreateInvoiceInput, ObservedPayment, WebhookEvent } from './types.js';
+import type { ReceiptStore, ReceiptStoreInvoiceFilter } from './store.js';
+export interface PersistentReceiptLedgerConfig {
+    store: ReceiptStore;
+}
+export declare class PersistentReceiptLedger {
+    private readonly store;
+    constructor(config: PersistentReceiptLedgerConfig);
+    createInvoice(input: CreateInvoiceInput): Promise<PaymentInvoice>;
+    addInvoice(invoice: PaymentInvoice): Promise<void>;
+    getInvoice(id: string): Promise<PaymentInvoice | undefined>;
+    listInvoices(filter?: ReceiptStoreInvoiceFilter): Promise<PaymentInvoice[]>;
+    recordPayment(invoiceId: string, payment: ObservedPayment): Promise<PaymentReceipt>;
+    markExpired(invoiceId: string, now?: number): Promise<PaymentInvoice>;
+    markRefunded(invoiceId: string, refund?: {
+        txHash?: `0x${string}`;
+        refundedAt?: number;
+    }): Promise<PaymentReceipt>;
+    getReceipt(id: string): Promise<PaymentReceipt | undefined>;
+    getReceiptByTxHash(txHash: `0x${string}`, invoiceId?: string): Promise<PaymentReceipt | undefined>;
+    listReceipts(): Promise<PaymentReceipt[]>;
+    listWebhookEvents(): Promise<WebhookEvent[]>;
+    private saveWebhookEvent;
+    private requireInvoice;
+    private updateInvoice;
+}
+//# sourceMappingURL=persistent-ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-ledger.d.ts","sourceRoot":"","sources":["../../src/receipts/persistent-ledger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAG1E,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,MAAM,EAAE,6BAA6B;IAI3C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAOjE,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI3D,YAAY,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAgCnF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYzE,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3D,OAAO,CAAC,cAAc,CAAC;IA2BpB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI3D,kBAAkB,CACtB,MAAM,EAAE,KAAK,MAAM,EAAE,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAIhC,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzC,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAIpC,gBAAgB;YAIhB,cAAc;YASd,aAAa;CAM5B"}

package/dist/receipts/persistent-ledger.js

@@ -0,0 +1,111 @@
+import { createInvoice, createReceipt, isInvoiceExpired } from './invoice.js';
+import { createWebhookEvent } from './webhooks.js';
+export class PersistentReceiptLedger {
+    store;
+    constructor(config) {
+        this.store = config.store;
+    }
+    async createInvoice(input) {
+        const invoice = createInvoice(input);
+        await this.addInvoice(invoice);
+        await this.saveWebhookEvent(createWebhookEvent('invoice.created', { invoice }));
+        return invoice;
+    }
+    async addInvoice(invoice) {
+        const existing = await this.store.getInvoice(invoice.id);
+        if (existing) {
+            throw new Error(`Invoice already exists: ${invoice.id}`);
+        }
+        await this.store.saveInvoice(invoice);
+    }
+    async getInvoice(id) {
+        return this.store.getInvoice(id);
+    }
+    async listInvoices(filter) {
+        return this.store.listInvoices(filter);
+    }
+    async recordPayment(invoiceId, payment) {
+        const existingReceipt = payment.txHash
+            ? await this.getReceiptByTxHash(payment.txHash, invoiceId)
+            : undefined;
+        if (existingReceipt) {
+            return existingReceipt;
+        }
+        const invoice = await this.requireInvoice(invoiceId);
+        const observedInvoice = await this.updateInvoice(invoice.id, { status: 'observed' });
+        await this.saveWebhookEvent(createWebhookEvent('invoice.observed', {
+            invoice: observedInvoice,
+            payment,
+        }));
+        const receipt = createReceipt(observedInvoice, payment);
+        await this.store.saveReceipt(receipt);
+        const persistedReceipt = payment.txHash
+            ? ((await this.store.getReceiptByTxHash(payment.txHash, invoice.id)) ?? receipt)
+            : receipt;
+        const paidInvoice = await this.updateInvoice(invoice.id, { status: 'paid' });
+        await this.saveWebhookEvent(createWebhookEvent('invoice.paid', {
+            invoice: paidInvoice,
+            receipt: persistedReceipt,
+        }));
+        return persistedReceipt;
+    }
+    async markExpired(invoiceId, now = Date.now()) {
+        const invoice = await this.requireInvoice(invoiceId);
+        if (!isInvoiceExpired(invoice, now)) {
+            throw new Error(`Invoice is not expired: ${invoiceId}`);
+        }
+        const expiredInvoice = await this.updateInvoice(invoiceId, { status: 'expired' });
+        await this.saveWebhookEvent(createWebhookEvent('invoice.expired', { invoice: expiredInvoice }));
+        return expiredInvoice;
+    }
+    async markRefunded(invoiceId, refund = {}) {
+        const invoice = await this.requireInvoice(invoiceId);
+        const receipt = (await this.store.listReceipts()).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(),
+        };
+        await this.store.saveReceipt(refundedReceipt);
+        const refundedInvoice = await this.updateInvoice(invoice.id, { status: 'refunded' });
+        await this.saveWebhookEvent(createWebhookEvent('invoice.refunded', {
+            invoice: refundedInvoice,
+            receipt: refundedReceipt,
+        }));
+        return refundedReceipt;
+    }
+    async getReceipt(id) {
+        return this.store.getReceipt(id);
+    }
+    async getReceiptByTxHash(txHash, invoiceId) {
+        return this.store.getReceiptByTxHash(txHash, invoiceId);
+    }
+    async listReceipts() {
+        return this.store.listReceipts();
+    }
+    async listWebhookEvents() {
+        return this.store.listWebhookEvents();
+    }
+    async saveWebhookEvent(event) {
+        await this.store.saveWebhookEvent(event);
+    }
+    async requireInvoice(id) {
+        const invoice = await this.store.getInvoice(id);
+        if (!invoice) {
+            throw new Error(`Invoice not found: ${id}`);
+        }
+        return invoice;
+    }
+    async updateInvoice(id, patch) {
+        const invoice = await this.requireInvoice(id);
+        const next = { ...invoice, ...patch };
+        await this.store.saveInvoice(next);
+        return next;
+    }
+}
+//# sourceMappingURL=persistent-ledger.js.map

package/dist/receipts/persistent-ledger.js.map

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

package/dist/receipts/persistent-webhook-inbox.d.ts

@@ -0,0 +1,32 @@
+import type { WebhookDeliveryAttempt, WebhookEvent } from './types.js';
+import type { ReceiptStore, ReceiptStoreDeliveryFilter } from './store.js';
+export interface PersistentWebhookInboxConfig {
+    store: ReceiptStore;
+}
+export interface PersistentReceiveWebhookInput {
+    payload: WebhookEvent | string;
+    header: string;
+    secret: string;
+    target?: string;
+    now?: number;
+    receivedAt?: number;
+    toleranceSeconds?: number;
+}
+export interface PersistentReplayWebhookInput {
+    event: WebhookEvent;
+    secret: string;
+    target?: string;
+    replayOf?: string;
+    timestamp?: number;
+    receivedAt?: number;
+}
+export declare class PersistentWebhookInbox {
+    private readonly store;
+    constructor(config: PersistentWebhookInboxConfig);
+    receive(input: PersistentReceiveWebhookInput): Promise<WebhookDeliveryAttempt>;
+    replay(input: PersistentReplayWebhookInput): Promise<WebhookDeliveryAttempt>;
+    listDeliveries(filter?: ReceiptStoreDeliveryFilter): Promise<WebhookDeliveryAttempt[]>;
+    getDelivery(id: string): Promise<WebhookDeliveryAttempt | undefined>;
+    private createDelivery;
+}
+//# sourceMappingURL=persistent-webhook-inbox.d.ts.map

package/dist/receipts/persistent-webhook-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-webhook-inbox.d.ts","sourceRoot":"","sources":["../../src/receipts/persistent-webhook-inbox.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAG3E,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,MAAM,EAAE,4BAA4B;IAI1C,OAAO,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAyB9E,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAkB5E,cAAc,CAAC,MAAM,GAAE,0BAA+B,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAI1F,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;YAI5D,cAAc;CAW7B"}

package/dist/receipts/persistent-webhook-inbox.js

@@ -0,0 +1,93 @@
+import { randomBytes } from 'node:crypto';
+import { signWebhookEvent, verifyWebhookSignature } from './webhooks.js';
+export class PersistentWebhookInbox {
+    store;
+    constructor(config) {
+        this.store = config.store;
+    }
+    async receive(input) {
+        const event = parseWebhookPayload(input.payload);
+        const verified = verifyWebhookSignature({
+            payload: input.payload,
+            header: input.header,
+            secret: input.secret,
+            now: input.now,
+            toleranceSeconds: input.toleranceSeconds,
+        });
+        const delivery = await this.createDelivery({
+            eventId: event.eventId,
+            eventType: event.eventType,
+            status: verified ? 'verified' : 'failed',
+            verified,
+            signatureHeader: input.header,
+            receivedAt: input.receivedAt ?? Date.now(),
+            target: input.target,
+            error: verified ? undefined : 'Webhook signature verification failed',
+        });
+        await this.store.saveWebhookDelivery(delivery);
+        return delivery;
+    }
+    async replay(input) {
+        const signature = signWebhookEvent(input.event, input.secret, input.timestamp);
+        const delivery = await this.createDelivery({
+            eventId: input.event.id,
+            eventType: input.event.type,
+            status: 'verified',
+            verified: true,
+            signatureHeader: signature.header,
+            receivedAt: input.receivedAt ?? Date.now(),
+            target: input.target,
+            replayOf: input.replayOf,
+        });
+        await this.store.saveWebhookDelivery(delivery);
+        return delivery;
+    }
+    async listDeliveries(filter = {}) {
+        return this.store.listWebhookDeliveries(filter);
+    }
+    async getDelivery(id) {
+        return this.store.getWebhookDelivery(id);
+    }
+    async createDelivery(input) {
+        const attempts = await this.store.listWebhookDeliveries({ eventId: input.eventId });
+        return {
+            id: `dlv_${randomBytes(12).toString('hex')}`,
+            attempt: attempts.length + 1,
+            ...input,
+        };
+    }
+}
+function parseWebhookPayload(payload) {
+    const event = typeof payload === 'string'
+        ? parseJson(payload)
+        : payload;
+    if (!isWebhookEventLike(event)) {
+        return {
+            eventId: 'unknown',
+            eventType: 'unknown',
+        };
+    }
+    return {
+        eventId: event.id,
+        eventType: event.type,
+    };
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function isWebhookEventLike(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const event = value;
+    return typeof event.id === 'string'
+        && typeof event.type === 'string'
+        && typeof event.createdAt === 'number'
+        && 'data' in event;
+}
+//# sourceMappingURL=persistent-webhook-inbox.js.map

package/dist/receipts/persistent-webhook-inbox.js.map

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

package/dist/receipts/proof.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Read-only Arc Testnet proof verification for Memo-wrapped receipt payments.
+ */
+import { type Log } from 'viem';
+import type { ReceiptOnchainProof, MemoPaymentRequest } from './types.js';
+export type ProofTransactionReceipt = {
+    status: string;
+    blockNumber: bigint;
+    transactionIndex?: number;
+    logs: readonly Log[];
+};
+export type ProofMemoLog = {
+    transactionHash?: `0x${string}` | null;
+};
+export type ProofClient = {
+    getTransactionReceipt: (params: {
+        hash: `0x${string}`;
+    }) => Promise<ProofTransactionReceipt | null>;
+};
+export type ProofPollingClient = ProofClient & {
+    getBlockNumber: () => Promise<bigint>;
+    getLogs: (params: {
+        address: `0x${string}`;
+        event: unknown;
+        args: {
+            memoId: `0x${string}`;
+        };
+        fromBlock: bigint;
+        toBlock: bigint;
+    }) => Promise<readonly ProofMemoLog[]>;
+};
+export type VerifyMemoPaymentProofFailureReason = 'tx_not_found' | 'tx_reverted' | 'wrong_memo_contract' | 'missing_memo_event' | 'memo_id_mismatch' | 'target_mismatch' | 'call_data_hash_mismatch' | 'missing_transfer' | 'recipient_mismatch' | 'amount_mismatch';
+export declare class MemoPaymentProofError extends Error {
+    readonly reason: VerifyMemoPaymentProofFailureReason;
+    constructor(reason: VerifyMemoPaymentProofFailureReason, message: string);
+}
+export interface VerifyMemoPaymentProofInput {
+    txHash: `0x${string}`;
+    paymentRequest: MemoPaymentRequest;
+    rpcUrl?: string;
+    publicClient?: ProofClient;
+    verifiedAt?: number;
+}
+export interface VerifyMemoPaymentProofResult {
+    proof: ReceiptOnchainProof;
+}
+export interface FindMemoPaymentProofInput {
+    paymentRequest: MemoPaymentRequest;
+    rpcUrl?: string;
+    publicClient?: ProofPollingClient;
+    fromBlock?: bigint;
+    toBlock?: bigint;
+    confirmations?: number;
+    lookbackBlocks?: bigint | number;
+    verifiedAt?: number;
+}
+export type FindMemoPaymentProofResult = {
+    status: 'found';
+    proof: ReceiptOnchainProof;
+    txHash: `0x${string}`;
+    fromBlock: bigint;
+    toBlock: bigint;
+    nextFromBlock: bigint;
+    scannedLogCount: number;
+} | {
+    status: 'pending';
+    fromBlock: bigint;
+    toBlock: bigint;
+    nextFromBlock: bigint;
+    scannedLogCount: number;
+};
+export declare function verifyMemoPaymentProof(input: VerifyMemoPaymentProofInput): Promise<ReceiptOnchainProof>;
+export declare function findMemoPaymentProof(input: FindMemoPaymentProofInput): Promise<FindMemoPaymentProofResult>;
+export declare function createMemoPaymentProofFromReceipt(params: {
+    txHash: `0x${string}`;
+    paymentRequest: MemoPaymentRequest;
+    txReceipt: ProofTransactionReceipt;
+    verifiedAt?: number;
+}): ReceiptOnchainProof;
+//# sourceMappingURL=proof.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proof.d.ts","sourceRoot":"","sources":["../../src/receipts/proof.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAML,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,qBAAqB,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CACrG,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC7C,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE;YAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;SAAE,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;CACxC,CAAC;AAQF,MAAM,MAAM,mCAAmC,GAC3C,cAAc,GACd,aAAa,GACb,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,yBAAyB,GACzB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;gBAEzC,MAAM,EAAE,mCAAmC,EAAE,OAAO,EAAE,MAAM;CAKzE;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,kBAAkB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,kBAAkB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAkBN,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CA0CrC;AAoFD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,kBAAkB,CAAC;IACnC,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,mBAAmB,CAsJtB"}