@hashgraphonline/standards-sdk 0.1.144 → 0.1.145

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es131.js","sources":["../../src/services/registry-broker/client/credits.ts"],"sourcesContent":["import type {\n  CreditPurchaseResponse,\n  JsonObject,\n  JsonValue,\n  X402CreditPurchaseResponse,\n  X402MinimumsResponse,\n} from '../types';\nimport {\n  creditPurchaseResponseSchema,\n  x402CreditPurchaseResponseSchema,\n  x402MinimumsResponseSchema,\n} from '../schemas';\nimport { RegistryBrokerClient } from './base-client';\nimport { normalizeHexPrivateKey, type X402NetworkId } from './utils';\nimport { optionalImport } from '../../../utils/dynamic-import';\n\ntype PaymentHeaders = Record<string, string | string[] | undefined>;\ntype PaymentClient = {\n  post: (\n    url: string,\n    body: JsonObject,\n  ) => Promise<{ data: JsonValue; headers?: PaymentHeaders }>;\n};\n\ninterface PurchaseCreditsWithX402Params {\n  accountId: string;\n  credits: number;\n  usdAmount?: number;\n  description?: string;\n  metadata?: JsonObject;\n  walletClient: object;\n}\n\ninterface BuyCreditsWithX402Params {\n  accountId: string;\n  credits: number;\n  usdAmount?: number;\n  description?: string;\n  metadata?: JsonObject;\n  evmPrivateKey: string;\n  network?: X402NetworkId;\n  rpcUrl?: string;\n}\n\ntype X402PurchaseResult = X402CreditPurchaseResponse & {\n  paymentResponseHeader?: string;\n  paymentResponse?: unknown;\n};\n\ntype LoadX402DependenciesResult = {\n  createPaymentClient: (walletClient: object) => PaymentClient;\n  decodePaymentResponse: (value: string) => unknown;\n  createX402Signer: (\n    network: X402NetworkId,\n    privateKey: `0x${string}`,\n  ) => Promise<object>;\n};\n\nasync function loadX402Dependencies(\n  client: RegistryBrokerClient,\n): Promise<LoadX402DependenciesResult> {\n  type X402AxiosModule = {\n    withPaymentInterceptor: (client: unknown, walletClient: object) => unknown;\n    decodeXPaymentResponse: (value: string) => unknown;\n  };\n  type X402TypesModule = {\n    createSigner: (\n      network: X402NetworkId,\n      privateKey: `0x${string}`,\n    ) => Promise<object>;\n  };\n\n  const [{ default: axios }, x402Axios, x402Types] = await Promise.all([\n    import('axios'),\n    optionalImport<X402AxiosModule>('x402-axios'),\n    optionalImport<X402TypesModule>('x402/types'),\n  ]);\n\n  if (!x402Axios || !x402Types) {\n    throw new Error(\n      'x402-axios and x402/types are required for X402 flows. Install them to enable ledger payments.',\n    );\n  }\n\n  const withPaymentInterceptor = x402Axios.withPaymentInterceptor;\n  const decodePaymentResponse = x402Axios.decodeXPaymentResponse;\n  const createX402Signer = x402Types.createSigner;\n\n  const createPaymentClient = (walletClient: object): PaymentClient => {\n    const axiosClient = axios.create({\n      baseURL: client.baseUrl,\n      headers: {\n        ...client.getDefaultHeaders(),\n        'content-type': 'application/json',\n      },\n    });\n    const paymentClient = withPaymentInterceptor(axiosClient, walletClient);\n    return paymentClient as PaymentClient;\n  };\n\n  return { createPaymentClient, decodePaymentResponse, createX402Signer };\n}\n\nfunction calculateHbarAmountParam(hbarAmount: number): number {\n  const tinybars = Math.ceil(hbarAmount * 1e8);\n  if (tinybars <= 0) {\n    throw new Error('Calculated purchase amount must be positive');\n  }\n  return tinybars / 1e8;\n}\n\ndeclare module './base-client' {\n  interface RegistryBrokerClient {\n    purchaseCreditsWithHbar(params: {\n      accountId: string;\n      privateKey: string;\n      hbarAmount: number;\n      memo?: string;\n      metadata?: JsonObject;\n    }): Promise<CreditPurchaseResponse>;\n    getX402Minimums(): Promise<X402MinimumsResponse>;\n    purchaseCreditsWithX402(\n      params: PurchaseCreditsWithX402Params,\n    ): Promise<X402PurchaseResult>;\n    buyCreditsWithX402(\n      params: BuyCreditsWithX402Params,\n    ): Promise<X402PurchaseResult>;\n  }\n}\n\nRegistryBrokerClient.prototype.purchaseCreditsWithHbar = async function (\n  this: RegistryBrokerClient,\n  params: {\n    accountId: string;\n    privateKey: string;\n    hbarAmount: number;\n    memo?: string;\n    metadata?: JsonObject;\n  },\n): Promise<CreditPurchaseResponse> {\n  const body: JsonObject = {\n    accountId: params.accountId,\n    payerKey: params.privateKey,\n    hbarAmount: calculateHbarAmountParam(params.hbarAmount),\n  };\n\n  if (params.memo) {\n    body.memo = params.memo;\n  }\n\n  if (params.metadata) {\n    body.metadata = params.metadata;\n  }\n\n  const raw = await this.requestJson<JsonValue>('/credits/purchase', {\n    method: 'POST',\n    headers: { 'content-type': 'application/json' },\n    body,\n  });\n\n  return this.parseWithSchema(\n    raw,\n    creditPurchaseResponseSchema,\n    'credit purchase response',\n  );\n};\n\nRegistryBrokerClient.prototype.getX402Minimums = async function (\n  this: RegistryBrokerClient,\n): Promise<X402MinimumsResponse> {\n  const raw = await this.requestJson<JsonValue>(\n    '/credits/purchase/x402/minimums',\n    { method: 'GET' },\n  );\n  return this.parseWithSchema(\n    raw,\n    x402MinimumsResponseSchema,\n    'x402 minimums response',\n  );\n};\n\nRegistryBrokerClient.prototype.purchaseCreditsWithX402 = async function (\n  this: RegistryBrokerClient,\n  params: PurchaseCreditsWithX402Params,\n): Promise<X402PurchaseResult> {\n  const { createPaymentClient, decodePaymentResponse } =\n    await loadX402Dependencies(this);\n\n  if (!Number.isFinite(params.credits) || params.credits <= 0) {\n    throw new Error('credits must be a positive number');\n  }\n  if (\n    params.usdAmount !== undefined &&\n    (!Number.isFinite(params.usdAmount) || params.usdAmount <= 0)\n  ) {\n    throw new Error('usdAmount must be a positive number when provided');\n  }\n\n  const body: JsonObject = {\n    accountId: params.accountId,\n    credits: params.credits,\n  };\n\n  if (params.usdAmount !== undefined) {\n    body.usdAmount = params.usdAmount;\n  }\n  if (params.description) {\n    body.description = params.description;\n  }\n  if (params.metadata) {\n    body.metadata = params.metadata;\n  }\n\n  const paymentClient = createPaymentClient(params.walletClient);\n\n  const response = await paymentClient.post('/credits/purchase/x402', body);\n\n  const parsed = this.parseWithSchema(\n    response.data,\n    x402CreditPurchaseResponseSchema,\n    'x402 credit purchase response',\n  );\n\n  const responseHeaders = response.headers ?? {};\n  const paymentHeader =\n    typeof responseHeaders['x-payment-response'] === 'string'\n      ? responseHeaders['x-payment-response']\n      : undefined;\n  const decodedPayment =\n    paymentHeader !== undefined\n      ? decodePaymentResponse(paymentHeader)\n      : undefined;\n\n  return {\n    ...parsed,\n    paymentResponseHeader: paymentHeader,\n    paymentResponse: decodedPayment,\n  };\n};\n\nRegistryBrokerClient.prototype.buyCreditsWithX402 = async function (\n  this: RegistryBrokerClient,\n  params: BuyCreditsWithX402Params,\n): Promise<X402PurchaseResult> {\n  const network: X402NetworkId = params.network ?? 'base';\n  const { createX402Signer } = await loadX402Dependencies(this);\n  const normalizedKey = normalizeHexPrivateKey(params.evmPrivateKey);\n  const walletClient = await createX402Signer(network, normalizedKey);\n\n  return this.purchaseCreditsWithX402({\n    accountId: params.accountId,\n    credits: params.credits,\n    usdAmount: params.usdAmount,\n    description: params.description,\n    metadata: params.metadata,\n    walletClient,\n  });\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es131.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":"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"}

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

@@ -1,250 +1,183 @@
-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");
-  }
-  if (creditsToPurchase <= 0) {
-    throw new Error("creditsToPurchase must be positive");
-  }
-  const rawHbar = creditsToPurchase / creditsPerHbar;
-  const tinybars = Math.ceil(rawHbar * 1e8);
-  return tinybars / 1e8;
-}
-function resolveCreditsToPurchase(shortfallCredits) {
-  if (!Number.isFinite(shortfallCredits) || shortfallCredits <= 0) {
-    return 0;
+import { Buffer } from "buffer";
+import { ledgerChallengeResponseSchema, ledgerVerifyResponseSchema } from "./standards-sdk.es149.js";
+import { canonicalizeLedgerNetwork } from "./standards-sdk.es138.js";
+import { createPrivateKeySignerAsync } from "./standards-sdk.es137.js";
+import { RegistryBrokerClient } from "./standards-sdk.es135.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;
   }
-  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;
+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 result;
   }
