@dynamic-labs-sdk/aleo 1.28.0 → 1.30.0

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":["packageName","packageVersion"],"sources":["../src/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.ts","../src/errors/NotAleoProviderError/NotAleoProviderError.ts","../src/isAleoNetworkProvider/isAleoNetworkProvider.ts","../src/isAleoWalletAccount/isAleoWalletAccount.ts","../src/isAleoWalletProvider/isAleoWalletProvider.ts","../src/utils/isAleoMainnet/isAleoMainnet.ts","../src/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.ts","../src/exports/index.ts"],"sourcesContent":["import { BaseError } from '@dynamic-labs-sdk/client';\n\n/**\n * Thrown when an input meant to be an Aleo transaction id (`at1...`) does\n * not match the bech32 pattern. Carries the offending value on `txId` for\n * inclusion in error logs / UI surfaces.\n */\nexport class InvalidAleoTransactionIdError extends BaseError {\n  public readonly txId: string;\n\n  constructor(params: { txId: string }) {\n    super({\n      cause: null,\n      code: 'invalid_aleo_transaction_id_error',\n      docsUrl: null,\n      name: 'InvalidAleoTransactionIdError',\n      shortMessage: `Invalid Aleo transaction id: ${params.txId}`,\n    });\n\n    this.txId = params.txId;\n  }\n}\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\n/**\n * Thrown by Aleo-specific top-level helpers (`signMessage`,\n * `requestTransaction`, `decrypt`, `requestRecords`) when the wallet\n * provider resolved from a wallet account is not an Aleo provider — i.e.\n * the caller passed a wallet account from a different chain. Carries the\n * offending provider's key on `providerKey`.\n */\nexport class NotAleoProviderError extends BaseError {\n  public readonly providerKey: string;\n\n  constructor(params: { providerKey: string }) {\n    super({\n      cause: null,\n      code: 'not_aleo_provider_error',\n      docsUrl: null,\n      name: 'NotAleoProviderError',\n      shortMessage: 'Provider is not an Aleo wallet provider',\n    });\n\n    this.providerKey = params.providerKey;\n  }\n}\n","import type { NetworkProvider } from '@dynamic-labs-sdk/client';\n\nimport type { AleoNetworkProvider } from '../AleoNetworkProvider.types';\n\n/**\n * Type guard narrowing a generic `NetworkProvider` to `AleoNetworkProvider`.\n * Use this to filter the network-provider registry down to the Aleo\n * network providers.\n *\n * @example\n * ```ts\n * if (isAleoNetworkProvider(networkProvider)) {\n *   const network = networkProvider.getNetwork();\n * }\n * ```\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an Aleo network provider, false otherwise.\n * @see isAleoWalletAccount\n * @see getNetworkByChainId\n * @notInstrumented\n */\nexport const isAleoNetworkProvider = (\n  networkProvider: NetworkProvider\n): networkProvider is AleoNetworkProvider => networkProvider.chain === 'ALEO';\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { AleoWalletAccount } from '../AleoWalletAccount.types';\n\n/**\n * Type guard narrowing a generic `WalletAccount` to `AleoWalletAccount`.\n * Use this to filter mixed-chain wallet account lists down to the Aleo\n * accounts.\n *\n * @example\n * ```ts\n * const accounts = getWalletAccounts();\n * const aleoAccounts = accounts.filter(isAleoWalletAccount);\n * ```\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an Aleo wallet account, false otherwise.\n * @see isAleoNetworkProvider\n * @see isAleoWalletProvider\n * @notInstrumented\n */\nexport const isAleoWalletAccount = (\n  walletAccount: WalletAccount\n): walletAccount is AleoWalletAccount => walletAccount.chain === 'ALEO';\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { AleoWalletProvider } from '../AleoWalletProvider.types';\n\n/**\n * Type guard narrowing a generic `WalletProvider` to `AleoWalletProvider`.\n * Returns `true` when the provider's chain is `'ALEO'`. Mirrors the\n * `is{Chain}WalletProvider` pattern used by the sibling chain packages\n * (Tron, Sui, Aptos) — exposes the Aleo-specific methods like\n * `requestTransaction`, `decrypt`, and `requestRecords` to the caller.\n *\n * @example\n * ```ts\n * if (isAleoWalletProvider(provider)) {\n *   const records = await provider.requestRecords({ program: 'credits.aleo' });\n * }\n * ```\n *\n * @param provider - The wallet provider to check.\n * @returns True if the wallet provider is an Aleo wallet provider, false otherwise.\n * @see isAleoWalletAccount\n * @see isAleoNetworkProvider\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- standard type-guard signature shared with sibling chains\nexport const isAleoWalletProvider = (\n  provider: WalletProvider | AleoWalletProvider\n): provider is AleoWalletProvider => {\n  return provider.chain === 'ALEO';\n};\n","import { ALEO_MAINNET_NETWORK_ID } from '../constants';\n\n/**\n * Whether a numeric/string chain id points at the Aleo mainnet (`0`)\n * rather than a testnet. Both numeric and string ids are accepted so\n * callers can pass `walletAccount.activeNetworkId` (which is stringly-\n * typed) directly. `undefined` and `null` resolve to `false` so a\n * stale or unknown id falls back to testnet behaviour at the call\n * site.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single primitive arg; named-arg ceremony would not improve clarity\nexport const isAleoMainnet = (\n  networkId: number | string | undefined | null\n): boolean => {\n  if (networkId === undefined || networkId === null) return false;\n  if (typeof networkId === 'number') {\n    return networkId === ALEO_MAINNET_NETWORK_ID;\n  }\n  return Number(networkId) === ALEO_MAINNET_NETWORK_ID;\n};\n","import { InvalidAleoTransactionIdError } from '../../errors/InvalidAleoTransactionIdError';\nimport { isAleoMainnet } from '../isAleoMainnet';\n\n/**\n * Aleo transaction ids are bech32-encoded with the `at1` prefix and a body\n * of lowercase alphanumerics — same character set as account addresses. We\n * validate strictly before letting the id reach the URL, refusing `/`, `?`,\n * `#`, `..`, etc. so a hostile id cannot produce path traversal or an open\n * redirect when the rendered URL is opened.\n */\nconst ALEO_TX_ID_PATTERN = /^at1[a-z0-9]{1,62}$/;\n\ntype GetAleoExplorerTxUrlParams = {\n  /**\n   * `0` = mainnet, `1` = testnet. When omitted, defaults to testnet so a\n   * stale UI never accidentally links to a mainnet explorer for a testnet\n   * transaction.\n   */\n  networkId?: number | string;\n  /** Aleo transaction id (`at1...`). */\n  txId: string;\n};\n\n/**\n * Build the Provable explorer URL for an Aleo transaction id.\n *\n * @example\n * ```ts\n * const url = getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 0 });\n * // → 'https://explorer.provable.com/transaction/at1abc...'\n * ```\n *\n * @param params.txId - Aleo transaction id (`at1...`).\n * @param [params.networkId] - `0` = mainnet, `1` = testnet.\n * @returns The Provable explorer URL for the transaction.\n * @throws {InvalidAleoTransactionIdError} When `txId` is not a well-formed bech32 Aleo transaction id.\n * @see getNetworkByChainId\n * @see isAleoWalletAccount\n * @notInstrumented\n */\nexport const getAleoExplorerTxUrl = ({\n  txId,\n  networkId,\n}: GetAleoExplorerTxUrlParams): string => {\n  if (!ALEO_TX_ID_PATTERN.test(txId)) {\n    throw new InvalidAleoTransactionIdError({ txId });\n  }\n  const subdomain = isAleoMainnet(networkId) ? '' : 'testnet.';\n  return `https://${subdomain}explorer.provable.com/transaction/${txId}`;\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { AleoFeatureUnsupportedError } from '../errors/AleoFeatureUnsupportedError';\nexport { InvalidAleoTransactionIdError } from '../errors/InvalidAleoTransactionIdError';\nexport { NotAleoProviderError } from '../errors/NotAleoProviderError';\nexport { isAleoNetworkProvider } from '../isAleoNetworkProvider';\nexport { isAleoWalletAccount } from '../isAleoWalletAccount';\nexport { isAleoWalletProvider } from '../isAleoWalletProvider';\nexport type { AleoNetworkProvider } from '../AleoNetworkProvider.types';\nexport type { AleoWalletAccount } from '../AleoWalletAccount.types';\nexport type {\n  AleoDecryptOptions,\n  AleoRequestRecordsOptions,\n  AleoTransaction,\n  AleoTransition,\n  AleoWalletProvider,\n} from '../AleoWalletProvider.types';\nexport { getAleoExplorerTxUrl } from '../utils/getAleoExplorerTxUrl';\nexport {\n  ALEO_NETWORK_TO_ID_MAP,\n  getNetworkByChainId,\n} from '../utils/getNetworkByChainId';\nexport {\n  ALEO_MAINNET_NETWORK_ID,\n  ALEO_TESTNET_NETWORK_ID,\n  MICROCREDITS_PER_CREDIT,\n} from '../utils/constants';\n"],"mappings":";;;;;;;;;;AAOA,IAAa,gCAAb,cAAmD,UAAU;CAC3D,AAAgB;CAEhB,YAAY,QAA0B;AACpC,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,gCAAgC,OAAO;GACtD,CAAC;AAEF,OAAK,OAAO,OAAO;;;;;;;;;;;;;ACVvB,IAAa,uBAAb,cAA0C,UAAU;CAClD,AAAgB;CAEhB,YAAY,QAAiC;AAC3C,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;AAEF,OAAK,cAAc,OAAO;;;;;;;;;;;;;;;;;;;;;;;;ACC9B,MAAa,yBACX,oBAC2C,gBAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;ACHvE,MAAa,uBACX,kBACuC,cAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;ACEjE,MAAa,wBACX,aACmC;AACnC,QAAO,SAAS,UAAU;;;;;;;;;;;;;;;ACf5B,MAAa,iBACX,cACY;AACZ,KAAI,cAAc,UAAa,cAAc,KAAM,QAAO;AAC1D,KAAI,OAAO,cAAc,SACvB,QAAO,cAAc;AAEvB,QAAO,OAAO,UAAU,KAAK;;;;;;;;;;;;ACV/B,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;AA8B3B,MAAa,wBAAwB,EACnC,MACA,gBACwC;AACxC,KAAI,CAAC,mBAAmB,KAAK,KAAK,CAChC,OAAM,IAAI,8BAA8B,EAAE,MAAM,CAAC;AAGnD,QAAO,WADW,cAAc,UAAU,GAAG,KAAK,WACtB,oCAAoC;;;;;AC1ClE,qBAAqBA,MAAaC,QAAe"}
+{"version":3,"file":"index.esm.js","names":["packageName","packageVersion"],"sources":["../src/errors/NotAleoProviderError/NotAleoProviderError.ts","../src/isAleoNetworkProvider/isAleoNetworkProvider.ts","../src/isAleoWalletAccount/isAleoWalletAccount.ts","../src/isAleoWalletProvider/isAleoWalletProvider.ts","../src/utils/isAleoMainnet/isAleoMainnet.ts","../src/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.ts","../src/exports/index.ts"],"sourcesContent":["import { BaseError } from '@dynamic-labs-sdk/client';\n\n/**\n * Thrown by Aleo-specific top-level helpers (`signMessage`,\n * `requestTransaction`, `decrypt`, `requestRecords`) when the wallet\n * provider resolved from a wallet account is not an Aleo provider — i.e.\n * the caller passed a wallet account from a different chain. Carries the\n * offending provider's key on `providerKey`.\n */\nexport class NotAleoProviderError extends BaseError {\n  public readonly providerKey: string;\n\n  constructor(params: { providerKey: string }) {\n    super({\n      cause: null,\n      code: 'not_aleo_provider_error',\n      docsUrl: null,\n      name: 'NotAleoProviderError',\n      shortMessage: 'Provider is not an Aleo wallet provider',\n    });\n\n    this.providerKey = params.providerKey;\n  }\n}\n","import type { NetworkProvider } from '@dynamic-labs-sdk/client';\n\nimport type { AleoNetworkProvider } from '../AleoNetworkProvider.types';\n\n/**\n * Type guard narrowing a generic `NetworkProvider` to `AleoNetworkProvider`.\n * Use this to filter the network-provider registry down to the Aleo\n * network providers.\n *\n * @example\n * ```ts\n * if (isAleoNetworkProvider(networkProvider)) {\n *   const network = networkProvider.getNetwork();\n * }\n * ```\n *\n * @param networkProvider - The network provider to check.\n * @returns True if the network provider is an Aleo network provider, false otherwise.\n * @see isAleoWalletAccount\n * @see getNetworkByChainId\n * @notInstrumented\n */\nexport const isAleoNetworkProvider = (\n  networkProvider: NetworkProvider\n): networkProvider is AleoNetworkProvider => networkProvider.chain === 'ALEO';\n","import type { WalletAccount } from '@dynamic-labs-sdk/client';\n\nimport type { AleoWalletAccount } from '../AleoWalletAccount.types';\n\n/**\n * Type guard narrowing a generic `WalletAccount` to `AleoWalletAccount`.\n * Use this to filter mixed-chain wallet account lists down to the Aleo\n * accounts.\n *\n * @example\n * ```ts\n * const accounts = getWalletAccounts();\n * const aleoAccounts = accounts.filter(isAleoWalletAccount);\n * ```\n *\n * @param walletAccount - The wallet account to check.\n * @returns True if the wallet account is an Aleo wallet account, false otherwise.\n * @see isAleoNetworkProvider\n * @see isAleoWalletProvider\n * @notInstrumented\n */\nexport const isAleoWalletAccount = (\n  walletAccount: WalletAccount\n): walletAccount is AleoWalletAccount => walletAccount.chain === 'ALEO';\n","import type { WalletProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { AleoWalletProvider } from '../AleoWalletProvider.types';\n\n/**\n * Type guard narrowing a generic `WalletProvider` to `AleoWalletProvider`.\n * Returns `true` when the provider's chain is `'ALEO'`. Mirrors the\n * `is{Chain}WalletProvider` pattern used by the sibling chain packages\n * (Tron, Sui, Aptos) — exposes the Aleo-specific methods like\n * `requestTransaction`, `decrypt`, and `requestRecords` to the caller.\n *\n * @example\n * ```ts\n * if (isAleoWalletProvider(provider)) {\n *   const records = await provider.requestRecords({ program: 'credits.aleo' });\n * }\n * ```\n *\n * @param provider - The wallet provider to check.\n * @returns True if the wallet provider is an Aleo wallet provider, false otherwise.\n * @see isAleoWalletAccount\n * @see isAleoNetworkProvider\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- standard type-guard signature shared with sibling chains\nexport const isAleoWalletProvider = (\n  provider: WalletProvider | AleoWalletProvider\n): provider is AleoWalletProvider => {\n  return provider.chain === 'ALEO';\n};\n","import { ALEO_MAINNET_NETWORK_ID } from '../constants';\n\n/**\n * Whether a numeric/string chain id points at the Aleo mainnet (`0`)\n * rather than a testnet. Both numeric and string ids are accepted so\n * callers can pass `walletAccount.activeNetworkId` (which is stringly-\n * typed) directly. `undefined` and `null` resolve to `false` so a\n * stale or unknown id falls back to testnet behaviour at the call\n * site.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single primitive arg; named-arg ceremony would not improve clarity\nexport const isAleoMainnet = (\n  networkId: number | string | undefined | null\n): boolean => {\n  if (networkId === undefined || networkId === null) return false;\n  if (typeof networkId === 'number') {\n    return networkId === ALEO_MAINNET_NETWORK_ID;\n  }\n  return Number(networkId) === ALEO_MAINNET_NETWORK_ID;\n};\n","import { InvalidAleoTransactionIdError } from '../../errors/InvalidAleoTransactionIdError';\nimport { isAleoMainnet } from '../isAleoMainnet';\n\n/**\n * Aleo transaction ids are bech32-encoded with the `at1` prefix and a body\n * of lowercase alphanumerics — same character set as account addresses. We\n * validate strictly before letting the id reach the URL, refusing `/`, `?`,\n * `#`, `..`, etc. so a hostile id cannot produce path traversal or an open\n * redirect when the rendered URL is opened.\n */\nconst ALEO_TX_ID_PATTERN = /^at1[a-z0-9]{1,62}$/;\n\ntype GetAleoExplorerTxUrlParams = {\n  /**\n   * `0` = mainnet, `1` = testnet. When omitted, defaults to testnet so a\n   * stale UI never accidentally links to a mainnet explorer for a testnet\n   * transaction.\n   */\n  networkId?: number | string;\n  /** Aleo transaction id (`at1...`). */\n  txId: string;\n};\n\n/**\n * Build the Provable explorer URL for an Aleo transaction id.\n *\n * @example\n * ```ts\n * const url = getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 0 });\n * // → 'https://explorer.provable.com/transaction/at1abc...'\n * ```\n *\n * @param params.txId - Aleo transaction id (`at1...`).\n * @param [params.networkId] - `0` = mainnet, `1` = testnet.\n * @returns The Provable explorer URL for the transaction.\n * @throws {InvalidAleoTransactionIdError} When `txId` is not a well-formed bech32 Aleo transaction id.\n * @see getNetworkByChainId\n * @see isAleoWalletAccount\n * @notInstrumented\n */\nexport const getAleoExplorerTxUrl = ({\n  txId,\n  networkId,\n}: GetAleoExplorerTxUrlParams): string => {\n  if (!ALEO_TX_ID_PATTERN.test(txId)) {\n    throw new InvalidAleoTransactionIdError({ txId });\n  }\n  const subdomain = isAleoMainnet(networkId) ? '' : 'testnet.';\n  return `https://${subdomain}explorer.provable.com/transaction/${txId}`;\n};\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { AleoFeatureUnsupportedError } from '../errors/AleoFeatureUnsupportedError';\nexport { AleoInvalidTransactionError } from '../errors/AleoInvalidTransactionError';\nexport { InvalidAleoTransactionIdError } from '../errors/InvalidAleoTransactionIdError';\nexport { NotAleoProviderError } from '../errors/NotAleoProviderError';\nexport { isAleoNetworkProvider } from '../isAleoNetworkProvider';\nexport { isAleoWalletAccount } from '../isAleoWalletAccount';\nexport { isAleoWalletProvider } from '../isAleoWalletProvider';\nexport type { AleoNetworkProvider } from '../AleoNetworkProvider.types';\nexport type { AleoWalletAccount } from '../AleoWalletAccount.types';\nexport type {\n  AleoDecryptOptions,\n  AleoRequestRecordsOptions,\n  AleoTransaction,\n  AleoTransition,\n  AleoWalletProvider,\n} from '../AleoWalletProvider.types';\nexport { getAleoExplorerTxUrl } from '../utils/getAleoExplorerTxUrl';\nexport {\n  ALEO_NETWORK_TO_ID_MAP,\n  getNetworkByChainId,\n} from '../utils/getNetworkByChainId';\nexport {\n  ALEO_MAINNET_NETWORK_ID,\n  ALEO_TESTNET_NETWORK_ID,\n  MICROCREDITS_PER_CREDIT,\n} from '../utils/constants';\n"],"mappings":";;;;;;;;;;;;;;AASA,IAAa,uBAAb,cAA0C,UAAU;CAClD,AAAgB;CAEhB,YAAY,QAAiC;AAC3C,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;AAEF,OAAK,cAAc,OAAO;;;;;;;;;;;;;;;;;;;;;;;;ACC9B,MAAa,yBACX,oBAC2C,gBAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;ACHvE,MAAa,uBACX,kBACuC,cAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;ACEjE,MAAa,wBACX,aACmC;AACnC,QAAO,SAAS,UAAU;;;;;;;;;;;;;;;ACf5B,MAAa,iBACX,cACY;AACZ,KAAI,cAAc,UAAa,cAAc,KAAM,QAAO;AAC1D,KAAI,OAAO,cAAc,SACvB,QAAO,cAAc;AAEvB,QAAO,OAAO,UAAU,KAAK;;;;;;;;;;;;ACV/B,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;AA8B3B,MAAa,wBAAwB,EACnC,MACA,gBACwC;AACxC,KAAI,CAAC,mBAAmB,KAAK,KAAK,CAChC,OAAM,IAAI,8BAA8B,EAAE,MAAM,CAAC;AAGnD,QAAO,WADW,cAAc,UAAU,GAAG,KAAK,WACtB,oCAAoC;;;;;AC1ClE,qBAAqBA,MAAaC,QAAe"}

package/dist/registerAleoNetworkProviderBuilder-ByQwv6MA.cjs

@@ -0,0 +1,158 @@
+const require_constants = require('./constants-BoB0_3u4.cjs');
+let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
+
+//#region src/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.ts
+const MICROCREDITS_PER_CREDIT_BIGINT = BigInt(require_constants.MICROCREDITS_PER_CREDIT);
+const MICROCREDIT_DECIMAL_DIGITS = String(require_constants.MICROCREDITS_PER_CREDIT).length - 1;
+/**
+* Bounded trailing-zero strip. `padStart` produces a fractional string
+* of exactly `MICROCREDIT_DECIMAL_DIGITS` characters, so the quantifier
+* upper bound matches the maximum possible run of trailing zeros —
+* keeps the regex linear and avoids the unbounded-quantifier hotspot.
+*/
+const TRAILING_ZEROS_PATTERN = /0{1,6}$/;
+/**
+* Format microcredits (bigint) as a decimal credits string without
+* losing precision for balances beyond `Number.MAX_SAFE_INTEGER`.
+*
+* The integer credits portion and the microcredits remainder are
+* computed in the bigint domain, then the remainder is zero-padded to
+* six digits and trailing fractional zeros are trimmed. Whole-credit
+* balances render without a redundant `.000000` suffix.
+*
+* @notInstrumented
+*/
+const formatMicrocreditsAsCredits = (microcredits) => {
+	const credits = microcredits / MICROCREDITS_PER_CREDIT_BIGINT;
+	const fractional = (microcredits % MICROCREDITS_PER_CREDIT_BIGINT).toString().padStart(MICROCREDIT_DECIMAL_DIGITS, "0").replace(TRAILING_ZEROS_PATTERN, "");
+	return fractional.length > 0 ? `${credits}.${fractional}` : `${credits}`;
+};
+
+//#endregion
+//#region src/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.ts
+const U64_PRIVATE_SUFFIX = "u64.private";
+const U64_SUFFIX = "u64";
+/**
+* Parse an Aleo VM mapping plaintext literal into microcredits.
+*
+* Accepts the shapes the Aleo `account` mapping endpoint actually
+* emits — e.g. `1500000u64.private`, `1_500_000u64`, or a bare integer
+* wrapped in JSON quotes. Strips the trailing `u64` / `u64.private`
+* type suffix, surrounding quotes, and the cosmetic `_` group
+* separators Aleo plaintext literals allow.
+*
+* Returns `0n` for empty input and for any payload that doesn't parse
+* as an integer. `BigInt()` throws `SyntaxError` on anything that
+* isn't a parseable integer — a corrupted RPC response, a mid-flight
+* truncation, or an upstream API change could deliver such a payload,
+* and we'd rather show a zero balance than crash the network-provider
+* machinery with an unhandled rejection.
+*
+* @notInstrumented
+*/
+const parseAleoMicrocreditsLiteral = (raw) => {
+	let cleaned = raw.trim();
+	if (cleaned.startsWith("\"") && cleaned.endsWith("\"")) cleaned = cleaned.slice(1, -1);
+	if (cleaned.endsWith(U64_PRIVATE_SUFFIX)) cleaned = cleaned.slice(0, -11);
+	else if (cleaned.endsWith(U64_SUFFIX)) cleaned = cleaned.slice(0, -3);
+	cleaned = cleaned.split("_").join("").trim();
+	if (!cleaned) return BigInt(0);
+	try {
+		return BigInt(cleaned);
+	} catch {
+		return BigInt(0);
+	}
+};
+
+//#endregion
+//#region src/utils/fetchAleoBalance/fetchAleoBalance.ts
+/**
+* Aleo addresses are bech32-encoded — lowercase alphanumerics only — so we
+* can validate strictly. Refusing anything else before it reaches the URL
+* keeps `/`, `?`, `#`, `..`, etc. out of the request path (SSRF / path
+* injection defence).
+*/
+const ALEO_ADDRESS_PATTERN = /^aleo1[a-z0-9]{1,62}$/;
+/**
+* Fetches the public credits balance for an Aleo address by querying the
+* `account` mapping on `credits.aleo` via the network's HTTP RPC. Returns
+* the balance as a credits string (private records are not visible here —
+* they live on the wallet and require a connected adapter to enumerate).
+*
+* Returns `null` when the address is malformed or no RPC URL is
+* configured; returns `'0'` for any other failure mode (non-OK status,
+* empty body, `null` mapping, unparseable payload). This keeps the
+* function fail-soft for the network-provider machinery, which surfaces
+* the result directly to the UI.
+*
+* @notInstrumented
+*/
+const fetchAleoBalance = async ({ address, networkData }) => {
+	if (!ALEO_ADDRESS_PATTERN.test(address)) return null;
+	const baseUrl = networkData.rpcUrls.http[0];
+	if (!baseUrl) return null;
+	const base = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+	const url = new URL(`program/credits.aleo/mapping/account/${encodeURIComponent(address)}`, base);
+	const response = await fetch(url.toString());
+	if (!response.ok) return "0";
+	const text = await response.text();
+	if (!text || text === "null") return "0";
+	const microcredits = parseAleoMicrocreditsLiteral(text);
+	if (microcredits <= BigInt(0)) return "0";
+	return formatMicrocreditsAsCredits(microcredits);
+};
+
+//#endregion
+//#region src/utils/createAleoNetworkProvider/createAleoNetworkProvider.ts
+/**
+* Build an `AleoNetworkProvider` bound to a specific `NetworkData`
+* (mainnet vs. testnet — anything the SDK config exposes). The provider
+* exposes a `getBalance({ address })` that proxies to
+* `fetchAleoBalance` over the configured RPC, returning public credits
+* only (private records require a connected wallet adapter).
+*
+* Called by `registerAleoNetworkProviderBuilder` — not invoked directly.
+*
+* @notInstrumented
+*/
+const createAleoNetworkProvider = (networkData) => ({
+	...(0, _dynamic_labs_sdk_client_core.createBaseNetworkProvider)("ALEO", networkData),
+	getBalance: async ({ address }) => ({ balance: await fetchAleoBalance({
+		address,
+		networkData
+	}) })
+});
+
+//#endregion
+//#region src/registerAleoNetworkProviderBuilder/registerAleoNetworkProviderBuilder.ts
+/**
+* Register the Aleo network-provider builder on a Dynamic client.
+*
+* Wires `createAleoNetworkProvider` into the client's network-provider
+* builder registry under the `'ALEO'` chain key, which is how the SDK's
+* network machinery materializes a per-network provider on demand.
+* Idempotent — a second call is a no-op once the builder is registered.
+*
+* Internal: called by the Aleo extension entry points
+* (`addAleoWalletStandardExtension`, `addAleoWalletAdaptersExtension`,
+* `addAleoExtension`). Not exported from the package's public surface.
+*
+* @notInstrumented
+*/
+const registerAleoNetworkProviderBuilder = (client) => {
+	const networkProviderBuilderRegistry = (0, _dynamic_labs_sdk_client_core.getNetworkProviderBuilderRegistry)(client);
+	if (networkProviderBuilderRegistry.get().get("ALEO")) return;
+	networkProviderBuilderRegistry.register({
+		builder: createAleoNetworkProvider,
+		chain: "ALEO"
+	});
+};
+
+//#endregion
+Object.defineProperty(exports, 'registerAleoNetworkProviderBuilder', {
+  enumerable: true,
+  get: function () {
+    return registerAleoNetworkProviderBuilder;
+  }
+});
+//# sourceMappingURL=registerAleoNetworkProviderBuilder-ByQwv6MA.cjs.map

package/dist/registerAleoNetworkProviderBuilder-ByQwv6MA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerAleoNetworkProviderBuilder-ByQwv6MA.cjs","names":["MICROCREDITS_PER_CREDIT"],"sources":["../src/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.ts","../src/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.ts","../src/utils/fetchAleoBalance/fetchAleoBalance.ts","../src/utils/createAleoNetworkProvider/createAleoNetworkProvider.ts","../src/registerAleoNetworkProviderBuilder/registerAleoNetworkProviderBuilder.ts"],"sourcesContent":["import { MICROCREDITS_PER_CREDIT } from '../constants';\n\nconst MICROCREDITS_PER_CREDIT_BIGINT = BigInt(MICROCREDITS_PER_CREDIT);\nconst MICROCREDIT_DECIMAL_DIGITS = String(MICROCREDITS_PER_CREDIT).length - 1;\n\n/**\n * Bounded trailing-zero strip. `padStart` produces a fractional string\n * of exactly `MICROCREDIT_DECIMAL_DIGITS` characters, so the quantifier\n * upper bound matches the maximum possible run of trailing zeros —\n * keeps the regex linear and avoids the unbounded-quantifier hotspot.\n */\nconst TRAILING_ZEROS_PATTERN = /0{1,6}$/;\n\n/**\n * Format microcredits (bigint) as a decimal credits string without\n * losing precision for balances beyond `Number.MAX_SAFE_INTEGER`.\n *\n * The integer credits portion and the microcredits remainder are\n * computed in the bigint domain, then the remainder is zero-padded to\n * six digits and trailing fractional zeros are trimmed. Whole-credit\n * balances render without a redundant `.000000` suffix.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single bigint arg; named-arg ceremony would not improve clarity\nexport const formatMicrocreditsAsCredits = (microcredits: bigint): string => {\n  const credits = microcredits / MICROCREDITS_PER_CREDIT_BIGINT;\n  const remainder = microcredits % MICROCREDITS_PER_CREDIT_BIGINT;\n  const fractional = remainder\n    .toString()\n    .padStart(MICROCREDIT_DECIMAL_DIGITS, '0')\n    .replace(TRAILING_ZEROS_PATTERN, '');\n  return fractional.length > 0 ? `${credits}.${fractional}` : `${credits}`;\n};\n","const U64_PRIVATE_SUFFIX = 'u64.private';\nconst U64_SUFFIX = 'u64';\n\n/**\n * Parse an Aleo VM mapping plaintext literal into microcredits.\n *\n * Accepts the shapes the Aleo `account` mapping endpoint actually\n * emits — e.g. `1500000u64.private`, `1_500_000u64`, or a bare integer\n * wrapped in JSON quotes. Strips the trailing `u64` / `u64.private`\n * type suffix, surrounding quotes, and the cosmetic `_` group\n * separators Aleo plaintext literals allow.\n *\n * Returns `0n` for empty input and for any payload that doesn't parse\n * as an integer. `BigInt()` throws `SyntaxError` on anything that\n * isn't a parseable integer — a corrupted RPC response, a mid-flight\n * truncation, or an upstream API change could deliver such a payload,\n * and we'd rather show a zero balance than crash the network-provider\n * machinery with an unhandled rejection.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single string arg; named-arg ceremony would not improve clarity\nexport const parseAleoMicrocreditsLiteral = (raw: string): bigint => {\n  let cleaned = raw.trim();\n  if (cleaned.startsWith('\"') && cleaned.endsWith('\"')) {\n    cleaned = cleaned.slice(1, -1);\n  }\n  if (cleaned.endsWith(U64_PRIVATE_SUFFIX)) {\n    cleaned = cleaned.slice(0, -U64_PRIVATE_SUFFIX.length);\n  } else if (cleaned.endsWith(U64_SUFFIX)) {\n    cleaned = cleaned.slice(0, -U64_SUFFIX.length);\n  }\n  cleaned = cleaned.split('_').join('').trim();\n  if (!cleaned) return BigInt(0);\n  try {\n    return BigInt(cleaned);\n  } catch {\n    return BigInt(0);\n  }\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\n\nimport { formatMicrocreditsAsCredits } from '../formatMicrocreditsAsCredits';\nimport { parseAleoMicrocreditsLiteral } from '../parseAleoMicrocreditsLiteral';\n\ntype FetchAleoBalanceParams = {\n  address: string;\n  networkData: NetworkData;\n};\n\n/**\n * Aleo addresses are bech32-encoded — lowercase alphanumerics only — so we\n * can validate strictly. Refusing anything else before it reaches the URL\n * keeps `/`, `?`, `#`, `..`, etc. out of the request path (SSRF / path\n * injection defence).\n */\nconst ALEO_ADDRESS_PATTERN = /^aleo1[a-z0-9]{1,62}$/;\n\n/**\n * Fetches the public credits balance for an Aleo address by querying the\n * `account` mapping on `credits.aleo` via the network's HTTP RPC. Returns\n * the balance as a credits string (private records are not visible here —\n * they live on the wallet and require a connected adapter to enumerate).\n *\n * Returns `null` when the address is malformed or no RPC URL is\n * configured; returns `'0'` for any other failure mode (non-OK status,\n * empty body, `null` mapping, unparseable payload). This keeps the\n * function fail-soft for the network-provider machinery, which surfaces\n * the result directly to the UI.\n *\n * @notInstrumented\n */\nexport const fetchAleoBalance = async ({\n  address,\n  networkData,\n}: FetchAleoBalanceParams): Promise<string | null> => {\n  if (!ALEO_ADDRESS_PATTERN.test(address)) {\n    return null;\n  }\n\n  const baseUrl = networkData.rpcUrls.http[0];\n  if (!baseUrl) {\n    return null;\n  }\n\n  const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;\n  const url = new URL(\n    `program/credits.aleo/mapping/account/${encodeURIComponent(address)}`,\n    base\n  );\n  const response = await fetch(url.toString());\n  if (!response.ok) {\n    return '0';\n  }\n\n  const text = await response.text();\n  if (!text || text === 'null') {\n    return '0';\n  }\n\n  const microcredits = parseAleoMicrocreditsLiteral(text);\n  if (microcredits <= BigInt(0)) {\n    return '0';\n  }\n\n  return formatMicrocreditsAsCredits(microcredits);\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { createBaseNetworkProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { AleoNetworkProvider } from '../../AleoNetworkProvider.types';\nimport { fetchAleoBalance } from '../fetchAleoBalance';\n\n/**\n * Build an `AleoNetworkProvider` bound to a specific `NetworkData`\n * (mainnet vs. testnet — anything the SDK config exposes). The provider\n * exposes a `getBalance({ address })` that proxies to\n * `fetchAleoBalance` over the configured RPC, returning public credits\n * only (private records require a connected wallet adapter).\n *\n * Called by `registerAleoNetworkProviderBuilder` — not invoked directly.\n *\n * @notInstrumented\n */\n \nexport const createAleoNetworkProvider = (\n  networkData: NetworkData\n): AleoNetworkProvider => ({\n  ...createBaseNetworkProvider('ALEO', networkData),\n  getBalance: async ({ address }) => ({\n    balance: await fetchAleoBalance({\n      address,\n      networkData,\n    }),\n  }),\n});\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworkProviderBuilderRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { createAleoNetworkProvider } from '../utils/createAleoNetworkProvider';\n\n/**\n * Register the Aleo network-provider builder on a Dynamic client.\n *\n * Wires `createAleoNetworkProvider` into the client's network-provider\n * builder registry under the `'ALEO'` chain key, which is how the SDK's\n * network machinery materializes a per-network provider on demand.\n * Idempotent — a second call is a no-op once the builder is registered.\n *\n * Internal: called by the Aleo extension entry points\n * (`addAleoWalletStandardExtension`, `addAleoWalletAdaptersExtension`,\n * `addAleoExtension`). Not exported from the package's public surface.\n *\n * @notInstrumented\n */\nexport const registerAleoNetworkProviderBuilder = (\n  client: DynamicClient\n): void => {\n  const networkProviderBuilderRegistry =\n    getNetworkProviderBuilderRegistry(client);\n\n  if (networkProviderBuilderRegistry.get().get('ALEO')) {\n    return;\n  }\n\n  networkProviderBuilderRegistry.register({\n    builder: createAleoNetworkProvider,\n    chain: 'ALEO',\n  });\n};\n"],"mappings":";;;;AAEA,MAAM,iCAAiC,OAAOA,0CAAwB;AACtE,MAAM,6BAA6B,OAAOA,0CAAwB,CAAC,SAAS;;;;;;;AAQ5E,MAAM,yBAAyB;;;;;;;;;;;;AAc/B,MAAa,+BAA+B,iBAAiC;CAC3E,MAAM,UAAU,eAAe;CAE/B,MAAM,cADY,eAAe,gCAE9B,UAAU,CACV,SAAS,4BAA4B,IAAI,CACzC,QAAQ,wBAAwB,GAAG;AACtC,QAAO,WAAW,SAAS,IAAI,GAAG,QAAQ,GAAG,eAAe,GAAG;;;;;AChCjE,MAAM,qBAAqB;AAC3B,MAAM,aAAa;;;;;;;;;;;;;;;;;;;AAqBnB,MAAa,gCAAgC,QAAwB;CACnE,IAAI,UAAU,IAAI,MAAM;AACxB,KAAI,QAAQ,WAAW,KAAI,IAAI,QAAQ,SAAS,KAAI,CAClD,WAAU,QAAQ,MAAM,GAAG,GAAG;AAEhC,KAAI,QAAQ,SAAS,mBAAmB,CACtC,WAAU,QAAQ,MAAM,GAAG,IAA2B;UAC7C,QAAQ,SAAS,WAAW,CACrC,WAAU,QAAQ,MAAM,GAAG,GAAmB;AAEhD,WAAU,QAAQ,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM;AAC5C,KAAI,CAAC,QAAS,QAAO,OAAO,EAAE;AAC9B,KAAI;AACF,SAAO,OAAO,QAAQ;SAChB;AACN,SAAO,OAAO,EAAE;;;;;;;;;;;;ACrBpB,MAAM,uBAAuB;;;;;;;;;;;;;;;AAgB7B,MAAa,mBAAmB,OAAO,EACrC,SACA,kBACoD;AACpD,KAAI,CAAC,qBAAqB,KAAK,QAAQ,CACrC,QAAO;CAGT,MAAM,UAAU,YAAY,QAAQ,KAAK;AACzC,KAAI,CAAC,QACH,QAAO;CAGT,MAAM,OAAO,QAAQ,SAAS,IAAI,GAAG,UAAU,GAAG,QAAQ;CAC1D,MAAM,MAAM,IAAI,IACd,wCAAwC,mBAAmB,QAAQ,IACnE,KACD;CACD,MAAM,WAAW,MAAM,MAAM,IAAI,UAAU,CAAC;AAC5C,KAAI,CAAC,SAAS,GACZ,QAAO;CAGT,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,KAAI,CAAC,QAAQ,SAAS,OACpB,QAAO;CAGT,MAAM,eAAe,6BAA6B,KAAK;AACvD,KAAI,gBAAgB,OAAO,EAAE,CAC3B,QAAO;AAGT,QAAO,4BAA4B,aAAa;;;;;;;;;;;;;;;;AC/ClD,MAAa,6BACX,iBACyB;CACzB,gEAA6B,QAAQ,YAAY;CACjD,YAAY,OAAO,EAAE,eAAe,EAClC,SAAS,MAAM,iBAAiB;EAC9B;EACA;EACD,CAAC,EACH;CACF;;;;;;;;;;;;;;;;;;ACTD,MAAa,sCACX,WACS;CACT,MAAM,sGAC8B,OAAO;AAE3C,KAAI,+BAA+B,KAAK,CAAC,IAAI,OAAO,CAClD;AAGF,gCAA+B,SAAS;EACtC,SAAS;EACT,OAAO;EACR,CAAC"}

package/dist/registerAleoNetworkProviderBuilder-CMcQJWs3.esm.js

@@ -0,0 +1,153 @@
+import { r as MICROCREDITS_PER_CREDIT } from "./constants-DZ9sVn7x.esm.js";
+import { createBaseNetworkProvider, getNetworkProviderBuilderRegistry } from "@dynamic-labs-sdk/client/core";
+
+//#region src/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.ts
+const MICROCREDITS_PER_CREDIT_BIGINT = BigInt(MICROCREDITS_PER_CREDIT);
+const MICROCREDIT_DECIMAL_DIGITS = String(MICROCREDITS_PER_CREDIT).length - 1;
+/**
+* Bounded trailing-zero strip. `padStart` produces a fractional string
+* of exactly `MICROCREDIT_DECIMAL_DIGITS` characters, so the quantifier
+* upper bound matches the maximum possible run of trailing zeros —
+* keeps the regex linear and avoids the unbounded-quantifier hotspot.
+*/
+const TRAILING_ZEROS_PATTERN = /0{1,6}$/;
+/**
+* Format microcredits (bigint) as a decimal credits string without
+* losing precision for balances beyond `Number.MAX_SAFE_INTEGER`.
+*
+* The integer credits portion and the microcredits remainder are
+* computed in the bigint domain, then the remainder is zero-padded to
+* six digits and trailing fractional zeros are trimmed. Whole-credit
+* balances render without a redundant `.000000` suffix.
+*
+* @notInstrumented
+*/
+const formatMicrocreditsAsCredits = (microcredits) => {
+	const credits = microcredits / MICROCREDITS_PER_CREDIT_BIGINT;
+	const fractional = (microcredits % MICROCREDITS_PER_CREDIT_BIGINT).toString().padStart(MICROCREDIT_DECIMAL_DIGITS, "0").replace(TRAILING_ZEROS_PATTERN, "");
+	return fractional.length > 0 ? `${credits}.${fractional}` : `${credits}`;
+};
+
+//#endregion
+//#region src/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.ts
+const U64_PRIVATE_SUFFIX = "u64.private";
+const U64_SUFFIX = "u64";
+/**
+* Parse an Aleo VM mapping plaintext literal into microcredits.
+*
+* Accepts the shapes the Aleo `account` mapping endpoint actually
+* emits — e.g. `1500000u64.private`, `1_500_000u64`, or a bare integer
+* wrapped in JSON quotes. Strips the trailing `u64` / `u64.private`
+* type suffix, surrounding quotes, and the cosmetic `_` group
+* separators Aleo plaintext literals allow.
+*
+* Returns `0n` for empty input and for any payload that doesn't parse
+* as an integer. `BigInt()` throws `SyntaxError` on anything that
+* isn't a parseable integer — a corrupted RPC response, a mid-flight
+* truncation, or an upstream API change could deliver such a payload,
+* and we'd rather show a zero balance than crash the network-provider
+* machinery with an unhandled rejection.
+*
+* @notInstrumented
+*/
+const parseAleoMicrocreditsLiteral = (raw) => {
+	let cleaned = raw.trim();
+	if (cleaned.startsWith("\"") && cleaned.endsWith("\"")) cleaned = cleaned.slice(1, -1);
+	if (cleaned.endsWith(U64_PRIVATE_SUFFIX)) cleaned = cleaned.slice(0, -11);
+	else if (cleaned.endsWith(U64_SUFFIX)) cleaned = cleaned.slice(0, -3);
+	cleaned = cleaned.split("_").join("").trim();
+	if (!cleaned) return BigInt(0);
+	try {
+		return BigInt(cleaned);
+	} catch {
+		return BigInt(0);
+	}
+};
+
+//#endregion
+//#region src/utils/fetchAleoBalance/fetchAleoBalance.ts
+/**
+* Aleo addresses are bech32-encoded — lowercase alphanumerics only — so we
+* can validate strictly. Refusing anything else before it reaches the URL
+* keeps `/`, `?`, `#`, `..`, etc. out of the request path (SSRF / path
+* injection defence).
+*/
+const ALEO_ADDRESS_PATTERN = /^aleo1[a-z0-9]{1,62}$/;
+/**
+* Fetches the public credits balance for an Aleo address by querying the
+* `account` mapping on `credits.aleo` via the network's HTTP RPC. Returns
+* the balance as a credits string (private records are not visible here —
+* they live on the wallet and require a connected adapter to enumerate).
+*
+* Returns `null` when the address is malformed or no RPC URL is
+* configured; returns `'0'` for any other failure mode (non-OK status,
+* empty body, `null` mapping, unparseable payload). This keeps the
+* function fail-soft for the network-provider machinery, which surfaces
+* the result directly to the UI.
+*
+* @notInstrumented
+*/
+const fetchAleoBalance = async ({ address, networkData }) => {
+	if (!ALEO_ADDRESS_PATTERN.test(address)) return null;
+	const baseUrl = networkData.rpcUrls.http[0];
+	if (!baseUrl) return null;
+	const base = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+	const url = new URL(`program/credits.aleo/mapping/account/${encodeURIComponent(address)}`, base);
+	const response = await fetch(url.toString());
+	if (!response.ok) return "0";
+	const text = await response.text();
+	if (!text || text === "null") return "0";
+	const microcredits = parseAleoMicrocreditsLiteral(text);
+	if (microcredits <= BigInt(0)) return "0";
+	return formatMicrocreditsAsCredits(microcredits);
+};
+
+//#endregion
+//#region src/utils/createAleoNetworkProvider/createAleoNetworkProvider.ts
+/**
+* Build an `AleoNetworkProvider` bound to a specific `NetworkData`
+* (mainnet vs. testnet — anything the SDK config exposes). The provider
+* exposes a `getBalance({ address })` that proxies to
+* `fetchAleoBalance` over the configured RPC, returning public credits
+* only (private records require a connected wallet adapter).
+*
+* Called by `registerAleoNetworkProviderBuilder` — not invoked directly.
+*
+* @notInstrumented
+*/
+const createAleoNetworkProvider = (networkData) => ({
+	...createBaseNetworkProvider("ALEO", networkData),
+	getBalance: async ({ address }) => ({ balance: await fetchAleoBalance({
+		address,
+		networkData
+	}) })
+});
+
+//#endregion
+//#region src/registerAleoNetworkProviderBuilder/registerAleoNetworkProviderBuilder.ts
+/**
+* Register the Aleo network-provider builder on a Dynamic client.
+*
+* Wires `createAleoNetworkProvider` into the client's network-provider
+* builder registry under the `'ALEO'` chain key, which is how the SDK's
+* network machinery materializes a per-network provider on demand.
+* Idempotent — a second call is a no-op once the builder is registered.
+*
+* Internal: called by the Aleo extension entry points
+* (`addAleoWalletStandardExtension`, `addAleoWalletAdaptersExtension`,
+* `addAleoExtension`). Not exported from the package's public surface.
+*
+* @notInstrumented
+*/
+const registerAleoNetworkProviderBuilder = (client) => {
+	const networkProviderBuilderRegistry = getNetworkProviderBuilderRegistry(client);
+	if (networkProviderBuilderRegistry.get().get("ALEO")) return;
+	networkProviderBuilderRegistry.register({
+		builder: createAleoNetworkProvider,
+		chain: "ALEO"
+	});
+};
+
+//#endregion
+export { registerAleoNetworkProviderBuilder as t };
+//# sourceMappingURL=registerAleoNetworkProviderBuilder-CMcQJWs3.esm.js.map

package/dist/registerAleoNetworkProviderBuilder-CMcQJWs3.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerAleoNetworkProviderBuilder-CMcQJWs3.esm.js","names":[],"sources":["../src/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.ts","../src/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.ts","../src/utils/fetchAleoBalance/fetchAleoBalance.ts","../src/utils/createAleoNetworkProvider/createAleoNetworkProvider.ts","../src/registerAleoNetworkProviderBuilder/registerAleoNetworkProviderBuilder.ts"],"sourcesContent":["import { MICROCREDITS_PER_CREDIT } from '../constants';\n\nconst MICROCREDITS_PER_CREDIT_BIGINT = BigInt(MICROCREDITS_PER_CREDIT);\nconst MICROCREDIT_DECIMAL_DIGITS = String(MICROCREDITS_PER_CREDIT).length - 1;\n\n/**\n * Bounded trailing-zero strip. `padStart` produces a fractional string\n * of exactly `MICROCREDIT_DECIMAL_DIGITS` characters, so the quantifier\n * upper bound matches the maximum possible run of trailing zeros —\n * keeps the regex linear and avoids the unbounded-quantifier hotspot.\n */\nconst TRAILING_ZEROS_PATTERN = /0{1,6}$/;\n\n/**\n * Format microcredits (bigint) as a decimal credits string without\n * losing precision for balances beyond `Number.MAX_SAFE_INTEGER`.\n *\n * The integer credits portion and the microcredits remainder are\n * computed in the bigint domain, then the remainder is zero-padded to\n * six digits and trailing fractional zeros are trimmed. Whole-credit\n * balances render without a redundant `.000000` suffix.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single bigint arg; named-arg ceremony would not improve clarity\nexport const formatMicrocreditsAsCredits = (microcredits: bigint): string => {\n  const credits = microcredits / MICROCREDITS_PER_CREDIT_BIGINT;\n  const remainder = microcredits % MICROCREDITS_PER_CREDIT_BIGINT;\n  const fractional = remainder\n    .toString()\n    .padStart(MICROCREDIT_DECIMAL_DIGITS, '0')\n    .replace(TRAILING_ZEROS_PATTERN, '');\n  return fractional.length > 0 ? `${credits}.${fractional}` : `${credits}`;\n};\n","const U64_PRIVATE_SUFFIX = 'u64.private';\nconst U64_SUFFIX = 'u64';\n\n/**\n * Parse an Aleo VM mapping plaintext literal into microcredits.\n *\n * Accepts the shapes the Aleo `account` mapping endpoint actually\n * emits — e.g. `1500000u64.private`, `1_500_000u64`, or a bare integer\n * wrapped in JSON quotes. Strips the trailing `u64` / `u64.private`\n * type suffix, surrounding quotes, and the cosmetic `_` group\n * separators Aleo plaintext literals allow.\n *\n * Returns `0n` for empty input and for any payload that doesn't parse\n * as an integer. `BigInt()` throws `SyntaxError` on anything that\n * isn't a parseable integer — a corrupted RPC response, a mid-flight\n * truncation, or an upstream API change could deliver such a payload,\n * and we'd rather show a zero balance than crash the network-provider\n * machinery with an unhandled rejection.\n *\n * @notInstrumented\n */\n// eslint-disable-next-line custom-rules/require-single-object-param -- single string arg; named-arg ceremony would not improve clarity\nexport const parseAleoMicrocreditsLiteral = (raw: string): bigint => {\n  let cleaned = raw.trim();\n  if (cleaned.startsWith('\"') && cleaned.endsWith('\"')) {\n    cleaned = cleaned.slice(1, -1);\n  }\n  if (cleaned.endsWith(U64_PRIVATE_SUFFIX)) {\n    cleaned = cleaned.slice(0, -U64_PRIVATE_SUFFIX.length);\n  } else if (cleaned.endsWith(U64_SUFFIX)) {\n    cleaned = cleaned.slice(0, -U64_SUFFIX.length);\n  }\n  cleaned = cleaned.split('_').join('').trim();\n  if (!cleaned) return BigInt(0);\n  try {\n    return BigInt(cleaned);\n  } catch {\n    return BigInt(0);\n  }\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\n\nimport { formatMicrocreditsAsCredits } from '../formatMicrocreditsAsCredits';\nimport { parseAleoMicrocreditsLiteral } from '../parseAleoMicrocreditsLiteral';\n\ntype FetchAleoBalanceParams = {\n  address: string;\n  networkData: NetworkData;\n};\n\n/**\n * Aleo addresses are bech32-encoded — lowercase alphanumerics only — so we\n * can validate strictly. Refusing anything else before it reaches the URL\n * keeps `/`, `?`, `#`, `..`, etc. out of the request path (SSRF / path\n * injection defence).\n */\nconst ALEO_ADDRESS_PATTERN = /^aleo1[a-z0-9]{1,62}$/;\n\n/**\n * Fetches the public credits balance for an Aleo address by querying the\n * `account` mapping on `credits.aleo` via the network's HTTP RPC. Returns\n * the balance as a credits string (private records are not visible here —\n * they live on the wallet and require a connected adapter to enumerate).\n *\n * Returns `null` when the address is malformed or no RPC URL is\n * configured; returns `'0'` for any other failure mode (non-OK status,\n * empty body, `null` mapping, unparseable payload). This keeps the\n * function fail-soft for the network-provider machinery, which surfaces\n * the result directly to the UI.\n *\n * @notInstrumented\n */\nexport const fetchAleoBalance = async ({\n  address,\n  networkData,\n}: FetchAleoBalanceParams): Promise<string | null> => {\n  if (!ALEO_ADDRESS_PATTERN.test(address)) {\n    return null;\n  }\n\n  const baseUrl = networkData.rpcUrls.http[0];\n  if (!baseUrl) {\n    return null;\n  }\n\n  const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;\n  const url = new URL(\n    `program/credits.aleo/mapping/account/${encodeURIComponent(address)}`,\n    base\n  );\n  const response = await fetch(url.toString());\n  if (!response.ok) {\n    return '0';\n  }\n\n  const text = await response.text();\n  if (!text || text === 'null') {\n    return '0';\n  }\n\n  const microcredits = parseAleoMicrocreditsLiteral(text);\n  if (microcredits <= BigInt(0)) {\n    return '0';\n  }\n\n  return formatMicrocreditsAsCredits(microcredits);\n};\n","import type { NetworkData } from '@dynamic-labs-sdk/client';\nimport { createBaseNetworkProvider } from '@dynamic-labs-sdk/client/core';\n\nimport type { AleoNetworkProvider } from '../../AleoNetworkProvider.types';\nimport { fetchAleoBalance } from '../fetchAleoBalance';\n\n/**\n * Build an `AleoNetworkProvider` bound to a specific `NetworkData`\n * (mainnet vs. testnet — anything the SDK config exposes). The provider\n * exposes a `getBalance({ address })` that proxies to\n * `fetchAleoBalance` over the configured RPC, returning public credits\n * only (private records require a connected wallet adapter).\n *\n * Called by `registerAleoNetworkProviderBuilder` — not invoked directly.\n *\n * @notInstrumented\n */\n \nexport const createAleoNetworkProvider = (\n  networkData: NetworkData\n): AleoNetworkProvider => ({\n  ...createBaseNetworkProvider('ALEO', networkData),\n  getBalance: async ({ address }) => ({\n    balance: await fetchAleoBalance({\n      address,\n      networkData,\n    }),\n  }),\n});\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getNetworkProviderBuilderRegistry } from '@dynamic-labs-sdk/client/core';\n\nimport { createAleoNetworkProvider } from '../utils/createAleoNetworkProvider';\n\n/**\n * Register the Aleo network-provider builder on a Dynamic client.\n *\n * Wires `createAleoNetworkProvider` into the client's network-provider\n * builder registry under the `'ALEO'` chain key, which is how the SDK's\n * network machinery materializes a per-network provider on demand.\n * Idempotent — a second call is a no-op once the builder is registered.\n *\n * Internal: called by the Aleo extension entry points\n * (`addAleoWalletStandardExtension`, `addAleoWalletAdaptersExtension`,\n * `addAleoExtension`). Not exported from the package's public surface.\n *\n * @notInstrumented\n */\nexport const registerAleoNetworkProviderBuilder = (\n  client: DynamicClient\n): void => {\n  const networkProviderBuilderRegistry =\n    getNetworkProviderBuilderRegistry(client);\n\n  if (networkProviderBuilderRegistry.get().get('ALEO')) {\n    return;\n  }\n\n  networkProviderBuilderRegistry.register({\n    builder: createAleoNetworkProvider,\n    chain: 'ALEO',\n  });\n};\n"],"mappings":";;;;AAEA,MAAM,iCAAiC,OAAO,wBAAwB;AACtE,MAAM,6BAA6B,OAAO,wBAAwB,CAAC,SAAS;;;;;;;AAQ5E,MAAM,yBAAyB;;;;;;;;;;;;AAc/B,MAAa,+BAA+B,iBAAiC;CAC3E,MAAM,UAAU,eAAe;CAE/B,MAAM,cADY,eAAe,gCAE9B,UAAU,CACV,SAAS,4BAA4B,IAAI,CACzC,QAAQ,wBAAwB,GAAG;AACtC,QAAO,WAAW,SAAS,IAAI,GAAG,QAAQ,GAAG,eAAe,GAAG;;;;;AChCjE,MAAM,qBAAqB;AAC3B,MAAM,aAAa;;;;;;;;;;;;;;;;;;;AAqBnB,MAAa,gCAAgC,QAAwB;CACnE,IAAI,UAAU,IAAI,MAAM;AACxB,KAAI,QAAQ,WAAW,KAAI,IAAI,QAAQ,SAAS,KAAI,CAClD,WAAU,QAAQ,MAAM,GAAG,GAAG;AAEhC,KAAI,QAAQ,SAAS,mBAAmB,CACtC,WAAU,QAAQ,MAAM,GAAG,IAA2B;UAC7C,QAAQ,SAAS,WAAW,CACrC,WAAU,QAAQ,MAAM,GAAG,GAAmB;AAEhD,WAAU,QAAQ,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM;AAC5C,KAAI,CAAC,QAAS,QAAO,OAAO,EAAE;AAC9B,KAAI;AACF,SAAO,OAAO,QAAQ;SAChB;AACN,SAAO,OAAO,EAAE;;;;;;;;;;;;ACrBpB,MAAM,uBAAuB;;;;;;;;;;;;;;;AAgB7B,MAAa,mBAAmB,OAAO,EACrC,SACA,kBACoD;AACpD,KAAI,CAAC,qBAAqB,KAAK,QAAQ,CACrC,QAAO;CAGT,MAAM,UAAU,YAAY,QAAQ,KAAK;AACzC,KAAI,CAAC,QACH,QAAO;CAGT,MAAM,OAAO,QAAQ,SAAS,IAAI,GAAG,UAAU,GAAG,QAAQ;CAC1D,MAAM,MAAM,IAAI,IACd,wCAAwC,mBAAmB,QAAQ,IACnE,KACD;CACD,MAAM,WAAW,MAAM,MAAM,IAAI,UAAU,CAAC;AAC5C,KAAI,CAAC,SAAS,GACZ,QAAO;CAGT,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,KAAI,CAAC,QAAQ,SAAS,OACpB,QAAO;CAGT,MAAM,eAAe,6BAA6B,KAAK;AACvD,KAAI,gBAAgB,OAAO,EAAE,CAC3B,QAAO;AAGT,QAAO,4BAA4B,aAAa;;;;;;;;;;;;;;;;AC/ClD,MAAa,6BACX,iBACyB;CACzB,GAAG,0BAA0B,QAAQ,YAAY;CACjD,YAAY,OAAO,EAAE,eAAe,EAClC,SAAS,MAAM,iBAAiB;EAC9B;EACA;EACD,CAAC,EACH;CACF;;;;;;;;;;;;;;;;;;ACTD,MAAa,sCACX,WACS;CACT,MAAM,iCACJ,kCAAkC,OAAO;AAE3C,KAAI,+BAA+B,KAAK,CAAC,IAAI,OAAO,CAClD;AAGF,gCAA+B,SAAS;EACtC,SAAS;EACT,OAAO;EACR,CAAC"}