@resvary/sdk 0.5.0-alpha.1

package/dist/receipts/proof.js

@@ -0,0 +1,223 @@
+/**
+ * Read-only Arc Testnet proof verification for Memo-wrapped receipt payments.
+ */
+import { createPublicClient, getAddress, http, parseAbiItem, parseEventLogs, } from 'viem';
+import { ARC_TESTNET } from '../constants.js';
+import { ARC_MEMO_ABI, ERC20_TRANSFER_ABI } from './memo-payment.js';
+const MEMO_EVENT = parseAbiItem('event Memo(address indexed sender,address indexed target,bytes32 callDataHash,bytes32 indexed memoId,bytes memo,uint256 memoIndex)');
+const DEFAULT_PROOF_LOOKBACK_BLOCKS = 5000n;
+export class MemoPaymentProofError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.name = 'MemoPaymentProofError';
+        this.reason = reason;
+    }
+}
+export async function verifyMemoPaymentProof(input) {
+    const client = input.publicClient ?? createPublicClient({
+        transport: http(input.rpcUrl ?? ARC_TESTNET.rpcUrl),
+    });
+    let txReceipt;
+    try {
+        txReceipt = await client.getTransactionReceipt({ hash: input.txHash });
+    }
+    catch {
+        throw new MemoPaymentProofError('tx_not_found', `Transaction ${input.txHash} was not found on Arc Testnet`);
+    }
+    if (!txReceipt) {
+        throw new MemoPaymentProofError('tx_not_found', `Transaction ${input.txHash} was not found on Arc Testnet`);
+    }
+    return createMemoPaymentProofFromReceipt({
+        txHash: input.txHash,
+        paymentRequest: input.paymentRequest,
+        txReceipt,
+        verifiedAt: input.verifiedAt,
+    });
+}
+export async function findMemoPaymentProof(input) {
+    const client = (input.publicClient ?? createPublicClient({
+        transport: http(input.rpcUrl ?? ARC_TESTNET.rpcUrl),
+    }));
+    const { fromBlock, toBlock } = await resolveProofSearchRange(input, client);
+    if (fromBlock > toBlock) {
+        return {
+            status: 'pending',
+            fromBlock,
+            toBlock,
+            nextFromBlock: fromBlock,
+            scannedLogCount: 0,
+        };
+    }
+    const memoLogs = await getMemoProofLogs(input.paymentRequest, client, { fromBlock, toBlock });
+    const candidate = await verifyMemoProofCandidates(input, client, memoLogs);
+    if (candidate.status === 'found') {
+        return {
+            status: 'found',
+            proof: candidate.proof,
+            txHash: candidate.txHash,
+            fromBlock,
+            toBlock,
+            nextFromBlock: toBlock + 1n,
+            scannedLogCount: memoLogs.length,
+        };
+    }
+    if (candidate.lastError) {
+        throw candidate.lastError;
+    }
+    return {
+        status: 'pending',
+        fromBlock,
+        toBlock,
+        nextFromBlock: toBlock + 1n,
+        scannedLogCount: memoLogs.length,
+    };
+}
+async function resolveProofSearchRange(input, client) {
+    const confirmations = BigInt(input.confirmations ?? 1);
+    const latestBlock = input.toBlock ?? await client.getBlockNumber();
+    const toBlock = latestBlock > confirmations ? latestBlock - confirmations : 0n;
+    const lookbackBlocks = input.lookbackBlocks === undefined
+        ? DEFAULT_PROOF_LOOKBACK_BLOCKS
+        : BigInt(input.lookbackBlocks);
+    return {
+        fromBlock: input.fromBlock ?? defaultProofFromBlock(toBlock, lookbackBlocks),
+        toBlock,
+    };
+}
+function defaultProofFromBlock(toBlock, lookbackBlocks) {
+    return toBlock > lookbackBlocks ? toBlock - lookbackBlocks : 0n;
+}
+async function getMemoProofLogs(paymentRequest, client, range) {
+    return client.getLogs({
+        address: paymentRequest.memoContract,
+        event: MEMO_EVENT,
+        args: { memoId: paymentRequest.memoId },
+        fromBlock: range.fromBlock,
+        toBlock: range.toBlock,
+    });
+}
+async function verifyMemoProofCandidates(input, client, memoLogs) {
+    let lastError;
+    for (const memoLog of memoLogs) {
+        const result = await verifyMemoProofCandidate(input, client, memoLog);
+        if (result.status === 'found') {
+            return result;
+        }
+        lastError = result.lastError ?? lastError;
+    }
+    return { status: 'pending', lastError };
+}
+async function verifyMemoProofCandidate(input, client, memoLog) {
+    const txHash = memoLog.transactionHash;
+    if (!txHash) {
+        return { status: 'pending' };
+    }
+    try {
+        const proof = await verifyMemoPaymentProof({
+            txHash,
+            paymentRequest: input.paymentRequest,
+            publicClient: client,
+            verifiedAt: input.verifiedAt,
+        });
+        return { status: 'found', proof, txHash };
+    }
+    catch (error) {
+        if (error instanceof MemoPaymentProofError) {
+            return { status: 'pending', lastError: error };
+        }
+        throw error;
+    }
+}
+export function createMemoPaymentProofFromReceipt(params) {
+    const { paymentRequest, txHash, txReceipt } = params;
+    if (txReceipt.status !== 'success') {
+        throw new MemoPaymentProofError('tx_reverted', `Transaction ${txHash} did not succeed`);
+    }
+    const memoLogs = txReceipt.logs.filter((log) => sameAddress(log.address, paymentRequest.memoContract));
+    if (memoLogs.length === 0) {
+        throw new MemoPaymentProofError('wrong_memo_contract', `Transaction ${txHash} has no logs from Memo contract ${paymentRequest.memoContract}`);
+    }
+    const parsedMemoLogs = parseEventLogs({
+        abi: ARC_MEMO_ABI,
+        eventName: 'Memo',
+        logs: memoLogs,
+        strict: false,
+    });
+    if (parsedMemoLogs.length === 0) {
+        throw new MemoPaymentProofError('missing_memo_event', `Transaction ${txHash} has no Memo event`);
+    }
+    const memoById = parsedMemoLogs.find((log) => {
+        const args = log.args;
+        return args.memoId?.toLowerCase() === paymentRequest.memoId.toLowerCase();
+    });
+    if (!memoById) {
+        throw new MemoPaymentProofError('memo_id_mismatch', `Transaction ${txHash} does not contain memoId ${paymentRequest.memoId}`);
+    }
+    const memoArgs = memoById.args;
+    if (!memoArgs.sender || !memoArgs.target || !memoArgs.callDataHash || !memoArgs.memoId) {
+        throw new MemoPaymentProofError('missing_memo_event', `Transaction ${txHash} has an incomplete Memo event`);
+    }
+    if (!sameAddress(memoArgs.target, paymentRequest.target)) {
+        throw new MemoPaymentProofError('target_mismatch', `Memo target ${memoArgs.target} does not match ${paymentRequest.target}`);
+    }
+    if (memoArgs.callDataHash.toLowerCase() !== paymentRequest.callDataHash.toLowerCase()) {
+        throw new MemoPaymentProofError('call_data_hash_mismatch', `Memo callDataHash ${memoArgs.callDataHash} does not match ${paymentRequest.callDataHash}`);
+    }
+    const transferLogs = txReceipt.logs.filter((log) => sameAddress(log.address, paymentRequest.target));
+    const parsedTransferLogs = parseEventLogs({
+        abi: ERC20_TRANSFER_ABI,
+        eventName: 'Transfer',
+        logs: transferLogs,
+        strict: false,
+    });
+    if (parsedTransferLogs.length === 0) {
+        throw new MemoPaymentProofError('missing_transfer', `Transaction ${txHash} has no USDC Transfer event`);
+    }
+    const payerTransfers = parsedTransferLogs.filter((log) => {
+        const args = log.args;
+        return args.from !== undefined && sameAddress(args.from, memoArgs.sender);
+    });
+    if (payerTransfers.length === 0) {
+        throw new MemoPaymentProofError('missing_transfer', `Transaction ${txHash} has no USDC Transfer from memo sender ${memoArgs.sender}`);
+    }
+    const recipientTransfers = payerTransfers.filter((log) => {
+        const args = log.args;
+        return args.to !== undefined && sameAddress(args.to, paymentRequest.payTo);
+    });
+    if (recipientTransfers.length === 0) {
+        throw new MemoPaymentProofError('recipient_mismatch', `Transaction ${txHash} has no USDC Transfer to ${paymentRequest.payTo}`);
+    }
+    const amountTransfer = recipientTransfers.find((log) => {
+        const args = log.args;
+        return args.value?.toString() === paymentRequest.amountUnits;
+    });
+    if (!amountTransfer) {
+        throw new MemoPaymentProofError('amount_mismatch', `Transaction ${txHash} has no USDC Transfer for ${paymentRequest.amountUnits} units`);
+    }
+    return {
+        chainId: ARC_TESTNET.chainId,
+        network: 'arc-testnet',
+        txHash,
+        blockNumber: txReceipt.blockNumber,
+        transactionIndex: txReceipt.transactionIndex ?? numberOrUndefined(memoById.transactionIndex),
+        logIndex: numberOrUndefined(memoById.logIndex),
+        memoContract: paymentRequest.memoContract,
+        memoIndex: memoArgs.memoIndex?.toString(),
+        memoId: paymentRequest.memoId,
+        callDataHash: paymentRequest.callDataHash,
+        payer: getAddress(memoArgs.sender),
+        payTo: getAddress(paymentRequest.payTo),
+        target: getAddress(paymentRequest.target),
+        amountUnits: paymentRequest.amountUnits,
+        explorerUrl: `${ARC_TESTNET.explorerUrl}/tx/${txHash}`,
+        verifiedAt: params.verifiedAt ?? Date.now(),
+    };
+}
+function sameAddress(left, right) {
+    return getAddress(left) === getAddress(right);
+}
+function numberOrUndefined(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+//# sourceMappingURL=proof.js.map

package/dist/receipts/proof.js.map

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

package/dist/receipts/serialization.d.ts

@@ -0,0 +1,3 @@
+export declare function serializeReceiptStoreValue(value: unknown): string;
+export declare function parseReceiptStoreValue<T>(value: string): T;
+//# sourceMappingURL=serialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/receipts/serialization.ts"],"names":[],"mappings":"AAMA,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAQ1D"}

package/dist/receipts/serialization.js

@@ -0,0 +1,24 @@
+const BIGINT_MARKER = '__resvaryBigInt';
+export function serializeReceiptStoreValue(value) {
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === 'bigint') {
+            return { [BIGINT_MARKER]: item.toString() };
+        }
+        return item;
+    });
+}
+export function parseReceiptStoreValue(value) {
+    return JSON.parse(value, (_key, item) => {
+        if (isSerializedBigInt(item)) {
+            return BigInt(item[BIGINT_MARKER]);
+        }
+        return item;
+    });
+}
+function isSerializedBigInt(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && BIGINT_MARKER in value
+        && typeof value[BIGINT_MARKER] === 'string');
+}
+//# sourceMappingURL=serialization.js.map

