@zkp2p/pay-shared 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,370 @@
+export declare const PaymentPlatform: {
+    readonly VENMO: "venmo";
+    readonly CASHAPP: "cashapp";
+    readonly REVOLUT: "revolut";
+    readonly WISE: "wise";
+    readonly ZELLE: "zelle";
+    readonly PAYPAL: "paypal";
+    readonly MONZO: "monzo";
+    readonly N26: "n26";
+};
+export type PaymentPlatformType = typeof PaymentPlatform[keyof typeof PaymentPlatform];
+export declare const SupportedChains: Record<number, string>;
+export type SupportedChainId = keyof typeof SupportedChains;
+export declare const CheckoutMode: {
+    readonly EXACT_TOKEN: "exact-token";
+    readonly EXACT_FIAT: "exact-fiat";
+};
+export type CheckoutModeType = typeof CheckoutMode[keyof typeof CheckoutMode];
+export declare const OrderStatus: {
+    readonly SIGNAL_SUBMITTED: "SIGNAL_SUBMITTED";
+    readonly SIGNAL_MINED: "SIGNAL_MINED";
+    readonly PAYMENT_SENT: "PAYMENT_SENT";
+    readonly PROOF_VERIFIED: "PROOF_VERIFIED";
+    readonly FULFILL_SUBMITTED: "FULFILL_SUBMITTED";
+    readonly FULFILLED: "FULFILLED";
+    readonly CANCELLED: "CANCELLED";
+    readonly EXPIRED: "EXPIRED";
+    readonly FAILED: "FAILED";
+};
+export type OrderStatusType = typeof OrderStatus[keyof typeof OrderStatus];
+export declare const ProofAttemptStatus: {
+    readonly PENDING: "PENDING";
+    readonly VERIFYING: "VERIFYING";
+    readonly VERIFIED: "VERIFIED";
+    readonly REJECTED: "REJECTED";
+};
+export type ProofAttemptStatusType = typeof ProofAttemptStatus[keyof typeof ProofAttemptStatus];
+export declare const SessionStatus: {
+    readonly CREATED: "CREATED";
+    readonly ACTIVE: "ACTIVE";
+    readonly COMPLETED: "COMPLETED";
+    readonly EXPIRED: "EXPIRED";
+    readonly CANCELLED: "CANCELLED";
+};
+export type SessionStatusType = typeof SessionStatus[keyof typeof SessionStatus];
+export declare const OrderErrorCode: {
+    readonly PROOF_INVALID: "PROOF_INVALID";
+    readonly PROOF_EXPIRED: "PROOF_EXPIRED";
+    readonly PROOF_AMOUNT_MISMATCH: "PROOF_AMOUNT_MISMATCH";
+    readonly PROOF_RECIPIENT_MISMATCH: "PROOF_RECIPIENT_MISMATCH";
+    readonly FULFILL_TIMEOUT: "FULFILL_TIMEOUT";
+    readonly FULFILL_REVERTED: "FULFILL_REVERTED";
+    readonly SIGNAL_TIMEOUT: "SIGNAL_TIMEOUT";
+    readonly SIGNAL_REVERTED: "SIGNAL_REVERTED";
+    readonly RPC_ERROR: "RPC_ERROR";
+    readonly RELAYER_ERROR: "RELAYER_ERROR";
+    readonly ATTESTATION_ERROR: "ATTESTATION_ERROR";
+    readonly BRIDGE_QUOTE_ERROR: "BRIDGE_QUOTE_ERROR";
+    readonly BRIDGE_TIMEOUT: "BRIDGE_TIMEOUT";
+    readonly FEE_THRESHOLD_EXCEEDED: "FEE_THRESHOLD_EXCEEDED";
+    readonly SDK_ERROR: "SDK_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type OrderErrorCodeType = typeof OrderErrorCode[keyof typeof OrderErrorCode];
+export declare const MerchantEnvironment: {
+    readonly LIVE: "LIVE";
+    readonly SANDBOX: "SANDBOX";
+};
+export type MerchantEnvironmentType = typeof MerchantEnvironment[keyof typeof MerchantEnvironment];
+export type Merchant = {
+    id: string;
+    name: string;
+    logoUrl?: string | null;
+    disableBranding?: boolean;
+    apiKey: string;
+    environment?: MerchantEnvironmentType;
+    sandboxMerchantId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultChainId?: number | null;
+    defaultCheckoutMode?: 'exact-token' | 'exact-fiat' | null;
+    defaultFiatCurrency?: string | null;
+    defaultMaxFeePercentage?: number | null;
+    enabledPaymentPlatforms?: PaymentPlatformType[] | null;
+};
+export type CreateMerchantRequest = {
+    name: string;
+    logoUrl?: string;
+};
+export type CheckoutSession = {
+    id: string;
+    merchantId: string;
+    amountUsdc: string;
+    netAmountUsdc?: string | null;
+    destinationChainId: number;
+    destinationToken: string;
+    recipientAddress: string;
+    status: SessionStatusType;
+    selectedPaymentPlatform?: PaymentPlatformType | null;
+    selectedFiatCurrency?: string | null;
+    successUrl?: string | null;
+    cancelUrl?: string | null;
+    metadata?: Record<string, string> | null;
+    expiresAt?: string | null;
+    activeOrderId?: string | null;
+    checkoutMode?: CheckoutModeType;
+    fiatAmount?: string | null;
+    fiatCurrency?: string | null;
+    maxFeePercentage?: number | null;
+    requiresBridge?: boolean;
+    enabledPaymentPlatforms?: PaymentPlatformType[] | null;
+    createdAt: string;
+    updatedAt: string;
+    merchant?: {
+        id: string;
+        name: string;
+        logoUrl?: string | null;
+        environment?: MerchantEnvironmentType;
+        disableBranding?: boolean;
+    } | null;
+    activeOrder?: Order | null;
+};
+export type QuoteIntent = {
+    depositId: string;
+    processorName: string;
+    amount: string;
+    toAddress: string;
+    payeeDetails: string;
+    processorIntentData: Record<string, unknown>;
+    fiatCurrencyCode: string;
+    chainId: string;
+};
+export type Quote = {
+    fiatAmount: string;
+    fiatAmountFormatted: string;
+    tokenAmount: string;
+    tokenAmountFormatted: string;
+    paymentMethod: string;
+    payeeAddress: string;
+    conversionRate: string;
+    intent: QuoteIntent;
+    payeeData?: Record<string, string>;
+};
+export type Order = {
+    id: string;
+    sessionId: string;
+    merchantId: string;
+    status: OrderStatusType;
+    intentHash?: string | null;
+    signalTx?: string | null;
+    fulfillTx?: string | null;
+    paymentPlatform?: PaymentPlatformType | null;
+    fiatCurrency?: string | null;
+    amountUsdc?: string | null;
+    netAmountUsdc?: string | null;
+    conversionRate?: string | null;
+    recipient?: string | null;
+    quote?: Quote | null;
+    expiresAt?: string | null;
+    bridgeCommitmentData?: string | null;
+    bridgeFulfillData?: string | null;
+    bridgeDepositTxHash?: string | null;
+    bridgeStatus?: 'pending' | 'filled' | 'expired' | null;
+    bridgeFilledAt?: string | null;
+    bridgeFilledTxHash?: string | null;
+    bridgeInfo?: OrderBridgeInfo | null;
+    currentProofId?: string | null;
+    cancelTx?: string | null;
+    cancelledAt?: string | null;
+    cancelReason?: string | null;
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    errorDetails?: Record<string, unknown> | null;
+    failedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type ProofAttempt = {
+    id: string;
+    orderId: string;
+    intentHash: string;
+    proof: Record<string, unknown>;
+    submittedAt: string;
+    status: ProofAttemptStatusType;
+    verifiedAt?: string | null;
+    attestationResponse?: Record<string, unknown> | null;
+    verificationError?: string | null;
+    verificationMessage?: string | null;
+    txHash?: string | null;
+    txSubmittedAt?: string | null;
+    txConfirmedAt?: string | null;
+    txError?: string | null;
+};
+type CreateSessionBaseRequest = {
+    merchantId: string;
+    destinationChainId: number;
+    destinationToken: string;
+    recipientAddress: string;
+    successUrl?: string;
+    cancelUrl?: string;
+    metadata?: Record<string, string>;
+    enabledPaymentPlatforms?: PaymentPlatformType[];
+};
+type CreateSessionExactTokenRequest = CreateSessionBaseRequest & {
+    checkoutMode?: 'exact-token';
+    amountUsdc: string;
+    fiatAmount?: never;
+    fiatCurrency?: never;
+    maxFeePercentage?: never;
+};
+type CreateSessionExactFiatRequest = CreateSessionBaseRequest & {
+    checkoutMode: 'exact-fiat';
+    amountUsdc?: never;
+    fiatAmount: string;
+    fiatCurrency?: string;
+    maxFeePercentage?: number;
+};
+export type CreateSessionRequest = CreateSessionExactTokenRequest | CreateSessionExactFiatRequest;
+/**
+ * Bridge information returned when session requires cross-chain bridging.
+ * Amounts are in raw units (6 decimals for USDC).
+ */
+export type BridgeInfo = {
+    required: boolean;
+    inputAmount?: string | null;
+    outputAmount?: string | null;
+    feeAmount?: string | null;
+    minOutputAmount?: string | null;
+    estimatedTimeSeconds?: number | null;
+};
+export type CreateSessionResponse = {
+    session: CheckoutSession;
+    sessionToken: string;
+    checkoutUrl: string;
+    bridge?: BridgeInfo;
+};
+export type StartSessionRequest = {
+    paymentPlatform?: PaymentPlatformType;
+    fiatCurrency?: string;
+};
+export type StartSessionResponse = {
+    session: CheckoutSession;
+    order: Order;
+    quote: Quote;
+    intentHash: string;
+    expiresAt?: string | null;
+};
+export type MarkPaymentSentResponse = {
+    order: Order;
+};
+export type FulfillIntentRequest = {
+    intentHash: string;
+    proof: Record<string, unknown> | string;
+};
+export type FulfillIntentResponse = {
+    order: Order;
+    proofAttemptId: string;
+    txHash: string;
+};
+export type FulfillIntentError = {
+    proofAttemptId: string;
+    errorCode?: string;
+    errorMessage: string;
+    canRetry: boolean;
+};
+export type ProofAttemptsResponse = {
+    proofAttempts: ProofAttempt[];
+};
+export interface BridgeStatusResponse {
+    status: 'pending' | 'filled' | 'expired' | 'not_applicable';
+    destinationChainId?: string;
+    outputAmountUsdc?: string;
+    fillTxHash?: string;
+    depositTxHash?: string;
+    acrossTrackingUrl?: string;
+    estimatedFillTime?: number;
+}
+/**
+ * Bridge information included in order responses.
+ * Tracks the status of cross-chain bridging via Across Protocol.
+ */
+export interface OrderBridgeInfo {
+    status: 'PENDING' | 'DEPOSITED' | 'FILLED' | 'EXPIRED';
+    destinationChainId: string;
+    outputAmountUsdc?: string;
+    estimatedOutputAmountUsdc?: string;
+    minOutputAmountUsdc?: string;
+    fillTxHash?: string | null;
+    estimatedFillTime?: number | null;
+}
+export declare const WebhookEventType: {
+    readonly ORDER_CREATED: "order.created";
+    readonly ORDER_PAYMENT_SENT: "order.payment_sent";
+    readonly ORDER_FULFILLED: "order.fulfilled";
+    readonly ORDER_FAILED: "order.failed";
+    readonly ORDER_EXPIRED: "order.expired";
+    readonly SESSION_STARTED: "session.started";
+    readonly SESSION_COMPLETED: "session.completed";
+    readonly SESSION_ABANDONED: "session.abandoned";
+};
+export type WebhookEventTypeValue = typeof WebhookEventType[keyof typeof WebhookEventType];
+export declare const WebhookDeliveryStatus: {
+    readonly PENDING: "PENDING";
+    readonly DELIVERED: "DELIVERED";
+    readonly FAILED: "FAILED";
+};
+export type WebhookDeliveryStatusType = typeof WebhookDeliveryStatus[keyof typeof WebhookDeliveryStatus];
+export type Webhook = {
+    id: string;
+    merchantId: string;
+    url: string;
+    events: WebhookEventTypeValue[];
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+};
+export type WebhookWithSecret = Webhook & {
+    secret: string;
+};
+export type WebhookDelivery = {
+    id: string;
+    webhookId: string;
+    eventType: WebhookEventTypeValue;
+    eventId: string;
+    status: WebhookDeliveryStatusType;
+    attempts: number;
+    lastAttemptAt?: string | null;
+    nextRetryAt?: string | null;
+    responseCode?: number | null;
+    createdAt: string;
+};
+export type WebhookPayload = {
+    id: string;
+    type: WebhookEventTypeValue;
+    timestamp: string;
+    environment: MerchantEnvironmentType;
+    data: {
+        session: CheckoutSession;
+        order?: Order | null;
+        txHash?: string | null;
+        error?: {
+            code: string;
+            message: string;
+        } | null;
+    };
+};
+export type CreateWebhookRequest = {
+    url: string;
+    events?: WebhookEventTypeValue[];
+};
+export type CreateWebhookResponse = WebhookWithSecret;
+export type UpdateWebhookRequest = {
+    url?: string;
+    events?: WebhookEventTypeValue[];
+    active?: boolean;
+};
+export type ListWebhooksResponse = {
+    webhooks: Webhook[];
+};
+export type ListWebhookDeliveriesResponse = {
+    deliveries: WebhookDelivery[];
+};
+export type TestWebhookResponse = {
+    success: boolean;
+    deliveryId: string;
+    responseCode?: number | null;
+    error?: string | null;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,90 @@
+export const PaymentPlatform = {
+    VENMO: 'venmo',
+    CASHAPP: 'cashapp',
+    REVOLUT: 'revolut',
+    WISE: 'wise',
+    ZELLE: 'zelle',
+    PAYPAL: 'paypal',
+    MONZO: 'monzo',
+    N26: 'n26',
+};
+// Supported chains for USDC destination
+// Re-exported from chains.ts for backward compatibility
+import { SupportedChainsMap } from './chains.js';
+export const SupportedChains = SupportedChainsMap;
+// Checkout mode determines how amounts are specified
+export const CheckoutMode = {
+    EXACT_TOKEN: 'exact-token', // Merchant specifies USDC amount, customer pays variable fiat
+    EXACT_FIAT: 'exact-fiat', // Merchant specifies fiat amount, customer pays fixed fiat, merchant receives variable USDC
+};
+export const OrderStatus = {
+    SIGNAL_SUBMITTED: 'SIGNAL_SUBMITTED', // Intent tx submitted, awaiting confirmation
+    SIGNAL_MINED: 'SIGNAL_MINED', // Intent tx confirmed, intentHash available
+    PAYMENT_SENT: 'PAYMENT_SENT', // User marked fiat payment as sent
+    PROOF_VERIFIED: 'PROOF_VERIFIED', // ZKP proof verified by attestation service
+    FULFILL_SUBMITTED: 'FULFILL_SUBMITTED', // Fulfill tx submitted, awaiting confirmation
+    FULFILLED: 'FULFILLED', // Fulfill tx confirmed, payment complete
+    CANCELLED: 'CANCELLED', // Order cancelled
+    EXPIRED: 'EXPIRED', // Order expired
+    FAILED: 'FAILED', // Order failed due to error
+};
+export const ProofAttemptStatus = {
+    PENDING: 'PENDING', // Proof received, awaiting verification
+    VERIFYING: 'VERIFYING', // Being verified by attestation service
+    VERIFIED: 'VERIFIED', // Proof valid, fulfillment can proceed (Order tracks tx status)
+    REJECTED: 'REJECTED', // Proof failed verification (can retry with new proof)
+};
+export const SessionStatus = {
+    CREATED: 'CREATED',
+    ACTIVE: 'ACTIVE',
+    COMPLETED: 'COMPLETED',
+    EXPIRED: 'EXPIRED',
+    CANCELLED: 'CANCELLED',
+};
+// Structured error codes for Order failures
+export const OrderErrorCode = {
+    // Proof verification errors
+    PROOF_INVALID: 'PROOF_INVALID', // Proof data failed attestation verification
+    PROOF_EXPIRED: 'PROOF_EXPIRED', // Proof timestamp too old
+    PROOF_AMOUNT_MISMATCH: 'PROOF_AMOUNT_MISMATCH', // Payment amount doesn't match intent
+    PROOF_RECIPIENT_MISMATCH: 'PROOF_RECIPIENT_MISMATCH', // Payment recipient doesn't match
+    // Transaction errors
+    FULFILL_TIMEOUT: 'FULFILL_TIMEOUT', // On-chain tx timed out
+    FULFILL_REVERTED: 'FULFILL_REVERTED', // On-chain tx reverted
+    SIGNAL_TIMEOUT: 'SIGNAL_TIMEOUT', // Signal intent tx timed out
+    SIGNAL_REVERTED: 'SIGNAL_REVERTED', // Signal intent tx reverted
+    // Infrastructure errors
+    RPC_ERROR: 'RPC_ERROR', // RPC node connection/timeout
+    RELAYER_ERROR: 'RELAYER_ERROR', // Relayer submission failed
+    ATTESTATION_ERROR: 'ATTESTATION_ERROR', // Attestation service unavailable
+    // Bridge errors (cross-chain)
+    BRIDGE_QUOTE_ERROR: 'BRIDGE_QUOTE_ERROR', // Failed to get bridge quote
+    BRIDGE_TIMEOUT: 'BRIDGE_TIMEOUT', // Bridge fill timed out
+    // Fee threshold errors (exact-fiat mode)
+    FEE_THRESHOLD_EXCEEDED: 'FEE_THRESHOLD_EXCEEDED', // Quote fee exceeds merchant's max
+    // Generic
+    SDK_ERROR: 'SDK_ERROR', // Unknown SDK error
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR', // Uncategorized error
+};
+export const MerchantEnvironment = {
+    LIVE: 'LIVE',
+    SANDBOX: 'SANDBOX',
+};
+// ============ Webhook Types ============
+export const WebhookEventType = {
+    // Order lifecycle events
+    ORDER_CREATED: 'order.created',
+    ORDER_PAYMENT_SENT: 'order.payment_sent',
+    ORDER_FULFILLED: 'order.fulfilled',
+    ORDER_FAILED: 'order.failed',
+    ORDER_EXPIRED: 'order.expired',
+    // Session lifecycle events
+    SESSION_STARTED: 'session.started',
+    SESSION_COMPLETED: 'session.completed',
+    SESSION_ABANDONED: 'session.abandoned',
+};
+export const WebhookDeliveryStatus = {
+    PENDING: 'PENDING',
+    DELIVERED: 'DELIVERED',
+    FAILED: 'FAILED',
+};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@zkp2p/pay-shared",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint . --ext .ts,.tsx"
+  }
+}