@spicenet-io/spiceflow-ui 4.15.2 → 4.16.0-rc.1

package/README.md

@@ -90,7 +90,7 @@ host-configured RPC. Keep private credentials out of browser bundles.
 - Use controller recovery for uncertain funding and `retryFinalization()` for failed
   application updates after settlement. Preserve original host terms across reload.
 - Deposit and rollup Withdraw retain distinct execution semantics while sharing
-  inventory/policy. Account wallet withdrawal uses the fee-only Supply path.
+  inventory/policy. Account wallet withdrawal uses the inclusive Supply controller and its fee hierarchy.
 
 Inventory isolation does not establish support for simultaneous differently configured
 providers: underlying quote/execution transports still have global state.
@@ -277,6 +277,18 @@ callbacks are unchanged.
 `initialSourceAssetId` selects a current balance by ID; it does not supply a
 cached balance or change the receipt's supported withdrawal routes.
 
+Native `SpiceWithdraw` actions save a pending submission for the current relayer,
+network and wallet before sending it. Reopening the modal after a timeout or
+reload shows **Check or resume withdrawal**; it looks up the original submission
+and continues its unfinished steps without another signature or source transfer.
+The pending record also shows a copyable submission key and action ID for support.
+A missing lookup result or unresolved action keeps a new withdrawal blocked,
+because the original submission may still arrive. The relayer must support
+idempotent `POST /actions`, submission lookup, and the action recovery status
+endpoint for this flow. Browser storage and Web Locks must be available before
+the native action can start. A host-provided non-7702 `onWithdrawExecute` remains
+the host's execution and recovery responsibility.
+
 ### Funding sources
 
 Supply, Pay and Lock list every balance that can fund the action: the embedded wallet
@@ -309,7 +321,7 @@ a failed application callback after the external action has confirmed.
 - Routed Supply, Pay and Lock actions must surface fee estimation before enabling submission.
 - Eligible direct external actions still require an accepted plan but charge no Spicenet fee. Network gas remains payable in the external wallet; native Max reserves gas.
 - Deposit gas and rollup withdrawal semantics remain distinct from action intent fees. Preserve their existing quote/readiness requirements.
-- Account wallet withdrawal is a fee-only Supply action. Do not bypass its fee/readiness gates based on the label "withdraw".
+- Account wallet withdrawal uses the shared input-inclusive Supply controller and its fee-only planner for local fees. Do not bypass its fee/readiness gates based on the label "withdraw".
 - Custom actions use the shared controller's `canExecute`; an available balance or old quote alone is insufficient.
 - `onSubmit` on `SpiceSupply`, `SpiceLock`, `SpiceDeposit` and the shared controller fires once when the user submits and the SDK accepts it, before any wallet prompt. Use it for "transaction in progress" feedback instead of listening for clicks on SDK buttons.
 - `max()` on the shared controller (`useSpiceSupply`, `useSpiceLock`) resolves the fee-aware Max for the selected source, or `null` when there is none or the action fixes its output. The host sets the result as the amount.
@@ -411,7 +423,7 @@ during prewarming. The time available before typing determines how much work it
 - Declare `actionInput` for every token the action consumes and honour the amount passed to `buildActionCalls`: when fees come from an input, the action is built for the remainder. Declare `actionProceeds` for a token the action leaves in the wallet. Both are optional; with neither, only balances can pay. Omit `actionProceeds` when the output is delivered to another owner.
 - `feeFunding` overrides the level order per transaction, for example `["proceeds", "input", "balance"]`; the order inside the balance level is fixed. An empty list leaves the choice to the host's `selectedAsset`.
 - A `selectedAsset` on a fee-only action is an explicit host choice and funds the fee from that balance as before.
