@phala/pay 0.8.3 → 0.9.0

package/src/react/DepositAddress.tsx

@@ -1,240 +0,0 @@
-"use client";
-
-import { useEffect, useId, useState } from "react";
-import { formatUnits } from "viem";
-import { networkName } from "../chains.js";
-import {
-  retrieveDepositAddress,
-  type ClientDepositAddress,
-  type DepositAddressPayment,
-} from "../deposit-address.js";
-import { CheckoutError, pollDelay } from "../checkout.js";
-import { formatWait } from "../format.js";
-import { depositAddressTransfer, type DepositAddressDetails } from "../payment.js";
-import type { Appearance } from "./appearance.js";
-import { AssetIcon, NetworkIcon } from "./Icons.js";
-import { Field } from "./Field.js";
-import { QrCode } from "./QrCode.js";
-
-export interface DepositAddressProps {
-  /** `address` and `networks` from your backend's `POST /v1/deposit_addresses`. */
-  depositAddress: DepositAddressDetails;
-  /** The network shown first; the first of `networks` by default. */
-  chainId?: number;
-  /** The token shown first, for example `pha`; the network's first token by default. */
-  asset?: string;
-  /**
-   * The `client_secret` of the same response. With `apiBase`, the component follows the
-   * address's payments and shows each one within about a block of arriving: received with its
-   * confirmations, then credited, and states each network's typical credit time. Display only;
-   * credit from your `deposit.credited` webhook.
-   */
-  clientSecret?: string;
-  /** The service origin, for example `https://pay.example.com`; needed with `clientSecret`. */
-  apiBase?: string;
-  /** Milliseconds between payment reads; default 3000. */
-  pollInterval?: number;
-  appearance?: Appearance;
-  className?: string;
-}
-
-/**
- * A customer's persistent deposit address: one address for every supported token on every
- * supported network. The payer picks a network and a token; the component shows a QR code of that
- * EIP-681 transfer request and the address and token contract to copy. Any amount of a supported
- * token sent is credited at the market rate when it arrives; follow it from your backend's
- * `deposit.credited` webhook.
- */
-export function DepositAddress({
-  depositAddress,
-  chainId,
-  asset,
-  clientSecret,
-  apiBase,
-  pollInterval,
-  appearance,
-  className,
-}: DepositAddressProps) {
-  const { networks } = depositAddress;
-  const id = useId();
-  const view = useClientView(clientSecret, apiBase, pollInterval ?? 3000);
-  const payments = view?.payments ?? [];
-  const [selectedChain, setSelectedChain] = useState(chainId ?? networks[0]?.chain_id);
-  const [selectedAsset, setSelectedAsset] = useState(asset);
-  const network = networks.find((candidate) => candidate.chain_id === selectedChain) ?? networks[0];
-  if (network === undefined) {
-    throw new TypeError("the deposit address has no network");
-  }
-  const token =
-    network.assets.find((candidate) => candidate.asset === selectedAsset) ?? network.assets[0];
-  if (token === undefined) {
-    throw new TypeError(`the deposit address takes no token on chain ${network.chain_id}`);
-  }
-  const { token: contract, to } = depositAddressTransfer(network, token);
-  const symbol = token.asset.toUpperCase();
-  const name = networkName(network.chain_id);
-  return (
-    <div
-      className={className === undefined ? "pp-root" : `pp-root ${className}`}
-      data-theme={appearance?.theme ?? "light"}
-    >
-      <p className="pp-subtitle">
-        {depositAddress.address === null
-          ? "Reusable deposit address; varies by network"
-          : "One reusable address for supported tokens and networks"}
-      </p>
-      {networks.length > 1 && (
-        <fieldset className="pp-choices">
-          <legend>Network</legend>
-          {networks.map((each) => (
-            <label key={each.chain_id}>
-              <input
-                type="radio"
-                name={`${id}-network`}
-                checked={each.chain_id === network.chain_id}
-                onChange={() => setSelectedChain(each.chain_id)}
-              />
-              <NetworkIcon chainId={each.chain_id} size={16} />{" "}
-              {networkName(each.chain_id)}
-            </label>
-          ))}
-        </fieldset>
-      )}
-      {network.assets.length > 1 && (
-        <fieldset className="pp-choices">
-          <legend>Token</legend>
-          {network.assets.map((each) => (
-            <label key={each.asset}>
-              <input
-                type="radio"
-                name={`${id}-token`}
-                checked={each.asset === token.asset}
-                onChange={() => setSelectedAsset(each.asset)}
-              />
-              <AssetIcon asset={each.asset} size={16} />{" "}
-              {each.asset.toUpperCase()}
-            </label>
-          ))}
-        </fieldset>
-      )}
-      <div className="pp-qr-panel">
-        <QrCode value={token.payment_uri} label={`Deposit address for ${symbol} on ${name}`} />
-      </div>
-      <dl className="pp-fields">
-        <Field label="Network" value={`${name} (chain ID ${network.chain_id})`} />
-        <Field label={`Token (${symbol}) contract`} value={contract} copy />
-        <Field label="Deposit address" value={to} copy />
-      </dl>
-      {payments.length > 0 && (
-        <ul className="pp-payments" aria-live="polite" aria-label="Payments">
-          {payments.map((payment) => (
-            <li key={`${payment.chain_id}:${payment.tx_hash}:${payment.created}`}>
-              {paymentMessage(payment)}
-            </li>
-          ))}
-        </ul>
-      )}
-      <p className="pp-message">
-        Send {symbol} on {name}. Unsupported tokens or networks are not credited.{" "}
-        {creditMessage(networks.map((each) => each.chain_id), view)}
-      </p>
-    </div>
-  );
-}
-
-/** The address's public view, read every `interval` while mounted; `null` without a secret. */
-function useClientView(
-  clientSecret: string | undefined,
-  apiBase: string | undefined,
-  interval: number,
-): ClientDepositAddress | null {
-  const key = clientSecret === undefined || apiBase === undefined ? "" : `${apiBase} ${clientSecret}`;
-  const [current, setCurrent] = useState<{ key: string; view: ClientDepositAddress | null }>({
-    key: "",
-    view: null,
-  });
-  useEffect(() => {
-    if (clientSecret === undefined || apiBase === undefined) {
-      return;
-    }
-    const controller = new AbortController();
-    let stopped = false;
-    let timer: ReturnType<typeof setTimeout> | undefined;
-    let failures = 0;
-    const load = async () => {
-      let failure: CheckoutError | null = null;
-      try {
-        const view = await retrieveDepositAddress({ clientSecret, apiBase, signal: controller.signal });
-        failures = 0;
-        if (!stopped) {
-          setCurrent({ key, view });
-        }
-      } catch (error) {
-        failures += 1;
-        // A secret that is not valid will not become valid: stop, keep showing the address.
-        if (error instanceof CheckoutError && error.code === "invalid_client_secret") {
-          return;
-        }
-        failure = error instanceof CheckoutError ? error : null;
-      }
-      if (!stopped) {
-        timer = setTimeout(() => void load(), pollDelay(interval, failures, failure));
-      }
-    };
-    void load();
-    return () => {
-      stopped = true;
-      controller.abort();
-      clearTimeout(timer);
-    };
-  }, [key, clientSecret, apiBase, interval]);
-  // Another address starts without the previous one's view.
-  return current.key === key && key !== "" ? current.view : null;
-}
-
-/**
- * When a payment on each of `chainIds` is credited, from `view`'s typical credit times, for
- * example "usually in about 30 seconds on Ethereum and about 7 seconds on Base". Before the view
- * is loaded it names no time.
- */
-function creditMessage(chainIds: number[], view: ClientDepositAddress | null): string {
-  const names = new Map<number, string[]>();
-  for (const network of view?.networks ?? []) {
-    if (chainIds.includes(network.chain_id)) {
-      const seconds = network.typical_credit_seconds;
-      names.set(seconds, [...(names.get(seconds) ?? []), networkName(network.chain_id)]);
-    }
-  }
-  if (names.size === 0) {
-    return "Any amount is credited at the market rate after confirmation.";
-  }
-  const list = new Intl.ListFormat("en", { type: "conjunction" });
-  const [only, ...others] = names.keys();
-  const usually =
-    only !== undefined && others.length === 0
-      ? formatWait(only)
-      : list.format([...names].map(([seconds, on]) => `${formatWait(seconds)} on ${list.format(on)}`));
-  return `Any amount is credited at the market rate on arrival, usually in ${usually}.`;
-}
-
-function paymentMessage(payment: DepositAddressPayment): string {
-  const amount =
-    payment.asset === null || payment.decimals === null
-      ? "A payment"
-      : `${formatUnits(BigInt(payment.amount_atomic), payment.decimals)} ${payment.asset.toUpperCase()}`;
-  const on = `on ${networkName(payment.chain_id)}`;
-  switch (payment.status) {
-    case "seen":
-      return payment.confirmations === null
-        ? `${amount} received ${on}, crediting shortly`
-        : `${amount} received ${on}, ${payment.confirmations} confirmation${payment.confirmations === 1 ? "" : "s"}`;
-    case "confirming":
-      return `${amount} confirmed ${on}, crediting…`;
-    case "credited":
-      return `${amount} ${on} credited`;
-    case "rejected":
-      return `${amount} ${on} cannot be credited. Contact support with your transaction.`;
-    case "reversed":
-      return `${amount} ${on} was reversed: a chain reorganization replaced it and its credit was removed.`;
-  }
-}

