@latticexyz/common 2.2.18-90aac1d4acce19ac592d47a090732dd11c1c3e7a → 2.2.18-9fa07c8489f1fbf167d0db01cd9aaa645a29c8e2

package/dist/actions.cjs

@@ -0,0 +1,334 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/actions/index.ts
+var actions_exports = {};
+__export(actions_exports, {
+  transactionQueue: () => transactionQueue,
+  writeObserver: () => writeObserver
+});
+module.exports = __toCommonJS(actions_exports);
+
+// src/writeContract.ts
+var import_actions5 = require("viem/actions");
+var import_p_retry = __toESM(require("p-retry"), 1);
+
+// src/debug.ts
+var import_debug = __toESM(require("debug"), 1);
+var debug = (0, import_debug.default)("mud:common");
+var error = (0, import_debug.default)("mud:common");
+debug.log = console.debug.bind(console);
+error.log = console.error.bind(console);
+
+// src/getNonceManagerId.ts
+var import_viem = require("viem");
+var import_actions = require("viem/actions");
+var import_utils = require("viem/utils");
+async function getNonceManagerId({
+  client,
+  address,
+  blockTag
+}) {
+  const chainId = client.chain?.id ?? await (0, import_utils.getAction)(client, import_actions.getChainId, "getChainId")({});
+  return `mud:createNonceManager:${chainId}:${(0, import_viem.getAddress)(address)}:${blockTag}`;
+}
+
+// src/createNonceManager.ts
+var import_actions2 = require("viem/actions");
+var import_p_queue = __toESM(require("p-queue"), 1);
+var import_utils2 = require("viem/utils");
+
+// src/findCause.ts
+function findCause(error2, fn) {
+  if (fn?.(error2)) return error2;
+  if (error2.cause instanceof Error) return findCause(error2.cause, fn);
+  return fn ? null : error2;
+}
+
+// src/createNonceManager.ts
+var debug2 = debug.extend("createNonceManager");
+function createNonceManager({
+  client,
+  address,
+  // TODO: rename to account?
+  blockTag = "latest",
+  broadcastChannelName,
+  queueConcurrency = 1
+}) {
+  const ref = { nonce: -1, noncePromise: null };
+  let channel = null;
+  if (typeof BroadcastChannel !== "undefined") {
+    const channelName = broadcastChannelName ? Promise.resolve(broadcastChannelName) : getNonceManagerId({ client, address, blockTag });
+    channelName.then((name) => {
+      channel = new BroadcastChannel(name);
+      channel.addEventListener("message", (event) => {
+        const nonce = JSON.parse(event.data);
+        debug2("got nonce from broadcast channel", nonce);
+        ref.nonce = nonce;
+      });
+    });
+  }
+  function hasNonce() {
+    return ref.nonce >= 0;
+  }
+  function getNonce() {
+    if (!hasNonce()) throw new Error("call resetNonce before using getNonce");
+    return ref.nonce;
+  }
+  function nextNonce() {
+    if (!hasNonce()) throw new Error("call resetNonce before using nextNonce");
+    const nonce = ref.nonce++;
+    channel?.postMessage(JSON.stringify(ref.nonce));
+    return nonce;
+  }
+  async function resetNonce() {
+    ref.noncePromise ??= (async () => {
+      ref.nonce = await (0, import_utils2.getAction)(client, import_actions2.getTransactionCount, "getTransactionCount")({ address, blockTag });
+      ref.noncePromise = null;
+      channel?.postMessage(JSON.stringify(ref.nonce));
+      debug2("reset nonce to", ref.nonce);
+    })();
+    await ref.noncePromise;
+  }
+  function shouldResetNonce(error2) {
+    const nonceError = findCause(error2, ({ name }) => name === "NonceTooLowError" || name === "NonceTooHighError");
+    return nonceError != null;
+  }
+  const mempoolQueue = new import_p_queue.default({ concurrency: queueConcurrency });
+  return {
+    hasNonce,
+    getNonce,
+    nextNonce,
+    resetNonce,
+    shouldResetNonce,
+    mempoolQueue
+  };
+}
+
+// src/getNonceManager.ts
+var nonceManagers = /* @__PURE__ */ new Map();
+async function getNonceManager({
+  client,
+  address,
+  // TODO: rename to account?
+  blockTag = "latest",
+  ...opts
+}) {
+  const id = await getNonceManagerId({ client, address, blockTag });
+  const nonceManager = nonceManagers.get(id) ?? createNonceManager({ client, address, blockTag, ...opts });
+  if (!nonceManagers.has(id)) {
+    nonceManagers.set(id, nonceManager);
+  }
+  if (!nonceManager.hasNonce()) {
+    await nonceManager.resetNonce();
+  }
+  return nonceManager;
+}
+
+// src/writeContract.ts
+var import_accounts = require("viem/accounts");
+
+// src/getFeeRef.ts
+var import_actions4 = require("viem/actions");
+
+// src/createFeeRef.ts
+var import_actions3 = require("viem/actions");
+var import_utils3 = require("viem/utils");
+async function createFeeRef({ client, args, refreshInterval }) {
+  const feeRef = { fees: {}, lastUpdatedTimestamp: 0 };
+  async function updateFees() {
+    const fees = await (0, import_utils3.getAction)(client, import_actions3.estimateFeesPerGas, "estimateFeesPerGas")(args);
+    feeRef.fees = fees;
+    feeRef.lastUpdatedTimestamp = Date.now();
+  }
+  setInterval(updateFees, refreshInterval);
+  await updateFees();
+  return feeRef;
+}
+
+// src/getFeeRef.ts
+var import_utils4 = require("viem/utils");
+var feeRefs = /* @__PURE__ */ new Map();
+async function getFeeRef(opts) {
+  const chainId = opts.args?.chain?.id ?? opts.client.chain?.id ?? await (0, import_utils4.getAction)(opts.client, import_actions4.getChainId, "getChainId")({});
+  const existingFeeRef = feeRefs.get(chainId);
+  if (existingFeeRef) {
+    return existingFeeRef;
+  }
+  const feeRef = await createFeeRef(opts);
+  feeRefs.set(chainId, feeRef);
+  return feeRef;
+}
+
+// src/writeContract.ts
+var import_utils5 = require("viem/utils");
+var debug3 = debug.extend("writeContract");
+async function writeContract(client, request, opts = {}) {
+  const rawAccount = request.account ?? client.account;
+  if (!rawAccount) {
+    throw new Error("No account provided");
+  }
+  const account = (0, import_accounts.parseAccount)(rawAccount);
+  const chain = client.chain;
+  const nonceManager = await getNonceManager({
+    client: opts.publicClient ?? client,
+    address: account.address,
+    queueConcurrency: opts.queueConcurrency
+  });
+  const feeRef = await getFeeRef({
+    client: opts.publicClient ?? client,
+    refreshInterval: 1e4,
+    args: { chain }
+  });
+  return nonceManager.mempoolQueue.add(
+    () => (0, import_p_retry.default)(
+      async () => {
+        const nonce = nonceManager.nextNonce();
+        const params = {
+          // viem_writeContract internally estimates gas, which we want to happen on the pending block
+          blockTag: "pending",
+          ...feeRef.fees,
+          ...request,
+          nonce
+        };
+        debug3("calling", params.functionName, "at", params.address, "with nonce", nonce);
+        return await (0, import_utils5.getAction)(client, import_actions5.writeContract, "writeContract")(params);
+      },
+      {
+        retries: 3,
+        onFailedAttempt: async (error2) => {
+          debug3("failed, resetting nonce");
+          await nonceManager.resetNonce();
+          if (nonceManager.shouldResetNonce(error2)) {
+            debug3("got nonce error, retrying", error2.message);
+            return;
+          }
+          if (String(error2).includes("transaction underpriced")) {
+            debug3("got transaction underpriced error, retrying", error2.message);
+            return;
+          }
+          throw error2;
+        }
+      }
+    ),
+    { throwOnTimeout: true }
+  );
+}
+
+// src/sendTransaction.ts
+var import_actions6 = require("viem/actions");
+var import_p_retry2 = __toESM(require("p-retry"), 1);
+var import_accounts2 = require("viem/accounts");
+var import_utils6 = require("viem/utils");
+var debug4 = debug.extend("sendTransaction");
+async function sendTransaction(client, request, opts = {}) {
+  const rawAccount = request.account ?? client.account;
+  if (!rawAccount) {
+    throw new Error("No account provided");
+  }
+  const account = (0, import_accounts2.parseAccount)(rawAccount);
+  const chain = client.chain;
+  const nonceManager = await getNonceManager({
+    client: opts.publicClient ?? client,
+    address: account.address,
+    queueConcurrency: opts.queueConcurrency
+  });
+  const feeRef = await getFeeRef({
+    client: opts.publicClient ?? client,
+    refreshInterval: 1e4,
+    args: { chain }
+  });
+  return await nonceManager.mempoolQueue.add(
+    () => (0, import_p_retry2.default)(
+      async () => {
+        const nonce = nonceManager.nextNonce();
+        const params = {
+          // viem_sendTransaction internally estimates gas, which we want to happen on the pending block
+          blockTag: "pending",
+          ...feeRef.fees,
+          ...request,
+          nonce
+        };
+        debug4("sending tx to", request.to, "with nonce", nonce);
+        return await (0, import_utils6.getAction)(client, import_actions6.sendTransaction, "sendTransaction")(params);
+      },
+      {
+        retries: 3,
+        onFailedAttempt: async (error2) => {
+          debug4("failed, resetting nonce");
+          await nonceManager.resetNonce();
+          if (nonceManager.shouldResetNonce(error2)) {
+            debug4("got nonce error, retrying", error2.message);
+            return;
+          }
+          if (String(error2).includes("transaction underpriced")) {
+            debug4("got transaction underpriced error, retrying", error2.message);
+            return;
+          }
+          throw error2;
+        }
+      }
+    ),
+    { throwOnTimeout: true }
+  );
+}
+
+// src/actions/transactionQueue.ts
+function transactionQueue(opts = {}) {
+  return (client) => ({
+    // Applies to: `client.writeContract`, `getContract(client, ...).write`
+    writeContract: (args) => writeContract(client, args, opts),
+    // Applies to: `client.sendTransaction`
+    sendTransaction: (args) => sendTransaction(client, args, opts)
+  });
+}
+
+// src/actions/writeObserver.ts
+var import_utils7 = require("viem/utils");
+var import_actions7 = require("viem/actions");
+function writeObserver({
+  onWrite
+}) {
+  let nextWriteId = 0;
+  return (client) => ({
+    // Applies to: `client.writeContract`, `getContract(client, ...).write`
+    writeContract: (args) => {
+      const result = (0, import_utils7.getAction)(client, import_actions7.writeContract, "writeContract")(args);
+      const id = `${client.chain.id}:${client.account.address}:${nextWriteId++}`;
+      onWrite({ id, request: args, result });
+      return result;
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  transactionQueue,
+  writeObserver
+});
+//# sourceMappingURL=actions.cjs.map

package/dist/actions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/actions/index.ts","../src/writeContract.ts","../src/debug.ts","../src/getNonceManagerId.ts","../src/createNonceManager.ts","../src/findCause.ts","../src/getNonceManager.ts","../src/getFeeRef.ts","../src/createFeeRef.ts","../src/sendTransaction.ts","../src/actions/transactionQueue.ts","../src/actions/writeObserver.ts"],"sourcesContent":["export * from \"./transactionQueue\";\nexport * from \"./writeObserver\";\n","import {\n  Abi,\n  Account,\n  Chain,\n  Client,\n  Transport,\n  WriteContractParameters,\n  WriteContractReturnType,\n  ContractFunctionName,\n  ContractFunctionArgs,\n} from \"viem\";\nimport { writeContract as viem_writeContract } from \"viem/actions\";\nimport pRetry from \"p-retry\";\nimport { debug as parentDebug } from \"./debug\";\nimport { getNonceManager } from \"./getNonceManager\";\nimport { parseAccount } from \"viem/accounts\";\nimport { getFeeRef } from \"./getFeeRef\";\nimport { getAction } from \"viem/utils\";\n\nconst debug = parentDebug.extend(\"writeContract\");\n\nexport type WriteContractExtraOptions<chain extends Chain | undefined> = {\n  /**\n   * `publicClient` can be provided to be used in place of the extended viem client for making public action calls\n   * (`getChainId`, `getTransactionCount`, `simulateContract`). This helps in cases where the extended\n   * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),\n   * where the transport is the bundler, not an RPC.\n   */\n  publicClient?: Client<Transport, chain>;\n  /**\n   * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered\n   * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions\n   * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.\n   * @default 1\n   */\n  queueConcurrency?: number;\n};\n\n/** @deprecated Use `walletClient.extend(transactionQueue())` instead. */\nexport async function writeContract<\n  chain extends Chain | undefined,\n  account extends Account | undefined,\n  const abi extends Abi | readonly unknown[],\n  functionName extends ContractFunctionName<abi, \"nonpayable\" | \"payable\">,\n  args extends ContractFunctionArgs<abi, \"nonpayable\" | \"payable\", functionName>,\n  chainOverride extends Chain | undefined,\n>(\n  client: Client<Transport, chain, account>,\n  request: WriteContractParameters<abi, functionName, args, chain, account, chainOverride>,\n  opts: WriteContractExtraOptions<chain> = {},\n): Promise<WriteContractReturnType> {\n  const rawAccount = request.account ?? client.account;\n  if (!rawAccount) {\n    // TODO: replace with viem AccountNotFoundError once its exported\n    throw new Error(\"No account provided\");\n  }\n  const account = parseAccount(rawAccount);\n  const chain = client.chain;\n\n  const nonceManager = await getNonceManager({\n    client: opts.publicClient ?? client,\n    address: account.address,\n    queueConcurrency: opts.queueConcurrency,\n  });\n\n  const feeRef = await getFeeRef({\n    client: opts.publicClient ?? client,\n    refreshInterval: 10000,\n    args: { chain },\n  });\n\n  return nonceManager.mempoolQueue.add(\n    () =>\n      pRetry(\n        async () => {\n          const nonce = nonceManager.nextNonce();\n          const params = {\n            // viem_writeContract internally estimates gas, which we want to happen on the pending block\n            blockTag: \"pending\",\n            ...feeRef.fees,\n            ...request,\n            nonce,\n          } as const satisfies WriteContractParameters<abi, functionName, args, chain, account, chainOverride>;\n          debug(\"calling\", params.functionName, \"at\", params.address, \"with nonce\", nonce);\n          return await getAction(client, viem_writeContract, \"writeContract\")(params as never);\n        },\n        {\n          retries: 3,\n          onFailedAttempt: async (error) => {\n            // in case this tx failed before hitting the mempool (i.e. gas estimation error), reset nonce so we don't skip past the unused nonce\n            debug(\"failed, resetting nonce\");\n            await nonceManager.resetNonce();\n            // retry nonce errors\n            // TODO: upgrade p-retry and move this to shouldRetry\n            if (nonceManager.shouldResetNonce(error)) {\n              debug(\"got nonce error, retrying\", error.message);\n              return;\n            }\n\n            if (String(error).includes(\"transaction underpriced\")) {\n              debug(\"got transaction underpriced error, retrying\", error.message);\n              return;\n            }\n\n            throw error;\n          },\n        },\n      ),\n    { throwOnTimeout: true },\n  );\n}\n","import createDebug from \"debug\";\n\nexport const debug = createDebug(\"mud:common\");\nexport const error = createDebug(\"mud:common\");\n\n// Pipe debug output to stdout instead of stderr\ndebug.log = console.debug.bind(console);\n\n// Pipe error output to stderr\nerror.log = console.error.bind(console);\n","import { BlockTag, Client, Hex, getAddress } from \"viem\";\nimport { getChainId } from \"viem/actions\";\nimport { getAction } from \"viem/utils\";\n\nexport async function getNonceManagerId({\n  client,\n  address,\n  blockTag,\n}: {\n  client: Client;\n  address: Hex;\n  blockTag: BlockTag;\n}): Promise<string> {\n  // TODO: improve this so we don't have to call getChainId every time\n  const chainId = client.chain?.id ?? (await getAction(client, getChainId, \"getChainId\")({}));\n  return `mud:createNonceManager:${chainId}:${getAddress(address)}:${blockTag}`;\n}\n","import { BlockTag, Client, Hex } from \"viem\";\nimport { debug as parentDebug } from \"./debug\";\nimport { getNonceManagerId } from \"./getNonceManagerId\";\nimport { getTransactionCount } from \"viem/actions\";\nimport PQueue from \"p-queue\";\nimport { getAction } from \"viem/utils\";\nimport { findCause } from \"./findCause\";\n\nconst debug = parentDebug.extend(\"createNonceManager\");\n\nexport type CreateNonceManagerOptions = {\n  client: Client;\n  address: Hex;\n  blockTag?: BlockTag;\n  broadcastChannelName?: string;\n  queueConcurrency?: number;\n};\n\nexport type CreateNonceManagerResult = {\n  hasNonce: () => boolean;\n  getNonce: () => number;\n  nextNonce: () => number;\n  resetNonce: () => Promise<void>;\n  shouldResetNonce: (error: Error) => boolean;\n  mempoolQueue: PQueue;\n};\n\nexport function createNonceManager({\n  client,\n  address, // TODO: rename to account?\n  blockTag = \"latest\",\n  broadcastChannelName,\n  queueConcurrency = 1,\n}: CreateNonceManagerOptions): CreateNonceManagerResult {\n  const ref = { nonce: -1, noncePromise: null as Promise<void> | null };\n  let channel: BroadcastChannel | null = null;\n\n  if (typeof BroadcastChannel !== \"undefined\") {\n    const channelName = broadcastChannelName\n      ? Promise.resolve(broadcastChannelName)\n      : getNonceManagerId({ client, address, blockTag });\n    channelName.then((name) => {\n      channel = new BroadcastChannel(name);\n      // TODO: emit some sort of \"connected\" event so other channels can broadcast current nonce\n      channel.addEventListener(\"message\", (event) => {\n        const nonce = JSON.parse(event.data);\n        debug(\"got nonce from broadcast channel\", nonce);\n        ref.nonce = nonce;\n      });\n    });\n  }\n\n  function hasNonce(): boolean {\n    return ref.nonce >= 0;\n  }\n\n  function getNonce(): number {\n    if (!hasNonce()) throw new Error(\"call resetNonce before using getNonce\");\n    return ref.nonce;\n  }\n\n  function nextNonce(): number {\n    if (!hasNonce()) throw new Error(\"call resetNonce before using nextNonce\");\n    const nonce = ref.nonce++;\n    channel?.postMessage(JSON.stringify(ref.nonce));\n    return nonce;\n  }\n\n  async function resetNonce(): Promise<void> {\n    ref.noncePromise ??= (async (): Promise<void> => {\n      ref.nonce = await getAction(client, getTransactionCount, \"getTransactionCount\")({ address, blockTag });\n      ref.noncePromise = null;\n      channel?.postMessage(JSON.stringify(ref.nonce));\n      debug(\"reset nonce to\", ref.nonce);\n    })();\n    await ref.noncePromise;\n  }\n\n  function shouldResetNonce(error: Error): boolean {\n    const nonceError = findCause(error, ({ name }) => name === \"NonceTooLowError\" || name === \"NonceTooHighError\");\n    return nonceError != null;\n  }\n\n  const mempoolQueue = new PQueue({ concurrency: queueConcurrency });\n\n  return {\n    hasNonce,\n    getNonce,\n    nextNonce,\n    resetNonce,\n    shouldResetNonce,\n    mempoolQueue,\n  };\n}\n","export function findCause(error: Error, fn?: (error: Error) => boolean): Error | null {\n  if (fn?.(error)) return error;\n  if (error.cause instanceof Error) return findCause(error.cause, fn);\n  return fn ? null : error;\n}\n","import { CreateNonceManagerOptions, CreateNonceManagerResult, createNonceManager } from \"./createNonceManager\";\nimport { getNonceManagerId } from \"./getNonceManagerId\";\n\nconst nonceManagers = new Map<string, CreateNonceManagerResult>();\n\nexport async function getNonceManager({\n  client,\n  address, // TODO: rename to account?\n  blockTag = \"latest\",\n  ...opts\n}: CreateNonceManagerOptions): Promise<CreateNonceManagerResult> {\n  const id = await getNonceManagerId({ client, address, blockTag });\n\n  const nonceManager = nonceManagers.get(id) ?? createNonceManager({ client, address, blockTag, ...opts });\n  if (!nonceManagers.has(id)) {\n    nonceManagers.set(id, nonceManager);\n  }\n\n  if (!nonceManager.hasNonce()) {\n    await nonceManager.resetNonce();\n  }\n\n  return nonceManager;\n}\n","import { getChainId } from \"viem/actions\";\nimport { CreateFeeRefOptions, FeeRef, createFeeRef } from \"./createFeeRef\";\nimport { getAction } from \"viem/utils\";\n\nconst feeRefs = new Map<number, FeeRef>();\n\nexport async function getFeeRef(opts: CreateFeeRefOptions): Promise<FeeRef> {\n  const chainId =\n    opts.args?.chain?.id ?? opts.client.chain?.id ?? (await getAction(opts.client, getChainId, \"getChainId\")({}));\n\n  const existingFeeRef = feeRefs.get(chainId);\n  if (existingFeeRef) {\n    return existingFeeRef;\n  }\n\n  const feeRef = await createFeeRef(opts);\n  feeRefs.set(chainId, feeRef);\n  return feeRef;\n}\n","import { EstimateFeesPerGasParameters, Client, EstimateFeesPerGasReturnType } from \"viem\";\nimport { estimateFeesPerGas } from \"viem/actions\";\nimport { getAction } from \"viem/utils\";\n\nexport type CreateFeeRefOptions = {\n  client: Client;\n  refreshInterval: number;\n  args?: EstimateFeesPerGasParameters;\n};\n\nexport type FeeRef = {\n  fees: EstimateFeesPerGasReturnType | {};\n  lastUpdatedTimestamp: number;\n};\n\n/** Update fee values once every `refreshInterval` instead of right before every request */\nexport async function createFeeRef({ client, args, refreshInterval }: CreateFeeRefOptions): Promise<FeeRef> {\n  const feeRef: FeeRef = { fees: {}, lastUpdatedTimestamp: 0 };\n\n  async function updateFees(): Promise<void> {\n    const fees = await getAction(client, estimateFeesPerGas, \"estimateFeesPerGas\")(args);\n    feeRef.fees = fees;\n    feeRef.lastUpdatedTimestamp = Date.now();\n  }\n\n  setInterval(updateFees, refreshInterval);\n  await updateFees();\n\n  return feeRef;\n}\n","import {\n  Account,\n  Chain,\n  Client,\n  SendTransactionParameters,\n  Transport,\n  SendTransactionReturnType,\n  SendTransactionRequest,\n} from \"viem\";\nimport { sendTransaction as viem_sendTransaction } from \"viem/actions\";\nimport pRetry from \"p-retry\";\nimport { debug as parentDebug } from \"./debug\";\nimport { getNonceManager } from \"./getNonceManager\";\nimport { parseAccount } from \"viem/accounts\";\nimport { getFeeRef } from \"./getFeeRef\";\nimport { getAction } from \"viem/utils\";\n\nconst debug = parentDebug.extend(\"sendTransaction\");\n\nexport type SendTransactionExtraOptions<chain extends Chain | undefined> = {\n  /**\n   * `publicClient` can be provided to be used in place of the extended viem client for making public action calls\n   * (`getChainId`, `getTransactionCount`, `call`). This helps in cases where the extended\n   * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),\n   * where the transport is the bundler, not an RPC.\n   */\n  publicClient?: Client<Transport, chain>;\n  /**\n   * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered\n   * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions\n   * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.\n   * @default 1\n   */\n  queueConcurrency?: number;\n};\n\n/** @deprecated Use `walletClient.extend(transactionQueue())` instead. */\nexport async function sendTransaction<\n  chain extends Chain | undefined,\n  account extends Account | undefined,\n  const request extends SendTransactionRequest<chain, chainOverride>,\n  chainOverride extends Chain | undefined = undefined,\n>(\n  client: Client<Transport, chain, account>,\n  request: SendTransactionParameters<chain, account, chainOverride, request>,\n  opts: SendTransactionExtraOptions<chain> = {},\n): Promise<SendTransactionReturnType> {\n  const rawAccount = request.account ?? client.account;\n  if (!rawAccount) {\n    // TODO: replace with viem AccountNotFoundError once its exported\n    throw new Error(\"No account provided\");\n  }\n  const account = parseAccount(rawAccount);\n  const chain = client.chain;\n\n  const nonceManager = await getNonceManager({\n    client: opts.publicClient ?? client,\n    address: account.address,\n    queueConcurrency: opts.queueConcurrency,\n  });\n\n  const feeRef = await getFeeRef({\n    client: opts.publicClient ?? client,\n    refreshInterval: 10000,\n    args: { chain },\n  });\n\n  return await nonceManager.mempoolQueue.add(\n    () =>\n      pRetry(\n        async () => {\n          const nonce = nonceManager.nextNonce();\n          const params = {\n            // viem_sendTransaction internally estimates gas, which we want to happen on the pending block\n            blockTag: \"pending\",\n            ...feeRef.fees,\n            ...request,\n            nonce,\n          } as const satisfies SendTransactionParameters<chain, account, chainOverride, request>;\n          debug(\"sending tx to\", request.to, \"with nonce\", nonce);\n          return await getAction(client, viem_sendTransaction, \"sendTransaction\")(params as never);\n        },\n        {\n          retries: 3,\n          onFailedAttempt: async (error) => {\n            // in case this tx failed before hitting the mempool (i.e. gas estimation error), reset nonce so we don't skip past the unused nonce\n            debug(\"failed, resetting nonce\");\n            await nonceManager.resetNonce();\n            // retry nonce errors\n            // TODO: upgrade p-retry and move this to shouldRetry\n            if (nonceManager.shouldResetNonce(error)) {\n              debug(\"got nonce error, retrying\", error.message);\n              return;\n            }\n\n            if (String(error).includes(\"transaction underpriced\")) {\n              debug(\"got transaction underpriced error, retrying\", error.message);\n              return;\n            }\n\n            throw error;\n          },\n        },\n      ),\n    { throwOnTimeout: true },\n  );\n}\n","import type { Transport, Chain, Account, WalletActions, Client } from \"viem\";\nimport { writeContract as mud_writeContract } from \"../writeContract\";\nimport { sendTransaction as mud_sendTransaction } from \"../sendTransaction\";\n\nexport type TransactionQueueOptions<chain extends Chain | undefined> = {\n  /**\n   * `publicClient` can be provided to be used in place of the extended viem client for making public action calls\n   * (`getChainId`, `getTransactionCount`, `simulateContract`, `call`). This helps in cases where the extended\n   * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),\n   * where the transport is the bundler, not an RPC.\n   */\n  publicClient?: Client<Transport, chain>;\n  /**\n   * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered\n   * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions\n   * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.\n   * @default 1\n   */\n  queueConcurrency?: number;\n};\n\nexport function transactionQueue<chain extends Chain | undefined>(\n  opts: TransactionQueueOptions<chain> = {},\n): <transport extends Transport, account extends Account | undefined = Account | undefined>(\n  client: Client<transport, chain, account>,\n) => Pick<WalletActions<chain, account>, \"writeContract\" | \"sendTransaction\"> {\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args) => mud_writeContract(client, args, opts),\n    // Applies to: `client.sendTransaction`\n    sendTransaction: (args) => mud_sendTransaction(client, args, opts),\n  });\n}\n","import type {\n  WriteContractParameters,\n  Transport,\n  Chain,\n  Account,\n  WalletActions,\n  WriteContractReturnType,\n  Client,\n} from \"viem\";\nimport { getAction } from \"viem/utils\";\nimport { writeContract } from \"viem/actions\";\nimport { type ContractWrite } from \"../getContract\";\n\ntype WriteObserverParameters = { onWrite: (write: ContractWrite) => void };\n\nexport function writeObserver<TChain extends Chain, TAccount extends Account>({\n  onWrite,\n}: WriteObserverParameters): (\n  client: Client<Transport, TChain, TAccount>,\n) => Pick<WalletActions<TChain, TAccount>, \"writeContract\"> {\n  let nextWriteId = 0;\n\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args): Promise<WriteContractReturnType> => {\n      const result = getAction(client, writeContract, \"writeContract\")(args);\n\n      const id = `${client.chain.id}:${client.account.address}:${nextWriteId++}`;\n      onWrite({ id, request: args as WriteContractParameters, result });\n\n      return result;\n    },\n  });\n}\n"],"mappings":"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","names":["import_actions","createDebug","import_actions","import_utils","error","debug","error","PQueue","import_actions","import_actions","import_utils","import_utils","import_utils","debug","pRetry","viem_writeContract","error","import_actions","import_p_retry","import_accounts","import_utils","debug","pRetry","viem_sendTransaction","error","import_utils","import_actions"]}

