@hashgraphonline/standards-agent-kit 0.2.160 → 0.2.162

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.160",
+  "version": "0.2.162",
   "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",

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

@@ -11,8 +11,13 @@ import {
   HederaClientConfig,
   NetworkType,
   getTopicId,
+  Logger,
 } from '@hashgraphonline/standards-sdk';
-import type { InscriptionResult } from '@kiloscribe/inscription-sdk';
+import {
+  InscriptionSDK,
+  type InscriptionResult,
+  type RegistrationProgressData,
+} from '@kiloscribe/inscription-sdk';
 import type { AgentOperationalMode } from 'hedera-agent-kit';
 
 /**
@@ -41,24 +46,32 @@ export interface CompletedInscriptionResponse {
 /**
  * Builder for Inscription operations
  */
-let cachedInscriptionSdkModule: typeof import('@kiloscribe/inscription-sdk') | null = null;
-const loadInscriptionSdkModule = async () => {
-  if (!cachedInscriptionSdkModule) {
-    cachedInscriptionSdkModule = (await import(
-      '@kiloscribe/inscription-sdk'
-    )) as typeof import('@kiloscribe/inscription-sdk');
-  }
-  return cachedInscriptionSdkModule;
-};
-
-type InscriptionSDKType = Awaited<
-  ReturnType<typeof loadInscriptionSdkModule>
->['InscriptionSDK'];
-type InscriptionSDKInstance = InstanceType<InscriptionSDKType>;
-type InscriptionSDKAuthParams = Parameters<InscriptionSDKType['createWithAuth']>[0];
+type InscriptionSDKInstance = InstanceType<typeof InscriptionSDK>;
+type InscriptionSDKAuthParams = Parameters<
+  typeof InscriptionSDK.createWithAuth
+>[0];
 type ClientAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'client' }>;
 type ServerAuthConfig = Extract<InscriptionSDKAuthParams, { type: 'server' }>;
 
+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;
   private static signerProvider?: () =>
@@ -153,32 +166,30 @@ export class InscriberBuilder extends BaseServiceBuilder {
     }
 
     const network = this.hederaKit.client.network;
-    const networkType: 'mainnet' | 'testnet' = network.toString().includes('mainnet')
+    const networkType: 'mainnet' | 'testnet' = network
+      .toString()
+      .includes('mainnet')
       ? 'mainnet'
       : 'testnet';
     const accountId = this.hederaKit.signer.getAccountId().toString();
 
     try {
-      const { InscriptionSDK } = await loadInscriptionSdkModule();
-      const signer = await this.getSigner();
-
-      if (signer) {
+      this.logger.info('Attempting InscriptionSDK.createWithAuth', {
+        accountId,
+        network: networkType,
+      });
+      const privateKey = this.hederaKit.signer?.getOperatorPrivateKey();
+      if (privateKey) {
         this.inscriptionSDK = await InscriptionSDK.createWithAuth({
-          type: 'client',
+          type: 'server',
           accountId,
-          signer: signer as unknown as ClientAuthConfig['signer'],
+          privateKey:
+            privateKey.toStringRaw() as ServerAuthConfig['privateKey'],
+          network: networkType,
+        });
+        this.logger.info('Created InscriptionSDK via createWithAuth', {
           network: networkType,
         });
-      } else {
-        const privateKey = this.hederaKit.signer?.getOperatorPrivateKey();
-        if (privateKey) {
-          this.inscriptionSDK = await InscriptionSDK.createWithAuth({
-            type: 'server',
-            accountId,
-            privateKey: privateKey.toStringRaw() as ServerAuthConfig['privateKey'],
-            network: networkType,
-          });
-        }
       }
     } catch (error) {
       this.logger.warn('Failed to create InscriptionSDK with auth', error);
@@ -187,21 +198,29 @@ export class InscriberBuilder extends BaseServiceBuilder {
 
     if (!this.inscriptionSDK) {
       try {
-        const { InscriptionSDK } = await loadInscriptionSdkModule();
+        this.logger.info('Creating fallback InscriptionSDK instance', {
+          network: networkType,
+        });
         this.inscriptionSDK = new InscriptionSDK({
           apiKey: 'public-access',
           network: networkType,
           connectionMode: 'http',
         });
+        this.logger.info('Created fallback InscriptionSDK instance', {
+          network: networkType,
+        });
+        return this.inscriptionSDK;
       } catch (fallbackError) {
-        this.logger.warn(
+        this.logger.error(
           'Failed to create InscriptionSDK fallback instance',
           fallbackError
         );
       }
     }
 
-    return this.inscriptionSDK || null;
+    this.logger.error('failed to setup sdk');
+
+    return null;
   }
 
   /**
@@ -343,6 +362,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;
@@ -384,25 +411,57 @@ export class InscriberBuilder extends BaseServiceBuilder {
         );
       const transactionId = exec?.transactionId || '';
 
+      this.logger.info('inscribeAuto wallet execution', {
+        transactionId,
+        network,
+      });
+
       const shouldWait = options.quoteOnly
         ? false
         : options.waitForConfirmation ?? true;
+      const canonicalTransactionId = toDashedTransactionId(
+        startResponse.tx_id || transactionId
+      );
       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);
 
+        let retrieved: RetrievedInscriptionResult | null = null;
         const sdk = await this.getInscriptionSDK(options);
+
+        console.log('got an SDK', sdk);
+
         if (sdk) {
-          const retrieved: RetrievedInscriptionResult =
-            await sdk.waitForInscription(
-              transactionId,
+          try {
+            retrieved = await sdk.waitForInscription(
+              pollId,
               maxAttempts,
               intervalMs,
-              true
+              true,
+              (progress: RegistrationProgressData) => {
+                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
           );
@@ -412,13 +471,17 @@ 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', resultConfirmed, retrieved);
+          this.logger.debug(
+            'retrieved inscription confirmed',
+            resultConfirmed,
+            retrieved
+          );
           return resultConfirmed;
         }
       }
@@ -427,8 +490,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') ||