@hashgraphonline/standards-sdk 0.1.165 → 0.1.166

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

@@ -0,0 +1,312 @@
+import { LogLevel, ILogger } from '../utils/logger';
+import { Registration } from './registrations';
+import { AccountResponse, HCSMessageWithCommonFields, TopicResponse, TopicInfo } from '../services/types';
+import { TransactionReceipt, PrivateKey, TopicMessageSubmitTransaction } from '../../node_modules/@hashgraph/sdk';
+import { HederaMirrorNode, MirrorNodeConfig } from '../services';
+import { WaitForConnectionConfirmationResponse, TransactMessage } from './types';
+export declare enum Hcs10MemoType {
+    INBOUND = "inbound",
+    OUTBOUND = "outbound",
+    CONNECTION = "connection",
+    REGISTRY = "registry"
+}
+/**
+ * Configuration for HCS-10 client.
+ *
+ * @example
+ * // Using default Hedera mirror nodes
+ * const config = {
+ *   network: 'testnet',
+ *   logLevel: 'info'
+ * };
+ *
+ * @example
+ * // Using HGraph custom mirror node provider
+ * const config = {
+ *   network: 'mainnet',
+ *   logLevel: 'info',
+ *   mirrorNode: {
+ *     customUrl: 'https://mainnet.hedera.api.hgraph.dev/v1/<API-KEY>',
+ *     apiKey: 'your-hgraph-api-key'
+ *   }
+ * };
+ *
+ * @example
+ * // Using custom mirror node with headers
+ * const config = {
+ *   network: 'testnet',
+ *   mirrorNode: {
+ *     customUrl: 'https://custom-mirror.example.com',
+ *     apiKey: 'your-api-key',
+ *     headers: {
+ *       'X-Custom-Header': 'value'
+ *     }
+ *   }
+ * };
+ */
+export interface HCS10Config {
+    /** The Hedera network to connect to */
+    network: 'mainnet' | 'testnet';
+    /** Log level for the client */
+    logLevel?: LogLevel;
+    /** Whether to pretty print logs */
+    prettyPrint?: boolean;
+    /** Fee amount for transactions that require fees */
+    feeAmount?: number;
+    /** Custom mirror node configuration */
+    mirrorNode?: MirrorNodeConfig;
+    /** Whether to run logger in silent mode */
+    silent?: boolean;
+    /** The key type to use for the operator */
+    keyType?: 'ed25519' | 'ecdsa';
+}
+export interface ProfileResponse {
+    profile: any;
+    topicInfo?: TopicInfo;
+    success: boolean;
+    error?: string;
+}
+export declare abstract class HCS10BaseClient extends Registration {
+    protected logger: ILogger;
+    protected feeAmount: number;
+    mirrorNode: HederaMirrorNode;
+    network: string;
+    protected operatorId: string;
+    constructor(config: HCS10Config);
+    abstract submitPayload(topicOrTransaction: string | TopicMessageSubmitTransaction, payload?: object | string, submitKey?: PrivateKey, requiresFee?: boolean): Promise<TransactionReceipt>;
+    abstract getAccountAndSigner(): {
+        accountId: string;
+        signer: any;
+    };
+    /**
+     * Updates the mirror node configuration.
+     * @param config The new mirror node configuration.
+     */
+    configureMirrorNode(config: MirrorNodeConfig): void;
+    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
+     * @param options Optional filtering options for messages
+     * @returns A stream of filtered messages valid for connection topics
+     */
+    getMessageStream(topicId: string, options?: {
+        sequenceNumber?: string | number;
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<{
+        messages: HCSMessageWithCommonFields[];
+    }>;
+    /**
+     * 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
+     * @param options Optional filtering options for messages
+     * @returns All messages from the topic
+     */
+    getMessages(topicId: string, options?: {
+        sequenceNumber?: string | number;
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<{
+        messages: HCSMessageWithCommonFields[];
+    }>;
+    /**
+     * 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
+     * @param retryOptions Optional retry configuration
+     * @returns The profile
+     */
+    retrieveProfile(accountId: string, disableCache?: boolean, retryOptions?: {
+        maxRetries?: number;
+        retryDelay?: number;
+    }): 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
+     * @param retryOptions Optional retry configuration
+     * @returns {TopicInfo} Topic Info from target profile.
+     */
+    retrieveCommunicationTopics(accountId: string, disableCache?: boolean, retryOptions?: {
+        maxRetries?: number;
+        retryDelay?: number;
+    }): Promise<TopicInfo>;
+    /**
+     * Retrieves outbound messages for an agent
+     * @param agentAccountId The account ID of the agent
+     * @param options Optional filtering options for messages
+     * @returns The outbound messages
+     */
+    retrieveOutboundMessages(agentAccountId: string, options?: {
+        sequenceNumber?: string | number;
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<HCSMessageWithCommonFields[]>;
+    /**
+     * 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;
+    /**
+     * Reads a topic's memo and determines its HCS-10 type
+     * @param topicId The topic ID to check
+     * @returns The HCS-10 memo type or null if not an HCS-10 topic
+     */
+    getTopicMemoType(topicId: string): Promise<Hcs10MemoType | null>;
+    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 options Optional filtering and retrieval options
+     * @returns Array of transaction requests sorted by timestamp (newest first)
+     */
+    getTransactionRequests(topicId: string, options?: {
+        limit?: number;
+        sequenceNumber?: string | number;
+        order?: 'asc' | 'desc';
+    }): Promise<TransactMessage[]>;
+    /**
+     * Gets the HCS-10 transaction memo for analytics based on the operation type
+     * @param payload The operation payload
+     * @returns The transaction memo in format hcs-10:op:{operation_enum}:{topic_type_enum}
+     */
+    protected getHcs10TransactionMemo(payload: object | string): string | null;
+}
+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/browser/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/browser/hcs-10/browser.d.ts

@@ -0,0 +1,129 @@
+import { PublicKey, TransactionReceipt, PrivateKey } from '../../node_modules/@hashgraph/sdk';
+import { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';
+import { LogLevel, ILogger } from '../utils';
+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';
+/**
+ * Configuration for HCS-10 browser client.
+ *
+ * @example
+ * // Using default Hedera mirror nodes
+ * const config = {
+ *   network: 'testnet',
+ *   hwc: walletConnectSDK
+ * };
+ *
+ * @example
+ * // Using HGraph custom mirror node provider
+ * const config = {
+ *   network: 'mainnet',
+ *   hwc: walletConnectSDK,
+ *   mirrorNode: {
+ *     customUrl: 'https://mainnet.hedera.api.hgraph.dev/v1/<API-KEY>',
+ *     apiKey: 'your-hgraph-api-key'
+ *   }
+ * };
+ */
+export type BrowserHCSClientConfig = {
+    /** The Hedera network to connect to */
+    network: 'mainnet' | 'testnet';
+    /** Hashinals WalletConnect SDK instance */
+    hwc: HashinalsWalletConnectSDK;
+    /** Log level for the client */
+    logLevel?: LogLevel;
+    /** Whether to pretty print logs */
+    prettyPrint?: boolean;
+    /** Guarded registry topic ID (deprecated) */
+    guardedRegistryTopicId?: string;
+    /** Base URL for the guarded registry */
+    guardedRegistryBaseUrl?: string;
+    /** Default fee amount for HIP-991 fee payments */
+    feeAmount?: number;
+    /** Custom mirror node configuration */
+    mirrorNode?: import('../services').MirrorNodeConfig;
+    /** Whether to run logger in silent mode */
+    silent?: boolean;
+};
+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: ILogger;
+    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;
+        updateAccountMemo?: boolean;
+    }): 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/browser/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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"}