-  if (!details.accountId || !details.accountId.trim()) {
-    throw new Error("autoTopUp.accountId is required");
+  if (!options.signer || typeof options.signer.sign !== "function") {
+    throw new Error(
+      "Ledger authentication requires a Hedera Signer or custom sign function."
+    );
   }
-  if (!details.privateKey || !details.privateKey.trim()) {
-    throw new Error("autoTopUp.privateKey is required");
+  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.");
   }
-  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;
+  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();
     }
-    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
-      }
-    });
-  }
-  const finalQuote = await client.getRegistrationQuote(payload);
-  if ((finalQuote.shortfallCredits ?? 0) > 0) {
-    throw new Error("Unable to purchase sufficient credits for registration");
   }
+  return {
+    signature: Buffer.from(signatureEntry.signature).toString("base64"),
+    signatureKind: "raw",
+    publicKey: derivedPublicKey
+  };
 }
-RegistryBrokerClient.prototype.resolveUaid = async function(uaid) {
-  const raw = await this.requestJson(
-    `/resolve/${encodeURIComponent(uaid)}`,
-    {
-      method: "GET"
+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,
-    resolveResponseSchema,
-    "resolve UAID response"
+    ledgerChallengeResponseSchema,
+    "ledger challenge response"
   );
 };
-RegistryBrokerClient.prototype.registerAgent = async function(payload, options) {
-  const autoTopUp = options?.autoTopUp ?? this.registrationAutoTopUp;
-  if (!autoTopUp) {
-    return performRegisterAgent(this, payload);
+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;
   }
-  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;
-    }
+  if (payload.publicKey) {
+    body.publicKey = payload.publicKey;
   }
-};
-RegistryBrokerClient.prototype.getRegistrationQuote = async function(payload) {
-  const raw = await this.requestJson("/register/quote", {
+  if (typeof payload.expiresInMinutes === "number") {
+    body.expiresInMinutes = payload.expiresInMinutes;
+  }
+  const raw = await this.requestJson("/auth/ledger/verify", {
     method: "POST",
-    body: serialiseAgentRegistrationRequest(payload),
-    headers: { "content-type": "application/json" }
+    headers: { "content-type": "application/json" },
+    body
   });
-  return this.parseWithSchema(
+  const result = this.parseWithSchema(
     raw,
-    registrationQuoteResponseSchema,
-    "registration quote response"
+    ledgerVerifyResponseSchema,
+    "ledger verification response"
   );
+  this.setLedgerApiKey(result.key);
+  return result;
 };
-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");
-  }
-  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.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.waitForRegistrationCompletion = async function(attemptId, options = {}) {
-  const normalisedAttemptId = attemptId.trim();
-  if (!normalisedAttemptId) {
-    throw new Error("attemptId is required");
-  }
-  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;
-      }
+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."
+      );
     }
