@hashgraphonline/standards-sdk 0.1.146 → 0.1.148

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es157.js","sources":["../../src/utils/parsers/scs-parser.ts"],"sourcesContent":["import { proto } from '@hashgraph/proto';\nimport { ContractId, Hbar, HbarUnit, Long, Transaction } from '@hashgraph/sdk';\nimport {\n  ContractCallData,\n  ContractCreateData,\n  ContractUpdateData,\n  ContractDeleteData,\n} from '../transaction-parser-types';\nimport { Buffer } from 'buffer';\nimport {\n  parseKey,\n  extractTransactionBody,\n  hasTransactionType,\n} from './parser-utils';\nimport { AccountId, FileId } from '@hashgraph/sdk';\n\n/**\n * Smart Contract Service (SCS) Parser\n *\n * Handles parsing for all contract-related transaction types including:\n * - Contract calls (including EthereumTransaction)\n * - Contract creation, updates, and deletion\n * - Proper dual-branch parsing (regular vs signed transactions)\n * - Comprehensive protobuf extraction\n */\nexport class SCSParser {\n  /**\n   * Parse Smart Contract Service transaction using unified dual-branch approach\n   * This handles both regular transactions and signed transaction variants\n   */\n  static parseSCSTransaction(\n    transaction: Transaction,\n    originalBytes?: Uint8Array,\n  ): {\n    type?: string;\n    humanReadableType?: string;\n    contractCall?: ContractCallData;\n    contractCreate?: ContractCreateData;\n    contractUpdate?: ContractUpdateData;\n    contractDelete?: ContractDeleteData;\n    [key: string]: unknown;\n  } {\n    try {\n      if (originalBytes || transaction.toBytes) {\n        try {\n          const bytesToParse = originalBytes || transaction.toBytes();\n          const decoded = proto.TransactionList.decode(bytesToParse);\n\n          if (decoded.transactionList && decoded.transactionList.length > 0) {\n            const tx = decoded.transactionList[0];\n            let txBody: proto.ITransactionBody | null = null;\n\n            if (tx.bodyBytes && tx.bodyBytes.length > 0) {\n              txBody = proto.TransactionBody.decode(tx.bodyBytes);\n            } else if (\n              tx.signedTransactionBytes &&\n              tx.signedTransactionBytes.length > 0\n            ) {\n              const signedTx = proto.SignedTransaction.decode(\n                tx.signedTransactionBytes,\n              );\n              if (signedTx.bodyBytes) {\n                txBody = proto.TransactionBody.decode(signedTx.bodyBytes);\n              }\n            }\n\n            if (txBody) {\n              const protoResult = this.parseFromProtobufTxBody(txBody);\n              if (protoResult.type && protoResult.type !== 'UNKNOWN') {\n                return protoResult;\n              }\n            }\n          }\n        } catch (protoError) {}\n      }\n\n      return this.parseFromTransactionInternals(transaction);\n    } catch (error) {\n      return {\n        type: 'UNKNOWN',\n        humanReadableType: 'Unknown Contract Transaction',\n      };\n    }\n  }\n\n  /**\n   * Parse contract transaction from protobuf TransactionBody\n   * Handles all contract operations from decoded protobuf data\n   */\n  private static parseFromProtobufTxBody(txBody: proto.ITransactionBody): {\n    type?: string;\n    humanReadableType?: string;\n    [key: string]: unknown;\n  } {\n    if (txBody.contractCall) {\n      const contractCall = this.parseContractCall(txBody.contractCall);\n      if (contractCall) {\n        return {\n          type: 'CONTRACTCALL',\n          humanReadableType: 'Contract Call',\n          contractCall,\n        };\n      }\n    }\n\n    if (txBody.contractCreateInstance) {\n      const contractCreate = this.parseContractCreate(\n        txBody.contractCreateInstance,\n      );\n      if (contractCreate) {\n        return {\n          type: 'CONTRACTCREATE',\n          humanReadableType: 'Contract Create',\n          contractCreate,\n        };\n      }\n    }\n\n    if (txBody.contractUpdateInstance) {\n      const contractUpdate = this.parseContractUpdate(\n        txBody.contractUpdateInstance,\n      );\n      if (contractUpdate) {\n        return {\n          type: 'CONTRACTUPDATE',\n          humanReadableType: 'Contract Update',\n          contractUpdate,\n        };\n      }\n    }\n\n    if (txBody.contractDeleteInstance) {\n      const contractDelete = this.parseContractDelete(\n        txBody.contractDeleteInstance,\n      );\n      if (contractDelete) {\n        return {\n          type: 'CONTRACTDELETE',\n          humanReadableType: 'Contract Delete',\n          contractDelete,\n        };\n      }\n    }\n\n    if (txBody.ethereumTransaction) {\n      const ethereumCall = this.parseEthereumTransaction(\n        txBody.ethereumTransaction,\n      );\n      if (ethereumCall) {\n        return {\n          type: 'ETHEREUMTRANSACTION',\n          humanReadableType: 'Ethereum Transaction',\n          ethereumTransaction: ethereumCall,\n        };\n      }\n    }\n\n    return {};\n  }\n\n  /**\n   * Extract contract data from Transaction internal fields\n   * This handles cases where data is stored in Transaction object internals\n   */\n  private static parseFromTransactionInternals(transaction: Transaction): {\n    type?: string;\n    humanReadableType?: string;\n    [key: string]: unknown;\n  } {\n    try {\n      const tx = transaction as unknown as {\n        _contractId?: { toString(): string };\n        _gas?: number | Long;\n        _amount?: { toString(): string };\n        _functionParameters?: Uint8Array;\n        _initialBalance?: { toString(): string };\n        _adminKey?: unknown;\n        _memo?: string;\n        _fileId?: { toString(): string };\n        _bytecode?: Uint8Array;\n        _constructorParameters?: Uint8Array;\n        _maxAutomaticTokenAssociations?: number;\n        _stakedAccountId?: { toString(): string };\n        _stakedNodeId?: number | Long;\n        _declineReward?: boolean;\n        _autoRenewPeriod?: { toString(): string };\n        _transferAccountId?: { toString(): string };\n        _transferContractId?: { toString(): string };\n        constructor?: { name?: string };\n      };\n\n      if (tx._contractId && tx._gas) {\n        const contractCall: ContractCallData = {\n          contractId: tx._contractId.toString(),\n          gas:\n            typeof tx._gas === 'number'\n              ? tx._gas\n              : Long.fromValue(tx._gas).toNumber(),\n          amount: tx._amount ? parseFloat(tx._amount.toString()) : 0,\n        };\n\n        if (tx._functionParameters) {\n          const funcParams = Buffer.from(tx._functionParameters).toString(\n            'hex',\n          );\n          contractCall.functionParameters = funcParams;\n          contractCall.functionName = this.extractFunctionName(funcParams);\n        }\n\n        return {\n          type: 'CONTRACTCALL',\n          humanReadableType: 'Contract Call',\n          contractCall,\n        };\n      }\n\n      if (hasTransactionType(transaction, 'contractCreateInstance')) {\n        const contractCreate: ContractCreateData = {\n          gas: tx._gas.toString(),\n          initialBalance: tx._initialBalance?.toString() || '0',\n        };\n\n        if (tx._fileId) {\n          contractCreate.initcodeSource = 'fileID';\n          contractCreate.initcode = tx._fileId.toString();\n        } else if (tx._bytecode) {\n          contractCreate.initcodeSource = 'bytes';\n          contractCreate.initcode = Buffer.from(tx._bytecode).toString('hex');\n        }\n\n        if (tx._constructorParameters) {\n          contractCreate.constructorParameters = Buffer.from(\n            tx._constructorParameters,\n          ).toString('hex');\n        }\n\n        if (tx._memo) contractCreate.memo = tx._memo;\n        if (tx._adminKey) contractCreate.adminKey = parseKey(tx._adminKey);\n        if (tx._maxAutomaticTokenAssociations !== undefined) {\n          contractCreate.maxAutomaticTokenAssociations =\n            tx._maxAutomaticTokenAssociations;\n        }\n        if (tx._stakedAccountId) {\n          contractCreate.stakedAccountId = tx._stakedAccountId.toString();\n        } else if (\n          tx._stakedNodeId !== null &&\n          tx._stakedNodeId !== undefined\n        ) {\n          contractCreate.stakedNodeId = Long.fromValue(\n            tx._stakedNodeId,\n          ).toString();\n        }\n        if (tx._declineReward !== undefined)\n          contractCreate.declineReward = tx._declineReward;\n        if (tx._autoRenewPeriod)\n          contractCreate.autoRenewPeriod = tx._autoRenewPeriod.toString();\n\n        return {\n          type: 'CONTRACTCREATE',\n          humanReadableType: 'Contract Create',\n          contractCreate,\n        };\n      }\n\n      if (hasTransactionType(transaction, 'contractUpdateInstance')) {\n        const contractUpdate: ContractUpdateData = {\n          contractIdToUpdate: tx._contractId.toString(),\n        };\n\n        if (tx._memo) contractUpdate.memo = tx._memo;\n        if (tx._adminKey) contractUpdate.adminKey = parseKey(tx._adminKey);\n        if (tx._maxAutomaticTokenAssociations !== undefined) {\n          contractUpdate.maxAutomaticTokenAssociations =\n            tx._maxAutomaticTokenAssociations;\n        }\n        if (tx._stakedAccountId) {\n          contractUpdate.stakedAccountId = tx._stakedAccountId.toString();\n        } else if (\n          tx._stakedNodeId !== null &&\n          tx._stakedNodeId !== undefined\n        ) {\n          contractUpdate.stakedNodeId = Long.fromValue(\n            tx._stakedNodeId,\n          ).toString();\n        }\n        if (tx._declineReward !== undefined)\n          contractUpdate.declineReward = tx._declineReward;\n        if (tx._autoRenewPeriod)\n          contractUpdate.autoRenewPeriod = tx._autoRenewPeriod.toString();\n\n        return {\n          type: 'CONTRACTUPDATE',\n          humanReadableType: 'Contract Update',\n          contractUpdate,\n        };\n      }\n\n      if (hasTransactionType(transaction, 'contractDeleteInstance')) {\n        const contractDelete: ContractDeleteData = {\n          contractIdToDelete: tx._contractId.toString(),\n        };\n\n        if (tx._transferAccountId) {\n          contractDelete.transferAccountId = tx._transferAccountId.toString();\n        } else if (tx._transferContractId) {\n          contractDelete.transferContractId = tx._transferContractId.toString();\n        }\n\n        return {\n          type: 'CONTRACTDELETE',\n          humanReadableType: 'Contract Delete',\n          contractDelete,\n        };\n      }\n\n      return {};\n    } catch (error) {\n      return {};\n    }\n  }\n\n  /**\n   * Enhanced function name extraction from contract call parameters\n   * Attempts to decode function selector and map to known function names\n   */\n  private static extractFunctionName(functionParameters: string): string {\n    if (functionParameters.length < 8) return 'unknown';\n\n    const selector = functionParameters.substring(0, 8);\n\n    const commonSelectors: Record<string, string> = {\n      a9059cbb: 'transfer',\n      '095ea7b3': 'approve',\n      '23b872dd': 'transferFrom',\n      '70a08231': 'balanceOf',\n      dd62ed3e: 'allowance',\n      '18160ddd': 'totalSupply',\n      '06fdde03': 'name',\n      '95d89b41': 'symbol',\n      '313ce567': 'decimals',\n      '42842e0e': 'safeTransferFrom',\n      b88d4fde: 'safeTransferFrom',\n      e985e9c5: 'isApprovedForAll',\n      a22cb465: 'setApprovalForAll',\n      '6352211e': 'ownerOf',\n      c87b56dd: 'tokenURI',\n      '01ffc9a7': 'supportsInterface',\n      '40c10f19': 'mint',\n      '42966c68': 'burn',\n      f2fde38b: 'transferOwnership',\n      '715018a6': 'renounceOwnership',\n      '8da5cb5b': 'owner',\n    };\n\n    return commonSelectors[selector] || selector;\n  }\n\n  /**\n   * Parse Ethereum Transaction (was completely missing from original parser)\n   */\n  static parseEthereumTransaction(\n    body: proto.IEthereumTransactionBody,\n  ): ContractCallData | undefined {\n    if (!body) return undefined;\n\n    const data: ContractCallData = {\n      contractId: 'EVM',\n      gas: body.maxGasAllowance\n        ? Long.fromValue(body.maxGasAllowance).toNumber()\n        : 0,\n      amount: 0,\n    };\n\n    if (body.ethereumData && body.ethereumData.length > 0) {\n      const ethData = Buffer.from(body.ethereumData).toString('hex');\n      data.functionParameters = ethData;\n\n      if (ethData.length >= 8) {\n        data.functionName = this.extractFunctionName(ethData);\n      }\n    }\n\n    return data;\n  }\n\n  static parseContractCall(\n    body: proto.IContractCallTransactionBody,\n  ): ContractCallData | undefined {\n    if (!body) return undefined;\n    const hbarAmount = Hbar.fromTinybars(Long.fromValue(body.amount ?? 0));\n    const data: ContractCallData = {\n      contractId: new ContractId(\n        body.contractID!.shardNum ?? 0,\n        body.contractID!.realmNum ?? 0,\n        body.contractID!.contractNum ?? 0,\n      ).toString(),\n      gas: Long.fromValue(body.gas ?? 0).toNumber(),\n      amount: parseFloat(hbarAmount.toString(HbarUnit.Hbar)),\n    };\n    if (body.functionParameters) {\n      data.functionParameters = Buffer.from(body.functionParameters).toString(\n        'hex',\n      );\n      if (data.functionParameters.length >= 8) {\n        data.functionName = this.extractFunctionName(data.functionParameters);\n      }\n    }\n    return data;\n  }\n\n  static parseContractCreate(\n    body: proto.IContractCreateTransactionBody,\n  ): ContractCreateData | undefined {\n    if (!body) return undefined;\n    const data: ContractCreateData = {};\n    if (body.initialBalance) {\n      data.initialBalance = Hbar.fromTinybars(\n        Long.fromValue(body.initialBalance),\n      ).toString(HbarUnit.Hbar);\n    }\n    if (body.gas) {\n      data.gas = Long.fromValue(body.gas).toString();\n    }\n    if (body.adminKey) {\n      data.adminKey = parseKey(body.adminKey);\n    }\n    if (body.constructorParameters) {\n      data.constructorParameters = Buffer.from(\n        body.constructorParameters,\n      ).toString('hex');\n    }\n    if (body.memo) {\n      data.memo = body.memo;\n    }\n    if (body.autoRenewPeriod?.seconds) {\n      data.autoRenewPeriod = Long.fromValue(\n        body.autoRenewPeriod.seconds,\n      ).toString();\n    }\n    if (body.stakedAccountId) {\n      data.stakedAccountId = new AccountId(\n        body.stakedAccountId.shardNum ?? 0,\n        body.stakedAccountId.realmNum ?? 0,\n        body.stakedAccountId.accountNum ?? 0,\n      ).toString();\n    } else if (body.stakedNodeId !== null && body.stakedNodeId !== undefined) {\n      data.stakedNodeId = Long.fromValue(body.stakedNodeId).toString();\n    }\n    if (body.declineReward !== undefined) {\n      data.declineReward = body.declineReward;\n    }\n    if (body.maxAutomaticTokenAssociations !== undefined) {\n      data.maxAutomaticTokenAssociations = body.maxAutomaticTokenAssociations;\n    }\n    if (body.fileID) {\n      data.initcodeSource = 'fileID';\n      data.initcode = new FileId(\n        body.fileID.shardNum ?? 0,\n        body.fileID.realmNum ?? 0,\n        body.fileID.fileNum ?? 0,\n      ).toString();\n    } else if (body.initcode && body.initcode.length > 0) {\n      data.initcodeSource = 'bytes';\n      data.initcode = Buffer.from(body.initcode).toString('hex');\n    }\n    return data;\n  }\n\n  static parseContractUpdate(\n    body: proto.IContractUpdateTransactionBody,\n  ): ContractUpdateData | undefined {\n    if (!body) return undefined;\n    const data: ContractUpdateData = {};\n    if (body.contractID) {\n      data.contractIdToUpdate = new ContractId(\n        body.contractID.shardNum ?? 0,\n        body.contractID.realmNum ?? 0,\n        body.contractID.contractNum ?? 0,\n      ).toString();\n    }\n    if (body.adminKey) {\n      data.adminKey = parseKey(body.adminKey);\n    }\n    if (body.expirationTime?.seconds) {\n      data.expirationTime = `${Long.fromValue(\n        body.expirationTime.seconds,\n      ).toString()}.${body.expirationTime.nanos}`;\n    }\n    if (body.autoRenewPeriod?.seconds) {\n      data.autoRenewPeriod = Long.fromValue(\n        body.autoRenewPeriod.seconds,\n      ).toString();\n    }\n\n    if (body.memo) {\n      const memoUnion = body.memo as unknown;\n      if (\n        memoUnion &&\n        typeof memoUnion === 'object' &&\n        Object.prototype.hasOwnProperty.call(memoUnion, 'value')\n      ) {\n        const value = (memoUnion as { value: unknown }).value;\n        if (value === null || value === undefined) {\n          data.memo = undefined;\n        } else {\n          data.memo = String(value);\n        }\n      } else if (typeof memoUnion === 'string') {\n        data.memo = memoUnion;\n      } else {\n        data.memo = undefined;\n      }\n    } else {\n      data.memo = undefined;\n    }\n\n    if (body.stakedAccountId) {\n      data.stakedAccountId = new AccountId(\n        body.stakedAccountId.shardNum ?? 0,\n        body.stakedAccountId.realmNum ?? 0,\n        body.stakedAccountId.accountNum ?? 0,\n      ).toString();\n      data.stakedNodeId = undefined;\n    } else if (\n      body.stakedNodeId !== null &&\n      body.stakedNodeId !== undefined &&\n      Long.fromValue(body.stakedNodeId).notEquals(-1)\n    ) {\n      data.stakedNodeId = Long.fromValue(body.stakedNodeId).toString();\n      data.stakedAccountId = undefined;\n    } else {\n      data.stakedNodeId = undefined;\n      data.stakedAccountId = undefined;\n    }\n    if (body.declineReward?.value !== undefined) {\n      data.declineReward = body.declineReward.value;\n    }\n    if (body.maxAutomaticTokenAssociations?.value !== undefined) {\n      data.maxAutomaticTokenAssociations =\n        body.maxAutomaticTokenAssociations.value;\n    }\n    if (body.autoRenewAccountId) {\n      data.autoRenewAccountId = new AccountId(\n        body.autoRenewAccountId.shardNum ?? 0,\n        body.autoRenewAccountId.realmNum ?? 0,\n        body.autoRenewAccountId.accountNum ?? 0,\n      ).toString();\n    }\n    return data;\n  }\n\n  static parseContractDelete(\n    body: proto.IContractDeleteTransactionBody,\n  ): ContractDeleteData | undefined {\n    if (!body) return undefined;\n    const data: ContractDeleteData = {};\n    if (body.contractID) {\n      data.contractIdToDelete = new ContractId(\n        body.contractID.shardNum ?? 0,\n        body.contractID.realmNum ?? 0,\n        body.contractID.contractNum ?? 0,\n      ).toString();\n    }\n    if (body.transferAccountID) {\n      data.transferAccountId = new AccountId(\n        body.transferAccountID.shardNum ?? 0,\n        body.transferAccountID.realmNum ?? 0,\n        body.transferAccountID.accountNum ?? 0,\n      ).toString();\n    } else if (body.transferContractID) {\n      data.transferContractId = new ContractId(\n        body.transferContractID.shardNum ?? 0,\n        body.transferContractID.realmNum ?? 0,\n        body.transferContractID.contractNum ?? 0,\n      ).toString();\n    }\n    return data;\n  }\n\n  /**\n   * Parse SCS (Smart Contract Service) transaction from Transaction object\n   * This is the unified entry point that delegates to the comprehensive parsing logic\n   */\n  static parseFromTransactionObject(transaction: Transaction): {\n    type?: string;\n    humanReadableType?: string;\n    [key: string]: unknown;\n  } {\n    return this.parseSCSTransaction(transaction);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es157.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.es158.js

@@ -1,334 +1,188 @@
-import { proto } from "@hashgraph/proto";
-import { Long, FileId, ContractId } from "@hashgraph/sdk";
-import { hasTransactionType } from "./standards-sdk.es159.js";
-class UtilParser {
-  /**
-   * Parse Utility/System Service transaction using unified dual-branch approach
-   * This handles both regular transactions and signed transaction variants
-   */
-  static parseUtilTransaction(transaction, originalBytes) {
-    try {
-      if (originalBytes || transaction.toBytes) {
-        try {
-          const bytesToParse = originalBytes || transaction.toBytes();
-          const decoded = proto.TransactionList.decode(bytesToParse);
-          if (decoded.transactionList && decoded.transactionList.length > 0) {
-            const tx = decoded.transactionList[0];
-            let txBody = null;
-            if (tx.bodyBytes && tx.bodyBytes.length > 0) {
-              txBody = proto.TransactionBody.decode(tx.bodyBytes);
-            } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
-              const signedTx = proto.SignedTransaction.decode(
-                tx.signedTransactionBytes
-              );
-              if (signedTx.bodyBytes) {
-                txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
-              }
-            }
-            if (txBody) {
-              const protoResult = this.parseFromProtobufTxBody(txBody);
-              if (protoResult.type && protoResult.type !== "UNKNOWN") {
-                return protoResult;
-              }
-            }
-          }
-        } catch (protoError) {
-        }
-      }
-      return this.parseFromTransactionInternals(transaction);
-    } catch (error) {
-      return {
-        type: "UNKNOWN",
-        humanReadableType: "Unknown Utility Transaction"
-      };
-    }
+import { Buffer } from "buffer";
+import { ledgerChallengeResponseSchema, ledgerVerifyResponseSchema } from "./standards-sdk.es127.js";
+import { canonicalizeLedgerNetwork } from "./standards-sdk.es129.js";
+import { createPrivateKeySignerAsync } from "./standards-sdk.es130.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;
   }
-  /**
-   * Parse utility transaction from protobuf TransactionBody
-   * Handles all utility operations from decoded protobuf data
-   */
-  static parseFromProtobufTxBody(txBody) {
-    if (txBody.utilPrng) {
-      const utilPrng = this.parseUtilPrng(txBody.utilPrng);
-      if (utilPrng) {
-        return {
-          type: "PRNG",
-          humanReadableType: "Pseudo Random Number",
-          utilPrng
-        };
-      }
-    }
-    if (txBody.freeze) {
-      const networkFreeze = this.parseNetworkFreezeFromProto(txBody.freeze);
-      if (networkFreeze) {
-        return {
-          type: "FREEZE",
-          humanReadableType: "Network Freeze",
-          freeze: networkFreeze
-        };
-      }
-    }
-    if (txBody.systemDelete) {
-      const systemDelete = this.parseSystemDeleteFromProto(txBody.systemDelete);
-      if (systemDelete) {
-        return {
-          type: "SYSTEMDELETE",
-          humanReadableType: "System Delete",
-          systemDelete
-        };
-      }
-    }
-    if (txBody.systemUndelete) {
-      const systemUndelete = this.parseSystemUndeleteFromProto(
-        txBody.systemUndelete
-      );
-      if (systemUndelete) {
-        return {
-          type: "SYSTEMUNDELETE",
-          humanReadableType: "System Undelete",
-          systemUndelete
-        };
-      }
-    }
-    if (txBody.nodeCreate) {
-      const nodeCreate = this.parseNodeCreateFromProto(txBody.nodeCreate);
-      if (nodeCreate) {
-        return {
-          type: "NODECREATE",
-          humanReadableType: "Node Create",
-          nodeCreate
-        };
-      }
-    }
-    if (txBody.nodeUpdate) {
-      const nodeUpdate = this.parseNodeUpdateFromProto(txBody.nodeUpdate);
-      if (nodeUpdate) {
-        return {
-          type: "NODEUPDATE",
-          humanReadableType: "Node Update",
-          nodeUpdate
-        };
-      }
-    }
-    if (txBody.nodeDelete) {
-      const nodeDelete = this.parseNodeDeleteFromProto(txBody.nodeDelete);
-      if (nodeDelete) {
-        return {
-          type: "NODEDELETE",
-          humanReadableType: "Node Delete",
-          nodeDelete
-        };
-      }
+}
+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 {};
+    return result;
   }
-  /**
-   * Extract utility data from Transaction internal fields
-   * This handles cases where data is stored in Transaction object internals
-   */
-  static parseFromTransactionInternals(transaction) {
-    try {
-      const tx = transaction;
-      if (hasTransactionType(transaction, "utilPrng")) {
-        const utilPrng = {};
-        if (tx._range && tx._range !== 0) {
-          utilPrng.range = tx._range;
-        }
-        return {
-          type: "PRNG",
-          humanReadableType: "Pseudo Random Number",
-          utilPrng
-        };
-      }
-      if (hasTransactionType(transaction, "freeze")) {
-        const networkFreeze = {};
-        if (tx._startTime) {
-          networkFreeze.startTime = tx._startTime.toString();
-        }
-        if (tx._endTime) {
-          networkFreeze.endTime = tx._endTime.toString();
-        }
-        if (tx._updateFile) {
-          networkFreeze.updateFile = tx._updateFile.toString();
-        }
-        if (tx._fileHash) {
-          networkFreeze.fileHash = Buffer.from(tx._fileHash).toString("hex");
-        }
-        if (tx._freezeType) {
-          networkFreeze.freezeType = tx._freezeType;
-        }
-        return {
-          type: "FREEZE",
-          humanReadableType: "Network Freeze",
-          freeze: networkFreeze
-        };
-      }
-      if (hasTransactionType(transaction, "systemDelete")) {
-        const systemDelete = {};
-        if (tx._fileId) {
-          systemDelete.fileId = tx._fileId.toString();
-        } else if (tx._contractId) {
-          systemDelete.contractId = tx._contractId.toString();
-        }
-        if (tx._expirationTime) {
-          systemDelete.expirationTime = tx._expirationTime.toString();
-        }
-        return {
-          type: "SYSTEMDELETE",
-          humanReadableType: "System Delete",
-          systemDelete
-        };
-      }
-      if (hasTransactionType(transaction, "systemUndelete")) {
-        const systemUndelete = {};
-        if (tx._fileId) {
-          systemUndelete.fileId = tx._fileId.toString();
-        } else if (tx._contractId) {
-          systemUndelete.contractId = tx._contractId.toString();
-        }
-        return {
-          type: "SYSTEMUNDELETE",
-          humanReadableType: "System Undelete",
-          systemUndelete
-        };
-      }
-      return {};
-    } catch (error) {
-      return {};
-    }
+  if (!options.signer || typeof options.signer.sign !== "function") {
+    throw new Error(
+      "Ledger authentication requires a Hedera Signer or custom sign function."
+    );
   }
-  /**
-   * Parse Network Freeze from protobuf data
-   */
-  static parseNetworkFreezeFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.startTime?.seconds) {
-      data.startTime = `${Long.fromValue(
-        body.startTime.seconds
-      ).toString()}.${body.startTime.nanos ?? 0}`;
-    }
-    if (body.updateFile) {
-      data.updateFile = new FileId(
-        body.updateFile.shardNum ?? 0,
-        body.updateFile.realmNum ?? 0,
-        body.updateFile.fileNum ?? 0
-      ).toString();
-    }
-    if (body.fileHash && body.fileHash.length > 0) {
-      data.fileHash = Buffer.from(body.fileHash).toString("hex");
-    }
-    if (body.freezeType !== void 0) {
-      const freezeTypes = [
-        "FREEZE_ONLY",
-        "PREPARE_UPGRADE",
-        "FREEZE_UPGRADE",
-        "FREEZE_ABORT"
-      ];
-      data.freezeType = freezeTypes[body.freezeType] || "FREEZE_ONLY";
-    }
-    return data;
+  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.");
   }
-  /**
-   * Parse System Delete from protobuf data
-   */
-  static parseSystemDeleteFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.fileID) {
-      data.fileId = new FileId(
-        body.fileID.shardNum ?? 0,
-        body.fileID.realmNum ?? 0,
-        body.fileID.fileNum ?? 0
-      ).toString();
-    } else if (body.contractID) {
-      data.contractId = new ContractId(
-        body.contractID.shardNum ?? 0,
-        body.contractID.realmNum ?? 0,
-        body.contractID.contractNum ?? 0
-      ).toString();
-    }
-    if (body.expirationTime?.seconds) {
-      data.expirationTime = Long.fromValue(
-        body.expirationTime.seconds
-      ).toString();
+  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();
     }
