Errors

Most of what your user can cause comes back as a result, such as declined. The SDK throws only when your app usually cannot fix things by asking the user. It throws one of two errors:

Each carries a reason. Compare the reason, never the message. The message is for your logs.

Catch themCopy Anchor Link

Use the guards, not instanceof. A guard still works when your bundle holds two copies of the SDK.

import {
  deposit,
  isNimbusSdkError,
  isNimbusSolanaFlowError,
} from "@umbra/nimbus-solana-web";

try {
  await deposit(context, { mint: usdc, amount: 5_000_000n, recipient: bob });
} catch (thrown) {
  if (isNimbusSolanaFlowError(thrown)) {
    console.error(thrown.reason, thrown.detail);
    showError("The payment was refused. Check the amount and the recipient.");
  } else if (isNimbusSdkError(thrown)) {
    console.error(thrown.reason, thrown.message);
    showError("Something went wrong. Try again in a moment.");
  } else {
    throw thrown;
  }
}

Rethrow anything neither guard knows. It is a bug in your app or in the SDK, not a refusal.

A NimbusSolanaFlowError also carries detail, the names and counts that locate the refusal. It never holds keys, so it is safe to log.

Results and errors lists every reason of both errors, with what to do about each.

NextCopy Anchor Link