From 2f086dc31fe19f913f50548a36e6535f4db2b831 Mon Sep 17 00:00:00 2001
From: Liran Cohen <c.liran.c@gmail.com>
Date: Wed, 14 Aug 2024 10:50:02 -0400
Subject: [PATCH] add additional comments around the signer for the permissions
 DWN api

---
 packages/api/src/dwn-api.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/api/src/dwn-api.ts b/packages/api/src/dwn-api.ts
index c7c45bbc5..c8661fe99 100644
--- a/packages/api/src/dwn-api.ts
+++ b/packages/api/src/dwn-api.ts
@@ -340,6 +340,11 @@ export class DwnApi {
    * API to interact with Grants
    *
    * NOTE: This is an EXPERIMENTAL API that will change behavior.
+   *
+   * Currently only supports issuing requests, grants, revokes and queries on behalf without permissions or impersonation.
+   * If the agent is connected to a delegateDid, the delegateDid will be used to sign/author the underlying records.
+   * If the agent is not connected to a delegateDid, the connectedDid will be used to sign/author the underlying records.
+   *
    * @beta
    */
   get permissions() {