@spicenet-io/spiceflow-ui 4.10.0-rc.0 → 4.10.0-rc.2

package/README.md

@@ -24,9 +24,13 @@ The example is a prerelease selection, not a stable recommendation or a policy b
 Reuse compatible host-owned Privy, wagmi and QueryClient providers. Read the exact
 package's peer dependencies; do not replace the wallet stack as part of a version bump.
 
+The SDK adds its stylesheet (spinner keyframes, focus ring, reduced-motion rule) to the
+page when it loads, so no CSS import is needed. `@spicenet-io/spiceflow-ui/styles.css`
+is still exported for a host whose Content Security Policy forbids inline styles;
+importing it as well is harmless.
+
 ```tsx
 import { SpiceFlowProvider } from "@spicenet-io/spiceflow-ui";
-import "@spicenet-io/spiceflow-ui/styles.css";
 
 // Inside the host's existing WagmiProvider → QueryClientProvider → PrivyProvider stack.
 <SpiceFlowProvider
@@ -40,17 +44,29 @@ import "@spicenet-io/spiceflow-ui/styles.css";
 ```
 
 Configure Privy credentials/policy on the host's `PrivyProvider`. Supply client RPCs
-for every enabled source, conversion and destination chain, and keep the SDK/wallet
-chain sets aligned. Wallet-library transports alone do not configure SDK reads;
-there is no internal RPC fallback. Keep private credentials out of browser bundles.
+through `rpcOverrides` for the chains you exercise, and keep the SDK/wallet chain sets
+aligned. An entry in `rpcOverrides` always wins; a chain without one uses the chain's
+built-in endpoint, so an integration that passes none keeps working. Wallet-library
+transports alone do not configure SDK reads. Rollup price lookups read only a
+host-configured RPC. Keep private credentials out of browser bundles.
 
 ## Integration ownership
 
 - Use stock components when they fit the approved UI; use `useSpiceSupply` for custom
   action forms. `useSpiceLock` and legacy `useSpiceAction` delegate to that controller.
+- Declare the destination token by chain and address:
+  `destinationToken={{ chainId: 8453, address: USDC }}`. The SDK takes the symbol and
+  decimals from the chain's token registry, then from the token contract, and holds the
+  action until they are known. Decimals that cannot be read block the action; a symbol
+  that cannot be read falls back to the shortened address. Any field you pass wins, so a
+  full `{ address, symbol, decimals, chainId }` object behaves exactly as before.
 - Supply destination metadata, protocol `buildActionCalls` or destination-only
   `lockBatches`, beneficiary semantics, and awaited application updates. The SDK owns
   inventory, routing, Max, fees, accepted plans, funding, execution and recovery.
+- For the account, use `useSpiceAccount()` instead of reading `SpiceFlowProviderContext`:
+  `mode` (`"embedded"` or `"external"`), `setMode`, `ownerAddress` for the current mode,
+  both wallet addresses and the whitelist state. A provider with a fixed `mode` prop
+  ignores `setMode`.
 - For custom holdings, use `useSpiceInventory` and `assetPositionId`. Keep raw balance,
   default visibility and spend eligibility separate. Preserve rows during refresh;
   stale/failed balances cannot authorize spending, and confirmed zero wins.
@@ -150,6 +166,36 @@ Rollup USD values use the host-configured RPC provider's pricing capability when
 
 Wallet discovery and rollup balances share a one-minute quote cache. Pricing polls only while the view is open and the page is visible. A failed refresh can retain a marked stale quote for up to five minutes; an unavailable quote displays `—`. No extra key, internal RPC, or symbol-based ERC-20 price fallback is used.
 