package/src/react/Field.tsx

@@ -1,46 +0,0 @@
-import { useEffect, useState } from "react";
-
-/** `copy` adds a copy button, copying `value`, or the given string when it differs from it. */
-export function Field({
-  label,
-  value,
-  copy = false,
-}: {
-  label: string;
-  value: string;
-  copy?: boolean | string;
-}) {
-  return (
-    <div className="pp-field">
-      <dt>{label}</dt>
-      <dd>
-        <span className={copy === false ? undefined : "pp-value"}>{value}</span>
-        {copy !== false && (
-          <CopyButton value={typeof copy === "string" ? copy : value} label={label} />
-        )}
-      </dd>
-    </div>
-  );
-}
-
-function CopyButton({ value, label }: { value: string; label: string }) {
-  const [copied, setCopied] = useState<boolean | null>(null);
-  useEffect(() => {
-    if (copied === null) {
-      return;
-    }
-    const timer = setTimeout(() => setCopied(null), 2000);
-    return () => clearTimeout(timer);
-  }, [copied]);
-  const onClick = () => {
-    navigator.clipboard.writeText(value).then(
-      () => setCopied(true),
-      () => setCopied(false),
-    );
-  };
-  return (
-    <button type="button" className="pp-copy" onClick={onClick} aria-label={`Copy ${label}`}>
-      <span aria-live="polite">{copied === null ? "Copy" : copied ? "Copied" : "Copy failed"}</span>
-    </button>
-  );
-}

