@hashgraphonline/standards-agent-kit 0.2.161 → 0.2.164

package/dist/umd/utils/inscription-utils.d.ts

@@ -9,7 +9,7 @@ export interface TopicIds {
  * - Prefers jsonTopicId when present (for CDN linking)
  * - Collects topic_id/topicId from either inscription or result
  */
-export declare function extractTopicIds(inscription: RetrievedInscriptionResult, result?: unknown): TopicIds;
+export declare function extractTopicIds(inscription: RetrievedInscriptionResult | undefined, result?: unknown): TopicIds;
 /**
  * Build HRL/CDN URLs from extracted topic ids.
  * - HRL prefers jsonTopicId, falls back to topicId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.2.161",
+  "version": "0.2.164",
   "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
   "type": "module",
   "main": "./dist/cjs/standards-agent-kit.cjs",
@@ -63,7 +63,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.72.0",
-    "@hashgraphonline/standards-sdk": "^0.1.110",
+    "@hashgraphonline/standards-sdk": "^0.1.111",
     "@kiloscribe/inscription-sdk": "^1.0.60",
     "@langchain/community": "^0.3.5",
     "@langchain/core": "^0.3.71",

package/src/builders/inscriber/inscriber-builder.ts

@@ -4,6 +4,7 @@ import {
   inscribe,
   inscribeWithSigner,
   retrieveInscription,
+  getOrCreateSDK,
   InscriptionInput,
   InscriptionOptions,
   InscriptionResponse,
@@ -11,11 +12,12 @@ import {
   HederaClientConfig,
   NetworkType,
   getTopicId,
+  Logger,
 } from '@hashgraphonline/standards-sdk';
-import {
+import type {
   InscriptionSDK,
-  type InscriptionResult,
-  type RegistrationProgressData,
+  InscriptionResult,
+  RegistrationProgressData,
 } from '@kiloscribe/inscription-sdk';
 import type { AgentOperationalMode } from 'hedera-agent-kit';
 
@@ -45,12 +47,26 @@ export interface CompletedInscriptionResponse {
 /**
  * Builder for Inscription operations
  */
-type InscriptionSDKInstance = InstanceType<typeof InscriptionSDK>;
-type InscriptionSDKAuthParams = Parameters<
-  typeof InscriptionSDK.createWithAuth
->[0];
-type ClientAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'client' }>;
-type ServerAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'server' }>;
+type InscriptionSDKInstance = InscriptionSDK;
+
+export const toDashedTransactionId = (transactionId: string): string => {
+  if (transactionId.includes('-')) {
+    return transactionId;
+  }
+
+  const [account, timePart] = transactionId.split('@');
+  if (!account || !timePart) {
+    return transactionId;
+  }
+
+  const [secondsPart, nanosPart] = timePart.split('.');
+  if (!secondsPart) {
+    return transactionId;
+  }
+
+  const normalizedNanos = (nanosPart ?? '0').padEnd(9, '0').slice(0, 9);
+  return `${account}-${secondsPart}-${normalizedNanos}`;
+};
 
 export class InscriberBuilder extends BaseServiceBuilder {
   protected inscriptionSDK?: InscriptionSDKInstance;
@@ -139,7 +155,7 @@ export class InscriberBuilder extends BaseServiceBuilder {
    * Get or create Inscription SDK
    */
   protected async getInscriptionSDK(
-    _options: InscriptionOptions
+    options: InscriptionOptions
   ): Promise<InscriptionSDKInstance | null> {
     if (this.inscriptionSDK) {
       return this.inscriptionSDK;
@@ -152,39 +168,37 @@ export class InscriberBuilder extends BaseServiceBuilder {
       ? 'mainnet'
       : 'testnet';
     const accountId = this.hederaKit.signer.getAccountId().toString();
+    const operatorKey = this.hederaKit.signer?.getOperatorPrivateKey();
+    const baseOptions: InscriptionOptions = {
+      ...options,
+      network: options.network ?? networkType,
+    };
+
+    const apiKey = baseOptions.apiKey ?? (operatorKey ? undefined : 'public-access');
+    const effectiveOptions: InscriptionOptions = apiKey
+      ? { ...baseOptions, apiKey }
+      : baseOptions;
+
+    const clientConfig = {
+      accountId,
+      privateKey: operatorKey?.toStringRaw() ?? apiKey ?? 'public-access',
+      network: networkType,
+    };
 
     try {
-      const privateKey = this.hederaKit.signer?.getOperatorPrivateKey();
-      if (privateKey) {
-        this.inscriptionSDK = await InscriptionSDK.createWithAuth({
-          type: 'server',
-          accountId,
-          privateKey:
-            privateKey.toStringRaw() as ServerAuthConfig['privateKey'],
-          network: networkType,
-        });
-      }
+      this.inscriptionSDK = await getOrCreateSDK(
+        clientConfig,
+        effectiveOptions,
+        this.inscriptionSDK
+      );
+      return this.inscriptionSDK;
     } catch (error) {
-      this.logger.warn('Failed to create InscriptionSDK with auth', error);
+      this.logger.error('failed to setup sdk', {
+        error: error instanceof Error ? error.message : String(error),
+      });
       this.inscriptionSDK = undefined;
+      return null;
     }
-
-    if (!this.inscriptionSDK) {
-      try {
-        this.inscriptionSDK = new InscriptionSDK({
-          apiKey: 'public-access',
-          network: networkType,
-          connectionMode: 'http',
-        });
-      } catch (fallbackError) {
-        this.logger.warn(
-          'Failed to create InscriptionSDK fallback instance',
-          fallbackError
-        );
-      }
-    }
-
-    return this.inscriptionSDK || null;
   }
 
   /**
@@ -326,6 +340,14 @@ export class InscriberBuilder extends BaseServiceBuilder {
         network
       );
 
+      this.logger.info('inscribeAuto start response', {
+        hasTransactionBytes:
+          typeof (start as { transactionBytes?: unknown }).transactionBytes ===
+          'string',
+        txId: (start as { tx_id?: unknown }).tx_id,
+        status: (start as { status?: unknown }).status,
+      });
+
       const completedStart = start as CompletedInscriptionResponse;
       const isCompletedResponse =
         Boolean(completedStart?.inscription) && completedStart?.confirmed;
@@ -366,30 +388,55 @@ export class InscriberBuilder extends BaseServiceBuilder {
           network
         );
       const transactionId = exec?.transactionId || '';
+      const rawTransactionId = startResponse.tx_id || transactionId;
+      const canonicalTransactionId = toDashedTransactionId(rawTransactionId);
+
+      this.logger.info('inscribeAuto wallet execution', {
+        transactionId,
+        network,
+      });
 
       const shouldWait = options.quoteOnly
         ? false
         : options.waitForConfirmation ?? true;
       if (shouldWait) {
-        this.logger.debug('Will be retrieving inscription');
         const maxAttempts =
           (options as { waitMaxAttempts?: number }).waitMaxAttempts ?? 60;
         const intervalMs =
           (options as { waitIntervalMs?: number }).waitIntervalMs ?? 5000;
+        const pollId = canonicalTransactionId;
+        this.logger.debug('Will be retrieving inscription', pollId);
 
-        const pollId = startResponse.tx_id || transactionId;
+        let retrieved: RetrievedInscriptionResult | null = null;
         const sdk = await this.getInscriptionSDK(options);
+
         if (sdk) {
-          const retrieved: RetrievedInscriptionResult =
-            await sdk.waitForInscription(
+          try {
+            retrieved = await sdk.waitForInscription(
               pollId,
               maxAttempts,
               intervalMs,
               true,
               (progress: RegistrationProgressData) => {
-                this.logger.info('checking inscription', progress);
+                this.logger.debug('checking inscription', progress);
               }
             );
+          } catch (error) {
+            this.logger.warn('Primary inscription wait failed', {
+              pollId,
+              error: error instanceof Error ? error.message : String(error),
+            });
+          }
+        } else {
+          this.logger.warn(
+            'No inscription SDK available, using public client',
+            {
+              pollId,
+            }
+          );
+        }
+
+        if (retrieved) {
           const topicIdFromInscription: string | undefined = getTopicId(
             retrieved as unknown
           );
@@ -399,14 +446,14 @@ export class InscriberBuilder extends BaseServiceBuilder {
             quote: false,
             confirmed: true,
             result: {
-              jobId: startResponse.tx_id || '',
-              transactionId,
+              jobId: toDashedTransactionId(startResponse.tx_id || ''),
+              transactionId: canonicalTransactionId,
               topicId,
             },
             inscription: retrieved,
           } as unknown as InscriptionResponse;
           this.logger.debug(
-            'retrieved inscription',
+            'retrieved inscription confirmed',
             resultConfirmed,
             retrieved
           );
@@ -418,8 +465,8 @@ export class InscriberBuilder extends BaseServiceBuilder {
         quote: false,
         confirmed: false,
         result: {
-          jobId: startResponse.tx_id || '',
-          transactionId,
+          jobId: toDashedTransactionId(startResponse.tx_id || ''),
+          transactionId: canonicalTransactionId,
           status: startResponse.status,
           completed: startResponse.completed,
         },

package/src/utils/inscription-utils.ts

@@ -19,11 +19,12 @@ function getStringProp(obj: unknown, key: string): string | undefined {
  * - Collects topic_id/topicId from either inscription or result
  */
 export function extractTopicIds(
-  inscription: RetrievedInscriptionResult,
+  inscription: RetrievedInscriptionResult | undefined,
   result?: unknown
 ): TopicIds {
   const jsonTopicId =
-    inscription.jsonTopicId || getStringProp(inscription, 'json_topic_id');
+    (inscription as RetrievedInscriptionResult | undefined)?.jsonTopicId ||
+    getStringProp(inscription, 'json_topic_id');
 
   const imageTopicId =
     getStringProp(inscription, 'topic_id') ||