@haneullabs/haneul 0.1.0

package/dist/esm/transactions/executor/parallel.js

@@ -0,0 +1,360 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __privateWrapper = (obj, member, setter, getter) => ({
+  set _(value) {
+    __privateSet(obj, member, value, setter);
+  },
+  get _() {
+    return __privateGet(obj, member, getter);
+  }
+});
+var _signer, _client, _coinBatchSize, _initialCoinBalance, _minimumCoinBalance, _epochBoundaryWindow, _defaultGasBudget, _maxPoolSize, _sourceCoins, _coinPool, _cache, _objectIdQueues, _buildQueue, _executeQueue, _lastDigest, _cacheLock, _pendingTransactions, _gasPrice, _ParallelTransactionExecutor_instances, getUsedObjects_fn, execute_fn, updateCache_fn, waitForLastDigest_fn, getGasCoin_fn, getGasPrice_fn, refillCoinPool_fn;
+import { toBase64 } from "@haneullabs/bcs";
+import { promiseWithResolvers } from "@haneullabs/utils";
+import { bcs } from "../../bcs/index.js";
+import { Transaction } from "../Transaction.js";
+import { TransactionDataBuilder } from "../TransactionData.js";
+import { CachingTransactionExecutor } from "./caching.js";
+import { ParallelQueue, SerialQueue } from "./queue.js";
+import { getGasCoinFromEffects } from "./serial.js";
+const PARALLEL_EXECUTOR_DEFAULTS = {
+  coinBatchSize: 20,
+  initialCoinBalance: 200000000n,
+  minimumCoinBalance: 50000000n,
+  maxPoolSize: 50,
+  epochBoundaryWindow: 1e3
+};
+class ParallelTransactionExecutor {
+  constructor(options) {
+    __privateAdd(this, _ParallelTransactionExecutor_instances);
+    __privateAdd(this, _signer);
+    __privateAdd(this, _client);
+    __privateAdd(this, _coinBatchSize);
+    __privateAdd(this, _initialCoinBalance);
+    __privateAdd(this, _minimumCoinBalance);
+    __privateAdd(this, _epochBoundaryWindow);
+    __privateAdd(this, _defaultGasBudget);
+    __privateAdd(this, _maxPoolSize);
+    __privateAdd(this, _sourceCoins);
+    __privateAdd(this, _coinPool, []);
+    __privateAdd(this, _cache);
+    __privateAdd(this, _objectIdQueues, /* @__PURE__ */ new Map());
+    __privateAdd(this, _buildQueue, new SerialQueue());
+    __privateAdd(this, _executeQueue);
+    __privateAdd(this, _lastDigest, null);
+    __privateAdd(this, _cacheLock, null);
+    __privateAdd(this, _pendingTransactions, 0);
+    __privateAdd(this, _gasPrice, null);
+    __privateSet(this, _signer, options.signer);
+    __privateSet(this, _client, options.client);
+    __privateSet(this, _coinBatchSize, options.coinBatchSize ?? PARALLEL_EXECUTOR_DEFAULTS.coinBatchSize);
+    __privateSet(this, _initialCoinBalance, options.initialCoinBalance ?? PARALLEL_EXECUTOR_DEFAULTS.initialCoinBalance);
+    __privateSet(this, _minimumCoinBalance, options.minimumCoinBalance ?? PARALLEL_EXECUTOR_DEFAULTS.minimumCoinBalance);
+    __privateSet(this, _defaultGasBudget, options.defaultGasBudget ?? __privateGet(this, _minimumCoinBalance));
+    __privateSet(this, _epochBoundaryWindow, options.epochBoundaryWindow ?? PARALLEL_EXECUTOR_DEFAULTS.epochBoundaryWindow);
+    __privateSet(this, _maxPoolSize, options.maxPoolSize ?? PARALLEL_EXECUTOR_DEFAULTS.maxPoolSize);
+    __privateSet(this, _cache, new CachingTransactionExecutor({
+      client: options.client,
+      cache: options.cache
+    }));
+    __privateSet(this, _executeQueue, new ParallelQueue(__privateGet(this, _maxPoolSize)));
+    __privateSet(this, _sourceCoins, options.sourceCoins ? new Map(options.sourceCoins.map((id) => [id, null])) : null);
+  }
+  resetCache() {
+    __privateSet(this, _gasPrice, null);
+    return __privateMethod(this, _ParallelTransactionExecutor_instances, updateCache_fn).call(this, () => __privateGet(this, _cache).reset());
+  }
+  async waitForLastTransaction() {
+    await __privateMethod(this, _ParallelTransactionExecutor_instances, updateCache_fn).call(this, () => __privateMethod(this, _ParallelTransactionExecutor_instances, waitForLastDigest_fn).call(this));
+  }
+  async executeTransaction(transaction, options, additionalSignatures = []) {
+    const { promise, resolve, reject } = promiseWithResolvers();
+    const usedObjects = await __privateMethod(this, _ParallelTransactionExecutor_instances, getUsedObjects_fn).call(this, transaction);
+    const execute = () => {
+      __privateGet(this, _executeQueue).runTask(() => {
+        const promise2 = __privateMethod(this, _ParallelTransactionExecutor_instances, execute_fn).call(this, transaction, usedObjects, options, additionalSignatures);
+        return promise2.then(resolve, reject);
+      });
+    };
+    const conflicts = /* @__PURE__ */ new Set();
+    usedObjects.forEach((objectId) => {
+      const queue = __privateGet(this, _objectIdQueues).get(objectId);
+      if (queue) {
+        conflicts.add(objectId);
+        __privateGet(this, _objectIdQueues).get(objectId).push(() => {
+          conflicts.delete(objectId);
+          if (conflicts.size === 0) {
+            execute();
+          }
+        });
+      } else {
+        __privateGet(this, _objectIdQueues).set(objectId, []);
+      }
+    });
+    if (conflicts.size === 0) {
+      execute();
+    }
+    return promise;
+  }
+}
+_signer = new WeakMap();
+_client = new WeakMap();
+_coinBatchSize = new WeakMap();
+_initialCoinBalance = new WeakMap();
+_minimumCoinBalance = new WeakMap();
+_epochBoundaryWindow = new WeakMap();
+_defaultGasBudget = new WeakMap();
+_maxPoolSize = new WeakMap();
+_sourceCoins = new WeakMap();
+_coinPool = new WeakMap();
+_cache = new WeakMap();
+_objectIdQueues = new WeakMap();
+_buildQueue = new WeakMap();
+_executeQueue = new WeakMap();
+_lastDigest = new WeakMap();
+_cacheLock = new WeakMap();
+_pendingTransactions = new WeakMap();
+_gasPrice = new WeakMap();
+_ParallelTransactionExecutor_instances = new WeakSet();
+getUsedObjects_fn = async function(transaction) {
+  const usedObjects = /* @__PURE__ */ new Set();
+  let serialized = false;
+  transaction.addSerializationPlugin(async (blockData, _options, next) => {
+    await next();
+    if (serialized) {
+      return;
+    }
+    serialized = true;
+    blockData.inputs.forEach((input) => {
+      if (input.Object?.ImmOrOwnedObject?.objectId) {
+        usedObjects.add(input.Object.ImmOrOwnedObject.objectId);
+      } else if (input.Object?.Receiving?.objectId) {
+        usedObjects.add(input.Object.Receiving.objectId);
+      } else if (input.UnresolvedObject?.objectId && !input.UnresolvedObject.initialSharedVersion) {
+        usedObjects.add(input.UnresolvedObject.objectId);
+      }
+    });
+  });
+  await transaction.prepareForSerialization({ client: __privateGet(this, _client) });
+  return usedObjects;
+};
+execute_fn = async function(transaction, usedObjects, options, additionalSignatures = []) {
+  let gasCoin;
+  try {
+    transaction.setSenderIfNotSet(__privateGet(this, _signer).toHaneulAddress());
+    await __privateGet(this, _buildQueue).runTask(async () => {
+      const data = transaction.getData();
+      if (!data.gasData.price) {
+        transaction.setGasPrice(await __privateMethod(this, _ParallelTransactionExecutor_instances, getGasPrice_fn).call(this));
+      }
+      transaction.setGasBudgetIfNotSet(__privateGet(this, _defaultGasBudget));
+      await __privateMethod(this, _ParallelTransactionExecutor_instances, updateCache_fn).call(this);
+      gasCoin = await __privateMethod(this, _ParallelTransactionExecutor_instances, getGasCoin_fn).call(this);
+      __privateWrapper(this, _pendingTransactions)._++;
+      transaction.setGasPayment([
+        {
+          objectId: gasCoin.id,
+          version: gasCoin.version,
+          digest: gasCoin.digest
+        }
+      ]);
+      await __privateGet(this, _cache).buildTransaction({ transaction, onlyTransactionKind: true });
+    });
+    const bytes = await transaction.build({ client: __privateGet(this, _client) });
+    const { signature } = await __privateGet(this, _signer).signTransaction(bytes);
+    const results = await __privateGet(this, _cache).executeTransaction({
+      transaction: bytes,
+      signature: [signature, ...additionalSignatures],
+      options: {
+        ...options,
+        showEffects: true
+      }
+    });
+    const effectsBytes = Uint8Array.from(results.rawEffects);
+    const effects = bcs.TransactionEffects.parse(effectsBytes);
+    const gasResult = getGasCoinFromEffects(effects);
+    const gasUsed = effects.V2?.gasUsed;
+    if (gasCoin && gasUsed && gasResult.owner === __privateGet(this, _signer).toHaneulAddress()) {
+      const totalUsed = BigInt(gasUsed.computationCost) + BigInt(gasUsed.storageCost) + BigInt(gasUsed.storageCost) - BigInt(gasUsed.storageRebate);
+      const remainingBalance = gasCoin.balance - totalUsed;
+      let usesGasCoin = false;
+      new TransactionDataBuilder(transaction.getData()).mapArguments((arg) => {
+        if (arg.$kind === "GasCoin") {
+          usesGasCoin = true;
+        }
+        return arg;
+      });
+      if (!usesGasCoin && remainingBalance >= __privateGet(this, _minimumCoinBalance)) {
+        __privateGet(this, _coinPool).push({
+          id: gasResult.ref.objectId,
+          version: gasResult.ref.version,
+          digest: gasResult.ref.digest,
+          balance: remainingBalance
+        });
+      } else {
+        if (!__privateGet(this, _sourceCoins)) {
+          __privateSet(this, _sourceCoins, /* @__PURE__ */ new Map());
+        }
+        __privateGet(this, _sourceCoins).set(gasResult.ref.objectId, gasResult.ref);
+      }
+    }
+    __privateSet(this, _lastDigest, results.digest);
+    return {
+      digest: results.digest,
+      effects: toBase64(effectsBytes),
+      data: results
+    };
+  } catch (error) {
+    if (gasCoin) {
+      if (!__privateGet(this, _sourceCoins)) {
+        __privateSet(this, _sourceCoins, /* @__PURE__ */ new Map());
+      }
+      __privateGet(this, _sourceCoins).set(gasCoin.id, null);
+    }
+    await __privateMethod(this, _ParallelTransactionExecutor_instances, updateCache_fn).call(this, async () => {
+      await Promise.all([
+        __privateGet(this, _cache).cache.deleteObjects([...usedObjects]),
+        __privateMethod(this, _ParallelTransactionExecutor_instances, waitForLastDigest_fn).call(this)
+      ]);
+    });
+    throw error;
+  } finally {
+    usedObjects.forEach((objectId) => {
+      const queue = __privateGet(this, _objectIdQueues).get(objectId);
+      if (queue && queue.length > 0) {
+        queue.shift()();
+      } else if (queue) {
+        __privateGet(this, _objectIdQueues).delete(objectId);
+      }
+    });
+    __privateWrapper(this, _pendingTransactions)._--;
+  }
+};
+updateCache_fn = async function(fn) {
+  if (__privateGet(this, _cacheLock)) {
+    await __privateGet(this, _cacheLock);
+  }
+  __privateSet(this, _cacheLock, fn?.().then(
+    () => {
+      __privateSet(this, _cacheLock, null);
+    },
+    () => {
+    }
+  ) ?? null);
+};
+waitForLastDigest_fn = async function() {
+  const digest = __privateGet(this, _lastDigest);
+  if (digest) {
+    __privateSet(this, _lastDigest, null);
+    await __privateGet(this, _client).waitForTransaction({ digest });
+  }
+};
+getGasCoin_fn = async function() {
+  if (__privateGet(this, _coinPool).length === 0 && __privateGet(this, _pendingTransactions) <= __privateGet(this, _maxPoolSize)) {
+    await __privateMethod(this, _ParallelTransactionExecutor_instances, refillCoinPool_fn).call(this);
+  }
+  if (__privateGet(this, _coinPool).length === 0) {
+    throw new Error("No coins available");
+  }
+  const coin = __privateGet(this, _coinPool).shift();
+  return coin;
+};
+getGasPrice_fn = async function() {
+  const remaining = __privateGet(this, _gasPrice) ? __privateGet(this, _gasPrice).expiration - __privateGet(this, _epochBoundaryWindow) - Date.now() : 0;
+  if (remaining > 0) {
+    return __privateGet(this, _gasPrice).price;
+  }
+  if (__privateGet(this, _gasPrice)) {
+    const timeToNextEpoch = Math.max(
+      __privateGet(this, _gasPrice).expiration + __privateGet(this, _epochBoundaryWindow) - Date.now(),
+      1e3
+    );
+    await new Promise((resolve) => setTimeout(resolve, timeToNextEpoch));
+  }
+  const state = await __privateGet(this, _client).getLatestHaneulSystemState();
+  __privateSet(this, _gasPrice, {
+    price: BigInt(state.referenceGasPrice),
+    expiration: Number.parseInt(state.epochStartTimestampMs, 10) + Number.parseInt(state.epochDurationMs, 10)
+  });
+  return __privateMethod(this, _ParallelTransactionExecutor_instances, getGasPrice_fn).call(this);
+};
+refillCoinPool_fn = async function() {
+  const batchSize = Math.min(
+    __privateGet(this, _coinBatchSize),
+    __privateGet(this, _maxPoolSize) - (__privateGet(this, _coinPool).length + __privateGet(this, _pendingTransactions)) + 1
+  );
+  if (batchSize === 0) {
+    return;
+  }
+  const txb = new Transaction();
+  const address = __privateGet(this, _signer).toHaneulAddress();
+  txb.setSender(address);
+  if (__privateGet(this, _sourceCoins)) {
+    const refs = [];
+    const ids = [];
+    for (const [id, ref] of __privateGet(this, _sourceCoins)) {
+      if (ref) {
+        refs.push(ref);
+      } else {
+        ids.push(id);
+      }
+    }
+    if (ids.length > 0) {
+      const coins = await __privateGet(this, _client).multiGetObjects({
+        ids
+      });
+      refs.push(
+        ...coins.filter((coin) => coin.data !== null).map(({ data }) => ({
+          objectId: data.objectId,
+          version: data.version,
+          digest: data.digest
+        }))
+      );
+    }
+    txb.setGasPayment(refs);
+    __privateSet(this, _sourceCoins, /* @__PURE__ */ new Map());
+  }
+  const amounts = new Array(batchSize).fill(__privateGet(this, _initialCoinBalance));
+  const results = txb.splitCoins(txb.gas, amounts);
+  const coinResults = [];
+  for (let i = 0; i < amounts.length; i++) {
+    coinResults.push(results[i]);
+  }
+  txb.transferObjects(coinResults, address);
+  await this.waitForLastTransaction();
+  const result = await __privateGet(this, _client).signAndExecuteTransaction({
+    transaction: txb,
+    signer: __privateGet(this, _signer),
+    options: {
+      showRawEffects: true
+    }
+  });
+  const effects = bcs.TransactionEffects.parse(Uint8Array.from(result.rawEffects));
+  effects.V2?.changedObjects.forEach(([id, { outputState }], i) => {
+    if (i === effects.V2?.gasObjectIndex || !outputState.ObjectWrite) {
+      return;
+    }
+    __privateGet(this, _coinPool).push({
+      id,
+      version: effects.V2.lamportVersion,
+      digest: outputState.ObjectWrite[0],
+      balance: BigInt(__privateGet(this, _initialCoinBalance))
+    });
+  });
+  if (!__privateGet(this, _sourceCoins)) {
+    __privateSet(this, _sourceCoins, /* @__PURE__ */ new Map());
+  }
+  const gasObject = getGasCoinFromEffects(effects).ref;
+  __privateGet(this, _sourceCoins).set(gasObject.objectId, gasObject);
+  await __privateGet(this, _client).waitForTransaction({ digest: result.digest });
+};
+export {
+  ParallelTransactionExecutor
+};
+//# sourceMappingURL=parallel.js.map