package/src/react/Icons.tsx

@@ -1,43 +0,0 @@
-"use client";
-
-import { networkName, networkIconName } from "../chains.js";
-import { assetIconName, iconMonogram, type IconName } from "../icon-names.js";
-import { ICON_PATHS } from "./icon-paths.js";
-
-export interface IconProps {
-  /** Width and height in pixels; default 18. No inline styles are injected. */
-  size?: number;
-  /** Default true next to visible text. Set false when the icon is used alone. */
-  decorative?: boolean;
-}
-export interface NetworkIconProps extends IconProps { chainId: number }
-export interface AssetIconProps extends IconProps { asset: string }
-
-function Icon({ name, label, size = 18, decorative = true }: IconProps & {
-  name: IconName | undefined;
-  label: string;
-}) {
-  const pixels = Number.isFinite(size) && size > 0 ? size : 18;
-  return (
-    <span className="pp-icon-label" role={decorative ? undefined : "img"}
-      aria-label={decorative ? undefined : label || "Unknown asset"}>
-      <svg className="pp-icon" xmlns="http://www.w3.org/2000/svg" width={pixels} height={pixels}
-        viewBox="0 0 24 24" fill="none" aria-hidden="true" focusable="false">
-        {name === undefined ? <>
-          <circle cx="12" cy="12" r="11" fill="currentColor" opacity="0.12" />
-          <text x="12" y="16" textAnchor="middle" fontFamily="sans-serif" fontSize="12" fill="currentColor">{iconMonogram(label)}</text>
-        </> : ICON_PATHS[name]}
-      </svg>
-    </span>
-  );
-}
-
-/** Branded network icon; testnets reuse their mainnet family artwork. */
-export function NetworkIcon({ chainId, ...props }: NetworkIconProps) {
-  return <Icon {...props} name={networkIconName(chainId)} label={networkName(chainId)} />;
-}
-
-/** Branded token icon, or a neutral first-letter monogram for unknown symbols. */
-export function AssetIcon({ asset, ...props }: AssetIconProps) {
-  return <Icon {...props} name={assetIconName(asset)} label={asset.trim().toUpperCase()} />;
-}

