{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "sweep-wallet", "title": "Sweep Wallet", "author": "Satchmo ", "description": "Sweep assets from a WIF private key into the connected wallet. Scans for funding UTXOs, ordinals, and BSV-21 tokens, previews found assets, and sweeps with progress.", "dependencies": [ "lucide-react" ], "registryDependencies": [ "badge", "button", "card", "input", "label", "separator", "skeleton" ], "files": [ { "path": "registry/new-york/blocks/sweep-wallet/index.tsx", "content": "\"use client\"\n\nimport { SweepWalletUi, type SweepWalletUiProps } from \"./sweep-wallet-ui\"\nimport {\n useSweepWallet,\n type ScanResult,\n type SweepResult,\n type UseSweepWalletOptions,\n type UseSweepWalletReturn,\n} from \"./use-sweep-wallet\"\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport { SweepWalletUi, type SweepWalletUiProps } from \"./sweep-wallet-ui\"\nexport {\n useSweepWallet,\n type ScanResult,\n type SweepResult,\n type SweepStep,\n type SweepFundingUtxo,\n type SweepOrdinalUtxo,\n type SweepTokenGroup,\n type UseSweepWalletOptions,\n type UseSweepWalletReturn,\n} from \"./use-sweep-wallet\"\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Props for the composed SweepWallet block */\nexport interface SweepWalletProps {\n /** Scan a WIF for spendable assets */\n onScan: (wif: string) => Promise\n /** Execute the sweep transaction */\n onSweep: (wif: string, assets: ScanResult) => Promise\n /** Callback after a successful sweep */\n onSuccess?: (result: SweepResult) => void\n /** Callback on any error */\n onError?: (error: Error) => void\n /** Optional CSS class */\n className?: string\n}\n\n// ---------------------------------------------------------------------------\n// Composed component\n// ---------------------------------------------------------------------------\n\n/**\n * Full sweep-wallet block: WIF input, scan, preview, sweep, and success/error states.\n *\n * Wires `useSweepWallet` (logic) into `SweepWalletUi` (presentation).\n * The caller provides `onScan` and `onSweep` callbacks that integrate with\n * `@1sat/actions` sweep utilities.\n *\n * @example\n * ```tsx\n * import { SweepWallet } from \"@/components/blocks/sweep-wallet\"\n *\n * {\n * const pk = PrivateKey.fromWif(wif)\n * const address = pk.toPublicKey().toAddress()\n * return await scanAddressUtxos(services, address)\n * }}\n * onSweep={async (wif, assets) => {\n * const inputs = await prepareSweepInputs(ctx, assets.funding)\n * return await sweepBsv.execute(ctx, { inputs, wif })\n * }}\n * />\n * ```\n */\nexport function SweepWallet({\n onScan,\n onSweep,\n onSuccess,\n onError,\n className,\n}: SweepWalletProps) {\n const hook = useSweepWallet({ onScan, onSweep, onSuccess, onError })\n\n return (\n \n )\n}\n", "type": "registry:block", "target": "~/components/blocks/sweep-wallet/index.tsx" }, { "path": "registry/new-york/blocks/sweep-wallet/sweep-wallet-ui.tsx", "content": "\"use client\"\n\nimport {\n AlertCircle,\n CheckCircle2,\n ClipboardPaste,\n Coins,\n ImageIcon,\n KeyRound,\n Loader2,\n RotateCcw,\n Search,\n Wallet,\n} from \"lucide-react\"\nimport { Badge } from \"@/components/ui/badge\"\nimport { Button } from \"@/components/ui/button\"\nimport {\n Card,\n CardContent,\n CardDescription,\n CardFooter,\n CardHeader,\n CardTitle,\n} from \"@/components/ui/card\"\nimport { Input } from \"@/components/ui/input\"\nimport { Label } from \"@/components/ui/label\"\nimport { Separator } from \"@/components/ui/separator\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport { cn } from \"@/lib/utils\"\nimport type {\n ScanResult,\n SweepResult,\n SweepStep,\n} from \"./use-sweep-wallet\"\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface SweepWalletUiProps {\n /** Current workflow step */\n step: SweepStep\n /** Current WIF input value */\n wifInput: string\n /** Update the WIF input */\n onWifInputChange: (value: string) => void\n /** Whether the WIF looks valid */\n isWifValid: boolean\n /** Scanned assets */\n scanResult: ScanResult | null\n /** Sweep result */\n sweepResult: SweepResult | null\n /** Error message */\n error: string | null\n /** Whether an async operation is in flight */\n isLoading: boolean\n /** Initiate scan */\n onScan: () => void\n /** Initiate sweep */\n onSweep: () => void\n /** Reset to input step */\n onReset: () => void\n /** Optional CSS class */\n className?: string\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst SATS_PER_BSV = 100_000_000\n\nfunction formatSats(sats: number): string {\n if (sats >= SATS_PER_BSV) {\n return `${(sats / SATS_PER_BSV).toFixed(8)} BSV`\n }\n return `${sats.toLocaleString()} sats`\n}\n\n// ---------------------------------------------------------------------------\n// Sub-components\n// ---------------------------------------------------------------------------\n\nfunction ScanningState() {\n return (\n
\n \n
\n

Scanning for assets...

\n

\n Checking funding UTXOs, ordinals, and tokens\n

\n
\n
\n \n \n \n
\n
\n )\n}\n\nfunction AssetPreview({ scanResult }: { scanResult: ScanResult }) {\n const { funding, ordinals, tokens, totalSats } = scanResult\n const fundingCount = funding.length\n const ordinalCount = ordinals.length\n const tokenCount = tokens.length\n\n return (\n
\n

Found Assets

\n\n {/* Funding */}\n {fundingCount > 0 && (\n
\n
\n \n BSV\n
\n
\n {formatSats(totalSats)}\n \n {fundingCount} UTXO{fundingCount !== 1 ? \"s\" : \"\"}\n \n
\n
\n )}\n\n {/* Ordinals */}\n {ordinalCount > 0 && (\n
\n
\n \n Ordinals\n
\n \n {ordinalCount} item{ordinalCount !== 1 ? \"s\" : \"\"}\n \n
\n )}\n\n {/* Tokens */}\n {tokens.map((token) => (\n \n
\n \n {token.symbol ?? \"Token\"}\n
\n {token.amount}\n
\n ))}\n\n {fundingCount === 0 && ordinalCount === 0 && tokenCount === 0 && (\n

\n No assets found\n

\n )}\n \n )\n}\n\nfunction SweepingState() {\n return (\n
\n \n
\n

Sweeping assets...

\n

\n Building and broadcasting transactions\n

\n
\n
\n )\n}\n\nfunction SuccessState({\n sweepResult,\n onReset,\n}: {\n sweepResult: SweepResult\n onReset: () => void\n}) {\n return (\n
\n
\n \n
\n

Sweep complete

\n {sweepResult.txid && (\n \n {sweepResult.txid}\n \n )}\n
\n
\n \n
\n )\n}\n\nfunction ErrorState({\n error,\n onReset,\n}: {\n error: string\n onReset: () => void\n}) {\n return (\n
\n
\n \n
\n

Sweep failed

\n

{error}

\n
\n
\n \n
\n )\n}\n\n// ---------------------------------------------------------------------------\n// Main UI\n// ---------------------------------------------------------------------------\n\n/**\n * Pure presentation component for the sweep-wallet block.\n *\n * Renders a Card with WIF input, scan/preview, sweep progress, and\n * success/error states. Never imports SDK packages.\n */\nexport function SweepWalletUi({\n step,\n wifInput,\n onWifInputChange,\n isWifValid,\n scanResult,\n sweepResult,\n error,\n isLoading,\n onScan,\n onSweep,\n onReset,\n className,\n}: SweepWalletUiProps) {\n const handlePaste = async () => {\n if (typeof navigator !== \"undefined\" && navigator.clipboard) {\n try {\n const text = await navigator.clipboard.readText()\n onWifInputChange(text.trim())\n } catch {\n // Clipboard permission denied -- user can paste manually\n }\n }\n }\n\n return (\n \n \n \n \n Sweep Wallet\n \n \n Import assets from a WIF private key into your connected wallet.\n \n \n\n \n {/* WIF input -- visible in input & preview steps */}\n {(step === \"input\" || step === \"preview\") && (\n
\n \n
\n onWifInputChange(e.target.value)}\n disabled={isLoading || step === \"preview\"}\n className=\"flex-1 font-mono text-sm\"\n autoComplete=\"off\"\n spellCheck={false}\n />\n {step === \"input\" && (\n { void handlePaste() }}\n disabled={isLoading}\n aria-label=\"Paste from clipboard\"\n >\n \n \n )}\n
\n {wifInput.length > 0 && !isWifValid && (\n

\n Invalid WIF format\n

\n )}\n
\n )}\n\n {/* Scanning skeleton */}\n {step === \"scanning\" && }\n\n {/* Asset preview */}\n {step === \"preview\" && scanResult && (\n <>\n \n \n \n )}\n\n {/* Sweeping progress */}\n {step === \"sweeping\" && }\n\n {/* Success */}\n {step === \"done\" && sweepResult && (\n \n )}\n\n {/* Error */}\n {step === \"error\" && error && (\n \n )}\n \n\n {/* Footer actions for input & preview steps */}\n {(step === \"input\" || step === \"preview\") && (\n \n {step === \"input\" && (\n \n \n Scan for Assets\n \n )}\n {step === \"preview\" && (\n
\n \n \n Sweep All\n \n \n Cancel\n \n
\n )}\n \n )}\n \n )\n}\n", "type": "registry:component", "target": "~/components/blocks/sweep-wallet/sweep-wallet-ui.tsx" }, { "path": "registry/new-york/blocks/sweep-wallet/use-sweep-wallet.ts", "content": "import { useCallback, useMemo, useState } from \"react\"\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A funding UTXO found during scan */\nexport interface SweepFundingUtxo {\n /** Outpoint in txid_vout format */\n outpoint: string\n /** Satoshis held by this output */\n satoshis: number\n}\n\n/** An ordinal UTXO found during scan */\nexport interface SweepOrdinalUtxo {\n /** Outpoint in txid_vout format */\n outpoint: string\n}\n\n/** A group of BSV-21 token UTXOs */\nexport interface SweepTokenGroup {\n /** Token ID in txid_vout format */\n tokenId: string\n /** Human-readable symbol (e.g. \"GOLD\") */\n symbol?: string\n /** Total token amount as string (bigint serialization) */\n amount: string\n}\n\n/** Categorized assets discovered by scanning a WIF/address */\nexport interface ScanResult {\n /** Standard funding UTXOs */\n funding: SweepFundingUtxo[]\n /** 1Sat ordinal UTXOs */\n ordinals: SweepOrdinalUtxo[]\n /** BSV-21 token groups */\n tokens: SweepTokenGroup[]\n /** Total satoshis across all funding UTXOs */\n totalSats: number\n}\n\n/** Result from a sweep operation */\nexport interface SweepResult {\n /** Transaction ID on success */\n txid?: string\n /** Error message on failure */\n error?: string\n}\n\n/** Step in the sweep workflow */\nexport type SweepStep = \"input\" | \"scanning\" | \"preview\" | \"sweeping\" | \"done\" | \"error\"\n\n/** Options for the useSweepWallet hook */\nexport interface UseSweepWalletOptions {\n /** Scan a WIF for spendable assets. Called with the raw WIF string. */\n onScan: (wif: string) => Promise\n /** Execute the sweep transaction. Called with WIF and the scan result. */\n onSweep: (wif: string, assets: ScanResult) => Promise\n /** Callback after a successful sweep */\n onSuccess?: (result: SweepResult) => void\n /** Callback on any error (scan or sweep) */\n onError?: (error: Error) => void\n}\n\n/** Return value of the useSweepWallet hook */\nexport interface UseSweepWalletReturn {\n /** Current step in the workflow */\n step: SweepStep\n /** Current WIF input value */\n wifInput: string\n /** Update the WIF input */\n setWifInput: (value: string) => void\n /** Whether the WIF input looks valid (base58check, 51-52 chars) */\n isWifValid: boolean\n /** Scanned assets (available after successful scan) */\n scanResult: ScanResult | null\n /** Sweep result (available after successful sweep) */\n sweepResult: SweepResult | null\n /** Current error message */\n error: string | null\n /** Whether any async operation is in flight */\n isLoading: boolean\n /** Initiate scanning */\n handleScan: () => Promise\n /** Initiate sweeping */\n handleSweep: () => Promise\n /** Reset back to input step */\n handleReset: () => void\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** WIF is base58check, typically 51 chars (uncompressed) or 52 chars (compressed) */\nconst WIF_PATTERN = /^[5KL][1-9A-HJ-NP-Za-km-z]{50,51}$/\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Manages the sweep-wallet workflow: WIF input -> scan -> preview -> sweep -> done.\n *\n * Pure logic hook. Does not import any UI or SDK packages. The caller provides\n * `onScan` and `onSweep` callbacks that wire into `@1sat/actions`.\n */\nexport function useSweepWallet({\n onScan,\n onSweep,\n onSuccess,\n onError,\n}: UseSweepWalletOptions): UseSweepWalletReturn {\n const [step, setStep] = useState(\"input\")\n const [wifInput, setWifInput] = useState(\"\")\n const [scanResult, setScanResult] = useState(null)\n const [sweepResult, setSweepResult] = useState(null)\n const [error, setError] = useState(null)\n\n const isWifValid = useMemo(() => WIF_PATTERN.test(wifInput.trim()), [wifInput])\n\n const isLoading = step === \"scanning\" || step === \"sweeping\"\n\n const handleScan = useCallback(async () => {\n const trimmed = wifInput.trim()\n if (!WIF_PATTERN.test(trimmed)) return\n\n setStep(\"scanning\")\n setError(null)\n setScanResult(null)\n setSweepResult(null)\n\n try {\n const result = await onScan(trimmed)\n setScanResult(result)\n\n const hasAssets =\n result.funding.length > 0 ||\n result.ordinals.length > 0 ||\n result.tokens.length > 0\n\n if (hasAssets) {\n setStep(\"preview\")\n } else {\n setError(\"No assets found for this key\")\n setStep(\"error\")\n }\n } catch (err) {\n const e = err instanceof Error ? err : new Error(String(err))\n setError(e.message)\n setStep(\"error\")\n onError?.(e)\n }\n }, [wifInput, onScan, onError])\n\n const handleSweep = useCallback(async () => {\n if (!scanResult) return\n const trimmed = wifInput.trim()\n if (!WIF_PATTERN.test(trimmed)) return\n\n setStep(\"sweeping\")\n setError(null)\n\n try {\n const result = await onSweep(trimmed, scanResult)\n\n if (result.error) {\n setError(result.error)\n setStep(\"error\")\n onError?.(new Error(result.error))\n } else {\n setSweepResult(result)\n setStep(\"done\")\n onSuccess?.(result)\n }\n } catch (err) {\n const e = err instanceof Error ? err : new Error(String(err))\n setError(e.message)\n setStep(\"error\")\n onError?.(e)\n }\n }, [wifInput, scanResult, onSweep, onSuccess, onError])\n\n const handleReset = useCallback(() => {\n setStep(\"input\")\n setWifInput(\"\")\n setScanResult(null)\n setSweepResult(null)\n setError(null)\n }, [])\n\n return {\n step,\n wifInput,\n setWifInput,\n isWifValid,\n scanResult,\n sweepResult,\n error,\n isLoading,\n handleScan,\n handleSweep,\n handleReset,\n }\n}\n", "type": "registry:component", "target": "~/components/blocks/sweep-wallet/use-sweep-wallet.ts" } ], "type": "registry:block" }