-- Account wallet withdrawals use this hierarchy automatically and display the chosen fee asset without a selector. The exact withdrawal amount is reserved before ranking balances; only its remainder can pay fees. Custom `useSpiceSupply` actions that must preserve an exact principal can declare `feeFundingReserve: { asset, amount }` instead of offering that principal as `actionInput`.
+- Account wallet withdrawals use this hierarchy automatically and display the chosen fee asset without a selector. Entered amounts and Max are total source-token budgets; applicable fees reduce the net received amount. Same-chain transfers retain the selected token. Choosing another supported chain routes through USDC escrow and delivers registered USDC, with the net output shown before submission. Withdraw discovers permitted embedded balances by default alongside escrow balances; `walletAssets` optionally supplies extra token metadata or an initial wallet selection. Custom `useSpiceSupply` actions that must preserve an exact principal can declare `feeFundingReserve: { asset, amount }` instead of offering that principal as `actionInput`.
 - `feeOnlyAction` alone declares the action: `amountDirection` defaults to `"output"` and `paymentAmount` to `"0"`. Explicit values still win.
 - `submit()` on the controller runs the executor that matches `amountDirection`. `submitSupply()` and `submitPay()` remain for existing callers.
 

package/dist/auth-privy.cjs.js

@@ -1,3 +1,3 @@
 "use client";
 (function(){if(typeof document==="undefined"||document.getElementById("spiceflow-styles"))return;var s=document.createElement("style");s.id="spiceflow-styles";s.textContent="@keyframes spiceflow-spin{0%{transform:rotate(0deg)}to{transform:rotate(1turn)}}@keyframes spin{0%{transform:rotate(0deg)}to{transform:rotate(1turn)}}@media (prefers-reduced-motion:reduce){*,:after,:before{animation-duration:.001ms!important;animation-iteration-count:1!important;scroll-behavior:auto!important;transition-duration:.001ms!important}}.spiceflow-focus-ring:focus-visible,[data-spiceflow-focus]:focus-visible{border-radius:4px;outline:2px solid currentColor;outline-offset:2px}@media (forced-colors:active){.spiceflow-focus-ring:focus-visible,[data-spiceflow-focus]:focus-visible{outline:2px solid Highlight}}.ibm-plex-mono-thin{font-weight:100}.ibm-plex-mono-extralight,.ibm-plex-mono-thin{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-extralight{font-weight:200}.ibm-plex-mono-light{font-weight:300}.ibm-plex-mono-light,.ibm-plex-mono-regular{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-regular{font-weight:400}.ibm-plex-mono-medium{font-weight:500}.ibm-plex-mono-medium,.ibm-plex-mono-semibold{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-semibold{font-weight:600}.ibm-plex-mono-bold{font-family:IBM Plex Mono,monospace!important;font-style:normal;font-weight:700}#privy-modal-content button{border-radius:6px;font-family:IBM Plex Mono,monospace!important;font-size:small;letter-spacing:-.5px;text-transform:uppercase}#privy-modal-content input{background:#fff;border-radius:6px;padding-top:5px!important}#privy-dialog-title{display:none!important;font-size:18px;padding-bottom:10px;padding-top:10px}.AppLogoContainer-sc-a206bd44-0{display:none}#privy-modal-content{background:var(--Neutral-0,#fafafa);border:6px solid var(--Neutral-1,#e9e9e9);box-shadow:inset 0 0 0 1px rgba(0,0,0,.15),0 330px 92px transparent,0 211px 84px rgba(0,0,0,.01),0 119px 71px rgba(0,0,0,.05),0 53px 53px rgba(0,0,0,.09),0 13px 29px rgba(0,0,0,.1);height:auto!important;padding-bottom:10px}.Subtitle-sc-ddbf22b4-4{font-size:12px;margin-top:-14px;opacity:.5}.StyledLink-sc-1c6127e5-0{background:none!important}.StyledLink-sc-c8577138-0,.login-method-button{font-family:IBM Plex Mono,monospace!important}.StyledLink-sc-c8577138-0{font-style:uppercase}#protected-by-privy{color:#000!important}";document.head.appendChild(s)})();
-"use strict";const r=require("./privy-CTb9WM_S.js");require("react/jsx-runtime"),require("react"),require("@spicenet-io/spiceflow-core"),require("@tanstack/react-query"),require("viem"),require("@privy-io/react-auth"),require("wagmi"),require("viem/actions"),exports.PrivyLogin=r.PrivyLogin;
+"use strict";const r=require("./privy-NjNrRvlu.js");require("react/jsx-runtime"),require("react"),require("@spicenet-io/spiceflow-core"),require("@tanstack/react-query"),require("viem"),require("@privy-io/react-auth"),require("wagmi"),require("viem/actions"),exports.PrivyLogin=r.PrivyLogin;

