@haneullabs/haneul 0.1.0

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transactions/executor/serial.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { toBase64 } from '@haneullabs/bcs';\n\nimport type { bcs } from '../../bcs/index.js';\nimport type { HaneulClient, HaneulTransactionBlockResponseOptions } from '../../client/index.js';\nimport type { Signer } from '../../cryptography/keypair.js';\nimport type { ObjectCacheOptions } from '../ObjectCache.js';\nimport { isTransaction, Transaction } from '../Transaction.js';\nimport { CachingTransactionExecutor } from './caching.js';\nimport { SerialQueue } from './queue.js';\n\nexport class SerialTransactionExecutor {\n\t#queue = new SerialQueue();\n\t#signer: Signer;\n\t#cache: CachingTransactionExecutor;\n\t#defaultGasBudget: bigint;\n\n\tconstructor({\n\t\tsigner,\n\t\tdefaultGasBudget = 50_000_000n,\n\t\t...options\n\t}: Omit<ObjectCacheOptions, 'address'> & {\n\t\tclient: HaneulClient;\n\t\tsigner: Signer;\n\t\t/** The gasBudget to use if the transaction has not defined it's own gasBudget, defaults to `50_000_000n` */\n\t\tdefaultGasBudget?: bigint;\n\t}) {\n\t\tthis.#signer = signer;\n\t\tthis.#defaultGasBudget = defaultGasBudget;\n\t\tthis.#cache = new CachingTransactionExecutor({\n\t\t\tclient: options.client,\n\t\t\tcache: options.cache,\n\t\t\tonEffects: (effects) => this.#cacheGasCoin(effects),\n\t\t});\n\t}\n\n\tasync applyEffects(effects: typeof bcs.TransactionEffects.$inferType) {\n\t\treturn this.#cache.applyEffects(effects);\n\t}\n\n\t#cacheGasCoin = async (effects: typeof bcs.TransactionEffects.$inferType) => {\n\t\tif (!effects.V2) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst gasCoin = getGasCoinFromEffects(effects).ref;\n\t\tif (gasCoin) {\n\t\t\tthis.#cache.cache.setCustom('gasCoin', gasCoin);\n\t\t} else {\n\t\t\tthis.#cache.cache.deleteCustom('gasCoin');\n\t\t}\n\t};\n\n\tasync buildTransaction(transaction: Transaction) {\n\t\treturn this.#queue.runTask(() => this.#buildTransaction(transaction));\n\t}\n\n\t#buildTransaction = async (transaction: Transaction) => {\n\t\tconst gasCoin = await this.#cache.cache.getCustom<{\n\t\t\tobjectId: string;\n\t\t\tversion: string;\n\t\t\tdigest: string;\n\t\t}>('gasCoin');\n\n\t\tconst copy = Transaction.from(transaction);\n\t\tif (gasCoin) {\n\t\t\tcopy.setGasPayment([gasCoin]);\n\t\t}\n\n\t\tcopy.setGasBudgetIfNotSet(this.#defaultGasBudget);\n\t\tcopy.setSenderIfNotSet(this.#signer.toHaneulAddress());\n\n\t\treturn this.#cache.buildTransaction({ transaction: copy });\n\t};\n\n\tresetCache() {\n\t\treturn this.#cache.reset();\n\t}\n\n\twaitForLastTransaction() {\n\t\treturn this.#cache.waitForLastTransaction();\n\t}\n\n\texecuteTransaction(\n\t\ttransaction: Transaction | Uint8Array,\n\t\toptions?: HaneulTransactionBlockResponseOptions,\n\t\tadditionalSignatures: string[] = [],\n\t) {\n\t\treturn this.#queue.runTask(async () => {\n\t\t\tconst bytes = isTransaction(transaction)\n\t\t\t\t? await this.#buildTransaction(transaction)\n\t\t\t\t: transaction;\n\n\t\t\tconst { signature } = await this.#signer.signTransaction(bytes);\n\t\t\tconst results = await this.#cache\n\t\t\t\t.executeTransaction({\n\t\t\t\t\tsignature: [signature, ...additionalSignatures],\n\t\t\t\t\ttransaction: bytes,\n\t\t\t\t\toptions,\n\t\t\t\t})\n\t\t\t\t.catch(async (error) => {\n\t\t\t\t\tawait this.resetCache();\n\t\t\t\t\tthrow error;\n\t\t\t\t});\n\n\t\t\tconst effectsBytes = Uint8Array.from(results.rawEffects!);\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});\n\t}\n}\n\nexport function getGasCoinFromEffects(effects: typeof bcs.TransactionEffects.$inferType) {\n\tif (!effects.V2) {\n\t\tthrow new Error('Unexpected effects version');\n\t}\n\n\tconst gasObjectChange = effects.V2.changedObjects[effects.V2.gasObjectIndex!];\n\n\tif (!gasObjectChange) {\n\t\tthrow new Error('Gas object not found in effects');\n\t}\n\n\tconst [objectId, { outputState }] = gasObjectChange;\n\n\tif (!outputState.ObjectWrite) {\n\t\tthrow new Error('Unexpected gas object state');\n\t}\n\n\tconst [digest, owner] = outputState.ObjectWrite;\n\n\treturn {\n\t\tref: {\n\t\t\tobjectId,\n\t\t\tdigest,\n\t\t\tversion: effects.V2.lamportVersion,\n\t\t},\n\t\towner: owner.AddressOwner || owner.ObjectOwner!,\n\t};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/transactions/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates a Blake2b hash of typed data as a base64 string.
+ *
+ * @param typeTag type tag (e.g. TransactionData, SenderSignedData)
+ * @param data data to hash
+ */
+export declare function hashTypedData(typeTag: string, data: Uint8Array): Uint8Array;

package/dist/esm/transactions/hash.js

@@ -0,0 +1,12 @@
+import { blake2b } from "@noble/hashes/blake2b";
+function hashTypedData(typeTag, data) {
+  const typeTagBytes = Array.from(`${typeTag}::`).map((e) => e.charCodeAt(0));
+  const dataWithTag = new Uint8Array(typeTagBytes.length + data.length);
+  dataWithTag.set(typeTagBytes);
+  dataWithTag.set(data, typeTagBytes.length);
+  return blake2b(dataWithTag, { dkLen: 32 });
+}
+export {
+  hashTypedData
+};
+//# sourceMappingURL=hash.js.map

package/dist/esm/transactions/hash.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transactions/hash.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { blake2b } from '@noble/hashes/blake2b';\n\n/**\n * Generates a Blake2b hash of typed data as a base64 string.\n *\n * @param typeTag type tag (e.g. TransactionData, SenderSignedData)\n * @param data data to hash\n */\nexport function hashTypedData(typeTag: string, data: Uint8Array): Uint8Array {\n\tconst typeTagBytes = Array.from(`${typeTag}::`).map((e) => e.charCodeAt(0));\n\n\tconst dataWithTag = new Uint8Array(typeTagBytes.length + data.length);\n\tdataWithTag.set(typeTagBytes);\n\tdataWithTag.set(data, typeTagBytes.length);\n\n\treturn blake2b(dataWithTag, { dkLen: 32 });\n}\n"],
+  "mappings": "AAGA,SAAS,eAAe;AAQjB,SAAS,cAAc,SAAiB,MAA8B;AAC5E,QAAM,eAAe,MAAM,KAAK,GAAG,OAAO,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE1E,QAAM,cAAc,IAAI,WAAW,aAAa,SAAS,KAAK,MAAM;AACpE,cAAY,IAAI,YAAY;AAC5B,cAAY,IAAI,MAAM,aAAa,MAAM;AAEzC,SAAO,QAAQ,aAAa,EAAE,OAAO,GAAG,CAAC;AAC1C;",
+  "names": []
+}

