@trustvc/trustvc 2.7.0 → 2.8.0

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

@@ -0,0 +1,67 @@
+'use strict';
+
+var core = require('../core');
+var supportInterfaceIds = require('./supportInterfaceIds');
+var ttDocumentStoreAbi = require('./tt-document-store-abi');
+var ethers = require('../utils/ethers');
+var documentStore = require('@trustvc/document-store');
+var utils = require('../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([
+      core.checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.supportInterfaceIds.IDocumentStore,
+        signer.provider
+      ),
+      core.checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.supportInterfaceIds.ITransferableDocumentStore,
+        signer.provider
+      )
+    ]);
+    if (!isDocumentStore && !isTransferableDocumentStore) {
+      isTTDocumentStore = true;
+    }
+  }
+  const Contract = ethers.getEthersContractFromProvider(signer.provider);
+  let documentStoreAbi;
+  if (isTTDocumentStore) {
+    documentStoreAbi = ttDocumentStoreAbi.TT_DOCUMENT_STORE_ABI;
+  } else {
+    const DocumentStoreFactory = isTransferableDocumentStore ? documentStore.TransferableDocumentStore__factory : documentStore.DocumentStore__factory;
+    documentStoreAbi = DocumentStoreFactory.abi;
+  }
+  const documentStoreContract = new Contract(
+    documentStoreAddress,
+    documentStoreAbi,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    signer
+  );
+  try {
+    const isV6 = ethers.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 utils.getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+  return await documentStoreContract.grantRole(role, account, txOptions);
+}, "documentStoreGrantRole");
+
+exports.documentStoreGrantRole = documentStoreGrantRole;

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

@@ -2,31 +2,34 @@
 
 var issue = require('./issue');
 var revoke = require('./revoke');
+var revokeRole = require('./revoke-role');
+var grantRole = require('./grant-role');
+var transferOwnership = require('./transferOwnership');
 var deploy = require('./deploy');
 var supportInterfaceIds = require('./supportInterfaceIds');
 var documentStore = require('@trustvc/document-store');
 
 
 
-Object.defineProperty(exports, "IssueOptions", {
-  enumerable: true,
-  get: function () { return issue.IssueOptions; }
-});
 Object.defineProperty(exports, "documentStoreIssue", {
   enumerable: true,
   get: function () { return issue.documentStoreIssue; }
 });
-Object.defineProperty(exports, "RevokeOptions", {
-  enumerable: true,
-  get: function () { return revoke.RevokeOptions; }
-});
 Object.defineProperty(exports, "documentStoreRevoke", {
   enumerable: true,
   get: function () { return revoke.documentStoreRevoke; }
 });
-Object.defineProperty(exports, "DeployOptions", {
+Object.defineProperty(exports, "documentStoreRevokeRole", {
+  enumerable: true,
+  get: function () { return revokeRole.documentStoreRevokeRole; }
+});
+Object.defineProperty(exports, "documentStoreGrantRole", {
+  enumerable: true,
+  get: function () { return grantRole.documentStoreGrantRole; }
+});
+Object.defineProperty(exports, "documentStoreTransferOwnership", {
   enumerable: true,
-  get: function () { return deploy.DeployOptions; }
+  get: function () { return transferOwnership.documentStoreTransferOwnership; }
 });
 Object.defineProperty(exports, "deployDocumentStore", {
   enumerable: true,

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

@@ -34,11 +34,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 = ethers.getEthersContractFromProvider(signer.provider);
   let documentStoreAbi;
   if (isTTDocumentStore) {

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

@@ -0,0 +1,67 @@
+'use strict';
+
+var core = require('../core');
+var supportInterfaceIds = require('./supportInterfaceIds');
+var ttDocumentStoreAbi = require('./tt-document-store-abi');
+var ethers = require('../utils/ethers');
+var documentStore = require('@trustvc/document-store');
+var utils = require('../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([
+      core.checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.supportInterfaceIds.IDocumentStore,
+        signer.provider
+      ),
+      core.checkSupportsInterface(
+        documentStoreAddress,
+        supportInterfaceIds.supportInterfaceIds.ITransferableDocumentStore,
+        signer.provider
+      )
+    ]);
+    if (!isDocumentStore && !isTransferableDocumentStore) {
+      isTTDocumentStore = true;
+    }
+  }
+  const Contract = ethers.getEthersContractFromProvider(signer.provider);
+  let documentStoreAbi;
+  if (isTTDocumentStore) {
+    documentStoreAbi = ttDocumentStoreAbi.TT_DOCUMENT_STORE_ABI;
+  } else {
+    const DocumentStoreFactory = isTransferableDocumentStore ? documentStore.TransferableDocumentStore__factory : documentStore.DocumentStore__factory;
+    documentStoreAbi = DocumentStoreFactory.abi;
+  }
+  const documentStoreContract = new Contract(
+    documentStoreAddress,
+    documentStoreAbi,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    signer
+  );
+  try {
+    const isV6 = ethers.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 utils.getTxOptions(signer, chainId, maxFeePerGas, maxPriorityFeePerGas);
+  return await documentStoreContract.revokeRole(role, account, txOptions);
+}, "documentStoreRevokeRole");
+
+exports.documentStoreRevokeRole = documentStoreRevokeRole;

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

@@ -34,11 +34,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 = ethers.getEthersContractFromProvider(signer.provider);
   let documentStoreAbi;
   if (isTTDocumentStore) {

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

@@ -0,0 +1,42 @@
+'use strict';
+
+var revokeRole = require('./revoke-role');
+var grantRole = require('./grant-role');
+var documentStoreRoles = require('./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 documentStoreRoles.getRoleString(documentStoreAddress, "admin", {
+    provider: signer.provider
+  });
+  const grantTransaction = grantRole.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 = revokeRole.documentStoreRevokeRole(
+    documentStoreAddress,
+    roleString,
+    ownerAddress,
+    signer,
+    options
+  );
+  const revokeTransactionResult = await revokeTransaction;
+  if (!revokeTransactionResult) {
+    throw new Error("Revoke transaction failed");
+  }
+  return { grantTransaction, revokeTransaction };
+}, "documentStoreTransferOwnership");
+
+exports.documentStoreTransferOwnership = documentStoreTransferOwnership;

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

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/cjs/index.js

