@trustvc/trustvc 2.7.0 → 2.9.0

package/dist/esm/deploy/token-registry.js

@@ -0,0 +1,95 @@
+import { TDocDeployer__factory, TradeTrustToken__factory } from '@tradetrust-tt/token-registry/contracts';
+import { getChainIdSafe, getDefaultContractAddress, isValidAddress, getTxOptions, isSupportedTitleEscrowFactory } from '../token-registry-functions/utils';
+import { encodeInitParams } from '../token-registry-v5/utils';
+import { getEthersContractFromProvider, getEthersContractFactoryFromProvider, isV6EthersProvider } from '../utils/ethers';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const deployTokenRegistry = /* @__PURE__ */ __name(async (registryName, registrySymbol, signer, options = {}) => {
+  const { maxFeePerGas, maxPriorityFeePerGas } = options;
+  let { chainId, standalone, factoryAddress, tokenRegistryImplAddress, deployerContractAddress } = options;
+  const deployerAddress = await signer.getAddress();
+  if (!chainId) {
+    chainId = await getChainIdSafe(signer);
+  }
+  const {
+    TitleEscrowFactory: defaultTitleEscrowFactoryAddress,
+    TokenImplementation: defaultTokenImplementationContractAddress,
+    Deployer: defaultDeployerContractAddress
+  } = getDefaultContractAddress(chainId);
+  if (!isValidAddress(deployerContractAddress)) {
+    deployerContractAddress = defaultDeployerContractAddress;
+  }
+  if (!isValidAddress(tokenRegistryImplAddress)) {
+    tokenRegistryImplAddress = defaultTokenImplementationContractAddress;
+  }
+  if (standalone !== false && (!deployerContractAddress || !tokenRegistryImplAddress)) {
+    console.error(
+      `Network ${chainId} does not support "quick-start" mode. Defaulting to standalone mode.`
+    );
+    standalone = true;
+  }
+  if (!standalone) {
+    if (!deployerContractAddress || !tokenRegistryImplAddress) {
+      throw new Error(`Network ${chainId} currently is not supported. Use --standalone instead.`);
+    }
+    const Contract = getEthersContractFromProvider(signer.provider);
+    const deployerContract = new Contract(
+      deployerContractAddress,
+      TDocDeployer__factory.abi,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+      // Type assertion needed for v5/v6 compatibility
+    );
+    const initParam = encodeInitParams({
+      name: registryName,
+      symbol: registrySymbol,
+      deployer: deployerAddress
+    });
+    const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+    return await deployerContract.deploy(tokenRegistryImplAddress, initParam, txOptions);
+  } else {
+    if (!factoryAddress || !isValidAddress(factoryAddress)) {
+      factoryAddress = defaultTitleEscrowFactoryAddress;
+      if (!factoryAddress) {
+        throw new Error(`Network ${chainId} currently is not supported. Supply a factory address.`);
+      }
+    }
+    const supportedTitleEscrowFactory = await isSupportedTitleEscrowFactory(
+      factoryAddress,
+      signer.provider
+    );
+    if (!supportedTitleEscrowFactory) {
+      throw new Error(`Title Escrow Factory ${factoryAddress} is not supported.`);
+    }
+    const Contract = getEthersContractFactoryFromProvider(signer.provider);
+    const tokenFactory = new Contract(
+      TradeTrustToken__factory.abi,
+      TradeTrustToken__factory.bytecode,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      signer
+      // Type assertion needed for v5/v6 compatibility
+    );
+    const isV6 = isV6EthersProvider(signer.provider);
+    const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+    if (isV6) {
+      const contract = await tokenFactory.deploy(
+        registryName,
+        registrySymbol,
+        factoryAddress,
+        txOptions
+      );
+      return await contract.deploymentTransaction().wait();
+    } else {
+      const contract = await tokenFactory.deploy(
+        registryName,
+        registrySymbol,
+        factoryAddress,
+        txOptions
+      );
+      return await contract.deployTransaction.wait();
+    }
+  }
+}, "deployTokenRegistry");
+
+export { deployTokenRegistry };

package/dist/esm/document-store/grant-role.js