package/dist/esm/transactions/index.d.ts

@@ -0,0 +1,21 @@
+import type { NamedPackagesOverrides } from '../experimental/mvr.js';
+export { normalizedTypeToMoveTypeSignature, getPureBcsSchema } from './serializer.js';
+export { Inputs } from './Inputs.js';
+export { Commands, type TransactionArgument, type TransactionInput, UpgradePolicy, } from './Commands.js';
+export { Transaction, isTransaction, type TransactionObjectInput, type TransactionObjectArgument, type TransactionResult, } from './Transaction.js';
+export { type SerializedTransactionDataV2 } from './data/v2.js';
+export { type SerializedTransactionDataV1 } from './data/v1.js';
+export type { TransactionData, Argument, ObjectRef, GasData, CallArg, Command, OpenMoveTypeSignature, OpenMoveTypeSignatureBody, } from './data/internal.js';
+export { TransactionDataBuilder } from './TransactionData.js';
+export { ObjectCache, AsyncCache } from './ObjectCache.js';
+export { SerialTransactionExecutor } from './executor/serial.js';
+export { ParallelTransactionExecutor } from './executor/parallel.js';
+export type { ParallelTransactionExecutorOptions } from './executor/parallel.js';
+export { coinWithBalance } from './intents/CoinWithBalance.js';
+export type { BuildTransactionOptions, SerializeTransactionOptions, TransactionPlugin, } from './resolve.js';
+export { Arguments } from './Arguments.js';
+export { namedPackagesPlugin, type NamedPackagesPluginOptions, } from './plugins/NamedPackagesPlugin.js';
+export type { NamedPackagesOverrides };
+/** @deprecated Use NamedPackagesOverrides instead */
+export type NamedPackagesPluginCache = NamedPackagesOverrides;
+export { isArgument } from './utils.js';

package/dist/esm/transactions/index.js

@@ -0,0 +1,39 @@
+import { normalizedTypeToMoveTypeSignature, getPureBcsSchema } from "./serializer.js";
+import { Inputs } from "./Inputs.js";
+import {
+  Commands,
+  UpgradePolicy
+} from "./Commands.js";
+import {
+  Transaction,
+  isTransaction
+} from "./Transaction.js";
+import { TransactionDataBuilder } from "./TransactionData.js";
+import { ObjectCache, AsyncCache } from "./ObjectCache.js";
+import { SerialTransactionExecutor } from "./executor/serial.js";
+import { ParallelTransactionExecutor } from "./executor/parallel.js";
+import { coinWithBalance } from "./intents/CoinWithBalance.js";
+import { Arguments } from "./Arguments.js";
+import {
+  namedPackagesPlugin
+} from "./plugins/NamedPackagesPlugin.js";
+import { isArgument } from "./utils.js";
+export {
+  Arguments,
+  AsyncCache,
+  Commands,
+  Inputs,
+  ObjectCache,
+  ParallelTransactionExecutor,
+  SerialTransactionExecutor,
+  Transaction,
+  TransactionDataBuilder,
+  UpgradePolicy,
+  coinWithBalance,
+  getPureBcsSchema,
+  isArgument,
+  isTransaction,
+  namedPackagesPlugin,
+  normalizedTypeToMoveTypeSignature
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/transactions/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transactions/index.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { NamedPackagesOverrides } from '../experimental/mvr.js';\n\nexport { normalizedTypeToMoveTypeSignature, getPureBcsSchema } from './serializer.js';\n\nexport { Inputs } from './Inputs.js';\nexport {\n\tCommands,\n\ttype TransactionArgument,\n\ttype TransactionInput,\n\tUpgradePolicy,\n} from './Commands.js';\n\nexport {\n\tTransaction,\n\tisTransaction,\n\ttype TransactionObjectInput,\n\ttype TransactionObjectArgument,\n\ttype TransactionResult,\n} from './Transaction.js';\n\nexport { type SerializedTransactionDataV2 } from './data/v2.js';\nexport { type SerializedTransactionDataV1 } from './data/v1.js';\n\nexport type {\n\tTransactionData,\n\tArgument,\n\tObjectRef,\n\tGasData,\n\tCallArg,\n\tCommand,\n\tOpenMoveTypeSignature,\n\tOpenMoveTypeSignatureBody,\n} from './data/internal.js';\n\nexport { TransactionDataBuilder } from './TransactionData.js';\nexport { ObjectCache, AsyncCache } from './ObjectCache.js';\nexport { SerialTransactionExecutor } from './executor/serial.js';\nexport { ParallelTransactionExecutor } from './executor/parallel.js';\nexport type { ParallelTransactionExecutorOptions } from './executor/parallel.js';\nexport { coinWithBalance } from './intents/CoinWithBalance.js';\n\nexport type {\n\tBuildTransactionOptions,\n\tSerializeTransactionOptions,\n\tTransactionPlugin,\n} from './resolve.js';\n\nexport { Arguments } from './Arguments.js';\n\nexport {\n\tnamedPackagesPlugin,\n\ttype NamedPackagesPluginOptions,\n} from './plugins/NamedPackagesPlugin.js';\n\nexport type { NamedPackagesOverrides };\n/** @deprecated Use NamedPackagesOverrides instead */\nexport type NamedPackagesPluginCache = NamedPackagesOverrides;\n\nexport { isArgument } from './utils.js';\n"],
+  "mappings": "AAKA,SAAS,mCAAmC,wBAAwB;AAEpE,SAAS,cAAc;AACvB;AAAA,EACC;AAAA,EAGA;AAAA,OACM;AAEP;AAAA,EACC;AAAA,EACA;AAAA,OAIM;AAgBP,SAAS,8BAA8B;AACvC,SAAS,aAAa,kBAAkB;AACxC,SAAS,iCAAiC;AAC1C,SAAS,mCAAmC;AAE5C,SAAS,uBAAuB;AAQhC,SAAS,iBAAiB;AAE1B;AAAA,EACC;AAAA,OAEM;AAMP,SAAS,kBAAkB;",
+  "names": []
+}

package/dist/esm/transactions/intents/CoinWithBalance.d.ts