package/dist/receipts/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/receipts/serialization.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAMxC,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,EAA6B,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAI,KAAa;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE;QAC/C,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAM,CAAC;AACV,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,CACZ,KAAK;WACA,OAAO,KAAK,KAAK,QAAQ;WACzB,aAAa,IAAI,KAAK;WACtB,OAAQ,KAA0B,CAAC,aAAa,CAAC,KAAK,QAAQ,CACpE,CAAC;AACJ,CAAC"}

package/dist/receipts/store.d.ts

@@ -0,0 +1,69 @@
+import type { PaymentInvoice, PaymentReceipt, InvoiceStatus, WebhookDeliveryAttempt, WebhookDeliveryStatus, WebhookEvent } from './types.js';
+export interface ReceiptStoreInvoiceFilter {
+    status?: InvoiceStatus;
+    customerId?: string;
+}
+export interface ReceiptStoreDeliveryFilter {
+    eventId?: string;
+    status?: WebhookDeliveryStatus;
+}
+export interface ReceiptStoreEventFilter {
+    type?: WebhookEvent['type'];
+}
+export interface WatcherCursor {
+    key: string;
+    network: string;
+    nextFromBlock: bigint;
+    updatedAt: number;
+    invoiceId?: string;
+    memoId?: `0x${string}`;
+    metadata?: Record<string, unknown>;
+}
+export interface WatcherCursorKeyInput {
+    network: string;
+    invoiceId: string;
+    memoId?: `0x${string}`;
+}
+export interface ReceiptStore {
+    saveInvoice(invoice: PaymentInvoice): Promise<void>;
+    getInvoice(id: string): Promise<PaymentInvoice | undefined>;
+    listInvoices(filter?: ReceiptStoreInvoiceFilter): Promise<PaymentInvoice[]>;
+    saveReceipt(receipt: PaymentReceipt): Promise<void>;
+    getReceipt(id: string): Promise<PaymentReceipt | undefined>;
+    getReceiptByTxHash(txHash: `0x${string}`, invoiceId?: string): Promise<PaymentReceipt | undefined>;
+    listReceipts(): Promise<PaymentReceipt[]>;
+    saveWebhookEvent(event: WebhookEvent): Promise<void>;
+    listWebhookEvents(filter?: ReceiptStoreEventFilter): Promise<WebhookEvent[]>;
+    saveWebhookDelivery(delivery: WebhookDeliveryAttempt): Promise<void>;
+    getWebhookDelivery(id: string): Promise<WebhookDeliveryAttempt | undefined>;
+    listWebhookDeliveries(filter?: ReceiptStoreDeliveryFilter): Promise<WebhookDeliveryAttempt[]>;
+    getWatcherCursor(key: string): Promise<WatcherCursor | undefined>;
+    listWatcherCursors(): Promise<WatcherCursor[]>;
+    saveWatcherCursor(cursor: WatcherCursor): Promise<void>;
+    deleteWatcherCursor(key: string): Promise<void>;
+}
+export declare class InMemoryReceiptStore implements ReceiptStore {
+    private readonly invoices;
+    private readonly receipts;
+    private readonly events;
+    private readonly deliveries;
+    private readonly cursors;
+    saveInvoice(invoice: PaymentInvoice): Promise<void>;
+    getInvoice(id: string): Promise<PaymentInvoice | undefined>;
+    listInvoices(filter?: ReceiptStoreInvoiceFilter): Promise<PaymentInvoice[]>;
+    saveReceipt(receipt: PaymentReceipt): Promise<void>;
+    getReceipt(id: string): Promise<PaymentReceipt | undefined>;
+    getReceiptByTxHash(txHash: `0x${string}`, invoiceId?: string): Promise<PaymentReceipt | undefined>;
+    listReceipts(): Promise<PaymentReceipt[]>;
+    saveWebhookEvent(event: WebhookEvent): Promise<void>;
+    listWebhookEvents(filter?: ReceiptStoreEventFilter): Promise<WebhookEvent[]>;
+    saveWebhookDelivery(delivery: WebhookDeliveryAttempt): Promise<void>;
+    getWebhookDelivery(id: string): Promise<WebhookDeliveryAttempt | undefined>;
+    listWebhookDeliveries(filter?: ReceiptStoreDeliveryFilter): Promise<WebhookDeliveryAttempt[]>;
+    getWatcherCursor(key: string): Promise<WatcherCursor | undefined>;
+    listWatcherCursors(): Promise<WatcherCursor[]>;
+    saveWatcherCursor(cursor: WatcherCursor): Promise<void>;
+    deleteWatcherCursor(key: string): Promise<void>;
+}
+export declare function createWatcherCursorKey(input: WatcherCursorKeyInput): string;
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/receipts/store.js