-    return data;
   }
-  /**
-   * Parse System Undelete from protobuf data
-   */
-  static parseSystemUndeleteFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.fileID) {
-      data.fileId = new FileId(
-        body.fileID.shardNum ?? 0,
-        body.fileID.realmNum ?? 0,
-        body.fileID.fileNum ?? 0
-      ).toString();
-    } else if (body.contractID) {
-      data.contractId = new ContractId(
-        body.contractID.shardNum ?? 0,
-        body.contractID.realmNum ?? 0,
-        body.contractID.contractNum ?? 0
-      ).toString();
-    }
-    return data;
+  return {
+    signature: Buffer.from(signatureEntry.signature).toString("base64"),
+    signatureKind: "raw",
+    publicKey: derivedPublicKey
+  };
+}
+async function createLedgerChallenge(client, payload) {
+  const resolvedNetwork = canonicalizeLedgerNetwork(payload.network);
+  const network = resolvedNetwork.kind === "hedera" ? resolvedNetwork.hederaNetwork ?? resolvedNetwork.canonical : resolvedNetwork.canonical;
+  const raw = await client.requestJson("/auth/ledger/challenge", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: {
+      accountId: payload.accountId,
+      network
+    }
+  });
+  return client.parseWithSchema(
+    raw,
+    ledgerChallengeResponseSchema,
+    "ledger challenge response"
+  );
+}
+async function verifyLedgerChallenge(client, 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;
   }