package/dist/actions.d.cts

@@ -0,0 +1,27 @@
+import { Chain, Client, Transport, Account, WalletActions } from 'viem';
+import { C as ContractWrite } from './getContract-CA0EdVg6.cjs';
+
+type TransactionQueueOptions<chain extends Chain | undefined> = {
+    /**
+     * `publicClient` can be provided to be used in place of the extended viem client for making public action calls
+     * (`getChainId`, `getTransactionCount`, `simulateContract`, `call`). This helps in cases where the extended
+     * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),
+     * where the transport is the bundler, not an RPC.
+     */
+    publicClient?: Client<Transport, chain>;
+    /**
+     * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered
+     * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions
+     * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.
+     * @default 1
+     */
+    queueConcurrency?: number;
+};
+declare function transactionQueue<chain extends Chain | undefined>(opts?: TransactionQueueOptions<chain>): <transport extends Transport, account extends Account | undefined = Account | undefined>(client: Client<transport, chain, account>) => Pick<WalletActions<chain, account>, "writeContract" | "sendTransaction">;
+
+type WriteObserverParameters = {
+    onWrite: (write: ContractWrite) => void;
+};
+declare function writeObserver<TChain extends Chain, TAccount extends Account>({ onWrite, }: WriteObserverParameters): (client: Client<Transport, TChain, TAccount>) => Pick<WalletActions<TChain, TAccount>, "writeContract">;
+
+export { type TransactionQueueOptions, transactionQueue, writeObserver };

