@hashgraphonline/standards-sdk 0.0.125 → 0.0.126

package/dist/es/hcs-11/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/hcs-11/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/hcs-11/client.ts"],"names":[],"mappings":"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"}

package/dist/es/hcs-11/mcp-server-builder.d.ts

@@ -1,4 +1,4 @@
-import { MCPServerConfig, MCPServerCapability, SocialPlatform } from './types';
+import { MCPServerConfig, MCPServerVerification, MCPServerResource, MCPServerTool, MCPServerCapability, SocialPlatform, SocialLink } from './types';
 import { NetworkType } from '../utils/types';
 /**
  * MCPServerBuilder is a builder class for creating MCP server configurations.
@@ -8,7 +8,7 @@ import { NetworkType } from '../utils/types';
  * ```typescript
  * const mcpBuilder = new MCPServerBuilder();
  * mcpBuilder.setName('My MCP Server');
- * mcpBuilder.setDescription('This is my MCP server for AI integration');
+ * mcpBuilder.setServerDescription('This is my MCP server for AI integration');
  * mcpBuilder.setVersion('2024-06-01');
  * mcpBuilder.setConnectionInfo('https://mcp.example.com', 'sse');
  * mcpBuilder.setServices([MCPServerCapability.TOOL_PROVIDER, MCPServerCapability.API_INTEGRATION]);
@@ -24,14 +24,20 @@ export declare class MCPServerBuilder {
     constructor();
     /**
      * Sets the display name of the MCP server
+     *
+     * @param name The display name for the MCP server profile
      */
     setName(name: string): this;
     /**
      * Sets the alias for the MCP server
+     *
+     * @param alias Alternative identifier for the MCP server
      */
     setAlias(alias: string): this;
     /**
      * Sets the bio/description for the MCP server profile
+     *
+     * @param bio Brief description or biography for the MCP server
      */
     setBio(bio: string): this;
     /**
@@ -40,82 +46,181 @@ export declare class MCPServerBuilder {
     setDescription(description: string): this;
     /**
      * Sets the version of the MCP server
+     *
+     * @param version The MCP server version (e.g., "2024-06-01")
      */
     setVersion(version: string): this;
     /**
      * Sets the connection information for the MCP server
+     *
+     * @param url Base URL for the MCP server (e.g., "https://mcp.example.com")
+     * @param transport Transport type ("stdio" or "sse")
      */
     setConnectionInfo(url: string, transport: 'stdio' | 'sse'): this;
     /**
      * Sets the detailed description for the MCP server capabilities
+     *
+     * @param description Detailed description of server functionality
      */
     setServerDescription(description: string): this;
     /**
      * Sets the services/capabilities provided by the MCP server
+     *
+     * @param services Array of service types offered by this MCP server
      */
     setServices(services: MCPServerCapability[]): this;
     /**
      * Sets the minimum host version requirements
+     *
+     * @param minVersion Minimum host version required (e.g., "2024-11-05")
      */
     setHostRequirements(minVersion?: string): this;
     /**
      * Sets the MCP capabilities supported by the server
+     *
+     * @param capabilities Array of capability strings (e.g., ["resources.get", "tools.invoke"])
      */
     setCapabilities(capabilities: string[]): this;
     /**
      * Adds a resource that the MCP server exposes
+     *
+     * @param name Resource name identifier (e.g., "hcs_topics")
+     * @param description Human-readable description of the resource
      */
     addResource(name: string, description: string): this;
+    /**
+     * Sets all resources the MCP server exposes (replaces existing resources)
+     *
+     * @param resources Array of resource objects with name and description
+     */
+    setResources(resources: MCPServerResource[]): this;
     /**
      * Adds a tool that the MCP server provides
+     *
+     * @param name Tool name identifier (e.g., "topic_submit")
+     * @param description Human-readable description of what the tool does
      */
     addTool(name: string, description: string): this;
