@hashgraphonline/standards-sdk 0.0.17 → 0.0.19

package/dist/es/hcs-10/agent-builder.d.ts

@@ -1,7 +1,25 @@
-import { InboundTopicType, NetworkType, AgentConfiguration, FeeAmount } from './types.d';
+import { InboundTopicType, NetworkType, FeeConfigBuilderInterface, AgentConfiguration } from './types.d';
 import { AIAgentCapability } from '../hcs-11';
 import { AgentMetadata } from './sdk';
 type SocialPlatform = 'twitter' | 'discord' | 'github' | 'website' | 'x' | 'linkedin' | 'youtube' | 'telegram';
+/**
+ * AgentBuilder is a builder class for creating agent configurations.
+ * It provides a fluent interface for setting various properties of the agent.
+ *
+ * Example usage:
+ * ```typescript
+ * const agentBuilder = new AgentBuilder();
+ * agentBuilder.setName('My Agent');
+ * agentBuilder.setDescription('This is my agent');
+ * agentBuilder.setCapabilities([AIAgentCapability.CREATE_CONTENT]);
+ * agentBuilder.setModel('gpt-4o');
+ * agentBuilder.setCreator('John Doe');
+ * agentBuilder.addSocial('twitter', 'JohnDoe');
+ * agentBuilder.addProperty('key', 'value');
+ * const agentConfig = agentBuilder.build();
+ * ```
+ *
+ */
 export declare class AgentBuilder {
     private config;
     setName(name: string): AgentBuilder;
@@ -16,8 +34,8 @@ export declare class AgentBuilder {
     setProfilePicture(pfpBuffer: Buffer, pfpFileName: string): AgentBuilder;
     setNetwork(network: NetworkType): AgentBuilder;
     setInboundTopicType(inboundTopicType: InboundTopicType): AgentBuilder;
-    setFeeConfig(feeAmount: FeeAmount, feeCollectorAccountId: string, exemptAccounts?: string[]): AgentBuilder;
-    setConnectionFeeConfig(feeAmount: FeeAmount, feeCollectorAccountId: string, exemptAccounts?: string[]): AgentBuilder;
+    setFeeConfig(feeConfigBuilder: FeeConfigBuilderInterface): AgentBuilder;
+    setConnectionFeeConfig(feeConfigBuilder: FeeConfigBuilderInterface): AgentBuilder;
     setExistingAccount(accountId: string, privateKey: string): AgentBuilder;
     build(): AgentConfiguration;
 }

package/dist/es/hcs-10/base-client.d.ts

@@ -1,6 +1,6 @@
 import { Logger, LogLevel } from '../utils/logger';
 import { Registration } from './registrations';
-import { HederaMirrorNode, TopicInfo, AccountResponse } from '../utils/mirror-node-utils';
+import { HederaMirrorNode, TopicInfo, AccountResponse } from '../services/mirror-node';
 export interface HCS10Config {
     network: 'mainnet' | 'testnet';
     logLevel?: LogLevel;
@@ -42,8 +42,7 @@ export declare abstract class HCS10BaseClient extends Registration {
     getAccountMemo(accountId: string): Promise<string | null>;
     protected getTopicInfoFromMemo(memo: string): Promise<TopicInfo | null>;
     getTopicInfo(accountId: string): Promise<TopicInfo | null>;
-    retrieveOutboundConnectTopic(accountId: string): Promise<string | null>;
-    retrieveOutboundConnectTopicFromNetwork(accountId: string): Promise<TopicInfo>;
+    retrieveOutboundConnectTopic(accountId: string): Promise<TopicInfo>;
     retrieveOutboundMessages(agentAccountId: string): Promise<HCSMessage[]>;
     hasConnectionCreated(agentAccountId: string, connectionId: number): Promise<boolean>;
     clearCache(): void;

package/dist/es/hcs-10/fee-config-builder.d.ts

@@ -0,0 +1,66 @@
+import { FeeConfigBuilderInterface, TopicFeeConfig } from './types.d';
+/**
+ * FeeConfigBuilder provides a fluent interface for creating fee configurations
+ * for HCS-10 topics. This makes it easy to configure fees without dealing with
+ * the complexity of the underlying fee structure.
+ *
+ * Example usage:
+ * ```typescript
+ * const feeConfig = new FeeConfigBuilder()
+ *   .setHbarAmount(1) // 1 HBAR
+ *   .setFeeCollector('0.0.12345')
+ *   .addExemptAccount('0.0.67890')
+ *   .build();
+ * ```
+ */
+export declare class FeeConfigBuilder implements FeeConfigBuilderInterface {
+    private feeAmount;
+    private decimals;
+    private feeCollectorAccountId;
+    private exemptAccountIds;
+    /**
+     * Static factory method to create a fee config with HBAR amount in one line
+     * @param hbarAmount Amount in HBAR
+     * @param collectorAccountId Account that will receive the fees
+     * @param exemptAccounts Optional array of exempt account IDs
+     * @returns A configured FeeConfigBuilder
+     */
+    static forHbar(hbarAmount: number, collectorAccountId: string, exemptAccounts?: string[]): FeeConfigBuilder;
+    /**
+     * Sets the fee amount in HBAR (convenient method)
+     * @param hbarAmount The amount in HBAR (e.g., 5 for 5 HBAR)
+     * @returns This builder instance for method chaining
+     */
+    setHbarAmount(hbarAmount: number): FeeConfigBuilder;
+    /**
+     * Sets the amount of the fee to be collected for topic submissions
+     * @param amount The fee amount (in tinybars or token units)
+     * @param decimals Decimal places for fixed point representation (default: 0)
+     * @returns This builder instance for method chaining
+     */
+    setFeeAmount(amount: number, decimals?: number): FeeConfigBuilder;
+    /**
+     * Sets the Hedera account ID that will collect the fees
+     * @param accountId The fee collector's account ID (e.g., '0.0.12345')
+     * @returns This builder instance for method chaining
+     */
+    setFeeCollector(accountId: string): FeeConfigBuilder;
+    /**
+     * Adds an account ID to the list of accounts exempt from paying fees
+     * @param accountId The account ID to exempt from fees
+     * @returns This builder instance for method chaining
+     */
+    addExemptAccount(accountId: string): FeeConfigBuilder;
+    /**
+     * Adds multiple account IDs to the list of accounts exempt from paying fees
+     * @param accountIds Array of account IDs to exempt from fees
+     * @returns This builder instance for method chaining
+     */
+    addExemptAccounts(accountIds: string[]): FeeConfigBuilder;
+    /**
+     * Builds and returns the final fee configuration object
+     * @throws Error if fee collector account ID is not set or if fee amount is not positive
+     * @returns A complete TopicFeeConfig object
+     */
+    build(): TopicFeeConfig;
+}

package/dist/es/hcs-10/index.d.ts

@@ -3,3 +3,4 @@ export * from './errors';
 export * from './agent-builder';
 export * from './base-client';
 export * from './registrations';
+export * from './browser';

package/dist/es/hcs-10/sdk.d.ts

@@ -2,9 +2,10 @@ import { Client, PrivateKey, KeyList, TransactionReceipt, PublicKey } from '@has
 import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
 import { Logger } from '../utils/logger';
 import { HCS10BaseClient } from './base-client';
-import { HCSClientConfig, AgentConfig, CreateAccountResponse, CreateAgentResponse, InscribePfpResponse, StoreHCS11ProfileResponse, AgentRegistrationResult, HandleConnectionRequestResponse, WaitForConnectionConfirmationResponse, GetAccountAndSignerResponse, InboundTopicType, TopicFeeConfig } from './types.d';
+import { HCSClientConfig, AgentConfig, CreateAccountResponse, CreateAgentResponse, InscribePfpResponse, StoreHCS11ProfileResponse, AgentRegistrationResult, HandleConnectionRequestResponse, WaitForConnectionConfirmationResponse, GetAccountAndSignerResponse, InboundTopicType, TopicFeeConfig, FeeConfigBuilderInterface } from './types.d';
 import { AgentBuilder } from './agent-builder';
 export { InboundTopicType } from './types.d';
+export { FeeConfigBuilder } from './fee-config-builder';
 export interface AgentMetadata {
     type: 'autonomous' | 'manual';
     model?: string;
@@ -43,7 +44,7 @@ export declare class HCS10Client extends HCS10BaseClient {
      * @param feeConfig Optional fee configuration for fee-based topics
      * @returns The topic ID of the created inbound topic
      */
-    createInboundTopic(accountId: string, topicType: InboundTopicType, feeConfig?: TopicFeeConfig): Promise<string>;
+    createInboundTopic(accountId: string, topicType: InboundTopicType, feeConfig?: FeeConfigBuilderInterface): Promise<string>;
     /**
      * Creates a new agent with inbound and outbound topics
      * @param builder The agent builder object
@@ -79,7 +80,7 @@ export declare class HCS10Client extends HCS10BaseClient {
      * @param connectionFeeConfig Optional fee configuration for the connection topic
      * @returns Response with connection details
      */
-    handleConnectionRequest(inboundTopicId: string, requestingAccountId: string, connectionRequestId: number, connectionFeeConfig?: TopicFeeConfig): Promise<HandleConnectionRequestResponse>;
+    handleConnectionRequest(inboundTopicId: string, requestingAccountId: string, connectionRequestId: number, connectionFeeConfig?: FeeConfigBuilderInterface): Promise<HandleConnectionRequestResponse>;
     confirmConnection(inboundTopicId: string, connectionTopicId: string, connectedAccountId: string, connectionId: number, operatorId: string, memo: string, submitKey?: PrivateKey): Promise<number>;
     sendMessage(connectionTopicId: string, operatorId: string, data: string, memo?: string, submitKey?: PrivateKey): Promise<void>;
     createTopic(memo: string, adminKey?: boolean | PublicKey | KeyList, submitKey?: boolean | PublicKey | KeyList, feeConfig?: TopicFeeConfig): Promise<string>;
@@ -105,6 +106,12 @@ export declare class HCS10Client extends HCS10BaseClient {
      */
     waitForConnectionConfirmation(inboundTopicId: string, connectionRequestId: number, maxAttempts?: number, delayMs?: number): Promise<WaitForConnectionConfirmationResponse>;
     getAccountAndSigner(): GetAccountAndSignerResponse;
+    /**
+     * Checks if a user can submit to a topic and determines if a fee is required
+     * @param topicId The topic ID to check
+     * @param userAccountId The account ID of the user attempting to submit
+     * @returns Object with canSubmit, requiresFee, and optional reason
+     */
     canSubmitToInboundTopic(topicId: string, userAccountId: string): Promise<{
         canSubmit: boolean;
         requiresFee: boolean;

package/dist/es/index.d.ts

@@ -4,3 +4,4 @@ export * from './hcs-10';
 export * from './hcs-11';
 export * from './utils';
 export * from './inscribe';
+export * from './services';

package/dist/es/services/index.d.ts

@@ -0,0 +1 @@
+export * from './mirror-node';

package/dist/es/{utils/mirror-node-utils.d.ts → services/mirror-node.d.ts}

@@ -1,5 +1,5 @@
 import { PublicKey } from '@hashgraph/sdk';
-import { Logger } from './logger';
+import { Logger } from '../utils/logger';
 import { HCSMessage } from '../hcs-10/base-client';
 export interface Balance {
     balance: number;
@@ -99,20 +99,20 @@ export interface TopicMessagesResponse {
     };
 }
 export interface TopicResponse {
-    admin_key: AdminKey;
+    admin_key: Key;
     auto_renew_account: string;
     auto_renew_period: number;
     created_timestamp: string;
     custom_fees: CustomFees;
     deleted: boolean;
-    fee_exempt_key_list: AdminKey[];
-    fee_schedule_key: AdminKey;
+    fee_exempt_key_list: Key[];
+    fee_schedule_key: Key;
     memo: string;
-    submit_key: AdminKey;
+    submit_key: Key;
     timestamp: Timestamp;
     topic_id: string;
 }
-export interface AdminKey {
+export interface Key {
     _type: string;
     key: string;
 }
@@ -142,5 +142,8 @@ export declare class HederaMirrorNode {
     getTopicFees(topicId: string): Promise<CustomFees | null>;
     getTopicMessages(topicId: string): Promise<HCSMessage[]>;
     requestAccount(accountId: string): Promise<AccountResponse>;
-    getAccountInfo(accountId: string): Promise<AccountResponse>;
+    checkKeyListAccess(keyBytes: Buffer, userPublicKey: PublicKey): Promise<boolean>;
+    private evaluateKeyAccess;
+    private evaluateKeyList;
+    private compareEd25519Key;
 }