@trustvc/trustvc 1.6.0-alpha.1 → 1.6.0-alpha.3

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

@@ -1,27 +1,21 @@
-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';
+import { getTitleEscrowAddress, encrypt, isTitleEscrowVersion, TitleEscrowInterface } from '../core';
+import { v4Contracts } from '../token-registry-v4';
+import { v5Contracts } from '../token-registry-v5';
+import { getTxOptions } from './utils';
+import { getEthersContractFromProvider, isV6EthersProvider } from '../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;
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
   let isV5TT = titleEscrowVersion === "v5";
   let isV4TT = titleEscrowVersion === "v4";
   if (!titleEscrowAddress) {
+    if (!tokenRegistryAddress) throw new Error("Token registry address is required");
+    if (!tokenId) throw new Error("Token ID is required");
     titleEscrowAddress = await getTitleEscrowAddress(
       tokenRegistryAddress,
       tokenId,
@@ -32,7 +26,6 @@ const transferHolder = /* @__PURE__ */ __name(async (contractOptions, signer, pa
   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([
@@ -51,43 +44,38 @@ const transferHolder = /* @__PURE__ */ __name(async (contractOptions, signer, pa
   if (!isV4TT && !isV5TT) {
     throw new Error("Only Token Registry V4/V5 is supported");
   }
-  if (isV4TT) {
-    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let titleEscrowContract;
+  if (isV5TT) {
+    titleEscrowContract = new Contract(
+      titleEscrowAddress,
+      v5Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+    );
+  } else if (isV4TT) {
+    titleEscrowContract = new Contract(
       titleEscrowAddress,
+      v4Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   }
   try {
-    if (isV5TT) {
-      await titleEscrowContract.callStatic.transferHolder(
-        holderAddress,
-        encryptedRemarks
-      );
-    } else if (isV4TT) {
-      await titleEscrowContract.callStatic.transferHolder(
-        holderAddress
-      );
+    const isV6 = isV6EthersProvider(signer.provider);
+    const args = isV5TT ? [holderAddress, encryptedRemarks] : [holderAddress];
+    if (isV6) {
+      await titleEscrowContract.transferHolder.staticCall(...args);
+    } else {
+      await titleEscrowContract.callStatic.transferHolder(...args);
     }
   } 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;
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
   if (isV5TT) {
-    return await titleEscrowContract.transferHolder(
-      holderAddress,
-      encryptedRemarks,
-      txOptions
-    );
+    return await titleEscrowContract.transferHolder(holderAddress, encryptedRemarks, txOptions);
   } else if (isV4TT) {
     return await titleEscrowContract.transferHolder(holderAddress, txOptions);
   }
@@ -96,7 +84,7 @@ const transferBeneficiary = /* @__PURE__ */ __name(async (contractOptions, signe
   const { tokenId, tokenRegistryAddress } = contractOptions;
   const { titleEscrowVersion } = options;
   let { titleEscrowAddress } = contractOptions;
-  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
   let isV5TT = titleEscrowVersion === "v5";
   let isV4TT = titleEscrowVersion === "v4";
   if (!titleEscrowAddress) {
@@ -110,7 +98,6 @@ const transferBeneficiary = /* @__PURE__ */ __name(async (contractOptions, signe
   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([
@@ -129,57 +116,51 @@ const transferBeneficiary = /* @__PURE__ */ __name(async (contractOptions, signe
   if (!isV4TT && !isV5TT) {
     throw new Error("Only Token Registry V4/V5 is supported");
   }
-  if (!isV5TT) {
-    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let titleEscrowContract;
+  if (isV5TT) {
+    titleEscrowContract = new Contract(
+      titleEscrowAddress,
+      v5Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+    );
+  } else if (isV4TT) {
+    titleEscrowContract = new Contract(
       titleEscrowAddress,
+      v4Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   }
   try {
-    if (isV5TT) {
-      await titleEscrowContract.callStatic.transferBeneficiary(
-        newBeneficiaryAddress,
-        encryptedRemarks
-      );
-    } else if (isV4TT) {
-      await titleEscrowContract.callStatic.transferBeneficiary(
-        newBeneficiaryAddress
-      );
+    const isV6 = isV6EthersProvider(signer.provider);
+    const args = isV5TT ? [newBeneficiaryAddress, encryptedRemarks] : [newBeneficiaryAddress];
+    if (isV6) {
+      await titleEscrowContract.transferBeneficiary.staticCall(...args);
+    } else {
+      await titleEscrowContract.callStatic.transferBeneficiary(...args);
     }
   } 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;
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
   if (isV5TT) {
-    const tx = await titleEscrowContract.transferBeneficiary(
+    return await titleEscrowContract.transferBeneficiary(
       newBeneficiaryAddress,
       encryptedRemarks,
       txOptions
     );
-    return tx;
   } else if (isV4TT) {
-    const tx = await titleEscrowContract.transferBeneficiary(
-      newBeneficiaryAddress,
-      txOptions
-    );
-    return tx;
+    return await titleEscrowContract.transferBeneficiary(newBeneficiaryAddress, txOptions);
   }
 }, "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;
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
   let isV5TT = titleEscrowVersion === "v5";
   let isV4TT = titleEscrowVersion === "v4";
   if (!titleEscrowAddress) {
@@ -193,7 +174,6 @@ const transferOwners = /* @__PURE__ */ __name(async (contractOptions, signer, pa
   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([
@@ -212,39 +192,36 @@ const transferOwners = /* @__PURE__ */ __name(async (contractOptions, signer, pa
   if (!isV4TT && !isV5TT) {
     throw new Error("Only Token Registry V4/V5 is supported");
   }
-  if (!isV5TT) {
-    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let titleEscrowContract;
+  if (isV5TT) {
+    titleEscrowContract = new Contract(
+      titleEscrowAddress,
+      v5Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+    );
+  } else if (isV4TT) {
+    titleEscrowContract = new Contract(
       titleEscrowAddress,
+      v4Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   }
   try {
-    if (isV5TT) {
-      await titleEscrowContract.callStatic.transferOwners(
-        newBeneficiaryAddress,
-        newHolderAddress,
-        encryptedRemarks
-      );
-    } else if (isV4TT) {
-      await titleEscrowContract.callStatic.transferOwners(
-        newBeneficiaryAddress,
-        newHolderAddress
-      );
+    const isV6 = isV6EthersProvider(signer.provider);
+    const args = isV5TT ? [newBeneficiaryAddress, newHolderAddress, encryptedRemarks] : [newBeneficiaryAddress, newHolderAddress];
+    if (isV6) {
+      await titleEscrowContract.transferOwners.staticCall(...args);
+    } else {
+      await titleEscrowContract.callStatic.transferOwners(...args);
     }
   } 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;
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
   if (isV5TT) {
     return await titleEscrowContract.transferOwners(
       newBeneficiaryAddress,
@@ -264,7 +241,7 @@ const nominate = /* @__PURE__ */ __name(async (contractOptions, signer, params,
   const { tokenId, tokenRegistryAddress } = contractOptions;
   const { titleEscrowVersion } = options;
   let { titleEscrowAddress } = contractOptions;
-  let { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas } = options;
   let isV5TT = titleEscrowVersion === "v5";
   let isV4TT = titleEscrowVersion === "v4";
   if (!titleEscrowAddress) {
@@ -278,7 +255,6 @@ const nominate = /* @__PURE__ */ __name(async (contractOptions, signer, params,
   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([
@@ -294,48 +270,40 @@ const nominate = /* @__PURE__ */ __name(async (contractOptions, signer, params,
       })
     ]);
   }
-  if (!isV5TT) {
-    titleEscrowContract = v4Contracts.TitleEscrow__factory.connect(
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let titleEscrowContract;
+  if (isV5TT) {
+    titleEscrowContract = new Contract(
       titleEscrowAddress,
+      v5Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+    );
+  } else if (isV4TT) {
+    titleEscrowContract = new Contract(
+      titleEscrowAddress,
+      v4Contracts.TitleEscrow__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   }
   try {
-    if (isV5TT) {
-      await titleEscrowContract.callStatic.nominate(
-        newBeneficiaryAddress,
-        encryptedRemarks
-      );
-    } else if (isV4TT) {
-      await titleEscrowContract.callStatic.nominate(
-        newBeneficiaryAddress
-      );
+    const isV6 = isV6EthersProvider(signer.provider);
+    const args = isV5TT ? [newBeneficiaryAddress, encryptedRemarks] : [newBeneficiaryAddress];
+    if (isV6) {
+      await titleEscrowContract.nominate.staticCall(...args);
+    } else {
+      await titleEscrowContract.callStatic.nominate(...args);
     }
   } 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;
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
   if (isV5TT) {
-    return await titleEscrowContract.nominate(
-      newBeneficiaryAddress,
-      encryptedRemarks,
-      txOptions
-    );
+    return await titleEscrowContract.nominate(newBeneficiaryAddress, encryptedRemarks, txOptions);
   } else if (isV4TT) {
-    return await titleEscrowContract.nominate(
-      newBeneficiaryAddress,
-      txOptions
-    );
+    return await titleEscrowContract.nominate(newBeneficiaryAddress, txOptions);
   }
 }, "nominate");
 

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,33 @@
+import { isV6EthersProvider } from '../utils/ethers';
+import { SUPPORTED_CHAINS } from '@tradetrust-tt/tradetrust-utils';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const getTxOptions = /* @__PURE__ */ __name(async (signer, chainId, maxFeePerGas, maxPriorityFeePerGas) => {
+  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;
+    }
+  }
+  return maxFeePerGas && maxPriorityFeePerGas ? { maxFeePerGas, maxPriorityFeePerGas } : {};
+}, "getTxOptions");
+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 getSignerAddressSafe = /* @__PURE__ */ __name(async (signer) => {
+  if (isV6EthersProvider(signer.provider)) {
+    return await signer.getAddress();
+  }
+  return await signer.getAddress();
+}, "getSignerAddressSafe");
+
+export { getChainIdSafe, getSignerAddressSafe, getTxOptions };

package/dist/types/core/endorsement-chain/index.d.ts

@@ -3,7 +3,7 @@ export { fetchTokenTransfers } from './fetchTokenTransfer.js';
 export { fetchEventTime, mergeTransfersV4, mergeTransfersV5, sortLogChain } from './helpers.js';
 export { getEndorsementChain } from './retrieveEndorsementChain.js';
 export { EndorsementChain, ParsedLog, TitleEscrowTransferEvent, TitleEscrowTransferEventType, TokenTransferEvent, TokenTransferEventType, TradeTrustTokenEventType, TransferBaseEvent, TransferEvent, TransferEventType, TypedEvent } from './types.js';
-export { TitleEscrowInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './useEndorsementChain.js';
+export { TitleEscrowInterface, checkSupportsInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './useEndorsementChain.js';
 import 'ethersV6';
 import '@ethersproject/abstract-provider';
 import 'ethers';

package/dist/types/core/endorsement-chain/useEndorsementChain.d.ts

@@ -12,6 +12,7 @@ declare const getTitleEscrowAddress: (tokenRegistryAddress: string, tokenId: str
     titleEscrowVersion?: "v4" | "v5";
 }) => Promise<string>;
 declare const getDocumentOwner: (tokenRegistryAddress: string, tokenId: string, provider: Provider | ethers.Provider) => Promise<string>;
+declare const checkSupportsInterface: (contractAddress: string, interfaceId: string, provider: Provider | ethers.Provider) => Promise<boolean>;
 interface TitleEscrowVersionParams {
     tokenRegistryAddress?: string;
     tokenId?: string;
@@ -27,4 +28,4 @@ interface TitleEscrowVersionParams {
 declare const isTitleEscrowVersion: ({ tokenRegistryAddress, tokenId, titleEscrowAddress, versionInterface, provider, }: TitleEscrowVersionParams) => Promise<boolean>;
 declare const fetchEndorsementChain: (tokenRegistryAddress: string, tokenId: string, provider: Provider | ethers.Provider, keyId?: string) => Promise<EndorsementChain>;
 
-export { TitleEscrowInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion };
+export { TitleEscrowInterface, checkSupportsInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion };

package/dist/types/core/index.d.ts

@@ -6,7 +6,7 @@ export { fetchTokenTransfers } from './endorsement-chain/fetchTokenTransfer.js';
 export { fetchEventTime, mergeTransfersV4, mergeTransfersV5, sortLogChain } from './endorsement-chain/helpers.js';
 export { getEndorsementChain } from './endorsement-chain/retrieveEndorsementChain.js';
 export { EndorsementChain, ParsedLog, TitleEscrowTransferEvent, TitleEscrowTransferEventType, TokenTransferEvent, TokenTransferEventType, TradeTrustTokenEventType, TransferBaseEvent, TransferEvent, TransferEventType, TypedEvent } from './endorsement-chain/types.js';
-export { TitleEscrowInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './endorsement-chain/useEndorsementChain.js';
+export { TitleEscrowInterface, checkSupportsInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './endorsement-chain/useEndorsementChain.js';
 export { DocumentBuilder, RenderMethod, W3CTransferableRecordsConfig, W3CVerifiableDocumentConfig, qrCode } from './documentBuilder.js';
 import '@trustvc/w3c-vc';
 import 'ethers';

package/dist/types/index.d.ts

@@ -11,6 +11,10 @@ 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 { rejectTransferBeneficiary, rejectTransferHolder, rejectTransferOwners } from './token-registry-functions/rejectTransfers.js';
+export { acceptReturned, rejectReturned, returnToIssuer } from './token-registry-functions/returnToken.js';
+export { mint } from './token-registry-functions/mint.js';
+export { ownerOf } from './token-registry-functions/ownerOf.js';
 export { decrypt } from './core/decrypt.js';
 export { encrypt } from './core/encrypt.js';
 export { verifyDocument } from './core/verify.js';
@@ -19,7 +23,7 @@ export { fetchTokenTransfers } from './core/endorsement-chain/fetchTokenTransfer
 export { fetchEventTime, mergeTransfersV4, mergeTransfersV5, sortLogChain } from './core/endorsement-chain/helpers.js';
 export { getEndorsementChain } from './core/endorsement-chain/retrieveEndorsementChain.js';
 export { EndorsementChain, ParsedLog, TitleEscrowTransferEvent, TitleEscrowTransferEventType, TokenTransferEvent, TokenTransferEventType, TradeTrustTokenEventType, TransferBaseEvent, TransferEvent, TransferEventType, TypedEvent } from './core/endorsement-chain/types.js';
-export { TitleEscrowInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './core/endorsement-chain/useEndorsementChain.js';
+export { TitleEscrowInterface, checkSupportsInterface, fetchEndorsementChain, getDocumentOwner, getTitleEscrowAddress, isTitleEscrowVersion } from './core/endorsement-chain/useEndorsementChain.js';
 export { DocumentBuilder, RenderMethod, W3CTransferableRecordsConfig, W3CVerifiableDocumentConfig, qrCode } from './core/documentBuilder.js';
 export { signOA } from './open-attestation/sign.js';
 export { KeyPair } from './open-attestation/types.js';
@@ -54,6 +58,7 @@ import '@typechain/ethers-v5/static/common';
 import '@tradetrust-tt/token-registry-v5/contracts';
 import '@tradetrust-tt/token-registry-v5';
 import 'ethersV6';
+import './token-registry-functions/types.js';
 import '@ethersproject/abstract-provider';
 import 'ethers/lib/utils';
 import '@ethersproject/abstract-signer';

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

@@ -1,4 +1,9 @@
 export { nominate, transferBeneficiary, transferHolder, transferOwners } from './transfer.js';
-import '@tradetrust-tt/tradetrust-utils';
+export { rejectTransferBeneficiary, rejectTransferHolder, rejectTransferOwners } from './rejectTransfers.js';
+export { acceptReturned, rejectReturned, returnToIssuer } from './returnToken.js';
+export { mint } from './mint.js';
+export { ownerOf } from './ownerOf.js';
 import 'ethersV6';
 import 'ethers';
+import './types.js';
+import '@tradetrust-tt/tradetrust-utils';

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

@@ -0,0 +1,20 @@
+import { Signer as Signer$1 } from 'ethersV6';
+import { Signer, ContractTransaction } from 'ethers';
+import { MintTokenOptions, MintTokenParams, TransactionOptions } from './types.js';
+import '@tradetrust-tt/tradetrust-utils';
+
+/**
+ * Mints a new token into the TradeTrustToken registry with the specified beneficiary and holder.
+ * Supports both Token Registry V4 and V5 contracts.
+ * @param {MintTokenOptions} contractOptions - Contains the `tokenRegistryAddress` for the minting contract.
+ * @param {Signer | SignerV6} signer - Signer instance (Ethers v5 or v6) that authorizes the mint transaction.
+ * @param {MintTokenParams} params - Parameters for minting, including `beneficiaryAddress`, `holderAddress`, `tokenId`, and optional `remarks`.
+ * @param {TransactionOptions} options - Transaction metadata including gas values, version detection, chain ID, and optional encryption ID.
+ * @returns {Promise<ContractTransaction>} A promise resolving to the transaction result from the mint call.
+ * @throws {Error} If the token registry address or signer provider is not provided.
+ * @throws {Error} If neither V4 nor V5 interfaces are supported.
+ * @throws {Error} If the `callStatic.mint` fails as a pre-check.
+ */
+declare const mint: (contractOptions: MintTokenOptions, signer: Signer | Signer$1, params: MintTokenParams, options: TransactionOptions) => Promise<ContractTransaction>;
+
+export { mint };

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

@@ -0,0 +1,19 @@
+import { Signer as Signer$1 } from 'ethersV6';
+import { Signer } from 'ethers';
+import { OwnerOfTokenOptions, OwnerOfTokenParams, TransactionOptions } from './types.js';
+import '@tradetrust-tt/tradetrust-utils';
+
+/**
+ * Retrieves the owner of a given token from the TradeTrustToken contract.
+ * Supports both Token Registry V4 and V5 implementations.
+ * @param {OwnerOfTokenOptions} contractOptions - Options containing the token registry address.
+ * @param {Signer | SignerV6} signer - Signer instance (v5 or v6) used to query the blockchain.
+ * @param {OwnerOfTokenParams} params - Contains the `tokenId` of the token to query ownership for.
+ * @param {TransactionOptions} options - Includes the `titleEscrowVersion` and other optional metadata for interface detection.
+ * @returns {Promise<string>} A promise that resolves to the owner address of the specified token.
+ * @throws {Error} If token registry address or signer provider is not provided.
+ * @throws {Error} If the token registry does not support V4 or V5 interfaces.
+ */
+declare const ownerOf: (contractOptions: OwnerOfTokenOptions, signer: Signer | Signer$1, params: OwnerOfTokenParams, options: TransactionOptions) => Promise<string>;
+
+export { ownerOf };

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

@@ -0,0 +1,43 @@
+import { Signer as Signer$1 } from 'ethersV6';
+import { Signer, ContractTransaction } from 'ethers';
+import { ContractOptions, RejectTransferParams, TransactionOptions } from './types.js';
+import '@tradetrust-tt/tradetrust-utils';
+
+/**
+ * Rejects the transfer of holder for a title escrow contract.
+ * @param {ContractOptions} contractOptions - Contract-related options including the token registry address, and optionally, token ID and the title escrow address.
+ * @param {Signer | SignerV6} signer - Ethers signer (V5 or V6) used to sign and send the transaction.
+ * @param {RejectTransferParams} params - Contains the `remarks` field which is an optional string that will be encrypted and sent with the transaction.
+ * @param {TransactionOptions} options - Transfer options including optional `chainId`, `titleEscrowVersion`,  `maxFeePerGas`, `maxPriorityFeePerGas`, and an `id` used for encryption.
+ * @throws error if the title escrow address or signer provider is missing.
+ * @throws if the version is not V5 compatible.
+ * @throws if the dry-run (`callStatic`) fails.
+ * @returns {Promise<ContractTransaction>} The transaction response of the rejectTransferHolder call.
+ */
+declare const rejectTransferHolder: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: RejectTransferParams, options: TransactionOptions) => Promise<ContractTransaction>;
+/**
+ * Rejects the transfer of beneficiary for a title escrow contract.
+ * @param {ContractOptions} contractOptions - Contract-related options including the token registry address, and optionally, token ID and the title escrow address.
+ * @param {Signer | SignerV6} signer - Ethers signer (V5 or V6) used to sign and send the transaction.
+ * @param {RejectTransferParams} params - Contains the `remarks` field which is an optional string that will be encrypted and sent with the transaction.
+ * @param {TransactionOptions} options - Transfer options including optional `chainId`, `titleEscrowVersion`,  `maxFeePerGas`, `maxPriorityFeePerGas`, and an `id` used for encryption.
+ * @throws error if the title escrow address or signer provider is missing.
+ * @throws error if the version is not V5 compatible.
+ * @throws error if the dry-run (`callStatic`) fails.
+ * @returns {Promise<ContractTransaction>} The transaction response of the rejectTransferBeneficiary call.
+ */
+declare const rejectTransferBeneficiary: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: RejectTransferParams, options: TransactionOptions) => Promise<ContractTransaction>;
+/**
+ * Rejects the transfer of ownership for a title escrow contract.
+ * @param {ContractOptions} contractOptions - Contract-related options including the token registry address, and optionally, token ID and the title escrow address.
+ * @param {Signer | SignerV6} signer - Ethers signer (V5 or V6) used to sign and send the transaction.
+ * @param {RejectTransferParams} params - Contains the `remarks` field which is an optional string that will be encrypted and sent with the transaction.
+ * @param {TransactionOptions} options - Transfer options including optional `chainId`, `titleEscrowVersion`,  `maxFeePerGas`, `maxPriorityFeePerGas`, and an `id` used for encryption.
+ * @throws error if the title escrow address or signer provider is missing.
+ * @throws an error if the version is not V5 compatible.
+ * @throws an error if the dry-run (`callStatic`) fails.
+ * @returns {Promise<ContractTransaction>} The transaction response of the rejectTransferOwners call.
+ */
+declare const rejectTransferOwners: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: RejectTransferParams, options: TransactionOptions) => Promise<ContractTransaction>;
+
+export { rejectTransferBeneficiary, rejectTransferHolder, rejectTransferOwners };

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

@@ -0,0 +1,44 @@
+import { Signer as Signer$1 } from 'ethersV6';
+import { Signer, ContractTransaction } from 'ethers';
+import { ContractOptions, ReturnToIssuerParams, TransactionOptions, RejectReturnedOptions, AcceptReturnedParams, AcceptReturnedOptions, RejectReturnedParams } from './types.js';
+import '@tradetrust-tt/tradetrust-utils';
+
+/**
+ * Returns the token to the original issuer from the Title Escrow contract.
+ * @param {ContractOptions} contractOptions - Options including token ID, registry address, and optionally title escrow address.
+ * @param {Signer | SignerV6} signer - Signer instance (Ethers v5 or v6) that will execute the transaction.
+ * @param {ReturnToIssuerParams} params - Contains optional remarks to be encrypted and attached to the transaction.
+ * @param {TransactionOptions} options - Transaction settings including gas fees, escrow version, chain ID, and optional encryption ID.
+ * @returns {Promise<ContractTransaction>} Promise that resolves to the transaction response from the `returnToIssuer` function.
+ * @throws {Error} If title escrow address or provider is not provided or if version is unsupported.
+ * @throws {Error} If the `callStatic.returnToIssuer` fails as a pre-check.
+ */
+declare const returnToIssuer: (contractOptions: ContractOptions, signer: Signer | Signer$1, params: ReturnToIssuerParams, options: TransactionOptions) => Promise<ContractTransaction>;
+/**
+ * Rejects a previously returned token by restoring it back to the token registry.
+ * This is only supported on Token Registry V5 contracts with the `restore` functionality.
+ * @param {AcceptReturnedOptions} contractOptions - Contains the `tokenRegistryAddress` used to locate the TradeTrustToken contract.
+ * @param {Signer | SignerV6} signer - Signer instance (v5 or v6) used to authorize the transaction.
+ * @param {AcceptReturnedParams} params - Includes the `tokenId` to restore and optional `remarks` to encrypt.
+ * @param {TransactionOptions} options - Configuration for the transaction including version, gas fees, and optional `id` used for encryption.
+ * @returns {Promise<ContractTransaction>} A promise that resolves to the transaction result of the `restore` call.
+ * @throws {Error} If the token registry address or provider is missing.
+ * @throws {Error} If the token registry version is unsupported.
+ * @throws {Error} If the callStatic pre-check fails.
+ */
+declare const rejectReturned: (contractOptions: AcceptReturnedOptions, signer: Signer | Signer$1, params: RejectReturnedParams, options: TransactionOptions) => Promise<ContractTransaction>;
+/**
+ * Accepts the returned token by burning it from the TradeTrustToken contract.
+ * Only supported on Token Registry V5 contracts that implement the burnable interface.
+ * @param {RejectReturnedOptions} contractOptions - Contains the `tokenRegistryAddress` from which the token will be burned.
+ * @param {Signer | SignerV6} signer - Signer instance (v5 or v6) used to authorize and send the burn transaction.
+ * @param {AcceptReturnedParams} params - Includes the `tokenId` to burn and optional `remarks` for audit trail.
+ * @param {TransactionOptions} options - Transaction settings including chain ID, gas fee values, escrow version, and encryption ID for remarks.
+ * @returns {Promise<ContractTransaction>} A promise resolving to the transaction result of the burn call.
+ * @throws {Error} If token registry address or signer provider is not provided.
+ * @throws {Error} If the contract does not support Token Registry V5.
+ * @throws {Error} If `callStatic.burn` fails as a pre-check.
+ */
+declare const acceptReturned: (contractOptions: RejectReturnedOptions, signer: Signer | Signer$1, params: AcceptReturnedParams, options: TransactionOptions) => Promise<ContractTransaction>;
+
+export { acceptReturned, rejectReturned, returnToIssuer };