package/dist/actions.js

@@ -1,2 +1,40 @@
-import{a as o}from"./chunk-DPUUE7NM.js";import{f as a}from"./chunk-6FIKI2CG.js";import"./chunk-TCWGPC6G.js";function d(n={}){return e=>({writeContract:t=>o(e,t,n),sendTransaction:t=>a(e,t,n)})}import{getAction as s}from"viem/utils";import{writeContract as u}from"viem/actions";function f({onWrite:n}){let e=0;return t=>({writeContract:r=>{let i=s(t,u,"writeContract")(r),c=`${t.chain.id}:${t.account.address}:${e++}`;return n({id:c,request:r,result:i}),i}})}export{d as transactionQueue,f as writeObserver};
+import {
+  writeContract
+} from "./chunk-Z6SVAIZN.js";
+import {
+  sendTransaction
+} from "./chunk-MYWRXQQH.js";
+import "./chunk-MK6UECU7.js";
+
+// src/actions/transactionQueue.ts
+function transactionQueue(opts = {}) {
+  return (client) => ({
+    // Applies to: `client.writeContract`, `getContract(client, ...).write`
+    writeContract: (args) => writeContract(client, args, opts),
+    // Applies to: `client.sendTransaction`
+    sendTransaction: (args) => sendTransaction(client, args, opts)
+  });
+}
+
+// src/actions/writeObserver.ts
+import { getAction } from "viem/utils";
+import { writeContract as writeContract2 } from "viem/actions";
+function writeObserver({
+  onWrite
+}) {
+  let nextWriteId = 0;
+  return (client) => ({
+    // Applies to: `client.writeContract`, `getContract(client, ...).write`
+    writeContract: (args) => {
+      const result = getAction(client, writeContract2, "writeContract")(args);
+      const id = `${client.chain.id}:${client.account.address}:${nextWriteId++}`;
+      onWrite({ id, request: args, result });
+      return result;
+    }
+  });
+}
+export {
+  transactionQueue,
+  writeObserver
+};
 //# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/actions/transactionQueue.ts","../src/actions/writeObserver.ts"],"sourcesContent":["import type { Transport, Chain, Account, WalletActions, Client } from \"viem\";\nimport { writeContract as mud_writeContract } from \"../writeContract\";\nimport { sendTransaction as mud_sendTransaction } from \"../sendTransaction\";\n\nexport type TransactionQueueOptions<chain extends Chain | undefined> = {\n  /**\n   * `publicClient` can be provided to be used in place of the extended viem client for making public action calls\n   * (`getChainId`, `getTransactionCount`, `simulateContract`, `call`). This helps in cases where the extended\n   * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),\n   * where the transport is the bundler, not an RPC.\n   */\n  publicClient?: Client<Transport, chain>;\n  /**\n   * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered\n   * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions\n   * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.\n   * @default 1\n   */\n  queueConcurrency?: number;\n};\n\nexport function transactionQueue<chain extends Chain | undefined>(\n  opts: TransactionQueueOptions<chain> = {},\n): <transport extends Transport, account extends Account | undefined = Account | undefined>(\n  client: Client<transport, chain, account>,\n) => Pick<WalletActions<chain, account>, \"writeContract\" | \"sendTransaction\"> {\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args) => mud_writeContract(client, args, opts),\n    // Applies to: `client.sendTransaction`\n    sendTransaction: (args) => mud_sendTransaction(client, args, opts),\n  });\n}\n","import type {\n  WriteContractParameters,\n  Transport,\n  Chain,\n  Account,\n  WalletActions,\n  WriteContractReturnType,\n  Client,\n} from \"viem\";\nimport { getAction } from \"viem/utils\";\nimport { writeContract } from \"viem/actions\";\nimport { type ContractWrite } from \"../getContract\";\n\ntype WriteObserverParameters = { onWrite: (write: ContractWrite) => void };\n\nexport function writeObserver<TChain extends Chain, TAccount extends Account>({\n  onWrite,\n}: WriteObserverParameters): (\n  client: Client<Transport, TChain, TAccount>,\n) => Pick<WalletActions<TChain, TAccount>, \"writeContract\"> {\n  let nextWriteId = 0;\n\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args): Promise<WriteContractReturnType> => {\n      const result = getAction(client, writeContract, \"writeContract\")(args);\n\n      const id = `${client.chain.id}:${client.account.address}:${nextWriteId++}`;\n      onWrite({ id, request: args as WriteContractParameters, result });\n\n      return result;\n    },\n  });\n}\n"],"mappings":"4GAqBO,SAASA,EACdC,EAAuC,CAAC,EAGoC,CAC5E,OAAQC,IAAY,CAElB,cAAgBC,GAASC,EAAkBF,EAAQC,EAAMF,CAAI,EAE7D,gBAAkBE,GAASE,EAAoBH,EAAQC,EAAMF,CAAI,CACnE,EACF,CCvBA,OAAS,aAAAK,MAAiB,aAC1B,OAAS,iBAAAC,MAAqB,eAKvB,SAASC,EAA8D,CAC5E,QAAAC,CACF,EAE4D,CAC1D,IAAIC,EAAc,EAElB,OAAQC,IAAY,CAElB,cAAgBC,GAA2C,CACzD,IAAMC,EAASP,EAAUK,EAAQJ,EAAe,eAAe,EAAEK,CAAI,EAE/DE,EAAK,GAAGH,EAAO,MAAM,EAAE,IAAIA,EAAO,QAAQ,OAAO,IAAID,GAAa,GACxE,OAAAD,EAAQ,CAAE,GAAAK,EAAI,QAASF,EAAiC,OAAAC,CAAO,CAAC,EAEzDA,CACT,CACF,EACF","names":["transactionQueue","opts","client","args","writeContract","sendTransaction","getAction","writeContract","writeObserver","onWrite","nextWriteId","client","args","result","id"]}