-    if (Date.now() - startedAt >= timeoutMs) {
+    authOptions.signer = await createPrivateKeySignerAsync({
+      accountId,
+      privateKey: hederaPrivateKey,
+      network: resolvedNetwork.hederaNetwork
+    });
+  } else if (evmPrivateKey) {
+    if (resolvedNetwork.kind !== "evm") {
       throw new Error(
-        `Registration progress polling timed out after ${timeoutMs}ms`
+        "evmPrivateKey can only be used with CAIP-2 EVM networks (eip155:<chainId>)."
       );
     }
-    await this.delay(interval, signal);
+    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."
+    );
   }
-};
-RegistryBrokerClient.prototype.validateUaid = async function(uaid) {
-  const raw = await this.requestJson(
-    `/uaids/validate/${encodeURIComponent(uaid)}`,
-    {
-      method: "GET"
-    }
+  logger?.info?.(
+    `Authenticating ledger account ${accountId} (${resolvedNetwork.canonical})${labelSuffix}...`
   );
-  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"
+  const verification = await this.authenticateWithLedger(authOptions);
+  if (setAccountHeader) {
+    this.setDefaultHeader("x-account-id", verification.accountId);
+  }
+  logger?.info?.(
+    `Ledger authentication complete${labelSuffix}. Issued key prefix: ${verification.apiKey.prefix}…${verification.apiKey.lastFour}`
   );
+  return verification;
 };
 //# 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/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":"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"}
+{"version":3,"file":"standards-sdk.es132.js","sources":["../../src/services/registry-broker/client/ledger-auth.ts"],"sourcesContent":["import { Buffer } from '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 { createPrivateKeySignerAsync } 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 = await createPrivateKeySignerAsync({\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":"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"}