tapimo 0.7.1 → 0.7.2

package/dist/internal/funding/Transfer.d.ts

@@ -0,0 +1,643 @@
+import * as z from 'zod/mini';
+import type * as Db from '../../db/Db.js';
+import * as FundingTransfers from '../../db/tables/fundingTransfers.js';
+import * as Action from './Action.js';
+import * as Provider from './Provider.js';
+/** Public funding transfer statuses, in the order documented by the API. */
+export declare const statuses: readonly ['awaiting-source', 'processing', 'refunding', 'completed', 'refunded', 'action-required', 'expired'];
+/** Lifecycle status of a funding transfer. */
+export type Status = (typeof statuses)[number];
+/** Statuses that never change again after verified chain evidence. */
+export declare const terminalStatuses: readonly ["completed", "expired", "refunded"];
+/** Funding methods a caller can select at creation. */
+export declare const methods: readonly ['depositAddress', 'transaction'];
+/** Funding method selected at creation. */
+export type Method = (typeof methods)[number];
+/** Amount modes a caller can select at creation. */
+export declare const modes: readonly ['exactDestination', 'exactSource'];
+/** Amount mode selected at creation. */
+export type Mode = (typeof modes)[number];
+/** Customer-safe codes explaining an `action-required` or refund outcome. */
+export declare const statusReasonCodes: readonly ['destination_amount_below_minimum', 'destination_recovered', 'manual_recovery_required', 'refund_failed', 'source_amount_above_maximum', 'source_amount_below_minimum', 'source_chain_mismatch', 'source_token_mismatch'];
+/** Stable customer-safe status reason code. */
+export type StatusReasonCode = (typeof statusReasonCodes)[number];
+/** Returns whether a status is terminal. */
+export declare function isTerminal(status: Status): boolean;
+/** Returns whether the lifecycle allows moving from one status to another. */
+export declare function canTransition(from: Status, to: Status): boolean;
+/** Generates a funding transfer id (`ftr_…`, lexically time-ordered). */
+export declare function generateId(now?: Date): string;
+/** Zod schemas owned by the funding transfer resource. */
+export declare namespace schema {
+    /** Funding transfer lifecycle status. */
+    const Status: z.ZodMiniEnum<{
+        "action-required": "action-required";
+        "awaiting-source": "awaiting-source";
+        completed: "completed";
+        expired: "expired";
+        processing: "processing";
+        refunded: "refunded";
+        refunding: "refunding";
+    }>;
+    /** Customer-safe explanation of a status that needs context. */
+    const StatusReason: z.ZodMiniObject<{
+        code: z.ZodMiniEnum<{
+            destination_amount_below_minimum: "destination_amount_below_minimum";
+            destination_recovered: "destination_recovered";
+            manual_recovery_required: "manual_recovery_required";
+            refund_failed: "refund_failed";
+            source_amount_above_maximum: "source_amount_above_maximum";
+            source_amount_below_minimum: "source_amount_below_minimum";
+            source_chain_mismatch: "source_chain_mismatch";
+            source_token_mismatch: "source_token_mismatch";
+        }>;
+        message: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    /** Funding method selected at creation. */
+    const Method: z.ZodMiniEnum<{
+        depositAddress: "depositAddress";
+        transaction: "transaction";
+    }>;
+    /** Amount mode selected at creation. */
+    const Mode: z.ZodMiniEnum<{
+        exactDestination: "exactDestination";
+        exactSource: "exactSource";
+    }>;
+    /** One fee applied to the transfer. */
+    const Fee: z.ZodMiniObject<{
+        amount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        side: z.ZodMiniEnum<{
+            destination: "destination";
+            source: "source";
+        }>;
+        token: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        type: z.ZodMiniEnum<{
+            provider: "provider";
+        }>;
+    }, z.core.$strip>;
+    /** Freshness and validity window of the selected quote. */
+    const Quote: z.ZodMiniObject<{
+        expiresAt: z.ZodMiniString<string>;
+        sampledAt: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    /**
+     * The stored public snapshot: every transfer field except lifecycle columns
+     * (`id`, `status`, `statusReason`, `version`, `createdAt`, `updatedAt`),
+     * which live in typed columns and merge in at serialization.
+     */
+    const Snapshot: z.ZodMiniObject<{
+        destinationAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationAmountMin: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        destinationToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        destinationTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        fees: z.ZodMiniArray<z.ZodMiniObject<{
+            amount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+            side: z.ZodMiniEnum<{
+                destination: "destination";
+                source: "source";
+            }>;
+            token: z.ZodMiniObject<{
+                address: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                name: z.ZodMiniString<string>;
+                standard: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                tokenKey: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+            type: z.ZodMiniEnum<{
+                provider: "provider";
+            }>;
+        }, z.core.$strip>>;
+        method: z.ZodMiniEnum<{
+            depositAddress: "depositAddress";
+            transaction: "transaction";
+        }>;
+        mode: z.ZodMiniEnum<{
+            exactDestination: "exactDestination";
+            exactSource: "exactSource";
+        }>;
+        provider: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        quote: z.ZodMiniObject<{
+            expiresAt: z.ZodMiniString<string>;
+            sampledAt: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        recipient: z.ZodMiniString<string>;
+        refundAddress: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        refundAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        refundTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        sender: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        sourceAmount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceAmountMax: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        sourceChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        sourceTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    }, z.core.$strip>;
+    /** A funding transfer as returned by reads. Reads never include `action`. */
+    const FundingTransfer: z.ZodMiniObject<{
+        createdAt: z.ZodMiniString<string>;
+        destinationAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationAmountMin: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        destinationToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        destinationTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        fees: z.ZodMiniArray<z.ZodMiniObject<{
+            amount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+            side: z.ZodMiniEnum<{
+                destination: "destination";
+                source: "source";
+            }>;
+            token: z.ZodMiniObject<{
+                address: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                name: z.ZodMiniString<string>;
+                standard: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                tokenKey: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+            type: z.ZodMiniEnum<{
+                provider: "provider";
+            }>;
+        }, z.core.$strip>>;
+        id: z.ZodMiniString<string>;
+        method: z.ZodMiniEnum<{
+            depositAddress: "depositAddress";
+            transaction: "transaction";
+        }>;
+        mode: z.ZodMiniEnum<{
+            exactDestination: "exactDestination";
+            exactSource: "exactSource";
+        }>;
+        provider: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        quote: z.ZodMiniObject<{
+            expiresAt: z.ZodMiniString<string>;
+            sampledAt: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        recipient: z.ZodMiniString<string>;
+        refundAddress: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        refundAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        refundTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        sender: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        sourceAmount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceAmountMax: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        sourceChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        sourceTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        status: z.ZodMiniEnum<{
+            "action-required": "action-required";
+            "awaiting-source": "awaiting-source";
+            completed: "completed";
+            expired: "expired";
+            processing: "processing";
+            refunded: "refunded";
+            refunding: "refunding";
+        }>;
+        statusReason: z.ZodMiniOptional<z.ZodMiniObject<{
+            code: z.ZodMiniEnum<{
+                destination_amount_below_minimum: "destination_amount_below_minimum";
+                destination_recovered: "destination_recovered";
+                manual_recovery_required: "manual_recovery_required";
+                refund_failed: "refund_failed";
+                source_amount_above_maximum: "source_amount_above_maximum";
+                source_amount_below_minimum: "source_amount_below_minimum";
+                source_chain_mismatch: "source_chain_mismatch";
+                source_token_mismatch: "source_token_mismatch";
+            }>;
+            message: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        updatedAt: z.ZodMiniString<string>;
+        version: z.ZodMiniNumber<number>;
+    }, z.core.$strip>;
+    /** A created funding transfer: the read shape plus the executable action. */
+    const CreatedFundingTransfer: z.ZodMiniObject<{
+        createdAt: z.ZodMiniString<string>;
+        destinationAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationAmountMin: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        destinationChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        destinationToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        destinationTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        fees: z.ZodMiniArray<z.ZodMiniObject<{
+            amount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+            side: z.ZodMiniEnum<{
+                destination: "destination";
+                source: "source";
+            }>;
+            token: z.ZodMiniObject<{
+                address: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                name: z.ZodMiniString<string>;
+                standard: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                tokenKey: z.ZodMiniString<string>;
+                verified: z.ZodMiniBoolean<boolean>;
+            }, z.core.$strip>;
+            type: z.ZodMiniEnum<{
+                provider: "provider";
+            }>;
+        }, z.core.$strip>>;
+        id: z.ZodMiniString<string>;
+        method: z.ZodMiniEnum<{
+            depositAddress: "depositAddress";
+            transaction: "transaction";
+        }>;
+        mode: z.ZodMiniEnum<{
+            exactDestination: "exactDestination";
+            exactSource: "exactSource";
+        }>;
+        provider: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        quote: z.ZodMiniObject<{
+            expiresAt: z.ZodMiniString<string>;
+            sampledAt: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        recipient: z.ZodMiniString<string>;
+        refundAddress: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        refundAmount: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        refundTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        sender: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        sourceAmount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceAmountMax: z.ZodMiniOptional<z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        sourceChain: z.ZodMiniObject<{
+            addressFormat: z.ZodMiniEnum<{
+                base58: "base58";
+                base58check: "base58check";
+                hex: "hex";
+            }>;
+            id: z.ZodMiniString<string>;
+            kind: z.ZodMiniEnum<{
+                evm: "evm";
+                solana: "solana";
+                tron: "tron";
+            }>;
+            name: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        sourceToken: z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniString<string>;
+            standard: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            tokenKey: z.ZodMiniString<string>;
+            verified: z.ZodMiniBoolean<boolean>;
+        }, z.core.$strip>;
+        sourceTransactionHashes: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        status: z.ZodMiniEnum<{
+            "action-required": "action-required";
+            "awaiting-source": "awaiting-source";
+            completed: "completed";
+            expired: "expired";
+            processing: "processing";
+            refunded: "refunded";
+            refunding: "refunding";
+        }>;
+        statusReason: z.ZodMiniOptional<z.ZodMiniObject<{
+            code: z.ZodMiniEnum<{
+                destination_amount_below_minimum: "destination_amount_below_minimum";
+                destination_recovered: "destination_recovered";
+                manual_recovery_required: "manual_recovery_required";
+                refund_failed: "refund_failed";
+                source_amount_above_maximum: "source_amount_above_maximum";
+                source_amount_below_minimum: "source_amount_below_minimum";
+                source_chain_mismatch: "source_chain_mismatch";
+                source_token_mismatch: "source_token_mismatch";
+            }>;
+            message: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
+        updatedAt: z.ZodMiniString<string>;
+        version: z.ZodMiniNumber<number>;
+        action: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+            calls: z.ZodMiniArray<z.ZodMiniObject<{
+                data: z.ZodMiniString<string>;
+                to: z.ZodMiniString<string>;
+                value: z.ZodMiniString<string>;
+            }, z.core.$strip>>;
+            type: z.ZodMiniLiteral<"evm:calls">;
+        }, z.core.$strip>], "type">;
+    }, z.core.$strip>;
+    /** Request body accepted by funding transfer creation. */
+    const CreateRequest: z.ZodMiniObject<{
+        amount: z.ZodMiniString<string>;
+        destinationToken: z.ZodMiniString<string>;
+        mode: z.ZodMiniEnum<{
+            exactDestination: "exactDestination";
+            exactSource: "exactSource";
+        }>;
+        recipient: z.ZodMiniString<string>;
+        sender: z.ZodMiniString<string>;
+        slippageBps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        sourceChain: z.ZodMiniString<string>;
+        sourceToken: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}
+/** Stored public snapshot of a funding transfer (see {@link schema.Snapshot}). */
+export type Snapshot = z.output<typeof schema.Snapshot>;
+/** Customer-safe status reason (see {@link schema.StatusReason}). */
+export type StatusReason = z.output<typeof schema.StatusReason>;
+/** A funding transfer as returned by reads (see {@link schema.FundingTransfer}). */
+export type Public = z.output<typeof schema.FundingTransfer>;
+/** A created funding transfer (see {@link schema.CreatedFundingTransfer}). */
+export type Created = z.output<typeof schema.CreatedFundingTransfer>;
+/** A validated creation request (see {@link schema.CreateRequest}). */
+export type CreateRequest = z.output<typeof schema.CreateRequest>;
+/** What an associated transaction reference evidences. */
+export declare const transactionRoles: readonly ['destination', 'refund', 'source'];
+/** Role of a verified transaction reference on a transfer. */
+export type TransactionRole = (typeof transactionRoles)[number];
+/**
+ * Creates a durable funding transfer: the row plus its version-1 event commit
+ * in one transaction, so every stored version has an immutable public record.
+ */
+export declare function create(db: Db.Db, input: create.Input): Promise<FundingTransfers.Record>;
+/**
+ * Creates the transfer row and its version-1 event inside the caller's
+ * transaction, for writes that must commit atomically with sibling state
+ * (idempotency completion).
+ */
+export declare function createIn(tx: Db.Db, input: create.Input): Promise<FundingTransfers.Record>;
+export declare namespace create {
+    /** Fields required to create a funding transfer. */
+    type Input = {
+        /** API key that created the transfer. */
+        apiKeyId: string;
+        /** Key environment the transfer belongs to. */
+        environment: 'production' | 'sandbox';
+        /** Transfer id override for deterministic tests. */
+        id?: string | undefined;
+        /** Owning organization id (`org_…`). */
+        orgId: string;
+        /** Attributed project id, when the creating key is project-attributed. */
+        projectId?: string | undefined;
+        /** Private provider correlation retained for reconciliation. */
+        providerState?: Provider.prepareTransfer.Correlation | undefined;
+        /** The public snapshot captured from the selected quote. */
+        snapshot: Snapshot;
+    };
+}
+/**
+ * Applies a version-guarded material change: a status transition, a snapshot
+ * update, or both. The row update and its immutable event commit in one
+ * transaction; a stale `expectedVersion` or disallowed transition applies
+ * nothing, so concurrent observations cannot overwrite newer evidence.
+ */
+export declare function transition(db: Db.Db, options: transition.Options): Promise<transition.Result>;
+export declare namespace transition {
+    /** Fields describing a material change to apply. */
+    type Options = {
+        /** The version the change was computed against. */
+        expectedVersion: number;
+        /** Transfer id (`ftr_…`). */
+        id: string;
+        /** Replacement public snapshot; omitted keeps the stored snapshot. */
+        snapshot?: Snapshot | undefined;
+        /** New status; omitted keeps the current status (snapshot-only change). */
+        status?: Status | undefined;
+        /** Customer-safe reason attached to the new status. */
+        statusReason?: StatusReason | undefined;
+    };
+    /** Outcome of a guarded transition. */
+    type Result = {
+        record: FundingTransfers.Record;
+        type: 'applied';
+    } | {
+        current: FundingTransfers.Record;
+        type: 'invalid';
+    } | {
+        current: FundingTransfers.Record;
+        type: 'stale';
+    } | {
+        type: 'not_found';
+    };
+}
+/** Serializes a created row with its one-time executable action. */
+export declare function toCreated(record: FundingTransfers.Record, action: Action.Action): Created;
+/** Serializes a stored row to the public read shape. Never includes actions. */
+export declare function toPublic(record: FundingTransfers.Record): Public;
+//# sourceMappingURL=Transfer.d.ts.map

package/dist/internal/funding/Transfer.d.ts.map

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