+{"version":3,"sources":["../src/actions/transactionQueue.ts","../src/actions/writeObserver.ts"],"sourcesContent":["import type { Transport, Chain, Account, WalletActions, Client } from \"viem\";\nimport { writeContract as mud_writeContract } from \"../writeContract\";\nimport { sendTransaction as mud_sendTransaction } from \"../sendTransaction\";\n\nexport type TransactionQueueOptions<chain extends Chain | undefined> = {\n  /**\n   * `publicClient` can be provided to be used in place of the extended viem client for making public action calls\n   * (`getChainId`, `getTransactionCount`, `simulateContract`, `call`). This helps in cases where the extended\n   * viem client is a smart account client, like in [permissionless.js](https://github.com/pimlicolabs/permissionless.js),\n   * where the transport is the bundler, not an RPC.\n   */\n  publicClient?: Client<Transport, chain>;\n  /**\n   * Adjust the number of concurrent calls to the mempool. This defaults to `1` to ensure transactions are ordered\n   * and nonces are handled properly. Any number greater than that is likely to see nonce errors and/or transactions\n   * arriving out of order, but this may be an acceptable trade-off for some applications that can safely retry.\n   * @default 1\n   */\n  queueConcurrency?: number;\n};\n\nexport function transactionQueue<chain extends Chain | undefined>(\n  opts: TransactionQueueOptions<chain> = {},\n): <transport extends Transport, account extends Account | undefined = Account | undefined>(\n  client: Client<transport, chain, account>,\n) => Pick<WalletActions<chain, account>, \"writeContract\" | \"sendTransaction\"> {\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args) => mud_writeContract(client, args, opts),\n    // Applies to: `client.sendTransaction`\n    sendTransaction: (args) => mud_sendTransaction(client, args, opts),\n  });\n}\n","import type {\n  WriteContractParameters,\n  Transport,\n  Chain,\n  Account,\n  WalletActions,\n  WriteContractReturnType,\n  Client,\n} from \"viem\";\nimport { getAction } from \"viem/utils\";\nimport { writeContract } from \"viem/actions\";\nimport { type ContractWrite } from \"../getContract\";\n\ntype WriteObserverParameters = { onWrite: (write: ContractWrite) => void };\n\nexport function writeObserver<TChain extends Chain, TAccount extends Account>({\n  onWrite,\n}: WriteObserverParameters): (\n  client: Client<Transport, TChain, TAccount>,\n) => Pick<WalletActions<TChain, TAccount>, \"writeContract\"> {\n  let nextWriteId = 0;\n\n  return (client) => ({\n    // Applies to: `client.writeContract`, `getContract(client, ...).write`\n    writeContract: (args): Promise<WriteContractReturnType> => {\n      const result = getAction(client, writeContract, \"writeContract\")(args);\n\n      const id = `${client.chain.id}:${client.account.address}:${nextWriteId++}`;\n      onWrite({ id, request: args as WriteContractParameters, result });\n\n      return result;\n    },\n  });\n}\n"],"mappings":";;;;;;;;;AAqBO,SAAS,iBACd,OAAuC,CAAC,GAGoC;AAC5E,SAAO,CAAC,YAAY;AAAA;AAAA,IAElB,eAAe,CAAC,SAAS,cAAkB,QAAQ,MAAM,IAAI;AAAA;AAAA,IAE7D,iBAAiB,CAAC,SAAS,gBAAoB,QAAQ,MAAM,IAAI;AAAA,EACnE;AACF;;;ACvBA,SAAS,iBAAiB;AAC1B,SAAS,iBAAAA,sBAAqB;AAKvB,SAAS,cAA8D;AAAA,EAC5E;AACF,GAE4D;AAC1D,MAAI,cAAc;AAElB,SAAO,CAAC,YAAY;AAAA;AAAA,IAElB,eAAe,CAAC,SAA2C;AACzD,YAAM,SAAS,UAAU,QAAQA,gBAAe,eAAe,EAAE,IAAI;AAErE,YAAM,KAAK,GAAG,OAAO,MAAM,EAAE,IAAI,OAAO,QAAQ,OAAO,IAAI,aAAa;AACxE,cAAQ,EAAE,IAAI,SAAS,MAAiC,OAAO,CAAC;AAEhE,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":["writeContract"]}