+### Host tokens
+
+A token the SDK does not know (a protocol's own token, a receipt token) is declared
+once on the provider. Every surface that lists balances then reads it: Supply, Pay,
+Lock, the account panel and Withdraw.
+
+```tsx
+<SpiceFlowProvider
+  additionalSourceTokens={[{ address: TOKEN, chainId: 8453, symbol: "TOKEN", decimals: 18 }]}
+>
+```
+
+A component's or hook's own `additionalSourceTokens` still works and is added to the
+provider's list.
+
+### Host token prices
+
+A host token usually has no price the SDK can find, so the account panel lists it
+without a USD value. `AccountDisplay.tokenPrices` takes the host's own price for it,
+keyed by `chainId:address`. The value counts toward the account total and the row
+sorts with the rest.
+
+```tsx
+<AccountDisplay tokenPrices={{ [`8453:${TOKEN}`]: tokenUsdPrice }} />
+```
+
+The SDK's own price wins whenever it has one. A symbol key prices rollup balances
+only: any wallet token can carry any symbol, so a wallet balance is matched by address
+alone. The price is for display and never changes which balance an action spends.
+
 ### Host-supplied token logos
 
 `AccountDisplay.tokenLogos` maps a token symbol to a logo URL, the same key
@@ -162,6 +208,22 @@ wins when it has a logo.
 <AccountDisplay tokenLogos={{ TOKEN: tokenLogoUrl }} />
 ```
 
+### Account with Deposit and Withdraw
+
+`SpiceAccount` renders `AccountDisplay` together with `SpiceDeposit` and
+`SpiceWithdraw`, and owns their open state. Withdraw on an idle rollup balance opens
+the modal with that balance selected. It takes every `AccountDisplay` prop except the
+two click handlers; `depositProps` and `withdrawProps` pass through to the modals.
+`styles` and `onDepositSuccess` are shared with the modals unless those props set
+their own.
+
+```tsx
+<SpiceAccount appName="MyApp" onDepositSuccess={refresh} />
+```
+
+Use `AccountDisplay` directly to hide one of the buttons or to open your own flow
+from them.
+
 ### Withdraw from an account balance
 
 `AccountDisplay.onWithdrawClick` receives the rollup receipt-token ID when a
@@ -185,14 +247,24 @@ const [withdrawAssetId, setWithdrawAssetId] = useState<string>();
   isOpen={withdrawOpen}
   onClose={() => setWithdrawOpen(false)}
   initialSourceAssetId={withdrawAssetId}
-  buildSpicenetBatch={buildSpicenetWithdrawalBatch}
 />
 ```
 
-Keep the integration's existing withdrawal batch builder and callbacks.
+`buildSpicenetBatch` defaults to the SDK's `buildSpicenetWithdrawalBatch`. An
+integration that already passes a builder keeps it as an override, and its
+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.
 
+### Funding sources
+
+Supply, Pay and Lock list every balance that can fund the action: the embedded wallet
+and rollup balances, and the connected external wallet, in either wallet mode. To keep a
+mode to its own wallet, pass `includeExternalWalletAssets={false}` (Embedded mode) or
+`includeCrossChainEmbeddedAssets={false}` (External mode). A user who holds the same
+token in both wallets sees one row per wallet; a host that preselects a source should
+match on `assetPositionId`, not on symbol or address alone.
+
 ### Action Fee Readiness
 
 - Routed Supply, Pay and Lock actions must surface fee estimation before enabling submission.
@@ -200,6 +272,8 @@ cached balance or change the receipt's supported withdrawal routes.
 - 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".
 - 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.
 
 ### Fee funding for fee-only actions
 
@@ -208,6 +282,8 @@ cached balance or change the receipt's supported withdrawal routes.
 - 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.
+- `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.
 
 ### Updating and releasing
 

package/dist/auth-privy.cjs.js

@@ -1,2 +1,3 @@
 "use client";
-"use strict";const r=require("./privy-DgLAdE7U.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;
+(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-BG9UqWrL.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,2 +1,3 @@
 "use client";
-import{P as g}from"./privy-TGSRGTFo.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};
+(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-BMB5O4hI.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/SpiceAccount/SpiceAccount.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import type { SpiceDepositProps } from "../../types/deposit";
+import type { SpiceWithdrawProps } from "../../types/withdraw";
+import { type AccountDisplayProps } from "../AccountDisplay";
+export interface SpiceAccountProps extends Omit<AccountDisplayProps, "onDepositClick" | "onWithdrawClick"> {
+    depositProps?: Omit<SpiceDepositProps, "isOpen" | "onClose">;
+    withdrawProps?: Omit<SpiceWithdrawProps, "isOpen" | "onClose" | "initialSourceAssetId">;
+}
+export declare const SpiceAccount: React.FC<SpiceAccountProps>;

package/dist/components/SpiceAccount/index.d.ts

@@ -0,0 +1,2 @@
+export { SpiceAccount } from "./SpiceAccount";
+export type { SpiceAccountProps } from "./SpiceAccount";

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

@@ -3,7 +3,7 @@ import { type Address } from "viem";
 import type { ExecutionOptions } from "../../../hooks/useSpiceExecution";
 import type { SelectedAsset } from "../../../types/assets";
 import type { ChainBatch } from "../../../types/authorization";
-import type { PivotRoute, SpiceSupplyProps, SupplyBatchBuildOptions } from "../../../types/supply";
+import type { DestinationTokenConfig, PivotRoute, SpiceSupplyProps, SupplyBatchBuildOptions } from "../../../types/supply";
 import type { ResolvedExactOutputSwap } from "../../../utils/swapQuotes";
 type EstimateFn = (chainBatches: ChainBatch[], tokenAddress: string, tokenTransferAmount: bigint, options?: ExecutionOptions) => Promise<FeeEstimateSummary>;
 export declare function getPivotEscrowAmount(sourceSwap: Pick<ResolvedSwap, "amountOutMinimum">, gasSkim: bigint): bigint;
@@ -14,7 +14,7 @@ export interface BatchBuilderContext {
     isFeeInclusiveInput?: boolean;
     feeOnlyAction?: boolean;
     swapInputAmount?: bigint | null;
-    destinationToken: SpiceSupplyProps["destinationToken"];
+    destinationToken: DestinationTokenConfig;
     embeddedWalletAddress: string | null | undefined;
     providerEmbeddedAddress: string | null | undefined;
     externalWalletAddress: string | null | undefined;

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

@@ -4,7 +4,7 @@ import { type Address } from "viem";
 import type { ExecutionRunner } from "../../../execution/runner";
 import type { ExecutionProgress } from "../../../hooks/useSpiceExecution";
 import type { SelectedAsset } from "../../../types/assets";
-import type { BuildPayBatchesFn, BuildSupplyBatchesFn, PivotRoute, SpiceSupplyProps } from "../../../types/supply";
+import type { BuildPayBatchesFn, BuildSupplyBatchesFn, DestinationTokenConfig, PivotRoute, SpiceSupplyProps } from "../../../types/supply";
 import type { ResolvedExactOutputSwap } from "../../../utils/swapQuotes";
 import { type SupplyFeeQuote } from "./feePreview";
 export type SupplyStep = "idle" | "building" | "signing-delegation" | "signing-intent" | "submitting" | "executing" | "success" | "error";
@@ -72,6 +72,7 @@ export type ExecutorContext = {
         spiceDepositSubmittedRef: MutableRefObject<boolean>;
         abortControllerRef: MutableRefObject<AbortController | null>;
     };
-} & Pick<SpiceSupplyProps, "destinationToken" | "buildActionCalls" | "feeExecutionMode" | "buildSpicenetBatch" | "onPayExecute" | "onSuccess">;
+    destinationToken: DestinationTokenConfig;
+} & Pick<SpiceSupplyProps, "buildActionCalls" | "feeExecutionMode" | "buildSpicenetBatch" | "onPayExecute" | "onSuccess">;
 export declare function executeSupply(ctx: ExecutorContext): Promise<void>;
 export declare function executePay(ctx: ExecutorContext): Promise<void>;

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

@@ -4,7 +4,7 @@ import { type Address } from "viem";
 import type { ExecutionOptions } from "../../../hooks/useSpiceExecution";
 import type { Asset, SelectedAsset } from "../../../types/assets";
 import type { ChainBatch } from "../../../types/authorization";
-import type { FeeFundingSource, PivotRoute, SpiceSupplyProps, SupplyBatchBuildOptions } from "../../../types/supply";
+import type { DestinationTokenConfig, FeeFundingSource, PivotRoute, SpiceSupplyProps, SupplyBatchBuildOptions } from "../../../types/supply";
 import type { FeePreview } from "../../../types/ui";
 import type { ResolvedExactOutputSwap } from "../../../utils/swapQuotes";
 import { type FundingConversion } from "./feeConversion";
@@ -32,7 +32,7 @@ export type SupplyFeeQuote = {
 };
 export declare function quoteDirectExternalAction(params: {
     selectedAsset: SelectedAsset;
-    destinationToken: SpiceSupplyProps["destinationToken"];
+    destinationToken: DestinationTokenConfig;
     paymentAmount?: string;
     account: Address;
     beneficiary?: Address;
@@ -101,7 +101,7 @@ export interface FeePreviewContext {
     isNon7702: boolean;
     isSourceDestToken: boolean;
     currentPaymentAmount: string;
-    destinationToken: SpiceSupplyProps["destinationToken"];
+    destinationToken: DestinationTokenConfig;
     feeExecutionMode: SpiceSupplyProps["feeExecutionMode"];
     resolvedTokenIn: Address | null;
     embeddedWalletAddress: string | null | undefined;

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

@@ -104,11 +104,13 @@ export declare function useSpiceEmbeddedWithdraw(params: {
         retryFinalization: () => void;
         fundEmbeddedSource: (amount: bigint) => Promise<void>;
         canExecute: boolean;
+        submit: () => Promise<void>;
         submitSupply: () => Promise<void>;
         submitPay: () => Promise<void>;
         retrySupply: () => void;
         dismissPaymentStatus: () => void;
         resolveMaxAmount: (asset: Asset) => Promise<string | null>;
+        max: () => Promise<string | null>;
         resetAfterSuccess: () => void;
         resetPaymentState: () => void;
     };

package/dist/hooks/index.d.ts

@@ -19,6 +19,7 @@ export type { PartnerWhitelistCheckResponse, UseIsUserWhitelistedOptions, } from
 export { isSupportedSupplyAsset, useSupplyAssets } from "./useSupplyAssets";
 export { resolveInputSupplySwapQuote, useSupplyQuote } from "./useSupplyQuote";
 export type { SupplyQuoteResult, UseSupplyQuoteOpts } from "./useSupplyQuote";
+export { useSpiceAccount, type SpiceAccountMode } from "./useSpiceAccount";
 export { useSpiceInventory } from "./useSpiceInventory";
 export { useSpiceLock, type UseSpiceLockParams } from "./useSpiceLock";
 export { useSpiceSupply, type UseSpiceSupplyParams, type UseSpiceSupplyResult, } from "./useSpiceSupply";

package/dist/hooks/useDestinationToken.d.ts

@@ -1,10 +1,11 @@
 import { type Address } from "viem";
+import type { DestinationTokenConfig, DestinationTokenDeclaration } from "../types/supply";
 export declare function useDestinationToken(params: {
     enabled: boolean;
     chainId: number;
     address?: Address;
     decimals?: number;
-    symbol: string;
+    symbol?: string;
     logoURI?: string;
 }): {
     token: {
@@ -18,3 +19,7 @@ export declare function useDestinationToken(params: {
     ready: boolean;
     refresh: () => void;
 };
+export declare function useDeclaredDestinationToken(declared: DestinationTokenDeclaration | undefined, enabled: boolean): {
+    token: DestinationTokenConfig | undefined;
+    error: string | null;
+};

package/dist/hooks/useSpiceAccount.d.ts

@@ -0,0 +1,12 @@
+export type SpiceAccountMode = "embedded" | "external";
+export declare function useSpiceAccount(): {
+    mode: SpiceAccountMode;
+    setMode: (next: SpiceAccountMode) => void | undefined;
+    ownerAddress: `0x${string}` | undefined;
+    embeddedAddress: `0x${string}` | undefined;
+    externalAddress: `0x${string}` | undefined;
+    isUserWhitelisted: boolean | null;
+    isWhitelistChecking: boolean;
+    isWhitelistGateActive: boolean;
+    whitelistCheck: import("./useIsUserWhitelisted").PartnerWhitelistCheckResponse | undefined;
+};

package/dist/hooks/useSpiceAction.d.ts

@@ -3,7 +3,7 @@ import type { Asset, SelectedAsset } from "../types/assets";
 import type { DestinationTokenConfig, SpiceSupplyProps } from "../types/supply";
 export type SpiceActionSource = Asset;
 export interface UseSpiceActionOptions {
-    destinationToken: DestinationTokenConfig;
+    destinationToken: DestinationTokenConfig | undefined;
     recipient?: Address;
     buildActionCalls: SpiceSupplyProps["buildActionCalls"];
     buildSpicenetBatch?: SpiceSupplyProps["buildSpicenetBatch"];

package/dist/hooks/useSpiceLock.d.ts

@@ -1,6 +1,6 @@
 import type { Asset, SelectedAsset } from "../types/assets";
 import type { SpiceLockModalProps } from "../types/lock";
-export interface UseSpiceLockParams extends Pick<SpiceLockModalProps, "lockBatches" | "lockChainId" | "lockTokenSymbol" | "lockTokenLogoURI" | "destinationTokenAddress" | "destinationTokenDecimals" | "beneficiary" | "onLockSuccess" | "onLockError" | "buildSpicenetBatch"> {
+export interface UseSpiceLockParams extends Pick<SpiceLockModalProps, "lockBatches" | "lockChainId" | "lockTokenSymbol" | "lockTokenLogoURI" | "destinationTokenAddress" | "destinationTokenDecimals" | "beneficiary" | "onSubmit" | "onLockSuccess" | "onLockError" | "buildSpicenetBatch"> {
     enabled: boolean;
     selectedAsset: SelectedAsset | null;
     recoveryKey?: string;
@@ -105,11 +105,13 @@ export declare function useSpiceLock(params: UseSpiceLockParams): {
     };
     retryFinalization: () => void;
     fundEmbeddedSource: (amount: bigint) => Promise<void>;
+    submit: () => Promise<void>;
     submitSupply: () => Promise<void>;
     submitPay: () => Promise<void>;
     retrySupply: () => void;
     dismissPaymentStatus: () => void;
     resolveMaxAmount: (asset: Asset) => Promise<string | null>;
+    max: () => Promise<string | null>;
     resetAfterSuccess: () => void;
     resetPaymentState: () => void;
 };

package/dist/hooks/useSpiceSupply.d.ts

@@ -2,10 +2,11 @@ import { type ResolvedSwap } from "@spicenet-io/spiceflow-core";
 import { type Address } from "viem";
 import { type PaymentResult, type SupplyStep } from "../components/SpiceSupply/lib/executors";
 import type { Asset, SelectedAsset } from "../types/assets";
-import type { SpiceSupplyProps } from "../types/supply";
+import type { DestinationTokenDeclaration, SpiceSupplyProps } from "../types/supply";
 import type { FeePreview } from "../types/ui";
-export interface UseSpiceSupplyParams extends Pick<SpiceSupplyProps, "destinationToken" | "sourceChains" | "supportedSourceAssets" | "buildActionCalls" | "feeExecutionMode" | "buildSpicenetBatch" | "onPayExecute" | "resolveExactOutputSwap" | "amountDirection" | "onSuccess" | "onError" | "additionalSourceTokens" | "includeExternalWalletAssets" | "includeCrossChainEmbeddedAssets" | "feeOnlyAction" | "actionInput" | "actionProceeds" | "feeFunding" | "maxSlippage" | "resolveInputSwap"> {
+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"> {
     enabled: boolean;
+    destinationToken: DestinationTokenDeclaration | undefined;
     selectedAsset: SelectedAsset | null;
     paymentAmount?: string;
     recipient?: Address;
@@ -108,11 +109,13 @@ export declare function useSpiceSupply(params: UseSpiceSupplyParams): {
     retryFinalization: () => void;
     fundEmbeddedSource: (amount: bigint) => Promise<void>;
     canExecute: boolean;
+    submit: () => Promise<void>;
     submitSupply: () => Promise<void>;
     submitPay: () => Promise<void>;
     retrySupply: () => void;
     dismissPaymentStatus: () => void;
     resolveMaxAmount: (asset: Asset) => Promise<string | null>;
+    max: () => Promise<string | null>;
     resetAfterSuccess: () => void;
     resetPaymentState: () => void;
 };

package/dist/hooks/useSupplyAssets.d.ts

@@ -2,6 +2,7 @@ import type { Asset } from "../types/assets";
 import type { DestinationTokenConfig } from "../types/supply";
 import { isSupportedSource } from "../utils/assetPolicy";
 import type { InventoryToken } from "../utils/inventoryStore";
+export declare const NO_DESTINATION_TOKEN: DestinationTokenConfig;
 export declare function compareSupplyAssets(a: Asset & {
     _source?: string;
 }, b: Asset & {
@@ -19,8 +20,8 @@ export declare function isSpendableExternalAsset(asset: Parameters<typeof isSpen
     allowPivot?: boolean;
 }): boolean;
 export declare function useSupplyAssets(opts: {
-    address: string | undefined;
-    destinationToken: DestinationTokenConfig;
+    address?: string;
+    destinationToken: DestinationTokenConfig | undefined;
     supportedSourceAssets?: string[];
     sourceChains?: number[];
     enabled: boolean;

package/dist/hooks/useSupplyQuote.d.ts

@@ -14,8 +14,8 @@ export interface UseSupplyQuoteOpts {
         decimals: number;
         chainId: number;
     };
-    chainId: number;
-    recipient: Address | undefined;
+    chainId?: number;
+    recipient?: Address;
     paymentAmount?: string;
     maxSlippage?: number;
     refreshIntervalMs?: number;

package/dist/hooks/useWalletBalances.d.ts

@@ -6,8 +6,8 @@ export declare const fetchUsdPricesForChain: (chainId: number, addresses: string
 export declare const fetchBalances: (walletAddress: Address, supportedChains?: number[], additionalTokens?: InventoryToken[], rpcOverrides?: Record<number, string>) => Promise<MultiChainBalances>;
 export interface UseAssetsConfig {
     address?: Address;
-    supportedChains: number[];
-    fetchBalances: typeof fetchBalances;
+    supportedChains?: number[];
+    fetchBalances?: typeof fetchBalances;
     additionalTokens?: InventoryToken[];
     enabled?: boolean;
     refreshInterval?: number;