package/src/react/QrCode.tsx

@@ -1,39 +0,0 @@
-import { useMemo } from "react";
-import { encode } from "uqr";
-
-export interface QrCodeProps {
-  value: string;
-  label: string;
-  size?: number;
-}
-
-/** A QR code as an SVG path, one unit per module. */
-export function QrCode({ value, label, size = 208 }: QrCodeProps) {
-  const { path, width } = useMemo(() => {
-    const { data, size: modules } = encode(value, { ecc: "M", border: 2 });
-    let d = "";
-    data.forEach((row, y) => {
-      row.forEach((dark, x) => {
-        if (dark) {
-          d += `M${x} ${y}h1v1h-1z`;
-        }
-      });
-    });
-    return { path: d, width: modules };
-  }, [value]);
-
-  return (
-    <svg
-      className="pp-qr"
-      role="img"
-      aria-label={label}
-      width={size}
-      height={size}
-      viewBox={`0 0 ${width} ${width}`}
-      shapeRendering="crispEdges"
-    >
-      <rect width={width} height={width} fill="#fff" />
-      <path d={path} fill="#000" />
-    </svg>
-  );
-}

package/src/react/appearance.ts

@@ -1,4 +0,0 @@
-/** Base theme; customize CSS properties on `.pp-root` in your stylesheet. */
-export interface Appearance {
-  theme?: "light" | "dark";
-}

package/src/react/icon-paths.tsx

@@ -1,13 +0,0 @@
-/** Generated from @web3icons/core@4.0.57 by scripts/generate-icons.mjs.
- * SPDX-License-Identifier: MIT; Copyright (c) 2024 0xa3k5.
- * See THIRD_PARTY_NOTICES for the full license. Do not edit.
- */
-
-export const ICON_PATHS = {
-  usdc: <><path fill="#0B53BF" d="M12 21a9 9 0 1 0 0-18 9 9 0 0 0 0 18"/><path fill="#fff" d="M13.62 5.45v1.159a5.64 5.64 0 0 1 4.005 5.394 5.64 5.64 0 0 1-4.005 5.394v1.16a6.74 6.74 0 0 0 5.13-6.554 6.74 6.74 0 0 0-5.13-6.553m-7.245 6.553a5.64 5.64 0 0 1 4.005-5.394V5.45a6.74 6.74 0 0 0-5.13 6.553 6.74 6.74 0 0 0 5.13 6.553v-1.159a5.63 5.63 0 0 1-4.005-5.394"/><path fill="#fff" d="M14.419 13.258c0-2.301-3.606-1.356-3.606-2.627 0-.456.366-.748 1.063-.748.833 0 1.12.405 1.21.95h1.147c-.102-1.024-.69-1.67-1.67-1.863v-.904h-1.125v.872c-1.075.137-1.75.762-1.75 1.693 0 2.312 3.611 1.445 3.611 2.694 0 .472-.455.787-1.226.787-1.007 0-1.339-.444-1.462-1.057H9.49c.073 1.122.764 1.823 1.947 1.999v.886h1.125v-.875c1.153-.149 1.856-.82 1.856-1.807"/></>,
-  usdt: <><path fill="#009393" d="m12 19.2-9-8.88L6.433 4.8h11.134L21 10.32zm.9-8.1v-1.098c1.62.08 3.132.396 3.6.805-.544.477-2.493.824-4.5.824s-3.956-.347-4.5-.824c.463-.41 1.98-.72 3.6-.81V11.1zm-5.4-.297v.661c.463.41 1.975.72 3.6.81V14.7h1.8v-2.43c1.62-.081 3.136-.396 3.6-.806v-1.318c-.464-.41-1.98-.725-3.6-.81V8.4h2.7V7.05H8.4V8.4h2.7v.936c-1.625.085-3.137.4-3.6.81z"/></>,
-  pha: <><circle cx="12" cy="12" r="12" fill="#252525"/><path fill="#D1FF52" fillRule="evenodd" d="M3 3h14.143v3.857H21V12h-3.857V6.857H6.857V12H3zm3.857 12.857h10.286V12H6.857zm0 0V21H3v-5.143z" clipRule="evenodd"/></>,
-  eth: <><path fill="#8FFCF3" d="M12 3v6.65l5.625 2.516z"/><path fill="#CABCF8" d="m12 3-5.625 9.166L12 9.651z"/><path fill="#CBA7F5" d="M12 16.477v4.522l5.625-7.784z"/><path fill="#74A0F3" d="M12 21v-4.523l-5.625-3.262z"/><path fill="#CBA7F5" d="m12 15.43 5.625-3.263L12 9.65z"/><path fill="#74A0F3" d="M6.375 12.167 12 15.429V9.651z"/><path fill="#202699" fillRule="evenodd" d="m12 15.429-5.625-3.263L12 3l5.625 9.166zM6.749 11.9l5.16-8.41v6.115zm-.077.23 5.238-2.327v5.364zm5.418-2.327v5.364l5.233-3.038zm0-.198 5.16 2.295-5.16-8.41z" clipRule="evenodd"/><path fill="#202699" fillRule="evenodd" d="M12 16.406 6.375 13.21 12 21l5.625-7.79zm-4.995-2.633 4.905 2.79v4.005zm5.085 2.79v4.005l4.905-6.795z" clipRule="evenodd"/></>,
-  ethereum: <><path fill="#8FFCF3" d="M12 3v6.651l5.625 2.516z"/><path fill="#CABCF8" d="m12 3-5.625 9.166L12 9.653z"/><path fill="#CBA7F5" d="M12 16.478V21l5.625-7.784z"/><path fill="#74A0F3" d="M12 21v-4.522l-5.625-3.262z"/><path fill="#CBA7F5" d="m12 15.43 5.625-3.263L12 9.652z"/><path fill="#74A0F3" d="M6.375 12.167 12 15.43V9.652z"/><path fill="#202699" fillRule="evenodd" d="m12 15.43-5.625-3.263L12 3l5.624 9.166zm-5.252-3.528 5.161-8.41v6.114zm-.077.229 5.238-2.327v5.364zm5.418-2.327v5.364l5.234-3.037zm0-.198 5.161 2.296-5.161-8.41z" clipRule="evenodd"/><path fill="#202699" fillRule="evenodd" d="m12 16.406-5.625-3.195L12 21l5.624-7.79zm-4.995-2.633 4.904 2.79v4.005zm5.084 2.79v4.005l4.905-6.795z" clipRule="evenodd"/></>,
-  base: <><path fill="#00F" d="M3 4.706c0-.585 0-.877.11-1.101.106-.215.28-.39.496-.495C3.83 3 4.122 3 4.706 3h14.588c.585 0 .876 0 1.101.11.215.105.389.28.494.495.111.225.111.517.111 1.101v14.588c0 .585 0 .876-.11 1.101-.106.215-.28.389-.495.494-.225.111-.517.111-1.101.111H4.706c-.585 0-.876 0-1.101-.11a1.08 1.08 0 0 1-.494-.495C3 20.17 3 19.878 3 19.294z"/></>,
-};