@@ -94,6 +94,10 @@ Object.defineProperty(exports, "deployDocumentStore", {
   enumerable: true,
   get: function () { return documentStore.deployDocumentStore; }
 });
+Object.defineProperty(exports, "documentStoreGrantRole", {
+  enumerable: true,
+  get: function () { return documentStore.documentStoreGrantRole; }
+});
 Object.defineProperty(exports, "documentStoreIssue", {
   enumerable: true,
   get: function () { return documentStore.documentStoreIssue; }
@@ -102,6 +106,10 @@ Object.defineProperty(exports, "documentStoreRevoke", {
   enumerable: true,
   get: function () { return documentStore.documentStoreRevoke; }
 });
+Object.defineProperty(exports, "documentStoreRevokeRole", {
+  enumerable: true,
+  get: function () { return documentStore.documentStoreRevokeRole; }
+});
 Object.keys(tokenRegistryFunctions).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,

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';
 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/types/document-store/grant-role.d.ts

@@ -0,0 +1,28 @@
+import { Signer as Signer$1, ContractTransaction as ContractTransaction$1 } 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 | ContractTransaction$1>;
+
+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.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';

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

@@ -1,9 +1,10 @@
 import { Signer as Signer$1, ContractTransactionResponse } from 'ethersV6';
 import { Signer, ContractTransaction } from 'ethers';
-import { CHAIN_ID } from '../utils/supportedChains/index.js';
-import { GasValue } from '../token-registry-functions/types.js';
+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';
 
 /**
  * Issues a document hash to the DocumentStore contract.
@@ -15,18 +16,12 @@ import '../utils/network/index.js';
  * @param {string} documentStoreAddress - The address of the DocumentStore contract.
  * @param {string} documentHash - The hash of the document to issue (must be a valid hex string).
  * @param {SignerV5 | SignerV6} signer - Signer instance (Ethers v5 or v6) that authorizes the issue transaction.
- * @param {IssueOptions} options - Optional transaction metadata including gas values and chain ID.
+ * @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 issue call.
  * @throws {Error} If the document store address or signer provider is not provided.
  * @throws {Error} If the document hash is invalid.
  * @throws {Error} If the `callStatic.issue` fails as a pre-check.
  */
-interface IssueOptions {
-    chainId?: CHAIN_ID;
-    maxFeePerGas?: GasValue;
-    maxPriorityFeePerGas?: GasValue;
-    isTransferable?: boolean;
-}
-declare const documentStoreIssue: (documentStoreAddress: string, documentHash: string, signer: Signer | Signer$1, options?: IssueOptions) => Promise<ContractTransaction | ContractTransactionResponse>;
+declare const documentStoreIssue: (documentStoreAddress: string, documentHash: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<ContractTransaction | ContractTransactionResponse>;
 
-export { type IssueOptions, documentStoreIssue };
+export { documentStoreIssue };

package/dist/types/document-store/revoke-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';
+
+/**
+ * Revokes a role from 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 revoke (e.g., 'ISSUER', 'REVOKER', 'ADMIN').
+ * @param {string} account - The account to revoke the role from.
+ * @param {SignerV5 | SignerV6} signer - Signer instance (Ethers v5 or v6) that authorizes the revoke 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 revoke 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.revokeRole` fails as a pre-check.
+ */
+declare const documentStoreRevokeRole: (documentStoreAddress: string, role: string, account: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<ContractTransaction | ContractTransactionResponse>;
+
+export { documentStoreRevokeRole };

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

@@ -0,0 +1,30 @@
+import { Signer as Signer$1, ContractTransaction as ContractTransaction$1 } 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';
+
+/**
+ * Transfers ownership of a DocumentStore contract to a new owner.
+ * 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} 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.
+ * @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.
+ */
+declare const documentStoreTransferOwnership: (documentStoreAddress: string, account: string, signer: Signer | Signer$1, options?: CommandOptions) => Promise<{
+    grantTransaction: Promise<ContractTransaction | ContractTransaction$1>;
+    revokeTransaction: Promise<ContractTransaction | ContractTransaction$1>;
+}>;
+
+export { documentStoreTransferOwnership };

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

@@ -0,0 +1,15 @@
+import { CHAIN_ID } from '../utils/supportedChains/index.js';
+import { GasValue } from '../token-registry-functions/types.js';
+import '../utils/gasStation/index.js';
+import 'ethers';
+import '../utils/network/index.js';
+import 'ethersV6';
+
+interface CommandOptions {
+    chainId?: CHAIN_ID;
+    maxFeePerGas?: GasValue;
+    maxPriorityFeePerGas?: GasValue;
+    isTransferable?: boolean;
+}
+
+export type { CommandOptions };

package/dist/types/index.d.ts

@@ -12,6 +12,17 @@ export { computeInterfaceId as v5ComputeInterfaceId, encodeInitParams as v5Encod
 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 { DocumentStore__factory, TransferableDocumentStore__factory } from '@trustvc/document-store';
 export { nominate, transferBeneficiary, transferHolder, transferOwners } from './token-registry-functions/transfer.js';
@@ -46,15 +57,6 @@ 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,7 +69,9 @@ 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';
@@ -85,4 +89,3 @@ 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/package.json

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