@hashgraphonline/standards-sdk 0.1.141 → 0.1.143-feat-adapter-registry.canary.fb173dc.54

package/dist/es/standards-sdk.es132.js

@@ -1,89 +1,250 @@
-import { Logger } from "./standards-sdk.es105.js";
-class ContentResolverRegistryImpl {
-  constructor() {
-    this.resolver = null;
-    this.onUnavailableCallbacks = [];
-    this.logger = Logger.getInstance({ module: "ContentResolverRegistry" });
+import { resolveResponseSchema, registrationQuoteResponseSchema, registerAgentResponseSchema, registrationProgressResponseSchema, uaidValidationResponseSchema, uaidConnectionStatusSchema, dashboardStatsResponseSchema } from "./standards-sdk.es157.js";
+import { RegistryBrokerClient } from "./standards-sdk.es136.js";
+import { serialiseAgentRegistrationRequest, DEFAULT_PROGRESS_INTERVAL_MS, DEFAULT_PROGRESS_TIMEOUT_MS, createAbortError, MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS } from "./standards-sdk.es158.js";
+import { RegistryBrokerError } from "./standards-sdk.es137.js";
+async function performRegisterAgent(client, payload) {
+  const raw = await client.requestJson("/register", {
+    method: "POST",
+    body: serialiseAgentRegistrationRequest(payload),
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    registerAgentResponseSchema,
+    "register agent response"
+  );
+}
+function calculateHbarAmount(creditsToPurchase, creditsPerHbar) {
+  if (creditsPerHbar <= 0) {
+    throw new Error("creditsPerHbar must be positive");
   }
-  static getInstance() {
-    if (!ContentResolverRegistryImpl._instance) {
-      ContentResolverRegistryImpl._instance = new ContentResolverRegistryImpl();
-    }
-    return ContentResolverRegistryImpl._instance;
+  if (creditsToPurchase <= 0) {
+    throw new Error("creditsToPurchase must be positive");
   }
-  /**
-   * Register a content resolver (typically called by ContentStoreManager)
-   */
-  register(resolver) {
-    if (this.resolver) {
-      this.logger.warn("Resolver already registered, replacing existing");
+  const rawHbar = creditsToPurchase / creditsPerHbar;
+  const tinybars = Math.ceil(rawHbar * 1e8);
+  return tinybars / 1e8;
+}
+function resolveCreditsToPurchase(shortfallCredits) {
+  if (!Number.isFinite(shortfallCredits) || shortfallCredits <= 0) {
+    return 0;
+  }
+  return Math.max(
+    Math.ceil(shortfallCredits),
+    MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS
+  );
+}
+async function ensureCreditsForRegistration(client, payload, autoTopUp) {
+  const details = autoTopUp ?? null;
+  if (!details) {
+    return;
+  }
+  if (!details.accountId || !details.accountId.trim()) {
+    throw new Error("autoTopUp.accountId is required");
+  }
+  if (!details.privateKey || !details.privateKey.trim()) {
+    throw new Error("autoTopUp.privateKey is required");
+  }
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const quote = await client.getRegistrationQuote(payload);
+    const shortfall = quote.shortfallCredits ?? 0;
+    if (shortfall <= 0) {
+      return;
+    }
+    const creditsToPurchase = resolveCreditsToPurchase(shortfall);
+    if (creditsToPurchase <= 0) {
+      return;
     }
-    this.resolver = resolver;
-    this.logger.info("Content resolver registered");
+    const creditsPerHbar = quote.creditsPerHbar ?? null;
+    if (!creditsPerHbar || creditsPerHbar <= 0) {
+      throw new Error("Unable to determine credits per HBAR for auto top-up");
+    }
+    const hbarAmount = calculateHbarAmount(creditsToPurchase, creditsPerHbar);
+    await client.purchaseCreditsWithHbar({
+      accountId: details.accountId.trim(),
+      privateKey: details.privateKey.trim(),
+      hbarAmount,
+      memo: details.memo ?? "Registry Broker auto top-up",
+      metadata: {
+        shortfallCredits: shortfall,
+        requiredCredits: quote.requiredCredits,
+        purchasedCredits: creditsToPurchase
+      }
+    });
   }
-  /**
-   * Get the registered content resolver
-   */
-  getResolver() {
-    return this.resolver;
+  const finalQuote = await client.getRegistrationQuote(payload);
+  if ((finalQuote.shortfallCredits ?? 0) > 0) {
+    throw new Error("Unable to purchase sufficient credits for registration");
   }
-  /**
-   * Check if a resolver is available
-   */
-  isAvailable() {
-    return this.resolver !== null;
+}
+RegistryBrokerClient.prototype.resolveUaid = async function(uaid) {
+  const raw = await this.requestJson(
+    `/resolve/${encodeURIComponent(uaid)}`,
+    {
+      method: "GET"
+    }
+  );
+  return this.parseWithSchema(
+    raw,
+    resolveResponseSchema,
+    "resolve UAID response"
+  );
+};
+RegistryBrokerClient.prototype.registerAgent = async function(payload, options) {
+  const autoTopUp = options?.autoTopUp ?? this.registrationAutoTopUp;
+  if (!autoTopUp) {
+    return performRegisterAgent(this, payload);
   }
-  /**
-   * Unregister the current resolver
-   */
-  unregister() {
-    if (this.resolver) {
-      this.resolver = null;
-      this.logger.info("Content resolver unregistered");
-      this.onUnavailableCallbacks.forEach((callback) => {
-        try {
-          callback();
-        } catch (error) {
-          this.logger.error("Error in unavailable callback:", error);
-        }
-      });
+  await ensureCreditsForRegistration(this, payload, autoTopUp);
+  let retried = false;
+  while (true) {
+    try {
+      return await performRegisterAgent(this, payload);
+    } catch (error) {
+      const shortfall = this.extractInsufficientCreditsDetails(error);
+      if (shortfall && !retried) {
+        await ensureCreditsForRegistration(this, payload, autoTopUp);
+        retried = true;
+        continue;
+      }
+      throw error;
     }
   }
-  /**
-   * Register callback for when resolver becomes unavailable
-   */
-  onUnavailable(callback) {
-    this.onUnavailableCallbacks.push(callback);
+};
+RegistryBrokerClient.prototype.getRegistrationQuote = async function(payload) {
+  const raw = await this.requestJson("/register/quote", {
+    method: "POST",
+    body: serialiseAgentRegistrationRequest(payload),
+    headers: { "content-type": "application/json" }
+  });
+  return this.parseWithSchema(
+    raw,
+    registrationQuoteResponseSchema,
+    "registration quote response"
+  );
+};
+RegistryBrokerClient.prototype.updateAgent = async function(uaid, payload) {
+  const raw = await this.requestJson(
+    `/register/${encodeURIComponent(uaid)}`,
+    {
+      method: "PUT",
+      body: serialiseAgentRegistrationRequest(payload),
+      headers: { "content-type": "application/json" }
+    }
+  );
+  return this.parseWithSchema(
+    raw,
+    registerAgentResponseSchema,
+    "update agent response"
+  );
+};
+RegistryBrokerClient.prototype.getRegistrationProgress = async function(attemptId) {
+  const normalisedAttemptId = attemptId.trim();
+  if (!normalisedAttemptId) {
+    throw new Error("attemptId is required");
   }
-  /**
-   * Remove unavailable callback
-   */
-  offUnavailable(callback) {
-    const index = this.onUnavailableCallbacks.indexOf(callback);
-    if (index !== -1) {
-      this.onUnavailableCallbacks.splice(index, 1);
+  try {
+    const raw = await this.requestJson(
+      `/register/progress/${encodeURIComponent(normalisedAttemptId)}`,
+      { method: "GET" }
+    );
+    const parsed = this.parseWithSchema(
+      raw,
+      registrationProgressResponseSchema,
+      "registration progress response"
+    );
+    return parsed.progress;
+  } catch (error) {
+    if (error instanceof RegistryBrokerError && error.status === 404) {
+      return null;
     }
+    throw error;
+  }
+};
+RegistryBrokerClient.prototype.waitForRegistrationCompletion = async function(attemptId, options = {}) {
+  const normalisedAttemptId = attemptId.trim();
+  if (!normalisedAttemptId) {
+    throw new Error("attemptId is required");
   }
-  /**
-   * Execute operation with resolver or fallback
-   */
-  async withResolver(operation, fallback) {
-    if (this.resolver) {
-      try {
-        return await operation(this.resolver);
-      } catch (error) {
-        this.logger.warn("Resolver operation failed, using fallback:", error);
-        return await fallback();
+  const interval = Math.max(
+    250,
+    options.intervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS
+  );
+  const timeoutMs = options.timeoutMs ?? DEFAULT_PROGRESS_TIMEOUT_MS;
+  const throwOnFailure = options.throwOnFailure ?? true;
+  const signal = options.signal;
+  const startedAt = Date.now();
+  while (true) {
+    if (signal?.aborted) {
+      throw createAbortError();
+    }
+    const progress = await this.getRegistrationProgress(normalisedAttemptId);
+    if (progress) {
+      options.onProgress?.(progress);
+      if (progress.status === "completed") {
+        return progress;
+      }
+      if (progress.status === "partial" || progress.status === "failed") {
+        if (throwOnFailure) {
+          throw new RegistryBrokerError(
+            "Registration did not complete successfully",
+            {
+              status: 409,
+              statusText: progress.status,
+              body: progress
+            }
+          );
+        }
+        return progress;
       }
-    } else {
-      this.logger.warn("No resolver available, using fallback");
-      return await fallback();
     }
+    if (Date.now() - startedAt >= timeoutMs) {
+      throw new Error(
+        `Registration progress polling timed out after ${timeoutMs}ms`
+      );
+    }
+    await this.delay(interval, signal);
   }
-}
-const ContentResolverRegistry = ContentResolverRegistryImpl.getInstance();
-export {
-  ContentResolverRegistry,
-  ContentResolverRegistryImpl
+};
+RegistryBrokerClient.prototype.validateUaid = async function(uaid) {
+  const raw = await this.requestJson(
+    `/uaids/validate/${encodeURIComponent(uaid)}`,
+    {
+      method: "GET"
+    }
+  );
+  return this.parseWithSchema(
+    raw,
+    uaidValidationResponseSchema,
+    "UAID validation response"
+  );
+};
+RegistryBrokerClient.prototype.getUaidConnectionStatus = async function(uaid) {
+  const raw = await this.requestJson(
+    `/uaids/connections/${encodeURIComponent(uaid)}/status`,
+    {
+      method: "GET"
+    }
+  );
+  return this.parseWithSchema(
+    raw,
+    uaidConnectionStatusSchema,
+    "UAID connection status"
+  );
+};
+RegistryBrokerClient.prototype.closeUaidConnection = async function(uaid) {
+  await this.request(`/uaids/connections/${encodeURIComponent(uaid)}`, {
+    method: "DELETE"
+  });
+};
+RegistryBrokerClient.prototype.dashboardStats = async function() {
+  const raw = await this.requestJson("/dashboard/stats", {
+    method: "GET"
+  });
+  return this.parseWithSchema(
+    raw,
+    dashboardStatsResponseSchema,
+    "dashboard stats response"
+  );
 };
 //# sourceMappingURL=standards-sdk.es132.js.map

package/dist/es/standards-sdk.es132.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es132.js","sources":["../../src/content-store/ContentResolverRegistry.ts"],"sourcesContent":["/**\n * Content Resolver Registry\n *\n * Dependency injection registry for content resolvers.\n * Allows tools to access content resolution without circular dependencies.\n */\n\nimport type { ContentResolverInterface } from './types';\nimport { Logger } from '../utils/logger';\n\nexport class ContentResolverRegistryImpl {\n  private static _instance: ContentResolverRegistryImpl;\n  private resolver: ContentResolverInterface | null = null;\n  private onUnavailableCallbacks: (() => void)[] = [];\n  private logger = Logger.getInstance({ module: 'ContentResolverRegistry' });\n\n  static getInstance(): ContentResolverRegistryImpl {\n    if (!ContentResolverRegistryImpl._instance) {\n      ContentResolverRegistryImpl._instance = new ContentResolverRegistryImpl();\n    }\n    return ContentResolverRegistryImpl._instance;\n  }\n\n  /**\n   * Register a content resolver (typically called by ContentStoreManager)\n   */\n  register(resolver: ContentResolverInterface): void {\n    if (this.resolver) {\n      this.logger.warn('Resolver already registered, replacing existing');\n    }\n    this.resolver = resolver;\n    this.logger.info('Content resolver registered');\n  }\n\n  /**\n   * Get the registered content resolver\n   */\n  getResolver(): ContentResolverInterface | null {\n    return this.resolver;\n  }\n\n  /**\n   * Check if a resolver is available\n   */\n  isAvailable(): boolean {\n    return this.resolver !== null;\n  }\n\n  /**\n   * Unregister the current resolver\n   */\n  unregister(): void {\n    if (this.resolver) {\n      this.resolver = null;\n      this.logger.info('Content resolver unregistered');\n      this.onUnavailableCallbacks.forEach(callback => {\n        try {\n          callback();\n        } catch (error) {\n          this.logger.error('Error in unavailable callback:', error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register callback for when resolver becomes unavailable\n   */\n  onUnavailable(callback: () => void): void {\n    this.onUnavailableCallbacks.push(callback);\n  }\n\n  /**\n   * Remove unavailable callback\n   */\n  offUnavailable(callback: () => void): void {\n    const index = this.onUnavailableCallbacks.indexOf(callback);\n    if (index !== -1) {\n      this.onUnavailableCallbacks.splice(index, 1);\n    }\n  }\n\n  /**\n   * Execute operation with resolver or fallback\n   */\n  async withResolver<T>(\n    operation: (resolver: ContentResolverInterface) => Promise<T>,\n    fallback: () => Promise<T>,\n  ): Promise<T> {\n    if (this.resolver) {\n      try {\n        return await operation(this.resolver);\n      } catch (error) {\n        this.logger.warn('Resolver operation failed, using fallback:', error);\n        return await fallback();\n      }\n    } else {\n      this.logger.warn('No resolver available, using fallback');\n      return await fallback();\n    }\n  }\n}\n\nexport const ContentResolverRegistry =\n  ContentResolverRegistryImpl.getInstance();\n"],"names":[],"mappings":";AAUO,MAAM,4BAA4B;AAAA,EAAlC,cAAA;AAEL,SAAQ,WAA4C;AACpD,SAAQ,yBAAyC,CAAA;AACjD,SAAQ,SAAS,OAAO,YAAY,EAAE,QAAQ,2BAA2B;AAAA,EAAA;AAAA,EAEzE,OAAO,cAA2C;AAChD,QAAI,CAAC,4BAA4B,WAAW;AAC1C,kCAA4B,YAAY,IAAI,4BAAA;AAAA,IAC9C;AACA,WAAO,4BAA4B;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,UAA0C;AACjD,QAAI,KAAK,UAAU;AACjB,WAAK,OAAO,KAAK,iDAAiD;AAAA,IACpE;AACA,SAAK,WAAW;AAChB,SAAK,OAAO,KAAK,6BAA6B;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,cAA+C;AAC7C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,aAAa;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,QAAI,KAAK,UAAU;AACjB,WAAK,WAAW;AAChB,WAAK,OAAO,KAAK,+BAA+B;AAChD,WAAK,uBAAuB,QAAQ,CAAA,aAAY;AAC9C,YAAI;AACF,mBAAA;AAAA,QACF,SAAS,OAAO;AACd,eAAK,OAAO,MAAM,kCAAkC,KAAK;AAAA,QAC3D;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,UAA4B;AACxC,SAAK,uBAAuB,KAAK,QAAQ;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,UAA4B;AACzC,UAAM,QAAQ,KAAK,uBAAuB,QAAQ,QAAQ;AAC1D,QAAI,UAAU,IAAI;AAChB,WAAK,uBAAuB,OAAO,OAAO,CAAC;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aACJ,WACA,UACY;AACZ,QAAI,KAAK,UAAU;AACjB,UAAI;AACF,eAAO,MAAM,UAAU,KAAK,QAAQ;AAAA,MACtC,SAAS,OAAO;AACd,aAAK,OAAO,KAAK,8CAA8C,KAAK;AACpE,eAAO,MAAM,SAAA;AAAA,MACf;AAAA,IACF,OAAO;AACL,WAAK,OAAO,KAAK,uCAAuC;AACxD,aAAO,MAAM,SAAA;AAAA,IACf;AAAA,EACF;AACF;AAEO,MAAM,0BACX,4BAA4B,YAAA;"}
+{"version":3,"file":"standards-sdk.es132.js","sources":["../../src/services/registry-broker/client/agents.ts"],"sourcesContent":["import type {\n  AgentRegistrationRequest,\n  DashboardStatsResponse,\n  JsonValue,\n  RegisterAgentOptions,\n  RegisterAgentQuoteResponse,\n  RegisterAgentResponse,\n  RegistrationProgressRecord,\n  RegistrationProgressWaitOptions,\n  ResolvedAgentResponse,\n  UaidConnectionStatus,\n  UaidValidationResponse,\n} from '../types';\nimport {\n  dashboardStatsResponseSchema,\n  registerAgentResponseSchema,\n  registrationProgressResponseSchema,\n  registrationQuoteResponseSchema,\n  resolveResponseSchema,\n  uaidConnectionStatusSchema,\n  uaidValidationResponseSchema,\n} from '../schemas';\nimport { RegistryBrokerClient } from './base-client';\nimport {\n  createAbortError,\n  DEFAULT_PROGRESS_INTERVAL_MS,\n  DEFAULT_PROGRESS_TIMEOUT_MS,\n  MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS,\n  serialiseAgentRegistrationRequest,\n} from './utils';\nimport { RegistryBrokerError } from './errors';\n\ndeclare module './base-client' {\n  interface RegistryBrokerClient {\n    resolveUaid(uaid: string): Promise<ResolvedAgentResponse>;\n    registerAgent(\n      payload: AgentRegistrationRequest,\n      options?: RegisterAgentOptions,\n    ): Promise<RegisterAgentResponse>;\n    getRegistrationQuote(\n      payload: AgentRegistrationRequest,\n    ): Promise<RegisterAgentQuoteResponse>;\n    updateAgent(\n      uaid: string,\n      payload: AgentRegistrationRequest,\n    ): Promise<RegisterAgentResponse>;\n    getRegistrationProgress(\n      attemptId: string,\n    ): Promise<RegistrationProgressRecord | null>;\n    waitForRegistrationCompletion(\n      attemptId: string,\n      options?: RegistrationProgressWaitOptions,\n    ): Promise<RegistrationProgressRecord>;\n    validateUaid(uaid: string): Promise<UaidValidationResponse>;\n    getUaidConnectionStatus(uaid: string): Promise<UaidConnectionStatus>;\n    closeUaidConnection(uaid: string): Promise<void>;\n    dashboardStats(): Promise<DashboardStatsResponse>;\n  }\n}\n\nasync function performRegisterAgent(\n  client: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n): Promise<RegisterAgentResponse> {\n  const raw = await client.requestJson<JsonValue>('/register', {\n    method: 'POST',\n    body: serialiseAgentRegistrationRequest(payload),\n    headers: { 'content-type': 'application/json' },\n  });\n  return client.parseWithSchema(\n    raw,\n    registerAgentResponseSchema,\n    'register agent response',\n  );\n}\n\nfunction calculateHbarAmount(\n  creditsToPurchase: number,\n  creditsPerHbar: number,\n): number {\n  if (creditsPerHbar <= 0) {\n    throw new Error('creditsPerHbar must be positive');\n  }\n  if (creditsToPurchase <= 0) {\n    throw new Error('creditsToPurchase must be positive');\n  }\n  const rawHbar = creditsToPurchase / creditsPerHbar;\n  const tinybars = Math.ceil(rawHbar * 1e8);\n  return tinybars / 1e8;\n}\n\nfunction resolveCreditsToPurchase(shortfallCredits: number): number {\n  if (!Number.isFinite(shortfallCredits) || shortfallCredits <= 0) {\n    return 0;\n  }\n  return Math.max(\n    Math.ceil(shortfallCredits),\n    MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS,\n  );\n}\n\nasync function ensureCreditsForRegistration(\n  client: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n  autoTopUp: RegisterAgentOptions['autoTopUp'],\n): Promise<void> {\n  const details = autoTopUp ?? null;\n  if (!details) {\n    return;\n  }\n\n  if (!details.accountId || !details.accountId.trim()) {\n    throw new Error('autoTopUp.accountId is required');\n  }\n\n  if (!details.privateKey || !details.privateKey.trim()) {\n    throw new Error('autoTopUp.privateKey is required');\n  }\n\n  for (let attempt = 0; attempt < 3; attempt += 1) {\n    const quote = await client.getRegistrationQuote(payload);\n    const shortfall = quote.shortfallCredits ?? 0;\n    if (shortfall <= 0) {\n      return;\n    }\n    const creditsToPurchase = resolveCreditsToPurchase(shortfall);\n    if (creditsToPurchase <= 0) {\n      return;\n    }\n\n    const creditsPerHbar = quote.creditsPerHbar ?? null;\n    if (!creditsPerHbar || creditsPerHbar <= 0) {\n      throw new Error('Unable to determine credits per HBAR for auto top-up');\n    }\n\n    const hbarAmount = calculateHbarAmount(creditsToPurchase, creditsPerHbar);\n\n    await client.purchaseCreditsWithHbar({\n      accountId: details.accountId.trim(),\n      privateKey: details.privateKey.trim(),\n      hbarAmount,\n      memo: details.memo ?? 'Registry Broker auto top-up',\n      metadata: {\n        shortfallCredits: shortfall,\n        requiredCredits: quote.requiredCredits,\n        purchasedCredits: creditsToPurchase,\n      },\n    });\n  }\n\n  const finalQuote = await client.getRegistrationQuote(payload);\n  if ((finalQuote.shortfallCredits ?? 0) > 0) {\n    throw new Error('Unable to purchase sufficient credits for registration');\n  }\n}\n\nRegistryBrokerClient.prototype.resolveUaid = async function (\n  this: RegistryBrokerClient,\n  uaid: string,\n): Promise<ResolvedAgentResponse> {\n  const raw = await this.requestJson<JsonValue>(\n    `/resolve/${encodeURIComponent(uaid)}`,\n    {\n      method: 'GET',\n    },\n  );\n  return this.parseWithSchema(\n    raw,\n    resolveResponseSchema,\n    'resolve UAID response',\n  );\n};\n\nRegistryBrokerClient.prototype.registerAgent = async function (\n  this: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n  options?: RegisterAgentOptions,\n): Promise<RegisterAgentResponse> {\n  const autoTopUp = options?.autoTopUp ?? this.registrationAutoTopUp;\n\n  if (!autoTopUp) {\n    return performRegisterAgent(this, payload);\n  }\n\n  await ensureCreditsForRegistration(this, payload, autoTopUp);\n\n  let retried = false;\n  while (true) {\n    try {\n      return await performRegisterAgent(this, payload);\n    } catch (error) {\n      const shortfall = this.extractInsufficientCreditsDetails(error);\n      if (shortfall && !retried) {\n        await ensureCreditsForRegistration(this, payload, autoTopUp);\n        retried = true;\n        continue;\n      }\n      throw error;\n    }\n  }\n};\n\nRegistryBrokerClient.prototype.getRegistrationQuote = async function (\n  this: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n): Promise<RegisterAgentQuoteResponse> {\n  const raw = await this.requestJson<JsonValue>('/register/quote', {\n    method: 'POST',\n    body: serialiseAgentRegistrationRequest(payload),\n    headers: { 'content-type': 'application/json' },\n  });\n\n  return this.parseWithSchema(\n    raw,\n    registrationQuoteResponseSchema,\n    'registration quote response',\n  );\n};\n\nRegistryBrokerClient.prototype.updateAgent = async function (\n  this: RegistryBrokerClient,\n  uaid: string,\n  payload: AgentRegistrationRequest,\n): Promise<RegisterAgentResponse> {\n  const raw = await this.requestJson<JsonValue>(\n    `/register/${encodeURIComponent(uaid)}`,\n    {\n      method: 'PUT',\n      body: serialiseAgentRegistrationRequest(payload),\n      headers: { 'content-type': 'application/json' },\n    },\n  );\n\n  return this.parseWithSchema(\n    raw,\n    registerAgentResponseSchema,\n    'update agent response',\n  );\n};\n\nRegistryBrokerClient.prototype.getRegistrationProgress = async function (\n  this: RegistryBrokerClient,\n  attemptId: string,\n): Promise<RegistrationProgressRecord | null> {\n  const normalisedAttemptId = attemptId.trim();\n  if (!normalisedAttemptId) {\n    throw new Error('attemptId is required');\n  }\n\n  try {\n    const raw = await this.requestJson<JsonValue>(\n      `/register/progress/${encodeURIComponent(normalisedAttemptId)}`,\n      { method: 'GET' },\n    );\n\n    const parsed = this.parseWithSchema(\n      raw,\n      registrationProgressResponseSchema,\n      'registration progress response',\n    );\n\n    return parsed.progress;\n  } catch (error) {\n    if (error instanceof RegistryBrokerError && error.status === 404) {\n      return null;\n    }\n    throw error;\n  }\n};\n\nRegistryBrokerClient.prototype.waitForRegistrationCompletion = async function (\n  this: RegistryBrokerClient,\n  attemptId: string,\n  options: RegistrationProgressWaitOptions = {},\n): Promise<RegistrationProgressRecord> {\n  const normalisedAttemptId = attemptId.trim();\n  if (!normalisedAttemptId) {\n    throw new Error('attemptId is required');\n  }\n\n  const interval = Math.max(\n    250,\n    options.intervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS,\n  );\n  const timeoutMs = options.timeoutMs ?? DEFAULT_PROGRESS_TIMEOUT_MS;\n  const throwOnFailure = options.throwOnFailure ?? true;\n  const signal = options.signal;\n  const startedAt = Date.now();\n\n  while (true) {\n    if (signal?.aborted) {\n      throw createAbortError();\n    }\n\n    const progress = await this.getRegistrationProgress(normalisedAttemptId);\n\n    if (progress) {\n      options.onProgress?.(progress);\n\n      if (progress.status === 'completed') {\n        return progress;\n      }\n\n      if (progress.status === 'partial' || progress.status === 'failed') {\n        if (throwOnFailure) {\n          throw new RegistryBrokerError(\n            'Registration did not complete successfully',\n            {\n              status: 409,\n              statusText: progress.status,\n              body: progress,\n            },\n          );\n        }\n        return progress;\n      }\n    }\n\n    if (Date.now() - startedAt >= timeoutMs) {\n      throw new Error(\n        `Registration progress polling timed out after ${timeoutMs}ms`,\n      );\n    }\n\n    await this.delay(interval, signal);\n  }\n};\n\nRegistryBrokerClient.prototype.validateUaid = async function (\n  this: RegistryBrokerClient,\n  uaid: string,\n): Promise<UaidValidationResponse> {\n  const raw = await this.requestJson<JsonValue>(\n    `/uaids/validate/${encodeURIComponent(uaid)}`,\n    {\n      method: 'GET',\n    },\n  );\n  return this.parseWithSchema(\n    raw,\n    uaidValidationResponseSchema,\n    'UAID validation response',\n  );\n};\n\nRegistryBrokerClient.prototype.getUaidConnectionStatus = async function (\n  this: RegistryBrokerClient,\n  uaid: string,\n): Promise<UaidConnectionStatus> {\n  const raw = await this.requestJson<JsonValue>(\n    `/uaids/connections/${encodeURIComponent(uaid)}/status`,\n    {\n      method: 'GET',\n    },\n  );\n  return this.parseWithSchema(\n    raw,\n    uaidConnectionStatusSchema,\n    'UAID connection status',\n  );\n};\n\nRegistryBrokerClient.prototype.closeUaidConnection = async function (\n  this: RegistryBrokerClient,\n  uaid: string,\n): Promise<void> {\n  await this.request(`/uaids/connections/${encodeURIComponent(uaid)}`, {\n    method: 'DELETE',\n  });\n};\n\nRegistryBrokerClient.prototype.dashboardStats = async function (\n  this: RegistryBrokerClient,\n): Promise<DashboardStatsResponse> {\n  const raw = await this.requestJson<JsonValue>('/dashboard/stats', {\n    method: 'GET',\n  });\n  return this.parseWithSchema(\n    raw,\n    dashboardStatsResponseSchema,\n    'dashboard stats response',\n  );\n};\n"],"names":[],"mappings":";;;;AA4DA,eAAe,qBACb,QACA,SACgC;AAChC,QAAM,MAAM,MAAM,OAAO,YAAuB,aAAa;AAAA,IAC3D,QAAQ;AAAA,IACR,MAAM,kCAAkC,OAAO;AAAA,IAC/C,SAAS,EAAE,gBAAgB,mBAAA;AAAA,EAAmB,CAC/C;AACD,SAAO,OAAO;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,SAAS,oBACP,mBACA,gBACQ;AACR,MAAI,kBAAkB,GAAG;AACvB,UAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AACA,MAAI,qBAAqB,GAAG;AAC1B,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AACA,QAAM,UAAU,oBAAoB;AACpC,QAAM,WAAW,KAAK,KAAK,UAAU,GAAG;AACxC,SAAO,WAAW;AACpB;AAEA,SAAS,yBAAyB,kBAAkC;AAClE,MAAI,CAAC,OAAO,SAAS,gBAAgB,KAAK,oBAAoB,GAAG;AAC/D,WAAO;AAAA,EACT;AACA,SAAO,KAAK;AAAA,IACV,KAAK,KAAK,gBAAgB;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAEA,eAAe,6BACb,QACA,SACA,WACe;AACf,QAAM,UAAU,aAAa;AAC7B,MAAI,CAAC,SAAS;AACZ;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,aAAa,CAAC,QAAQ,UAAU,QAAQ;AACnD,UAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AAEA,MAAI,CAAC,QAAQ,cAAc,CAAC,QAAQ,WAAW,QAAQ;AACrD,UAAM,IAAI,MAAM,kCAAkC;AAAA,EACpD;AAEA,WAAS,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG;AAC/C,UAAM,QAAQ,MAAM,OAAO,qBAAqB,OAAO;AACvD,UAAM,YAAY,MAAM,oBAAoB;AAC5C,QAAI,aAAa,GAAG;AAClB;AAAA,IACF;AACA,UAAM,oBAAoB,yBAAyB,SAAS;AAC5D,QAAI,qBAAqB,GAAG;AAC1B;AAAA,IACF;AAEA,UAAM,iBAAiB,MAAM,kBAAkB;AAC/C,QAAI,CAAC,kBAAkB,kBAAkB,GAAG;AAC1C,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AAEA,UAAM,aAAa,oBAAoB,mBAAmB,cAAc;AAExE,UAAM,OAAO,wBAAwB;AAAA,MACnC,WAAW,QAAQ,UAAU,KAAA;AAAA,MAC7B,YAAY,QAAQ,WAAW,KAAA;AAAA,MAC/B;AAAA,MACA,MAAM,QAAQ,QAAQ;AAAA,MACtB,UAAU;AAAA,QACR,kBAAkB;AAAA,QAClB,iBAAiB,MAAM;AAAA,QACvB,kBAAkB;AAAA,MAAA;AAAA,IACpB,CACD;AAAA,EACH;AAEA,QAAM,aAAa,MAAM,OAAO,qBAAqB,OAAO;AAC5D,OAAK,WAAW,oBAAoB,KAAK,GAAG;AAC1C,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AACF;AAEA,qBAAqB,UAAU,cAAc,eAE3C,MACgC;AAChC,QAAM,MAAM,MAAM,KAAK;AAAA,IACrB,YAAY,mBAAmB,IAAI,CAAC;AAAA,IACpC;AAAA,MACE,QAAQ;AAAA,IAAA;AAAA,EACV;AAEF,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,gBAAgB,eAE7C,SACA,SACgC;AAChC,QAAM,YAAY,SAAS,aAAa,KAAK;AAE7C,MAAI,CAAC,WAAW;AACd,WAAO,qBAAqB,MAAM,OAAO;AAAA,EAC3C;AAEA,QAAM,6BAA6B,MAAM,SAAS,SAAS;AAE3D,MAAI,UAAU;AACd,SAAO,MAAM;AACX,QAAI;AACF,aAAO,MAAM,qBAAqB,MAAM,OAAO;AAAA,IACjD,SAAS,OAAO;AACd,YAAM,YAAY,KAAK,kCAAkC,KAAK;AAC9D,UAAI,aAAa,CAAC,SAAS;AACzB,cAAM,6BAA6B,MAAM,SAAS,SAAS;AAC3D,kBAAU;AACV;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEA,qBAAqB,UAAU,uBAAuB,eAEpD,SACqC;AACrC,QAAM,MAAM,MAAM,KAAK,YAAuB,mBAAmB;AAAA,IAC/D,QAAQ;AAAA,IACR,MAAM,kCAAkC,OAAO;AAAA,IAC/C,SAAS,EAAE,gBAAgB,mBAAA;AAAA,EAAmB,CAC/C;AAED,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,cAAc,eAE3C,MACA,SACgC;AAChC,QAAM,MAAM,MAAM,KAAK;AAAA,IACrB,aAAa,mBAAmB,IAAI,CAAC;AAAA,IACrC;AAAA,MACE,QAAQ;AAAA,MACR,MAAM,kCAAkC,OAAO;AAAA,MAC/C,SAAS,EAAE,gBAAgB,mBAAA;AAAA,IAAmB;AAAA,EAChD;AAGF,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,0BAA0B,eAEvD,WAC4C;AAC5C,QAAM,sBAAsB,UAAU,KAAA;AACtC,MAAI,CAAC,qBAAqB;AACxB,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,MAAI;AACF,UAAM,MAAM,MAAM,KAAK;AAAA,MACrB,sBAAsB,mBAAmB,mBAAmB,CAAC;AAAA,MAC7D,EAAE,QAAQ,MAAA;AAAA,IAAM;AAGlB,UAAM,SAAS,KAAK;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,WAAO,OAAO;AAAA,EAChB,SAAS,OAAO;AACd,QAAI,iBAAiB,uBAAuB,MAAM,WAAW,KAAK;AAChE,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEA,qBAAqB,UAAU,gCAAgC,eAE7D,WACA,UAA2C,CAAA,GACN;AACrC,QAAM,sBAAsB,UAAU,KAAA;AACtC,MAAI,CAAC,qBAAqB;AACxB,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,QAAM,WAAW,KAAK;AAAA,IACpB;AAAA,IACA,QAAQ,cAAc;AAAA,EAAA;AAExB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,iBAAiB,QAAQ,kBAAkB;AACjD,QAAM,SAAS,QAAQ;AACvB,QAAM,YAAY,KAAK,IAAA;AAEvB,SAAO,MAAM;AACX,QAAI,QAAQ,SAAS;AACnB,YAAM,iBAAA;AAAA,IACR;AAEA,UAAM,WAAW,MAAM,KAAK,wBAAwB,mBAAmB;AAEvE,QAAI,UAAU;AACZ,cAAQ,aAAa,QAAQ;AAE7B,UAAI,SAAS,WAAW,aAAa;AACnC,eAAO;AAAA,MACT;AAEA,UAAI,SAAS,WAAW,aAAa,SAAS,WAAW,UAAU;AACjE,YAAI,gBAAgB;AAClB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,cACE,QAAQ;AAAA,cACR,YAAY,SAAS;AAAA,cACrB,MAAM;AAAA,YAAA;AAAA,UACR;AAAA,QAEJ;AACA,eAAO;AAAA,MACT;AAAA,IACF;AAEA,QAAI,KAAK,QAAQ,aAAa,WAAW;AACvC,YAAM,IAAI;AAAA,QACR,iDAAiD,SAAS;AAAA,MAAA;AAAA,IAE9D;AAEA,UAAM,KAAK,MAAM,UAAU,MAAM;AAAA,EACnC;AACF;AAEA,qBAAqB,UAAU,eAAe,eAE5C,MACiC;AACjC,QAAM,MAAM,MAAM,KAAK;AAAA,IACrB,mBAAmB,mBAAmB,IAAI,CAAC;AAAA,IAC3C;AAAA,MACE,QAAQ;AAAA,IAAA;AAAA,EACV;AAEF,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,0BAA0B,eAEvD,MAC+B;AAC/B,QAAM,MAAM,MAAM,KAAK;AAAA,IACrB,sBAAsB,mBAAmB,IAAI,CAAC;AAAA,IAC9C;AAAA,MACE,QAAQ;AAAA,IAAA;AAAA,EACV;AAEF,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,sBAAsB,eAEnD,MACe;AACf,QAAM,KAAK,QAAQ,sBAAsB,mBAAmB,IAAI,CAAC,IAAI;AAAA,IACnE,QAAQ;AAAA,EAAA,CACT;AACH;AAEA,qBAAqB,UAAU,iBAAiB,iBAEb;AACjC,QAAM,MAAM,MAAM,KAAK,YAAuB,oBAAoB;AAAA,IAChE,QAAQ;AAAA,EAAA,CACT;AACD,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/es/standards-sdk.es133.js

@@ -1,68 +1,183 @@
-import { Logger } from "./standards-sdk.es105.js";
-const REFERENCE_THRESHOLD = 50 * 1024;
-class ContentStoreServiceImpl {
-  constructor() {
-    this.contentStore = null;
-    this.logger = Logger.getInstance({ module: "ContentStoreService" });
+import { Buffer } from "node:buffer";
+import { ledgerChallengeResponseSchema, ledgerVerifyResponseSchema } from "./standards-sdk.es157.js";
+import { canonicalizeLedgerNetwork } from "./standards-sdk.es139.js";
+import { createPrivateKeySigner } from "./standards-sdk.es138.js";
+import { RegistryBrokerClient } from "./standards-sdk.es136.js";
+async function loadViemAccount(privateKey) {
+  try {
+    const viem = await import("viem/accounts");
+    return viem.privateKeyToAccount(privateKey);
+  } catch (error) {
+    const err = new Error(
+      'EVM ledger authentication requires the optional dependency "viem". Install it to use evmPrivateKey flows.'
+    );
+    err.cause = error;
+    throw err;
   }
-  static getInstance() {
-    if (!ContentStoreServiceImpl._instance) {
-      ContentStoreServiceImpl._instance = new ContentStoreServiceImpl();
+}
+async function resolveLedgerAuthSignature(message, options) {
+  if (typeof options.sign === "function") {
+    const result = await options.sign(message);
+    if (!result || typeof result.signature !== "string" || result.signature.length === 0) {
+      throw new Error("Custom ledger signer failed to produce a signature.");
     }
-    return ContentStoreServiceImpl._instance;
+    return result;
+  }
+  if (!options.signer || typeof options.signer.sign !== "function") {
+    throw new Error(
+      "Ledger authentication requires a Hedera Signer or custom sign function."
+    );
   }
-  /**
-   * Set the content store instance
-   */
-  async setInstance(store) {
-    if (this.contentStore) {
-      this.logger.warn("Content store already set, replacing");
+  const payload = Buffer.from(message, "utf8");
+  const signatures = await options.signer.sign([payload]);
+  const signatureEntry = signatures?.[0];
+  if (!signatureEntry) {
+    throw new Error("Signer did not return any signatures.");
+  }
+  let derivedPublicKey;
+  if (signatureEntry.publicKey) {
+    derivedPublicKey = signatureEntry.publicKey.toString();
+  } else if (typeof options.signer.getAccountKey === "function") {
+    const accountKey = await options.signer.getAccountKey();
+    if (accountKey && typeof accountKey.toString === "function") {
+      derivedPublicKey = accountKey.toString();
     }
-    this.contentStore = store;
-    this.logger.info("Content store instance set");
   }
-  /**
-   * Get the content store instance
-   */
-  getInstance() {
-    return this.contentStore;
+  return {
+    signature: Buffer.from(signatureEntry.signature).toString("base64"),
+    signatureKind: "raw",
+    publicKey: derivedPublicKey
+  };
+}
+RegistryBrokerClient.prototype.createLedgerChallenge = async function(payload) {
+  const resolvedNetwork = canonicalizeLedgerNetwork(payload.network);
+  const network = resolvedNetwork.kind === "hedera" ? resolvedNetwork.hederaNetwork ?? resolvedNetwork.canonical : resolvedNetwork.canonical;
+  const raw = await this.requestJson("/auth/ledger/challenge", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: {
+      accountId: payload.accountId,
+      network
+    }
+  });
+  return this.parseWithSchema(
+    raw,
+    ledgerChallengeResponseSchema,
+    "ledger challenge response"
+  );
+};
+RegistryBrokerClient.prototype.verifyLedgerChallenge = async function(payload) {
+  const resolvedNetwork = canonicalizeLedgerNetwork(payload.network);
+  const network = resolvedNetwork.kind === "hedera" ? resolvedNetwork.hederaNetwork ?? resolvedNetwork.canonical : resolvedNetwork.canonical;
+  const body = {
+    challengeId: payload.challengeId,
+    accountId: payload.accountId,
+    network,
+    signature: payload.signature
+  };
+  if (payload.signatureKind) {
+    body.signatureKind = payload.signatureKind;
   }
-  /**
-   * Clear the content store instance
-   */
-  dispose() {
-    this.contentStore = null;
-    this.logger.info("Content store disposed");
+  if (payload.publicKey) {
+    body.publicKey = payload.publicKey;
   }
-  /**
-   * Check if content store is available
-   */
-  isAvailable() {
-    return this.contentStore !== null;
+  if (typeof payload.expiresInMinutes === "number") {
+    body.expiresInMinutes = payload.expiresInMinutes;
   }
-}
-function extractReferenceId(input) {
-  const trimmed = input.trim();
-  const exactMatch = trimmed.match(/^content-ref:([a-f0-9]+)$/);
-  if (exactMatch) {
-    return exactMatch[1];
+  const raw = await this.requestJson("/auth/ledger/verify", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body
+  });
+  const result = this.parseWithSchema(
+    raw,
+    ledgerVerifyResponseSchema,
+    "ledger verification response"
+  );
+  this.setLedgerApiKey(result.key);
+  return result;
+};
+RegistryBrokerClient.prototype.authenticateWithLedger = async function(options) {
+  const challenge = await this.createLedgerChallenge({
+    accountId: options.accountId,
+    network: options.network
+  });
+  const signed = await resolveLedgerAuthSignature(challenge.message, options);
+  const verification = await this.verifyLedgerChallenge({
+    challengeId: challenge.challengeId,
+    accountId: options.accountId,
+    network: options.network,
+    signature: signed.signature,
+    signatureKind: signed.signatureKind,
+    publicKey: signed.publicKey,
+    expiresInMinutes: options.expiresInMinutes
+  });
+  return verification;
+};
+RegistryBrokerClient.prototype.authenticateWithLedgerCredentials = async function(options) {
+  const {
+    accountId,
+    network,
+    signer,
+    sign,
+    hederaPrivateKey,
+    evmPrivateKey,
+    expiresInMinutes,
+    setAccountHeader = true,
+    label,
+    logger
+  } = options;
+  const resolvedNetwork = canonicalizeLedgerNetwork(network);
+  const labelSuffix = label ? ` for ${label}` : "";
+  const networkPayload = resolvedNetwork.canonical;
+  const authOptions = {
+    accountId,
+    network: networkPayload,
+    expiresInMinutes
+  };
+  if (sign) {
+    authOptions.sign = sign;
+  } else if (signer) {
+    authOptions.signer = signer;
+  } else if (hederaPrivateKey) {
+    if (resolvedNetwork.kind !== "hedera" || !resolvedNetwork.hederaNetwork) {
+      throw new Error(
+        "hederaPrivateKey can only be used with hedera:mainnet or hedera:testnet networks."
+      );
+    }
+    authOptions.signer = createPrivateKeySigner({
+      accountId,
+      privateKey: hederaPrivateKey,
+      network: resolvedNetwork.hederaNetwork
+    });
+  } else if (evmPrivateKey) {
+    if (resolvedNetwork.kind !== "evm") {
+      throw new Error(
+        "evmPrivateKey can only be used with CAIP-2 EVM networks (eip155:<chainId>)."
+      );
+    }
+    const formattedKey = evmPrivateKey.startsWith("0x") ? evmPrivateKey : `0x${evmPrivateKey}`;
+    const account = await loadViemAccount(formattedKey);
+    authOptions.sign = async (message) => ({
+      signature: await account.signMessage({ message }),
+      signatureKind: "evm",
+      publicKey: account.publicKey
+    });
+  } else {
+    throw new Error(
+      "Provide a signer, sign function, hederaPrivateKey, or evmPrivateKey to authenticate with the ledger."
+    );
   }
-  const embeddedMatch = trimmed.match(/content-ref:([a-f0-9]+)/);
-  if (embeddedMatch) {
-    return embeddedMatch[1];
+  logger?.info?.(
+    `Authenticating ledger account ${accountId} (${resolvedNetwork.canonical})${labelSuffix}...`
+  );
+  const verification = await this.authenticateWithLedger(authOptions);
+  if (setAccountHeader) {
+    this.setDefaultHeader("x-account-id", verification.accountId);
   }
-  return null;
-}
-function shouldUseReference(content) {
-  const size = typeof content === "string" ? Buffer.byteLength(content, "utf8") : content.length;
-  return size > REFERENCE_THRESHOLD;
-}
-const ContentStoreService = ContentStoreServiceImpl.getInstance();
-export {
-  ContentStoreService,
-  ContentStoreServiceImpl,
-  REFERENCE_THRESHOLD,
-  extractReferenceId,
-  shouldUseReference
+  logger?.info?.(
+    `Ledger authentication complete${labelSuffix}. Issued key prefix: ${verification.apiKey.prefix}…${verification.apiKey.lastFour}`
+  );
+  return verification;
 };
 //# sourceMappingURL=standards-sdk.es133.js.map

package/dist/es/standards-sdk.es133.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/content-store/ContentStoreService.ts"],"sourcesContent":["/**\n * Content Store Service\n *\n * Provides utility functions for content storage and reference handling.\n */\n\nimport type { ContentStoreInterface } from './types';\nimport { Logger } from '../utils/logger';\n\n/**\n * Maximum content size before using references (50KB)\n */\nexport const REFERENCE_THRESHOLD = 50 * 1024;\n\n/**\n * Content store service for managing large content\n */\nexport class ContentStoreServiceImpl {\n  private static _instance: ContentStoreServiceImpl;\n  private contentStore: ContentStoreInterface | null = null;\n  private logger = Logger.getInstance({ module: 'ContentStoreService' });\n\n  static getInstance(): ContentStoreServiceImpl {\n    if (!ContentStoreServiceImpl._instance) {\n      ContentStoreServiceImpl._instance = new ContentStoreServiceImpl();\n    }\n    return ContentStoreServiceImpl._instance;\n  }\n\n  /**\n   * Set the content store instance\n   */\n  async setInstance(store: ContentStoreInterface): Promise<void> {\n    if (this.contentStore) {\n      this.logger.warn('Content store already set, replacing');\n    }\n    this.contentStore = store;\n    this.logger.info('Content store instance set');\n  }\n\n  /**\n   * Get the content store instance\n   */\n  getInstance(): ContentStoreInterface | null {\n    return this.contentStore;\n  }\n\n  /**\n   * Clear the content store instance\n   */\n  dispose(): void {\n    this.contentStore = null;\n    this.logger.info('Content store disposed');\n  }\n\n  /**\n   * Check if content store is available\n   */\n  isAvailable(): boolean {\n    return this.contentStore !== null;\n  }\n}\n\n/**\n * Extract reference ID from input string\n */\nexport function extractReferenceId(input: string): string | null {\n  const trimmed = input.trim();\n\n  const exactMatch = trimmed.match(/^content-ref:([a-f0-9]+)$/);\n  if (exactMatch) {\n    return exactMatch[1];\n  }\n\n  const embeddedMatch = trimmed.match(/content-ref:([a-f0-9]+)/);\n  if (embeddedMatch) {\n    return embeddedMatch[1];\n  }\n\n  return null;\n}\n\n/**\n * Check if content should use reference based on size\n */\nexport function shouldUseReference(content: string | Buffer): boolean {\n  const size =\n    typeof content === 'string'\n      ? Buffer.byteLength(content, 'utf8')\n      : content.length;\n\n  return size > REFERENCE_THRESHOLD;\n}\n\nexport const ContentStoreService = ContentStoreServiceImpl.getInstance();\n"],"names":[],"mappings":";AAYO,MAAM,sBAAsB,KAAK;AAKjC,MAAM,wBAAwB;AAAA,EAA9B,cAAA;AAEL,SAAQ,eAA6C;AACrD,SAAQ,SAAS,OAAO,YAAY,EAAE,QAAQ,uBAAuB;AAAA,EAAA;AAAA,EAErE,OAAO,cAAuC;AAC5C,QAAI,CAAC,wBAAwB,WAAW;AACtC,8BAAwB,YAAY,IAAI,wBAAA;AAAA,IAC1C;AACA,WAAO,wBAAwB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,OAA6C;AAC7D,QAAI,KAAK,cAAc;AACrB,WAAK,OAAO,KAAK,sCAAsC;AAAA,IACzD;AACA,SAAK,eAAe;AACpB,SAAK,OAAO,KAAK,4BAA4B;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,cAA4C;AAC1C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,eAAe;AACpB,SAAK,OAAO,KAAK,wBAAwB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AACF;AAKO,SAAS,mBAAmB,OAA8B;AAC/D,QAAM,UAAU,MAAM,KAAA;AAEtB,QAAM,aAAa,QAAQ,MAAM,2BAA2B;AAC5D,MAAI,YAAY;AACd,WAAO,WAAW,CAAC;AAAA,EACrB;AAEA,QAAM,gBAAgB,QAAQ,MAAM,yBAAyB;AAC7D,MAAI,eAAe;AACjB,WAAO,cAAc,CAAC;AAAA,EACxB;AAEA,SAAO;AACT;AAKO,SAAS,mBAAmB,SAAmC;AACpE,QAAM,OACJ,OAAO,YAAY,WACf,OAAO,WAAW,SAAS,MAAM,IACjC,QAAQ;AAEd,SAAO,OAAO;AAChB;AAEO,MAAM,sBAAsB,wBAAwB,YAAA;"}
+{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/services/registry-broker/client/ledger-auth.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport type { SignerSignature } from '@hashgraph/sdk';\nimport type {\n  JsonObject,\n  JsonValue,\n  LedgerAuthenticationOptions,\n  LedgerAuthenticationSignerResult,\n  LedgerChallengeRequest,\n  LedgerChallengeResponse,\n  LedgerCredentialAuthOptions,\n  LedgerVerifyRequest,\n  LedgerVerifyResponse,\n} from '../types';\nimport {\n  ledgerChallengeResponseSchema,\n  ledgerVerifyResponseSchema,\n} from '../schemas';\nimport { canonicalizeLedgerNetwork } from '../ledger-network';\nimport { createPrivateKeySigner } from '../private-key-signer';\nimport { RegistryBrokerClient } from './base-client';\n\ndeclare module './base-client' {\n  interface RegistryBrokerClient {\n    createLedgerChallenge(\n      payload: LedgerChallengeRequest,\n    ): Promise<LedgerChallengeResponse>;\n    verifyLedgerChallenge(\n      payload: LedgerVerifyRequest,\n    ): Promise<LedgerVerifyResponse>;\n    authenticateWithLedger(\n      options: LedgerAuthenticationOptions,\n    ): Promise<LedgerVerifyResponse>;\n    authenticateWithLedgerCredentials(\n      options: LedgerCredentialAuthOptions,\n    ): Promise<LedgerVerifyResponse>;\n  }\n}\n\nasync function loadViemAccount(privateKey: `0x${string}`): Promise<{\n  publicKey: string;\n  signMessage: (input: { message: string }) => Promise<string>;\n}> {\n  try {\n    const viem = await import('viem/accounts');\n    return viem.privateKeyToAccount(privateKey);\n  } catch (error) {\n    const err = new Error(\n      'EVM ledger authentication requires the optional dependency \"viem\". Install it to use evmPrivateKey flows.',\n    );\n    (err as { cause?: unknown }).cause = error;\n    throw err;\n  }\n}\n\nasync function resolveLedgerAuthSignature(\n  message: string,\n  options: LedgerAuthenticationOptions,\n): Promise<LedgerAuthenticationSignerResult> {\n  if (typeof options.sign === 'function') {\n    const result = await options.sign(message);\n    if (\n      !result ||\n      typeof result.signature !== 'string' ||\n      result.signature.length === 0\n    ) {\n      throw new Error('Custom ledger signer failed to produce a signature.');\n    }\n    return result;\n  }\n\n  if (!options.signer || typeof options.signer.sign !== 'function') {\n    throw new Error(\n      'Ledger authentication requires a Hedera Signer or custom sign function.',\n    );\n  }\n\n  const payload = Buffer.from(message, 'utf8');\n  const signatures: SignerSignature[] = await options.signer.sign([payload]);\n  const signatureEntry = signatures?.[0];\n  if (!signatureEntry) {\n    throw new Error('Signer did not return any signatures.');\n  }\n\n  let derivedPublicKey: string | undefined;\n  if (signatureEntry.publicKey) {\n    derivedPublicKey = signatureEntry.publicKey.toString();\n  } else if (typeof options.signer.getAccountKey === 'function') {\n    const accountKey = await options.signer.getAccountKey();\n    if (accountKey && typeof accountKey.toString === 'function') {\n      derivedPublicKey = accountKey.toString();\n    }\n  }\n\n  return {\n    signature: Buffer.from(signatureEntry.signature).toString('base64'),\n    signatureKind: 'raw',\n    publicKey: derivedPublicKey,\n  };\n}\n\nRegistryBrokerClient.prototype.createLedgerChallenge = async function (\n  this: RegistryBrokerClient,\n  payload: LedgerChallengeRequest,\n): Promise<LedgerChallengeResponse> {\n  const resolvedNetwork = canonicalizeLedgerNetwork(payload.network);\n  const network =\n    resolvedNetwork.kind === 'hedera'\n      ? (resolvedNetwork.hederaNetwork ?? resolvedNetwork.canonical)\n      : resolvedNetwork.canonical;\n  const raw = await this.requestJson<JsonValue>('/auth/ledger/challenge', {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body: {\n      accountId: payload.accountId,\n      network,\n    },\n  });\n\n  return this.parseWithSchema(\n    raw,\n    ledgerChallengeResponseSchema,\n    'ledger challenge response',\n  );\n};\n\nRegistryBrokerClient.prototype.verifyLedgerChallenge = async function (\n  this: RegistryBrokerClient,\n  payload: LedgerVerifyRequest,\n): Promise<LedgerVerifyResponse> {\n  const resolvedNetwork = canonicalizeLedgerNetwork(payload.network);\n  const network =\n    resolvedNetwork.kind === 'hedera'\n      ? (resolvedNetwork.hederaNetwork ?? resolvedNetwork.canonical)\n      : resolvedNetwork.canonical;\n  const body: JsonObject = {\n    challengeId: payload.challengeId,\n    accountId: payload.accountId,\n    network,\n    signature: payload.signature,\n  };\n\n  if (payload.signatureKind) {\n    body.signatureKind = payload.signatureKind;\n  }\n  if (payload.publicKey) {\n    body.publicKey = payload.publicKey;\n  }\n  if (typeof payload.expiresInMinutes === 'number') {\n    body.expiresInMinutes = payload.expiresInMinutes;\n  }\n\n  const raw = await this.requestJson<JsonValue>('/auth/ledger/verify', {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body,\n  });\n\n  const result = this.parseWithSchema(\n    raw,\n    ledgerVerifyResponseSchema,\n    'ledger verification response',\n  );\n\n  this.setLedgerApiKey(result.key);\n  return result;\n};\n\nRegistryBrokerClient.prototype.authenticateWithLedger = async function (\n  this: RegistryBrokerClient,\n  options: LedgerAuthenticationOptions,\n): Promise<LedgerVerifyResponse> {\n  const challenge = await this.createLedgerChallenge({\n    accountId: options.accountId,\n    network: options.network,\n  });\n  const signed = await resolveLedgerAuthSignature(challenge.message, options);\n  const verification = await this.verifyLedgerChallenge({\n    challengeId: challenge.challengeId,\n    accountId: options.accountId,\n    network: options.network,\n    signature: signed.signature,\n    signatureKind: signed.signatureKind,\n    publicKey: signed.publicKey,\n    expiresInMinutes: options.expiresInMinutes,\n  });\n  return verification;\n};\n\nRegistryBrokerClient.prototype.authenticateWithLedgerCredentials =\n  async function (\n    this: RegistryBrokerClient,\n    options: LedgerCredentialAuthOptions,\n  ): Promise<LedgerVerifyResponse> {\n    const {\n      accountId,\n      network,\n      signer,\n      sign,\n      hederaPrivateKey,\n      evmPrivateKey,\n      expiresInMinutes,\n      setAccountHeader = true,\n      label,\n      logger,\n    } = options;\n\n    const resolvedNetwork = canonicalizeLedgerNetwork(network);\n    const labelSuffix = label ? ` for ${label}` : '';\n\n    const networkPayload = resolvedNetwork.canonical;\n\n    const authOptions: LedgerAuthenticationOptions = {\n      accountId,\n      network: networkPayload,\n      expiresInMinutes,\n    };\n\n    if (sign) {\n      authOptions.sign = sign;\n    } else if (signer) {\n      authOptions.signer = signer;\n    } else if (hederaPrivateKey) {\n      if (resolvedNetwork.kind !== 'hedera' || !resolvedNetwork.hederaNetwork) {\n        throw new Error(\n          'hederaPrivateKey can only be used with hedera:mainnet or hedera:testnet networks.',\n        );\n      }\n      authOptions.signer = createPrivateKeySigner({\n        accountId,\n        privateKey: hederaPrivateKey,\n        network: resolvedNetwork.hederaNetwork,\n      });\n    } else if (evmPrivateKey) {\n      if (resolvedNetwork.kind !== 'evm') {\n        throw new Error(\n          'evmPrivateKey can only be used with CAIP-2 EVM networks (eip155:<chainId>).',\n        );\n      }\n      const formattedKey = evmPrivateKey.startsWith('0x')\n        ? (evmPrivateKey as `0x${string}`)\n        : (`0x${evmPrivateKey}` as `0x${string}`);\n      const account = await loadViemAccount(formattedKey);\n      authOptions.sign = async message => ({\n        signature: await account.signMessage({ message }),\n        signatureKind: 'evm',\n        publicKey: account.publicKey,\n      });\n    } else {\n      throw new Error(\n        'Provide a signer, sign function, hederaPrivateKey, or evmPrivateKey to authenticate with the ledger.',\n      );\n    }\n\n    logger?.info?.(\n      `Authenticating ledger account ${accountId} (${resolvedNetwork.canonical})${labelSuffix}...`,\n    );\n    const verification = await this.authenticateWithLedger(authOptions);\n    if (setAccountHeader) {\n      this.setDefaultHeader('x-account-id', verification.accountId);\n    }\n    logger?.info?.(\n      `Ledger authentication complete${labelSuffix}. Issued key prefix: ${verification.apiKey.prefix}…${verification.apiKey.lastFour}`,\n    );\n    return verification;\n  };\n"],"names":[],"mappings":";;;;;AAsCA,eAAe,gBAAgB,YAG5B;AACD,MAAI;AACF,UAAM,OAAO,MAAM,OAAO,eAAe;AACzC,WAAO,KAAK,oBAAoB,UAAU;AAAA,EAC5C,SAAS,OAAO;AACd,UAAM,MAAM,IAAI;AAAA,MACd;AAAA,IAAA;AAED,QAA4B,QAAQ;AACrC,UAAM;AAAA,EACR;AACF;AAEA,eAAe,2BACb,SACA,SAC2C;AAC3C,MAAI,OAAO,QAAQ,SAAS,YAAY;AACtC,UAAM,SAAS,MAAM,QAAQ,KAAK,OAAO;AACzC,QACE,CAAC,UACD,OAAO,OAAO,cAAc,YAC5B,OAAO,UAAU,WAAW,GAC5B;AACA,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AACA,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,QAAQ,UAAU,OAAO,QAAQ,OAAO,SAAS,YAAY;AAChE,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,QAAM,UAAU,OAAO,KAAK,SAAS,MAAM;AAC3C,QAAM,aAAgC,MAAM,QAAQ,OAAO,KAAK,CAAC,OAAO,CAAC;AACzE,QAAM,iBAAiB,aAAa,CAAC;AACrC,MAAI,CAAC,gBAAgB;AACnB,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AAEA,MAAI;AACJ,MAAI,eAAe,WAAW;AAC5B,uBAAmB,eAAe,UAAU,SAAA;AAAA,EAC9C,WAAW,OAAO,QAAQ,OAAO,kBAAkB,YAAY;AAC7D,UAAM,aAAa,MAAM,QAAQ,OAAO,cAAA;AACxC,QAAI,cAAc,OAAO,WAAW,aAAa,YAAY;AAC3D,yBAAmB,WAAW,SAAA;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,WAAW,OAAO,KAAK,eAAe,SAAS,EAAE,SAAS,QAAQ;AAAA,IAClE,eAAe;AAAA,IACf,WAAW;AAAA,EAAA;AAEf;AAEA,qBAAqB,UAAU,wBAAwB,eAErD,SACkC;AAClC,QAAM,kBAAkB,0BAA0B,QAAQ,OAAO;AACjE,QAAM,UACJ,gBAAgB,SAAS,WACpB,gBAAgB,iBAAiB,gBAAgB,YAClD,gBAAgB;AACtB,QAAM,MAAM,MAAM,KAAK,YAAuB,0BAA0B;AAAA,IACtE,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAA;AAAA,IAC3B,MAAM;AAAA,MACJ,WAAW,QAAQ;AAAA,MACnB;AAAA,IAAA;AAAA,EACF,CACD;AAED,SAAO,KAAK;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,qBAAqB,UAAU,wBAAwB,eAErD,SAC+B;AAC/B,QAAM,kBAAkB,0BAA0B,QAAQ,OAAO;AACjE,QAAM,UACJ,gBAAgB,SAAS,WACpB,gBAAgB,iBAAiB,gBAAgB,YAClD,gBAAgB;AACtB,QAAM,OAAmB;AAAA,IACvB,aAAa,QAAQ;AAAA,IACrB,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA,WAAW,QAAQ;AAAA,EAAA;AAGrB,MAAI,QAAQ,eAAe;AACzB,SAAK,gBAAgB,QAAQ;AAAA,EAC/B;AACA,MAAI,QAAQ,WAAW;AACrB,SAAK,YAAY,QAAQ;AAAA,EAC3B;AACA,MAAI,OAAO,QAAQ,qBAAqB,UAAU;AAChD,SAAK,mBAAmB,QAAQ;AAAA,EAClC;AAEA,QAAM,MAAM,MAAM,KAAK,YAAuB,uBAAuB;AAAA,IACnE,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAA;AAAA,IAC3B;AAAA,EAAA,CACD;AAED,QAAM,SAAS,KAAK;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAGF,OAAK,gBAAgB,OAAO,GAAG;AAC/B,SAAO;AACT;AAEA,qBAAqB,UAAU,yBAAyB,eAEtD,SAC+B;AAC/B,QAAM,YAAY,MAAM,KAAK,sBAAsB;AAAA,IACjD,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,EAAA,CAClB;AACD,QAAM,SAAS,MAAM,2BAA2B,UAAU,SAAS,OAAO;AAC1E,QAAM,eAAe,MAAM,KAAK,sBAAsB;AAAA,IACpD,aAAa,UAAU;AAAA,IACvB,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,IACjB,WAAW,OAAO;AAAA,IAClB,eAAe,OAAO;AAAA,IACtB,WAAW,OAAO;AAAA,IAClB,kBAAkB,QAAQ;AAAA,EAAA,CAC3B;AACD,SAAO;AACT;AAEA,qBAAqB,UAAU,oCAC7B,eAEE,SAC+B;AAC/B,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,mBAAmB;AAAA,IACnB;AAAA,IACA;AAAA,EAAA,IACE;AAEJ,QAAM,kBAAkB,0BAA0B,OAAO;AACzD,QAAM,cAAc,QAAQ,QAAQ,KAAK,KAAK;AAE9C,QAAM,iBAAiB,gBAAgB;AAEvC,QAAM,cAA2C;AAAA,IAC/C;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EAAA;AAGF,MAAI,MAAM;AACR,gBAAY,OAAO;AAAA,EACrB,WAAW,QAAQ;AACjB,gBAAY,SAAS;AAAA,EACvB,WAAW,kBAAkB;AAC3B,QAAI,gBAAgB,SAAS,YAAY,CAAC,gBAAgB,eAAe;AACvE,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,gBAAY,SAAS,uBAAuB;AAAA,MAC1C;AAAA,MACA,YAAY;AAAA,MACZ,SAAS,gBAAgB;AAAA,IAAA,CAC1B;AAAA,EACH,WAAW,eAAe;AACxB,QAAI,gBAAgB,SAAS,OAAO;AAClC,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,UAAM,eAAe,cAAc,WAAW,IAAI,IAC7C,gBACA,KAAK,aAAa;AACvB,UAAM,UAAU,MAAM,gBAAgB,YAAY;AAClD,gBAAY,OAAO,OAAM,aAAY;AAAA,MACnC,WAAW,MAAM,QAAQ,YAAY,EAAE,SAAS;AAAA,MAChD,eAAe;AAAA,MACf,WAAW,QAAQ;AAAA,IAAA;AAAA,EAEvB,OAAO;AACL,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,UAAQ;AAAA,IACN,iCAAiC,SAAS,KAAK,gBAAgB,SAAS,IAAI,WAAW;AAAA,EAAA;AAEzF,QAAM,eAAe,MAAM,KAAK,uBAAuB,WAAW;AAClE,MAAI,kBAAkB;AACpB,SAAK,iBAAiB,gBAAgB,aAAa,SAAS;AAAA,EAC9D;AACA,UAAQ;AAAA,IACN,iCAAiC,WAAW,wBAAwB,aAAa,OAAO,MAAM,IAAI,aAAa,OAAO,QAAQ;AAAA,EAAA;AAEhI,SAAO;AACT;"}