package/dist/esm/transactions/executor/parallel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transactions/executor/parallel.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { toBase64 } from '@haneullabs/bcs';\nimport { promiseWithResolvers } from '@haneullabs/utils';\nimport { bcs } from '../../bcs/index.js';\nimport type { HaneulObjectRef } from '../../bcs/types.js';\nimport type {\n\tHaneulClient,\n\tHaneulTransactionBlockResponse,\n\tHaneulTransactionBlockResponseOptions,\n} from '../../client/index.js';\nimport type { Signer } from '../../cryptography/index.js';\nimport type { ObjectCacheOptions } from '../ObjectCache.js';\nimport { Transaction } from '../Transaction.js';\nimport { TransactionDataBuilder } from '../TransactionData.js';\nimport { CachingTransactionExecutor } from './caching.js';\nimport { ParallelQueue, SerialQueue } from './queue.js';\nimport { getGasCoinFromEffects } from './serial.js';\n\nconst PARALLEL_EXECUTOR_DEFAULTS = {\n\tcoinBatchSize: 20,\n\tinitialCoinBalance: 200_000_000n,\n\tminimumCoinBalance: 50_000_000n,\n\tmaxPoolSize: 50,\n\tepochBoundaryWindow: 1_000,\n} satisfies Omit<ParallelTransactionExecutorOptions, 'signer' | 'client'>;\nexport interface ParallelTransactionExecutorOptions extends Omit<ObjectCacheOptions, 'address'> {\n\tclient: HaneulClient;\n\tsigner: Signer;\n\t/** The number of coins to create in a batch when refilling the gas pool */\n\tcoinBatchSize?: number;\n\t/** The initial balance of each coin created for the gas pool */\n\tinitialCoinBalance?: bigint;\n\t/** The minimum balance of a coin that can be reused for future transactions.  If the gasCoin is below this value, it will be used when refilling the gasPool */\n\tminimumCoinBalance?: bigint;\n\t/** The gasBudget to use if the transaction has not defined it's own gasBudget, defaults to `minimumCoinBalance` */\n\tdefaultGasBudget?: bigint;\n\t/**\n\t * Time to wait before/after the expected epoch boundary before re-fetching the gas pool (in milliseconds).\n\t * Building transactions will be paused for up to 2x this duration around each epoch boundary to ensure the\n\t * gas price is up-to-date for the next epoch.\n\t * */\n\tepochBoundaryWindow?: number;\n\t/** The maximum number of transactions that can be execute in parallel, this also determines the maximum number of gas coins that will be created */\n\tmaxPoolSize?: number;\n\t/** An initial list of coins used to fund the gas pool, uses all owned SUI coins by default */\n\tsourceCoins?: string[];\n}\n\ninterface CoinWithBalance {\n\tid: string;\n\tversion: string;\n\tdigest: string;\n\tbalance: bigint;\n}\nexport class ParallelTransactionExecutor {\n\t#signer: Signer;\n\t#client: HaneulClient;\n\t#coinBatchSize: number;\n\t#initialCoinBalance: bigint;\n\t#minimumCoinBalance: bigint;\n\t#epochBoundaryWindow: number;\n\t#defaultGasBudget: bigint;\n\t#maxPoolSize: number;\n\t#sourceCoins: Map<string, HaneulObjectRef | null> | null;\n\t#coinPool: CoinWithBalance[] = [];\n\t#cache: CachingTransactionExecutor;\n\t#objectIdQueues = new Map<string, (() => void)[]>();\n\t#buildQueue = new SerialQueue();\n\t#executeQueue: ParallelQueue;\n\t#lastDigest: string | null = null;\n\t#cacheLock: Promise<void> | null = null;\n\t#pendingTransactions = 0;\n\t#gasPrice: null | {\n\t\tprice: bigint;\n\t\texpiration: number;\n\t} = null;\n\n\tconstructor(options: ParallelTransactionExecutorOptions) {\n\t\tthis.#signer = options.signer;\n\t\tthis.#client = options.client;\n\t\tthis.#coinBatchSize = options.coinBatchSize ?? PARALLEL_EXECUTOR_DEFAULTS.coinBatchSize;\n\t\tthis.#initialCoinBalance =\n\t\t\toptions.initialCoinBalance ?? PARALLEL_EXECUTOR_DEFAULTS.initialCoinBalance;\n\t\tthis.#minimumCoinBalance =\n\t\t\toptions.minimumCoinBalance ?? PARALLEL_EXECUTOR_DEFAULTS.minimumCoinBalance;\n\t\tthis.#defaultGasBudget = options.defaultGasBudget ?? this.#minimumCoinBalance;\n\t\tthis.#epochBoundaryWindow =\n\t\t\toptions.epochBoundaryWindow ?? PARALLEL_EXECUTOR_DEFAULTS.epochBoundaryWindow;\n\t\tthis.#maxPoolSize = options.maxPoolSize ?? PARALLEL_EXECUTOR_DEFAULTS.maxPoolSize;\n\t\tthis.#cache = new CachingTransactionExecutor({\n\t\t\tclient: options.client,\n\t\t\tcache: options.cache,\n\t\t});\n\t\tthis.#executeQueue = new ParallelQueue(this.#maxPoolSize);\n\t\tthis.#sourceCoins = options.sourceCoins\n\t\t\t? new Map(options.sourceCoins.map((id) => [id, null]))\n\t\t\t: null;\n\t}\n\n\tresetCache() {\n\t\tthis.#gasPrice = null;\n\t\treturn this.#updateCache(() => this.#cache.reset());\n\t}\n\n\tasync waitForLastTransaction() {\n\t\tawait this.#updateCache(() => this.#waitForLastDigest());\n\t}\n\n\tasync executeTransaction(\n\t\ttransaction: Transaction,\n\t\toptions?: HaneulTransactionBlockResponseOptions,\n\t\tadditionalSignatures: string[] = [],\n\t) {\n\t\tconst { promise, resolve, reject } = promiseWithResolvers<{\n\t\t\tdigest: string;\n\t\t\teffects: string;\n\t\t\tdata: HaneulTransactionBlockResponse;\n\t\t}>();\n\t\tconst usedObjects = await this.#getUsedObjects(transaction);\n\n\t\tconst execute = () => {\n\t\t\tthis.#executeQueue.runTask(() => {\n\t\t\t\tconst promise = this.#execute(transaction, usedObjects, options, additionalSignatures);\n\n\t\t\t\treturn promise.then(resolve, reject);\n\t\t\t});\n\t\t};\n\n\t\tconst conflicts = new Set<string>();\n\n\t\tusedObjects.forEach((objectId) => {\n\t\t\tconst queue = this.#objectIdQueues.get(objectId);\n\t\t\tif (queue) {\n\t\t\t\tconflicts.add(objectId);\n\t\t\t\tthis.#objectIdQueues.get(objectId)!.push(() => {\n\t\t\t\t\tconflicts.delete(objectId);\n\t\t\t\t\tif (conflicts.size === 0) {\n\t\t\t\t\t\texecute();\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tthis.#objectIdQueues.set(objectId, []);\n\t\t\t}\n\t\t});\n\n\t\tif (conflicts.size === 0) {\n\t\t\texecute();\n\t\t}\n\n\t\treturn promise;\n\t}\n\n\tasync #getUsedObjects(transaction: Transaction) {\n\t\tconst usedObjects = new Set<string>();\n\t\tlet serialized = false;\n\n\t\ttransaction.addSerializationPlugin(async (blockData, _options, next) => {\n\t\t\tawait next();\n\n\t\t\tif (serialized) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tserialized = true;\n\n\t\t\tblockData.inputs.forEach((input) => {\n\t\t\t\tif (input.Object?.ImmOrOwnedObject?.objectId) {\n\t\t\t\t\tusedObjects.add(input.Object.ImmOrOwnedObject.objectId);\n\t\t\t\t} else if (input.Object?.Receiving?.objectId) {\n\t\t\t\t\tusedObjects.add(input.Object.Receiving.objectId);\n\t\t\t\t} else if (\n\t\t\t\t\tinput.UnresolvedObject?.objectId &&\n\t\t\t\t\t!input.UnresolvedObject.initialSharedVersion\n\t\t\t\t) {\n\t\t\t\t\tusedObjects.add(input.UnresolvedObject.objectId);\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\n\t\tawait transaction.prepareForSerialization({ client: this.#client });\n\n\t\treturn usedObjects;\n\t}\n\n\tasync #execute(\n\t\ttransaction: Transaction,\n\t\tusedObjects: Set<string>,\n\t\toptions?: HaneulTransactionBlockResponseOptions,\n\t\tadditionalSignatures: string[] = [],\n\t) {\n\t\tlet gasCoin!: CoinWithBalance;\n\t\ttry {\n\t\t\ttransaction.setSenderIfNotSet(this.#signer.toHaneulAddress());\n\n\t\t\tawait this.#buildQueue.runTask(async () => {\n\t\t\t\tconst data = transaction.getData();\n\n\t\t\t\tif (!data.gasData.price) {\n\t\t\t\t\ttransaction.setGasPrice(await this.#getGasPrice());\n\t\t\t\t}\n\n\t\t\t\ttransaction.setGasBudgetIfNotSet(this.#defaultGasBudget);\n\n\t\t\t\tawait this.#updateCache();\n\t\t\t\tgasCoin = await this.#getGasCoin();\n\t\t\t\tthis.#pendingTransactions++;\n\t\t\t\ttransaction.setGasPayment([\n\t\t\t\t\t{\n\t\t\t\t\t\tobjectId: gasCoin.id,\n\t\t\t\t\t\tversion: gasCoin.version,\n\t\t\t\t\t\tdigest: gasCoin.digest,\n\t\t\t\t\t},\n\t\t\t\t]);\n\n\t\t\t\t// Resolve cached references\n\t\t\t\tawait this.#cache.buildTransaction({ transaction, onlyTransactionKind: true });\n\t\t\t});\n\n\t\t\tconst bytes = await transaction.build({ client: this.#client });\n\n\t\t\tconst { signature } = await this.#signer.signTransaction(bytes);\n\n\t\t\tconst results = await this.#cache.executeTransaction({\n\t\t\t\ttransaction: bytes,\n\t\t\t\tsignature: [signature, ...additionalSignatures],\n\t\t\t\toptions: {\n\t\t\t\t\t...options,\n\t\t\t\t\tshowEffects: true,\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tconst effectsBytes = Uint8Array.from(results.rawEffects!);\n\t\t\tconst effects = bcs.TransactionEffects.parse(effectsBytes);\n\n\t\t\tconst gasResult = getGasCoinFromEffects(effects);\n\t\t\tconst gasUsed = effects.V2?.gasUsed;\n\n\t\t\tif (gasCoin && gasUsed && gasResult.owner === this.#signer.toHaneulAddress()) {\n\t\t\t\tconst totalUsed =\n\t\t\t\t\tBigInt(gasUsed.computationCost) +\n\t\t\t\t\tBigInt(gasUsed.storageCost) +\n\t\t\t\t\tBigInt(gasUsed.storageCost) -\n\t\t\t\t\tBigInt(gasUsed.storageRebate);\n\t\t\t\tconst remainingBalance = gasCoin.balance - totalUsed;\n\n\t\t\t\tlet usesGasCoin = false;\n\t\t\t\tnew TransactionDataBuilder(transaction.getData()).mapArguments((arg) => {\n\t\t\t\t\tif (arg.$kind === 'GasCoin') {\n\t\t\t\t\t\tusesGasCoin = true;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn arg;\n\t\t\t\t});\n\n\t\t\t\tif (!usesGasCoin && remainingBalance >= this.#minimumCoinBalance) {\n\t\t\t\t\tthis.#coinPool.push({\n\t\t\t\t\t\tid: gasResult.ref.objectId,\n\t\t\t\t\t\tversion: gasResult.ref.version,\n\t\t\t\t\t\tdigest: gasResult.ref.digest,\n\t\t\t\t\t\tbalance: remainingBalance,\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\tif (!this.#sourceCoins) {\n\t\t\t\t\t\tthis.#sourceCoins = new Map();\n\t\t\t\t\t}\n\t\t\t\t\tthis.#sourceCoins.set(gasResult.ref.objectId, gasResult.ref);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tthis.#lastDigest = results.digest;\n\n\t\t\treturn {\n\t\t\t\tdigest: results.digest,\n\t\t\t\teffects: toBase64(effectsBytes),\n\t\t\t\tdata: results,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tif (gasCoin) {\n\t\t\t\tif (!this.#sourceCoins) {\n\t\t\t\t\tthis.#sourceCoins = new Map();\n\t\t\t\t}\n\n\t\t\t\tthis.#sourceCoins.set(gasCoin.id, null);\n\t\t\t}\n\n\t\t\tawait this.#updateCache(async () => {\n\t\t\t\tawait Promise.all([\n\t\t\t\t\tthis.#cache.cache.deleteObjects([...usedObjects]),\n\t\t\t\t\tthis.#waitForLastDigest(),\n\t\t\t\t]);\n\t\t\t});\n\n\t\t\tthrow error;\n\t\t} finally {\n\t\t\tusedObjects.forEach((objectId) => {\n\t\t\t\tconst queue = this.#objectIdQueues.get(objectId);\n\t\t\t\tif (queue && queue.length > 0) {\n\t\t\t\t\tqueue.shift()!();\n\t\t\t\t} else if (queue) {\n\t\t\t\t\tthis.#objectIdQueues.delete(objectId);\n\t\t\t\t}\n\t\t\t});\n\t\t\tthis.#pendingTransactions--;\n\t\t}\n\t}\n\n\t/** Helper for synchronizing cache updates, by ensuring only one update happens at a time.  This can also be used to wait for any pending cache updates  */\n\tasync #updateCache(fn?: () => Promise<void>) {\n\t\tif (this.#cacheLock) {\n\t\t\tawait this.#cacheLock;\n\t\t}\n\n\t\tthis.#cacheLock =\n\t\t\tfn?.().then(\n\t\t\t\t() => {\n\t\t\t\t\tthis.#cacheLock = null;\n\t\t\t\t},\n\t\t\t\t() => {},\n\t\t\t) ?? null;\n\t}\n\n\tasync #waitForLastDigest() {\n\t\tconst digest = this.#lastDigest;\n\t\tif (digest) {\n\t\t\tthis.#lastDigest = null;\n\t\t\tawait this.#client.waitForTransaction({ digest });\n\t\t}\n\t}\n\n\tasync #getGasCoin() {\n\t\tif (this.#coinPool.length === 0 && this.#pendingTransactions <= this.#maxPoolSize) {\n\t\t\tawait this.#refillCoinPool();\n\t\t}\n\n\t\tif (this.#coinPool.length === 0) {\n\t\t\tthrow new Error('No coins available');\n\t\t}\n\n\t\tconst coin = this.#coinPool.shift()!;\n\t\treturn coin;\n\t}\n\n\tasync #getGasPrice(): Promise<bigint> {\n\t\tconst remaining = this.#gasPrice\n\t\t\t? this.#gasPrice.expiration - this.#epochBoundaryWindow - Date.now()\n\t\t\t: 0;\n\n\t\tif (remaining > 0) {\n\t\t\treturn this.#gasPrice!.price;\n\t\t}\n\n\t\tif (this.#gasPrice) {\n\t\t\tconst timeToNextEpoch = Math.max(\n\t\t\t\tthis.#gasPrice.expiration + this.#epochBoundaryWindow - Date.now(),\n\t\t\t\t1_000,\n\t\t\t);\n\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, timeToNextEpoch));\n\t\t}\n\n\t\tconst state = await this.#client.getLatestHaneulSystemState();\n\n\t\tthis.#gasPrice = {\n\t\t\tprice: BigInt(state.referenceGasPrice),\n\t\t\texpiration:\n\t\t\t\tNumber.parseInt(state.epochStartTimestampMs, 10) +\n\t\t\t\tNumber.parseInt(state.epochDurationMs, 10),\n\t\t};\n\n\t\treturn this.#getGasPrice();\n\t}\n\n\tasync #refillCoinPool() {\n\t\tconst batchSize = Math.min(\n\t\t\tthis.#coinBatchSize,\n\t\t\tthis.#maxPoolSize - (this.#coinPool.length + this.#pendingTransactions) + 1,\n\t\t);\n\n\t\tif (batchSize === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst txb = new Transaction();\n\t\tconst address = this.#signer.toHaneulAddress();\n\t\ttxb.setSender(address);\n\n\t\tif (this.#sourceCoins) {\n\t\t\tconst refs = [];\n\t\t\tconst ids = [];\n\t\t\tfor (const [id, ref] of this.#sourceCoins) {\n\t\t\t\tif (ref) {\n\t\t\t\t\trefs.push(ref);\n\t\t\t\t} else {\n\t\t\t\t\tids.push(id);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (ids.length > 0) {\n\t\t\t\tconst coins = await this.#client.multiGetObjects({\n\t\t\t\t\tids,\n\t\t\t\t});\n\t\t\t\trefs.push(\n\t\t\t\t\t...coins\n\t\t\t\t\t\t.filter((coin): coin is typeof coin & { data: object } => coin.data !== null)\n\t\t\t\t\t\t.map(({ data }) => ({\n\t\t\t\t\t\t\tobjectId: data.objectId,\n\t\t\t\t\t\t\tversion: data.version,\n\t\t\t\t\t\t\tdigest: data.digest,\n\t\t\t\t\t\t})),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\ttxb.setGasPayment(refs);\n\t\t\tthis.#sourceCoins = new Map();\n\t\t}\n\n\t\tconst amounts = new Array(batchSize).fill(this.#initialCoinBalance);\n\t\tconst results = txb.splitCoins(txb.gas, amounts);\n\t\tconst coinResults = [];\n\t\tfor (let i = 0; i < amounts.length; i++) {\n\t\t\tcoinResults.push(results[i]);\n\t\t}\n\t\ttxb.transferObjects(coinResults, address);\n\n\t\tawait this.waitForLastTransaction();\n\n\t\tconst result = await this.#client.signAndExecuteTransaction({\n\t\t\ttransaction: txb,\n\t\t\tsigner: this.#signer,\n\t\t\toptions: {\n\t\t\t\tshowRawEffects: true,\n\t\t\t},\n\t\t});\n\n\t\tconst effects = bcs.TransactionEffects.parse(Uint8Array.from(result.rawEffects!));\n\t\teffects.V2?.changedObjects.forEach(([id, { outputState }], i) => {\n\t\t\tif (i === effects.V2?.gasObjectIndex || !outputState.ObjectWrite) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.#coinPool.push({\n\t\t\t\tid,\n\t\t\t\tversion: effects.V2!.lamportVersion,\n\t\t\t\tdigest: outputState.ObjectWrite[0],\n\t\t\t\tbalance: BigInt(this.#initialCoinBalance),\n\t\t\t});\n\t\t});\n\n\t\tif (!this.#sourceCoins) {\n\t\t\tthis.#sourceCoins = new Map();\n\t\t}\n\n\t\tconst gasObject = getGasCoinFromEffects(effects).ref;\n\t\tthis.#sourceCoins!.set(gasObject.objectId, gasObject);\n\n\t\tawait this.#client.waitForTransaction({ digest: result.digest });\n\t}\n}\n"],
+  "mappings": "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",
+  "names": ["promise"]
+}

