@trustvc/trustvc 1.5.4 → 1.6.0-alpha.1

package/dist/cjs/index.js

@@ -2,6 +2,7 @@
 
 var tokenRegistryV4 = require('./token-registry-v4');
 var tokenRegistryV5 = require('./token-registry-v5');
+var tokenRegistryFunctions = require('./token-registry-functions');
 var core = require('./core');
 var openAttestation = require('./open-attestation');
 var verify = require('./verify');
@@ -79,6 +80,12 @@ Object.defineProperty(exports, "v5Utils", {
   enumerable: true,
   get: function () { return tokenRegistryV5.v5Utils; }
 });
+Object.keys(tokenRegistryFunctions).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return tokenRegistryFunctions[k]; }
+  });
+});
 Object.keys(core).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,

package/dist/cjs/token-registry-functions/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+var transfer = require('./transfer');
+
+
+
+Object.keys(transfer).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return transfer[k]; }
+	});
+});

package/dist/cjs/token-registry-functions/transfer.js

@@ -0,0 +1,347 @@
+'use strict';
+
+var tradetrustUtils = require('@tradetrust-tt/tradetrust-utils');
+var core = require('src/core');
+var tokenRegistryV4 = require('src/token-registry-v4');
+var tokenRegistryV5 = require('src/token-registry-v5');
+var ethers = require('src/utils/ethers');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const getChainIdSafe = /* @__PURE__ */ __name(async (signer) => {
+  if (ethers.isV6EthersProvider(signer.provider)) {
+    const network = await signer.provider?.getNetwork();
+    if (!network?.chainId) throw new Error("Cannot determine chainId: provider is missing");
+    return network.chainId;
+  }
+  return await signer.getChainId();
+}, "getChainIdSafe");
+const transferHolder = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenRegistryAddress, tokenId } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await core.getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { holderAddress, remarks } = params;
+  let titleEscrowContract = tokenRegistryV5.v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${core.encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (isV4TT) {
+    titleEscrowContract = tokenRegistryV4.v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferHolder(
+        holderAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferHolder(
+        holderAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferHolder failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = tradetrustUtils.SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.transferHolder(
+      holderAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.transferHolder(holderAddress, txOptions);
+  }
+}, "transferHolder");
+const transferBeneficiary = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await core.getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, remarks } = params;
+  let titleEscrowContract = tokenRegistryV5.v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${core.encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (!isV5TT) {
+    titleEscrowContract = tokenRegistryV4.v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferBeneficiary(
+        newBeneficiaryAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferBeneficiary(
+        newBeneficiaryAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferBeneficiary failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = tradetrustUtils.SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    const tx = await titleEscrowContract.transferBeneficiary(
+      newBeneficiaryAddress,
+      encryptedRemarks,
+      txOptions
+    );
+    return tx;
+  } else if (isV4TT) {
+    const tx = await titleEscrowContract.transferBeneficiary(
+      newBeneficiaryAddress,
+      txOptions
+    );
+    return tx;
+  }
+}, "transferBeneficiary");
+const transferOwners = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await core.getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, newHolderAddress, remarks } = params;
+  let titleEscrowContract = tokenRegistryV5.v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${core.encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (!isV5TT) {
+    titleEscrowContract = tokenRegistryV4.v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferOwners(
+        newBeneficiaryAddress,
+        newHolderAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferOwners(
+        newBeneficiaryAddress,
+        newHolderAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferOwners failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = tradetrustUtils.SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.transferOwners(
+      newBeneficiaryAddress,
+      newHolderAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.transferOwners(
+      newBeneficiaryAddress,
+      newHolderAddress,
+      txOptions
+    );
+  }
+}, "transferOwners");
+const nominate = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await core.getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, remarks } = params;
+  let titleEscrowContract = tokenRegistryV5.v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${core.encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      core.isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: core.TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV5TT) {
+    titleEscrowContract = tokenRegistryV4.v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.nominate(
+        newBeneficiaryAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.nominate(
+        newBeneficiaryAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for nominate failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = tradetrustUtils.SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.nominate(
+      newBeneficiaryAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.nominate(
+      newBeneficiaryAddress,
+      txOptions
+    );
+  }
+}, "nominate");
+
+exports.nominate = nominate;
+exports.transferBeneficiary = transferBeneficiary;
+exports.transferHolder = transferHolder;
+exports.transferOwners = transferOwners;

package/dist/esm/index.js

@@ -1,5 +1,6 @@
 export { v4ComputeInterfaceId, v4ComputeTitleEscrowAddress, v4ContractAddress, v4Contracts, v4EncodeInitParams, v4GetEventFromReceipt, v4RoleHash, v4SupportInterfaceIds, v4Utils } from './token-registry-v4';
 export { v5ComputeInterfaceId, v5ContractAddress, v5Contracts, v5EncodeInitParams, v5GetEventFromReceipt, v5RoleHash, v5SupportInterfaceIds, v5Utils } from './token-registry-v5';
+export * from './token-registry-functions';
 export * from './core';
 export * from './open-attestation';
 export * from './verify';

package/dist/esm/token-registry-functions/index.js

@@ -0,0 +1 @@
+export * from './transfer';

package/dist/esm/token-registry-functions/transfer.js

@@ -0,0 +1,342 @@
+import { SUPPORTED_CHAINS } from '@tradetrust-tt/tradetrust-utils';
+import { getTitleEscrowAddress, encrypt, isTitleEscrowVersion, TitleEscrowInterface } from 'src/core';
+import { v4Contracts } from 'src/token-registry-v4';
+import { v5Contracts } from 'src/token-registry-v5';
+import { isV6EthersProvider } from 'src/utils/ethers';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const getChainIdSafe = /* @__PURE__ */ __name(async (signer) => {
+  if (isV6EthersProvider(signer.provider)) {
+    const network = await signer.provider?.getNetwork();
+    if (!network?.chainId) throw new Error("Cannot determine chainId: provider is missing");
+    return network.chainId;
+  }
+  return await signer.getChainId();
+}, "getChainIdSafe");
+const transferHolder = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenRegistryAddress, tokenId } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { holderAddress, remarks } = params;
+  let titleEscrowContract = v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (isV4TT) {
+    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferHolder(
+        holderAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferHolder(
+        holderAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferHolder failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.transferHolder(
+      holderAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.transferHolder(holderAddress, txOptions);
+  }
+}, "transferHolder");
+const transferBeneficiary = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, remarks } = params;
+  let titleEscrowContract = v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (!isV5TT) {
+    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferBeneficiary(
+        newBeneficiaryAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferBeneficiary(
+        newBeneficiaryAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferBeneficiary failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    const tx = await titleEscrowContract.transferBeneficiary(
+      newBeneficiaryAddress,
+      encryptedRemarks,
+      txOptions
+    );
+    return tx;
+  } else if (isV4TT) {
+    const tx = await titleEscrowContract.transferBeneficiary(
+      newBeneficiaryAddress,
+      txOptions
+    );
+    return tx;
+  }
+}, "transferBeneficiary");
+const transferOwners = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, newHolderAddress, remarks } = params;
+  let titleEscrowContract = v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV4TT && !isV5TT) {
+    throw new Error("Only Token Registry V4/V5 is supported");
+  }
+  if (!isV5TT) {
+    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.transferOwners(
+        newBeneficiaryAddress,
+        newHolderAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.transferOwners(
+        newBeneficiaryAddress,
+        newHolderAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for transferOwners failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.transferOwners(
+      newBeneficiaryAddress,
+      newHolderAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.transferOwners(
+      newBeneficiaryAddress,
+      newHolderAddress,
+      txOptions
+    );
+  }
+}, "transferOwners");
+const nominate = /* @__PURE__ */ __name(async (contractOptions, signer, params, options) => {
+  const { tokenId, tokenRegistryAddress } = contractOptions;
+  const { titleEscrowVersion } = options;
+  let { titleEscrowAddress } = contractOptions;
+  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  let isV5TT = titleEscrowVersion === "v5";
+  let isV4TT = titleEscrowVersion === "v4";
+  if (!titleEscrowAddress) {
+    titleEscrowAddress = await getTitleEscrowAddress(
+      tokenRegistryAddress,
+      tokenId,
+      signer.provider,
+      { titleEscrowVersion }
+    );
+  }
+  if (!titleEscrowAddress) throw new Error("Token registry address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  const { newBeneficiaryAddress, remarks } = params;
+  let titleEscrowContract = v5Contracts.TitleEscrow__factory.connect(titleEscrowAddress, signer);
+  const encryptedRemarks = remarks ? `0x${encrypt(remarks, options.id)}` : "0x";
+  if (titleEscrowVersion === void 0) {
+    [isV4TT, isV5TT] = await Promise.all([
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V4,
+        provider: signer.provider
+      }),
+      isTitleEscrowVersion({
+        titleEscrowAddress,
+        versionInterface: TitleEscrowInterface.V5,
+        provider: signer.provider
+      })
+    ]);
+  }
+  if (!isV5TT) {
+    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+      titleEscrowAddress,
+      signer
+    );
+  }
+  try {
+    if (isV5TT) {
+      await titleEscrowContract.callStatic.nominate(
+        newBeneficiaryAddress,
+        encryptedRemarks
+      );
+    } else if (isV4TT) {
+      await titleEscrowContract.callStatic.nominate(
+        newBeneficiaryAddress
+      );
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for nominate failed");
+  }
+  if (!maxFeePerGas || !maxPriorityFeePerGas) {
+    chainId = chainId ?? await getChainIdSafe(signer);
+    const gasStation = SUPPORTED_CHAINS[chainId]?.gasStation;
+    if (gasStation) {
+      const gasFees = await gasStation();
+      maxFeePerGas = gasFees?.maxFeePerGas ?? 0;
+      maxPriorityFeePerGas = gasFees?.maxPriorityFeePerGas ?? 0;
+    }
+  }
+  const txOptions = maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : void 0;
+  if (isV5TT) {
+    return await titleEscrowContract.nominate(
+      newBeneficiaryAddress,
+      encryptedRemarks,
+      txOptions
+    );
+  } else if (isV4TT) {
+    return await titleEscrowContract.nominate(
+      newBeneficiaryAddress,
+      txOptions
+    );
+  }
+}, "nominate");
+
+export { nominate, transferBeneficiary, transferHolder, transferOwners };

