@haven_ai/sdk 0.1.22-alpha.0 → 0.1.23-alpha.1

package/dist/index.d.cts

@@ -270,6 +270,21 @@ interface X402AuthorizationOptions {
      * omit for a non-MCP-tool x402 merchant (plain HTTP resource).
      */
     mcpCallContext?: X402McpCallContext;
+    /**
+     * #1348: the agent's delegate address, when the caller already resolved it
+     * from `getAgent()` in this same flow — skips `createX402Intent`'s internal
+     * agent fetch (one full round trip on every guided purchase). Staleness
+     * caveat (#1358 review): the backend derives the funding shape by comparing
+     * `payTo` to the CURRENT delegate address, so a value made stale by a
+     * delegate rotation mid-flow is not always a clean failure — a pinned-budget
+     * agent gets a 403, but an open-budget delegation agent would route to the
+     * settlement shape with the stale address. The window is one tool call
+     * (previously sub-millisecond, now the merchant-quote duration), never
+     * externally suppliable; server-truth hardening is tracked in #1360. Only
+     * pass an address fetched in THIS flow; omit to keep the self-contained
+     * fetch.
+     */
+    delegateAddress?: string;
 }
 /**
  * Keyless x402 construct result.
@@ -403,6 +418,16 @@ interface X402Quote {
     amountAtomic: string;
     amount: string;
     token: string;
+    /**
+     * #1351: decimals for `asset` on `network`, resolved from the SAME
+     * address→token binding that produced `token` — the quote's own authority on
+     * how many atomic units one human unit is. `null` when the merchant's asset
+     * is not a token Haven recognises on that network, in which case `token` is
+     * an unverified fallback label and NO human→atomic conversion is safe.
+     * Consumers converting a human-denominated figure (a user-intent spending
+     * cap) MUST fail closed on `null` rather than assume 6.
+     */
+    decimals: number | null;
     asset: string;
     network: string;
     chainId: number | null;
@@ -428,49 +453,7 @@ interface X402ResumeState {
     chainId: number | null;
     merchantAddress: string;
 }