package/dist/esm/transactions/executor/queue.d.ts

@@ -0,0 +1,11 @@
+export declare class SerialQueue {
+    #private;
+    runTask<T>(task: () => Promise<T>): Promise<T>;
+}
+export declare class ParallelQueue {
+    #private;
+    activeTasks: number;
+    maxTasks: number;
+    constructor(maxTasks: number);
+    runTask<T>(task: () => Promise<T>): Promise<T>;
+}

package/dist/esm/transactions/executor/queue.js

@@ -0,0 +1,65 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var _queue, _queue2;
+class SerialQueue {
+  constructor() {
+    __privateAdd(this, _queue, []);
+  }
+  async runTask(task) {
+    return new Promise((resolve, reject) => {
+      __privateGet(this, _queue).push(() => {
+        task().finally(() => {
+          __privateGet(this, _queue).shift();
+          if (__privateGet(this, _queue).length > 0) {
+            __privateGet(this, _queue)[0]();
+          }
+        }).then(resolve, reject);
+      });
+      if (__privateGet(this, _queue).length === 1) {
+        __privateGet(this, _queue)[0]();
+      }
+    });
+  }
+}
+_queue = new WeakMap();
+class ParallelQueue {
+  constructor(maxTasks) {
+    __privateAdd(this, _queue2, []);
+    this.activeTasks = 0;
+    this.maxTasks = maxTasks;
+  }
+  runTask(task) {
+    return new Promise((resolve, reject) => {
+      if (this.activeTasks < this.maxTasks) {
+        this.activeTasks++;
+        task().finally(() => {
+          if (__privateGet(this, _queue2).length > 0) {
+            __privateGet(this, _queue2).shift()();
+          } else {
+            this.activeTasks--;
+          }
+        }).then(resolve, reject);
+      } else {
+        __privateGet(this, _queue2).push(() => {
+          task().finally(() => {
+            if (__privateGet(this, _queue2).length > 0) {
+              __privateGet(this, _queue2).shift()();
+            } else {
+              this.activeTasks--;
+            }
+          }).then(resolve, reject);
+        });
+      }
+    });
+  }
+}
+_queue2 = new WeakMap();
+export {
+  ParallelQueue,
+  SerialQueue
+};
+//# sourceMappingURL=queue.js.map