@@ -0,0 +1,9 @@
+import type { HaneulClient } from '../../client/index.js';
+import type { BuildTransactionOptions } from '../resolve.js';
+import type { Transaction, TransactionResult } from '../Transaction.js';
+export declare function coinWithBalance({ type, balance, useGasCoin, }: {
+    balance: bigint | number;
+    type?: string;
+    useGasCoin?: boolean;
+}): (tx: Transaction) => TransactionResult;
+export declare function getHaneulClient(options: BuildTransactionOptions): HaneulClient;

package/dist/esm/transactions/intents/CoinWithBalance.js

@@ -0,0 +1,168 @@
+import { bigint, object, parse, string } from "valibot";
+import { bcs } from "../../bcs/index.js";
+import { normalizeStructTag } from "../../utils/haneul-types.js";
+import { Commands } from "../Commands.js";
+import { Inputs } from "../Inputs.js";
+import { getClient } from "../resolve.js";
+const COIN_WITH_BALANCE = "CoinWithBalance";
+const SUI_TYPE = normalizeStructTag("0x2::haneul::HANEUL");
+function coinWithBalance({
+  type = SUI_TYPE,
+  balance,
+  useGasCoin = true
+}) {
+  let coinResult = null;
+  return (tx) => {
+    if (coinResult) {
+      return coinResult;
+    }
+    tx.addIntentResolver(COIN_WITH_BALANCE, resolveCoinBalance);
+    const coinType = type === "gas" ? type : normalizeStructTag(type);
+    coinResult = tx.add(
+      Commands.Intent({
+        name: COIN_WITH_BALANCE,
+        inputs: {},
+        data: {
+          type: coinType === SUI_TYPE && useGasCoin ? "gas" : coinType,
+          balance: BigInt(balance)
+        }
+      })
+    );
+    return coinResult;
+  };
+}
+const CoinWithBalanceData = object({
+  type: string(),
+  balance: bigint()
+});
+async function resolveCoinBalance(transactionData, buildOptions, next) {
+  const coinTypes = /* @__PURE__ */ new Set();
+  const totalByType = /* @__PURE__ */ new Map();
+  if (!transactionData.sender) {
+    throw new Error("Sender must be set to resolve CoinWithBalance");
+  }
+  for (const command of transactionData.commands) {
+    if (command.$kind === "$Intent" && command.$Intent.name === COIN_WITH_BALANCE) {
+      const { type, balance } = parse(CoinWithBalanceData, command.$Intent.data);
+      if (type !== "gas" && balance > 0n) {
+        coinTypes.add(type);
+      }
+      totalByType.set(type, (totalByType.get(type) ?? 0n) + balance);
+    }
+  }
+  const usedIds = /* @__PURE__ */ new Set();
+  for (const input of transactionData.inputs) {
+    if (input.Object?.ImmOrOwnedObject) {
+      usedIds.add(input.Object.ImmOrOwnedObject.objectId);
+    }
+    if (input.UnresolvedObject?.objectId) {
+      usedIds.add(input.UnresolvedObject.objectId);
+    }
+  }
+  const coinsByType = /* @__PURE__ */ new Map();
+  const client = getHaneulClient(buildOptions);
+  await Promise.all(
+    [...coinTypes].map(async (coinType) => {
+      coinsByType.set(
+        coinType,
+        await getCoinsOfType({
+          coinType,
+          balance: totalByType.get(coinType),
+          client,
+          owner: transactionData.sender,
+          usedIds
+        })
+      );
+    })
+  );
+  const mergedCoins = /* @__PURE__ */ new Map();
+  mergedCoins.set("gas", { $kind: "GasCoin", GasCoin: true });
+  for (const [index, transaction] of transactionData.commands.entries()) {
+    if (transaction.$kind !== "$Intent" || transaction.$Intent.name !== COIN_WITH_BALANCE) {
+      continue;
+    }
+    const { type, balance } = transaction.$Intent.data;
+    if (balance === 0n && type !== "gas") {
+      transactionData.replaceCommand(
+        index,
+        Commands.MoveCall({ target: "0x2::coin::zero", typeArguments: [type] })
+      );
+      continue;
+    }
+    const commands = [];
+    if (!mergedCoins.has(type)) {
+      const [first, ...rest] = coinsByType.get(type).map(
+        (coin) => transactionData.addInput(
+          "object",
+          Inputs.ObjectRef({
+            objectId: coin.coinObjectId,
+            digest: coin.digest,
+            version: coin.version
+          })
+        )
+      );
+      if (rest.length > 0) {
+        commands.push(Commands.MergeCoins(first, rest));
+      }
+      mergedCoins.set(type, first);
+    }
+    commands.push(
+      Commands.SplitCoins(mergedCoins.get(type), [
+        transactionData.addInput("pure", Inputs.Pure(bcs.u64().serialize(balance)))
+      ])
+    );
+    transactionData.replaceCommand(index, commands);
+    transactionData.mapArguments((arg) => {
+      if (arg.$kind === "Result" && arg.Result === index) {
+        return {
+          $kind: "NestedResult",
+          NestedResult: [index + commands.length - 1, 0]
+        };
+      }
+      return arg;
+    });
+  }
+  return next();
+}
+async function getCoinsOfType({
+  coinType,
+  balance,
+  client,
+  owner,
+  usedIds
+}) {
+  let remainingBalance = balance;
+  const coins = [];
+  return loadMoreCoins();
+  async function loadMoreCoins(cursor = null) {
+    const { data, hasNextPage, nextCursor } = await client.getCoins({ owner, coinType, cursor });
+    const sortedCoins = data.sort((a, b) => Number(BigInt(b.balance) - BigInt(a.balance)));
+    for (const coin of sortedCoins) {
+      if (usedIds.has(coin.coinObjectId)) {
+        continue;
+      }
+      const coinBalance = BigInt(coin.balance);
+      coins.push(coin);
+      remainingBalance -= coinBalance;
+      if (remainingBalance <= 0) {
+        return coins;
+      }
+    }
+    if (hasNextPage) {
+      return loadMoreCoins(nextCursor);
+    }
+    throw new Error(`Not enough coins of type ${coinType} to satisfy requested balance`);
+  }
+}
+function getHaneulClient(options) {
+  const client = getClient(options);
+  if (!client.jsonRpc) {
+    throw new Error(`CoinWithBalance intent currently only works with HaneulClient`);
+  }
+  return client;
+}
+export {
+  coinWithBalance,
+  getHaneulClient
+};
+//# sourceMappingURL=CoinWithBalance.js.map