package/dist/types/index.d.ts

@@ -10,6 +10,7 @@ export { supportInterfaceIds as v5SupportInterfaceIds } from './token-registry-v
 export { c as v5Contracts } from './contracts-BaIGKzNt.js';
 export { computeInterfaceId as v5ComputeInterfaceId, encodeInitParams as v5EncodeInitParams, getEventFromReceipt as v5GetEventFromReceipt } from './token-registry-v5/utils.js';
 export { TypedContractMethod } from '@tradetrust-tt/token-registry-v5/contracts/common';
+export { nominate, transferBeneficiary, transferHolder, transferOwners } from './token-registry-functions/transfer.js';
 export { decrypt } from './core/decrypt.js';
 export { encrypt } from './core/encrypt.js';
 export { verifyDocument } from './core/verify.js';

package/dist/types/token-registry-functions/index.d.ts

@@ -0,0 +1,4 @@
+export { nominate, transferBeneficiary, transferHolder, transferOwners } from './transfer.js';
+import '@tradetrust-tt/tradetrust-utils';
+import 'ethersV6';
+import 'ethers';

package/dist/types/token-registry-functions/transfer.d.ts

@@ -0,0 +1,43 @@
+import { CHAIN_ID } from '@tradetrust-tt/tradetrust-utils';
+import { Signer as Signer$1, BigNumberish } from 'ethersV6';
+import { Signer, BigNumber } from 'ethers';
+
+interface TransferHolderParams {
+    holderAddress: string;
+    remarks?: string;
+}
+interface TransferBeneficiaryParams {
+    newBeneficiaryAddress: string;
+    remarks?: string;
+}
+interface NominateParams {
+    newBeneficiaryAddress: string;
+    remarks?: string;
+}
+interface TransferOwnersParams {
+    newHolderAddress: string;
+    newBeneficiaryAddress: string;
+    remarks?: string;
+}
+interface TransferOptions {
+    chainId?: CHAIN_ID;
+    titleEscrowVersion?: 'v4' | 'v5';
+    maxFeePerGas?: BigNumberish | string | number | BigNumber;
+    maxPriorityFeePerGas?: BigNumberish | string | number | BigNumber;
+    id?: string;
+}
+type ContractOptions = {
+    titleEscrowAddress: string;
+    tokenId?: string | number;
+    tokenRegistryAddress?: string;
+} | {
+    titleEscrowAddress?: undefined;
+    tokenId: string | number;
+    tokenRegistryAddress: string;
+};
+declare const transferHolder: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: TransferHolderParams, options: TransferOptions) => Promise<ContractTransactionResponse>;
+declare const transferBeneficiary: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: TransferBeneficiaryParams, options: TransferOptions) => Promise<any>;
+declare const transferOwners: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: TransferOwnersParams, options: TransferOptions) => Promise<any>;
+declare const nominate: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: NominateParams, options: TransferOptions) => Promise<any>;
+
+export { nominate, transferBeneficiary, transferHolder, transferOwners };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustvc/trustvc",
-  "version": "1.5.4",
+  "version": "1.6.0-alpha.1",
   "description": "TrustVC library",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -111,18 +111,18 @@
   },
   "dependencies": {
     "@tradetrust-tt/dnsprove": "^2.17.0",
-    "@tradetrust-tt/ethers-aws-kms-signer": "^2.1.3",
+    "@tradetrust-tt/ethers-aws-kms-signer": "^2.1.4",
     "@tradetrust-tt/token-registry-v4": "npm:@tradetrust-tt/token-registry@^4.16.0",
     "@tradetrust-tt/token-registry-v5": "npm:@tradetrust-tt/token-registry@^5.3.0",
     "@tradetrust-tt/tradetrust": "^6.10.1",
     "@tradetrust-tt/tradetrust-utils": "^2.3.2",
     "@tradetrust-tt/tt-verify": "^9.4.0",
     "@trustvc/w3c-context": "^1.2.13",
-    "@trustvc/w3c-credential-status": "^1.2.12",
-    "@trustvc/w3c-issuer": "^1.2.3",
+    "@trustvc/w3c-credential-status": "^1.2.13",
+    "@trustvc/w3c-issuer": "^1.2.4",
     "@trustvc/w3c-vc": "^1.2.17",
     "ethers": "^5.8.0",
-    "ethersV6": "npm:ethers@^6.14.3",
+    "ethersV6": "npm:ethers@^6.14.4",
     "js-sha3": "^0.9.3",
     "ts-chacha20": "^1.2.0"
   },