package/dist/esm/transactions/executor/queue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transactions/executor/queue.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nexport class SerialQueue {\n\t#queue: Array<() => void> = [];\n\n\tasync runTask<T>(task: () => Promise<T>): Promise<T> {\n\t\treturn new Promise((resolve, reject) => {\n\t\t\tthis.#queue.push(() => {\n\t\t\t\ttask()\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tthis.#queue.shift();\n\t\t\t\t\t\tif (this.#queue.length > 0) {\n\t\t\t\t\t\t\tthis.#queue[0]();\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.then(resolve, reject);\n\t\t\t});\n\n\t\t\tif (this.#queue.length === 1) {\n\t\t\t\tthis.#queue[0]();\n\t\t\t}\n\t\t});\n\t}\n}\n\nexport class ParallelQueue {\n\t#queue: Array<() => void> = [];\n\tactiveTasks = 0;\n\tmaxTasks: number;\n\n\tconstructor(maxTasks: number) {\n\t\tthis.maxTasks = maxTasks;\n\t}\n\n\trunTask<T>(task: () => Promise<T>): Promise<T> {\n\t\treturn new Promise<T>((resolve, reject) => {\n\t\t\tif (this.activeTasks < this.maxTasks) {\n\t\t\t\tthis.activeTasks++;\n\n\t\t\t\ttask()\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tif (this.#queue.length > 0) {\n\t\t\t\t\t\t\tthis.#queue.shift()!();\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tthis.activeTasks--;\n\t\t\t\t\t\t}\n\t\t\t\t\t})\n\t\t\t\t\t.then(resolve, reject);\n\t\t\t} else {\n\t\t\t\tthis.#queue.push(() => {\n\t\t\t\t\ttask()\n\t\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\t\tif (this.#queue.length > 0) {\n\t\t\t\t\t\t\t\tthis.#queue.shift()!();\n\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\tthis.activeTasks--;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.then(resolve, reject);\n\t\t\t\t});\n\t\t\t}\n\t\t});\n\t}\n}\n"],
+  "mappings": ";;;;;;AAAA,YAAAA;AAGO,MAAM,YAAY;AAAA,EAAlB;AACN,+BAA4B,CAAC;AAAA;AAAA,EAE7B,MAAM,QAAW,MAAoC;AACpD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACvC,yBAAK,QAAO,KAAK,MAAM;AACtB,aAAK,EACH,QAAQ,MAAM;AACd,6BAAK,QAAO,MAAM;AAClB,cAAI,mBAAK,QAAO,SAAS,GAAG;AAC3B,+BAAK,QAAO,CAAC,EAAE;AAAA,UAChB;AAAA,QACD,CAAC,EACA,KAAK,SAAS,MAAM;AAAA,MACvB,CAAC;AAED,UAAI,mBAAK,QAAO,WAAW,GAAG;AAC7B,2BAAK,QAAO,CAAC,EAAE;AAAA,MAChB;AAAA,IACD,CAAC;AAAA,EACF;AACD;AApBC;AAsBM,MAAM,cAAc;AAAA,EAK1B,YAAY,UAAkB;AAJ9B,uBAAAA,SAA4B,CAAC;AAC7B,uBAAc;AAIb,SAAK,WAAW;AAAA,EACjB;AAAA,EAEA,QAAW,MAAoC;AAC9C,WAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AAC1C,UAAI,KAAK,cAAc,KAAK,UAAU;AACrC,aAAK;AAEL,aAAK,EACH,QAAQ,MAAM;AACd,cAAI,mBAAKA,SAAO,SAAS,GAAG;AAC3B,+BAAKA,SAAO,MAAM,EAAG;AAAA,UACtB,OAAO;AACN,iBAAK;AAAA,UACN;AAAA,QACD,CAAC,EACA,KAAK,SAAS,MAAM;AAAA,MACvB,OAAO;AACN,2BAAKA,SAAO,KAAK,MAAM;AACtB,eAAK,EACH,QAAQ,MAAM;AACd,gBAAI,mBAAKA,SAAO,SAAS,GAAG;AAC3B,iCAAKA,SAAO,MAAM,EAAG;AAAA,YACtB,OAAO;AACN,mBAAK;AAAA,YACN;AAAA,UACD,CAAC,EACA,KAAK,SAAS,MAAM;AAAA,QACvB,CAAC;AAAA,MACF;AAAA,IACD,CAAC;AAAA,EACF;AACD;AArCCA,UAAA;",
+  "names": ["_queue"]
+}

