@vera-pay/sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,772 @@
+import { ethers } from 'ethers';
+
+interface Plan {
+    planId: bigint;
+    merchant: string;
+    paymentToken: string;
+    amount: bigint;
+    interval: bigint;
+    name: string;
+    metadataURI: string;
+    active: boolean;
+}
+interface Subscription {
+    subscriptionId: bigint;
+    planId: bigint;
+    subscriber: string;
+    startTime: bigint;
+    lastPaymentTime: bigint;
+    paymentsCount: bigint;
+    active: boolean;
+}
+interface PaymentReceipt {
+    subscriptionId: string;
+    planId: string;
+    subscriber: string;
+    merchant: string;
+    amount: string;
+    protocolFee: string;
+    timestamp: number;
+    txHash: string;
+    blockNumber: number;
+    chainId: number;
+    ipfsCid?: string;
+}
+interface CreatePlanParams {
+    paymentToken: string;
+    amount: bigint;
+    interval: bigint;
+    name: string;
+    metadataURI?: string;
+}
+interface VeraPayConfig {
+    contractAddress: string;
+    rpcUrl?: string;
+    chainId?: number;
+    ipfsGateway?: string;
+}
+type NetworkName = "flow-testnet" | "flow-mainnet";
+interface NetworkConfig {
+    chainId: number;
+    rpcUrl: string;
+    blockExplorer: string;
+    evmBlockExplorer: string;
+    name: string;
+}
+
+interface IPFSAdapter {
+    uploadJson(data: unknown): Promise<string>;
+    fetchJson<T = unknown>(cid: string): Promise<T>;
+}
+/**
+ * Minimal adapter that talks to a Kubo-compatible IPFS HTTP API
+ * (e.g. `http://localhost:5001`).
+ */
+declare function createKuboAdapter(apiUrl: string): IPFSAdapter;
+interface StorachaConfig {
+    key: string;
+    proof: string;
+}
+/**
+ * Creates an IPFS adapter backed by Storacha (formerly web3.storage).
+ *
+ * Accepts either a pre-built client (anything with `uploadFile`) or a
+ * `{ key, proof }` config. When config is provided, the Storacha client
+ * is lazily initialized on first upload using a memory store + Ed25519
+ * principal — no interactive auth or email prompts.
+ *
+ * Setup (one-time, via Storacha CLI):
+ * ```bash
+ * storacha key create --json          # → { "did": "...", "key": "MgCa..." }
+ * storacha delegation create <did> \
+ *   -c space/blob/add -c space/index/add \
+ *   -c filecoin/offer -c upload/add --base64   # → mAYIEAP8...
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * import { createStorachaAdapter } from "@verapay/sdk";
+ *
+ * const ipfs = createStorachaAdapter({
+ *   key: process.env.STORACHA_KEY!,
+ *   proof: process.env.STORACHA_PROOF!,
+ * });
+ * ```
+ */
+declare function createStorachaAdapter(clientOrConfig: {
+    uploadFile: (file: Blob) => Promise<{
+        toString(): string;
+    }>;
+} | StorachaConfig): IPFSAdapter;
+/**
+ * In-memory adapter useful for tests and demos where no real IPFS node is available.
+ */
+declare function createMemoryAdapter(): IPFSAdapter;
+declare function buildPaymentReceipt(event: {
+    subscriptionId: bigint;
+    planId: bigint;
+    subscriber: string;
+    merchant: string;
+    amount: bigint;
+    protocolFee: bigint;
+    timestamp: bigint;
+}, txHash: string, blockNumber: number, chainId: number): PaymentReceipt;
+declare function ipfsGatewayUrl(cid: string): string;
+
+declare class VeraPayClient {
+    readonly contract: ethers.Contract;
+    readonly provider: ethers.Provider;
+    readonly config: VeraPayConfig;
+    private signer?;
+    private ipfs?;
+    constructor(config: VeraPayConfig, signerOrProvider: ethers.Signer | ethers.Provider, ipfsAdapter?: IPFSAdapter);
+    /**
+     * Convenience factory that auto-configures for a known Flow network.
+     */
+    static fromNetwork(network: NetworkName, contractAddress: string, signerOrProvider: ethers.Signer | ethers.Provider, ipfsAdapter?: IPFSAdapter): VeraPayClient;
+    createPlan(params: CreatePlanParams): Promise<{
+        planId: bigint;
+        tx: ethers.TransactionResponse;
+    }>;
+    togglePlan(planId: bigint): Promise<ethers.TransactionResponse>;
+    getMerchantPlans(merchant: string): Promise<bigint[]>;
+    /**
+     * Approve the VeraPay contract to pull `amount` of the given ERC-20 token,
+     * then subscribe to the plan. Returns subscription ID and the payment receipt
+     * (optionally pinned to IPFS).
+     */
+    subscribeWithApproval(planId: bigint, options?: {
+        approveMax?: boolean;
+    }): Promise<{
+        subscriptionId: bigint;
+        receipt: PaymentReceipt;
+        tx: ethers.TransactionResponse;
+    }>;
+    subscribe(planId: bigint): Promise<{
+        subscriptionId: bigint;
+        receipt: PaymentReceipt;
+        tx: ethers.TransactionResponse;
+    }>;
+    cancelSubscription(subscriptionId: bigint): Promise<ethers.TransactionResponse>;
+    getSubscriberSubscriptions(subscriber: string): Promise<bigint[]>;
+    processPayment(subscriptionId: bigint): Promise<{
+        receipt: PaymentReceipt;
+        tx: ethers.TransactionResponse;
+    }>;
+    batchProcessPayments(subscriptionIds: bigint[]): Promise<ethers.TransactionResponse>;
+    isPaymentDue(subscriptionId: bigint): Promise<boolean>;
+    getDuePayments(subscriptionIds: bigint[]): Promise<bigint[]>;
+    /**
+     * Start a polling loop that checks for due payments and processes them.
+     * Returns a cleanup function to stop the loop.
+     */
+    startKeeper(subscriptionIds: bigint[], intervalMs?: number, onPayment?: (receipt: PaymentReceipt) => void, onError?: (err: unknown) => void): () => void;
+    getNextPlanId(): Promise<bigint>;
+    getNextSubscriptionId(): Promise<bigint>;
+    listActivePlans(): Promise<Plan[]>;
+    getPlan(planId: bigint): Promise<Plan>;
+    getSubscription(subscriptionId: bigint): Promise<Subscription>;
+    getProtocolFeeBps(): Promise<bigint>;
+    get hasIPFS(): boolean;
+    get contractAddress(): string;
+    /**
+     * Pin a payment receipt to IPFS and return the CID.
+     */
+    pinReceipt(receipt: PaymentReceipt): Promise<string>;
+    fetchReceipt(cid: string): Promise<PaymentReceipt>;
+    setIPFSAdapter(adapter: IPFSAdapter): void;
+    onPaymentProcessed(callback: (receipt: PaymentReceipt) => void, filter?: {
+        subscriptionId?: bigint;
+        planId?: bigint;
+        subscriber?: string;
+    }): ethers.Contract;
+    removeAllListeners(): void;
+    private requireSigner;
+    private extractPaymentReceipt;
+}
+
+declare const VERA_PAY_ABI: readonly [{
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_feeRecipient";
+        readonly type: "address";
+    }, {
+        readonly name: "_feeBps";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createPlan";
+    readonly inputs: readonly [{
+        readonly name: "_paymentToken";
+        readonly type: "address";
+    }, {
+        readonly name: "_amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "_interval";
+        readonly type: "uint256";
+    }, {
+        readonly name: "_name";
+        readonly type: "string";
+    }, {
+        readonly name: "_metadataURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "planId";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "togglePlan";
+    readonly inputs: readonly [{
+        readonly name: "_planId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "subscribe";
+    readonly inputs: readonly [{
+        readonly name: "_planId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "subId";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "cancelSubscription";
+    readonly inputs: readonly [{
+        readonly name: "_subId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "processPayment";
+    readonly inputs: readonly [{
+        readonly name: "_subId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "batchProcessPayments";
+    readonly inputs: readonly [{
+        readonly name: "_subIds";
+        readonly type: "uint256[]";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getPlan";
+    readonly inputs: readonly [{
+        readonly name: "_planId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "merchant";
+            readonly type: "address";
+        }, {
+            readonly name: "paymentToken";
+            readonly type: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "interval";
+            readonly type: "uint256";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+        }, {
+            readonly name: "metadataURI";
+            readonly type: "string";
+        }, {
+            readonly name: "active";
+            readonly type: "bool";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getSubscription";
+    readonly inputs: readonly [{
+        readonly name: "_subId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "planId";
+            readonly type: "uint256";
+        }, {
+            readonly name: "subscriber";
+            readonly type: "address";
+        }, {
+            readonly name: "startTime";
+            readonly type: "uint256";
+        }, {
+            readonly name: "lastPaymentTime";
+            readonly type: "uint256";
+        }, {
+            readonly name: "paymentsCount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "active";
+            readonly type: "bool";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getMerchantPlans";
+    readonly inputs: readonly [{
+        readonly name: "_merchant";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getSubscriberSubscriptions";
+    readonly inputs: readonly [{
+        readonly name: "_subscriber";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isPaymentDue";
+    readonly inputs: readonly [{
+        readonly name: "_subId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getDuePayments";
+    readonly inputs: readonly [{
+        readonly name: "_subIds";
+        readonly type: "uint256[]";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "due";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nextPlanId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nextSubscriptionId";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "protocolFeeBps";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "activeSub";
+    readonly inputs: readonly [{
+        readonly name: "planId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "subscriber";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "subId";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "PlanCreated";
+    readonly inputs: readonly [{
+        readonly name: "planId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "merchant";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "paymentToken";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "interval";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "name";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadataURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PlanToggled";
+    readonly inputs: readonly [{
+        readonly name: "planId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "active";
+        readonly type: "bool";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Subscribed";
+    readonly inputs: readonly [{
+        readonly name: "subscriptionId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "planId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "subscriber";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PaymentProcessed";
+    readonly inputs: readonly [{
+        readonly name: "subscriptionId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "planId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "subscriber";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "merchant";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "protocolFee";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "timestamp";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "SubscriptionCancelled";
+    readonly inputs: readonly [{
+        readonly name: "subscriptionId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "subscriber";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+    readonly anonymous: false;
+}];
+declare const ERC20_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "mint";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+
+declare const NETWORKS: Record<NetworkName, NetworkConfig>;
+declare const DEPLOYED_CONTRACTS: Record<string, string>;
+declare const KNOWN_TOKENS: Record<string, Record<string, string>>;
+declare const CADENCE_HANDLERS: Record<string, string>;
+declare const DEFAULT_IPFS_GATEWAY = "https://storacha.link/ipfs";
+
+interface SchedulerConfig {
+    network: "testnet" | "mainnet";
+    /** Cadence address where VeraPayScheduledPaymentHandler is deployed (without 0x prefix) */
+    handlerAddress: string;
+    /** The VeraPay EVM contract address (with 0x prefix) for handler initialization */
+    evmContractAddress: string;
+    /** Optional IPFS adapter for pinning payment receipts */
+    ipfsAdapter?: IPFSAdapter;
+}
+interface SchedulePaymentParams {
+    subscriptionId: string;
+    /** Seconds from now until execution. Use "0.0" for immediate. */
+    delaySeconds: string;
+    /** 0 = High, 1 = Medium, 2 = Low */
+    priority: number;
+    /** Compute units for the scheduled tx (minimum 10) */
+    executionEffort: number;
+}
+/**
+ * FlowScheduler provides a JS/browser interface to schedule and cancel
+ * VeraPay subscription payments using Flow's native scheduled transactions.
+ *
+ * It uses FCL (Flow Client Library) which handles wallet authentication
+ * through Flow's wallet discovery (Blocto, Lilico, etc.).
+ *
+ * Usage:
+ * ```ts
+ * import { FlowScheduler } from "@verapay/sdk";
+ *
+ * const scheduler = new FlowScheduler({
+ *   network: "testnet",
+ *   handlerAddress: "7c0bf27829276c6b",
+ * });
+ *
+ * // Authenticate with a Flow wallet
+ * await scheduler.authenticate();
+ *
+ * // Schedule a payment for subscription #1 in 1 hour
+ * const txId = await scheduler.schedulePayment({
+ *   subscriptionId: "1",
+ *   delaySeconds: "3600.0",
+ *   priority: 1,        // Medium
+ *   executionEffort: 1000,
+ * });
+ *
+ * // Wait for execution
+ * await scheduler.waitForTransaction(txId);
+ * ```
+ */
+interface SubscribeAndScheduleResult {
+    flowTxId: string;
+    /** The ID of the scheduled future transaction (from FlowTransactionScheduler) */
+    scheduledTxId?: string;
+    receipt?: PaymentReceipt;
+    ipfsCid?: string;
+}
+declare class FlowScheduler {
+    readonly config: SchedulerConfig;
+    private configured;
+    private ipfs?;
+    constructor(config: SchedulerConfig);
+    get hasIPFS(): boolean;
+    setIPFSAdapter(adapter: IPFSAdapter): void;
+    private ensureConfigured;
+    /** Trigger FCL wallet authentication (Blocto, Lilico, etc.) */
+    authenticate(): Promise<{
+        addr: string;
+    }>;
+    /** Disconnect the current wallet */
+    unauthenticate(): Promise<void>;
+    /** Get the currently authenticated Flow address, or null */
+    currentUser(): Promise<string | null>;
+    /**
+     * Create a Cadence Owned Account (COA) and fund it with FLOW for EVM gas.
+     * Idempotent — skips if COA already exists. Must be called before initHandler.
+     * Returns the Flow transaction ID.
+     */
+    setupCOA(fundAmount?: string): Promise<string>;
+    /**
+     * Initialize the VeraPay scheduled payment handler on the connected account.
+     * Idempotent — skips if already initialized. Requires a COA (call setupCOA first).
+     * Returns the Flow transaction ID.
+     */
+    initHandler(): Promise<string>;
+    /**
+     * Convenience method: runs setupCOA + initHandler in sequence.
+     * Both are idempotent so it's safe to call on every session.
+     */
+    setup(fundAmount?: string): Promise<{
+        coaTxId: string;
+        handlerTxId: string;
+    }>;
+    /**
+     * Schedule a subscription payment to be executed at a future time.
+     * The connected Flow wallet pays the scheduling fees.
+     * Returns the Flow transaction ID.
+     */
+    schedulePayment(params: SchedulePaymentParams): Promise<string>;
+    /**
+     * Cancel a previously scheduled payment and receive a partial fee refund.
+     * Returns the Flow transaction ID.
+     */
+    cancelScheduledPayment(scheduledTransactionId: string): Promise<string>;
+    /**
+     * Make the COA approve an EVM spender (e.g., VeraPay) to transfer ERC20 tokens.
+     * This is required before the scheduled payment can pull tokens from the COA.
+     * Returns the Flow transaction ID.
+     */
+    approveERC20(tokenAddress: string, amount?: string): Promise<string>;
+    /**
+     * Subscribe the COA to a VeraPay plan AND schedule the next recurring payment
+     * in a single Cadence transaction.
+     *
+     * 1. COA calls subscribe(planId) on the EVM contract (first payment is charged immediately)
+     * 2. Decodes the returned subscription ID from the EVM call
+     * 3. Schedules the next payment via FlowTransactionScheduler with the plan's interval as delay
+     *
+     * If an IPFS adapter is configured, the payment receipt is automatically
+     * pinned after the transaction seals.
+     *
+     * Returns the Flow tx ID, and optionally the receipt + IPFS CID.
+     */
+    subscribeAndSchedule(params: {
+        planId: number | string;
+        intervalSeconds: string;
+        priority?: number;
+        executionEffort?: number;
+    }): Promise<SubscribeAndScheduleResult>;
+    /**
+     * Subscribe the COA to a VeraPay plan via an EVM call (without scheduling).
+     * The COA must have already approved the VeraPay contract to spend its tokens.
+     * Returns the Flow transaction ID.
+     */
+    subscribeToPlan(planId: number | string): Promise<string>;
+    /**
+     * Query the COA's EVM address for a given Flow account.
+     * Returns the hex EVM address (0x...) or null if no COA exists.
+     */
+    getCoaEvmAddress(flowAddress?: string): Promise<string | null>;
+    /** Wait for a Flow transaction to be sealed. Returns the transaction result with events. */
+    waitForTransaction(txId: string): Promise<{
+        status: number;
+        events: Array<{
+            type: string;
+            data: Record<string, unknown>;
+        }>;
+    }>;
+    /**
+     * Extract the scheduled transaction ID from sealed tx events.
+     * Looks for the FlowTransactionScheduler.TransactionScheduled event.
+     */
+    static extractScheduledTxId(events: Array<{
+        type: string;
+        data: Record<string, unknown>;
+    }>): string | undefined;
+}
+
+export { CADENCE_HANDLERS, type CreatePlanParams, DEFAULT_IPFS_GATEWAY, DEPLOYED_CONTRACTS, ERC20_ABI, FlowScheduler, type IPFSAdapter, KNOWN_TOKENS, NETWORKS, type NetworkConfig, type NetworkName, type PaymentReceipt, type Plan, type SchedulePaymentParams, type SchedulerConfig, type StorachaConfig, type SubscribeAndScheduleResult, type Subscription, VERA_PAY_ABI, VeraPayClient, type VeraPayConfig, buildPaymentReceipt, createKuboAdapter, createMemoryAdapter, createStorachaAdapter, ipfsGatewayUrl };