@hashgraphonline/standards-sdk 0.0.15 → 0.0.17

package/dist/umd/utils/index.d.ts

@@ -1 +1,3 @@
 export * from './logger';
+export * from './mirror-node-utils';
+export * from './topic-fee-utils';

package/dist/umd/utils/mirror-node-utils.d.ts

@@ -0,0 +1,146 @@
+import { PublicKey } from '@hashgraph/sdk';
+import { Logger } from './logger';
+import { HCSMessage } from '../hcs-10/base-client';
+export interface Balance {
+    balance: number;
+    timestamp: string;
+    tokens: TokenBalance[];
+}
+export interface TokenBalance {
+    token_id: string;
+    balance: number;
+}
+export interface Key {
+    _type: string;
+    key: string;
+}
+export interface AccountResponse {
+    account: string;
+    alias: string;
+    auto_renew_period: number;
+    balance: Balance;
+    created_timestamp: string;
+    decline_reward: boolean;
+    deleted: boolean;
+    ethereum_nonce: number;
+    evm_address: string;
+    expiry_timestamp: string;
+    key: Key;
+    max_automatic_token_associations: number;
+    memo: string;
+    pending_reward: number;
+    receiver_sig_required: boolean;
+    staked_account_id: string | null;
+    staked_node_id: string | null;
+    stake_period_start: string | null;
+    transactions: Transaction[];
+    links: Links;
+}
+export interface Transaction {
+    bytes: string | null;
+    charged_tx_fee: number;
+    consensus_timestamp: string;
+    entity_id: string | null;
+    max_fee: string;
+    memo_base64: string;
+    name: string;
+    nft_transfers: NftTransfer[];
+    node: string;
+    nonce: number;
+    parent_consensus_timestamp: string | null;
+    result: string;
+    scheduled: boolean;
+    staking_reward_transfers: Transfer[];
+    token_transfers: TokenTransfer[];
+    transaction_hash: string;
+    transaction_id: string;
+    transfers: Transfer[];
+    valid_duration_seconds: string;
+    valid_start_timestamp: string;
+}
+export interface Transfer {
+    account: string;
+    amount: number;
+    is_approval: boolean;
+}
+export interface TokenTransfer {
+    token_id: string;
+    account: string;
+    amount: string;
+    is_approval: boolean;
+}
+export interface NftTransfer {
+    receiver_account_id: string;
+    sender_account_id: string;
+    serial_number: number;
+    is_approval: boolean;
+}
+export interface Links {
+    next: string;
+}
+export type NetworkType = 'mainnet' | 'testnet';
+export interface TopicInfo {
+    inboundTopic: string;
+    outboundTopic: string;
+}
+export interface TopicMessage {
+    consensus_timestamp: string;
+    topic_id: string;
+    message: string;
+    sequence_number: number;
+    running_hash: string;
+    running_hash_version: number;
+    payer_account_id: string;
+}
+export interface TopicMessagesResponse {
+    messages: TopicMessage[];
+    links: {
+        next?: string;
+    };
+}
+export interface TopicResponse {
+    admin_key: AdminKey;
+    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;
+    memo: string;
+    submit_key: AdminKey;
+    timestamp: Timestamp;
+    topic_id: string;
+}
+export interface AdminKey {
+    _type: string;
+    key: string;
+}
+export interface CustomFees {
+    created_timestamp: string;
+    fixed_fees: FixedFee[];
+}
+export interface FixedFee {
+    amount: number;
+    collector_account_id: string;
+    denominating_token_id: string;
+}
+export interface Timestamp {
+    from: string;
+    to: string;
+}
+export declare class HederaMirrorNode {
+    private network;
+    private baseUrl;
+    private logger?;
+    constructor(network: NetworkType, logger?: Logger);
+    private getMirrorNodeUrl;
+    getBaseUrl(): string;
+    getPublicKey(accountId: string): Promise<PublicKey>;
+    getAccountMemo(accountId: string): Promise<string | null>;
+    getTopicInfo(topicId: string): Promise<TopicResponse>;
+    getTopicFees(topicId: string): Promise<CustomFees | null>;
+    getTopicMessages(topicId: string): Promise<HCSMessage[]>;
+    requestAccount(accountId: string): Promise<AccountResponse>;
+    getAccountInfo(accountId: string): Promise<AccountResponse>;
+}

package/dist/umd/utils/topic-fee-utils.d.ts