+    /**
+     * Sets all tools the MCP server provides (replaces existing tools)
+     *
+     * @param tools Array of tool objects with name and description
+     */
+    setTools(tools: MCPServerTool[]): this;
     /**
      * Sets information about who maintains the MCP server
+     *
+     * @param maintainer Organization or entity maintaining this MCP server
      */
     setMaintainer(maintainer: string): this;
     /**
      * Sets the URL to the source code repository
+     *
+     * @param repository URL to source code repository
      */
     setRepository(repository: string): this;
     /**
      * Sets the URL to the server documentation
+     *
+     * @param docs URL to server documentation
      */
     setDocs(docs: string): this;
+    /**
+     * Sets the verification information for the MCP server
+     *
+     * @param verification Complete verification object
+     */
+    setVerification(verification: MCPServerVerification): this;
     /**
      * Adds DNS-based verification of endpoint ownership
+     *
+     * For DNS verification, the MCP server owner must add a DNS TXT record to their domain with:
+     * - Name: By default, `_hedera` or a custom name specified in `dnsField` (automatically prefixed with `_`)
+     * - Value: Equal to their Hedera account ID (e.g., `0.0.12345678`)
+     *
+     * Example DNS record:
+     * ```
+     * _hedera.example.com. 3600 IN TXT "0.0.12345678"
+     * ```
+     *
+     * @param domain The fully qualified domain name to check (e.g., "example.com")
+     * @param dnsField Optional custom DNS TXT record name (defaults to "hedera")
      */
     addVerificationDNS(domain: string, dnsField?: string): this;
     /**
      * Adds signature-based verification of endpoint ownership
+     *
+     * For signature verification:
+     * 1. The message to be signed must be the server URL exactly as it appears in the connectionInfo.url field
+     * 2. The signature must be created using the ED25519 key associated with the Hedera account
+     * 3. The signature must be encoded as a hexadecimal string with no `0x` prefix
+     *
+     * @param signature Hex-encoded ED25519 signature of the server URL
      */
     addVerificationSignature(signature: string): this;
     /**
      * Adds challenge-based verification of endpoint ownership
+     *
+     * For challenge verification:
+     * 1. The MCP server must expose an endpoint that responds to HTTP GET requests
+     * 2. The endpoint path defaults to "/hedera-verification" or can be customized with challengePath
+     * 3. The server must respond with a JSON object containing:
+     *    ```json
+     *    {
+     *      "accountId": "0.0.12345678",
+     *      "timestamp": 1620000000000,
+     *      "signature": "a1b2c3d4e5f6..."
+     *    }
+     *    ```
+     * 4. The signature must be an ED25519 signature of the UTF-8 encoded string `{accountId}:{timestamp}`
+     *
+     * @param challengePath Optional custom challenge endpoint path (defaults to "hedera-verification")
      */
     addVerificationChallenge(challengePath?: string): this;
     /**
      * Adds a social media link to the profile
+     *
+     * @param platform Social media platform (e.g., "twitter", "github")
+     * @param handle Username on the platform (e.g., "@username", "username")
      */
     addSocial(platform: SocialPlatform, handle: string): this;
+    /**
+     * Sets all social media links for the profile (replaces existing links)
+     *
+     * @param socials Array of social media links
+     */
+    setSocials(socials: SocialLink[]): this;
     /**
      * Sets the profile picture for the MCP server
+     *
+     * @param pfpBuffer Buffer containing the profile picture data
+     * @param pfpFileName Filename for the profile picture including extension
      */
     setProfilePicture(pfpBuffer: Buffer, pfpFileName: string): this;
     /**
      * Sets a reference to an existing profile picture
+     *
+     * @param pfpTopicId Topic ID containing the profile picture (for reuse)
      */
     setExistingProfilePicture(pfpTopicId: string): this;
     /**
      * Sets the network type (mainnet or testnet)
+     *
+     * @param network Network type ("mainnet" or "testnet")
      */
     setNetworkType(network: NetworkType): this;
     /**
      * Sets an existing account to use for the MCP server
+     *
+     * @param accountId Hedera account ID (e.g., "0.0.12345678")
+     * @param privateKey ED25519 private key as a string
      */
     setExistingAccount(accountId: string, privateKey: string): this;
     /**
      * Builds and validates the MCP server configuration
+     *
+     * @returns Complete MCPServerConfig object ready for use
+     * @throws Error if required fields are missing
      */
     build(): MCPServerConfig;
 }

