ethers.jsのエラーメッセージを多言語化する「ethers-i18n」を作った

Error: insufficient funds for intrinsic transaction cost

npm install @nakamura196/ethers-i18n

import { setLocale, t, getLocale, getSupportedLocales } from "@nakamura196/ethers-i18n";

// サポートされているロケール一覧
console.log(getSupportedLocales()); // ["en", "ja", "ko", "zh"]

// 日本語に設定
setLocale("ja");
console.log(getLocale()); // "ja"

// エラーコードを翻訳
console.log(t("INVALID_ARGUMENT"));    // "無効な引数です"
console.log(t("INSUFFICIENT_FUNDS"));  // "トランザクションに必要な残高が不足しています"
console.log(t("NETWORK_ERROR"));       // "ネットワークエラーが発生しました"

import { setLocale } from "@nakamura196/ethers-i18n";
import { translateError } from "@nakamura196/ethers-i18n/wrapper";

setLocale("ja");

try {
  // ethers.jsの操作（例：不正なアドレスでの送金）
  await provider.getBalance("invalid-address");
} catch (error) {
  // ethers.jsのエラーコードを自動検出して翻訳
  const message = translateError(error);
  console.log(message); // "無効な引数です"
}

import { setLocale } from "@nakamura196/ethers-i18n";
import { withI18n } from "@nakamura196/ethers-i18n/wrapper";

setLocale("ja");

try {
  const balance = await withI18n(() => provider.getBalance("invalid-address"));
} catch (error) {
  // error.message は翻訳済み
  console.log(error.message); // "無効な引数です"

  // 元のメッセージも保持されている
  console.log(error.originalMessage); // "invalid argument"
}

// 設定は1行
setLocale("ja");

// 翻訳も1行
const msg = t("INVALID_ARGUMENT");

import { configure } from "@nakamura196/ethers-i18n";

configure({
  locale: "ja",
  fallback: "en", // 日本語訳がない場合は英語にフォールバック
});

// src/locales/fr.ts
import { LocaleMessages } from "../types";

export const fr: LocaleMessages = {
  INVALID_ARGUMENT: "argument invalide",
  MISSING_ARGUMENT: "argument manquant",
  UNEXPECTED_ARGUMENT: "argument inattendu",
  CALL_EXCEPTION: "exception d'appel de contrat",
  INSUFFICIENT_FUNDS: "fonds insuffisants pour la transaction",
  // ... 残りのエラーコードも定義
};

// React での使用例
import { setLocale } from "@nakamura196/ethers-i18n";
import { translateError } from "@nakamura196/ethers-i18n/wrapper";

function App() {
  // ブラウザの言語設定に応じてロケールを切り替え
  useEffect(() => {
    const lang = navigator.language.startsWith("ja") ? "ja" : "en";
    setLocale(lang);
  }, []);

  const handleTransaction = async () => {
    try {
      await contract.transfer(to, amount);
    } catch (error) {
      // ユーザーに分かりやすいメッセージを表示
      toast.error(translateError(error));
    }
  };
}

import { setLocale } from "@nakamura196/ethers-i18n";
import { withI18n } from "@nakamura196/ethers-i18n/wrapper";

// 環境変数でロケールを制御
setLocale(process.env.LANG?.startsWith("ja") ? "ja" : "en");

const balance = await withI18n(() => provider.getBalance(address));