@unicitylabs/sphere-sdk 0.18.0-dev.2 → 0.18.0-dev.3

package/dist/modules/payments-v2/index.d.cts

@@ -1,5 +1,6 @@
 import { IMintJustificationVerifier } from '@unicitylabs/state-transition-sdk/lib/transaction/verification/IMintJustificationVerifier.js';
 import { Token as Token$1 } from '@unicitylabs/state-transition-sdk/lib/transaction/Token.js';
+import { ITokenIssuanceVerifier } from '@unicitylabs/state-transition-sdk/lib/transaction/verification/ITokenIssuanceVerifier.js';
 
 declare const NFT_METADATA_TAG = 39052n;
 declare const NFT_MEDIA_TAG = 39053n;
@@ -185,6 +186,22 @@ interface BurnParams {
     /** The recipient predicate is `BurnPredicate(sha256(reasonBytes))`; the bytes ride in the aux data. */
     readonly reasonBytes: Uint8Array;
 }
+/** The issuance rule of one token type, and the coins no other type may carry. */
+interface TokenIssuancePolicy extends ITokenIssuanceVerifier {
+    /** A token carrying one of these coins counts only when it is of this type and verified. */
+    readonly coinIds: readonly CoinId[];
+    /** Must change whenever the proofs this policy accepts change, a fix to its verification code included, so wallets check held tokens again. */
+    readonly revision?: string;
+}
+/** Mint-reason verifiers keyed by CBOR tag, registered at engine construction. */
+interface TokenPlugin {
+    /** Stable identifier for diagnostics, e.g. `'bridge:tron-usdt'`. */
+    readonly id: string;
+    /** Mint-reason verifiers to register; a duplicate tag across plugins is INVALID_CONFIG. */
+    readonly mintJustificationVerifiers?: readonly IMintJustificationVerifier[];
+    /** Issuance policies to register; a duplicate token type or coin across plugins is INVALID_CONFIG. */
+    readonly tokenIssuancePolicies?: readonly TokenIssuancePolicy[];
+}
 /** Plan an NFT mint (#785); `mintDataToken` then mints the plan. */
 interface BuildNftMintParams {
     /** The first owner's 33-byte compressed chain pubkey — the genesis recipient a signature binds. */
@@ -379,6 +396,8 @@ interface ITokenEngine {
      * read its bytes via `readTokenData`. (Used e.g. for on-chain invoice tokens.)
      */
     mintDataToken(params: MintDataTokenParams, options?: EngineOpOptions): Promise<SphereToken>;
+    /** Throws VALIDATION_ERROR when `mintDataToken` would refuse `params` before submitting, e.g. a reason tag no registered verifier handles. */
+    assertMintable(params: MintDataTokenParams): void;
     /** Plan an NFT mint: encode (and optionally sign as this engine's identity) the payload and derive its token id. No chain op. */
     buildNftMint(params: BuildNftMintParams): Promise<NftMintPlan>;
     /** Spend a token wholesale to a recipient pubkey; returns the recipient's finished token. */
@@ -450,6 +469,7 @@ interface FullIdentity extends Identity {
     readonly privateKey: string;
 }
 type TokenStatus = 'pending' | 'submitted' | 'confirmed' | 'transferring' | 'spent' | 'invalid';
+type Unverified = 'pending' | 'refused';
 interface Token {
     readonly id: string;
     readonly coinId: string;
@@ -476,6 +496,8 @@ interface Token {
      * send self-heals instead of wedging on a stale source.
      */
     suspectedSpent?: boolean;
+    /** Carries a coin an issuance policy claims without having passed that policy yet (`pending`) or at all (`refused`): shown, never spent. */
+    readonly unverified?: Unverified;
 }
 /**
  * A holding that names no coin (wallet-api#140) — an NFT. Deliberately NOT a
@@ -538,6 +560,8 @@ interface Asset {
     readonly fiatValueUsd: number | null;
     /** Total fiat value in EUR */
     readonly fiatValueEur: number | null;
+    /** Holds tokens of a claimed coin that have not passed its issuance policy yet (`pending`) or at all (`refused`): never spendable, never priced. */
+    readonly unverified?: Unverified;
 }
 type TransferStatus = 'pending' | 'submitted' | 'confirmed' | 'delivered' | 'completed' | 'failed';
 /**
@@ -574,6 +598,8 @@ interface IncomingTransfer {
     readonly tokens: Token[];
     /** Arrivals that name no coin (#777). Disjoint from `tokens`, never a zero Token. */
     readonly coinless?: CoinlessToken[];
+    /** Refused arrivals of a claimed coin under another type; never counted, and never in `tokens`. */
+    readonly unverifiedTokens?: Token[];
     readonly memo?: string;
     readonly receivedAt: number;
 }
@@ -634,6 +660,7 @@ interface BurnResult {
     /** The burned blob, the proof of the burn: persist it, then `acknowledgeBurn(burnId)`. */
     burnedToken?: Uint8Array;
     error?: string;
+    errorCode?: string;
 }
 /** A burn not yet acknowledged: in flight (`burnedToken` null), certified, or settled. */
 interface PendingBurn {
@@ -643,6 +670,10 @@ interface PendingBurn {
     readonly burnedToken: Uint8Array | null;
     readonly settled: boolean;
     readonly createdAt: number;
+    readonly failure?: {
+        readonly code: string;
+        readonly message: string;
+    };
 }
 /** #785: `content` uses ERC-721 field names; `sign` (default true) signs as creator with this wallet's chain key. */
 interface MintNftRequest {
@@ -730,9 +761,13 @@ interface PaymentsV2 {
     prewarmSend(request: SendRequest): Promise<void>;
     discardPrewarm(): void;
     assets(coinId?: string): Promise<Asset[]>;
+    unverifiedAssets(coinId?: string): Promise<Asset[]>;
     tokens(filter?: {
         coinId?: string;
     }): Token[];
+    unverifiedTokens(filter?: {
+        coinId?: string;
+    }): Token[];
     coinless(): CoinlessToken[];
     tokenData(tokenId: string): Promise<Uint8Array | null>;
     /** The genesis mint reason of one held token; null when it was minted without one. Same contract as tokenData. */
@@ -821,6 +856,7 @@ interface StoragePort {
             tokenId: string;
             key: string;
         }[];
+        externalDelivery?: boolean;
     }): Promise<ApplyDeltaResult>;
 }
 interface DeliveryReceipt {
@@ -1046,7 +1082,13 @@ interface BurnJournalEntry {
         amount: string;
     }[];
     createdAt: number;
+    failure?: BurnFailure;
+}
+interface BurnFailure {
+    code: string;
+    message: string;
 }
+declare function isLiveBurn(entry: BurnJournalEntry): boolean;
 interface ShortfallEntry {
     transferId: string;
     remainingAmount: string;
@@ -1080,6 +1122,7 @@ declare const STORE_KEYS: {
     readonly epochLatch: "epoch-latch";
     readonly suspectedSpent: "suspected-spent";
     readonly knownSpends: "known-spends";
+    readonly verifiedTokens: "verified-tokens";
 };
 
 interface HistoryWireAsset {
@@ -1115,6 +1158,9 @@ declare const ATTENTION_MINT_UNRESOLVED = "mint:unresolved";
 /** Genesis payload cap, NftSigned wrapper included: wallet-api refuses an oversize blob only after the mint certified. */
 declare const NFT_MAX_PAYLOAD_BYTES: number;
 
+/** Cap on `data` plus `justification`: wallet-api refuses an oversize blob only after the mint certified. */
+declare const CUSTOM_MINT_MAX_PAYLOAD_BYTES: number;
+
 interface IntentPayloadBase {
     v: 2;
     recipient: string;
@@ -1286,6 +1332,15 @@ declare class Requests implements PaymentsRequestsApi {
     private revertPayable;
 }
 
+declare class CoinClaims {
+    private readonly issuers;
+    private readonly policies;
+    static fromPlugins(plugins: readonly TokenPlugin[] | undefined): CoinClaims;
+    add(policy: TokenIssuancePolicy): void;
+    fingerprint(): string;
+    issuerOf(coinId: CoinId): string | null;
+}
+
 interface RegistryReader {
     getSymbol(coinId: string): string;
     getName(coinId: string): string;
@@ -1381,6 +1436,8 @@ interface PaymentsFacadeDeps {
     kv: ScopedKV;
     registry: RegistryReader;
     price?: PriceReader;
+    /** Coins that count only in verified tokens of their issuing type (TokenPlugin issuance policies). */
+    claims?: CoinClaims;
     emit: (event: string, payload: unknown) => void;
     resolveRecipient: (identifier: string) => Promise<RecipientInfo | null>;
     signComplete: (transferId: string) => Promise<string>;
@@ -1410,6 +1467,7 @@ declare class PaymentsFacade implements PaymentsV2 {
     private readonly wakeRefresh;
     private readonly prewarmed;
     private readonly view;
+    private readonly verdicts;
     private readonly ledger;
     private readonly queue;
     private readonly machine;
@@ -1435,6 +1493,7 @@ declare class PaymentsFacade implements PaymentsV2 {
     private readonly activeMoneyOps;
     /** #737: the ledger holds exactly the sources of the still-open intents. */
     private readonly pins;
+    private readonly burnHold;
     /** Per facade, so per address: an NFT reading is never served to another wallet. */
     private readonly nftCache;
     constructor(deps: PaymentsFacadeDeps);
@@ -1445,9 +1504,14 @@ declare class PaymentsFacade implements PaymentsV2 {
      *  DISPOSED here, so one mid-`verify()` is cancelled — MODULE_DESTROYED, #770(4). */
     setEngine(next: ITokenEngine): void;
     assets(coinId?: string): Promise<Asset[]>;
+    unverifiedAssets: (coinId?: string) => Promise<Asset[]>;
+    private heldAssets;
     tokens(filter?: {
         coinId?: string;
     }): Token[];
+    unverifiedTokens: (filter?: {
+        coinId?: string;
+    }) => Token[];
     coinless(): CoinlessToken[];
     tokenData(tokenId: string): Promise<Uint8Array | null>;
     tokenJustification(tokenId: string): Promise<Uint8Array | null>;
@@ -1527,7 +1591,6 @@ declare class PaymentsFacade implements PaymentsV2 {
     private ownedOp;
     private engine;
     private newId;
-    private seedHeldStates;
     private track;
     private trackTail;
 }
@@ -1535,4 +1598,4 @@ declare class PaymentsFacade implements PaymentsV2 {
 declare const HEARTBEAT_SEED_MS = 5000;
 declare const HEARTBEAT_CAP_MS = 120000;
 
-export { ATTENTION_MINT_UNRESOLVED, ATTENTION_RECIPIENT_NETWORK_UNVERIFIED, ATTENTION_RESEED_REJECTED, type AckOutcome, type AckRequest, type ApplyDeltaResult, type BurnJournalEntry, type BurnRequest, type BurnResult, type CheckpointReseeder, type ConnectionStatus, type CustomMintJournalEntry, type DeliverOptions, type DeliveryJournalEntry, type DeliveryPort, type DeliveryReceipt, type DeterministicMintCapable, type FacadeClient, type FacadeSession, HEARTBEAT_CAP_MS, HEARTBEAT_SEED_MS, type HistoryEntry, type HistoryPage, type IncomingDelivery, type IntentBackstopEntry, type IntentPayload, type InventoryAsset, type InventoryItem, type InventoryPage, MAX_RESELECT, type MintCustomRequest, type MintJournalEntry, type MintNftRequest, type MintResult, NFT_DOCUMENT_MEDIA_TYPE, NFT_LINK_TAG, NFT_MAX_PAYLOAD_BYTES, NFT_MEDIA_TAG, NFT_METADATA_TAG, NFT_SIGNED_TAG, type NftAttribute, type NftContent, type NftLink, type NftMedia, type NftMediaRef, type NftMetadata, type NftMintJournalEntry, type NftSignatureContext, type NftSignatureStatus, type NftView, type OpOutcome, type OutcomeClass, type PaymentRequestStatus, type PaymentRequestView, PaymentsFacade, type PaymentsFacadeDeps, type PaymentsRequestsApi, type PaymentsV2, type PaymentsV2Events, type PendingBurn, type PendingTransfer, type PlannedOp, type RecipientInfo, type RetryableAckError, STORE_KEYS, type ScopedKV, type SendCoinlessRequest, type SendRequest, type SendWholeTokenRequest, type SettlingLink, type ShortfallEntry, type StoragePort, type StreamCursor, type StreamName, createScopedKV, encodeNftContent, isNftDocumentLink, isRetryableAckError, parseNftDocument, parseNftPayload, supportsDeterministicMint, sweepSupersededState, verifyNftLinkContent };
+export { ATTENTION_MINT_UNRESOLVED, ATTENTION_RECIPIENT_NETWORK_UNVERIFIED, ATTENTION_RESEED_REJECTED, type AckOutcome, type AckRequest, type ApplyDeltaResult, type BurnFailure, type BurnJournalEntry, type BurnRequest, type BurnResult, CUSTOM_MINT_MAX_PAYLOAD_BYTES, type CheckpointReseeder, type ConnectionStatus, type CustomMintJournalEntry, type DeliverOptions, type DeliveryJournalEntry, type DeliveryPort, type DeliveryReceipt, type DeterministicMintCapable, type FacadeClient, type FacadeSession, HEARTBEAT_CAP_MS, HEARTBEAT_SEED_MS, type HistoryEntry, type HistoryPage, type IncomingDelivery, type IntentBackstopEntry, type IntentPayload, type InventoryAsset, type InventoryItem, type InventoryPage, MAX_RESELECT, type MintCustomRequest, type MintJournalEntry, type MintNftRequest, type MintResult, NFT_DOCUMENT_MEDIA_TYPE, NFT_LINK_TAG, NFT_MAX_PAYLOAD_BYTES, NFT_MEDIA_TAG, NFT_METADATA_TAG, NFT_SIGNED_TAG, type NftAttribute, type NftContent, type NftLink, type NftMedia, type NftMediaRef, type NftMetadata, type NftMintJournalEntry, type NftSignatureContext, type NftSignatureStatus, type NftView, type OpOutcome, type OutcomeClass, type PaymentRequestStatus, type PaymentRequestView, PaymentsFacade, type PaymentsFacadeDeps, type PaymentsRequestsApi, type PaymentsV2, type PaymentsV2Events, type PendingBurn, type PendingTransfer, type PlannedOp, type RecipientInfo, type RetryableAckError, STORE_KEYS, type ScopedKV, type SendCoinlessRequest, type SendRequest, type SendWholeTokenRequest, type SettlingLink, type ShortfallEntry, type StoragePort, type StreamCursor, type StreamName, createScopedKV, encodeNftContent, isLiveBurn, isNftDocumentLink, isRetryableAckError, parseNftDocument, parseNftPayload, supportsDeterministicMint, sweepSupersededState, verifyNftLinkContent };

package/dist/modules/payments-v2/index.d.ts

@@ -1,5 +1,6 @@
 import { IMintJustificationVerifier } from '@unicitylabs/state-transition-sdk/lib/transaction/verification/IMintJustificationVerifier.js';
 import { Token as Token$1 } from '@unicitylabs/state-transition-sdk/lib/transaction/Token.js';
+import { ITokenIssuanceVerifier } from '@unicitylabs/state-transition-sdk/lib/transaction/verification/ITokenIssuanceVerifier.js';
 
 declare const NFT_METADATA_TAG = 39052n;
 declare const NFT_MEDIA_TAG = 39053n;
@@ -185,6 +186,22 @@ interface BurnParams {
     /** The recipient predicate is `BurnPredicate(sha256(reasonBytes))`; the bytes ride in the aux data. */
     readonly reasonBytes: Uint8Array;
 }
+/** The issuance rule of one token type, and the coins no other type may carry. */
+interface TokenIssuancePolicy extends ITokenIssuanceVerifier {
+    /** A token carrying one of these coins counts only when it is of this type and verified. */
+    readonly coinIds: readonly CoinId[];
+    /** Must change whenever the proofs this policy accepts change, a fix to its verification code included, so wallets check held tokens again. */
+    readonly revision?: string;
+}
+/** Mint-reason verifiers keyed by CBOR tag, registered at engine construction. */
+interface TokenPlugin {
+    /** Stable identifier for diagnostics, e.g. `'bridge:tron-usdt'`. */
+    readonly id: string;
+    /** Mint-reason verifiers to register; a duplicate tag across plugins is INVALID_CONFIG. */
+    readonly mintJustificationVerifiers?: readonly IMintJustificationVerifier[];
+    /** Issuance policies to register; a duplicate token type or coin across plugins is INVALID_CONFIG. */
+    readonly tokenIssuancePolicies?: readonly TokenIssuancePolicy[];
+}
 /** Plan an NFT mint (#785); `mintDataToken` then mints the plan. */
 interface BuildNftMintParams {
     /** The first owner's 33-byte compressed chain pubkey — the genesis recipient a signature binds. */
@@ -379,6 +396,8 @@ interface ITokenEngine {
      * read its bytes via `readTokenData`. (Used e.g. for on-chain invoice tokens.)
      */
     mintDataToken(params: MintDataTokenParams, options?: EngineOpOptions): Promise<SphereToken>;
+    /** Throws VALIDATION_ERROR when `mintDataToken` would refuse `params` before submitting, e.g. a reason tag no registered verifier handles. */
+    assertMintable(params: MintDataTokenParams): void;
     /** Plan an NFT mint: encode (and optionally sign as this engine's identity) the payload and derive its token id. No chain op. */
     buildNftMint(params: BuildNftMintParams): Promise<NftMintPlan>;
     /** Spend a token wholesale to a recipient pubkey; returns the recipient's finished token. */
@@ -450,6 +469,7 @@ interface FullIdentity extends Identity {
     readonly privateKey: string;
 }
 type TokenStatus = 'pending' | 'submitted' | 'confirmed' | 'transferring' | 'spent' | 'invalid';
+type Unverified = 'pending' | 'refused';
 interface Token {
     readonly id: string;
     readonly coinId: string;
@@ -476,6 +496,8 @@ interface Token {
      * send self-heals instead of wedging on a stale source.
      */
     suspectedSpent?: boolean;
+    /** Carries a coin an issuance policy claims without having passed that policy yet (`pending`) or at all (`refused`): shown, never spent. */
+    readonly unverified?: Unverified;
 }
 /**
  * A holding that names no coin (wallet-api#140) — an NFT. Deliberately NOT a
@@ -538,6 +560,8 @@ interface Asset {
     readonly fiatValueUsd: number | null;
     /** Total fiat value in EUR */
     readonly fiatValueEur: number | null;
+    /** Holds tokens of a claimed coin that have not passed its issuance policy yet (`pending`) or at all (`refused`): never spendable, never priced. */
+    readonly unverified?: Unverified;
 }
 type TransferStatus = 'pending' | 'submitted' | 'confirmed' | 'delivered' | 'completed' | 'failed';
 /**
@@ -574,6 +598,8 @@ interface IncomingTransfer {
     readonly tokens: Token[];
     /** Arrivals that name no coin (#777). Disjoint from `tokens`, never a zero Token. */
     readonly coinless?: CoinlessToken[];
+    /** Refused arrivals of a claimed coin under another type; never counted, and never in `tokens`. */
+    readonly unverifiedTokens?: Token[];
     readonly memo?: string;
     readonly receivedAt: number;
 }
@@ -634,6 +660,7 @@ interface BurnResult {
     /** The burned blob, the proof of the burn: persist it, then `acknowledgeBurn(burnId)`. */
     burnedToken?: Uint8Array;
     error?: string;
+    errorCode?: string;
 }
 /** A burn not yet acknowledged: in flight (`burnedToken` null), certified, or settled. */
 interface PendingBurn {
@@ -643,6 +670,10 @@ interface PendingBurn {
     readonly burnedToken: Uint8Array | null;
     readonly settled: boolean;
     readonly createdAt: number;
+    readonly failure?: {
+        readonly code: string;
+        readonly message: string;
+    };
 }
 /** #785: `content` uses ERC-721 field names; `sign` (default true) signs as creator with this wallet's chain key. */
 interface MintNftRequest {
@@ -730,9 +761,13 @@ interface PaymentsV2 {
     prewarmSend(request: SendRequest): Promise<void>;
     discardPrewarm(): void;
     assets(coinId?: string): Promise<Asset[]>;
+    unverifiedAssets(coinId?: string): Promise<Asset[]>;
     tokens(filter?: {
         coinId?: string;
     }): Token[];
+    unverifiedTokens(filter?: {
+        coinId?: string;
+    }): Token[];
     coinless(): CoinlessToken[];
     tokenData(tokenId: string): Promise<Uint8Array | null>;
     /** The genesis mint reason of one held token; null when it was minted without one. Same contract as tokenData. */
@@ -821,6 +856,7 @@ interface StoragePort {
             tokenId: string;
             key: string;
         }[];
+        externalDelivery?: boolean;
     }): Promise<ApplyDeltaResult>;
 }
 interface DeliveryReceipt {
@@ -1046,7 +1082,13 @@ interface BurnJournalEntry {
         amount: string;
     }[];
     createdAt: number;
+    failure?: BurnFailure;
+}
+interface BurnFailure {
+    code: string;
+    message: string;
 }
+declare function isLiveBurn(entry: BurnJournalEntry): boolean;
 interface ShortfallEntry {
     transferId: string;
     remainingAmount: string;
@@ -1080,6 +1122,7 @@ declare const STORE_KEYS: {
     readonly epochLatch: "epoch-latch";
     readonly suspectedSpent: "suspected-spent";
     readonly knownSpends: "known-spends";
+    readonly verifiedTokens: "verified-tokens";
 };
 
 interface HistoryWireAsset {
@@ -1115,6 +1158,9 @@ declare const ATTENTION_MINT_UNRESOLVED = "mint:unresolved";
 /** Genesis payload cap, NftSigned wrapper included: wallet-api refuses an oversize blob only after the mint certified. */
 declare const NFT_MAX_PAYLOAD_BYTES: number;
 
+/** Cap on `data` plus `justification`: wallet-api refuses an oversize blob only after the mint certified. */
+declare const CUSTOM_MINT_MAX_PAYLOAD_BYTES: number;
+
 interface IntentPayloadBase {
     v: 2;
     recipient: string;
@@ -1286,6 +1332,15 @@ declare class Requests implements PaymentsRequestsApi {
     private revertPayable;
 }
 
+declare class CoinClaims {
+    private readonly issuers;
+    private readonly policies;
+    static fromPlugins(plugins: readonly TokenPlugin[] | undefined): CoinClaims;
+    add(policy: TokenIssuancePolicy): void;
+    fingerprint(): string;
+    issuerOf(coinId: CoinId): string | null;
+}
+
 interface RegistryReader {
     getSymbol(coinId: string): string;
     getName(coinId: string): string;
@@ -1381,6 +1436,8 @@ interface PaymentsFacadeDeps {
     kv: ScopedKV;
     registry: RegistryReader;
     price?: PriceReader;
+    /** Coins that count only in verified tokens of their issuing type (TokenPlugin issuance policies). */
+    claims?: CoinClaims;
     emit: (event: string, payload: unknown) => void;
     resolveRecipient: (identifier: string) => Promise<RecipientInfo | null>;
     signComplete: (transferId: string) => Promise<string>;
@@ -1410,6 +1467,7 @@ declare class PaymentsFacade implements PaymentsV2 {
     private readonly wakeRefresh;
     private readonly prewarmed;
     private readonly view;
+    private readonly verdicts;
     private readonly ledger;
     private readonly queue;
     private readonly machine;
@@ -1435,6 +1493,7 @@ declare class PaymentsFacade implements PaymentsV2 {
     private readonly activeMoneyOps;
     /** #737: the ledger holds exactly the sources of the still-open intents. */
     private readonly pins;
+    private readonly burnHold;
     /** Per facade, so per address: an NFT reading is never served to another wallet. */
     private readonly nftCache;
     constructor(deps: PaymentsFacadeDeps);
@@ -1445,9 +1504,14 @@ declare class PaymentsFacade implements PaymentsV2 {
      *  DISPOSED here, so one mid-`verify()` is cancelled — MODULE_DESTROYED, #770(4). */
     setEngine(next: ITokenEngine): void;
     assets(coinId?: string): Promise<Asset[]>;
+    unverifiedAssets: (coinId?: string) => Promise<Asset[]>;
+    private heldAssets;
     tokens(filter?: {
         coinId?: string;
     }): Token[];
+    unverifiedTokens: (filter?: {
+        coinId?: string;
+    }) => Token[];
     coinless(): CoinlessToken[];
     tokenData(tokenId: string): Promise<Uint8Array | null>;
     tokenJustification(tokenId: string): Promise<Uint8Array | null>;
@@ -1527,7 +1591,6 @@ declare class PaymentsFacade implements PaymentsV2 {
     private ownedOp;
     private engine;
     private newId;
-    private seedHeldStates;
     private track;
     private trackTail;
 }
@@ -1535,4 +1598,4 @@ declare class PaymentsFacade implements PaymentsV2 {
 declare const HEARTBEAT_SEED_MS = 5000;
 declare const HEARTBEAT_CAP_MS = 120000;
 
-export { ATTENTION_MINT_UNRESOLVED, ATTENTION_RECIPIENT_NETWORK_UNVERIFIED, ATTENTION_RESEED_REJECTED, type AckOutcome, type AckRequest, type ApplyDeltaResult, type BurnJournalEntry, type BurnRequest, type BurnResult, type CheckpointReseeder, type ConnectionStatus, type CustomMintJournalEntry, type DeliverOptions, type DeliveryJournalEntry, type DeliveryPort, type DeliveryReceipt, type DeterministicMintCapable, type FacadeClient, type FacadeSession, HEARTBEAT_CAP_MS, HEARTBEAT_SEED_MS, type HistoryEntry, type HistoryPage, type IncomingDelivery, type IntentBackstopEntry, type IntentPayload, type InventoryAsset, type InventoryItem, type InventoryPage, MAX_RESELECT, type MintCustomRequest, type MintJournalEntry, type MintNftRequest, type MintResult, NFT_DOCUMENT_MEDIA_TYPE, NFT_LINK_TAG, NFT_MAX_PAYLOAD_BYTES, NFT_MEDIA_TAG, NFT_METADATA_TAG, NFT_SIGNED_TAG, type NftAttribute, type NftContent, type NftLink, type NftMedia, type NftMediaRef, type NftMetadata, type NftMintJournalEntry, type NftSignatureContext, type NftSignatureStatus, type NftView, type OpOutcome, type OutcomeClass, type PaymentRequestStatus, type PaymentRequestView, PaymentsFacade, type PaymentsFacadeDeps, type PaymentsRequestsApi, type PaymentsV2, type PaymentsV2Events, type PendingBurn, type PendingTransfer, type PlannedOp, type RecipientInfo, type RetryableAckError, STORE_KEYS, type ScopedKV, type SendCoinlessRequest, type SendRequest, type SendWholeTokenRequest, type SettlingLink, type ShortfallEntry, type StoragePort, type StreamCursor, type StreamName, createScopedKV, encodeNftContent, isNftDocumentLink, isRetryableAckError, parseNftDocument, parseNftPayload, supportsDeterministicMint, sweepSupersededState, verifyNftLinkContent };
+export { ATTENTION_MINT_UNRESOLVED, ATTENTION_RECIPIENT_NETWORK_UNVERIFIED, ATTENTION_RESEED_REJECTED, type AckOutcome, type AckRequest, type ApplyDeltaResult, type BurnFailure, type BurnJournalEntry, type BurnRequest, type BurnResult, CUSTOM_MINT_MAX_PAYLOAD_BYTES, type CheckpointReseeder, type ConnectionStatus, type CustomMintJournalEntry, type DeliverOptions, type DeliveryJournalEntry, type DeliveryPort, type DeliveryReceipt, type DeterministicMintCapable, type FacadeClient, type FacadeSession, HEARTBEAT_CAP_MS, HEARTBEAT_SEED_MS, type HistoryEntry, type HistoryPage, type IncomingDelivery, type IntentBackstopEntry, type IntentPayload, type InventoryAsset, type InventoryItem, type InventoryPage, MAX_RESELECT, type MintCustomRequest, type MintJournalEntry, type MintNftRequest, type MintResult, NFT_DOCUMENT_MEDIA_TYPE, NFT_LINK_TAG, NFT_MAX_PAYLOAD_BYTES, NFT_MEDIA_TAG, NFT_METADATA_TAG, NFT_SIGNED_TAG, type NftAttribute, type NftContent, type NftLink, type NftMedia, type NftMediaRef, type NftMetadata, type NftMintJournalEntry, type NftSignatureContext, type NftSignatureStatus, type NftView, type OpOutcome, type OutcomeClass, type PaymentRequestStatus, type PaymentRequestView, PaymentsFacade, type PaymentsFacadeDeps, type PaymentsRequestsApi, type PaymentsV2, type PaymentsV2Events, type PendingBurn, type PendingTransfer, type PlannedOp, type RecipientInfo, type RetryableAckError, STORE_KEYS, type ScopedKV, type SendCoinlessRequest, type SendRequest, type SendWholeTokenRequest, type SettlingLink, type ShortfallEntry, type StoragePort, type StreamCursor, type StreamName, createScopedKV, encodeNftContent, isLiveBurn, isNftDocumentLink, isRetryableAckError, parseNftDocument, parseNftPayload, supportsDeterministicMint, sweepSupersededState, verifyNftLinkContent };