@@ -0,0 +1,11 @@
+import { PublicKey } from '@hashgraph/sdk';
+import { Logger } from './logger';
+/**
+ * Converts account IDs to public keys for fee exemption
+ * @param client Hedera client instance
+ * @param accountIds Array of account IDs to convert to public keys
+ * @param network The network to use for retrieving public keys
+ * @param logger Optional logger instance
+ * @returns Array of public keys
+ */
+export declare function accountIdsToExemptKeys(accountIds: string[], network: string, logger?: Logger): Promise<PublicKey[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-sdk",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "HCS Standards SDK",
   "type": "module",
   "files": [
@@ -36,6 +36,7 @@
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.2.0",
     "rimraf": "^6.0.1",
+    "terser": "^5.37.0",
     "typescript": "^5.5.4",
     "vite": "^5.4.0",
     "vite-plugin-dts": "^4.0.2"
@@ -43,7 +44,7 @@
   "dependencies": {
     "@google/model-viewer": "^4.0.0",
     "@hashgraph/hedera-wallet-connect": "^1.5.0",
-    "@hashgraph/sdk": "^2.56.0",
+    "@hashgraph/sdk": "2.61.0-beta.2",
     "@hashgraphonline/hashinal-wc": "^1.0.96",
     "@kiloscribe/inscription-sdk": "^1.0.24",
     "dotenv": "^16.4.7",
@@ -56,5 +57,6 @@
     "tsx": "^4.19.3",
     "vite-plugin-node-polyfills": "^0.23.0",
     "zod": "^3.24.2"
-  }
+  },
+  "packageManager": "yarn@3.6.1+sha512.de524adec81a6c3d7a26d936d439d2832e351cdfc5728f9d91f3fc85dd20b04391c038e9b4ecab11cae2b0dd9f0d55fd355af766bc5c1a7f8d25d96bb2a0b2ca"
 }

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

@@ -1,150 +0,0 @@
-import { Logger, LogLevel } from '../utils/logger';
-import { Registration } from './registrations';
-export interface AccountResponse {
-    account: string;
-    alias: string;
-    auto_renew_period: number;
-    balance: Balance;
-    created_timestamp: string;
-    decline_reward: boolean;
-    deleted: boolean;
-    ethereum_nonce: number;
-    evm_address: string;
-    expiry_timestamp: string;
-    key: Key;
-    max_automatic_token_associations: number;
-    memo: string;
-    pending_reward: number;
-    receiver_sig_required: boolean;
-    staked_account_id: string | null;
-    staked_node_id: string | null;
-    stake_period_start: string | null;
-    transactions: Transaction[];
-    links: Links;
-}
-export interface Balance {
-    balance: number;
-    timestamp: string;
-    tokens: TokenBalance[];
-}
-export interface TokenBalance {
-    token_id: string;
-    balance: number;
-}
-export interface Key {
-    _type: string;
-    key: string;
-}
-export interface Transaction {
-    bytes: string | null;
-    charged_tx_fee: number;
-    consensus_timestamp: string;
-    entity_id: string | null;
-    max_fee: string;
-    memo_base64: string;
-    name: string;
-    nft_transfers: NftTransfer[];
-    node: string;
-    nonce: number;
-    parent_consensus_timestamp: string | null;
-    result: string;
-    scheduled: boolean;
-    staking_reward_transfers: Transfer[];
-    token_transfers: TokenTransfer[];
-    transaction_hash: string;
-    transaction_id: string;
-    transfers: Transfer[];
-    valid_duration_seconds: string;
-    valid_start_timestamp: string;
-}
-export interface Transfer {
-    account: string;
-    amount: number;
-    is_approval: boolean;
-}
-export interface TokenTransfer {
-    token_id: string;
-    account: string;
-    amount: string;
-    is_approval: boolean;
-}
-export interface NftTransfer {
-    receiver_account_id: string;
-    sender_account_id: string;
-    serial_number: number;
-    is_approval: boolean;
-}
-export interface Links {
-    next: string;
-}
-export interface OutboundConfig {
-    network: 'mainnet' | 'testnet';
-    logLevel?: LogLevel;
-}
-export interface TopicInfo {
-    inboundTopic: string;
-    outboundTopic: string;
-}
-export interface HCSMessage {
-    p: 'hcs-10';
-    op: 'connection_request' | 'connection_created' | 'message';
-    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;
-}
-export declare abstract class Outbound extends Registration {
-    private static topicCache;
-    protected network: string;
-    protected logger: Logger;
-    protected validTags: string[];
-    constructor(config: OutboundConfig);
-    abstract getAccountAndSigner(): {
-        accountId: string;
-        signer: any;
-    };
-    protected abstract getMessages(topicId: string): Promise<{
-        messages: HCSMessage[];
-    }>;
-    protected validateTags(metadata: {
-        tags: string[];
-    }): {
-        valid: boolean;
-        error?: string;
-    };
-    protected checkRegistrationStatus(transactionId: string, network: string, baseUrl: string): Promise<{
-        status: 'pending' | 'success' | 'failed';
-    }>;
-    protected waitForRegistrationConfirmation(transactionId: string, network: string, baseUrl: string, maxAttempts: number, delayMs: number): Promise<boolean>;
-    requestAccount(account: string): Promise<AccountResponse>;
-    getAccountMemo(accountId: string): Promise<string | null>;
-    private getTopicInfoFromMemo;
-    getMirrorNodeUrl(): string;
-    getTopicInfo(accountId: string): Promise<TopicInfo | null>;
-    retrieveOutboundConnectTopic(accountId: string): Promise<string | null>;
-    retrieveOutboundConnectTopicFromNetwork(accountId: string): Promise<TopicInfo>;
-    retrieveOutboundMessages(agentAccountId: string): Promise<HCSMessage[]>;
-    hasConnectionCreated(agentAccountId: string, connectionId: number): Promise<boolean>;
-    clearCache(): void;
-}
-export declare class OutboundCache {
-    private static instance;
-    private cache;
-    private cacheExpiry;
-    private readonly CACHE_TTL;
-    private constructor();
-    static getInstance(): OutboundCache;
-    set(key: string, value: TopicInfo): void;
-    get(key: string): TopicInfo | undefined;
-    clear(): void;
-}

