@unicitylabs/sphere-sdk 0.14.0-dev.5 → 0.14.0-dev.7

package/dist/core/index.d.cts

@@ -2631,7 +2631,7 @@ declare class PaymentsModule {
     onPaymentRequest(handler: PaymentRequestHandler): () => void;
     /** Get all payment requests. @see PaymentRequests.getPaymentRequests */
     getPaymentRequests(filter?: {
-        status?: PaymentRequestStatus$1;
+        status?: PaymentRequestStatus;
     }): IncomingPaymentRequest[];
     /** Count of incoming payment requests with status `'pending'`. @see PaymentRequests.getPendingPaymentRequestsCount */
     getPendingPaymentRequestsCount(): number;
@@ -2645,7 +2645,7 @@ declare class PaymentsModule {
     payPaymentRequest(requestId: string, memo?: string): Promise<TransferResult>;
     /** Get outgoing payment requests. @see PaymentRequests.getOutgoingPaymentRequests */
     getOutgoingPaymentRequests(filter?: {
-        status?: PaymentRequestStatus$1;
+        status?: PaymentRequestStatus;
     }): OutgoingPaymentRequest[];
     /** Subscribe to payment request responses. @see PaymentRequests.onPaymentRequestResponse */
     onPaymentRequestResponse(handler: PaymentRequestResponseHandler): () => void;
@@ -4060,6 +4060,107 @@ interface FailedNoticeInfo {
     readonly error?: string;
 }
 
+interface SendRequest {
+    recipient: string;
+    amount: string;
+    coinId: string;
+    memo?: string;
+}
+interface MintResult {
+    success: boolean;
+    tokenId?: string;
+    error?: string;
+}
+interface HistoryEntry {
+    id: string;
+    type: 'SENT' | 'RECEIVED' | 'MINT';
+    coinId: string;
+    amount: string;
+    symbol?: string;
+    timestamp: number;
+    memo?: string;
+    transferId?: string;
+    tokenId?: string;
+    senderPubkey?: string;
+    senderNametag?: string;
+    recipientPubkey?: string;
+    recipientNametag?: string;
+    tokenIds?: {
+        id: string;
+        amount: string;
+    }[];
+}
+interface HistoryPage {
+    entries: HistoryEntry[];
+    more: boolean;
+    cursor: string | null;
+}
+type PaymentRequestStatus$1 = 'pending' | 'settling' | 'paid' | 'rejected' | 'expired';
+interface PaymentRequestView {
+    id: string;
+    requestId: string;
+    senderPubkey: string;
+    senderNametag?: string;
+    amount: string;
+    coinId: string;
+    symbol?: string;
+    message?: string;
+    timestamp: number;
+    status: PaymentRequestStatus$1;
+}
+interface PaymentsRequestsApi {
+    create(to: string, terms: {
+        coinId: string;
+        amount: string;
+        memo?: string;
+    }): Promise<{
+        success: boolean;
+        requestId?: string;
+        error?: string;
+    }>;
+    list(): PaymentRequestView[];
+    pay(id: string): Promise<TransferResult>;
+    decline(id: string): Promise<void>;
+    dismissProcessed(): void;
+}
+/**
+ * A pending-transfers row, derived ON READ from the §6 stores (intent backstop
+ * + delivery journal + shortfalls) — never a cached mirror. kind 'shortfall' =
+ * a completed partial (#690) whose `amount` is the remainder still owed;
+ * legs.certified counts journaled legs (certified, delivery still owed).
+ */
+interface PendingTransfer {
+    transferId: string;
+    kind: 'open' | 'shortfall';
+    recipient: string;
+    coinId: string;
+    amount: string;
+    legs: {
+        certified: number;
+        total: number;
+    };
+    deliveryPending: boolean;
+    createdAt: number;
+}
+interface PaymentsV2 {
+    assets(coinId?: string): Promise<Asset[]>;
+    tokens(filter?: {
+        coinId?: string;
+    }): Token[];
+    history(page?: {
+        before?: string;
+        limit?: number;
+    }): Promise<HistoryPage>;
+    send(req: SendRequest): Promise<TransferResult>;
+    mint(coinId: string, amount: bigint): Promise<MintResult>;
+    receive(): Promise<{
+        transfers: IncomingTransfer[];
+    }>;
+    pendingTransfers(): Promise<PendingTransfer[]>;
+    resumeNow(): Promise<void>;
+    readonly requests: PaymentsRequestsApi;
+}
+
 /**
  * Group Chat Types (NIP-29)
  * Plain interfaces for SDK consumers — no classes, no UI helpers.
@@ -4473,7 +4574,7 @@ interface IncomingTransfer {
     readonly memo?: string;
     readonly receivedAt: number;
 }
-type PaymentRequestStatus$1 = 'pending' | 'rejected' | 'paid' | 'expired' | 'settling';
+type PaymentRequestStatus = 'pending' | 'rejected' | 'paid' | 'expired' | 'settling';
 /**
  * Outgoing payment request (requesting payment from someone)
  */
@@ -4514,7 +4615,7 @@ interface IncomingPaymentRequest {
     /** Timestamp */
     readonly timestamp: number;
     /** Current status */
-    status: PaymentRequestStatus$1;
+    status: PaymentRequestStatus;
 }
 /**
  * Result of sending a payment request
@@ -4554,7 +4655,7 @@ interface OutgoingPaymentRequest {
     /** Created timestamp */
     readonly createdAt: number;
     /** Current status */
-    status: PaymentRequestStatus$1;
+    status: PaymentRequestStatus;
     /** Response data (if received) */
     response?: PaymentRequestResponse;
 }
@@ -4851,7 +4952,7 @@ interface SphereEventMap {
     'communications:ready': {
         conversationCount: number;
     };
-    'history:updated': TransactionHistoryEntry;
+    'history:updated': TransactionHistoryEntry | HistoryEntry;
     /** Replaces transfer:confirmed / :delivery_pending / :failed on the v2 vertical. */
     'transfer:updated': TransferResult;
     /** Replaces split:checkpoint-stuck / delivery:undeliverable / delivery:deferred (by code). */
@@ -7080,86 +7181,6 @@ interface DerivedAddressInfo {
  */
 declare function discoverAddressesImpl(deriveTransportPubkey: (index: number) => DerivedAddressInfo, batchResolve: (transportPubkeys: string[]) => Promise<PeerInfo[]>, options?: DiscoverAddressesOptions): Promise<DiscoverAddressesResult>;
 
-interface SendRequest {
-    recipient: string;
-    amount: string;
-    coinId: string;
-    memo?: string;
-}
-interface MintResult {
-    success: boolean;
-    tokenId?: string;
-    error?: string;
-}
-interface HistoryEntry {
-    id: string;
-    type: 'SENT' | 'RECEIVED' | 'MINT';
-    coinId: string;
-    amount: string;
-    symbol?: string;
-    timestamp: number;
-    memo?: string;
-    transferId?: string;
-    tokenId?: string;
-    senderPubkey?: string;
-    senderNametag?: string;
-    recipientPubkey?: string;
-    recipientNametag?: string;
-    tokenIds?: {
-        id: string;
-        amount: string;
-    }[];
-}
-interface HistoryPage {
-    entries: HistoryEntry[];
-    more: boolean;
-    cursor: string | null;
-}
-type PaymentRequestStatus = 'pending' | 'settling' | 'paid' | 'rejected' | 'expired';
-interface PaymentRequestView {
-    id: string;
-    requestId: string;
-    senderPubkey: string;
-    senderNametag?: string;
-    amount: string;
-    coinId: string;
-    symbol?: string;
-    message?: string;
-    timestamp: number;
-    status: PaymentRequestStatus;
-}
-interface PaymentsRequestsApi {
-    create(to: string, terms: {
-        coinId: string;
-        amount: string;
-        memo?: string;
-    }): Promise<{
-        success: boolean;
-        requestId?: string;
-        error?: string;
-    }>;
-    list(): PaymentRequestView[];
-    pay(id: string): Promise<TransferResult>;
-    decline(id: string): Promise<void>;
-    dismissProcessed(): void;
-}
-interface PaymentsV2 {
-    assets(coinId?: string): Promise<Asset[]>;
-    tokens(filter?: {
-        coinId?: string;
-    }): Token[];
-    history(page?: {
-        before?: string;
-        limit?: number;
-    }): Promise<HistoryPage>;
-    send(req: SendRequest): Promise<TransferResult>;
-    mint(coinId: string, amount: bigint): Promise<MintResult>;
-    receive(): Promise<{
-        transfers: IncomingTransfer[];
-    }>;
-    readonly requests: PaymentsRequestsApi;
-}
-
 /**
  * Text Wallet Backup Serialization Types
  */
@@ -7736,7 +7757,10 @@ declare class Sphere {
     private static resolveSwapConfig;
     /**
      * P9: validate + resolve the paymentsV2 opt-in BEFORE any storage writes —
-     * fail-closed at init, never a silently-degraded composition.
+     * fail-closed at init, never a silently-degraded composition. Returns the
+     * resolved composition (null = flag off); #728: resolving here also asserts
+     * the single-network invariant (walletApi.network known + equal to the
+     * Sphere network) before any session/KV/provider exists.
      */
     private static resolvePaymentsV2Flag;
     /**

package/dist/core/index.d.ts

@@ -2631,7 +2631,7 @@ declare class PaymentsModule {
     onPaymentRequest(handler: PaymentRequestHandler): () => void;
     /** Get all payment requests. @see PaymentRequests.getPaymentRequests */
     getPaymentRequests(filter?: {
-        status?: PaymentRequestStatus$1;
+        status?: PaymentRequestStatus;
     }): IncomingPaymentRequest[];
     /** Count of incoming payment requests with status `'pending'`. @see PaymentRequests.getPendingPaymentRequestsCount */
     getPendingPaymentRequestsCount(): number;
@@ -2645,7 +2645,7 @@ declare class PaymentsModule {
     payPaymentRequest(requestId: string, memo?: string): Promise<TransferResult>;
     /** Get outgoing payment requests. @see PaymentRequests.getOutgoingPaymentRequests */
     getOutgoingPaymentRequests(filter?: {
-        status?: PaymentRequestStatus$1;
+        status?: PaymentRequestStatus;
     }): OutgoingPaymentRequest[];
     /** Subscribe to payment request responses. @see PaymentRequests.onPaymentRequestResponse */
     onPaymentRequestResponse(handler: PaymentRequestResponseHandler): () => void;
@@ -4060,6 +4060,107 @@ interface FailedNoticeInfo {
     readonly error?: string;
 }
 
+interface SendRequest {
+    recipient: string;
+    amount: string;
+    coinId: string;
+    memo?: string;
+}
+interface MintResult {
+    success: boolean;
+    tokenId?: string;
+    error?: string;
+}
+interface HistoryEntry {
+    id: string;
+    type: 'SENT' | 'RECEIVED' | 'MINT';
+    coinId: string;
+    amount: string;
+    symbol?: string;
+    timestamp: number;
+    memo?: string;
+    transferId?: string;
+    tokenId?: string;
+    senderPubkey?: string;
+    senderNametag?: string;
+    recipientPubkey?: string;
+    recipientNametag?: string;
+    tokenIds?: {
+        id: string;
+        amount: string;
+    }[];
+}
+interface HistoryPage {
+    entries: HistoryEntry[];
+    more: boolean;
+    cursor: string | null;
+}
+type PaymentRequestStatus$1 = 'pending' | 'settling' | 'paid' | 'rejected' | 'expired';
+interface PaymentRequestView {
+    id: string;
+    requestId: string;
+    senderPubkey: string;
+    senderNametag?: string;
+    amount: string;
+    coinId: string;
+    symbol?: string;
+    message?: string;
+    timestamp: number;
+    status: PaymentRequestStatus$1;
+}
+interface PaymentsRequestsApi {
+    create(to: string, terms: {
+        coinId: string;
+        amount: string;
+        memo?: string;
+    }): Promise<{
+        success: boolean;
+        requestId?: string;
+        error?: string;
+    }>;
+    list(): PaymentRequestView[];
+    pay(id: string): Promise<TransferResult>;
+    decline(id: string): Promise<void>;
+    dismissProcessed(): void;
+}
+/**
+ * A pending-transfers row, derived ON READ from the §6 stores (intent backstop
+ * + delivery journal + shortfalls) — never a cached mirror. kind 'shortfall' =
+ * a completed partial (#690) whose `amount` is the remainder still owed;
+ * legs.certified counts journaled legs (certified, delivery still owed).
+ */
+interface PendingTransfer {
+    transferId: string;
+    kind: 'open' | 'shortfall';
+    recipient: string;
+    coinId: string;
+    amount: string;
+    legs: {
+        certified: number;
+        total: number;
+    };
+    deliveryPending: boolean;
+    createdAt: number;
+}
+interface PaymentsV2 {
+    assets(coinId?: string): Promise<Asset[]>;
+    tokens(filter?: {
+        coinId?: string;
+    }): Token[];
+    history(page?: {
+        before?: string;
+        limit?: number;
+    }): Promise<HistoryPage>;
+    send(req: SendRequest): Promise<TransferResult>;
+    mint(coinId: string, amount: bigint): Promise<MintResult>;
+    receive(): Promise<{
+        transfers: IncomingTransfer[];
+    }>;
+    pendingTransfers(): Promise<PendingTransfer[]>;
+    resumeNow(): Promise<void>;
+    readonly requests: PaymentsRequestsApi;
+}
+
 /**
  * Group Chat Types (NIP-29)
  * Plain interfaces for SDK consumers — no classes, no UI helpers.
@@ -4473,7 +4574,7 @@ interface IncomingTransfer {
     readonly memo?: string;
     readonly receivedAt: number;
 }
-type PaymentRequestStatus$1 = 'pending' | 'rejected' | 'paid' | 'expired' | 'settling';
+type PaymentRequestStatus = 'pending' | 'rejected' | 'paid' | 'expired' | 'settling';
 /**
  * Outgoing payment request (requesting payment from someone)
  */
@@ -4514,7 +4615,7 @@ interface IncomingPaymentRequest {
     /** Timestamp */
     readonly timestamp: number;
     /** Current status */
-    status: PaymentRequestStatus$1;
+    status: PaymentRequestStatus;
 }
 /**
  * Result of sending a payment request
@@ -4554,7 +4655,7 @@ interface OutgoingPaymentRequest {
     /** Created timestamp */
     readonly createdAt: number;
     /** Current status */
-    status: PaymentRequestStatus$1;
+    status: PaymentRequestStatus;
     /** Response data (if received) */
     response?: PaymentRequestResponse;
 }
@@ -4851,7 +4952,7 @@ interface SphereEventMap {
     'communications:ready': {
         conversationCount: number;
     };
-    'history:updated': TransactionHistoryEntry;
+    'history:updated': TransactionHistoryEntry | HistoryEntry;
     /** Replaces transfer:confirmed / :delivery_pending / :failed on the v2 vertical. */
     'transfer:updated': TransferResult;
     /** Replaces split:checkpoint-stuck / delivery:undeliverable / delivery:deferred (by code). */
@@ -7080,86 +7181,6 @@ interface DerivedAddressInfo {
  */
 declare function discoverAddressesImpl(deriveTransportPubkey: (index: number) => DerivedAddressInfo, batchResolve: (transportPubkeys: string[]) => Promise<PeerInfo[]>, options?: DiscoverAddressesOptions): Promise<DiscoverAddressesResult>;
 
-interface SendRequest {
-    recipient: string;
-    amount: string;
-    coinId: string;
-    memo?: string;
-}
-interface MintResult {
-    success: boolean;
-    tokenId?: string;
-    error?: string;
-}
-interface HistoryEntry {
-    id: string;
-    type: 'SENT' | 'RECEIVED' | 'MINT';
-    coinId: string;
-    amount: string;
-    symbol?: string;
-    timestamp: number;
-    memo?: string;
-    transferId?: string;
-    tokenId?: string;
-    senderPubkey?: string;
-    senderNametag?: string;
-    recipientPubkey?: string;
-    recipientNametag?: string;
-    tokenIds?: {
-        id: string;
-        amount: string;
-    }[];
-}
-interface HistoryPage {
-    entries: HistoryEntry[];
-    more: boolean;
-    cursor: string | null;
-}
-type PaymentRequestStatus = 'pending' | 'settling' | 'paid' | 'rejected' | 'expired';
-interface PaymentRequestView {
-    id: string;
-    requestId: string;
-    senderPubkey: string;
-    senderNametag?: string;
-    amount: string;
-    coinId: string;
-    symbol?: string;
-    message?: string;
-    timestamp: number;
-    status: PaymentRequestStatus;
-}
-interface PaymentsRequestsApi {
-    create(to: string, terms: {
-        coinId: string;
-        amount: string;
-        memo?: string;
-    }): Promise<{
-        success: boolean;
-        requestId?: string;
-        error?: string;
-    }>;
-    list(): PaymentRequestView[];
-    pay(id: string): Promise<TransferResult>;
-    decline(id: string): Promise<void>;
-    dismissProcessed(): void;
-}
-interface PaymentsV2 {
-    assets(coinId?: string): Promise<Asset[]>;
-    tokens(filter?: {
-        coinId?: string;
-    }): Token[];
-    history(page?: {
-        before?: string;
-        limit?: number;
-    }): Promise<HistoryPage>;
-    send(req: SendRequest): Promise<TransferResult>;
-    mint(coinId: string, amount: bigint): Promise<MintResult>;
-    receive(): Promise<{
-        transfers: IncomingTransfer[];
-    }>;
-    readonly requests: PaymentsRequestsApi;
-}
-
 /**
  * Text Wallet Backup Serialization Types
  */
@@ -7736,7 +7757,10 @@ declare class Sphere {
     private static resolveSwapConfig;
     /**
      * P9: validate + resolve the paymentsV2 opt-in BEFORE any storage writes —
-     * fail-closed at init, never a silently-degraded composition.
+     * fail-closed at init, never a silently-degraded composition. Returns the
+     * resolved composition (null = flag off); #728: resolving here also asserts
+     * the single-network invariant (walletApi.network known + equal to the
+     * Sphere network) before any session/KV/provider exists.
      */
     private static resolvePaymentsV2Flag;
     /**