-interface MppAuthorizationOptions {
-    /** Stable caller-supplied key for this user intent. Prevents duplicate approvals across retries. */
-    idempotencyKey?: string;
-}
-/** Quote parsed from an MPP challenge without creating a Haven payment. */
-interface MppQuote {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    request: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-/** State bundle an agent can persist while waiting for manual MPP approval. */
-interface MppResumeState {
-    rail: 'mpp';
-    paymentRail: MachinePaymentRail;
-    paymentId: string;
-    idempotencyKey: string;
-    challenge: MachinePaymentChallenge;
-    url: string;
-    request?: X402RequestSnapshot;
-    resourceUrl: string;
-    description: string | null;
-    amountAtomic: string;
-    amount: string;
-    token: string;
-    asset: string;
-    network: string;
-    chainId: number;
-    merchantAddress: string;
-    expiresAt: string;
-}
-type PaymentResumeState = X402ResumeState | MppResumeState;
+type PaymentResumeState = X402ResumeState;
 interface ResumeAuthorizedX402Input extends X402AuthorizationOptions {
     /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
     paymentId: string;
@@ -489,63 +472,7 @@ interface ResumeX402PaymentInput extends X402AuthorizationOptions {
     /** Original or freshly parsed x402 requirements. Supplying this avoids an extra merchant 402 probe. */
     paymentRequired?: X402PaymentRequired;
 }
-interface ResumeAuthorizedMppInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original MPP challenge returned by the paid resource. */
-    challenge: MachinePaymentChallenge;
-}
-interface ResumeMppPaymentInput extends MppAuthorizationOptions {
-    /** Payment or approval request ID returned by authorizeMachinePayment / haven.fetch. */
-    paymentId: string;
-    /** Original paid URL. If challenge is omitted, Haven will call it once to re-read the MPP challenge. */
-    url: string;
-    /** Original fetch options. Reused for the 402 probe and final merchant retry. */
-    init?: RequestInit;
-    /** Serializable original request captured by quoteMpp() / pending approval errors. */
-    request?: X402RequestSnapshot;
-    /** Original MPP challenge. Supplying this avoids an extra paid-resource 402 probe. */
-    challenge?: MachinePaymentChallenge;
-}
 type MachinePaymentRail = 'x402' | 'mpp_demo' | 'mpp_crypto' | 'stripe_deposit' | 'spt';
-interface MachinePaymentChallenge {
-    rail: MachinePaymentRail;
-    version: string;
-    challengeId: string;
-    resource: string;
-    description: string;
-    network: {
-        chainId: number;
-        name: 'base';
-    };
-    asset: {
-        symbol: 'USDC';
-        address: string;
-        decimals: 6;
-    };
-    amount: {
-        display: string;
-        atomic: string;
-    };
-    recipient: string;
-    expiresAt: string;
-    metadata?: Record<string, unknown>;
-}
-interface MachinePaymentReceipt {
-    success: boolean;
-    rail: MachinePaymentRail;
-    paymentId: string;
-    challengeId: string;
-    txHash: string;
-    token: string;
-    amount: string;
-    to: string;
-    resourceUrl: string;
-    explorerUrl: string;
-    payer?: string;
-    chainId?: number;
-    proofHeader: string;
-}
 interface HavenAgent {
     id: string;
     name: string;
@@ -825,6 +752,22 @@ declare const AgentPaymentFailureCode: {
      * mcp_transport explicitly (the version-skew path).
      */
     readonly MerchantCallContextUnavailable: "MERCHANT_CALL_CONTEXT_UNAVAILABLE";
+    /**
+     * #1351: the caller supplied BOTH the atomic `max_amount` and the
+     * human-denominated `max_amount_human` cap for one purchase. Haven refuses
+     * to guess which the user meant — the two differ by a factor of 10^decimals,
+     * so picking wrong is exactly the silent-overspend this cap exists to
+     * prevent. Rejected before any merchant probe, funding intent, or signature.
+     */
+    readonly AmbiguousMaxAmount: "AMBIGUOUS_MAX_AMOUNT";
+    /**
+     * #1351: a human-denominated cap was supplied, but it cannot be converted to
+     * atomic units against THIS quote — either the quote's asset has no known
+     * decimals on its network, or the cap carries more fraction digits than the
+     * asset can represent (truncating it would silently change the user's cap).
+     * The fallback is the exact atomic `max_amount`.
+     */
+    readonly MaxAmountUnconvertible: "MAX_AMOUNT_UNCONVERTIBLE";
 };
 type AgentPaymentFailureCode = (typeof AgentPaymentFailureCode)[keyof typeof AgentPaymentFailureCode];
 /**
@@ -833,17 +776,19 @@ type AgentPaymentFailureCode = (typeof AgentPaymentFailureCode)[keyof typeof Age
  *
  * Two layers of vocabulary share this enum because both reach the wire:
  *
- *   - **Categorical rails** identify the rail family and are used as
- *     discriminators on `PaymentResumeState`: `direct`, `x402`, `mpp`.
+ *   - **Categorical rails** identify the rail family and are used as the
+ *     `PaymentResumeState` discriminator: `direct`, `x402` (`mpp` remains a
+ *     valid categorical VALUE on historical status reads, but #1328 retired
+ *     the `MppResumeState` variant that used to carry it — the mpp_demo
+ *     client resume flow no longer exists).
  *   - **Granular rails** identify the specific protocol the backend persists
  *     and returns on response bodies: `mpp_demo`, `mpp_crypto`,
  *     `stripe_deposit`, `spt`. `x402` doubles as both categorical and
  *     granular.
  *
  * Consumers reading the top-level `rail` field on a payment status response
- * should treat any `mpp*` value as the MPP family; consumers reading the
- * `rail` field on a `MppResumeState` will always see the categorical `mpp`,
- * with the granular value on `paymentRail`.
+ * should treat any `mpp*` value as the MPP family — this still applies to
+ * historical `mpp_demo` rows, which remain readable.
  */
 declare const AgentPaymentRail: {
     /** Standard Haven payment from the user's Safe through an approved delegate allowance. */
@@ -866,8 +811,8 @@ type PaymentPhase = AgentPaymentPhase;
 type PaymentNextAction = AgentPaymentNextAction;
 declare const AGENT_PAYMENT_PHASE_VALUES: ("rejected" | "expired" | "failed" | "agent_signature_required" | "payment_submitted" | "payment_confirmed" | "user_approval_required" | "user_execution_required" | "waiting_for_additional_approvals" | "funding_sent" | "insufficient_funds" | "funded_but_unsettled")[];
 declare const AGENT_PAYMENT_NEXT_ACTION_VALUES: ("sign_and_submit_payment" | "check_status_later" | "none" | "wait_for_user_approval" | "wait_for_user_to_complete_payment" | "retry_original_x402_request" | "stop_and_tell_user" | "request_again_if_user_still_wants_it" | "retry_with_explicit_context" | "payment_window_expired" | "fund_safe_or_raise_allowance" | "sweep_stranded_funds")[];
-declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE")[];
-declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct")[];
+declare const AGENT_PAYMENT_FAILURE_CODE_VALUES: ("PRICE_EXCEEDS_MAX" | "PAYMENT_WINDOW_EXPIRED" | "MERCHANT_REJECTED_AFTER_FUNDING" | "MERCHANT_UNRESPONSIVE_AFTER_FUNDING" | "MERCHANT_CALL_CONTEXT_UNAVAILABLE" | "AMBIGUOUS_MAX_AMOUNT" | "MAX_AMOUNT_UNCONVERTIBLE")[];
+declare const AGENT_PAYMENT_RAIL_VALUES: ("x402" | "mpp_demo" | "mpp_crypto" | "stripe_deposit" | "spt" | "direct" | "mpp")[];
 declare const AgentPaymentPhaseDescriptions: Record<AgentPaymentPhase, string>;
 declare const AgentPaymentNextActionDescriptions: Record<AgentPaymentNextAction, string>;
 declare const AgentPaymentFailureCodeDescriptions: Record<AgentPaymentFailureCode, string>;
@@ -931,6 +876,34 @@ interface AgentNextStep {
     safe_to_continue: boolean;
     reason: string;
 }
+/**
+ * #1349: compact, Haven-generated reporting evidence for a completed x402
+ * merchant purchase. `status`, money fields, merchant endpoint/address, and
+ * funding transaction come from Haven payment state; `product` and
+ * `invoice_id` are optional merchant-supplied display metadata. The raw
+ * merchant result remains separate evidence and MUST NOT be used to infer
+ * settlement status.
+ */
+interface AgentPurchaseSummary {
+    /** Set only after Haven has completed the funding and merchant-settlement flow. */
+    status: 'settled';
+    product: string | null;
+    amount: string | null;
+    amount_atomic: string | null;
+    asset: string | null;
+    network: string | null;
+    merchant: {
+        address: string | null;
+        resource_url: string | null;
+    };
+    /** Merchant-supplied identifier, or null when the merchant did not supply one. */
+    invoice_id: string | null;
+    funding_tx_hash: string | null;
+    /** Optional merchant receipt reference parsed from PAYMENT-RESPONSE; not Haven settlement proof. */
+    settlement_tx_hash: string | null;
+    /** Same read-only allowance block returned at the top level, or null when unavailable. */
+    allowance: PostPurchaseAllowanceSummary | null;
+}
 /** #1308: compact reporting summary — what the agent tells the user. */
 interface AgentPaymentSummary {
     payment_id: string;
@@ -941,6 +914,12 @@ interface AgentPaymentSummary {
     network?: string;
     expires_at?: string;
     product?: string;
+    /**
+     * Default reporting contract for a successful `haven_settle_mcp_tool` call.
+     * The merchant's raw `result` remains available separately as advanced
+     * evidence; do not parse it to determine whether a payment settled.
+     */
+    purchase_summary?: AgentPurchaseSummary;
 }
 declare const AgentPaymentRailDescriptions: Record<AgentPaymentRail, string>;
 declare const AgentPaymentPhaseSchema: AgentPaymentEnumSchema;
@@ -1048,7 +1027,7 @@ declare class X402UnexpectedStatusError extends HavenApiError {
 }
 declare class HavenPaymentStateError extends HavenApiError {
     readonly state: PaymentStatusResult;
-    resumeState?: X402ResumeState | MppResumeState;
+    resumeState?: X402ResumeState;
     constructor(message: string, statusCode: number, state: PaymentStatusResult, body?: unknown);
     get status(): string;
     get phase(): PaymentPhase;
@@ -1300,7 +1279,6 @@ declare class HavenClient {
     private readonly chainRpcs;
     private readonly inFlightX402;
     private readonly x402ReceiptCache;
-    private readonly inFlightMachinePayments;
     /**
      * Setup-time headers configured via `HavenClientConfig.defaultHeaders`.
      * Read-only after construction — use `withRequestContext` for per-call
@@ -1408,6 +1386,8 @@ declare class HavenClient {
      * Get the agent identity tied to this API key.
      */
     getAgent(): Promise<HavenAgent>;
+    private agentInFlight;
+    private fetchAgent;
     /**
      * One-shot "am I ready?" bootstrap: identity + live spend authority + a
      * readiness signal, in a single call. Folds {@link getAgent} and
@@ -1478,6 +1458,8 @@ declare class HavenClient {
     getPostPurchaseAllowanceSummary(paymentId: string): Promise<{
         allowance: PostPurchaseAllowanceSummary | null;
         warnings: AgentPaymentWarning[];
+        /** Same authenticated payment-state read used to resolve the settled token. */
+        payment: PaymentStatusResult | null;
     }>;
     /**
      * `haven_get_payment_status` convenience: fetch status and, for a
@@ -1506,6 +1488,7 @@ declare class HavenClient {
      */
     discoverTools(options?: {
         category?: string;
+        search?: string;
         rail?: 'x402' | 'mpp';
     }): Promise<HavenCatalogEntry[]>;
     /**
@@ -1535,10 +1518,11 @@ declare class HavenClient {
         verification: ReceiptVerification;
     }>;
     /**
-     * Rehydrate the x402/MPP resume-state bundle for a payment id.
+     * Rehydrate the x402 resume-state bundle for a payment id (#1328: the MPP
+     * resume-state variant retired along with the rest of the mpp_demo surface).
      *
      * The server returns stored protocol context only. The client still signs the
-     * merchant proof locally when resumeX402Payment() or resumeMppPayment() runs.
+     * merchant proof locally when resumeX402Payment() runs.
      */
     getResumeState(paymentId: string): Promise<PaymentResumeState>;
     /**
@@ -1627,15 +1611,6 @@ declare class HavenClient {
      * Non-SSE responses pass through untouched.
      */
     private surfaceMcpResult;
-    /**
-     * Probe a paid MPP endpoint or inspect an existing challenge without creating
-     * a Haven payment or approval request.
-     */
-    quoteMpp(challengeOrUrl: MachinePaymentChallenge | string, init?: RequestInit, options?: MppAuthorizationOptions): Promise<MppQuote>;
-    /**
-     * Pay a previously inspected MPP quote and retry the exact captured request.
-     */
-    payMppChallenge(quote: MppQuote, options?: MppAuthorizationOptions): Promise<Response>;
     private retryX402Request;
     /**
      * #956: capture the merchant's OWN receipt when the paid response carries
@@ -1704,21 +1679,12 @@ declare class HavenClient {
     getX402MerchantCallContext(paymentId: string): Promise<X402MerchantCallContext>;
     private resolveX402MerchantCompletionContext;
     private resolveX402WalletForMerchantCall;
-    authorizeMachinePayment(challenge: MachinePaymentChallenge, options?: MppAuthorizationOptions): Promise<MachinePaymentReceipt>;
-    private authorizeMppDemoPayment;
-    resumeAuthorizedMpp(input: ResumeAuthorizedMppInput): Promise<MachinePaymentReceipt>;
-    resumeMppPayment(input: ResumeMppPaymentInput | MppResumeState): Promise<Response>;
-    private fetchWithMachinePayment;
-    private retryMppRequest;
     private assertCanResumeX402;
-    private assertCanResumeMpp;
     private mapX402ReceiptFromAuthorization;
     private mapX402ReceiptFromStatus;
     private buildX402Receipt;
     private createStandardX402Header;
     private cacheX402Receipt;
-    private mapMachinePaymentReceipt;
-    private mapMachinePaymentReceiptFromStatus;
     private recordMerchantRetryRejected;
     private reportMachinePaymentEvidence;
     /**
@@ -1742,11 +1708,8 @@ declare class HavenClient {
     private buildX402Quote;
     private detectX402McpTransport;
     private buildX402ResumeState;
-    private buildMppQuote;
-    private buildMppResumeState;
     private attachResumeState;
     private attachX402ResumeState;
-    private attachMppResumeState;
     /**
      * Execute a tool call by name and input.
      *
@@ -1919,7 +1882,7 @@ declare const toolDescriptions: {
     readonly payX402OneShot: {
         readonly summary: "Fetch an x402 paid HTTP resource in a single call. Handles the full probe -> pay -> retry round trip and returns the merchant response.";
         readonly selectionGuidance: "Prefer this over the quote+pay split when the agent just wants the paid resource and does not need to inspect the price first. If you already have a quote from haven_quote_x402, use haven_pay_x402_quote instead. Do not use for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns an MPP machine-payment challenge instead of standard x402, the MPP payment path is used automatically. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
+        readonly behavior: "Calls the URL, parses any HTTP 402 x402 challenge, signs the EIP-3009 payment from the delegate wallet, asks Haven for a Safe AllowanceModule top-up if needed, then retries the original request with the X-PAYMENT header and returns the merchant response. If the resource returns a non-402 status, returns it unchanged without contacting Haven.";
         readonly nextActionGuidance: string;
     };
     readonly resumeX402: {
@@ -1927,29 +1890,13 @@ declare const toolDescriptions: {
         readonly behavior: "Accepts either resume_state or payment_id, validates the original x402 details against the approved Haven funding, and retries the merchant request with the X-PAYMENT header. No new Haven approval is created.";
         readonly nextActionGuidance: "Only use when get_payment_status returns nextAction=retry_original_x402_request; do not start a new merchant session.";
     };
-    readonly quoteMpp: {
-        readonly summary: "Inspect a Haven MPP challenge or paid MPP URL without creating a Haven payment, signature, approval, or on-chain transaction.";
-        readonly behavior: "Parses an MPP challenge envelope and returns a typed quote with rail tag, amount, asset, and merchant context. Pure read-only — Haven is not contacted.";
-        readonly nextActionGuidance: "On success the returned quote is the input to haven_pay_mpp_challenge. Do not call the merchant again — Haven re-uses the captured request when paying.";
-    };
-    readonly payMpp: {
-        readonly summary: "Pay an inspected MPP challenge. The delegate key signs locally; Haven only validates and relays signed, on-chain-constrained payment transactions.";
-        readonly selectionGuidance: "Do not use this for read-only allowance, budget, spend-limit, remaining-amount, reset-period, or what-can-I-spend questions; use the allowance lookup tool instead.";
-        readonly behavior: "Authorizes the payment through Haven within the on-chain allowance, signs the challenge proof, and returns the proof header for retrying the original paid resource.";
-        readonly nextActionGuidance: "If approval is needed, preserve resume_state or payment_id and wait for nextAction=retry_original_x402_request before resuming.";
-    };
-    readonly resumeMpp: {
-        readonly summary: "Resume an MPP payment after the Haven wallet owner approved the funding step.";
-        readonly behavior: "Accepts either resume_state or payment_id and retries the original paid resource with the MPP proof header. No new Haven approval is created.";
-        readonly nextActionGuidance: "";
-    };
     readonly getPaymentStatus: {
         readonly summary: "Fetch structured Haven payment status, including phase and nextAction taxonomy for agent recovery.";
         readonly behavior: "Accepts a payment intent or approval request id and returns the full state taxonomy (phase, nextAction, rail, amount, merchant, resource url, idempotency key, message).";
         readonly nextActionGuidance: "";
     };
     readonly getResumeState: {
-        readonly summary: "Rehydrate stored x402 or MPP resume_state by payment_id.";
+        readonly summary: "Rehydrate stored x402 resume_state by payment_id.";
         readonly behavior: "Returns the context that the agent originally received in a pending-approval response, reconstructed from Haven's database. This is context only; signing still happens locally when a resume tool is called.";
         readonly nextActionGuidance: "";
     };
@@ -1987,7 +1934,7 @@ declare const toolDescriptions: {
         readonly summary: "Step 1 of a purchase: discover payable services from Haven's curated merchant catalog — names, prices, and which pay tool to use next.";
         readonly selectionGuidance: string;
         readonly behavior: string;
-        readonly nextActionGuidance: "Pick an entry and pay it with the tool named in suggested_tool, passing the entry's resource_url, tool_name, and tool_arguments for MCP merchants. Confirm the price from the live pay-tool result (not the catalog), and pass max_amount when the user has a cap.";
+        readonly nextActionGuidance: "Pick an entry and pay it with the tool named in suggested_tool, passing the entry's resource_url, tool_name, and tool_arguments for MCP merchants. Confirm the price from the live pay-tool result (not the catalog), and pass the user's cap as max_amount_human in whole tokens (\"no more than 1 USDC\" → max_amount_human: \"1\") — never convert it to atomic units by hand (#1351).";
     };
     readonly sweep_delegate: {
         readonly summary: "Sweep stranded USDC and/or ETH from the delegate wallet back to the originating Safe.";
@@ -2023,7 +1970,7 @@ type SharedToolKey = keyof typeof toolDescriptions;
  * this canonical string and asserts byte-for-byte equality, so the two copies
  * cannot drift.
  */
-declare const HAVEN_SKILL_MD = "---\nname: haven-pay\ndescription: Pay for things from the user's Haven wallet within their agent rules. Use when the user asks to send, pay, tip, or transfer crypto \u2014 or when a request hits an HTTP 402 (x402) paywall.\n---\n\n# Haven: pay from a Haven wallet\n\nThis skill lets the agent make payments from the user's Haven wallet through\nthe Haven MCP tools. Every payment is checked against the agent's on-chain\nbudget before money moves; payments above the remaining budget wait for the\nuser's approval in Haven.\n\nHosted tools run in the `mcp__haven__` namespace. Local signing tools run in\nthe `mcp__haven-signer__` namespace and keep the delegate key on this machine.\nTool results carry the exact next step (`next_action`, `next_tool`,\n`next_arguments`) \u2014 follow those fields first; the prose below is fallback\nand orientation, not the source of truth.\n\n## When to use this skill\n\n- The user asks to send money, pay someone, tip, donate, or transfer tokens.\n- A request returns HTTP 402 (x402): use the Haven pay tools to settle it,\n  then retry the original request.\n\n## Identity and budget\n\nDo not guess the wallet address, network, or budget.\n\nFor instant orientation at the start of a session, read the non-secret\n`agent.json` the connector wrote to your Haven credential directory (typically\n`~/.haven/agents/<agent-id>/agent.json` \u2014 if you don't know the agent id, list\n`~/.haven/agents/` to find the folder). It\nholds your agent id, Haven wallet address, network, and *configured* per-token\nbudget, and contains no keys \u2014 the fastest way to answer \"who am I and what may\nI spend\" with no round trip. If that file is absent (some setups don't write\nit), use the tools below instead.\n\nBefore any payment, confirm the *live remaining* budget with the tools \u2014\n`agent.json` shows the configured budget, not what is left after recent\nspending:\n\n- `mcp__haven__haven_get_agent` \u2014 the recommended first call: identity\n  (wallet, network) plus a readiness signal (`ready` / `needs_approval` /\n  `revoked`) and live remaining per-token allowance, in one shot.\n- `mcp__haven__haven_get_allowances` \u2014 detailed per-token breakdown\n  (configured, spent, reset window) when you need more than the summary.\n\nBudgets reset on a period the user chose. If a payment exceeds the remaining\nbudget it is queued for the user to approve in the Haven dashboard \u2014 this is\nnormal, not an error.\n\n## Paying\n\n**Catalog purchases \u2014 the primary path for MCP merchants:**\n\n1. `mcp__haven__haven_discover_tools` to find a payable service and its\n   `catalog_id`.\n2. `mcp__haven__haven_prepare_catalog_purchase` with `catalog_id` and\n   `max_amount`. `max_amount` (atomic units) is REQUIRED on this tool, and\n   is best practice on every paid call below too \u2014 it caps what the LIVE\n   merchant quote may charge, checked before any funding intent is created.\n3. Then FOLLOW THE RESPONSE'S GUIDANCE FIELDS: `next_action`, `next_tool`,\n   and `next_arguments` name the exact next call \u2014 act on those first; the\n   prose in this section is fallback and debugging detail. If the catalog\n   entry is missing or degraded, the response instead names\n   `mcp__haven__haven_pay_mcp_tool` (merchant URL, tool name, arguments) as\n   the manual fallback.\n\n**Signing:** `mcp__haven-signer__haven_sign_x402` with `payment_id` and\n`payment_required` ONLY \u2014 the local signer fetches the exact signing bytes\nitself, so never relay `typed_data` yourself. Fallback for an older signer\nor backend: re-run the quote/prepare tool with the SAME `idempotency_key`\nplus `include_signing_payload=true`, then pass `payload_hash`,\n`x402_expected` (the nested `x402.expected` object), and\n`typed_data`/`typed_data_b64` through unchanged.\n\n**Settle:** `mcp__haven__haven_settle_mcp_tool` with `payment_id`,\n`signature`, and `payment_header` ONLY \u2014 Haven rehydrates the merchant call\ncontext (`merchant_url`, `tool_name`, `arguments`, `mcp_transport`)\nserver-side from `payment_id`. Pass those four fields explicitly only as a\nversion-skew fallback when Haven has no stored context for the id \u2014 both or\nnone together, never just one. If the settle result carries `settled: false`,\nfunding is queued for the user's approval \u2014 tell them and check status later,\ndo not re-pay.\n\nStep-by-step alternative (also key-safe; for an older signer or backend, or\nwhen you already have a merchant URL and tool name instead of a\n`catalog_id`): `mcp__haven__haven_pay_mcp_tool` then\n`mcp__haven-signer__haven_sign` \u2192 `mcp__haven__haven_submit` \u2192\n`mcp__haven-signer__haven_x402_sign_header` \u2192\n`mcp__haven__haven_complete_mcp_tool`. Pass `payment_required`,\n`arguments`, and `mcp_transport` verbatim from the quote/prepare result.\nThe returned `expires_at` is the signing window; if a tool returns\n`PAYMENT_WINDOW_EXPIRED`, re-run the same quote/prepare tool with the same\n`idempotency_key`. Do not call the merchant yourself \u2014 Haven completes the\nmerchant leg for you.\n\n**Direct transfer / non-MCP paywall:** `mcp__haven__haven_pay` with\nrecipient, amount, and token for a plain transfer. For an arbitrary,\nnon-MCP x402 paywall: `mcp__haven__haven_quote_x402` to get a quote, then\n`mcp__haven__haven_pay_x402_quote` \u2014 follow the result's guidance fields\nfirst, sign in the local Haven signer, and retry the original request only\nwhen the result says `retry_original_x402_request`.\n\n**Catalog tool arguments:** when `haven_discover_tools` returns\n`tool_arguments`, pass that object unchanged as the pay tool's\n`arguments` field (for example\n`tool_arguments: { \"tier\": \"50gb\" }` -> `arguments: { \"tier\": \"50gb\" }`).\n\n**Prices:** show the user the live price from the pay-tool result, never a\ncatalog price. `haven_discover_tools` prices are indicative\n(`price_is_indicative`) and can be stale. The pay-tool result's `amount` /\n`amount_atomic` is the amount Haven authorizes for the call \u2014 a ceiling the\nmerchant settles at or below \u2014 so present it as the most the user will pay.\n\n**Status:** `mcp__haven__haven_get_payment_status` with a `payment_id` to\ncheck on queued or in-flight payments. Do not poll in a tight loop.\n\n## Approval semantics\n\n- A result with `pending_approval` means the payment exceeded the remaining\n  budget and is waiting for the user in Haven. Tell the user, then check\n  status later.\n- `safe_to_continue: false` on a guidance block is the same signal in\n  machine-readable form: stop and involve the user before calling anything\n  else for this payment.\n- Never ask the user for private keys. Signing happens only in the local Haven\n  signer; the hosted Haven tools never receive the signing key. If a tool\n  reports a missing or invalid credential, tell the user to re-run the Haven\n  setup command.\n\n## Failure handling\n\nHaven tool failures are shaped like `{ success: false, code, message, ... }`\nor older `{ error, status, details? }` responses. Branch on `code` when\npresent and surface `message` or `error` verbatim. Common cases:\n\n- `pending_approval`: queued for the user's approval (see above).\n- `insufficient_funds`: the Haven wallet doesn't hold enough of that token.\n  Suggest the user add funds in the Haven dashboard.\n- `PRICE_EXCEEDS_MAX`: the live merchant price exceeded your `max_amount`.\n  No funds moved; ask the user before retrying with a higher cap.\n- `PAYMENT_WINDOW_EXPIRED`: re-run the quote/prepare tool with the same\n  `idempotency_key`, then sign the fresh payload.\n- `MERCHANT_REJECTED_AFTER_FUNDING`: the merchant refused the paid retry.\n  Stop-and-sweep \u2014 stop retrying the merchant and use\n  `mcp__haven__haven_sweep_delegate` to recover stranded delegate funds.\n- `MERCHANT_UNRESPONSIVE_AFTER_FUNDING`: funding confirmed on-chain, but the\n  merchant never answered the paid retry. This is NOT proof of rejection \u2014 the\n  merchant may still settle late. Verify-then-sweep, never a blind sweep:\n  check `mcp__haven__haven_get_payment_status`, retry\n  `mcp__haven__haven_complete_mcp_tool` ONCE, and only sweep with\n  `mcp__haven__haven_sweep_delegate` if no settlement appears.\n- Budget exceeded: tell the user how much remains (from\n  `mcp__haven__haven_get_allowances`) and that they can raise the budget in\n  Haven.\n\n## Reporting after a purchase\n\nA settled `mcp__haven__haven_settle_mcp_tool` response carries\n`agent_summary` and the remaining post-purchase allowance in `allowance` \u2014\nreport the amount paid and what is left from those fields directly. Do not\ncall `haven_get_agent` or `haven_get_allowances` again just to report a\npurchase you already made.\n\n## Revoke\n\nIf this agent's credential may have leaked, tell the user to pause or revoke\nthe agent in the Haven dashboard under Agents. New requests stop immediately\nfor that credential.\n";
+declare const HAVEN_SKILL_MD = "---\nname: haven-pay\ndescription: Pay for things from the user's Haven wallet within their agent rules. Use when the user asks to send, pay, tip, or transfer crypto \u2014 or when a request hits an HTTP 402 (x402) paywall.\n---\n\n# Haven: pay from a Haven wallet\n\nThis skill lets the agent make payments from the user's Haven wallet through\nthe Haven MCP tools. Every payment is checked against the agent's on-chain\nbudget before money moves; payments above the remaining budget wait for the\nuser's approval in Haven.\n\nHosted tools run in the `mcp__haven__` namespace. Local signing tools run in\nthe `mcp__haven-signer__` namespace and keep the delegate key on this machine.\nTool results carry the exact next step (`next_action`, `next_tool`,\n`next_arguments`) \u2014 follow those fields first; the prose below is fallback\nand orientation, not the source of truth.\n\n## When to use this skill\n\n- The user asks to send money, pay someone, tip, donate, or transfer tokens.\n- A request returns HTTP 402 (x402): use the Haven pay tools to settle it,\n  then retry the original request.\n\n## Identity and budget\n\nDo not guess the wallet address, network, or budget.\n\nFor instant orientation at the start of a session, read the non-secret\n`agent.json` the connector wrote to your Haven credential directory (typically\n`~/.haven/agents/<agent-id>/agent.json` \u2014 if you don't know the agent id, list\n`~/.haven/agents/` to find the folder). It\nholds your agent id, Haven wallet address, network, and *configured* per-token\nbudget, and contains no keys \u2014 the fastest way to answer \"who am I and what may\nI spend\" with no round trip. If that file is absent (some setups don't write\nit), use the tools below instead.\n\nBefore any payment, confirm the *live remaining* budget with the tools \u2014\n`agent.json` shows the configured budget, not what is left after recent\nspending:\n\n- `mcp__haven__haven_get_agent` \u2014 the recommended first call: identity\n  (wallet, network) plus a readiness signal (`ready` / `needs_approval` /\n  `revoked`) and live remaining per-token allowance, in one shot.\n- `mcp__haven__haven_get_allowances` \u2014 detailed per-token breakdown\n  (configured, spent, reset window) when you need more than the summary.\n\nBudgets reset on a period the user chose. If a payment exceeds the remaining\nbudget it is queued for the user to approve in the Haven dashboard \u2014 this is\nnormal, not an error.\n\n## Paying\n\n**Catalog purchases \u2014 the primary path for MCP merchants:**\n\n1. `mcp__haven__haven_discover_tools` to find a payable service and its\n   `catalog_id`.\n2. `mcp__haven__haven_prepare_catalog_purchase` with `catalog_id` and a\n   spending cap. A cap is REQUIRED on this tool and is best practice on every\n   paid call below too \u2014 it caps what the LIVE merchant quote may charge,\n   checked before any funding intent is created. Write it the way the user\n   said it: `max_amount_human` is whole tokens, so \"no more than 1 USDC\" is\n   `max_amount_human: \"1\"`. (`max_amount` is the atomic-unit form, where\n   \"1\" means 0.000001 USDC \u2014 do not convert by hand, and never send both.)\n3. Then FOLLOW THE RESPONSE'S GUIDANCE FIELDS: `next_action`, `next_tool`,\n   and `next_arguments` name the exact next call \u2014 act on those first; the\n   prose in this section is fallback and debugging detail. If the catalog\n   entry is missing or degraded, the response instead names\n   `mcp__haven__haven_pay_mcp_tool` (merchant URL, tool name, arguments) as\n   the manual fallback.\n\n**Signing:** `mcp__haven-signer__haven_sign_x402` with `payment_id` ONLY \u2014\nthe local signer fetches the exact signing bytes AND `payment_required`\nitself, so never relay `typed_data` or the 402 blob yourself. If the signer\nreports its fetched context carried no `payment_required` (older backend),\nre-call with `payment_required` added verbatim. Fallback for an older signer\nor backend: re-run the quote/prepare tool with the SAME `idempotency_key`\nplus `include_signing_payload=true`, then pass `payload_hash`,\n`x402_expected` (the nested `x402.expected` object), and\n`typed_data`/`typed_data_b64` through unchanged.\n\n**Settle:** `mcp__haven__haven_settle_mcp_tool` with `payment_id`,\n`signature`, and `payment_header` ONLY \u2014 Haven rehydrates the merchant call\ncontext (`merchant_url`, `tool_name`, `arguments`, `mcp_transport`)\nserver-side from `payment_id`. Pass those four fields explicitly only as a\nversion-skew fallback when Haven has no stored context for the id \u2014 both or\nnone together, never just one. If the settle result carries `settled: false`,\nfunding is queued for the user's approval \u2014 tell them and check status later,\ndo not re-pay.\n\nStep-by-step alternative (also key-safe; for an older signer or backend, or\nwhen you already have a merchant URL and tool name instead of a\n`catalog_id`): `mcp__haven__haven_pay_mcp_tool` then\n`mcp__haven-signer__haven_sign` \u2192 `mcp__haven__haven_submit` \u2192\n`mcp__haven-signer__haven_x402_sign_header` \u2192\n`mcp__haven__haven_complete_mcp_tool`. Pass `payment_required`,\n`arguments`, and `mcp_transport` verbatim from the quote/prepare result.\nThe returned `expires_at` is the signing window; if a tool returns\n`PAYMENT_WINDOW_EXPIRED`, re-run the same quote/prepare tool with the same\n`idempotency_key`. Do not call the merchant yourself \u2014 Haven completes the\nmerchant leg for you.\n\n**Direct transfer / non-MCP paywall:** `mcp__haven__haven_pay` with\nrecipient, amount, and token for a plain transfer. For an arbitrary,\nnon-MCP x402 paywall: `mcp__haven__haven_quote_x402` to get a quote, then\n`mcp__haven__haven_pay_x402_quote` \u2014 follow the result's guidance fields\nfirst, sign in the local Haven signer, and retry the original request only\nwhen the result says `retry_original_x402_request`.\n\n**Catalog tool arguments:** when `haven_discover_tools` returns\n`tool_arguments`, pass that object unchanged as the pay tool's\n`arguments` field (for example\n`tool_arguments: { \"tier\": \"50gb\" }` -> `arguments: { \"tier\": \"50gb\" }`).\n\n**Prices:** show the user the live price from the pay-tool result, never a\ncatalog price. `haven_discover_tools` prices are indicative\n(`price_is_indicative`) and can be stale. The pay-tool result's `amount` /\n`amount_atomic` is the amount Haven authorizes for the call \u2014 a ceiling the\nmerchant settles at or below \u2014 so present it as the most the user will pay.\n\n**Status:** `mcp__haven__haven_get_payment_status` with a `payment_id` to\ncheck on queued or in-flight payments. Do not poll in a tight loop.\n\n## Approval semantics\n\n- A result with `pending_approval` means the payment exceeded the remaining\n  budget and is waiting for the user in Haven. Tell the user, then check\n  status later.\n- `safe_to_continue: false` on a guidance block is the same signal in\n  machine-readable form: stop and involve the user before calling anything\n  else for this payment.\n- Never ask the user for private keys. Signing happens only in the local Haven\n  signer; the hosted Haven tools never receive the signing key. If a tool\n  reports a missing or invalid credential, tell the user to re-run the Haven\n  setup command.\n\n## Failure handling\n\nHaven tool failures are shaped like `{ success: false, code, message, ... }`\nor older `{ error, status, details? }` responses. Branch on `code` when\npresent and surface `message` or `error` verbatim. Common cases:\n\n- `pending_approval`: queued for the user's approval (see above).\n- `insufficient_funds`: the Haven wallet doesn't hold enough of that token.\n  Suggest the user add funds in the Haven dashboard.\n- `PRICE_EXCEEDS_MAX`: the live merchant price exceeded your cap. No funds\n  moved; ask the user before retrying with a higher one.\n- `AMBIGUOUS_MAX_AMOUNT`: you sent both `max_amount` and\n  `max_amount_human`. Nothing was contacted or spent \u2014 re-send with exactly\n  one (`max_amount_human` for a cap the user stated in tokens).\n- `MAX_AMOUNT_UNCONVERTIBLE`: `max_amount_human` does not fit this quote's\n  asset \u2014 unknown decimals, or more decimal places than the asset supports.\n  Round the cap, or send an exact atomic `max_amount`.\n- `PAYMENT_WINDOW_EXPIRED`: re-run the quote/prepare tool with the same\n  `idempotency_key`, then sign the fresh payload.\n- `MERCHANT_REJECTED_AFTER_FUNDING`: the merchant refused the paid retry.\n  Stop-and-sweep \u2014 stop retrying the merchant and use\n  `mcp__haven__haven_sweep_delegate` to recover stranded delegate funds.\n- `MERCHANT_UNRESPONSIVE_AFTER_FUNDING`: funding confirmed on-chain, but the\n  merchant never answered the paid retry. This is NOT proof of rejection \u2014 the\n  merchant may still settle late. Verify-then-sweep, never a blind sweep:\n  check `mcp__haven__haven_get_payment_status`, retry\n  `mcp__haven__haven_complete_mcp_tool` ONCE, and only sweep with\n  `mcp__haven__haven_sweep_delegate` if no settlement appears.\n- Budget exceeded: tell the user how much remains (from\n  `mcp__haven__haven_get_allowances`) and that they can raise the budget in\n  Haven.\n\n## Reporting after a purchase\n\nA settled `mcp__haven__haven_settle_mcp_tool` response carries\n`agent_summary.purchase_summary` and the remaining post-purchase allowance\nin `allowance` \u2014 report the product, Haven-derived payment/transaction\nfields, and what is left from those fields directly. `result` is optional\nraw merchant evidence; never use it to decide whether the purchase was paid.\nDo not call `haven_get_agent` or `haven_get_allowances` again just to\nreport a purchase you already made.\n\n## Revoke\n\nIf this agent's credential may have leaked, tell the user to pause or revoke\nthe agent in the Haven dashboard under Agents. New requests stop immediately\nfor that credential.\n";
 /** Directory name for the installed skill folder. */
 declare const SKILL_FOLDER_NAME = "haven-pay";
 
@@ -2061,7 +2008,7 @@ declare const SKILL_FOLDER_NAME = "haven-pay";
  * package. A guard test in each package asserts exactly that against its own
  * `package.json`, so the two cannot drift again silently.
  */
-declare const HAVEN_MINIMUM_NODE_VERSION = "24.0.0";
+declare const HAVEN_MINIMUM_NODE_VERSION = "22.0.0";
 /**
  * Compare two Node versions. Negative when `left` is older.
  *
@@ -2206,11 +2153,16 @@ declare function encodePaymentProof(receipt: {
     payer?: string;
     chainId?: number;
 }): string;
-
-declare function parseMachinePaymentChallenge(response: Response): MachinePaymentChallenge;
-declare function parseMachinePaymentChallengeResponse(response: Response): Promise<MachinePaymentChallenge>;
-declare function buildMachinePaymentIdempotencyKey(challenge: MachinePaymentChallenge): string;
-declare function encodeMachinePaymentProof(receipt: Omit<MachinePaymentReceipt, 'proofHeader'>): string;
+/**
+ * Resolve a token symbol from a contract address.
+ *
+ * Checks all supported chains. For chain-specific resolution,
+ * pass the optional `network` CAIP-2 string (e.g. "eip155:100").
+ */
+declare function resolveTokenFromAddress(address: string, network?: string): {
+    symbol: string;
+    decimals: number;
+} | null;
 
 /**
  * Runtime-agnostic base64 helpers — the single source of truth for the wire
@@ -2278,4 +2230,4 @@ declare function discoverMerchantMcpUrl(inputUrl: string): Promise<string | null
 /** Trailing-slash/percent-case echoes compare equal; unparseable never does. */
 declare function sameUrl(a: string, b: string): boolean;
 
-export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, MerchantTimeoutError, type MppAuthorizationOptions, type MppQuote, type MppResumeState, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedMppInput, type ResumeAuthorizedX402Input, type ResumeMppPaymentInput, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildMachinePaymentIdempotencyKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodeMachinePaymentProof, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };
+export { AGENT_PAYMENT_FAILURE_CODE_VALUES, AGENT_PAYMENT_NEXT_ACTION_VALUES, AGENT_PAYMENT_PHASE_VALUES, AGENT_PAYMENT_RAIL_VALUES, type AgentNextStep, type AgentPaymentEnumSchema, AgentPaymentFailureCode, AgentPaymentFailureCodeDescriptions, AgentPaymentFailureCodeSchema, AgentPaymentNextAction, AgentPaymentNextActionDescriptions, AgentPaymentNextActionSchema, AgentPaymentPhase, AgentPaymentPhaseDescriptions, AgentPaymentPhaseSchema, AgentPaymentRail, AgentPaymentRailDescriptions, AgentPaymentRailSchema, type AgentPaymentSummary, type AgentPaymentWarning, AgentPaymentWarningCode, type AgentPurchaseSummary, type ClaudeTool, DISCOVERY_MAX_BYTES, HAVEN_MINIMUM_NODE_VERSION, HAVEN_SKILL_MD, type HavenAgent, type HavenAgentAllowanceSummary, type HavenAgentReadiness, type HavenAgentSummary, type HavenAllowance, type HavenAllowanceSummary, HavenApiError, type HavenCatalogEntry, HavenClient, type HavenClientConfig, HavenError, type HavenPaymentReceipt, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, HavenUnsupportedSignerVersionError, MERCHANT_DISCOVERY_PATHS, type MachinePaymentRail, MerchantTimeoutError, type OpenAITool, type PaymentFee, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentReceipt, type PaymentRequest, type PaymentResult, type PaymentResumeState, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type PostPurchaseAllowanceSummary, RECEIPT_VERSION, type ReceiptVerification, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, SIGNER_UPDATE_FALLBACK, SKILL_FOLDER_NAME, SWEEP_BASE_CHAIN_ID, SWEEP_BASE_SEPOLIA_CHAIN_ID, SWEEP_BASE_SEPOLIA_USDC_ADDRESS, SWEEP_BASE_USDC_ADDRESS, type SharedToolKey, type SignData, SignerRefusalCode, type SweepAuthorization, type SweepEip712Domain, type SweepEntry, type SweepExpectedAuth, type SweepPreparation, type SweepPrepareResponse, type SweepResult, type SweepSubmitResponse, type SweepSubmitResult, type SweepTypedData, TRANSFER_WITH_AUTHORIZATION_TYPES, type ToolDescription, type UnsupportedNodeVersionMessageOptions, type X402AuthorizationOptions, type X402ExpectedAuth, type X402ExpectedContext, type X402Intent, type X402McpCallContext, type X402McpTransport, type X402MerchantCallContext, type X402PaymentOption, type X402PaymentRequired, type X402Quote, type X402Receipt, type X402RequestSnapshot, type X402ResumeState, X402UnexpectedStatusError, X402_MAX_AUTHORIZATION_WINDOW_SECONDS, X402_SETTLEMENT_FORWARD_MARGIN_SECONDS, addressFromKey, buildSweepAuthorizationMessage, buildSweepTypedData, buildX402ExpectedMessage, compareNodeVersions, composeDescription, decodeBase64Json, decodeBase64Utf8, discoverMerchantMcpUrl, encodeBase64Json, encodeBase64Utf8, encodePaymentProof, havenTools, isSupportedNodeVersion, isSweepableChain, parsePaymentRequired, parsePaymentRequiredResponse, resolveTokenFromAddress, sameUrl, selectPaymentOption, selectStandardPaymentOption, signHash, signUserOpTypedDataForDelegation, sweepUsdcAddress, sweepUsdcDomain, toStandardPaymentRequirements, toolDescriptions, unsupportedNodeVersionMessage, verifyPaymentReceipt, verifySignature, x402AuthorizationAmount };