package/src/react/index.ts

@@ -1,7 +0,0 @@
-"use client";
-
-export { Checkout, type CheckoutProps } from "./Checkout.js";
-export { DepositAddress, type DepositAddressProps } from "./DepositAddress.js";
-export { useCheckout, type UseCheckoutOptions, type UseCheckoutResult } from "./useCheckout.js";
-export type { Appearance } from "./appearance.js";
-export { NetworkIcon, AssetIcon, type IconProps, type NetworkIconProps, type AssetIconProps } from "./Icons.js";

package/src/react/useCheckout.ts

@@ -1,58 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from "react";
-import {
-  createCheckout,
-  type CheckoutOptions,
-  type CheckoutSession,
-  type CheckoutState,
-} from "../checkout.js";
-
-export type UseCheckoutOptions = Pick<
-  CheckoutOptions,
-  "clientSecret" | "expectedAddress" | "apiBase" | "pollInterval" | "signal" | "requestTimeout"
->;
-
-export interface UseCheckoutResult extends CheckoutState {
-  /** Reads the quote now, for example right after the wallet broadcast the payment. */
-  refresh: () => void;
-}
-
-const LOADING: CheckoutState = { status: "loading", quote: null, error: null };
-
-/** Follows a quote's public view for as long as the component is mounted. */
-export function useCheckout({
-  clientSecret,
-  expectedAddress,
-  apiBase,
-  pollInterval,
-  signal,
-  requestTimeout,
-}: UseCheckoutOptions): UseCheckoutResult {
-  const [current, setCurrent] = useState({ key: "", state: LOADING });
-  const checkout = useRef<CheckoutSession | null>(null);
-  const key = `${apiBase} ${clientSecret} ${expectedAddress}`;
-
-  useEffect(() => {
-    const instance = createCheckout({
-      clientSecret,
-      expectedAddress,
-      apiBase,
-      ...(pollInterval === undefined ? {} : { pollInterval }),
-      ...(signal === undefined ? {} : { signal }),
-      ...(requestTimeout === undefined ? {} : { requestTimeout }),
-    });
-    checkout.current = instance;
-    const unsubscribe = instance.subscribe((state) => setCurrent({ key, state }));
-    return () => {
-      unsubscribe();
-      instance.destroy();
-      checkout.current = null;
-    };
-  }, [key, clientSecret, expectedAddress, apiBase, pollInterval, signal, requestTimeout]);
-
-  const refresh = useCallback(() => {
-    void checkout.current?.refresh();
-  }, []);
-
-  // A new client secret starts from `loading`, not from the previous quote's state.
-  return { ...(current.key === key ? current.state : LOADING), refresh };
-}