package/dist/auth-privy.js

@@ -1,3 +1,3 @@
 "use client";
 (function(){if(typeof document==="undefined"||document.getElementById("spiceflow-styles"))return;var s=document.createElement("style");s.id="spiceflow-styles";s.textContent="@keyframes spiceflow-spin{0%{transform:rotate(0deg)}to{transform:rotate(1turn)}}@keyframes spin{0%{transform:rotate(0deg)}to{transform:rotate(1turn)}}@media (prefers-reduced-motion:reduce){*,:after,:before{animation-duration:.001ms!important;animation-iteration-count:1!important;scroll-behavior:auto!important;transition-duration:.001ms!important}}.spiceflow-focus-ring:focus-visible,[data-spiceflow-focus]:focus-visible{border-radius:4px;outline:2px solid currentColor;outline-offset:2px}@media (forced-colors:active){.spiceflow-focus-ring:focus-visible,[data-spiceflow-focus]:focus-visible{outline:2px solid Highlight}}.ibm-plex-mono-thin{font-weight:100}.ibm-plex-mono-extralight,.ibm-plex-mono-thin{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-extralight{font-weight:200}.ibm-plex-mono-light{font-weight:300}.ibm-plex-mono-light,.ibm-plex-mono-regular{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-regular{font-weight:400}.ibm-plex-mono-medium{font-weight:500}.ibm-plex-mono-medium,.ibm-plex-mono-semibold{font-family:IBM Plex Mono,monospace!important;font-style:normal}.ibm-plex-mono-semibold{font-weight:600}.ibm-plex-mono-bold{font-family:IBM Plex Mono,monospace!important;font-style:normal;font-weight:700}#privy-modal-content button{border-radius:6px;font-family:IBM Plex Mono,monospace!important;font-size:small;letter-spacing:-.5px;text-transform:uppercase}#privy-modal-content input{background:#fff;border-radius:6px;padding-top:5px!important}#privy-dialog-title{display:none!important;font-size:18px;padding-bottom:10px;padding-top:10px}.AppLogoContainer-sc-a206bd44-0{display:none}#privy-modal-content{background:var(--Neutral-0,#fafafa);border:6px solid var(--Neutral-1,#e9e9e9);box-shadow:inset 0 0 0 1px rgba(0,0,0,.15),0 330px 92px transparent,0 211px 84px rgba(0,0,0,.01),0 119px 71px rgba(0,0,0,.05),0 53px 53px rgba(0,0,0,.09),0 13px 29px rgba(0,0,0,.1);height:auto!important;padding-bottom:10px}.Subtitle-sc-ddbf22b4-4{font-size:12px;margin-top:-14px;opacity:.5}.StyledLink-sc-1c6127e5-0{background:none!important}.StyledLink-sc-c8577138-0,.login-method-button{font-family:IBM Plex Mono,monospace!important}.StyledLink-sc-c8577138-0{font-style:uppercase}#protected-by-privy{color:#000!important}";document.head.appendChild(s)})();
-import{P as g}from"./privy-CbyTXV2C.js";import"react/jsx-runtime";import"react";import"@spicenet-io/spiceflow-core";import"@tanstack/react-query";import"viem";import"@privy-io/react-auth";import"wagmi";import"viem/actions";export{g as PrivyLogin};
+import{P as g}from"./privy-BVlSQ7nR.js";import"react/jsx-runtime";import"react";import"@spicenet-io/spiceflow-core";import"@tanstack/react-query";import"viem";import"@privy-io/react-auth";import"wagmi";import"viem/actions";export{g as PrivyLogin};

package/dist/components/SpiceSupply/lib/executors.d.ts

