@hashgraphonline/standards-sdk 0.0.109 → 0.0.111

package/dist/cjs/fees/fee-config-builder.d.ts

@@ -0,0 +1,115 @@
+import { FeeConfigBuilderInterface, TopicFeeConfig } from './types';
+import { Logger } from '../utils/logger';
+import { NetworkType } from '../utils/types';
+/**
+ * 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:
+ *
+ * // Super simple one-liner with the factory method
+ * const simpleFeeConfig = FeeConfigBuilder.forHbar(5, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']);
+ *
+ * // With multiple fees:
+ * const multipleFeeConfig = new FeeConfigBuilder({
+ *   network: NetworkType.TESTNET,
+ *   logger: new Logger(),
+ *   defaultCollectorAccountId: '0.0.12345',
+ *   defaultExemptAccountIds: ['0.0.67890']
+ * })
+ *   .withHbarFee(1) // 1 HBAR fee
+ *   .withTokenFee(10, '0.0.54321') // 10 units of token 0.0.54321
+ *   .build();
+ *
+ * With Agent Builder
+ * const agent = new AgentBuilder()
+ *   .setName('Fee Collector Agent')
+ *   .setDescription('An agent that collects fees')
+ *   .setInboundTopicType(InboundTopicType.FEE_BASED)
+ *   .setFeeConfig(FeeConfigBuilder.forHbar(1, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']))
+ *   .setNetwork('testnet')
+  .build();
+
+ * Directly with client
+ * const client = new HCS10Client(config);
+ * const connectionFeeConfig = new FeeConfigBuilder({
+ *   network: NetworkType.TESTNET,
+ *   logger: new Logger(),
+ *   defaultCollectorAccountId: client.getAccountAndSigner().accountId,
+ *   defaultExemptAccountIds: ['0.0.67890']
+ * })
+ *   .withHbarFee(0.5) // 0.5 HBAR (simple!)
+ *   .build();
+
+ * const result = await client.handleConnectionRequest(
+ *   inboundTopicId,
+ *   requestingAccountId,
+ *   connectionRequestId,
+ *   connectionFeeConfig
+ * );
+*/
+export interface FeeConfigBuilderOptions {
+    network: NetworkType;
+    logger: Logger;
+    defaultCollectorAccountId?: string;
+}
+export declare class FeeConfigBuilder implements FeeConfigBuilderInterface {
+    private customFees;
+    private mirrorNode;
+    private logger;
+    private defaultCollectorAccountId;
+    constructor(options: FeeConfigBuilderOptions);
+    /**
+     * Static factory method to create a FeeConfigBuilder with a single HBAR fee.
+     * @param hbarAmount Amount in HBAR.
+     * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
+     * @param network Network type ('mainnet' or 'testnet').
+     * @param logger Logger instance.
+     * @param exemptAccounts Optional array of account IDs exempt from this fee.
+     * @returns A configured FeeConfigBuilder instance.
+     */
+    static forHbar(hbarAmount: number, collectorAccountId: string | undefined, network: NetworkType, logger: Logger, exemptAccounts?: string[]): FeeConfigBuilder;
+    /**
+     * Static factory method to create a FeeConfigBuilder with a single token fee.
+     * Automatically fetches token decimals if not provided.
+     * @param tokenAmount Amount of tokens.
+     * @param feeTokenId Token ID for the fee.
+     * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
+     * @param network Network type ('mainnet' or 'testnet').
+     * @param logger Logger instance.
+     * @param exemptAccounts Optional array of account IDs exempt from this fee.
+     * @param decimals Optional decimals for the token (fetched if omitted).
+     * @returns A Promise resolving to a configured FeeConfigBuilder instance.
+     */
+    static forToken(tokenAmount: number, feeTokenId: string, collectorAccountId: string | undefined, network: NetworkType, logger: Logger, exemptAccounts?: string[], decimals?: number): Promise<FeeConfigBuilder>;
+    /**
+     * Adds an HBAR fee configuration to the builder.
+     * Allows chaining multiple fee additions.
+     * @param hbarAmount The amount in HBAR (e.g., 0.5).
+     * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
+     * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.
+     * @returns This FeeConfigBuilder instance for chaining.
+     */
+    addHbarFee(hbarAmount: number, collectorAccountId?: string, exemptAccountIds?: string[]): FeeConfigBuilder;
+    /**
+     * Adds a token fee configuration to the builder.
+     * Allows chaining multiple fee additions.
+     * Fetches token decimals automatically if not provided.
+     * @param tokenAmount The amount of the specified token.
+     * @param feeTokenId The ID of the token to charge the fee in.
+     * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
+     * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.
+     * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.
+     * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.
+     */
+    addTokenFee(tokenAmount: number, feeTokenId: string, collectorAccountId?: string, decimals?: number, exemptAccountIds?: string[]): Promise<FeeConfigBuilder>;
+    /**
+     * Builds the final TopicFeeConfig object.
+     * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.
+     * @throws Error if no fees have been added.
+     * @throws Error if more than 10 fees have been added.
+     */
+    build(): TopicFeeConfig;
+}
+//# sourceMappingURL=fee-config-builder.d.ts.map

