@trustvc/trustvc 2.8.0 → 2.9.1

package/dist/esm/document-store/transferOwnership.js

@@ -1,6 +1,11 @@
 import { documentStoreRevokeRole } from './revoke-role';
 import { documentStoreGrantRole } from './grant-role';
 import { getRoleString } from './document-store-roles';
+import { checkSupportsInterface } from '../core';
+import { supportInterfaceIds } from './supportInterfaceIds';
+import { TT_DOCUMENT_STORE_ABI } from './tt-document-store-abi';
+import { getEthersContractFromProvider, isV6EthersProvider } from '../utils/ethers';
+import { TransferableDocumentStore__factory, DocumentStore__factory } from '@trustvc/document-store';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -9,29 +14,72 @@ const documentStoreTransferOwnership = /* @__PURE__ */ __name(async (documentSto
   if (!signer.provider) throw new Error("Provider is required");
   if (!account) throw new Error("Account is required");
   const ownerAddress = await signer.getAddress();
-  const roleString = await getRoleString(documentStoreAddress, "admin", {
+  const roleString = await getRoleString(documentStoreAddress, "DEFAULT_ADMIN_ROLE", {
     provider: signer.provider
   });
-  const grantTransaction = documentStoreGrantRole(
+  const Contract = getEthersContractFromProvider(signer.provider);
+  const isDocumentStore = await checkSupportsInterface(
+    documentStoreAddress,
+    supportInterfaceIds.IDocumentStore,
+    signer.provider
+  );
+  const isTransferableDocumentStore = await checkSupportsInterface(
+    documentStoreAddress,
+    supportInterfaceIds.ITransferableDocumentStore,
+    signer.provider
+  );
+  let documentStoreAbi;
+  if (isDocumentStore || isTransferableDocumentStore) {
+    const DocumentStoreFactory = isTransferableDocumentStore ? TransferableDocumentStore__factory : DocumentStore__factory;
+    documentStoreAbi = DocumentStoreFactory.abi;
+  } else {
+    documentStoreAbi = TT_DOCUMENT_STORE_ABI;
+  }
+  const documentStoreContract = new Contract(
+    documentStoreAddress,
+    documentStoreAbi,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    signer
+  );
+  const isV6 = isV6EthersProvider(signer.provider);
+  try {
+    if (isV6) {
+      await documentStoreContract.grantRole.staticCall(roleString, account);
+    } else {
+      await documentStoreContract.callStatic.grantRole(roleString, account);
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for grant-role failed");
+  }
+  try {
+    if (isV6) {
+      await documentStoreContract.revokeRole.staticCall(roleString, ownerAddress);
+    } else {
+      await documentStoreContract.callStatic.revokeRole(roleString, ownerAddress);
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for revoke-role failed");
+  }
+  const grantTransaction = await documentStoreGrantRole(
     documentStoreAddress,
     roleString,
     account,
     signer,
     options
   );
-  const grantTransactionResult = await grantTransaction;
-  if (!grantTransactionResult) {
+  if (!grantTransaction) {
     throw new Error("Grant transaction failed, not proceeding with revoke transaction");
   }
-  const revokeTransaction = documentStoreRevokeRole(
+  const revokeTransaction = await documentStoreRevokeRole(
     documentStoreAddress,
     roleString,
     ownerAddress,
     signer,
     options
   );
-  const revokeTransactionResult = await revokeTransaction;
-  if (!revokeTransactionResult) {
+  if (!revokeTransaction) {
     throw new Error("Revoke transaction failed");
   }
   return { grantTransaction, revokeTransaction };

package/dist/esm/index.js

@@ -1,6 +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 { DocumentStore__factory, TransferableDocumentStore__factory, deployDocumentStore, documentStoreGrantRole, documentStoreIssue, documentStoreRevoke, documentStoreRevokeRole } from './document-store';
+export { DocumentStore__factory, TransferableDocumentStore__factory, deployDocumentStore, documentStoreGrantRole, documentStoreIssue, documentStoreRevoke, documentStoreRevokeRole, documentStoreTransferOwnership, getRoleString } from './document-store';
 export * from './token-registry-functions';
 export * from './core';
 export * from './open-attestation';

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

@@ -3,3 +3,4 @@ export * from './rejectTransfers';
 export * from './returnToken';
 export * from './mint';
 export * from './ownerOf';
+export * from '../deploy/token-registry';

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

@@ -1,6 +1,7 @@
 import { checkSupportsInterface } from '../core';
 import { v5SupportInterfaceIds, v5Contracts } from '../token-registry-v5';
 import { v4SupportInterfaceIds, v4Contracts } from '../token-registry-v4';
+import { getEthersContractFromProvider } from '../utils/ethers';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -21,23 +22,24 @@ const ownerOf = /* @__PURE__ */ __name(async (contractOptions, signer, params, o
   if (!isV4TT && !isV5TT) {
     throw new Error("Only Token Registry V4/V5 is supported");
   }
+  const Contract = getEthersContractFromProvider(signer.provider);
   let tradeTrustTokenContract;
   if (isV5TT) {
-    tradeTrustTokenContract = v5Contracts.TradeTrustToken__factory.connect(
+    tradeTrustTokenContract = new Contract(
       tokenRegistryAddress,
+      v5Contracts.TradeTrustToken__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   } else if (isV4TT) {
-    tradeTrustTokenContract = v4Contracts.TradeTrustToken__factory.connect(
+    tradeTrustTokenContract = new Contract(
       tokenRegistryAddress,
+      v4Contracts.TradeTrustToken__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       signer
     );
   }
-  if (isV5TT) {
-    return await tradeTrustTokenContract.ownerOf(tokenId);
-  } else if (isV4TT) {
-    return await tradeTrustTokenContract.ownerOf(tokenId);
-  }
+  return await tradeTrustTokenContract.ownerOf(tokenId);
 }, "ownerOf");
 
 export { ownerOf };

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

@@ -1,5 +1,7 @@
-import { isV6EthersProvider } from '../utils/ethers';
+import { isV6EthersProvider, getEthersContractFromProvider } from '../utils/ethers';
 import { SUPPORTED_CHAINS } from '../utils';
+import { isAddress } from 'ethersV6';
+import { constants } from '../token-registry-v5';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -29,5 +31,39 @@ const getSignerAddressSafe = /* @__PURE__ */ __name(async (signer) => {
   }
   return await signer.getAddress();
 }, "getSignerAddressSafe");
+const { contractInterfaceId: CONTRACT_INTERFACE_ID, contractAddress: CONTRACT_ADDRESS } = constants;
+const getDefaultContractAddress = /* @__PURE__ */ __name((chainId) => {
+  const { TitleEscrowFactory, TokenImplementation, Deployer } = CONTRACT_ADDRESS;
+  const chainTitleEscrowFactory = TitleEscrowFactory[chainId];
+  const chainTokenImplementation = TokenImplementation[chainId];
+  const chainDeployer = Deployer[chainId];
+  return {
+    TitleEscrowFactory: chainTitleEscrowFactory,
+    TokenImplementation: chainTokenImplementation,
+    Deployer: chainDeployer
+  };
+}, "getDefaultContractAddress");
+const isValidAddress = /* @__PURE__ */ __name((address) => {
+  if (!address) return false;
+  return isAddress(address);
+}, "isValidAddress");
+const isSupportedTitleEscrowFactory = /* @__PURE__ */ __name(async (factoryAddress, provider) => {
+  const Contract = getEthersContractFromProvider(provider);
+  const titleEscrowFactoryContract = new Contract(
+    factoryAddress,
+    ["function implementation() view returns (address)"],
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    provider
+  );
+  const implAddr = await titleEscrowFactoryContract.implementation();
+  const implContract = new Contract(
+    implAddr,
+    ["function supportsInterface(bytes4 interfaceId) view returns (bool)"],
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    provider
+  );
+  const { TitleEscrow: titleEscrowInterfaceId } = CONTRACT_INTERFACE_ID;
+  return implContract.supportsInterface(titleEscrowInterfaceId);
+}, "isSupportedTitleEscrowFactory");
 
-export { getChainIdSafe, getSignerAddressSafe, getTxOptions };
+export { getChainIdSafe, getDefaultContractAddress, getSignerAddressSafe, getTxOptions, isSupportedTitleEscrowFactory, isValidAddress };

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

@@ -4,4 +4,4 @@ export { supportInterfaceIds as v5SupportInterfaceIds } from './supportInterface
 import * as contracts from './contracts';
 export { contracts as v5Contracts };
 export { computeInterfaceId as v5ComputeInterfaceId, encodeInitParams as v5EncodeInitParams, getEventFromReceipt as v5GetEventFromReceipt } from './utils';
-export { constants, utils, utils as v5Utils } from '@tradetrust-tt/token-registry-v4';
+export { constants, utils, utils as v5Utils } from '@tradetrust-tt/token-registry-v5';

package/dist/esm/utils/ethers/index.js

@@ -1,5 +1,5 @@
-import { ethers as ethers$1 } from 'ethers';
-import { ethers } from 'ethersV6';
+import { Contract, ContractFactory } from 'ethersV6';
+import { Contract as Contract$1, ContractFactory as ContractFactory$1 } from 'ethers';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -14,7 +14,10 @@ const isV6EthersProvider = /* @__PURE__ */ __name((provider) => {
   throw new Error("Unknown provider type");
 }, "isV6EthersProvider");
 const getEthersContractFromProvider = /* @__PURE__ */ __name((provider) => {
-  return isV6EthersProvider(provider) ? ethers.Contract : ethers$1.Contract;
+  return isV6EthersProvider(provider) ? Contract : Contract$1;
 }, "getEthersContractFromProvider");
+const getEthersContractFactoryFromProvider = /* @__PURE__ */ __name((provider) => {
+  return isV6EthersProvider(provider) ? ContractFactory : ContractFactory$1;
+}, "getEthersContractFactoryFromProvider");
 
-export { getEthersContractFromProvider, isV6EthersProvider };
+export { getEthersContractFactoryFromProvider, getEthersContractFromProvider, isV6EthersProvider };

package/dist/types/deploy/document-store.d.ts

@@ -0,0 +1,77 @@
+import { Signer as Signer$1, ContractTransactionReceipt } from 'ethersV6';
+import { Signer, ContractReceipt } from 'ethers';
+import { CHAIN_ID } from '../utils/supportedChains/index.js';
+import { GasValue } from '../token-registry-functions/types.js';
+import '../utils/gasStation/index.js';
+import '../utils/network/index.js';
+
+/**
+ * Document Store Deployment Module
+ *
+ * This module provides functionality to deploy TrustVC Document Store contracts
+ * with support for both ethers v5 and v6 signers. It supports two types of stores:
+ *
+ * 1. **Standard Document Store**: For issuing and revoking verifiable documents
+ *    - Immutable ownership (documents cannot be transferred)
+ *    - Suitable for most credential use cases
+ *
+ * 2. **Transferable Document Store**: For documents that can change ownership
+ *    - Supports ownership transfers between addresses
+ *    - Useful for transferable credentials or certificates
+ */
+
+/**
+ * Configuration options for Document Store deployment
+ */
+interface DeployOptions {
+    chainId?: CHAIN_ID;
+    maxFeePerGas?: GasValue;
+    maxPriorityFeePerGas?: GasValue;
+    isTransferable?: boolean;
+}
+/**
+ * Union type for transaction receipts from both ethers v5 and v6
+ */
+type TransactionReceipt = ContractReceipt | ContractTransactionReceipt;
+/**
+ * Deploys a new Document Store contract with automatic type selection.
+ * **Store Types:**
+ * - **Standard** (default): Documents are immutable and cannot be transferred
+ * - **Transferable**: Documents can be transferred to different owners
+ * **Ethers Compatibility:**
+ * - Automatically detects and handles both ethers v5 and v6 signers
+ * - Returns appropriate receipt type based on signer version
+ * @param {string} storeName - The name of the document store (e.g., "My University Credentials")
+ * @param {string} owner - The owner address that will control the document store
+ * @param {SignerV5 | SignerV6} signer - Signer instance that authorizes the deployment
+ * @param {DeployOptions} options - Configuration options for deployment
+ * @returns {Promise<TransactionReceipt>} Transaction receipt with deployed contract address
+ * @throws {Error} If store name is not provided
+ * @throws {Error} If owner address is not provided
+ * @throws {Error} If signer provider is not available
+ * @throws {Error} If deployment transaction fails
+ * @example
+ * ```typescript
+ *  Deploy standard document store
+ * const receipt = await deployDocumentStore(
+ *   "My Document Store",
+ *   "0x1234...",
+ *   signer,
+ *   { chainId: CHAIN_ID.SEPOLIA }
+ * );
+ *
+ *  Deploy transferable document store
+ * const receipt = await deployDocumentStore(
+ *   "My Transferable Store",
+ *   "0x1234...",
+ *   signer,
+ *   {
+ *     isTransferable: true,
+ *     maxFeePerGas: 50000000000n
+ *   }
+ * );
+ * ```
+ */
+declare const deployDocumentStore: (storeName: string, owner: string, signer: Signer | Signer$1, options?: DeployOptions) => Promise<TransactionReceipt>;
+
+export { type DeployOptions, type TransactionReceipt, deployDocumentStore };

package/dist/types/deploy/token-registry.d.ts

@@ -0,0 +1,82 @@
+import { GasValue } from '../token-registry-functions/types.js';
+import { CHAIN_ID } from '../utils/supportedChains/index.js';
+import { ContractReceipt, ContractTransaction as ContractTransaction$1, Signer } from 'ethers';
+import { ContractTransactionReceipt, ContractTransactionResponse, Signer as Signer$1 } from 'ethersV6';
+import '../utils/gasStation/index.js';
+import '../utils/network/index.js';
+
+/**
+ * Token Registry Deployment Module
+ *
+ * This module provides functionality to deploy TradeTrust Token Registry contracts
+ * with support for both ethers v5 and v6 signers. It handles two deployment modes:
+ *
+ * 1. **Quick-start mode** (default): Uses a pre-deployed deployer contract and implementation
+ *    - Faster deployment with lower gas costs
+ *    - Requires network to have deployer and implementation contracts
+ *
+ * 2. **Standalone mode**: Deploys a fresh Token Registry contract from scratch
+ *    - Works on any network with a supported Title Escrow Factory
+ *    - Higher gas costs but more flexible
+ */
+
+/**
+ * Union type for transaction receipts from both ethers v5 and v6
+ */
+type ContractTransaction = ContractTransaction$1 | ContractTransactionResponse;
+type TransactionReceipt = ContractReceipt | ContractTransactionReceipt | ContractTransaction;
+/**
+ * Configuration options for Token Registry deployment
+ */
+interface DeployOptions {
+    chainId?: CHAIN_ID;
+    maxFeePerGas?: GasValue;
+    maxPriorityFeePerGas?: GasValue;
+    standalone?: boolean;
+    factoryAddress?: string;
+    tokenRegistryImplAddress?: string;
+    deployerContractAddress?: string;
+}
+/**
+ * Deploys a new Token Registry contract with automatic mode selection.
+ *
+ * **Deployment Modes:**
+ * - **Quick-start** (default): Uses pre-deployed contracts for faster, cheaper deployment
+ * - **Standalone**: Deploys fresh contract when quick-start is unavailable
+ *
+ * **Ethers Compatibility:**
+ * - Automatically detects and handles both ethers v5 and v6 signers
+ * - Returns appropriate receipt type based on signer version
+ * @param {string} registryName - The name of the token registry (e.g., "My Token Registry")
+ * @param {string} registrySymbol - The symbol of the token registry (e.g., "MTR")
+ * @param {SignerV5 | SignerV6} signer - Signer instance that authorizes the deployment
+ * @param {DeployOptions} options - Configuration options for deployment
+ * @returns {Promise<TransactionReceipt>} Transaction receipt with deployed contract address
+ * @throws {Error} If network is not supported and no custom addresses provided
+ * @throws {Error} If Title Escrow Factory is not supported (standalone mode)
+ * @throws {Error} If deployment transaction fails
+ * @example
+ * ```typescript
+ * // Quick-start deployment
+ * const receipt = await deployTokenRegistry(
+ *   "My Registry",
+ *   "MTR",
+ *   signer,
+ *   { chainId: CHAIN_ID.SEPOLIA }
+ * );
+ *
+ * // Standalone deployment with custom factory
+ * const receipt = await deployTokenRegistry(
+ *   "My Registry",
+ *   "MYR",
+ *   signer,
+ *   {
+ *     standalone: true,
+ *     factoryAddress: "0x..."
+ *   }
+ * );
+ * ```
+ */
+declare const deployTokenRegistry: (registryName: string, registrySymbol: string, signer: Signer | Signer$1, options?: DeployOptions) => Promise<TransactionReceipt>;
+
+export { type DeployOptions, type TransactionReceipt, deployTokenRegistry };

package/dist/types/document-store/grant-role.d.ts

@@ -1,4 +1,4 @@
-import { Signer as Signer$1, ContractTransaction as ContractTransaction$1 } from 'ethersV6';
+import { Signer as Signer$1, ContractTransactionResponse } from 'ethersV6';
 import { Signer, ContractTransaction } from 'ethers';
 import { CommandOptions } from './types.js';
 import '../utils/supportedChains/index.js';
@@ -23,6 +23,6 @@ import '../token-registry-functions/types.js';
  * @throws {Error} If the role is invalid.
  * @throws {Error} If the `callStatic.grantRole` fails as a pre-check.
  */
-declare const documentStoreGrantRole: (documentStoreAddress: string, role: string, account: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<ContractTransaction | ContractTransaction$1>;
+declare const documentStoreGrantRole: (documentStoreAddress: string, role: string, account: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<ContractTransaction | ContractTransactionResponse>;
 
 export { documentStoreGrantRole };

package/dist/types/document-store/index.d.ts

@@ -3,7 +3,8 @@ export { documentStoreRevoke } from './revoke.js';
 export { documentStoreRevokeRole } from './revoke-role.js';
 export { documentStoreGrantRole } from './grant-role.js';
 export { documentStoreTransferOwnership } from './transferOwnership.js';
-export { deployDocumentStore } from './deploy.js';
+export { deployDocumentStore } from '../deploy/document-store.js';
+export { getRoleString } from './document-store-roles.js';
 export { supportInterfaceIds } from './supportInterfaceIds.js';
 export { DocumentStore__factory, TransferableDocumentStore__factory } from '@trustvc/document-store';
 import 'ethersV6';

package/dist/types/document-store/transferOwnership.d.ts

@@ -1,4 +1,4 @@
-import { Signer as Signer$1, ContractTransaction as ContractTransaction$1 } from 'ethersV6';
+import { Signer as Signer$1, ContractTransactionResponse } from 'ethersV6';
 import { Signer, ContractTransaction } from 'ethers';
 import { CommandOptions } from './types.js';
 import '../utils/supportedChains/index.js';
@@ -17,14 +17,14 @@ import '../token-registry-functions/types.js';
  * @param {string} account - The account to transfer ownership to.
  * @param {SignerV5 | SignerV6} signer - Signer instance (Ethers v5 or v6) that authorizes the transfer ownership transaction.
  * @param {CommandOptions} options - Optional transaction metadata including gas values and chain ID.
- * @returns {Promise<{grantTransaction: Promise<ContractTransactionV5 | ContractTransactionV6>; revokeTransaction: Promise<ContractTransactionV5 | ContractTransactionV6>}>} A promise resolving to the transaction result from the grant and revoke role calls.
+ * @returns {Promise<{grantTransaction: ContractTransactionV5 | ContractTransactionV6; revokeTransaction: ContractTransactionV5 | ContractTransactionV6}>} A promise resolving to the transaction result from the grant and revoke role calls.
  * @throws {Error} If the document store address or signer provider is not provided.
  * @throws {Error} If the role is invalid.
- * @throws {Error} If the `callStatic.revokeRole` fails as a pre-check.
+ * @throws {Error} If either the `callStatic.grantRole` or `callStatic.revokeRole` pre-check fails.
  */
 declare const documentStoreTransferOwnership: (documentStoreAddress: string, account: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<{
-    grantTransaction: Promise<ContractTransaction | ContractTransaction$1>;
-    revokeTransaction: Promise<ContractTransaction | ContractTransaction$1>;
+    grantTransaction: ContractTransaction | ContractTransactionResponse;
+    revokeTransaction: ContractTransaction | ContractTransactionResponse;
 }>;
 
 export { documentStoreTransferOwnership };

package/dist/types/index.d.ts

@@ -3,33 +3,28 @@ export { contractAddress as v4ContractAddress } from './token-registry-v4/contra
 export { supportInterfaceIds as v4SupportInterfaceIds } from './token-registry-v4/supportInterfaceIds.js';
 export { c as v4Contracts } from './contracts-BEtjrEPE.js';
 export { computeInterfaceId as v4ComputeInterfaceId, computeTitleEscrowAddress as v4ComputeTitleEscrowAddress, encodeInitParams as v4EncodeInitParams, getEventFromReceipt as v4GetEventFromReceipt } from './token-registry-v4/utils.js';
-export { utils as v4Utils, utils as v5Utils } from '@tradetrust-tt/token-registry-v4';
+export { utils as v4Utils } from '@tradetrust-tt/token-registry-v4';
 export { contractAddress as v5ContractAddress } from './token-registry-v5/contractAddress.js';
 export { roleHash as v5RoleHash } from './token-registry-v5/roleHash.js';
 export { supportInterfaceIds as v5SupportInterfaceIds } from './token-registry-v5/supportInterfaceIds.js';
 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 { utils as v5Utils } from '@tradetrust-tt/token-registry-v5';
 export { TypedContractMethod } from '@tradetrust-tt/token-registry-v5/contracts/common';
 export { documentStoreIssue } from './document-store/issue.js';
 export { documentStoreRevoke } from './document-store/revoke.js';
 export { documentStoreRevokeRole } from './document-store/revoke-role.js';
 export { documentStoreGrantRole } from './document-store/grant-role.js';
-export { OAErrorMessageHandling, errorMessageHandling, interpretFragments, w3cCredentialStatusRevoked, w3cCredentialStatusSuspended } from './utils/fragment/index.js';
-export { networkCurrency, networkName, networkType, networks } from './utils/network/index.js';
-export { generate12ByteNonce, generate32ByteKey, stringToUint8Array } from './utils/stringUtils/index.js';
-export { CHAIN_ID, SUPPORTED_CHAINS, chainInfo } from './utils/supportedChains/index.js';
-export { errorMessages } from './utils/errorMessages/index.js';
-export { WrappedOrSignedOpenAttestationDocument, getChainId, getObfuscatedData, getTokenId, getTokenRegistryAddress, getTransferableRecordsCredentialStatus, isObfuscated, isTransferableRecord } from './utils/documents/index.js';
-export { GasStationFeeData, GasStationFunction, calculateMaxFee, gasStation, scaleBigNumber } from './utils/gasStation/index.js';
-export { AwsKmsSigner, AwsKmsSignerCredentials } from '@tradetrust-tt/ethers-aws-kms-signer';
-export { gaEvent, gaPageView, validateGaEvent, validateGtag, validatePageViewEvent } from './utils/analytics/analytics.js';
-export { deployDocumentStore } from './document-store/deploy.js';
+export { documentStoreTransferOwnership } from './document-store/transferOwnership.js';
+export { deployDocumentStore } from './deploy/document-store.js';
+export { getRoleString } from './document-store/document-store-roles.js';
 export { DocumentStore__factory, TransferableDocumentStore__factory } from '@trustvc/document-store';
 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 { DeployOptions, TransactionReceipt, deployTokenRegistry } from './deploy/token-registry.js';
 export { decrypt } from './core/decrypt.js';
 export { encrypt } from './core/encrypt.js';
 export { verifyDocument } from './core/verify.js';
@@ -57,6 +52,15 @@ export { PrivateKeyPair } from '@trustvc/w3c-issuer';
 export { i as vc } from './index-1ws_BWZW.js';
 export { verifyW3CSignature } from './w3c/verify.js';
 export { deriveW3C } from './w3c/derive.js';
+export { OAErrorMessageHandling, errorMessageHandling, interpretFragments, w3cCredentialStatusRevoked, w3cCredentialStatusSuspended } from './utils/fragment/index.js';
+export { networkCurrency, networkName, networkType, networks } from './utils/network/index.js';
+export { generate12ByteNonce, generate32ByteKey, stringToUint8Array } from './utils/stringUtils/index.js';
+export { CHAIN_ID, SUPPORTED_CHAINS, chainInfo } from './utils/supportedChains/index.js';
+export { errorMessages } from './utils/errorMessages/index.js';
+export { WrappedOrSignedOpenAttestationDocument, getChainId, getObfuscatedData, getTokenId, getTokenRegistryAddress, getTransferableRecordsCredentialStatus, isObfuscated, isTransferableRecord } from './utils/documents/index.js';
+export { GasStationFeeData, GasStationFunction, calculateMaxFee, gasStation, scaleBigNumber } from './utils/gasStation/index.js';
+export { AwsKmsSigner, AwsKmsSignerCredentials } from '@tradetrust-tt/ethers-aws-kms-signer';
+export { gaEvent, gaPageView, validateGaEvent, validateGtag, validatePageViewEvent } from './utils/analytics/analytics.js';
 export { CustomDnsResolver, IDNSQueryResponse, IDNSRecord, OpenAttestationDNSTextRecord, OpenAttestationDnsDidRecord, defaultDnsResolvers, getDnsDidRecords, getDocumentStoreRecords, parseDnsDidResults, parseDocumentStoreResults, parseOpenAttestationRecord, queryDns } from '@tradetrust-tt/dnsprove';
 export { OpenAttestationDocument, SUPPORTED_SIGNING_ALGORITHM, SchemaId, SignedWrappedDocument, WrappedDocument, getData as getDataV2, isSchemaValidationError, obfuscateDocument, v2, v3, validateSchema, __unsafe__use__it__at__your__own__risks__wrapDocument as wrapOADocumentV3, __unsafe__use__it__at__your__own__risks__wrapDocuments as wrapOADocumentsV3 } from '@tradetrust-tt/tradetrust';
 export { DiagnoseError } from '@tradetrust-tt/tradetrust/dist/types/shared/utils';
@@ -67,11 +71,9 @@ import '@tradetrust-tt/token-registry-v4/contracts';
 import 'ethers';
 import '@typechain/ethers-v5/static/common';
 import '@tradetrust-tt/token-registry-v5/contracts';
-import '@tradetrust-tt/token-registry-v5';
 import 'ethersV6';
 import './document-store/types.js';
 import './token-registry-functions/types.js';
-import '@trustvc/w3c-credential-status';
 import '@ethersproject/abstract-provider';
 import 'ethers/lib/utils';
 import '@ethersproject/abstract-signer';
@@ -89,3 +91,4 @@ import './verify/fragments/issuer-identity/w3cIssuerIdentity.js';
 import './verify/fragments/document-status/w3cEmptyCredentialStatus/index.js';
 import 'runtypes';
 import '@trustvc/w3c-context';
+import '@trustvc/w3c-credential-status';

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

@@ -3,6 +3,7 @@ export { rejectTransferBeneficiary, rejectTransferHolder, rejectTransferOwners }
 export { acceptReturned, rejectReturned, returnToIssuer } from './returnToken.js';
 export { mint } from './mint.js';
 export { ownerOf } from './ownerOf.js';
+export { DeployOptions, TransactionReceipt, deployTokenRegistry } from '../deploy/token-registry.js';
 import 'ethersV6';
 import 'ethers';
 import './types.js';

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

@@ -9,7 +9,7 @@ import '../utils/network/index.js';
  * 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 {SignerV5 | 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.

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

@@ -4,6 +4,12 @@ import { BigNumberish, Provider } from 'ethersV6';
 import '../utils/gasStation/index.js';
 import '../utils/network/index.js';
 
+interface GasPriceScale {
+    maxPriorityFeePerGasScale: number;
+}
+interface GasOption extends GasPriceScale {
+    dryRun: boolean;
+}
 type GasValue = BigNumber | BigNumberish | string | number;
 interface RejectTransferParams {
     remarks?: string;
@@ -78,5 +84,24 @@ interface ProviderInfo {
     ethersVersion: 'v5' | 'v6';
     titleEscrowVersion: 'v4' | 'v5';
 }
+interface NetworkOption {
+    network: string;
+}
+type WalletOption = {
+    encryptedWalletPath: string;
+};
+type PrivateKeyOption = {
+    key?: string;
+    keyFile?: never;
+} | {
+    key?: never;
+    keyFile?: string;
+};
+type NetworkAndWalletSignerOption = NetworkOption & (Partial<WalletOption> | Partial<PrivateKeyOption>);
+interface DeployContractAddress {
+    TitleEscrowFactory?: string;
+    TokenImplementation?: string;
+    Deployer?: string;
+}
 
-export type { AcceptReturnedOptions, AcceptReturnedParams, ContractOptions, GasValue, MintTokenOptions, MintTokenParams, NominateParams, OwnerOfTokenOptions, OwnerOfTokenParams, ProviderInfo, RejectReturnedOptions, RejectReturnedParams, RejectTransferParams, ReturnToIssuerParams, TransactionOptions, TransferBeneficiaryParams, TransferHolderParams, TransferOwnersParams };
+export type { AcceptReturnedOptions, AcceptReturnedParams, ContractOptions, DeployContractAddress, GasOption, GasPriceScale, GasValue, MintTokenOptions, MintTokenParams, NetworkAndWalletSignerOption, NetworkOption, NominateParams, OwnerOfTokenOptions, OwnerOfTokenParams, PrivateKeyOption, ProviderInfo, RejectReturnedOptions, RejectReturnedParams, RejectTransferParams, ReturnToIssuerParams, TransactionOptions, TransferBeneficiaryParams, TransferHolderParams, TransferOwnersParams, WalletOption };

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

@@ -1,7 +1,7 @@
-import { GasValue } from './types.js';
+import { GasValue, DeployContractAddress } from './types.js';
 import { CHAIN_ID } from '../utils/supportedChains/index.js';
-import { Signer as Signer$1 } from 'ethers';
-import { Signer } from 'ethersV6';
+import { Signer as Signer$1, providers } from 'ethers';
+import { Signer, Provider } from 'ethersV6';
 import '../utils/gasStation/index.js';
 import '../utils/network/index.js';
 
@@ -14,5 +14,8 @@ declare const getTxOptions: (signer: Signer | Signer$1, chainId: CHAIN_ID, maxFe
 }>;
 declare const getChainIdSafe: (signer: Signer | Signer$1) => Promise<bigint | number>;
 declare const getSignerAddressSafe: (signer: Signer | Signer$1) => Promise<string>;
+declare const getDefaultContractAddress: (chainId: CHAIN_ID) => DeployContractAddress;
+declare const isValidAddress: (address?: string) => boolean;
+declare const isSupportedTitleEscrowFactory: (factoryAddress: string, provider: providers.Provider | Provider) => Promise<boolean>;
 
-export { getChainIdSafe, getSignerAddressSafe, getTxOptions };
+export { getChainIdSafe, getDefaultContractAddress, getSignerAddressSafe, getTxOptions, isSupportedTitleEscrowFactory, isValidAddress };

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

@@ -3,7 +3,6 @@ export { roleHash as v5RoleHash } from './roleHash.js';
 export { supportInterfaceIds as v5SupportInterfaceIds } from './supportInterfaceIds.js';
 export { c as v5Contracts } from '../contracts-BaIGKzNt.js';
 export { computeInterfaceId as v5ComputeInterfaceId, encodeInitParams as v5EncodeInitParams, getEventFromReceipt as v5GetEventFromReceipt } from './utils.js';
-export { constants, utils, utils as v5Utils } from '@tradetrust-tt/token-registry-v4';
+export { constants, utils, utils as v5Utils } from '@tradetrust-tt/token-registry-v5';
 export { TypedContractMethod } from '@tradetrust-tt/token-registry-v5/contracts/common';
 import '@tradetrust-tt/token-registry-v5/contracts';
-import '@tradetrust-tt/token-registry-v5';

package/dist/types/utils/ethers/index.d.ts

@@ -1,8 +1,9 @@
-import { ethers as ethers$1 } from 'ethers';
-import { ethers } from 'ethersV6';
-import { Provider } from '@ethersproject/abstract-provider';
+import { Provider, Contract as Contract$1, ContractFactory as ContractFactory$1 } from 'ethersV6';
+import { providers, Contract, ContractFactory } from 'ethers';
 
+type ProviderV5 = providers.Provider;
 declare const isV6EthersProvider: (provider: any) => boolean;
-declare const getEthersContractFromProvider: (provider: Provider | ethers.Provider) => typeof ethers$1.Contract | typeof ethers.Contract;
+declare const getEthersContractFromProvider: (provider: ProviderV5 | Provider) => typeof Contract | typeof Contract$1;
+declare const getEthersContractFactoryFromProvider: (provider: ProviderV5 | Provider) => typeof ContractFactory | typeof ContractFactory$1;
 
-export { getEthersContractFromProvider, isV6EthersProvider };
+export { getEthersContractFactoryFromProvider, getEthersContractFromProvider, isV6EthersProvider };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustvc/trustvc",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "description": "TrustVC library",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",