-  /**
-   * Parse Node Create from protobuf data
-   */
-  static parseNodeCreateFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.nodeId !== void 0) {
-      data.nodeId = Long.fromValue(body.nodeId).toNumber();
-    }
-    return data;
+  if (payload.publicKey) {
+    body.publicKey = payload.publicKey;
   }
-  /**
-   * Parse Node Update from protobuf data
-   */
-  static parseNodeUpdateFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.nodeId !== void 0) {
-      data.nodeId = Long.fromValue(body.nodeId).toNumber();
-    }
-    return data;
+  if (typeof payload.expiresInMinutes === "number") {
+    body.expiresInMinutes = payload.expiresInMinutes;
   }
-  /**
-   * Parse Node Delete from protobuf data
-   */
-  static parseNodeDeleteFromProto(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.nodeId !== void 0) {
-      data.nodeId = Long.fromValue(body.nodeId).toNumber();
+  const raw = await client.requestJson("/auth/ledger/verify", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body
+  });
+  const result = client.parseWithSchema(
+    raw,
+    ledgerVerifyResponseSchema,
+    "ledger verification response"
+  );
+  client.setLedgerApiKey(result.key);
+  return result;
+}
+async function authenticateWithLedger(client, options) {
+  const challenge = await client.createLedgerChallenge({
+    accountId: options.accountId,
+    network: options.network
+  });
+  const signed = await resolveLedgerAuthSignature(challenge.message, options);
+  const verification = await client.verifyLedgerChallenge({
+    challengeId: challenge.challengeId,
+    accountId: options.accountId,
+    network: options.network,
+    signature: signed.signature,
+    signatureKind: signed.signatureKind,
+    publicKey: signed.publicKey,
+    expiresInMinutes: options.expiresInMinutes
+  });
+  return verification;
+}
+async function authenticateWithLedgerCredentials(client, 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."
+      );
     }