package/dist/chains.cjs

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/chains/index.ts
+var chains_exports = {};
+__export(chains_exports, {
+  garnet: () => garnet,
+  mudFoundry: () => mudFoundry,
+  redstone: () => redstone,
+  rhodolite: () => rhodolite
+});
+module.exports = __toCommonJS(chains_exports);
+
+// src/chains/mudFoundry.ts
+var import_chains = require("viem/chains");
+var mudFoundry = {
+  ...import_chains.foundry,
+  fees: {
+    defaultPriorityFee: 0n
+  }
+};
+
+// src/chains/redstone.ts
+var import_chains2 = require("viem/chains");
+var redstone = {
+  ...import_chains2.redstone,
+  iconUrls: ["https://redstone.xyz/chain-icons/redstone.png"],
+  indexerUrl: "https://indexer.mud.redstonechain.com"
+};
+
+// src/chains/garnet.ts
+var import_chains3 = require("viem/chains");
+var garnet = {
+  ...import_chains3.garnet,
+  iconUrls: ["https://redstone.xyz/chain-icons/garnet.png"],
+  indexerUrl: "https://indexer.mud.garnetchain.com"
+};
+
+// src/chains/rhodolite.ts
+var import_op_stack = require("viem/op-stack");
+var sourceId = 17e3;
+var defaultRpcUrls = {
+  http: ["https://rpc.rhodolitechain.com"],
+  webSocket: ["wss://rpc.rhodolitechain.com"]
+};
+var rhodolite = {
+  ...import_op_stack.chainConfig,
+  name: "Rhodolite Devnet",
+  testnet: true,
+  id: 17420,
+  sourceId,
+  nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+  rpcUrls: {
+    default: defaultRpcUrls,
+    bundler: defaultRpcUrls,
+    quarryPassIssuer: defaultRpcUrls,
+    wiresaw: defaultRpcUrls
+  },
+  contracts: {
+    ...import_op_stack.chainConfig.contracts,
+    l1StandardBridge: {
+      [sourceId]: {
+        address: "0x6487446e0B9FAEa90F6a9772A6448cFa780E30F9"
+      }
+    },
+    quarryPaymaster: {
+      address: "0x7ca1b85aca23fccf2fbac14c02b5e8a6432639b9"
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Blockscout",
+      url: "https://explorer.rhodolitechain.com"
+    },
+    worldsExplorer: {
+      name: "MUD Worlds Explorer",
+      url: "https://explorer.mud.dev/rhodolite/worlds"
+    }
+  },
+  iconUrls: ["https://redstone.xyz/chain-icons/rhodolite.png"],
+  indexerUrl: "https://indexer.mud.rhodolitechain.com"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  garnet,
+  mudFoundry,
+  redstone,
+  rhodolite
+});
+//# sourceMappingURL=chains.cjs.map

