Skip to Content
Symmio Frontier — the SDK surface for builders on HyperEVM
ReactErrors

Errors

Every SYMMIO React hook surfaces failures as a single error class — SymmioRequestError — with a kind discriminator the UI switches on.

SymmioRequestError

class SymmioRequestError extends Error {
  readonly name = "SymmioRequestError";
  readonly kind: "user-rejected" | "contract-revert" | "insufficient-funds" | "rpc" | "sdk" | "unknown";
  readonly reason?: string; // populated for kind === "contract-revert"
  readonly shortMessage?: string; // viem short message for kind === "rpc"
  // ...standard Error fields, including `cause`
}

Kinds, with intent

kindWhenTypical UI
user-rejectedWallet popup dismissed.Silent — no toast, no banner.
contract-revertOn-chain call reverted. reason carries the Solidity revert string.Show the reason inline.
insufficient-fundsSigning EOA had not enough native gas.”Top up your wallet” prompt.
rpcTransport-layer failure (network, node unreachable, bad response). shortMessage is the viem human-readable form.Generic “Try again later.”
sdkSDK precondition failed (unknown chain, missing wallet, missing config).Fix the app’s wiring; usually a bug.
unknownFell through every classifier.Show the message; treat as a bug to fix.

Branching in the UI

import { useEditAccountName } from "@symmio/trading-react";
 
function RenameButton() {
  const { mutate, error } = useEditAccountName();
 
  return (
    <>
      <button onClick={() => mutate({ account, name })}>Rename</button>
 
      {error?.kind === "user-rejected" ? null : null /* silent */}
      {error?.kind === "contract-revert" && <p className="error">Reverted: {error.reason}</p>}
      {error?.kind === "insufficient-funds" && <p className="warn">Top up your wallet to cover gas.</p>}
      {error?.kind === "rpc" && <p className="warn">{error.shortMessage}</p>}
      {error?.kind === "sdk" && <p className="error">SDK error: {error.message}</p>}
      {error?.kind === "unknown" && <p className="error">{error.message}</p>}
    </>
  );
}

normalizeSymmError

The classifier the hooks use internally. Convert any thrown value (viem error, SymmError, plain Error, anything) into a SymmioRequestError.

import { normalizeSymmError } from "@symmio/trading-react";
 
try {
  await someThirdPartyCall();
} catch (err) {
  const normalized = normalizeSymmError(err);
  showToast(normalized.kind, normalized.message);
}

Useful when:

  • You’re calling core functions directly (outside the hooks) and want the same UI-shaped errors.
  • You’re handling errors from a non-SDK source (a custom contract call, a fetch) and want one branching shape.

Re-exported SymmError

@symmio/trading-react re-exports SymmError from core for convenience. normalizeSymmError(symmError).kind is always "sdk".

import { SymmError } from "@symmio/trading-react"; // same as `from "@symmio/trading-core"`
Last updated on
Transactions storeOverview