-    return data;
-  }
-  static parseUtilPrng(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.range && body.range !== 0) {
-      data.range = body.range;
+    authOptions.signer = await createPrivateKeySignerAsync({
+      accountId,
+      privateKey: hederaPrivateKey,
+      network: resolvedNetwork.hederaNetwork
+    });
+  } else if (evmPrivateKey) {
+    if (resolvedNetwork.kind !== "evm") {
+      throw new Error(
+        "evmPrivateKey can only be used with CAIP-2 EVM networks (eip155:<chainId>)."
+      );
     }
-    return data;
-  }
-  static parseFreeze(body) {
-    return this.parseNetworkFreezeFromProto(body);
+    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."
+    );
   }
-  /**
-   * Parse Utility/System Service transaction from Transaction object
-   * This is the unified entry point that delegates to the comprehensive parsing logic
-   */
-  static parseFromTransactionObject(transaction) {
-    return this.parseUtilTransaction(transaction);
+  logger?.info?.(
+    `Authenticating ledger account ${accountId} (${resolvedNetwork.canonical})${labelSuffix}...`
+  );
+  const verification = await client.authenticateWithLedger(authOptions);
+  if (setAccountHeader) {
+    client.setDefaultHeader("x-account-id", verification.accountId);
   }
+  logger?.info?.(
+    `Ledger authentication complete${labelSuffix}. Issued key prefix: ${verification.apiKey.prefix}…${verification.apiKey.lastFour}`
+  );
+  return verification;
 }
 export {
-  UtilParser
+  authenticateWithLedger,
+  authenticateWithLedgerCredentials,
+  createLedgerChallenge,
+  verifyLedgerChallenge
 };
 //# sourceMappingURL=standards-sdk.es158.js.map