@@ -0,0 +1,85 @@
+export class InMemoryReceiptStore {
+    invoices = new Map();
+    receipts = new Map();
+    events = new Map();
+    deliveries = new Map();
+    cursors = new Map();
+    async saveInvoice(invoice) {
+        this.invoices.set(invoice.id, invoice);
+    }
+    async getInvoice(id) {
+        return this.invoices.get(id);
+    }
+    async 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;
+        });
+    }
+    async saveReceipt(receipt) {
+        this.receipts.set(receipt.id, receipt);
+    }
+    async getReceipt(id) {
+        return this.receipts.get(id);
+    }
+    async getReceiptByTxHash(txHash, invoiceId) {
+        return [...this.receipts.values()].find((receipt) => (receipt.txHash?.toLowerCase() === txHash.toLowerCase()
+            && (invoiceId === undefined || receipt.invoiceId === invoiceId)));
+    }
+    async listReceipts() {
+        return [...this.receipts.values()];
+    }
+    async saveWebhookEvent(event) {
+        this.events.set(event.id, event);
+    }
+    async listWebhookEvents(filter = {}) {
+        return [...this.events.values()].filter((event) => {
+            if (filter.type && event.type !== filter.type) {
+                return false;
+            }
+            return true;
+        });
+    }
+    async saveWebhookDelivery(delivery) {
+        this.deliveries.set(delivery.id, delivery);
+    }
+    async getWebhookDelivery(id) {
+        return this.deliveries.get(id);
+    }
+    async listWebhookDeliveries(filter = {}) {
+        return [...this.deliveries.values()].filter((delivery) => {
+            if (filter.eventId && delivery.eventId !== filter.eventId) {
+                return false;
+            }
+            if (filter.status && delivery.status !== filter.status) {
+                return false;
+            }
+            return true;
+        });
+    }
+    async getWatcherCursor(key) {
+        return this.cursors.get(key);
+    }
+    async listWatcherCursors() {
+        return [...this.cursors.values()];
+    }
+    async saveWatcherCursor(cursor) {
+        this.cursors.set(cursor.key, cursor);
+    }
+    async deleteWatcherCursor(key) {
+        this.cursors.delete(key);
+    }
+}
+export function createWatcherCursorKey(input) {
+    return [
+        input.network,
+        input.invoiceId,
+        input.memoId?.toLowerCase() ?? 'no-memo-id',
+    ].join(':');
+}
+//# sourceMappingURL=store.js.map