package/dist/esm/transactions/executor/serial.d.ts

@@ -0,0 +1,31 @@
+import type { bcs } from '../../bcs/index.js';
+import type { HaneulClient, HaneulTransactionBlockResponseOptions } from '../../client/index.js';
+import type { Signer } from '../../cryptography/keypair.js';
+import type { ObjectCacheOptions } from '../ObjectCache.js';
+import { Transaction } from '../Transaction.js';
+export declare class SerialTransactionExecutor {
+    #private;
+    constructor({ signer, defaultGasBudget, ...options }: Omit<ObjectCacheOptions, 'address'> & {
+        client: HaneulClient;
+        signer: Signer;
+        /** The gasBudget to use if the transaction has not defined it's own gasBudget, defaults to `50_000_000n` */
+        defaultGasBudget?: bigint;
+    });
+    applyEffects(effects: typeof bcs.TransactionEffects.$inferType): Promise<void>;
+    buildTransaction(transaction: Transaction): Promise<Uint8Array<ArrayBuffer>>;
+    resetCache(): Promise<void>;
+    waitForLastTransaction(): Promise<void>;
+    executeTransaction(transaction: Transaction | Uint8Array, options?: HaneulTransactionBlockResponseOptions, additionalSignatures?: string[]): Promise<{
+        digest: string;
+        effects: string;
+        data: import("../../client/index.js").HaneulTransactionBlockResponse;
+    }>;
+}
+export declare function getGasCoinFromEffects(effects: typeof bcs.TransactionEffects.$inferType): {
+    ref: {
+        objectId: string;
+        digest: string;
+        version: string;
+    };
+    owner: string;
+};