package/dist/chains.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains/index.ts","../src/chains/mudFoundry.ts","../src/chains/redstone.ts","../src/chains/garnet.ts","../src/chains/rhodolite.ts"],"sourcesContent":["export type { MUDChain } from \"./types\";\nexport { mudFoundry } from \"./mudFoundry\";\nexport { redstone } from \"./redstone\";\nexport { garnet } from \"./garnet\";\nexport { rhodolite } from \"./rhodolite\";\n","import { foundry } from \"viem/chains\";\nimport { MUDChain } from \"./types\";\n\nexport const mudFoundry = {\n  ...foundry,\n  fees: {\n    defaultPriorityFee: 0n,\n  },\n} as const satisfies MUDChain;\n","import { redstone as redstoneConfig } from \"viem/chains\";\nimport type { MUDChain } from \"./types\";\n\nexport const redstone = {\n  ...redstoneConfig,\n  iconUrls: [\"https://redstone.xyz/chain-icons/redstone.png\"],\n  indexerUrl: \"https://indexer.mud.redstonechain.com\",\n} as const satisfies MUDChain;\n","import { garnet as garnetConfig } from \"viem/chains\";\nimport type { MUDChain } from \"./types\";\n\nexport const garnet = {\n  ...garnetConfig,\n  iconUrls: [\"https://redstone.xyz/chain-icons/garnet.png\"],\n  indexerUrl: \"https://indexer.mud.garnetchain.com\",\n} as const satisfies MUDChain;\n","import { chainConfig } from \"viem/op-stack\";\nimport { MUDChain } from \"./types\";\nimport { Chain } from \"viem\";\n\nconst sourceId = 17000;\n\nconst defaultRpcUrls = {\n  http: [\"https://rpc.rhodolitechain.com\"],\n  webSocket: [\"wss://rpc.rhodolitechain.com\"],\n} as const satisfies Chain[\"rpcUrls\"][\"default\"];\n\nexport const rhodolite = {\n  ...chainConfig,\n  name: \"Rhodolite Devnet\",\n  testnet: true,\n  id: 17420,\n  sourceId,\n  nativeCurrency: { name: \"Ether\", symbol: \"ETH\", decimals: 18 },\n  rpcUrls: {\n    default: defaultRpcUrls,\n    bundler: defaultRpcUrls,\n    quarryPassIssuer: defaultRpcUrls,\n    wiresaw: defaultRpcUrls,\n  },\n  contracts: {\n    ...chainConfig.contracts,\n    l1StandardBridge: {\n      [sourceId]: {\n        address: \"0x6487446e0B9FAEa90F6a9772A6448cFa780E30F9\",\n      },\n    },\n    quarryPaymaster: {\n      address: \"0x7ca1b85aca23fccf2fbac14c02b5e8a6432639b9\",\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Blockscout\",\n      url: \"https://explorer.rhodolitechain.com\",\n    },\n    worldsExplorer: {\n      name: \"MUD Worlds Explorer\",\n      url: \"https://explorer.mud.dev/rhodolite/worlds\",\n    },\n  },\n  iconUrls: [\"https://redstone.xyz/chain-icons/rhodolite.png\"],\n  indexerUrl: \"https://indexer.mud.rhodolitechain.com\",\n} as const satisfies MUDChain;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAwB;AAGjB,IAAM,aAAa;AAAA,EACxB,GAAG;AAAA,EACH,MAAM;AAAA,IACJ,oBAAoB;AAAA,EACtB;AACF;;;ACRA,IAAAA,iBAA2C;AAGpC,IAAM,WAAW;AAAA,EACtB,GAAG,eAAAC;AAAA,EACH,UAAU,CAAC,+CAA+C;AAAA,EAC1D,YAAY;AACd;;;ACPA,IAAAC,iBAAuC;AAGhC,IAAM,SAAS;AAAA,EACpB,GAAG,eAAAC;AAAA,EACH,UAAU,CAAC,6CAA6C;AAAA,EACxD,YAAY;AACd;;;ACPA,sBAA4B;AAI5B,IAAM,WAAW;AAEjB,IAAM,iBAAiB;AAAA,EACrB,MAAM,CAAC,gCAAgC;AAAA,EACvC,WAAW,CAAC,8BAA8B;AAC5C;AAEO,IAAM,YAAY;AAAA,EACvB,GAAG;AAAA,EACH,MAAM;AAAA,EACN,SAAS;AAAA,EACT,IAAI;AAAA,EACJ;AAAA,EACA,gBAAgB,EAAE,MAAM,SAAS,QAAQ,OAAO,UAAU,GAAG;AAAA,EAC7D,SAAS;AAAA,IACP,SAAS;AAAA,IACT,SAAS;AAAA,IACT,kBAAkB;AAAA,IAClB,SAAS;AAAA,EACX;AAAA,EACA,WAAW;AAAA,IACT,GAAG,4BAAY;AAAA,IACf,kBAAkB;AAAA,MAChB,CAAC,QAAQ,GAAG;AAAA,QACV,SAAS;AAAA,MACX;AAAA,IACF;AAAA,IACA,iBAAiB;AAAA,MACf,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,UAAU,CAAC,gDAAgD;AAAA,EAC3D,YAAY;AACd;","names":["import_chains","redstoneConfig","import_chains","garnetConfig"]}