package/dist/es/hcs-11/mcp-server-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server-builder.d.ts","sourceRoot":"","sources":["../../../src/hcs-11/mcp-server-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EAOf,mBAAmB,EACnB,cAAc,EAGf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAEZ;IACF,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAS;;IAQvB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IAWhE;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ/C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI;IAQlD;;OAEG;IACH,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9C;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAWpD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAWhD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ3B;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3D;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWjD;;OAEG;IACH,wBAAwB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAYtD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAYzD;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAM/D;;OAEG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAK1C;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ/D;;OAEG;IACH,KAAK,IAAI,eAAe;CA+CzB"}
+{"version":3,"file":"mcp-server-builder.d.ts","sourceRoot":"","sources":["../../../src/hcs-11/mcp-server-builder.ts"],"names":[],"mappings":"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"}

package/dist/es/standards-sdk.es13.js

@@ -12,6 +12,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the display name of the MCP server
+   *
+   * @param name The display name for the MCP server profile
    */
   setName(name) {
     this.config.name = name;
@@ -19,6 +21,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the alias for the MCP server
+   *
+   * @param alias Alternative identifier for the MCP server
    */
   setAlias(alias) {
     this.config.alias = alias;
@@ -26,6 +30,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the bio/description for the MCP server profile
+   *
+   * @param bio Brief description or biography for the MCP server
    */
   setBio(bio) {
     this.config.bio = bio;
@@ -39,6 +45,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the version of the MCP server
+   *
+   * @param version The MCP server version (e.g., "2024-06-01")
    */
   setVersion(version) {
     if (!this.config.mcpServer) {
@@ -49,19 +57,25 @@ class MCPServerBuilder {
   }
   /**
    * Sets the connection information for the MCP server
+   *
+   * @param url Base URL for the MCP server (e.g., "https://mcp.example.com")
+   * @param transport Transport type ("stdio" or "sse")
    */
   setConnectionInfo(url, transport) {
     if (!this.config.mcpServer) {
       this.config.mcpServer = {};
     }
-    this.config.mcpServer.connectionInfo = {
+    const connectionInfo = {
       url,
       transport
     };
+    this.config.mcpServer.connectionInfo = connectionInfo;
     return this;
   }
   /**
    * Sets the detailed description for the MCP server capabilities
+   *
+   * @param description Detailed description of server functionality
    */
   setServerDescription(description) {
     if (!this.config.mcpServer) {
@@ -72,6 +86,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the services/capabilities provided by the MCP server
+   *
+   * @param services Array of service types offered by this MCP server
    */
   setServices(services) {
     if (!this.config.mcpServer) {
@@ -82,16 +98,23 @@ class MCPServerBuilder {
   }
   /**
    * Sets the minimum host version requirements
+   *
+   * @param minVersion Minimum host version required (e.g., "2024-11-05")
    */
   setHostRequirements(minVersion) {
     if (!this.config.mcpServer) {
       this.config.mcpServer = {};
     }
-    this.config.mcpServer.host = { minVersion };
+    const hostInfo = {
+      minVersion
+    };
+    this.config.mcpServer.host = hostInfo;
     return this;
   }
   /**
    * Sets the MCP capabilities supported by the server
+   *
+   * @param capabilities Array of capability strings (e.g., ["resources.get", "tools.invoke"])
    */
   setCapabilities(capabilities) {
     if (!this.config.mcpServer) {
@@ -102,6 +125,9 @@ class MCPServerBuilder {
   }
   /**
    * Adds a resource that the MCP server exposes
+   *
+   * @param name Resource name identifier (e.g., "hcs_topics")
+   * @param description Human-readable description of the resource
    */
   addResource(name, description) {
     if (!this.config.mcpServer) {
@@ -110,11 +136,30 @@ class MCPServerBuilder {
     if (!this.config.mcpServer.resources) {
       this.config.mcpServer.resources = [];
     }
-    this.config.mcpServer.resources.push({ name, description });
+    const resource = {
+      name,
+      description
+    };
+    this.config.mcpServer.resources.push(resource);
+    return this;
+  }
+  /**
+   * Sets all resources the MCP server exposes (replaces existing resources)
+   *
+   * @param resources Array of resource objects with name and description
+   */
+  setResources(resources) {
+    if (!this.config.mcpServer) {
+      this.config.mcpServer = {};
+    }
+    this.config.mcpServer.resources = resources;
     return this;
   }
   /**
    * Adds a tool that the MCP server provides
+   *
+   * @param name Tool name identifier (e.g., "topic_submit")
+   * @param description Human-readable description of what the tool does
    */
   addTool(name, description) {
     if (!this.config.mcpServer) {
@@ -123,11 +168,29 @@ class MCPServerBuilder {
     if (!this.config.mcpServer.tools) {
       this.config.mcpServer.tools = [];
     }
-    this.config.mcpServer.tools.push({ name, description });
+    const tool = {
+      name,
+      description
+    };
+    this.config.mcpServer.tools.push(tool);
+    return this;
+  }
+  /**
+   * Sets all tools the MCP server provides (replaces existing tools)
+   *
+   * @param tools Array of tool objects with name and description
+   */
+  setTools(tools) {
+    if (!this.config.mcpServer) {
+      this.config.mcpServer = {};
+    }
+    this.config.mcpServer.tools = tools;
     return this;
   }
   /**
    * Sets information about who maintains the MCP server
+   *
+   * @param maintainer Organization or entity maintaining this MCP server
    */
   setMaintainer(maintainer) {
     if (!this.config.mcpServer) {
@@ -138,6 +201,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the URL to the source code repository
+   *
+   * @param repository URL to source code repository
    */
   setRepository(repository) {
     if (!this.config.mcpServer) {
@@ -148,6 +213,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the URL to the server documentation
+   *
+   * @param docs URL to server documentation
    */
   setDocs(docs) {
     if (!this.config.mcpServer) {
@@ -156,61 +223,129 @@ class MCPServerBuilder {
     this.config.mcpServer.docs = docs;
     return this;
   }
+  /**
+   * Sets the verification information for the MCP server
+   *
+   * @param verification Complete verification object
+   */
+  setVerification(verification) {
+    if (!this.config.mcpServer) {
+      this.config.mcpServer = {};
+    }
+    this.config.mcpServer.verification = verification;
+    return this;
+  }
   /**
    * Adds DNS-based verification of endpoint ownership
+   *
+   * For DNS verification, the MCP server owner must add a DNS TXT record to their domain with:
+   * - Name: By default, `_hedera` or a custom name specified in `dnsField` (automatically prefixed with `_`)
+   * - Value: Equal to their Hedera account ID (e.g., `0.0.12345678`)
+   *
+   * Example DNS record:
+   * ```
+   * _hedera.example.com. 3600 IN TXT "0.0.12345678"
+   * ```
+   *
+   * @param domain The fully qualified domain name to check (e.g., "example.com")
+   * @param dnsField Optional custom DNS TXT record name (defaults to "hedera")
    */
   addVerificationDNS(domain, dnsField) {
     if (!this.config.mcpServer) {
       this.config.mcpServer = {};
     }
-    this.config.mcpServer.verification = {
+    const verification = {
       type: VerificationType.DNS,
       value: domain,
       dns_field: dnsField
     };
+    this.config.mcpServer.verification = verification;
     return this;
   }
   /**
    * Adds signature-based verification of endpoint ownership
+   *
+   * For signature verification:
+   * 1. The message to be signed must be the server URL exactly as it appears in the connectionInfo.url field
+   * 2. The signature must be created using the ED25519 key associated with the Hedera account
+   * 3. The signature must be encoded as a hexadecimal string with no `0x` prefix
+   *
+   * @param signature Hex-encoded ED25519 signature of the server URL
    */
   addVerificationSignature(signature) {
     if (!this.config.mcpServer) {
       this.config.mcpServer = {};
     }
-    this.config.mcpServer.verification = {
+    const verification = {
       type: VerificationType.SIGNATURE,
       value: signature
     };
+    this.config.mcpServer.verification = verification;
     return this;
   }
   /**
    * Adds challenge-based verification of endpoint ownership
+   *
+   * For challenge verification:
+   * 1. The MCP server must expose an endpoint that responds to HTTP GET requests
+   * 2. The endpoint path defaults to "/hedera-verification" or can be customized with challengePath
+   * 3. The server must respond with a JSON object containing:
+   *    ```json
+   *    {
+   *      "accountId": "0.0.12345678",
+   *      "timestamp": 1620000000000,
+   *      "signature": "a1b2c3d4e5f6..."
+   *    }
+   *    ```
+   * 4. The signature must be an ED25519 signature of the UTF-8 encoded string `{accountId}:{timestamp}`
+   *
+   * @param challengePath Optional custom challenge endpoint path (defaults to "hedera-verification")
    */
   addVerificationChallenge(challengePath) {
     if (!this.config.mcpServer) {
       this.config.mcpServer = {};
     }
-    this.config.mcpServer.verification = {
+    const verification = {
       type: VerificationType.CHALLENGE,
       value: "",
       challenge_path: challengePath
     };
+    this.config.mcpServer.verification = verification;
     return this;
   }
   /**
    * Adds a social media link to the profile
+   *
+   * @param platform Social media platform (e.g., "twitter", "github")
+   * @param handle Username on the platform (e.g., "@username", "username")
    */
   addSocial(platform, handle) {
     const existingSocial = this.socials.find((s) => s.platform === platform);
     if (!existingSocial) {
-      this.socials.push({ platform, handle });
+      const socialLink = {
+        platform,
+        handle
+      };
+      this.socials.push(socialLink);
     } else {
       existingSocial.handle = handle;
     }
     return this;
   }
+  /**
+   * Sets all social media links for the profile (replaces existing links)
+   *
+   * @param socials Array of social media links
+   */
+  setSocials(socials) {
+    this.socials = socials;
+    return this;
+  }
   /**
    * Sets the profile picture for the MCP server
+   *
+   * @param pfpBuffer Buffer containing the profile picture data
+   * @param pfpFileName Filename for the profile picture including extension
    */
   setProfilePicture(pfpBuffer, pfpFileName) {
     this.config.pfpBuffer = pfpBuffer;
@@ -219,6 +354,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets a reference to an existing profile picture
+   *
+   * @param pfpTopicId Topic ID containing the profile picture (for reuse)
    */
   setExistingProfilePicture(pfpTopicId) {
     this.config.existingPfpTopicId = pfpTopicId;
@@ -226,6 +363,8 @@ class MCPServerBuilder {
   }
   /**
    * Sets the network type (mainnet or testnet)
+   *
+   * @param network Network type ("mainnet" or "testnet")
    */
   setNetworkType(network) {
     this.config.network = network;
@@ -233,6 +372,9 @@ class MCPServerBuilder {
   }
   /**
    * Sets an existing account to use for the MCP server
+   *
+   * @param accountId Hedera account ID (e.g., "0.0.12345678")
+   * @param privateKey ED25519 private key as a string
    */
   setExistingAccount(accountId, privateKey) {
     this.config.existingAccount = {
@@ -243,6 +385,9 @@ class MCPServerBuilder {
   }
   /**
    * Builds and validates the MCP server configuration
+   *
+   * @returns Complete MCPServerConfig object ready for use
+   * @throws Error if required fields are missing
    */
   build() {
     if (!this.config.name) {