package/dist/esm/transactions/executor/serial.js

@@ -0,0 +1,117 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _queue, _signer, _cache, _defaultGasBudget, _cacheGasCoin, _buildTransaction;
+import { toBase64 } from "@haneullabs/bcs";
+import { isTransaction, Transaction } from "../Transaction.js";
+import { CachingTransactionExecutor } from "./caching.js";
+import { SerialQueue } from "./queue.js";
+class SerialTransactionExecutor {
+  constructor({
+    signer,
+    defaultGasBudget = 50000000n,
+    ...options
+  }) {
+    __privateAdd(this, _queue, new SerialQueue());
+    __privateAdd(this, _signer);
+    __privateAdd(this, _cache);
+    __privateAdd(this, _defaultGasBudget);
+    __privateAdd(this, _cacheGasCoin, async (effects) => {
+      if (!effects.V2) {
+        return;
+      }
+      const gasCoin = getGasCoinFromEffects(effects).ref;
+      if (gasCoin) {
+        __privateGet(this, _cache).cache.setCustom("gasCoin", gasCoin);
+      } else {
+        __privateGet(this, _cache).cache.deleteCustom("gasCoin");
+      }
+    });
+    __privateAdd(this, _buildTransaction, async (transaction) => {
+      const gasCoin = await __privateGet(this, _cache).cache.getCustom("gasCoin");
+      const copy = Transaction.from(transaction);
+      if (gasCoin) {
+        copy.setGasPayment([gasCoin]);
+      }
+      copy.setGasBudgetIfNotSet(__privateGet(this, _defaultGasBudget));
+      copy.setSenderIfNotSet(__privateGet(this, _signer).toHaneulAddress());
+      return __privateGet(this, _cache).buildTransaction({ transaction: copy });
+    });
+    __privateSet(this, _signer, signer);
+    __privateSet(this, _defaultGasBudget, defaultGasBudget);
+    __privateSet(this, _cache, new CachingTransactionExecutor({
+      client: options.client,
+      cache: options.cache,
+      onEffects: (effects) => __privateGet(this, _cacheGasCoin).call(this, effects)
+    }));
+  }
+  async applyEffects(effects) {
+    return __privateGet(this, _cache).applyEffects(effects);
+  }
+  async buildTransaction(transaction) {
+    return __privateGet(this, _queue).runTask(() => __privateGet(this, _buildTransaction).call(this, transaction));
+  }
+  resetCache() {
+    return __privateGet(this, _cache).reset();
+  }
+  waitForLastTransaction() {
+    return __privateGet(this, _cache).waitForLastTransaction();
+  }
+  executeTransaction(transaction, options, additionalSignatures = []) {
+    return __privateGet(this, _queue).runTask(async () => {
+      const bytes = isTransaction(transaction) ? await __privateGet(this, _buildTransaction).call(this, transaction) : transaction;
+      const { signature } = await __privateGet(this, _signer).signTransaction(bytes);
+      const results = await __privateGet(this, _cache).executeTransaction({
+        signature: [signature, ...additionalSignatures],
+        transaction: bytes,
+        options
+      }).catch(async (error) => {
+        await this.resetCache();
+        throw error;
+      });
+      const effectsBytes = Uint8Array.from(results.rawEffects);
+      return {
+        digest: results.digest,
+        effects: toBase64(effectsBytes),
+        data: results
+      };
+    });
+  }
+}
+_queue = new WeakMap();
+_signer = new WeakMap();
+_cache = new WeakMap();
+_defaultGasBudget = new WeakMap();
+_cacheGasCoin = new WeakMap();
+_buildTransaction = new WeakMap();
+function getGasCoinFromEffects(effects) {
+  if (!effects.V2) {
+    throw new Error("Unexpected effects version");
+  }
+  const gasObjectChange = effects.V2.changedObjects[effects.V2.gasObjectIndex];
+  if (!gasObjectChange) {
+    throw new Error("Gas object not found in effects");
+  }
+  const [objectId, { outputState }] = gasObjectChange;
+  if (!outputState.ObjectWrite) {
+    throw new Error("Unexpected gas object state");
+  }
+  const [digest, owner] = outputState.ObjectWrite;
+  return {
+    ref: {
+      objectId,
+      digest,
+      version: effects.V2.lamportVersion
+    },
+    owner: owner.AddressOwner || owner.ObjectOwner
+  };
+}
+export {
+  SerialTransactionExecutor,
+  getGasCoinFromEffects
+};
+//# sourceMappingURL=serial.js.map