@hashgraphonline/standards-sdk 0.1.171 → 0.1.172

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

@@ -1,90 +1,262 @@
-const normalise = (value) => value.trim().toLowerCase();
-const HEDERA_NETWORK_ALIASES = /* @__PURE__ */ new Map([
-  ["hedera:mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
-  ["mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
-  ["hedera-mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
-  ["hedera_mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
-  ["hedera:testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
-  ["testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
-  ["hedera-testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
-  ["hedera_testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }]
-]);
-const EVM_NETWORK_CHAIN_IDS = {
-  abstract: 2741,
-  "abstract-testnet": 11124,
-  base: 8453,
-  "base-sepolia": 84532,
-  avalanche: 43114,
-  "avalanche-fuji": 43113,
-  iotex: 4689,
-  sei: 1329,
-  "sei-testnet": 1328,
-  polygon: 137,
-  "polygon-amoy": 80002,
-  peaq: 3338
-};
-const CHAIN_ID_TO_ALIAS = new Map(
-  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias])
-);
-const parseChainId = (value) => {
-  if (/^eip155:\d+$/i.test(value)) {
-    return Number.parseInt(value.split(":")[1], 10);
+import { dashboardStatsResponseSchema, registrationProgressResponseSchema, registrationQuoteResponseSchema, uaidConnectionStatusSchema, resolveResponseSchema, registerAgentResponseSchema, uaidValidationResponseSchema } from "./standards-sdk.es145.js";
+import { purchaseCreditsWithHbar } from "./standards-sdk.es179.js";
+import { serialiseAgentRegistrationRequest, DEFAULT_PROGRESS_INTERVAL_MS, DEFAULT_PROGRESS_TIMEOUT_MS, createAbortError, MINIMUM_REGISTRATION_AUTO_TOP_UP_CREDITS } from "./standards-sdk.es177.js";
+import { RegistryBrokerError } from "./standards-sdk.es146.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 (/^\d+$/.test(value)) {
-    return Number.parseInt(value, 10);
+  if (creditsToPurchase <= 0) {
+    throw new Error("creditsToPurchase must be positive");
   }
-  return void 0;
-};
-const normaliseEvmNetwork = (value) => {
-  const trimmed = normalise(value);
-  let chainId = parseChainId(trimmed);
-  let alias;
-  if (chainId === void 0) {
-    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];
-    if (mapped !== void 0) {
-      chainId = mapped;
-      alias = trimmed;
+  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 getRegistrationQuote(client, payload);
+    const shortfall = quote.shortfallCredits ?? 0;
+    if (shortfall <= 0) {
+      return;
+    }
+    const creditsToPurchase = resolveCreditsToPurchase(shortfall);
+    if (creditsToPurchase <= 0) {
+      return;
     }
-  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {
-    alias = CHAIN_ID_TO_ALIAS.get(chainId);
+    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 purchaseCreditsWithHbar(client, {
+      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
+      }
+    });
   }
-  if (chainId === void 0) {
-    throw new Error(
-      'Unsupported EVM ledger network. Provide an alias like "base-sepolia" or a canonical eip155:<chainId> string.'
-    );
+  const finalQuote = await getRegistrationQuote(client, payload);
+  if ((finalQuote.shortfallCredits ?? 0) > 0) {
+    throw new Error("Unable to purchase sufficient credits for registration");
   }
-  return {
-    canonical: `eip155:${chainId}`,
-    kind: "evm",
-    chainId,
-    legacyName: alias
-  };
-};
-const normaliseHederaNetwork = (value) => {
-  const trimmed = normalise(value);
-  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);
-  if (!mapping) {
-    throw new Error(
-      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy "mainnet"/"testnet" also accepted).'
+}
+async function resolveUaid(client, uaid) {
+  const raw = await client.requestJson(
+    `/resolve/${encodeURIComponent(uaid)}`,
+    {
+      method: "GET"
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    resolveResponseSchema,
+    "resolve UAID response"
+  );
+}
+async function registerAgent(client, payload, options) {
+  const autoTopUp = options?.autoTopUp ?? client.registrationAutoTopUp;
+  if (!autoTopUp) {
+    return performRegisterAgent(client, payload);
+  }
+  await ensureCreditsForRegistration(client, payload, autoTopUp);
+  let retried = false;
+  while (true) {
+    try {
+      return await performRegisterAgent(client, payload);
+    } catch (error) {
+      const shortfall = client.extractInsufficientCreditsDetails(error);
+      if (shortfall && !retried) {
+        await ensureCreditsForRegistration(client, payload, autoTopUp);
+        retried = true;
+        continue;
+      }
+      throw error;
+    }
+  }
+}
+async function getRegistrationQuote(client, payload) {
+  const raw = await client.requestJson("/register/quote", {
+    method: "POST",
+    body: serialiseAgentRegistrationRequest(payload),
+    headers: { "content-type": "application/json" }
+  });
+  return client.parseWithSchema(
+    raw,
+    registrationQuoteResponseSchema,
+    "registration quote response"
+  );
+}
+async function updateAgent(client, uaid, payload) {
+  const raw = await client.requestJson(
+    `/register/${encodeURIComponent(uaid)}`,
+    {
+      method: "PUT",
+      body: serialiseAgentRegistrationRequest(payload),
+      headers: { "content-type": "application/json" }
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    registerAgentResponseSchema,
+    "update agent response"
+  );
+}
+async function getRegistrationProgress(client, attemptId) {
+  const normalisedAttemptId = attemptId.trim();
+  if (!normalisedAttemptId) {
+    throw new Error("attemptId is required");
+  }
+  try {
+    const raw = await client.requestJson(
+      `/register/progress/${encodeURIComponent(normalisedAttemptId)}`,
+      { method: "GET" }
     );
+    const parsed = client.parseWithSchema(
+      raw,
+      registrationProgressResponseSchema,
+      "registration progress response"
+    );
+    return parsed.progress;
+  } catch (error) {
+    if (error instanceof RegistryBrokerError && error.status === 404) {
+      return null;
+    }
+    throw error;
   }
-  return {
-    canonical: mapping.canonical,
-    kind: "hedera",
-    hederaNetwork: mapping.hederaNetwork
-  };
-};
-const canonicalizeLedgerNetwork = (network) => {
-  if (typeof network !== "string" || network.trim().length === 0) {
-    throw new Error("Ledger network is required.");
+}
+async function waitForRegistrationCompletion(client, attemptId, options = {}) {
+  const normalisedAttemptId = attemptId.trim();
+  if (!normalisedAttemptId) {
+    throw new Error("attemptId is required");
   }
-  const trimmed = normalise(network);
-  if (trimmed.startsWith("hedera:") || trimmed.includes("hedera-") || trimmed.includes("hedera_") || trimmed === "mainnet" || trimmed === "testnet") {
-    return normaliseHederaNetwork(trimmed);
+  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 client.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;
+      }
+    }
+    if (Date.now() - startedAt >= timeoutMs) {
+      throw new Error(
+        `Registration progress polling timed out after ${timeoutMs}ms`
+      );
+    }
+    await client.delay(interval, signal);
   }
-  return normaliseEvmNetwork(trimmed);
-};
+}
+async function validateUaid(client, uaid) {
+  const raw = await client.requestJson(
+    `/uaids/validate/${encodeURIComponent(uaid)}`,
+    {
+      method: "GET"
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    uaidValidationResponseSchema,
+    "UAID validation response"
+  );
+}
+async function getUaidConnectionStatus(client, uaid) {
+  const raw = await client.requestJson(
+    `/uaids/connections/${encodeURIComponent(uaid)}/status`,
+    {
+      method: "GET"
+    }
+  );
+  return client.parseWithSchema(
+    raw,
+    uaidConnectionStatusSchema,
+    "UAID connection status"
+  );
+}
+async function closeUaidConnection(client, uaid) {
+  await client.request(`/uaids/connections/${encodeURIComponent(uaid)}`, {
+    method: "DELETE"
+  });
+}
+async function dashboardStats(client) {
+  const raw = await client.requestJson("/dashboard/stats", {
+    method: "GET"
+  });
+  return client.parseWithSchema(
+    raw,
+    dashboardStatsResponseSchema,
+    "dashboard stats response"
+  );
+}
 export {
-  canonicalizeLedgerNetwork
+  closeUaidConnection,
+  dashboardStats,
+  getRegistrationProgress,
+  getRegistrationQuote,
+  getUaidConnectionStatus,
+  registerAgent,
+  resolveUaid,
+  updateAgent,
+  validateUaid,
+  waitForRegistrationCompletion
 };
 //# sourceMappingURL=standards-sdk.es147.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es147.js","sources":["../../src/services/registry-broker/ledger-network.ts"],"sourcesContent":["type HederaNetwork = 'mainnet' | 'testnet';\ntype LedgerNetworkKind = 'hedera' | 'evm';\n\nexport interface CanonicalLedgerNetwork {\n  canonical: string;\n  kind: LedgerNetworkKind;\n  hederaNetwork?: HederaNetwork;\n  chainId?: number;\n  legacyName?: string;\n}\n\nconst normalise = (value: string): string => value.trim().toLowerCase();\n\nconst HEDERA_NETWORK_ALIASES = new Map<\n  string,\n  { canonical: `hedera:${HederaNetwork}`; hederaNetwork: HederaNetwork }\n>([\n  ['hedera:mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera-mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera_mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera:testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera-testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera_testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n]);\n\nconst EVM_NETWORK_CHAIN_IDS: Record<string, number> = {\n  abstract: 2741,\n  'abstract-testnet': 11124,\n  base: 8453,\n  'base-sepolia': 84532,\n  avalanche: 43114,\n  'avalanche-fuji': 43113,\n  iotex: 4689,\n  sei: 1329,\n  'sei-testnet': 1328,\n  polygon: 137,\n  'polygon-amoy': 80002,\n  peaq: 3338,\n};\n\nconst CHAIN_ID_TO_ALIAS = new Map<number, string>(\n  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias]),\n);\n\nconst parseChainId = (value: string): number | undefined => {\n  if (/^eip155:\\d+$/i.test(value)) {\n    return Number.parseInt(value.split(':')[1]!, 10);\n  }\n  if (/^\\d+$/.test(value)) {\n    return Number.parseInt(value, 10);\n  }\n  return undefined;\n};\n\nconst normaliseEvmNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  let chainId = parseChainId(trimmed);\n  let alias: string | undefined;\n\n  if (chainId === undefined) {\n    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];\n    if (mapped !== undefined) {\n      chainId = mapped;\n      alias = trimmed;\n    }\n  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {\n    alias = CHAIN_ID_TO_ALIAS.get(chainId);\n  }\n\n  if (chainId === undefined) {\n    throw new Error(\n      'Unsupported EVM ledger network. Provide an alias like \"base-sepolia\" or a canonical eip155:<chainId> string.',\n    );\n  }\n\n  return {\n    canonical: `eip155:${chainId}`,\n    kind: 'evm',\n    chainId,\n    legacyName: alias,\n  };\n};\n\nconst normaliseHederaNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);\n  if (!mapping) {\n    throw new Error(\n      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy \"mainnet\"/\"testnet\" also accepted).',\n    );\n  }\n  return {\n    canonical: mapping.canonical,\n    kind: 'hedera',\n    hederaNetwork: mapping.hederaNetwork,\n  };\n};\n\nexport const canonicalizeLedgerNetwork = (\n  network: string,\n): CanonicalLedgerNetwork => {\n  if (typeof network !== 'string' || network.trim().length === 0) {\n    throw new Error('Ledger network is required.');\n  }\n  const trimmed = normalise(network);\n  if (\n    trimmed.startsWith('hedera:') ||\n    trimmed.includes('hedera-') ||\n    trimmed.includes('hedera_') ||\n    trimmed === 'mainnet' ||\n    trimmed === 'testnet'\n  ) {\n    return normaliseHederaNetwork(trimmed);\n  }\n  return normaliseEvmNetwork(trimmed);\n};\n"],"names":[],"mappings":"AAWA,MAAM,YAAY,CAAC,UAA0B,MAAM,KAAA,EAAO,YAAA;AAE1D,MAAM,6CAA6B,IAGjC;AAAA,EACA,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAC9E,CAAC;AAED,MAAM,wBAAgD;AAAA,EACpD,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,KAAK;AAAA,EACL,eAAe;AAAA,EACf,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,MAAM;AACR;AAEA,MAAM,oBAAoB,IAAI;AAAA,EAC5B,OAAO,QAAQ,qBAAqB,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC;AACxE;AAEA,MAAM,eAAe,CAAC,UAAsC;AAC1D,MAAI,gBAAgB,KAAK,KAAK,GAAG;AAC/B,WAAO,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE,CAAC,GAAI,EAAE;AAAA,EACjD;AACA,MAAI,QAAQ,KAAK,KAAK,GAAG;AACvB,WAAO,OAAO,SAAS,OAAO,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AAEA,MAAM,sBAAsB,CAAC,UAA0C;AACrE,QAAM,UAAU,UAAU,KAAK;AAC/B,MAAI,UAAU,aAAa,OAAO;AAClC,MAAI;AAEJ,MAAI,YAAY,QAAW;AACzB,UAAM,SAAS,sBAAsB,OAAO;AAC5C,QAAI,WAAW,QAAW;AACxB,gBAAU;AACV,cAAQ;AAAA,IACV;AAAA,EACF,WAAW,kBAAkB,IAAI,OAAO,GAAG;AACzC,YAAQ,kBAAkB,IAAI,OAAO;AAAA,EACvC;AAEA,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,WAAW,UAAU,OAAO;AAAA,IAC5B,MAAM;AAAA,IACN;AAAA,IACA,YAAY;AAAA,EAAA;AAEhB;AAEA,MAAM,yBAAyB,CAAC,UAA0C;AACxE,QAAM,UAAU,UAAU,KAAK;AAC/B,QAAM,UAAU,uBAAuB,IAAI,OAAO;AAClD,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,MAAM;AAAA,IACN,eAAe,QAAQ;AAAA,EAAA;AAE3B;AAEO,MAAM,4BAA4B,CACvC,YAC2B;AAC3B,MAAI,OAAO,YAAY,YAAY,QAAQ,KAAA,EAAO,WAAW,GAAG;AAC9D,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AACA,QAAM,UAAU,UAAU,OAAO;AACjC,MACE,QAAQ,WAAW,SAAS,KAC5B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,SAAS,KAC1B,YAAY,aACZ,YAAY,WACZ;AACA,WAAO,uBAAuB,OAAO;AAAA,EACvC;AACA,SAAO,oBAAoB,OAAO;AACpC;"}
+{"version":3,"file":"standards-sdk.es147.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 type { RegistryBrokerClient } from './base-client';\nimport { purchaseCreditsWithHbar } from './credits';\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\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 getRegistrationQuote(client, 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 purchaseCreditsWithHbar(client, {\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 getRegistrationQuote(client, payload);\n  if ((finalQuote.shortfallCredits ?? 0) > 0) {\n    throw new Error('Unable to purchase sufficient credits for registration');\n  }\n}\n\nexport async function resolveUaid(\n  client: RegistryBrokerClient,\n  uaid: string,\n): Promise<ResolvedAgentResponse> {\n  const raw = await client.requestJson<JsonValue>(\n    `/resolve/${encodeURIComponent(uaid)}`,\n    {\n      method: 'GET',\n    },\n  );\n  return client.parseWithSchema(\n    raw,\n    resolveResponseSchema,\n    'resolve UAID response',\n  );\n}\n\nexport async function registerAgent(\n  client: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n  options?: RegisterAgentOptions,\n): Promise<RegisterAgentResponse> {\n  const autoTopUp = options?.autoTopUp ?? client.registrationAutoTopUp;\n\n  if (!autoTopUp) {\n    return performRegisterAgent(client, payload);\n  }\n\n  await ensureCreditsForRegistration(client, payload, autoTopUp);\n\n  let retried = false;\n  while (true) {\n    try {\n      return await performRegisterAgent(client, payload);\n    } catch (error) {\n      const shortfall = client.extractInsufficientCreditsDetails(error);\n      if (shortfall && !retried) {\n        await ensureCreditsForRegistration(client, payload, autoTopUp);\n        retried = true;\n        continue;\n      }\n      throw error;\n    }\n  }\n}\n\nexport async function getRegistrationQuote(\n  client: RegistryBrokerClient,\n  payload: AgentRegistrationRequest,\n): Promise<RegisterAgentQuoteResponse> {\n  const raw = await client.requestJson<JsonValue>('/register/quote', {\n    method: 'POST',\n    body: serialiseAgentRegistrationRequest(payload),\n    headers: { 'content-type': 'application/json' },\n  });\n\n  return client.parseWithSchema(\n    raw,\n    registrationQuoteResponseSchema,\n    'registration quote response',\n  );\n}\n\nexport async function updateAgent(\n  client: RegistryBrokerClient,\n  uaid: string,\n  payload: AgentRegistrationRequest,\n): Promise<RegisterAgentResponse> {\n  const raw = await client.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 client.parseWithSchema(\n    raw,\n    registerAgentResponseSchema,\n    'update agent response',\n  );\n}\n\nexport async function getRegistrationProgress(\n  client: 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 client.requestJson<JsonValue>(\n      `/register/progress/${encodeURIComponent(normalisedAttemptId)}`,\n      { method: 'GET' },\n    );\n\n    const parsed = client.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\nexport async function waitForRegistrationCompletion(\n  client: 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 client.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 client.delay(interval, signal);\n  }\n}\n\nexport async function validateUaid(\n  client: RegistryBrokerClient,\n  uaid: string,\n): Promise<UaidValidationResponse> {\n  const raw = await client.requestJson<JsonValue>(\n    `/uaids/validate/${encodeURIComponent(uaid)}`,\n    {\n      method: 'GET',\n    },\n  );\n  return client.parseWithSchema(\n    raw,\n    uaidValidationResponseSchema,\n    'UAID validation response',\n  );\n}\n\nexport async function getUaidConnectionStatus(\n  client: RegistryBrokerClient,\n  uaid: string,\n): Promise<UaidConnectionStatus> {\n  const raw = await client.requestJson<JsonValue>(\n    `/uaids/connections/${encodeURIComponent(uaid)}/status`,\n    {\n      method: 'GET',\n    },\n  );\n  return client.parseWithSchema(\n    raw,\n    uaidConnectionStatusSchema,\n    'UAID connection status',\n  );\n}\n\nexport async function closeUaidConnection(\n  client: RegistryBrokerClient,\n  uaid: string,\n): Promise<void> {\n  await client.request(`/uaids/connections/${encodeURIComponent(uaid)}`, {\n    method: 'DELETE',\n  });\n}\n\nexport async function dashboardStats(\n  client: RegistryBrokerClient,\n): Promise<DashboardStatsResponse> {\n  const raw = await client.requestJson<JsonValue>('/dashboard/stats', {\n    method: 'GET',\n  });\n  return client.parseWithSchema(\n    raw,\n    dashboardStatsResponseSchema,\n    'dashboard stats response',\n  );\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,84 +1,90 @@
-import { optionalImportSync, optionalImport } from "./standards-sdk.es164.js";
-const unsupported = (method) => new Error(`${method} is not supported by the in-memory signer`);
-let cachedSdk = null;
-const loadHashgraphSdk = () => {
-  if (cachedSdk) {
-    return cachedSdk;
+const normalise = (value) => value.trim().toLowerCase();
+const HEDERA_NETWORK_ALIASES = /* @__PURE__ */ new Map([
+  ["hedera:mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera-mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera_mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera:testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["hedera-testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["hedera_testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }]
+]);
+const EVM_NETWORK_CHAIN_IDS = {
+  abstract: 2741,
+  "abstract-testnet": 11124,
+  base: 8453,
+  "base-sepolia": 84532,
+  avalanche: 43114,
+  "avalanche-fuji": 43113,
+  iotex: 4689,
+  sei: 1329,
+  "sei-testnet": 1328,
+  polygon: 137,
+  "polygon-amoy": 80002,
+  peaq: 3338
+};
+const CHAIN_ID_TO_ALIAS = new Map(
+  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias])
+);
+const parseChainId = (value) => {
+  if (/^eip155:\d+$/i.test(value)) {
+    return Number.parseInt(value.split(":")[1], 10);
   }
-  const resolved = optionalImportSync("@hashgraph/sdk");
-  if (resolved) {
-    cachedSdk = resolved;
-    return resolved;
+  if (/^\d+$/.test(value)) {
+    return Number.parseInt(value, 10);
   }
-  const message = "@hashgraph/sdk is required for ledger signing. Install it as a dependency to enable createPrivateKeySigner.";
-  throw new Error(message);
+  return void 0;
 };
-const loadHashgraphSdkAsync = async () => {
-  if (cachedSdk) {
-    return cachedSdk;
+const normaliseEvmNetwork = (value) => {
+  const trimmed = normalise(value);
+  let chainId = parseChainId(trimmed);
+  let alias;
+  if (chainId === void 0) {
+    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];
+    if (mapped !== void 0) {
+      chainId = mapped;
+      alias = trimmed;
+    }
+  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {
+    alias = CHAIN_ID_TO_ALIAS.get(chainId);
   }
-  const resolved = await optionalImport("@hashgraph/sdk");
-  if (resolved) {
-    cachedSdk = resolved;
-    return resolved;
+  if (chainId === void 0) {
+    throw new Error(
+      'Unsupported EVM ledger network. Provide an alias like "base-sepolia" or a canonical eip155:<chainId> string.'
+    );
   }
-  const message = "@hashgraph/sdk is required for ledger signing. Install it as a dependency to enable createPrivateKeySigner.";
-  throw new Error(message);
+  return {
+    canonical: `eip155:${chainId}`,
+    kind: "evm",
+    chainId,
+    legacyName: alias
+  };
 };
-const buildSigner = (sdk, options) => {
-  const { AccountId, LedgerId, PrivateKey, SignerSignature } = sdk;
-  if (!options.privateKey) {
-    throw new Error("privateKey is required to create a ledger signer.");
-  }
-  if (!options.accountId) {
-    throw new Error("accountId is required to create a ledger signer.");
+const normaliseHederaNetwork = (value) => {
+  const trimmed = normalise(value);
+  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);
+  if (!mapping) {
+    throw new Error(
+      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy "mainnet"/"testnet" also accepted).'
+    );
   }
-  const accountId = AccountId.fromString(options.accountId);
-  const privateKey = PrivateKey.fromString(options.privateKey);
-  const ledgerId = LedgerId.fromString(options.network);
   return {
-    getLedgerId: () => ledgerId,
-    getAccountId: () => accountId,
-    getAccountKey: () => privateKey.publicKey,
-    getNetwork: () => ({}),
-    getMirrorNetwork: () => [],
-    sign: async (messages) => Promise.all(
-      messages.map(async (message) => {
-        const signature = await privateKey.sign(message);
-        return new SignerSignature({
-          publicKey: privateKey.publicKey,
-          signature,
-          accountId
-        });
-      })
-    ),
-    getAccountBalance: async () => {
-      throw unsupported("getAccountBalance");
-    },
-    getAccountInfo: async () => {
-      throw unsupported("getAccountInfo");
-    },
-    getAccountRecords: async () => {
-      throw unsupported("getAccountRecords");
-    },
-    signTransaction: async (_) => {
-      throw unsupported("signTransaction");
-    },
-    checkTransaction: async (_) => {
-      throw unsupported("checkTransaction");
-    },
-    populateTransaction: async (_) => {
-      throw unsupported("populateTransaction");
-    },
-    call: async (_request) => {
-      throw unsupported("call");
-    }
+    canonical: mapping.canonical,
+    kind: "hedera",
+    hederaNetwork: mapping.hederaNetwork
   };
 };
-const createPrivateKeySigner = (options) => buildSigner(loadHashgraphSdk(), options);
-const createPrivateKeySignerAsync = async (options) => buildSigner(await loadHashgraphSdkAsync(), options);
+const canonicalizeLedgerNetwork = (network) => {
+  if (typeof network !== "string" || network.trim().length === 0) {
+    throw new Error("Ledger network is required.");
+  }
+  const trimmed = normalise(network);
+  if (trimmed.startsWith("hedera:") || trimmed.includes("hedera-") || trimmed.includes("hedera_") || trimmed === "mainnet" || trimmed === "testnet") {
+    return normaliseHederaNetwork(trimmed);
+  }
+  return normaliseEvmNetwork(trimmed);
+};
 export {
-  createPrivateKeySigner,
-  createPrivateKeySignerAsync
+  canonicalizeLedgerNetwork
 };
 //# sourceMappingURL=standards-sdk.es148.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es148.js","sources":["../../src/services/registry-broker/private-key-signer.ts"],"sourcesContent":["import type {\n  Signer,\n  AccountBalance,\n  AccountInfo,\n  Transaction,\n  TransactionRecord,\n  SignerSignature,\n} from '@hashgraph/sdk';\nimport { optionalImport, optionalImportSync } from '../../utils/dynamic-import';\n\nconst unsupported = (method: string): Error =>\n  new Error(`${method} is not supported by the in-memory signer`);\n\nexport interface PrivateKeySignerOptions {\n  accountId: string;\n  privateKey: string;\n  network: 'mainnet' | 'testnet';\n}\n\ntype HashgraphSdk = typeof import('@hashgraph/sdk');\n\nlet cachedSdk: HashgraphSdk | null = null;\n\nconst loadHashgraphSdk = (): HashgraphSdk => {\n  if (cachedSdk) {\n    return cachedSdk;\n  }\n  const resolved = optionalImportSync<HashgraphSdk>('@hashgraph/sdk');\n  if (resolved) {\n    cachedSdk = resolved;\n    return resolved;\n  }\n\n  const message =\n    '@hashgraph/sdk is required for ledger signing. Install it as a dependency to enable createPrivateKeySigner.';\n  throw new Error(message);\n};\n\nconst loadHashgraphSdkAsync = async (): Promise<HashgraphSdk> => {\n  if (cachedSdk) {\n    return cachedSdk;\n  }\n  const resolved = await optionalImport<HashgraphSdk>('@hashgraph/sdk');\n  if (resolved) {\n    cachedSdk = resolved;\n    return resolved;\n  }\n  const message =\n    '@hashgraph/sdk is required for ledger signing. Install it as a dependency to enable createPrivateKeySigner.';\n  throw new Error(message);\n};\n\nconst buildSigner = (\n  sdk: HashgraphSdk,\n  options: PrivateKeySignerOptions,\n): Signer => {\n  const { AccountId, LedgerId, PrivateKey, SignerSignature } = sdk;\n  if (!options.privateKey) {\n    throw new Error('privateKey is required to create a ledger signer.');\n  }\n  if (!options.accountId) {\n    throw new Error('accountId is required to create a ledger signer.');\n  }\n  const accountId = AccountId.fromString(options.accountId);\n  const privateKey = PrivateKey.fromString(options.privateKey);\n  const ledgerId = LedgerId.fromString(options.network);\n\n  return {\n    getLedgerId: () => ledgerId,\n    getAccountId: () => accountId,\n    getAccountKey: () => privateKey.publicKey,\n    getNetwork: () => ({}),\n    getMirrorNetwork: () => [],\n    sign: async (messages: Uint8Array[]): Promise<SignerSignature[]> =>\n      Promise.all(\n        messages.map(async message => {\n          const signature = await privateKey.sign(message);\n          return new SignerSignature({\n            publicKey: privateKey.publicKey,\n            signature,\n            accountId,\n          });\n        }),\n      ),\n    getAccountBalance: async (): Promise<AccountBalance> => {\n      throw unsupported('getAccountBalance');\n    },\n    getAccountInfo: async (): Promise<AccountInfo> => {\n      throw unsupported('getAccountInfo');\n    },\n    getAccountRecords: async (): Promise<TransactionRecord[]> => {\n      throw unsupported('getAccountRecords');\n    },\n    signTransaction: async <T extends Transaction>(_: T): Promise<T> => {\n      throw unsupported('signTransaction');\n    },\n    checkTransaction: async <T extends Transaction>(_: T): Promise<T> => {\n      throw unsupported('checkTransaction');\n    },\n    populateTransaction: async <T extends Transaction>(_: T): Promise<T> => {\n      throw unsupported('populateTransaction');\n    },\n    call: async <RequestT, ResponseT, OutputT>(\n      _request: unknown,\n    ): Promise<OutputT> => {\n      throw unsupported('call');\n    },\n  };\n};\n\nexport const createPrivateKeySigner = (\n  options: PrivateKeySignerOptions,\n): Signer => buildSigner(loadHashgraphSdk(), options);\n\nexport const createPrivateKeySignerAsync = async (\n  options: PrivateKeySignerOptions,\n): Promise<Signer> => buildSigner(await loadHashgraphSdkAsync(), options);\n"],"names":[],"mappings":";AAUA,MAAM,cAAc,CAAC,WACnB,IAAI,MAAM,GAAG,MAAM,2CAA2C;AAUhE,IAAI,YAAiC;AAErC,MAAM,mBAAmB,MAAoB;AAC3C,MAAI,WAAW;AACb,WAAO;AAAA,EACT;AACA,QAAM,WAAW,mBAAiC,gBAAgB;AAClE,MAAI,UAAU;AACZ,gBAAY;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,UACJ;AACF,QAAM,IAAI,MAAM,OAAO;AACzB;AAEA,MAAM,wBAAwB,YAAmC;AAC/D,MAAI,WAAW;AACb,WAAO;AAAA,EACT;AACA,QAAM,WAAW,MAAM,eAA6B,gBAAgB;AACpE,MAAI,UAAU;AACZ,gBAAY;AACZ,WAAO;AAAA,EACT;AACA,QAAM,UACJ;AACF,QAAM,IAAI,MAAM,OAAO;AACzB;AAEA,MAAM,cAAc,CAClB,KACA,YACW;AACX,QAAM,EAAE,WAAW,UAAU,YAAY,oBAAoB;AAC7D,MAAI,CAAC,QAAQ,YAAY;AACvB,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AACA,MAAI,CAAC,QAAQ,WAAW;AACtB,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AACA,QAAM,YAAY,UAAU,WAAW,QAAQ,SAAS;AACxD,QAAM,aAAa,WAAW,WAAW,QAAQ,UAAU;AAC3D,QAAM,WAAW,SAAS,WAAW,QAAQ,OAAO;AAEpD,SAAO;AAAA,IACL,aAAa,MAAM;AAAA,IACnB,cAAc,MAAM;AAAA,IACpB,eAAe,MAAM,WAAW;AAAA,IAChC,YAAY,OAAO,CAAA;AAAA,IACnB,kBAAkB,MAAM,CAAA;AAAA,IACxB,MAAM,OAAO,aACX,QAAQ;AAAA,MACN,SAAS,IAAI,OAAM,YAAW;AAC5B,cAAM,YAAY,MAAM,WAAW,KAAK,OAAO;AAC/C,eAAO,IAAI,gBAAgB;AAAA,UACzB,WAAW,WAAW;AAAA,UACtB;AAAA,UACA;AAAA,QAAA,CACD;AAAA,MACH,CAAC;AAAA,IAAA;AAAA,IAEL,mBAAmB,YAAqC;AACtD,YAAM,YAAY,mBAAmB;AAAA,IACvC;AAAA,IACA,gBAAgB,YAAkC;AAChD,YAAM,YAAY,gBAAgB;AAAA,IACpC;AAAA,IACA,mBAAmB,YAA0C;AAC3D,YAAM,YAAY,mBAAmB;AAAA,IACvC;AAAA,IACA,iBAAiB,OAA8B,MAAqB;AAClE,YAAM,YAAY,iBAAiB;AAAA,IACrC;AAAA,IACA,kBAAkB,OAA8B,MAAqB;AACnE,YAAM,YAAY,kBAAkB;AAAA,IACtC;AAAA,IACA,qBAAqB,OAA8B,MAAqB;AACtE,YAAM,YAAY,qBAAqB;AAAA,IACzC;AAAA,IACA,MAAM,OACJ,aACqB;AACrB,YAAM,YAAY,MAAM;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAEO,MAAM,yBAAyB,CACpC,YACW,YAAY,iBAAA,GAAoB,OAAO;AAE7C,MAAM,8BAA8B,OACzC,YACoB,YAAY,MAAM,sBAAA,GAAyB,OAAO;"}
+{"version":3,"file":"standards-sdk.es148.js","sources":["../../src/services/registry-broker/ledger-network.ts"],"sourcesContent":["type HederaNetwork = 'mainnet' | 'testnet';\ntype LedgerNetworkKind = 'hedera' | 'evm';\n\nexport interface CanonicalLedgerNetwork {\n  canonical: string;\n  kind: LedgerNetworkKind;\n  hederaNetwork?: HederaNetwork;\n  chainId?: number;\n  legacyName?: string;\n}\n\nconst normalise = (value: string): string => value.trim().toLowerCase();\n\nconst HEDERA_NETWORK_ALIASES = new Map<\n  string,\n  { canonical: `hedera:${HederaNetwork}`; hederaNetwork: HederaNetwork }\n>([\n  ['hedera:mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera-mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera_mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera:testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera-testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera_testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n]);\n\nconst EVM_NETWORK_CHAIN_IDS: Record<string, number> = {\n  abstract: 2741,\n  'abstract-testnet': 11124,\n  base: 8453,\n  'base-sepolia': 84532,\n  avalanche: 43114,\n  'avalanche-fuji': 43113,\n  iotex: 4689,\n  sei: 1329,\n  'sei-testnet': 1328,\n  polygon: 137,\n  'polygon-amoy': 80002,\n  peaq: 3338,\n};\n\nconst CHAIN_ID_TO_ALIAS = new Map<number, string>(\n  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias]),\n);\n\nconst parseChainId = (value: string): number | undefined => {\n  if (/^eip155:\\d+$/i.test(value)) {\n    return Number.parseInt(value.split(':')[1]!, 10);\n  }\n  if (/^\\d+$/.test(value)) {\n    return Number.parseInt(value, 10);\n  }\n  return undefined;\n};\n\nconst normaliseEvmNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  let chainId = parseChainId(trimmed);\n  let alias: string | undefined;\n\n  if (chainId === undefined) {\n    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];\n    if (mapped !== undefined) {\n      chainId = mapped;\n      alias = trimmed;\n    }\n  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {\n    alias = CHAIN_ID_TO_ALIAS.get(chainId);\n  }\n\n  if (chainId === undefined) {\n    throw new Error(\n      'Unsupported EVM ledger network. Provide an alias like \"base-sepolia\" or a canonical eip155:<chainId> string.',\n    );\n  }\n\n  return {\n    canonical: `eip155:${chainId}`,\n    kind: 'evm',\n    chainId,\n    legacyName: alias,\n  };\n};\n\nconst normaliseHederaNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);\n  if (!mapping) {\n    throw new Error(\n      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy \"mainnet\"/\"testnet\" also accepted).',\n    );\n  }\n  return {\n    canonical: mapping.canonical,\n    kind: 'hedera',\n    hederaNetwork: mapping.hederaNetwork,\n  };\n};\n\nexport const canonicalizeLedgerNetwork = (\n  network: string,\n): CanonicalLedgerNetwork => {\n  if (typeof network !== 'string' || network.trim().length === 0) {\n    throw new Error('Ledger network is required.');\n  }\n  const trimmed = normalise(network);\n  if (\n    trimmed.startsWith('hedera:') ||\n    trimmed.includes('hedera-') ||\n    trimmed.includes('hedera_') ||\n    trimmed === 'mainnet' ||\n    trimmed === 'testnet'\n  ) {\n    return normaliseHederaNetwork(trimmed);\n  }\n  return normaliseEvmNetwork(trimmed);\n};\n"],"names":[],"mappings":"AAWA,MAAM,YAAY,CAAC,UAA0B,MAAM,KAAA,EAAO,YAAA;AAE1D,MAAM,6CAA6B,IAGjC;AAAA,EACA,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAC9E,CAAC;AAED,MAAM,wBAAgD;AAAA,EACpD,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,KAAK;AAAA,EACL,eAAe;AAAA,EACf,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,MAAM;AACR;AAEA,MAAM,oBAAoB,IAAI;AAAA,EAC5B,OAAO,QAAQ,qBAAqB,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC;AACxE;AAEA,MAAM,eAAe,CAAC,UAAsC;AAC1D,MAAI,gBAAgB,KAAK,KAAK,GAAG;AAC/B,WAAO,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE,CAAC,GAAI,EAAE;AAAA,EACjD;AACA,MAAI,QAAQ,KAAK,KAAK,GAAG;AACvB,WAAO,OAAO,SAAS,OAAO,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AAEA,MAAM,sBAAsB,CAAC,UAA0C;AACrE,QAAM,UAAU,UAAU,KAAK;AAC/B,MAAI,UAAU,aAAa,OAAO;AAClC,MAAI;AAEJ,MAAI,YAAY,QAAW;AACzB,UAAM,SAAS,sBAAsB,OAAO;AAC5C,QAAI,WAAW,QAAW;AACxB,gBAAU;AACV,cAAQ;AAAA,IACV;AAAA,EACF,WAAW,kBAAkB,IAAI,OAAO,GAAG;AACzC,YAAQ,kBAAkB,IAAI,OAAO;AAAA,EACvC;AAEA,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,WAAW,UAAU,OAAO;AAAA,IAC5B,MAAM;AAAA,IACN;AAAA,IACA,YAAY;AAAA,EAAA;AAEhB;AAEA,MAAM,yBAAyB,CAAC,UAA0C;AACxE,QAAM,UAAU,UAAU,KAAK;AAC/B,QAAM,UAAU,uBAAuB,IAAI,OAAO;AAClD,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,MAAM;AAAA,IACN,eAAe,QAAQ;AAAA,EAAA;AAE3B;AAEO,MAAM,4BAA4B,CACvC,YAC2B;AAC3B,MAAI,OAAO,YAAY,YAAY,QAAQ,KAAA,EAAO,WAAW,GAAG;AAC9D,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AACA,QAAM,UAAU,UAAU,OAAO;AACjC,MACE,QAAQ,WAAW,SAAS,KAC5B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,SAAS,KAC1B,YAAY,aACZ,YAAY,WACZ;AACA,WAAO,uBAAuB,OAAO;AAAA,EACvC;AACA,SAAO,oBAAoB,OAAO;AACpC;"}