package/dist/es/hcs-10/registration-utils.d.ts

@@ -1,34 +0,0 @@
-import { Logger } from '../utils/logger';
-import { RegistrationResult } from './types';
-/**
- * Checks the status of a registration transaction
- * @param transactionId Transaction ID
- * @param network Network type
- * @param baseUrl Base URL of the guarded registry
- * @param logger Logger instance
- * @returns Registration status
- */
-export declare function checkRegistrationStatus(transactionId: string, network: string, baseUrl: string, logger?: Logger): Promise<{
-    status: 'pending' | 'success' | 'failed';
-}>;
-/**
- * Waits for a registration transaction to complete
- * @param transactionId Transaction ID
- * @param network Network type
- * @param baseUrl Base URL of the guarded registry
- * @param maxAttempts Maximum number of attempts
- * @param delayMs Delay between attempts
- * @param logger Logger instance
- * @returns Confirmation result
- */
-export declare function waitForRegistrationConfirmation(transactionId: string, network: string, baseUrl: string, maxAttempts?: number, delayMs?: number, logger?: Logger): Promise<boolean>;
-/**
- * Executes a registration request
- * @param accountId Account ID
- * @param inboundTopicId Inbound topic ID
- * @param network Network type
- * @param guardedRegistryBaseUrl Base URL of the guarded registry
- * @param logger Logger instance
- * @returns Registration result
- */
-export declare function executeRegistration(accountId: string, inboundTopicId: string, network: string, guardedRegistryBaseUrl: string, logger: Logger): Promise<RegistrationResult>;

package/dist/umd/hcs-10/outbound.d.ts