@@ -0,0 +1,65 @@
+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';
+import { getTxOptions } from '../token-registry-functions/utils';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const documentStoreGrantRole = /* @__PURE__ */ __name(async (documentStoreAddress, role, account, signer, options = {}) => {
+  if (!documentStoreAddress) throw new Error("Document store address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  if (!role) throw new Error("Role is required");
+  if (!account) throw new Error("Account is required");
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas, isTransferable } = options;
+  let isDocumentStore = !isTransferable;
+  let isTransferableDocumentStore = isTransferable;
+  let isTTDocumentStore = false;
+  if (isTransferable === void 0) {
+    [isDocumentStore, isTransferableDocumentStore] = await Promise.all([
+      checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.IDocumentStore,
+        signer.provider
+      ),
+      checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.ITransferableDocumentStore,
+        signer.provider
+      )
+    ]);
+    if (!isDocumentStore && !isTransferableDocumentStore) {
+      isTTDocumentStore = true;
+    }
+  }
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let documentStoreAbi;
+  if (isTTDocumentStore) {
+    documentStoreAbi = TT_DOCUMENT_STORE_ABI;
+  } else {
+    const DocumentStoreFactory = isTransferableDocumentStore ? TransferableDocumentStore__factory : DocumentStore__factory;
+    documentStoreAbi = DocumentStoreFactory.abi;
+  }
+  const documentStoreContract = new Contract(
+    documentStoreAddress,
+    documentStoreAbi,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    signer
+  );
+  try {
+    const isV6 = isV6EthersProvider(signer.provider);
+    if (isV6) {
+      await documentStoreContract.grantRole.staticCall(role, account);
+    } else {
+      await documentStoreContract.callStatic.grantRole(role, account);
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for grant-role failed");
+  }
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+  return await documentStoreContract.grantRole(role, account, txOptions);
+}, "documentStoreGrantRole");
+
+export { documentStoreGrantRole };

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

@@ -1,5 +1,8 @@
-export { IssueOptions, documentStoreIssue } from './issue';
-export { RevokeOptions, documentStoreRevoke } from './revoke';
-export { DeployOptions, deployDocumentStore } from './deploy';
+export { documentStoreIssue } from './issue';
+export { documentStoreRevoke } from './revoke';
+export { documentStoreRevokeRole } from './revoke-role';
+export { documentStoreGrantRole } from './grant-role';
+export { documentStoreTransferOwnership } from './transferOwnership';
+export { deployDocumentStore } from '../deploy/document-store';
 export { supportInterfaceIds } from './supportInterfaceIds';
 export { DocumentStore__factory, TransferableDocumentStore__factory } from '@trustvc/document-store';

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

@@ -32,11 +32,6 @@ const documentStoreIssue = /* @__PURE__ */ __name(async (documentStoreAddress, d
       isTTDocumentStore = true;
     }
   }
-  if (!isDocumentStore && !isTransferableDocumentStore && !isTTDocumentStore) {
-    throw new Error(
-      "Contract does not support DocumentStore, TransferableDocumentStore, or TT Document Store interface"
-    );
-  }
   const Contract = getEthersContractFromProvider(signer.provider);
   let documentStoreAbi;
   if (isTTDocumentStore) {

package/dist/esm/document-store/revoke-role.js

@@ -0,0 +1,65 @@
+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';
+import { getTxOptions } from '../token-registry-functions/utils';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const documentStoreRevokeRole = /* @__PURE__ */ __name(async (documentStoreAddress, role, account, signer, options = {}) => {
+  if (!documentStoreAddress) throw new Error("Document store address is required");
+  if (!signer.provider) throw new Error("Provider is required");
+  if (!role) throw new Error("Role is required");
+  if (!account) throw new Error("Account is required");
+  const { chainId, maxFeePerGas, maxPriorityFeePerGas, isTransferable } = options;
+  let isDocumentStore = !isTransferable;
+  let isTransferableDocumentStore = isTransferable;
+  let isTTDocumentStore = false;
+  if (isTransferable === void 0) {
+    [isDocumentStore, isTransferableDocumentStore] = await Promise.all([
+      checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.IDocumentStore,
+        signer.provider
+      ),
+      checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.ITransferableDocumentStore,
+        signer.provider
+      )
+    ]);
+    if (!isDocumentStore && !isTransferableDocumentStore) {
+      isTTDocumentStore = true;
+    }
+  }
+  const Contract = getEthersContractFromProvider(signer.provider);
+  let documentStoreAbi;
+  if (isTTDocumentStore) {
+    documentStoreAbi = TT_DOCUMENT_STORE_ABI;
+  } else {
+    const DocumentStoreFactory = isTransferableDocumentStore ? TransferableDocumentStore__factory : DocumentStore__factory;
+    documentStoreAbi = DocumentStoreFactory.abi;
+  }
+  const documentStoreContract = new Contract(
+    documentStoreAddress,
+    documentStoreAbi,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    signer
+  );
+  try {
+    const isV6 = isV6EthersProvider(signer.provider);
+    if (isV6) {
+      await documentStoreContract.revokeRole.staticCall(role, account);
+    } else {
+      await documentStoreContract.callStatic.revokeRole(role, account);
+    }
+  } catch (e) {
+    console.error("callStatic failed:", e);
+    throw new Error("Pre-check (callStatic) for revoke-role failed");
+  }
+  const txOptions = await getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+  return await documentStoreContract.revokeRole(role, account, txOptions);
+}, "documentStoreRevokeRole");
+
+export { documentStoreRevokeRole };

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