package/src/server/addresses.ts

@@ -1,223 +0,0 @@
-import {
-  encodeAbiParameters,
-  getAddress,
-  getContractAddress,
-  keccak256,
-  concat,
-  type Address,
-  type Hex,
-} from "viem";
-
-/**
- * The forwarder `factory` deploys for `treasury` and `salt`: OpenZeppelin 5.x
- * `Clones.predictDeterministicAddressWithImmutableArgs` with `abi.encodePacked(treasury)`, so the
- * address commits to the factory, the implementation, the treasury, and the salt.
- */
-export function forwarderAddress(
-  factory: string,
-  implementation: string,
-  treasury: string,
-  salt: Hex,
-): Address {
-  const initCode = concat([
-    "0x61",
-    "0x0041", // runtime length: the 45-byte proxy and the 20 treasury bytes
-    "0x3d81600a3d39f3",
-    "0x363d3d373d3d3d363d73",
-    getAddress(implementation),
-    "0x5af43d82803e903d91602b57fd5bf3",
-    getAddress(treasury),
-  ]);
-  return getContractAddress({
-    opcode: "CREATE2",
-    from: getAddress(factory),
-    salt,
-    bytecodeHash: keccak256(initCode),
-  });
-}
-
-/** `keccak256(abi.encode(account, client_reference_id, "quote", quote_id))`: a quote's salt. */
-export function quoteSalt(account: string, clientReferenceId: string, quoteId: string): Hex {
-  return keccak256(
-    encodeAbiParameters(
-      [{ type: "string" }, { type: "string" }, { type: "string" }, { type: "string" }],
-      [account, clientReferenceId, "quote", quoteId],
-    ),
-  );
-}
-
-/**
- * `keccak256(abi.encode(account, livemode, client_reference_id, "deposit_address", version))`:
- * a deposit address's salt, the same on every chain.
- */
-export function depositAddressSalt(
-  account: string,
-  livemode: boolean,
-  clientReferenceId: string,
-  version: number | bigint,
-): Hex {
-  return keccak256(
-    encodeAbiParameters(
-      [
-        { type: "string" },
-        { type: "bool" },
-        { type: "string" },
-        { type: "string" },
-        { type: "uint256" },
-      ],
-      [account, livemode, clientReferenceId, "deposit_address", BigInt(version)],
-    ),
-  );
-}
-
-export interface Forwarder {
-  factory: string;
-  implementation: string;
-}
-
-/** The address of a quote over `treasury`, which you pin yourself (see `verifyQuoteAddress`). */
-export function quoteAddress(
-  forwarder: Forwarder,
-  quote: { client_reference_id: string; id: string },
-  treasury: string,
-  account: string,
-): Address {
-  return forwarderAddress(
-    forwarder.factory,
-    forwarder.implementation,
-    treasury,
-    quoteSalt(account, quote.client_reference_id, quote.id),
-  );
-}
-
-/** A deposit address on the network whose treasury is `treasury`, which you pin yourself. */
-export function depositAddress(
-  forwarder: Forwarder,
-  address: { livemode: boolean; client_reference_id: string; version: number },
-  treasury: string,
-  account: string,
-): Address {
-  return forwarderAddress(
-    forwarder.factory,
-    forwarder.implementation,
-    treasury,
-    depositAddressSalt(account, address.livemode, address.client_reference_id, address.version),
-  );
-}
-
-/** An address the service returned is not the one your pins derive: show nothing to pay. */
-export class AddressMismatchError extends Error {
-  override readonly name = "AddressMismatchError";
-}
-
-/**
- * What every address is recomputed from, configured on your server and never read from the
- * service: your account id (`acct_…`), the forwarder `factory` and `implementation` of the
- * attested deployment, and `treasuries`, your own treasury per chain id as you proved it. A
- * compromised service could return another treasury with the address that really derives from
- * it, so the response's `treasury` is never trusted.
- *
- * Live mode requires `treasuries`: without the chain's treasury the check fails closed. In test
- * mode an unpinned chain falls back to the response's treasury with a console warning.
- */
-export interface AddressPins extends Forwarder {
-  account: string;
-  treasuries?: Readonly<Record<number, string>> | undefined;
-}
-
-/**
- * The treasury an address on `chainId` must pay: the pinned one, which the response must name.
- */
-function pinnedTreasury(
-  pins: AddressPins,
-  livemode: boolean,
-  chainId: number,
-  treasury: string,
-  where: string,
-): string {
-  const pinned = pins.treasuries?.[chainId];
-  if (pinned === undefined) {
-    if (livemode) {
-      throw new AddressMismatchError(`${where}: live mode requires your pinned treasury of chain ${chainId}`);
-    }
-    console.warn(
-      `${where}: no pinned treasury of chain ${chainId}; the service's ${treasury} is trusted (test mode only)`,
-    );
-    return treasury;
-  }
-  if (!sameAddress(pinned, treasury)) {
-    throw new AddressMismatchError(`${where} pays a treasury that is not the pinned one`);
-  }
-  return pinned;
-}
-
-function requirePins(pins: AddressPins, where: string): void {
-  for (const field of ["account", "factory", "implementation"] as const) {
-    if (typeof pins[field] !== "string" || pins[field] === "") {
-      throw new AddressMismatchError(`${where}: the pinned ${field} is missing`);
-    }
-  }
-}
-
-function sameAddress(a: string, b: string): boolean {
-  return a.toLowerCase() === b.toLowerCase();
-}
-
-/**
- * Recomputes an open quote's address from your pins and returns it, the `expectedAddress` to
- * pass to `<Checkout>`. Throws `AddressMismatchError` unless the quote names your pinned
- * treasury of its chain and its address derives from it; in live mode also when the chain has no
- * pinned treasury.
- */
-export function verifyQuoteAddress(
-  pins: AddressPins,
-  quote: {
-    id: string;
-    livemode: boolean;
-    chain_id: number;
-    treasury: string;
-    address: string;
-    client_reference_id: string;
-  },
-): Address {
-  const where = `quote ${quote.id}`;
-  requirePins(pins, where);
-  const treasury = pinnedTreasury(pins, quote.livemode, quote.chain_id, quote.treasury, where);
-  const derived = quoteAddress(pins, quote, treasury, pins.account);
-  if (!sameAddress(derived, quote.address)) {
-    throw new AddressMismatchError(`${where} has an address the account cannot derive`);
-  }
-  return derived;
-}
-
-/**
- * Recomputes every network of an active deposit address from your pins and returns the address,
- * the same on every network. Throws `AddressMismatchError` as `verifyQuoteAddress` does, for any
- * network.
- */
-export function verifyDepositAddress(
-  pins: AddressPins,
-  address: {
-    id: string;
-    livemode: boolean;
-    client_reference_id: string;
-    version: number;
-    networks: readonly { chain_id: number; treasury: string; address: string }[];
-  },
-): Address {
-  requirePins(pins, `deposit address ${address.id}`);
-  let first: Address | undefined;
-  for (const network of address.networks) {
-    const where = `deposit address ${address.id} on chain ${network.chain_id}`;
-    const treasury = pinnedTreasury(pins, address.livemode, network.chain_id, network.treasury, where);
-    const derived = depositAddress(pins, address, treasury, pins.account);
-    if (!sameAddress(derived, network.address)) {
-      throw new AddressMismatchError(`${where} is not one the account can derive`);
-    }
-    first ??= derived;
-  }
-  if (first === undefined) {
-    throw new AddressMismatchError(`deposit address ${address.id} has no network`);
-  }
-  return first;
-}