package/dist/cjs/fees/fee-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-config-builder.d.ts","sourceRoot":"","sources":["../../../src/fees/fee-config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EAEzB,cAAc,EAEf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CE;AACF,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,yBAAyB,CAAS;gBAE9B,OAAO,EAAE,uBAAuB;IAM5C;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,CACZ,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAM,EAAO,GAC5B,gBAAgB;IASnB;;;;;;;;;;;OAWG;WACU,QAAQ,CACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAM,EAAO,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC;IAgB5B;;;;;;;OAOG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,gBAAgB,GAAE,MAAM,EAAO,GAC9B,gBAAgB;IAmBnB;;;;;;;;;;OAUG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAM,EAAO,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IA6C5B;;;;;OAKG;IACH,KAAK,IAAI,cAAc;CAqBxB"}

package/dist/cjs/fees/index.d.ts

@@ -0,0 +1,3 @@
+export * from './fee-config-builder';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/fees/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fees/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC"}

package/dist/cjs/fees/types.d.ts

@@ -0,0 +1,26 @@
+export interface FeeConfigBuilderInterface {
+    addHbarFee(hbarAmount: number, collectorAccountId?: string, exemptAccountIds?: string[]): FeeConfigBuilderInterface;
+    addTokenFee(tokenAmount: number, feeTokenId: string, collectorAccountId?: string, decimals?: number, exemptAccountIds?: string[]): Promise<FeeConfigBuilderInterface>;
+    build(): TopicFeeConfig;
+}
+export declare enum CustomFeeType {
+    FIXED_FEE = "FIXED_FEE",
+    FRACTIONAL_FEE = "FRACTIONAL_FEE",
+    ROYALTY_FEE = "ROYALTY_FEE"
+}
+export type FeeAmount = {
+    amount: number;
+    decimals?: number;
+};
+export interface TokenFeeConfig {
+    feeAmount: FeeAmount;
+    feeCollectorAccountId: string;
+    feeTokenId?: string;
+    exemptAccounts: string[];
+    type: CustomFeeType;
+}
+export interface TopicFeeConfig {
+    customFees: TokenFeeConfig[];
+    exemptAccounts: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/fees/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fees/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,yBAAyB,CAAC;IAC7B,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,IAAI,cAAc,CAAC;CACzB;AAED,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

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

@@ -0,0 +1,244 @@
+import { Logger, LogLevel } from '../utils/logger';
+import { Registration } from './registrations';
+import { AccountResponse, TopicResponse, TopicInfo } from '../services/types';
+import { TransactionReceipt, PrivateKey } from '@hashgraph/sdk';
+import { HederaMirrorNode } from '../services';
+import { WaitForConnectionConfirmationResponse, TransactMessage } from './types';
+export declare enum Hcs10MemoType {
+    INBOUND = "inbound",
+    OUTBOUND = "outbound",
+    CONNECTION = "connection"
+}
+export interface HCS10Config {
+    network: 'mainnet' | 'testnet';
+    logLevel?: LogLevel;
+    prettyPrint?: boolean;
+    feeAmount?: number;
+}
+export interface HCSMessage {
+    p: 'hcs-10';
+    op: 'connection_request' | 'connection_created' | 'message' | 'close_connection' | 'transaction';
+    data?: string;
+    created?: Date;
+    consensus_timestamp?: string;
+    m?: string;
+    payer: string;
+    outbound_topic_id?: string;
+    connection_request_id?: number;
+    confirmed_request_id?: number;
+    connection_topic_id?: string;
+    connected_account_id?: string;
+    requesting_account_id?: string;
+    connection_id?: number;
+    sequence_number: number;
+    operator_id?: string;
+    reason?: string;
+    close_method?: string;
+    schedule_id?: string;
+}
+export interface ProfileResponse {
+    profile: any;
+    topicInfo?: TopicInfo;
+    success: boolean;
+    error?: string;
+}
+export declare abstract class HCS10BaseClient extends Registration {
+    protected network: string;
+    protected logger: Logger;
+    protected feeAmount: number;
+    mirrorNode: HederaMirrorNode;
+    protected operatorId: string;
+    constructor(config: HCS10Config);
+    abstract submitPayload(topicId: string, payload: object | string, submitKey?: PrivateKey, requiresFee?: boolean): Promise<TransactionReceipt>;
+    abstract getAccountAndSigner(): {
+        accountId: string;
+        signer: any;
+    };
+    extractTopicFromOperatorId(operatorId: string): string;
+    extractAccountFromOperatorId(operatorId: string): string;
+    /**
+     * Get a stream of messages from a connection topic
+     * @param topicId The connection topic ID to get messages from
+     * @returns A stream of filtered messages valid for connection topics
+     */
+    getMessageStream(topicId: string): Promise<{
+        messages: HCSMessage[];
+    }>;
+    /**
+     * Public method to retrieve topic information using the internal mirror node client.
+     *
+     * @param topicId The ID of the topic to query.
+     * @returns Topic information or null if not found or an error occurs.
+     */
+    getPublicTopicInfo(topicId: string): Promise<TopicResponse | null>;
+    /**
+     * 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
+     */
+    canSubmitToTopic(topicId: string, userAccountId: string): Promise<{
+        canSubmit: boolean;
+        requiresFee: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Get all messages from a topic
+     * @param topicId The topic ID to get messages from
+     * @returns All messages from the topic
+     */
+    getMessages(topicId: string): Promise<{
+        messages: HCSMessage[];
+    }>;
+    /**
+     * Requests an account from the mirror node
+     * @param account The account ID to request
+     * @returns The account response
+     */
+    requestAccount(account: string): Promise<AccountResponse>;
+    /**
+     * Retrieves the memo for an account
+     * @param accountId The account ID to retrieve the memo for
+     * @returns The memo
+     */
+    getAccountMemo(accountId: string): Promise<string | null>;
+    /**
+     * Retrieves the profile for an account
+     * @param accountId The account ID to retrieve the profile for
+     * @param disableCache Whether to disable caching of the result
+     * @returns The profile
+     */
+    retrieveProfile(accountId: string, disableCache?: boolean): Promise<ProfileResponse>;
+    /**
+     * @deprecated Use retrieveCommunicationTopics instead
+     * @param accountId The account ID to retrieve the outbound connect topic for
+     * @returns {TopicInfo} Topic Info from target profile.
+     */
+    retrieveOutboundConnectTopic(accountId: string): Promise<TopicInfo>;
+    /**
+     * Retrieves the communication topics for an account
+     * @param accountId The account ID to retrieve the communication topics for
+     * @param disableCache Whether to disable caching of the result
+     * @returns {TopicInfo} Topic Info from target profile.
+     */
+    retrieveCommunicationTopics(accountId: string, disableCache?: boolean): Promise<TopicInfo>;
+    /**
+     * Retrieves outbound messages for an agent
+     * @param agentAccountId The account ID of the agent
+     * @returns The outbound messages
+     */
+    retrieveOutboundMessages(agentAccountId: string): Promise<HCSMessage[]>;
+    /**
+     * Checks if a connection has been created for an agent
+     * @param agentAccountId The account ID of the agent
+     * @param connectionId The ID of the connection
+     * @returns True if the connection has been created, false otherwise
+     */
+    hasConnectionCreated(agentAccountId: string, connectionId: number): Promise<boolean>;
+    /**
+     * Gets message content, resolving any HRL references if needed
+     * @param data The data string that may contain an HRL reference
+     * @param forceRaw Whether to force returning raw binary data
+     * @returns The resolved content
+     */
+    getMessageContent(data: string, forceRaw?: boolean): Promise<string | ArrayBuffer>;
+    /**
+     * Gets message content with its content type, resolving any HRL references if needed
+     * @param data The data string that may contain an HRL reference
+     * @param forceRaw Whether to force returning raw binary data
+     * @returns The resolved content along with content type information
+     */
+    getMessageContentWithType(data: string, forceRaw?: boolean): Promise<{
+        content: string | ArrayBuffer;
+        contentType: string;
+        isBinary: boolean;
+    }>;
+    /**
+     * Submits a connection request to an inbound topic
+     * @param inboundTopicId The ID of the inbound topic
+     * @param memo An optional memo for the message
+     * @returns The transaction receipt
+     */
+    submitConnectionRequest(inboundTopicId: string, memo: string): Promise<TransactionReceipt>;
+    /**
+     * Records an outbound connection confirmation
+     * @param outboundTopicId The ID of the outbound topic
+     * @param connectionRequestId The ID of the connection request
+     * @param confirmedRequestId The ID of the confirmed request
+     * @param connectionTopicId The ID of the connection topic
+     * @param operatorId The operator ID of the original message sender.
+     * @param memo An optional memo for the message
+     */
+    recordOutboundConnectionConfirmation({ outboundTopicId, requestorOutboundTopicId, connectionRequestId, confirmedRequestId, connectionTopicId, operatorId, memo, }: {
+        outboundTopicId: string;
+        requestorOutboundTopicId: string;
+        connectionRequestId: number;
+        confirmedRequestId: number;
+        connectionTopicId: string;
+        operatorId: string;
+        memo: string;
+    }): Promise<TransactionReceipt>;
+    /**
+     * Waits for confirmation of a connection request
+     * @param inboundTopicId Inbound topic ID
+     * @param connectionRequestId Connection request ID
+     * @param maxAttempts Maximum number of attempts
+     * @param delayMs Delay between attempts in milliseconds
+     * @returns Connection confirmation details
+     */
+    waitForConnectionConfirmation(inboundTopicId: string, connectionRequestId: number, maxAttempts?: number, delayMs?: number, recordConfirmation?: boolean): Promise<WaitForConnectionConfirmationResponse>;
+    /**
+     * Retrieves the operator ID for the current agent
+     * @param disableCache Whether to disable caching of the result
+     * @returns The operator ID
+     */
+    getOperatorId(disableCache?: boolean): Promise<string>;
+    /**
+     * Retrieves the account ID of the owner of an inbound topic
+     * @param inboundTopicId The ID of the inbound topic
+     * @returns The account ID of the owner of the inbound topic
+     */
+    retrieveInboundAccountId(inboundTopicId: string): Promise<string>;
+    clearCache(): void;
+    /**
+     * Generates a standard HCS-10 memo string.
+     * @param type The type of topic memo ('inbound', 'outbound', 'connection').
+     * @param options Configuration options for the memo.
+     * @returns The formatted memo string.
+     * @protected
+     */
+    protected _generateHcs10Memo(type: Hcs10MemoType, options: {
+        ttl?: number;
+        accountId?: string;
+        inboundTopicId?: string;
+        connectionId?: number;
+    }): string;
+    protected checkRegistrationStatus(transactionId: string, network: string, baseUrl: string): Promise<{
+        status: 'pending' | 'success' | 'failed';
+    }>;
+    /**
+     * Validates if an operator_id follows the correct format (agentTopicId@accountId)
+     * @param operatorId The operator ID to validate
+     * @returns True if the format is valid, false otherwise
+     */
+    protected isValidOperatorId(operatorId: string): boolean;
+    /**
+     * Retrieves all transaction requests from a topic
+     * @param topicId The topic ID to retrieve transactions from
+     * @param limit Optional maximum number of messages to retrieve
+     * @returns Array of transaction requests sorted by timestamp (newest first)
+     */
+    getTransactionRequests(topicId: string, limit?: number): Promise<TransactMessage[]>;
+}
+export declare class HCS10Cache {
+    private static instance;
+    private cache;
+    private cacheExpiry;
+    private readonly CACHE_TTL;
+    private constructor();
+    static getInstance(): HCS10Cache;
+    set(key: string, value: ProfileResponse): void;
+    get(key: string): ProfileResponse | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=base-client.d.ts.map

package/dist/cjs/hcs-10/base-client.d.ts.map

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

package/dist/cjs/hcs-10/browser.d.ts

@@ -0,0 +1,96 @@
+import { PublicKey, TransactionReceipt, PrivateKey } from '@hashgraph/sdk';
+import { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';
+import { Logger, LogLevel } from '../utils/logger';
+import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
+import { HCS10BaseClient } from './base-client';
+import { AgentConfig, InscribePfpResponse, StoreHCS11ProfileResponse, AgentRegistrationResult, HandleConnectionRequestResponse, RegistrationProgressCallback, AgentCreationState, GetAccountAndSignerResponse } from './types';
+import { InscribeProfileResponse } from '../hcs-11';
+import { AgentBuilder } from '../hcs-11/agent-builder';
+import { PersonBuilder } from '../hcs-11/person-builder';
+export type BrowserHCSClientConfig = {
+    network: 'mainnet' | 'testnet';
+    hwc: HashinalsWalletConnectSDK;
+    logLevel?: LogLevel;
+    prettyPrint?: boolean;
+    guardedRegistryTopicId?: string;
+    guardedRegistryBaseUrl?: string;
+    feeAmount?: number;
+};
+export type BrowserAgentConfig = Omit<AgentConfig<BrowserHCSClient>, 'privateKey'> & {
+    client: BrowserHCSClient;
+};
+export type RegisteredAgent = {
+    outboundTopicId: string;
+    inboundTopicId: string;
+    pfpTopicId: string;
+    profileTopicId: string;
+    error?: string;
+    success: boolean;
+    state: AgentCreationState;
+};
+export declare class BrowserHCSClient extends HCS10BaseClient {
+    private hwc;
+    protected logger: Logger;
+    private guardedRegistryBaseUrl;
+    private hcs11Client;
+    constructor(config: BrowserHCSClientConfig);
+    sendMessage(connectionTopicId: string, data: string, memo?: string, submitKey?: PrivateKey, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<TransactionReceipt>;
+    getPublicKey(accountId: string): Promise<PublicKey>;
+    handleConnectionRequest(inboundTopicId: string, requestingAccountId: string, connectionId: number, connectionMemo?: string, ttl?: number): Promise<HandleConnectionRequestResponse>;
+    confirmConnection(inboundTopicId: string, connectionTopicId: string, connectedAccountId: string, connectionId: number, operatorId: string, memo: string): Promise<number>;
+    create(builder: AgentBuilder | PersonBuilder, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        existingState?: AgentCreationState;
+        ttl?: number;
+        updateAccountMemo?: boolean;
+    }): Promise<RegisteredAgent | InscribeProfileResponse>;
+    private handleProfilePictureCreation;
+    private createAndInscribeProfile;
+    private initializeRegistrationState;
+    private updateStateForCompletedRegistration;
+    registerAgentWithGuardedRegistry(accountId: string, network?: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        maxAttempts?: number;
+        delayMs?: number;
+        existingState?: AgentCreationState;
+    }): Promise<AgentRegistrationResult>;
+    createAndRegisterAgent(builder: AgentBuilder, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        maxAttempts?: number;
+        delayMs?: number;
+        existingState?: AgentCreationState;
+        baseUrl?: string;
+    }): Promise<AgentRegistrationResult>;
+    storeHCS11Profile(agentName: string, agentBio: string, inboundTopicId: string, outboundTopicId: string, capabilities?: number[], metadata?: Record<string, any>, pfpBuffer?: Buffer, pfpFileName?: string, existingPfpTopicId?: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+    }): Promise<StoreHCS11ProfileResponse>;
+    createTopic(memo: string, adminKey?: boolean, submitKey?: boolean): Promise<{
+        success: boolean;
+        topicId?: string;
+        error?: string;
+    }>;
+    submitPayload(topicId: string, payload: object | string, submitKey?: PrivateKey, requiresFee?: boolean): Promise<TransactionReceipt>;
+    inscribeFile(buffer: Buffer, fileName: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<RetrievedInscriptionResult>;
+    getAccountAndSigner(): GetAccountAndSignerResponse;
+    /**
+     * Inscribes a profile picture (PFP) on HCS-11.
+     *
+     * @param buffer - The buffer containing the PFP image.
+     * @param fileName - The name of the file containing the PFP image.
+     * @param options - Optional configuration options.
+     * @returns A promise that resolves to the topic ID of the inscribed PFP.
+     */
+    inscribePfp(buffer: Buffer, fileName: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+    }): Promise<InscribePfpResponse>;
+    private createCommunicationTopics;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/cjs/hcs-10/browser.d.ts.map

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