@@ -1,150 +0,0 @@
-import { Logger, LogLevel } from '../utils/logger';
-import { Registration } from './registrations';
-export interface AccountResponse {
-    account: string;
-    alias: string;
-    auto_renew_period: number;
-    balance: Balance;
-    created_timestamp: string;
-    decline_reward: boolean;
-    deleted: boolean;
-    ethereum_nonce: number;
-    evm_address: string;
-    expiry_timestamp: string;
-    key: Key;
-    max_automatic_token_associations: number;
-    memo: string;
-    pending_reward: number;
-    receiver_sig_required: boolean;
-    staked_account_id: string | null;
-    staked_node_id: string | null;
-    stake_period_start: string | null;
-    transactions: Transaction[];
-    links: Links;
-}
-export interface Balance {
-    balance: number;
-    timestamp: string;
-    tokens: TokenBalance[];
-}
-export interface TokenBalance {
-    token_id: string;
-    balance: number;
-}
-export interface Key {
-    _type: string;
-    key: string;
-}
-export interface Transaction {
-    bytes: string | null;
-    charged_tx_fee: number;
-    consensus_timestamp: string;
-    entity_id: string | null;
-    max_fee: string;
-    memo_base64: string;
-    name: string;
-    nft_transfers: NftTransfer[];
-    node: string;
-    nonce: number;
-    parent_consensus_timestamp: string | null;
-    result: string;
-    scheduled: boolean;
-    staking_reward_transfers: Transfer[];
-    token_transfers: TokenTransfer[];
-    transaction_hash: string;
-    transaction_id: string;
-    transfers: Transfer[];
-    valid_duration_seconds: string;
-    valid_start_timestamp: string;
-}
-export interface Transfer {
-    account: string;
-    amount: number;
-    is_approval: boolean;
-}
-export interface TokenTransfer {
-    token_id: string;
-    account: string;
-    amount: string;
-    is_approval: boolean;
-}
-export interface NftTransfer {
-    receiver_account_id: string;
-    sender_account_id: string;
-    serial_number: number;
-    is_approval: boolean;
-}
-export interface Links {
-    next: string;
-}
-export interface OutboundConfig {
-    network: 'mainnet' | 'testnet';
-    logLevel?: LogLevel;
-}
-export interface TopicInfo {
-    inboundTopic: string;
-    outboundTopic: string;
-}
-export interface HCSMessage {
-    p: 'hcs-10';
-    op: 'connection_request' | 'connection_created' | 'message';
-    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;
-}
-export declare abstract class Outbound extends Registration {
-    private static topicCache;
-    protected network: string;
-    protected logger: Logger;
-    protected validTags: string[];
-    constructor(config: OutboundConfig);
-    abstract getAccountAndSigner(): {
-        accountId: string;
-        signer: any;
-    };
-    protected abstract getMessages(topicId: string): Promise<{
-        messages: HCSMessage[];
-    }>;
-    protected validateTags(metadata: {
-        tags: string[];
-    }): {
-        valid: boolean;
-        error?: string;
-    };
-    protected checkRegistrationStatus(transactionId: string, network: string, baseUrl: string): Promise<{
-        status: 'pending' | 'success' | 'failed';
-    }>;
-    protected waitForRegistrationConfirmation(transactionId: string, network: string, baseUrl: string, maxAttempts: number, delayMs: number): Promise<boolean>;
-    requestAccount(account: string): Promise<AccountResponse>;
-    getAccountMemo(accountId: string): Promise<string | null>;
-    private getTopicInfoFromMemo;
-    getMirrorNodeUrl(): string;
-    getTopicInfo(accountId: string): Promise<TopicInfo | null>;
-    retrieveOutboundConnectTopic(accountId: string): Promise<string | null>;
-    retrieveOutboundConnectTopicFromNetwork(accountId: string): Promise<TopicInfo>;
-    retrieveOutboundMessages(agentAccountId: string): Promise<HCSMessage[]>;
-    hasConnectionCreated(agentAccountId: string, connectionId: number): Promise<boolean>;
-    clearCache(): void;
-}
-export declare class OutboundCache {
-    private static instance;
-    private cache;
-    private cacheExpiry;
-    private readonly CACHE_TTL;
-    private constructor();
-    static getInstance(): OutboundCache;
-    set(key: string, value: TopicInfo): void;
-    get(key: string): TopicInfo | undefined;
-    clear(): void;
-}

package/dist/umd/hcs-10/registration-utils.d.ts

@@ -1,34 +0,0 @@
-import { Logger } from '../utils/logger';
-import { RegistrationResult } from './types';
-/**
- * Checks the status of a registration transaction
- * @param transactionId Transaction ID
- * @param network Network type
- * @param baseUrl Base URL of the guarded registry
- * @param logger Logger instance
- * @returns Registration status
- */
-export declare function checkRegistrationStatus(transactionId: string, network: string, baseUrl: string, logger?: Logger): Promise<{
-    status: 'pending' | 'success' | 'failed';
-}>;
-/**
- * Waits for a registration transaction to complete
- * @param transactionId Transaction ID
- * @param network Network type
- * @param baseUrl Base URL of the guarded registry
- * @param maxAttempts Maximum number of attempts
- * @param delayMs Delay between attempts
- * @param logger Logger instance
- * @returns Confirmation result
- */
-export declare function waitForRegistrationConfirmation(transactionId: string, network: string, baseUrl: string, maxAttempts?: number, delayMs?: number, logger?: Logger): Promise<boolean>;
-/**
- * Executes a registration request
- * @param accountId Account ID
- * @param inboundTopicId Inbound topic ID
- * @param network Network type
- * @param guardedRegistryBaseUrl Base URL of the guarded registry
- * @param logger Logger instance
- * @returns Registration result
- */
-export declare function executeRegistration(accountId: string, inboundTopicId: string, network: string, guardedRegistryBaseUrl: string, logger: Logger): Promise<RegistrationResult>;