package/dist/receipts/store.js.map

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

package/dist/receipts/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Types for Resvary invoice, receipt, and webhook workflows.
+ */
+export type StablecoinSymbol = 'USDC' | 'EURC';
+export type InvoiceStatus = 'open' | 'observed' | 'paid' | 'expired' | 'refunded' | 'void';
+export type ReceiptStatus = 'paid' | 'refunded';
+export interface CreateInvoiceInput {
+    /** Optional deterministic invoice id. A random id is generated when omitted. */
+    id?: string;
+    /** Human-readable stablecoin amount, e.g. "19.00". */
+    amount: string;
+    /** Stablecoin symbol. Defaults to USDC. */
+    currency?: StablecoinSymbol;
+    /** Seller wallet receiving the payment. */
+    payTo: `0x${string}`;
+    /** Arc network identifier. Defaults to arc-testnet. */
+    network?: string;
+    /** Optional customer/user id from the seller application. */
+    customerId?: string;
+    /** Optional invoice description. */
+    description?: string;
+    /** Unix timestamp in milliseconds. */
+    createdAt?: number;
+    /** Unix timestamp in milliseconds. */
+    expiresAt?: number;
+    /** Optional metadata copied into receipts and webhooks. */
+    metadata?: Record<string, unknown>;
+}
+export interface PaymentInvoice {
+    id: string;
+    status: InvoiceStatus;
+    amount: string;
+    amountUnits: string;
+    currency: StablecoinSymbol;
+    payTo: `0x${string}`;
+    network: string;
+    memo: string;
+    memoId?: `0x${string}`;
+    memoData?: `0x${string}`;
+    paymentUri: string;
+    createdAt: number;
+    expiresAt?: number;
+    customerId?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ObservedPayment {
+    txHash?: `0x${string}`;
+    from?: `0x${string}`;
+    to: `0x${string}`;
+    amount: string;
+    currency?: StablecoinSymbol;
+    network?: string;
+    memo?: string;
+    memoId?: `0x${string}`;
+    callDataHash?: `0x${string}`;
+    observedAt?: number;
+    blockNumber?: bigint;
+    onchainProof?: ReceiptOnchainProof;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoPaymentRequest {
+    invoiceId: string;
+    memoContract: `0x${string}`;
+    target: `0x${string}`;
+    data: `0x${string}`;
+    txData: `0x${string}`;
+    memoId: `0x${string}`;
+    memoData: `0x${string}`;
+    callDataHash: `0x${string}`;
+    amountUnits: string;
+    payTo: `0x${string}`;
+}
+export interface PaymentMatchResult {
+    success: boolean;
+    reason?: string;
+}
+export interface PaymentReceipt {
+    id: string;
+    invoiceId: string;
+    status: ReceiptStatus;
+    amount: string;
+    amountUnits: string;
+    currency: StablecoinSymbol;
+    network: string;
+    payTo: `0x${string}`;
+    payer?: `0x${string}`;
+    memo: string;
+    txHash?: `0x${string}`;
+    createdAt: number;
+    blockNumber?: bigint;
+    onchainProof?: ReceiptOnchainProof;
+    metadata?: Record<string, unknown>;
+}
+export interface ReceiptOnchainProof {
+    chainId: number;
+    network: string;
+    txHash: `0x${string}`;
+    blockNumber: bigint;
+    transactionIndex?: number;
+    logIndex?: number;
+    memoContract: `0x${string}`;
+    memoIndex?: string;
+    memoId: `0x${string}`;
+    callDataHash: `0x${string}`;
+    payer: `0x${string}`;
+    payTo: `0x${string}`;
+    target: `0x${string}`;
+    amountUnits: string;
+    explorerUrl: string;
+    verifiedAt: number;
+}
+export type WebhookEventType = 'invoice.created' | 'invoice.observed' | 'invoice.paid' | 'invoice.expired' | 'invoice.refunded' | 'credit.granted' | 'credit.adjusted' | 'credit.reserved' | 'credit.released' | 'credit.expired' | 'usage.charged' | 'funding.intent.created' | 'funding.accepted' | 'funding.confirmed' | 'funding.settled' | 'funding.reconciliation_required' | 'funding.failed';
+export interface WebhookEvent<TData = unknown> {
+    id: string;
+    type: WebhookEventType;
+    createdAt: number;
+    data: TData;
+}
+export type WebhookDeliveryStatus = 'verified' | 'failed';
+export interface WebhookDeliveryAttempt {
+    id: string;
+    eventId: string;
+    eventType: WebhookEventType | 'unknown';
+    attempt: number;
+    status: WebhookDeliveryStatus;
+    verified: boolean;
+    signatureHeader: string;
+    receivedAt: number;
+    target?: string;
+    replayOf?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/receipts/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for Resvary invoice, receipt, and webhook workflows.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/receipts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/receipts/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}