tempwallet-sdk/dist/sweep.d.ts

Helpers for single-use (temporary) EVM flows: ephemeral EOAs, Safe builders, Permit2 signature skeleton, sweep & gas estimates. No infra included.

import type { TransactionRequest } from "ethers";
import type { SweepBuildInput } from "./types";
/**
 * Build a transaction that sweeps ALL available ETH from `fromAddress` to `to`.
 *
 * This function calculates the maximum amount that can be swept after accounting for gas costs.
 * Perfect for cleaning up temporary wallets after they've served their purpose.
 *
 * @param input - Sweep configuration
 * @param input.fromAddress - Source address to sweep from
 * @param input.to - Destination address to sweep to
 * @param input.providerUrl - RPC provider URL for balance checking
 * @param input.gasLimitBuffer - Optional buffer to reserve for gas costs (in wei)
 * @returns Promise resolving to a TransactionRequest ready for signing
 * @throws {NoBalanceToSweepError} If the source address has no balance
 * @throws {InsufficientAfterBufferError} If the balance is insufficient after gas buffer
 *
 * @example
 * ```typescript
 * // Build a sweep transaction from a temporary wallet
 * const sweepTx = await buildSweepTx({
 *   fromAddress: "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
 *   to: "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
 *   providerUrl: "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
 *   gasLimitBuffer: parseEther("0.001") // Reserve 0.001 ETH for gas
 * });
 *
 * // The transaction is ready to be signed and sent
 * console.log(`Sweeping ${formatEther(sweepTx.value!)} ETH`);
 * ```
 */
export declare function buildSweepTx(input: SweepBuildInput): Promise<TransactionRequest>;
/**
 * Sign & send a prepared sweep transaction using the provided private key.
 *
 * This is a convenience function for executing sweep transactions. You can also
 * use your own signer or wallet implementation.
 *
 * @param providerUrl - RPC provider URL for transaction submission
 * @param privateKey - Private key of the source address (without 0x prefix)
 * @param tx - Transaction request (typically from buildSweepTx)
 * @returns Promise resolving to the transaction hash
 * @throws {Error} If the transaction fails (network, insufficient funds, etc.)
 *
 * @example
 * ```typescript
 * // Build and send a sweep transaction
 * const sweepTx = await buildSweepTx({
 *   fromAddress: "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
 *   to: "0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6",
 *   providerUrl: "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
 * });
 *
 * const txHash = await sendSweepTx(
 *   "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
 *   "your-private-key-here",
 *   sweepTx
 * );
 *
 * console.log(`Sweep transaction sent: ${txHash}`);
 * ```
 *
 * @example
 * ```typescript
 * // Alternative: Use your own signer
 * const sweepTx = await buildSweepTx({...});
 * const provider = new JsonRpcProvider(providerUrl);
 * const signer = new Wallet(privateKey, provider);
 * const tx = await signer.sendTransaction(sweepTx);
 * ```
 */
export declare function sendSweepTx(providerUrl: string, privateKey: string, tx: TransactionRequest): Promise<string>;
//# sourceMappingURL=sweep.d.ts.map