@@ -32,11 +32,6 @@ const documentStoreRevoke = /* @__PURE__ */ __name(async (documentStoreAddress,
       isTTDocumentStore = true;
     }
   }
-  if (!isDocumentStore && !isTransferableDocumentStore && !isTTDocumentStore) {
-    throw new Error(
-      "Contract does not support DocumentStore, TransferableDocumentStore, or TT Document Store interface"
-    );
-  }
   const Contract = getEthersContractFromProvider(signer.provider);
   let documentStoreAbi;
   if (isTTDocumentStore) {

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

@@ -0,0 +1,40 @@
+import { documentStoreRevokeRole } from './revoke-role';
+import { documentStoreGrantRole } from './grant-role';
+import { getRoleString } from './document-store-roles';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const documentStoreTransferOwnership = /* @__PURE__ */ __name(async (documentStoreAddress, account, signer, options = {}) => {
+  if (!documentStoreAddress) throw new Error("Document store address is required");
+  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", {
+    provider: signer.provider
+  });
+  const grantTransaction = documentStoreGrantRole(
+    documentStoreAddress,
+    roleString,
+    account,
+    signer,
+    options
+  );
+  const grantTransactionResult = await grantTransaction;
+  if (!grantTransactionResult) {
+    throw new Error("Grant transaction failed, not proceeding with revoke transaction");
+  }
+  const revokeTransaction = documentStoreRevokeRole(
+    documentStoreAddress,
+    roleString,
+    ownerAddress,
+    signer,
+    options
+  );
+  const revokeTransactionResult = await revokeTransaction;
+  if (!revokeTransactionResult) {
+    throw new Error("Revoke transaction failed");
+  }
+  return { grantTransaction, revokeTransaction };
+}, "documentStoreTransferOwnership");
+
+export { documentStoreTransferOwnership };

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

@@ -0,0 +1 @@
+

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, documentStoreIssue, documentStoreRevoke } from './document-store';
+export { DocumentStore__factory, TransferableDocumentStore__factory, deployDocumentStore, documentStoreGrantRole, documentStoreIssue, documentStoreRevoke, documentStoreRevokeRole } 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

@@ -0,0 +1,28 @@
+import { Signer as Signer$1, ContractTransactionResponse } from 'ethersV6';
+import { Signer, ContractTransaction } from 'ethers';
+import { CommandOptions } from './types.js';
+import '../utils/supportedChains/index.js';
+import '../utils/gasStation/index.js';
+import '../utils/network/index.js';
+import '../token-registry-functions/types.js';
+
+/**
+ * Grants a role to an account on the DocumentStore contract.
+ * Supports both Ethers v5 and v6 signers.
+ * Supports three types of document stores:
+ * 1. DocumentStore (ERC-165 compliant)
+ * 2. TransferableDocumentStore (ERC-165 compliant)
+ * 3. TT Document Store (legacy, no ERC-165 support - used as fallback)
+ * @param {string} documentStoreAddress - The address of the DocumentStore contract.
+ * @param {string} role - The role to grant (e.g., 'ISSUER', 'REVOKER', 'ADMIN').
+ * @param {string} account - The account to grant the role to.
+ * @param {SignerV5 | SignerV6} signer - Signer instance (Ethers v5 or v6) that authorizes the grant role transaction.
+ * @param {CommandOptions} options - Optional transaction metadata including gas values and chain ID.
+ * @returns {Promise<ContractTransactionV5 | ContractTransactionV6>} A promise resolving to the transaction result from the grant role call.
+ * @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.grantRole` fails as a pre-check.
+ */
+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

@@ -1,10 +1,14 @@
-export { IssueOptions, documentStoreIssue } from './issue.js';
-export { RevokeOptions, documentStoreRevoke } from './revoke.js';
-export { DeployOptions, deployDocumentStore } from './deploy.js';
+export { documentStoreIssue } from './issue.js';
+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/document-store.js';
 export { supportInterfaceIds } from './supportInterfaceIds.js';
 export { DocumentStore__factory, TransferableDocumentStore__factory } from '@trustvc/document-store';
 import 'ethersV6';
 import 'ethers';
+import './types.js';
 import '../utils/supportedChains/index.js';
 import '../utils/gasStation/index.js';
 import '../utils/network/index.js';