@@ -21,6 +21,7 @@ export type ExecutorContext = {
     isInsufficientBalance: boolean;
     isPayMode: boolean;
     isFeeInclusiveInput?: boolean;
+    quotedInclusivePlatformFee?: boolean;
     feeOnlyAction?: boolean;
     actionProceeds?: Exclude<SpiceSupplyProps["actionProceeds"], "output">;
     validateFeeQuote?: () => void;

package/dist/components/SpiceSupply/lib/feePreview.d.ts

@@ -22,6 +22,7 @@ export type SupplyFeeQuote = {
     proceedsAvailable?: bigint;
     proceedsUsed?: bigint;
     batches?: ChainBatch[];
+    feePricingBatches?: ChainBatch[];
     actionContext?: Partial<import("../../../types/supply").BuildActionCallsContext>;
     fundingAmount?: bigint;
     destinationSwap?: ResolvedSwap;
@@ -49,6 +50,15 @@ export declare function sizePivotSourceGasSkim(params: {
     signal?: AbortSignal;
 }): Promise<bigint>;
 export declare function retainQuotedFixedFees(estimate: FeeEstimateSummary, previous: FeeEstimateSummary): FeeEstimateSummary;
+export declare function estimateQuotedSupplyFees(params: {
+    estimate: EstimateFn;
+    batches: ChainBatch[];
+    pricingBatches: ChainBatch[];
+    tokenAddress: string;
+    fundingAmount: bigint;
+    options: ExecutionOptions;
+    signedEstimate?: FeeEstimateSummary;
+}): Promise<FeeEstimateSummary>;
 export declare function solveGrossFunding(fees: Pick<FeePreview, "grossAmount" | "gasFee" | "spicenetFee" | "bridgeFee">, requiredNetFunding: bigint): bigint;
 export declare function estimatePayFunding(args: {
     requiredNetFunding: bigint;
@@ -109,6 +119,7 @@ export interface FeePreviewContext {
     selectedAsset: SelectedAsset | null;
     isPayMode: boolean;
     isFeeInclusiveInput?: boolean;
+    quotedInclusivePlatformFee?: boolean;
     parsedAmount: number;
     needsSwap: boolean;
     exactOutputSwap: ResolvedExactOutputSwap | null;
@@ -142,5 +153,5 @@ export declare class FeeShortfallError extends Error {
     readonly preview: FeePreview;
     constructor(preview: FeePreview);
 }
-export declare function supplyContextForFees(fees: FeePreview, amount: bigint, inclusive: boolean, mode: SpiceSupplyProps["feeExecutionMode"], reserveFee?: bigint): Required<Pick<import("../../../types/supply").BuildActionCallsContext, "grossAmount" | "netAmount" | "combinedFeeAmount" | "feeExecutionMode" | "feeBreakdown">>;
+export declare function supplyContextForFees(fees: FeePreview, amount: bigint, inclusive: boolean, mode: SpiceSupplyProps["feeExecutionMode"], reserveFee?: bigint, quotedInclusivePlatformFee?: boolean): Required<Pick<import("../../../types/supply").BuildActionCallsContext, "grossAmount" | "netAmount" | "combinedFeeAmount" | "feeExecutionMode" | "feeBreakdown">>;
 export {};

package/dist/components/SpiceWithdraw/lib/executors.d.ts

@@ -2,7 +2,7 @@ import type { Dispatch, MutableRefObject, SetStateAction } from "react";
 import type { ExecutionRunner } from "../../../execution/runner";
 import type { DestinationToken, SpiceWithdrawDeliveryTransfer, SpiceWithdrawProps } from "../../../types/withdraw";
 import type { ChainBatch } from "../../../types/authorization";
-import type { ExecutionProgress } from "../../../hooks/useSpiceExecution";
+import type { ExecutionOptions, ExecutionProgress } from "../../../hooks/useSpiceExecution";
 import type { FeeEstimateSummary } from "@spicenet-io/spiceflow-core";
 export type WithdrawalExecutionContext = {
     actionId: string;
@@ -31,6 +31,7 @@ export type WithdrawExecutorContext = {
     };
     executionContextRef: MutableRefObject<WithdrawalExecutionContext | null>;
     isMountedRef: MutableRefObject<boolean>;
+    withdrawalRecovery?: ExecutionOptions["withdrawalRecovery"];
 } & Pick<SpiceWithdrawProps, "onWithdrawExecute" | "onWithdrawSuccess" | "buildSpicenetBatch">;
 export declare function executeWithdraw(ctx: WithdrawExecutorContext): Promise<void>;
 export declare function retryWithdraw(ctx: WithdrawExecutorContext): Promise<void>;

package/dist/components/SpiceWithdraw/lib/pendingWithdrawal.d.ts

@@ -0,0 +1,41 @@
+import type { CreateActionResponse } from "@spicenet-io/spiceflow-core";
+export type WithdrawalScope = {
+    apiUrl: string;
+    network: string;
+    wallet: string;
+};
+export type WithdrawalDetails = {
+    source: "spice" | "embedded";
+    sourceAssetId: string;
+    sourceChainId: number;
+    sourceToken: string;
+    destinationChainId: number;
+    destinationToken: string;
+    recipient: string;
+    amount: string;
+    symbol: string;
+    callback?: {
+        amount: string;
+        symbol: string;
+    };
+};
+export type PendingWithdrawal = {
+    version: 1;
+    scope: WithdrawalScope;
+    details: WithdrawalDetails;
+    idempotencyKey: string;
+    phase: "submitting" | "active" | "completed" | "cancelled";
+    createdAt: number;
+    actionId?: string;
+    intentId?: string;
+    intentIndex?: number;
+    totalSteps?: number;
+    callbackSent?: boolean;
+};
+export declare function withdrawalStorageKey(scope: WithdrawalScope): string;
+export declare function readPendingWithdrawal(scope: WithdrawalScope): PendingWithdrawal | null;
+export declare function savePendingWithdrawal(record: PendingWithdrawal): void;
+export declare function clearRejectedSubmission(record: PendingWithdrawal): void;
+export declare function newSubmissionKey(): string;
+export declare function beginWithdrawal(scope: WithdrawalScope, details: WithdrawalDetails, totalSteps: number): PendingWithdrawal;
+export declare function recordWithdrawalAction(record: PendingWithdrawal, result: CreateActionResponse, totalSteps: number): PendingWithdrawal;

package/dist/components/SpiceWithdraw/lib/useEmbeddedWithdraw.d.ts

@@ -1,15 +1,23 @@
 import { type Address } from "viem";
+import type { ExecutionOptions } from "../../../hooks/useSpiceExecution";
 import type { Asset } from "../../../types/assets";
 import type { SpiceWithdrawProps } from "../../../types/withdraw";
 export declare function useSpiceEmbeddedWithdraw(params: {
     enabled: boolean;
     asset: Asset | null;
     amount: bigint;
+    destination?: {
+        address: Address;
+        symbol: string;
+        decimals: number;
+        chainId: number;
+    } | null;
     recipient?: Address;
     owner?: Address;
     sourceChains?: number[];
     onSuccess?: SpiceWithdrawProps["onWithdrawSuccess"];
     onError?: SpiceWithdrawProps["onWithdrawError"];
+    withdrawalRecovery?: ExecutionOptions["withdrawalRecovery"];
 }): {
     supply: {
         selectedAsset: import("../../..").SelectedAsset | null;
@@ -113,6 +121,6 @@ export declare function useSpiceEmbeddedWithdraw(params: {
         resetAfterSuccess: () => void;
         resetPaymentState: () => void;
     };
-    source: Asset | undefined;
+    source: Asset | null | undefined;
     maximumFeeFunding: bigint | null | undefined;
 };

package/dist/components/SpiceWithdraw/lib/useWithdrawalRecovery.d.ts

@@ -0,0 +1,25 @@
+import type { CreateActionResponse } from "@spicenet-io/spiceflow-core";
+import type { Address } from "viem";
+import type { SpiceWithdrawProps } from "../../../types/withdraw";
+import { type PendingWithdrawal, type WithdrawalDetails, type WithdrawalScope } from "./pendingWithdrawal";
+type Params = {
+    isOpen: boolean;
+    scope: WithdrawalScope | null;
+    details: WithdrawalDetails | null;
+    onSuccess?: SpiceWithdrawProps["onWithdrawSuccess"];
+};
+export declare function useWithdrawalRecovery(params: Params): {
+    record: PendingWithdrawal | null;
+    error: string | null;
+    busy: boolean;
+    completedByResume: string | null;
+    blocked: boolean;
+    executionOptions: {
+        submitAction: (user: Address, totalSteps: number, create: (idempotencyKey: string) => Promise<CreateActionResponse>) => Promise<CreateActionResponse>;
+        onActionComplete: (actionId: string) => Promise<void>;
+    };
+    pinDetails: (callback?: WithdrawalDetails["callback"]) => void;
+    onInitialSuccess: () => Promise<void>;
+    resume: () => Promise<void>;
+};
+export {};

package/dist/execution/pollIntentStep.d.ts

@@ -1,3 +1,4 @@
+import type { RelayerService } from "../utils/relayer";
 type StepResult = {
     status: string;
     transactionHash?: string;
@@ -16,6 +17,8 @@ type PollIntentStepOptions = {
     onStepUpdate?: (result: StepResult) => void;
     signal?: AbortSignal;
     chainId?: number;
+    startWithExecute?: boolean;
+    relayer?: Pick<RelayerService, "executeStep" | "checkStepStatus">;
 };
 export declare function pollIntentStepUntilSuccess(options: PollIntentStepOptions): Promise<string | undefined>;
 export declare function runAllIntentSteps(options: {

package/dist/hooks/useSpiceExecution.d.ts

@@ -1,4 +1,4 @@
-import type { FeeEstimateSummary } from "@spicenet-io/spiceflow-core";
+import type { CreateActionResponse, FeeEstimateSummary } from "@spicenet-io/spiceflow-core";
 import { Address } from "viem";
 import { Call, ChainBatch } from "../types/authorization";
 import { type ActionOutputCredit } from "../utils/actionOutputEscrowFunding";
@@ -42,6 +42,10 @@ export interface ExecutionOptions {
     submittedFeeEstimate?: FeeEstimateSummary;
     skipUserFundingPreflight?: boolean;
     validateFeeCalls?: boolean;
+    withdrawalRecovery?: {
+        submitAction: (user: Address, totalSteps: number, create: (idempotencyKey: string) => Promise<CreateActionResponse>) => Promise<CreateActionResponse>;
+        onActionComplete: (actionId: string) => Promise<void>;
+    };
     signal?: AbortSignal;
 }
 export declare function validateUserFundingCapacity(chainBatches: ChainBatch[], userAddress: Address, options?: Pick<ExecutionOptions, "walletFundingRequirement"> & {

package/dist/hooks/useSpiceSupply.d.ts

@@ -5,7 +5,9 @@ import { type FeePreviewContext } from "../components/SpiceSupply/lib/feePreview
 import type { Asset, SelectedAsset } from "../types/assets";
 import type { DestinationTokenDeclaration, SpiceSupplyProps } from "../types/supply";
 import type { FeePreview } from "../types/ui";
+import { type ExecutionOptions } from "./useSpiceExecution";
 export interface UseSpiceSupplyParams extends Pick<SpiceSupplyProps, "sourceChains" | "supportedSourceAssets" | "buildActionCalls" | "feeExecutionMode" | "buildSpicenetBatch" | "onPayExecute" | "resolveExactOutputSwap" | "amountDirection" | "onSubmit" | "onSuccess" | "onError" | "additionalSourceTokens" | "includeExternalWalletAssets" | "includeCrossChainEmbeddedAssets" | "feeOnlyAction" | "actionInput" | "actionProceeds" | "feeFunding" | "maxSlippage" | "resolveInputSwap"> {
+    quotedInclusivePlatformFee?: boolean;
     enabled?: boolean;
     destinationToken: DestinationTokenDeclaration | undefined;
     selectedAsset: SelectedAsset | null;
@@ -18,6 +20,7 @@ export interface UseSpiceSupplyParams extends Pick<SpiceSupplyProps, "sourceChai
     };
     prependSourceEscrow?: boolean;
     feeFundingReserve?: FeePreviewContext["feeFundingReserve"];
+    withdrawalRecovery?: ExecutionOptions["withdrawalRecovery"];
 }
 export declare function useSpiceSupply(params: UseSpiceSupplyParams): {
     selectedAsset: SelectedAsset | null;