package/dist/esm/transactions/intents/CoinWithBalance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transactions/intents/CoinWithBalance.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { InferInput } from 'valibot';\nimport { bigint, object, parse, string } from 'valibot';\n\nimport { bcs } from '../../bcs/index.js';\nimport type { CoinStruct, HaneulClient } from '../../client/index.js';\nimport { normalizeStructTag } from '../../utils/haneul-types.js';\nimport { Commands } from '../Commands.js';\nimport type { Argument } from '../data/internal.js';\nimport { Inputs } from '../Inputs.js';\nimport { getClient } from '../resolve.js';\nimport type { BuildTransactionOptions } from '../resolve.js';\nimport type { Transaction, TransactionResult } from '../Transaction.js';\nimport type { TransactionDataBuilder } from '../TransactionData.js';\n\nconst COIN_WITH_BALANCE = 'CoinWithBalance';\nconst SUI_TYPE = normalizeStructTag('0x2::haneul::HANEUL');\n\nexport function coinWithBalance({\n\ttype = SUI_TYPE,\n\tbalance,\n\tuseGasCoin = true,\n}: {\n\tbalance: bigint | number;\n\ttype?: string;\n\tuseGasCoin?: boolean;\n}): (tx: Transaction) => TransactionResult {\n\tlet coinResult: TransactionResult | null = null;\n\n\treturn (tx: Transaction) => {\n\t\tif (coinResult) {\n\t\t\treturn coinResult;\n\t\t}\n\n\t\ttx.addIntentResolver(COIN_WITH_BALANCE, resolveCoinBalance);\n\t\tconst coinType = type === 'gas' ? type : normalizeStructTag(type);\n\n\t\tcoinResult = tx.add(\n\t\t\tCommands.Intent({\n\t\t\t\tname: COIN_WITH_BALANCE,\n\t\t\t\tinputs: {},\n\t\t\t\tdata: {\n\t\t\t\t\ttype: coinType === SUI_TYPE && useGasCoin ? 'gas' : coinType,\n\t\t\t\t\tbalance: BigInt(balance),\n\t\t\t\t} satisfies InferInput<typeof CoinWithBalanceData>,\n\t\t\t}),\n\t\t);\n\n\t\treturn coinResult;\n\t};\n}\n\nconst CoinWithBalanceData = object({\n\ttype: string(),\n\tbalance: bigint(),\n});\n\nasync function resolveCoinBalance(\n\ttransactionData: TransactionDataBuilder,\n\tbuildOptions: BuildTransactionOptions,\n\tnext: () => Promise<void>,\n) {\n\tconst coinTypes = new Set<string>();\n\tconst totalByType = new Map<string, bigint>();\n\n\tif (!transactionData.sender) {\n\t\tthrow new Error('Sender must be set to resolve CoinWithBalance');\n\t}\n\n\tfor (const command of transactionData.commands) {\n\t\tif (command.$kind === '$Intent' && command.$Intent.name === COIN_WITH_BALANCE) {\n\t\t\tconst { type, balance } = parse(CoinWithBalanceData, command.$Intent.data);\n\n\t\t\tif (type !== 'gas' && balance > 0n) {\n\t\t\t\tcoinTypes.add(type);\n\t\t\t}\n\n\t\t\ttotalByType.set(type, (totalByType.get(type) ?? 0n) + balance);\n\t\t}\n\t}\n\tconst usedIds = new Set<string>();\n\n\tfor (const input of transactionData.inputs) {\n\t\tif (input.Object?.ImmOrOwnedObject) {\n\t\t\tusedIds.add(input.Object.ImmOrOwnedObject.objectId);\n\t\t}\n\t\tif (input.UnresolvedObject?.objectId) {\n\t\t\tusedIds.add(input.UnresolvedObject.objectId);\n\t\t}\n\t}\n\n\tconst coinsByType = new Map<string, CoinStruct[]>();\n\tconst client = getHaneulClient(buildOptions);\n\tawait Promise.all(\n\t\t[...coinTypes].map(async (coinType) => {\n\t\t\tcoinsByType.set(\n\t\t\t\tcoinType,\n\t\t\t\tawait getCoinsOfType({\n\t\t\t\t\tcoinType,\n\t\t\t\t\tbalance: totalByType.get(coinType)!,\n\t\t\t\t\tclient,\n\t\t\t\t\towner: transactionData.sender!,\n\t\t\t\t\tusedIds,\n\t\t\t\t}),\n\t\t\t);\n\t\t}),\n\t);\n\n\tconst mergedCoins = new Map<string, Argument>();\n\n\tmergedCoins.set('gas', { $kind: 'GasCoin', GasCoin: true });\n\n\tfor (const [index, transaction] of transactionData.commands.entries()) {\n\t\tif (transaction.$kind !== '$Intent' || transaction.$Intent.name !== COIN_WITH_BALANCE) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst { type, balance } = transaction.$Intent.data as {\n\t\t\ttype: string;\n\t\t\tbalance: bigint;\n\t\t};\n\n\t\tif (balance === 0n && type !== 'gas') {\n\t\t\ttransactionData.replaceCommand(\n\t\t\t\tindex,\n\t\t\t\tCommands.MoveCall({ target: '0x2::coin::zero', typeArguments: [type] }),\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst commands = [];\n\n\t\tif (!mergedCoins.has(type)) {\n\t\t\tconst [first, ...rest] = coinsByType.get(type)!.map((coin) =>\n\t\t\t\ttransactionData.addInput(\n\t\t\t\t\t'object',\n\t\t\t\t\tInputs.ObjectRef({\n\t\t\t\t\t\tobjectId: coin.coinObjectId,\n\t\t\t\t\t\tdigest: coin.digest,\n\t\t\t\t\t\tversion: coin.version,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t);\n\n\t\t\tif (rest.length > 0) {\n\t\t\t\tcommands.push(Commands.MergeCoins(first, rest));\n\t\t\t}\n\n\t\t\tmergedCoins.set(type, first);\n\t\t}\n\n\t\tcommands.push(\n\t\t\tCommands.SplitCoins(mergedCoins.get(type)!, [\n\t\t\t\ttransactionData.addInput('pure', Inputs.Pure(bcs.u64().serialize(balance))),\n\t\t\t]),\n\t\t);\n\n\t\ttransactionData.replaceCommand(index, commands);\n\n\t\ttransactionData.mapArguments((arg) => {\n\t\t\tif (arg.$kind === 'Result' && arg.Result === index) {\n\t\t\t\treturn {\n\t\t\t\t\t$kind: 'NestedResult',\n\t\t\t\t\tNestedResult: [index + commands.length - 1, 0],\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn arg;\n\t\t});\n\t}\n\n\treturn next();\n}\n\nasync function getCoinsOfType({\n\tcoinType,\n\tbalance,\n\tclient,\n\towner,\n\tusedIds,\n}: {\n\tcoinType: string;\n\tbalance: bigint;\n\tclient: HaneulClient;\n\towner: string;\n\tusedIds: Set<string>;\n}): Promise<CoinStruct[]> {\n\tlet remainingBalance = balance;\n\tconst coins: CoinStruct[] = [];\n\n\treturn loadMoreCoins();\n\n\tasync function loadMoreCoins(cursor: string | null = null): Promise<CoinStruct[]> {\n\t\tconst { data, hasNextPage, nextCursor } = await client.getCoins({ owner, coinType, cursor });\n\n\t\tconst sortedCoins = data.sort((a, b) => Number(BigInt(b.balance) - BigInt(a.balance)));\n\n\t\tfor (const coin of sortedCoins) {\n\t\t\tif (usedIds.has(coin.coinObjectId)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst coinBalance = BigInt(coin.balance);\n\n\t\t\tcoins.push(coin);\n\t\t\tremainingBalance -= coinBalance;\n\n\t\t\tif (remainingBalance <= 0) {\n\t\t\t\treturn coins;\n\t\t\t}\n\t\t}\n\n\t\tif (hasNextPage) {\n\t\t\treturn loadMoreCoins(nextCursor);\n\t\t}\n\n\t\tthrow new Error(`Not enough coins of type ${coinType} to satisfy requested balance`);\n\t}\n}\n\nexport function getHaneulClient(options: BuildTransactionOptions): HaneulClient {\n\tconst client = getClient(options) as HaneulClient;\n\tif (!client.jsonRpc) {\n\t\tthrow new Error(`CoinWithBalance intent currently only works with HaneulClient`);\n\t}\n\n\treturn client;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/transactions/object.d.ts

@@ -0,0 +1,16 @@
+import type { Transaction, TransactionObjectInput } from './Transaction.js';
+export declare function createObjectMethods<T>(makeObject: (value: TransactionObjectInput) => T): {
+    (value: TransactionObjectInput): T;
+    system(options?: {
+        mutable?: boolean;
+    }): T;
+    clock(): T;
+    random(): T;
+    denyList(options?: {
+        mutable?: boolean;
+    }): T;
+    option({ type, value }: {
+        type: string;
+        value: TransactionObjectInput | null;
+    }): (tx: Transaction) => import("./Transaction.js").TransactionResult;
+};

package/dist/esm/transactions/object.js

@@ -0,0 +1,58 @@
+import { Inputs } from "./Inputs.js";
+function createObjectMethods(makeObject) {
+  function object(value) {
+    return makeObject(value);
+  }
+  object.system = (options) => {
+    const mutable = options?.mutable;
+    if (mutable !== void 0) {
+      return object(
+        Inputs.SharedObjectRef({
+          objectId: "0x5",
+          initialSharedVersion: 1,
+          mutable
+        })
+      );
+    }
+    return object({
+      $kind: "UnresolvedObject",
+      UnresolvedObject: {
+        objectId: "0x5",
+        initialSharedVersion: 1
+      }
+    });
+  };
+  object.clock = () => object(
+    Inputs.SharedObjectRef({
+      objectId: "0x6",
+      initialSharedVersion: 1,
+      mutable: false
+    })
+  );
+  object.random = () => object({
+    $kind: "UnresolvedObject",
+    UnresolvedObject: {
+      objectId: "0x8",
+      mutable: false
+    }
+  });
+  object.denyList = (options) => {
+    return object({
+      $kind: "UnresolvedObject",
+      UnresolvedObject: {
+        objectId: "0x403",
+        mutable: options?.mutable
+      }
+    });
+  };
+  object.option = ({ type, value }) => (tx) => tx.moveCall({
+    typeArguments: [type],
+    target: `0x1::option::${value === null ? "none" : "some"}`,
+    arguments: value === null ? [] : [tx.object(value)]
+  });
+  return object;
+}
+export {
+  createObjectMethods
+};
+//# sourceMappingURL=object.js.map

package/dist/esm/transactions/object.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transactions/object.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { Transaction, TransactionObjectInput } from './Transaction.js';\nimport { Inputs } from './Inputs.js';\n\nexport function createObjectMethods<T>(makeObject: (value: TransactionObjectInput) => T) {\n\tfunction object(value: TransactionObjectInput) {\n\t\treturn makeObject(value);\n\t}\n\n\tobject.system = (options?: { mutable?: boolean }) => {\n\t\tconst mutable = options?.mutable;\n\n\t\tif (mutable !== undefined) {\n\t\t\treturn object(\n\t\t\t\tInputs.SharedObjectRef({\n\t\t\t\t\tobjectId: '0x5',\n\t\t\t\t\tinitialSharedVersion: 1,\n\t\t\t\t\tmutable,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\treturn object({\n\t\t\t$kind: 'UnresolvedObject',\n\t\t\tUnresolvedObject: {\n\t\t\t\tobjectId: '0x5',\n\t\t\t\tinitialSharedVersion: 1,\n\t\t\t},\n\t\t});\n\t};\n\tobject.clock = () =>\n\t\tobject(\n\t\t\tInputs.SharedObjectRef({\n\t\t\t\tobjectId: '0x6',\n\t\t\t\tinitialSharedVersion: 1,\n\t\t\t\tmutable: false,\n\t\t\t}),\n\t\t);\n\tobject.random = () =>\n\t\tobject({\n\t\t\t$kind: 'UnresolvedObject',\n\t\t\tUnresolvedObject: {\n\t\t\t\tobjectId: '0x8',\n\t\t\t\tmutable: false,\n\t\t\t},\n\t\t});\n\tobject.denyList = (options?: { mutable?: boolean }) => {\n\t\treturn object({\n\t\t\t$kind: 'UnresolvedObject',\n\t\t\tUnresolvedObject: {\n\t\t\t\tobjectId: '0x403',\n\t\t\t\tmutable: options?.mutable,\n\t\t\t},\n\t\t});\n\t};\n\tobject.option =\n\t\t({ type, value }: { type: string; value: TransactionObjectInput | null }) =>\n\t\t(tx: Transaction) =>\n\t\t\ttx.moveCall({\n\t\t\t\ttypeArguments: [type],\n\t\t\t\ttarget: `0x1::option::${value === null ? 'none' : 'some'}`,\n\t\t\t\targuments: value === null ? [] : [tx.object(value)],\n\t\t\t});\n\n\treturn object;\n}\n"],
+  "mappings": "AAIA,SAAS,cAAc;AAEhB,SAAS,oBAAuB,YAAkD;AACxF,WAAS,OAAO,OAA+B;AAC9C,WAAO,WAAW,KAAK;AAAA,EACxB;AAEA,SAAO,SAAS,CAAC,YAAoC;AACpD,UAAM,UAAU,SAAS;AAEzB,QAAI,YAAY,QAAW;AAC1B,aAAO;AAAA,QACN,OAAO,gBAAgB;AAAA,UACtB,UAAU;AAAA,UACV,sBAAsB;AAAA,UACtB;AAAA,QACD,CAAC;AAAA,MACF;AAAA,IACD;AAEA,WAAO,OAAO;AAAA,MACb,OAAO;AAAA,MACP,kBAAkB;AAAA,QACjB,UAAU;AAAA,QACV,sBAAsB;AAAA,MACvB;AAAA,IACD,CAAC;AAAA,EACF;AACA,SAAO,QAAQ,MACd;AAAA,IACC,OAAO,gBAAgB;AAAA,MACtB,UAAU;AAAA,MACV,sBAAsB;AAAA,MACtB,SAAS;AAAA,IACV,CAAC;AAAA,EACF;AACD,SAAO,SAAS,MACf,OAAO;AAAA,IACN,OAAO;AAAA,IACP,kBAAkB;AAAA,MACjB,UAAU;AAAA,MACV,SAAS;AAAA,IACV;AAAA,EACD,CAAC;AACF,SAAO,WAAW,CAAC,YAAoC;AACtD,WAAO,OAAO;AAAA,MACb,OAAO;AAAA,MACP,kBAAkB;AAAA,QACjB,UAAU;AAAA,QACV,SAAS,SAAS;AAAA,MACnB;AAAA,IACD,CAAC;AAAA,EACF;AACA,SAAO,SACN,CAAC,EAAE,MAAM,MAAM,MACf,CAAC,OACA,GAAG,SAAS;AAAA,IACX,eAAe,CAAC,IAAI;AAAA,IACpB,QAAQ,gBAAgB,UAAU,OAAO,SAAS,MAAM;AAAA,IACxD,WAAW,UAAU,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC;AAAA,EACnD,CAAC;AAEH,SAAO;AACR;",
+  "names": []
+}

package/dist/esm/transactions/plugins/NamedPackagesPlugin.d.ts

@@ -0,0 +1,48 @@
+import type { BuildTransactionOptions } from '../resolve.js';
+import type { TransactionDataBuilder } from '../TransactionData.js';
+import type { NamedPackagesOverrides } from '../../experimental/mvr.js';
+export type NamedPackagesPluginOptions = {
+    /**
+     * The URL of the MVR API to use for resolving names.
+     */
+    url: string;
+    /**
+     * The number of names to resolve in each batch request.
+     * Needs to be calculated based on the GraphQL query limits.
+     */
+    pageSize?: number;
+    /**
+     * Local overrides for the resolution plugin. Pass this to pre-populate
+     * the cache with known packages / types (especially useful for local or CI testing).
+     *
+     * The type cache expects ONLY first-level types to ensure the cache is more composable.
+     *
+     * 	Expected format example:
+     *  {
+     * 		packages: {
+     * 			'@framework/std': '0x1234',
+     * 		},
+     * 		types: {
+     * 			'@framework/std::string::String': '0x1234::string::String',
+     * 		},
+     * 	}
+     *
+     */
+    overrides?: NamedPackagesOverrides;
+};
+/**
+ * @experimental This plugin is in experimental phase and there might be breaking changes in the future
+ *
+ * Adds named resolution so that you can use .move names in your transactions.
+ * e.g. `@org/app::type::Type` will be resolved to `0x1234::type::Type`.
+ * This plugin will resolve all names & types in the transaction block.
+ *
+ * To install this plugin globally in your app, use:
+ * ```
+ * Transaction.registerGlobalSerializationPlugin("namedPackagesPlugin", namedPackagesPlugin({ suiGraphQLClient }));
+ * ```
+ *
+ * You can also define `overrides` to pre-populate name resolutions locally (removes the GraphQL request).
+ */
+export declare const namedPackagesPlugin: (options?: NamedPackagesPluginOptions) => (transactionData: TransactionDataBuilder, buildOptions: BuildTransactionOptions, next: () => Promise<void>) => Promise<void>;
+export declare function getClient(options: BuildTransactionOptions): import("../../experimental/core.js").ClientWithCoreApi;

package/dist/esm/transactions/plugins/NamedPackagesPlugin.js

@@ -0,0 +1,47 @@
+import { ClientCache } from "../../experimental/cache.js";
+import { MvrClient } from "../../experimental/mvr.js";
+import { findNamesInTransaction, replaceNames } from "../../experimental/mvr.js";
+const cacheMap = /* @__PURE__ */ new WeakMap();
+const namedPackagesPlugin = (options) => {
+  let mvrClient;
+  if (options) {
+    const overrides = options.overrides ?? {
+      packages: {},
+      types: {}
+    };
+    if (!cacheMap.has(overrides)) {
+      cacheMap.set(overrides, new ClientCache());
+    }
+    mvrClient = new MvrClient({
+      cache: cacheMap.get(overrides),
+      url: options.url,
+      pageSize: options.pageSize,
+      overrides
+    });
+  }
+  return async (transactionData, buildOptions, next) => {
+    const names = findNamesInTransaction(transactionData);
+    if (names.types.length === 0 && names.packages.length === 0) {
+      return next();
+    }
+    const resolved = await (mvrClient || getClient(buildOptions).core.mvr).resolve({
+      types: names.types,
+      packages: names.packages
+    });
+    replaceNames(transactionData, resolved);
+    await next();
+  };
+};
+function getClient(options) {
+  if (!options.client) {
+    throw new Error(
+      `No sui client passed to Transaction#build, but transaction data was not sufficient to build offline.`
+    );
+  }
+  return options.client;
+}
+export {
+  getClient,
+  namedPackagesPlugin
+};
+//# sourceMappingURL=NamedPackagesPlugin.js.map

package/dist/esm/transactions/plugins/NamedPackagesPlugin.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/transactions/plugins/NamedPackagesPlugin.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { ClientCache } from '../../experimental/cache.js';\nimport { MvrClient } from '../../experimental/mvr.js';\nimport type { BuildTransactionOptions } from '../resolve.js';\nimport type { TransactionDataBuilder } from '../TransactionData.js';\nimport { findNamesInTransaction, replaceNames } from '../../experimental/mvr.js';\nimport type { NamedPackagesOverrides } from '../../experimental/mvr.js';\n\nexport type NamedPackagesPluginOptions = {\n\t/**\n\t * The URL of the MVR API to use for resolving names.\n\t */\n\turl: string;\n\t/**\n\t * The number of names to resolve in each batch request.\n\t * Needs to be calculated based on the GraphQL query limits.\n\t */\n\tpageSize?: number;\n\t/**\n\t * Local overrides for the resolution plugin. Pass this to pre-populate\n\t * the cache with known packages / types (especially useful for local or CI testing).\n\t *\n\t * The type cache expects ONLY first-level types to ensure the cache is more composable.\n\t *\n\t * \tExpected format example:\n\t *  {\n\t * \t\tpackages: {\n\t * \t\t\t'@framework/std': '0x1234',\n\t * \t\t},\n\t * \t\ttypes: {\n\t * \t\t\t'@framework/std::string::String': '0x1234::string::String',\n\t * \t\t},\n\t * \t}\n\t *\n\t */\n\toverrides?: NamedPackagesOverrides;\n};\n\n// The original versions of the mvr plugin cached lookups by mutating overrides.\n// We don't want to mutate the options, but we can link our cache to the provided overrides object\n// This preserves the caching across transactions while removing the mutation side effects\nconst cacheMap = new WeakMap<object, ClientCache>();\n\n/**\n * @experimental This plugin is in experimental phase and there might be breaking changes in the future\n *\n * Adds named resolution so that you can use .move names in your transactions.\n * e.g. `@org/app::type::Type` will be resolved to `0x1234::type::Type`.\n * This plugin will resolve all names & types in the transaction block.\n *\n * To install this plugin globally in your app, use:\n * ```\n * Transaction.registerGlobalSerializationPlugin(\"namedPackagesPlugin\", namedPackagesPlugin({ suiGraphQLClient }));\n * ```\n *\n * You can also define `overrides` to pre-populate name resolutions locally (removes the GraphQL request).\n */\nexport const namedPackagesPlugin = (options?: NamedPackagesPluginOptions) => {\n\tlet mvrClient: MvrClient | undefined;\n\n\tif (options) {\n\t\tconst overrides = options.overrides ?? {\n\t\t\tpackages: {},\n\t\t\ttypes: {},\n\t\t};\n\n\t\tif (!cacheMap.has(overrides)) {\n\t\t\tcacheMap.set(overrides, new ClientCache());\n\t\t}\n\n\t\tmvrClient = new MvrClient({\n\t\t\tcache: cacheMap.get(overrides)!,\n\t\t\turl: options.url,\n\t\t\tpageSize: options.pageSize,\n\t\t\toverrides: overrides,\n\t\t});\n\t}\n\n\treturn async (\n\t\ttransactionData: TransactionDataBuilder,\n\t\tbuildOptions: BuildTransactionOptions,\n\t\tnext: () => Promise<void>,\n\t) => {\n\t\tconst names = findNamesInTransaction(transactionData);\n\n\t\tif (names.types.length === 0 && names.packages.length === 0) {\n\t\t\treturn next();\n\t\t}\n\n\t\tconst resolved = await (mvrClient || getClient(buildOptions).core.mvr).resolve({\n\t\t\ttypes: names.types,\n\t\t\tpackages: names.packages,\n\t\t});\n\n\t\treplaceNames(transactionData, resolved);\n\n\t\tawait next();\n\t};\n};\n\nexport function getClient(options: BuildTransactionOptions) {\n\tif (!options.client) {\n\t\tthrow new Error(\n\t\t\t`No sui client passed to Transaction#build, but transaction data was not sufficient to build offline.`,\n\t\t);\n\t}\n\n\treturn options.client;\n}\n"],
+  "mappings": "AAGA,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAG1B,SAAS,wBAAwB,oBAAoB;AAoCrD,MAAM,WAAW,oBAAI,QAA6B;AAgB3C,MAAM,sBAAsB,CAAC,YAAyC;AAC5E,MAAI;AAEJ,MAAI,SAAS;AACZ,UAAM,YAAY,QAAQ,aAAa;AAAA,MACtC,UAAU,CAAC;AAAA,MACX,OAAO,CAAC;AAAA,IACT;AAEA,QAAI,CAAC,SAAS,IAAI,SAAS,GAAG;AAC7B,eAAS,IAAI,WAAW,IAAI,YAAY,CAAC;AAAA,IAC1C;AAEA,gBAAY,IAAI,UAAU;AAAA,MACzB,OAAO,SAAS,IAAI,SAAS;AAAA,MAC7B,KAAK,QAAQ;AAAA,MACb,UAAU,QAAQ;AAAA,MAClB;AAAA,IACD,CAAC;AAAA,EACF;AAEA,SAAO,OACN,iBACA,cACA,SACI;AACJ,UAAM,QAAQ,uBAAuB,eAAe;AAEpD,QAAI,MAAM,MAAM,WAAW,KAAK,MAAM,SAAS,WAAW,GAAG;AAC5D,aAAO,KAAK;AAAA,IACb;AAEA,UAAM,WAAW,OAAO,aAAa,UAAU,YAAY,EAAE,KAAK,KAAK,QAAQ;AAAA,MAC9E,OAAO,MAAM;AAAA,MACb,UAAU,MAAM;AAAA,IACjB,CAAC;AAED,iBAAa,iBAAiB,QAAQ;AAEtC,UAAM,KAAK;AAAA,EACZ;AACD;AAEO,SAAS,UAAU,SAAkC;AAC3D,MAAI,CAAC,QAAQ,QAAQ;AACpB,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AAEA,SAAO,QAAQ;AAChB;",
+  "names": []
+}

package/dist/esm/transactions/pure.d.ts

@@ -0,0 +1,20 @@
+import type { SerializedBcs } from '@haneullabs/bcs';
+import type { PureTypeName, ShapeFromPureTypeName, ValidPureTypeName } from '../bcs/pure.js';
+export declare function createPure<T>(makePure: (value: SerializedBcs<any, any> | Uint8Array) => T): {
+    <Type extends PureTypeName>(type: Type extends PureTypeName ? ValidPureTypeName<Type> : Type, value: ShapeFromPureTypeName<Type>): T;
+    (value: SerializedBcs<any, any> | Uint8Array): T;
+    u8(value: number): T;
+    u16(value: number): T;
+    u32(value: number): T;
+    u64(value: bigint | number | string): T;
+    u128(value: bigint | number | string): T;
+    u256(value: bigint | number | string): T;
+    bool(value: boolean): T;
+    string(value: string): T;
+    address(value: string): T;
+    id: (value: string) => T;
+    vector<Type extends PureTypeName>(type: Type extends PureTypeName ? ValidPureTypeName<Type> : Type, value: Iterable<ShapeFromPureTypeName<Type>> & {
+        length: number;
+    }): T;
+    option<Type extends PureTypeName>(type: Type extends PureTypeName ? ValidPureTypeName<Type> : Type, value: ShapeFromPureTypeName<Type> | null | undefined): T;
+};

package/dist/esm/transactions/pure.js

@@ -0,0 +1,37 @@
+import { isSerializedBcs } from "@haneullabs/bcs";
+import { bcs } from "../bcs/index.js";
+import { pureBcsSchemaFromTypeName } from "../bcs/pure.js";
+function createPure(makePure) {
+  function pure(typeOrSerializedValue, value) {
+    if (typeof typeOrSerializedValue === "string") {
+      return makePure(pureBcsSchemaFromTypeName(typeOrSerializedValue).serialize(value));
+    }
+    if (typeOrSerializedValue instanceof Uint8Array || isSerializedBcs(typeOrSerializedValue)) {
+      return makePure(typeOrSerializedValue);
+    }
+    throw new Error("tx.pure must be called either a bcs type name, or a serialized bcs value");
+  }
+  pure.u8 = (value) => makePure(bcs.U8.serialize(value));
+  pure.u16 = (value) => makePure(bcs.U16.serialize(value));
+  pure.u32 = (value) => makePure(bcs.U32.serialize(value));
+  pure.u64 = (value) => makePure(bcs.U64.serialize(value));
+  pure.u128 = (value) => makePure(bcs.U128.serialize(value));
+  pure.u256 = (value) => makePure(bcs.U256.serialize(value));
+  pure.bool = (value) => makePure(bcs.Bool.serialize(value));
+  pure.string = (value) => makePure(bcs.String.serialize(value));
+  pure.address = (value) => makePure(bcs.Address.serialize(value));
+  pure.id = pure.address;
+  pure.vector = (type, value) => {
+    return makePure(
+      bcs.vector(pureBcsSchemaFromTypeName(type)).serialize(value)
+    );
+  };
+  pure.option = (type, value) => {
+    return makePure(bcs.option(pureBcsSchemaFromTypeName(type)).serialize(value));
+  };
+  return pure;
+}
+export {
+  createPure
+};
+//# sourceMappingURL=pure.js.map

package/dist/esm/transactions/pure.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/transactions/pure.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isSerializedBcs } from '@haneullabs/bcs';\nimport type { SerializedBcs } from '@haneullabs/bcs';\n\nimport { bcs } from '../bcs/index.js';\nimport { pureBcsSchemaFromTypeName } from '../bcs/pure.js';\nimport type { PureTypeName, ShapeFromPureTypeName, ValidPureTypeName } from '../bcs/pure.js';\n\nexport function createPure<T>(makePure: (value: SerializedBcs<any, any> | Uint8Array) => T) {\n\tfunction pure<Type extends PureTypeName>(\n\t\ttype: Type extends PureTypeName ? ValidPureTypeName<Type> : Type,\n\t\tvalue: ShapeFromPureTypeName<Type>,\n\t): T;\n\n\tfunction pure(\n\t\t/**\n\t\t * The pure value, serialized to BCS. If this is a Uint8Array, then the value\n\t\t * is assumed to be raw bytes, and will be used directly.\n\t\t */\n\t\tvalue: SerializedBcs<any, any> | Uint8Array,\n\t): T;\n\n\tfunction pure(\n\t\ttypeOrSerializedValue?: PureTypeName | SerializedBcs<any, any> | Uint8Array,\n\t\tvalue?: unknown,\n\t): T {\n\t\tif (typeof typeOrSerializedValue === 'string') {\n\t\t\treturn makePure(pureBcsSchemaFromTypeName(typeOrSerializedValue).serialize(value as never));\n\t\t}\n\n\t\tif (typeOrSerializedValue instanceof Uint8Array || isSerializedBcs(typeOrSerializedValue)) {\n\t\t\treturn makePure(typeOrSerializedValue);\n\t\t}\n\n\t\tthrow new Error('tx.pure must be called either a bcs type name, or a serialized bcs value');\n\t}\n\n\tpure.u8 = (value: number) => makePure(bcs.U8.serialize(value));\n\tpure.u16 = (value: number) => makePure(bcs.U16.serialize(value));\n\tpure.u32 = (value: number) => makePure(bcs.U32.serialize(value));\n\tpure.u64 = (value: bigint | number | string) => makePure(bcs.U64.serialize(value));\n\tpure.u128 = (value: bigint | number | string) => makePure(bcs.U128.serialize(value));\n\tpure.u256 = (value: bigint | number | string) => makePure(bcs.U256.serialize(value));\n\tpure.bool = (value: boolean) => makePure(bcs.Bool.serialize(value));\n\tpure.string = (value: string) => makePure(bcs.String.serialize(value));\n\tpure.address = (value: string) => makePure(bcs.Address.serialize(value));\n\tpure.id = pure.address;\n\tpure.vector = <Type extends PureTypeName>(\n\t\ttype: Type extends PureTypeName ? ValidPureTypeName<Type> : Type,\n\t\tvalue: Iterable<ShapeFromPureTypeName<Type>> & { length: number },\n\t) => {\n\t\treturn makePure(\n\t\t\tbcs.vector(pureBcsSchemaFromTypeName(type as PureTypeName)).serialize(value as never),\n\t\t);\n\t};\n\tpure.option = <Type extends PureTypeName>(\n\t\ttype: Type extends PureTypeName ? ValidPureTypeName<Type> : Type,\n\t\tvalue: ShapeFromPureTypeName<Type> | null | undefined,\n\t) => {\n\t\treturn makePure(bcs.option(pureBcsSchemaFromTypeName(type)).serialize(value as never));\n\t};\n\n\treturn pure;\n}\n"],
+  "mappings": "AAGA,SAAS,uBAAuB;AAGhC,SAAS,WAAW;AACpB,SAAS,iCAAiC;AAGnC,SAAS,WAAc,UAA8D;AAc3F,WAAS,KACR,uBACA,OACI;AACJ,QAAI,OAAO,0BAA0B,UAAU;AAC9C,aAAO,SAAS,0BAA0B,qBAAqB,EAAE,UAAU,KAAc,CAAC;AAAA,IAC3F;AAEA,QAAI,iCAAiC,cAAc,gBAAgB,qBAAqB,GAAG;AAC1F,aAAO,SAAS,qBAAqB;AAAA,IACtC;AAEA,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC3F;AAEA,OAAK,KAAK,CAAC,UAAkB,SAAS,IAAI,GAAG,UAAU,KAAK,CAAC;AAC7D,OAAK,MAAM,CAAC,UAAkB,SAAS,IAAI,IAAI,UAAU,KAAK,CAAC;AAC/D,OAAK,MAAM,CAAC,UAAkB,SAAS,IAAI,IAAI,UAAU,KAAK,CAAC;AAC/D,OAAK,MAAM,CAAC,UAAoC,SAAS,IAAI,IAAI,UAAU,KAAK,CAAC;AACjF,OAAK,OAAO,CAAC,UAAoC,SAAS,IAAI,KAAK,UAAU,KAAK,CAAC;AACnF,OAAK,OAAO,CAAC,UAAoC,SAAS,IAAI,KAAK,UAAU,KAAK,CAAC;AACnF,OAAK,OAAO,CAAC,UAAmB,SAAS,IAAI,KAAK,UAAU,KAAK,CAAC;AAClE,OAAK,SAAS,CAAC,UAAkB,SAAS,IAAI,OAAO,UAAU,KAAK,CAAC;AACrE,OAAK,UAAU,CAAC,UAAkB,SAAS,IAAI,QAAQ,UAAU,KAAK,CAAC;AACvE,OAAK,KAAK,KAAK;AACf,OAAK,SAAS,CACb,MACA,UACI;AACJ,WAAO;AAAA,MACN,IAAI,OAAO,0BAA0B,IAAoB,CAAC,EAAE,UAAU,KAAc;AAAA,IACrF;AAAA,EACD;AACA,OAAK,SAAS,CACb,MACA,UACI;AACJ,WAAO,SAAS,IAAI,OAAO,0BAA0B,IAAI,CAAC,EAAE,UAAU,KAAc,CAAC;AAAA,EACtF;AAEA,SAAO;AACR;",
+  "names": []
+}

package/dist/esm/transactions/resolve.d.ts

@@ -0,0 +1,13 @@
+import type { ClientWithCoreApi } from '../experimental/index.js';
+import type { TransactionDataBuilder } from './TransactionData.js';
+export interface BuildTransactionOptions {
+    client?: ClientWithCoreApi;
+    onlyTransactionKind?: boolean;
+}
+export interface SerializeTransactionOptions extends BuildTransactionOptions {
+    supportedIntents?: string[];
+}
+export type TransactionPlugin = (transactionData: TransactionDataBuilder, options: BuildTransactionOptions, next: () => Promise<void>) => Promise<void>;
+export declare function needsTransactionResolution(data: TransactionDataBuilder, options: BuildTransactionOptions): boolean;
+export declare function resolveTransactionPlugin(transactionData: TransactionDataBuilder, options: BuildTransactionOptions, next: () => Promise<void>): Promise<void>;
+export declare function getClient(options: BuildTransactionOptions): ClientWithCoreApi;