@dynamic-labs-sdk/aleo 0.0.0 → 0.27.1

package/dist/utils/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Aleo credits are denominated in microcredits — 1 credit = 1,000,000 mc.
+ * Mirrors the SUN_PER_TRX / lamports-per-sol pattern in sibling chain packages.
+ */
+export declare const MICROCREDITS_PER_CREDIT = 1000000;
+export declare const ALEO_MAINNET_NETWORK_ID = 0;
+export declare const ALEO_TESTNET_NETWORK_ID = 1;
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAEjD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC"}

package/dist/utils/createAleoNetworkProvider/createAleoNetworkProvider.d.ts

@@ -0,0 +1,15 @@
+import type { NetworkData } from '@dynamic-labs-sdk/client';
+import type { AleoNetworkProvider } from '../../AleoNetworkProvider.types';
+/**
+ * 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.
+ *
+ * @not-instrumented
+ */
+export declare const createAleoNetworkProvider: (networkData: NetworkData) => AleoNetworkProvider;
+//# sourceMappingURL=createAleoNetworkProvider.d.ts.map

package/dist/utils/createAleoNetworkProvider/createAleoNetworkProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAleoNetworkProvider.d.ts","sourceRoot":"","sources":["../../../src/utils/createAleoNetworkProvider/createAleoNetworkProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,yBAAyB,gBACvB,WAAW,KACvB,mBAQD,CAAC"}

package/dist/utils/createAleoNetworkProvider/index.d.ts

@@ -0,0 +1,2 @@
+export { createAleoNetworkProvider } from './createAleoNetworkProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/createAleoNetworkProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/createAleoNetworkProvider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/utils/fetchAleoBalance/fetchAleoBalance.d.ts

@@ -0,0 +1,22 @@
+import type { NetworkData } from '@dynamic-labs-sdk/client';
+type FetchAleoBalanceParams = {
+    address: string;
+    networkData: NetworkData;
+};
+/**
+ * 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.
+ *
+ * @not-instrumented
+ */
+export declare const fetchAleoBalance: ({ address, networkData, }: FetchAleoBalanceParams) => Promise<string | null>;
+export {};
+//# sourceMappingURL=fetchAleoBalance.d.ts.map

package/dist/utils/fetchAleoBalance/fetchAleoBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchAleoBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchAleoBalance/fetchAleoBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK5D,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAUF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,8BAG1B,sBAAsB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CA+BhD,CAAC"}

package/dist/utils/fetchAleoBalance/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchAleoBalance } from './fetchAleoBalance';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/fetchAleoBalance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchAleoBalance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ *
+ * @not-instrumented
+ */
+export declare const formatMicrocreditsAsCredits: (microcredits: bigint) => string;
+//# sourceMappingURL=formatMicrocreditsAsCredits.d.ts.map

package/dist/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatMicrocreditsAsCredits.d.ts","sourceRoot":"","sources":["../../../src/utils/formatMicrocreditsAsCredits/formatMicrocreditsAsCredits.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,2BAA2B,iBAAkB,MAAM,KAAG,MAQlE,CAAC"}

package/dist/utils/formatMicrocreditsAsCredits/index.d.ts

@@ -0,0 +1,2 @@
+export { formatMicrocreditsAsCredits } from './formatMicrocreditsAsCredits';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/formatMicrocreditsAsCredits/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/formatMicrocreditsAsCredits/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.d.ts

@@ -0,0 +1,26 @@
+type GetAleoExplorerTxUrlParams = {
+    /**
+     * `0` = mainnet, `1` = testnet. When omitted, defaults to testnet so a
+     * stale UI never accidentally links to a mainnet explorer for a testnet
+     * transaction.
+     */
+    networkId?: number | string;
+    /** Aleo transaction id (`at1...`). */
+    txId: string;
+};
+/**
+ * Build the Provable explorer URL for an Aleo transaction id.
+ *
+ * Examples:
+ *   getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 0 })
+ *     → 'https://explorer.provable.com/transaction/at1abc...'
+ *   getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 1 })
+ *     → 'https://testnet.explorer.provable.com/transaction/at1abc...'
+ *
+ * @throws InvalidAleoTransactionIdError when `txId` is not a well-formed
+ *         bech32 Aleo transaction id.
+ * @not-instrumented
+ */
+export declare const getAleoExplorerTxUrl: ({ txId, networkId, }: GetAleoExplorerTxUrlParams) => string;
+export {};
+//# sourceMappingURL=getAleoExplorerTxUrl.d.ts.map

package/dist/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAleoExplorerTxUrl.d.ts","sourceRoot":"","sources":["../../../src/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.ts"],"names":[],"mappings":"AAYA,KAAK,0BAA0B,GAAG;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,yBAG9B,0BAA0B,KAAG,MAM/B,CAAC"}

package/dist/utils/getAleoExplorerTxUrl/index.d.ts

@@ -0,0 +1,2 @@
+export { getAleoExplorerTxUrl } from './getAleoExplorerTxUrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/getAleoExplorerTxUrl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/getAleoExplorerTxUrl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/utils/getNetworkByChainId/getNetworkByChainId.d.ts

@@ -0,0 +1,22 @@
+import { Network } from '@provablehq/aleo-types';
+/**
+ * Map from `@provablehq/aleo-types` Network enum to the numeric chain id used
+ * everywhere else in the SDK (`0` = mainnet, `1` = testnet).
+ */
+export declare const ALEO_NETWORK_TO_ID_MAP: Partial<Record<Network, number>>;
+type GetNetworkByChainIdParams = {
+    chainId: number;
+};
+/**
+ * Resolve the `@provablehq/aleo-types` Network enum value for a numeric
+ * chain id, the bridge between the SDK's chain ids and the on-chain
+ * network identifier the Aleo libraries expect.
+ *
+ * @param params.chainId The numeric chain id (`0` = mainnet, `1` = testnet).
+ * @returns The matching `Network` enum value, or `undefined` when the id is
+ *          not a known Aleo network.
+ * @not-instrumented
+ */
+export declare const getNetworkByChainId: ({ chainId, }: GetNetworkByChainIdParams) => Network | undefined;
+export {};
+//# sourceMappingURL=getNetworkByChainId.d.ts.map

package/dist/utils/getNetworkByChainId/getNetworkByChainId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNetworkByChainId.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkByChainId/getNetworkByChainId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAOjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAGnE,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,iBAE7B,yBAAyB,KAAG,OAAO,GAAG,SAKxC,CAAC"}

package/dist/utils/getNetworkByChainId/index.d.ts

@@ -0,0 +1,2 @@
+export { ALEO_NETWORK_TO_ID_MAP, getNetworkByChainId, } from './getNetworkByChainId';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/getNetworkByChainId/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkByChainId/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/utils/isAleoMainnet/index.d.ts

@@ -0,0 +1,2 @@
+export { isAleoMainnet } from './isAleoMainnet';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/isAleoMainnet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/isAleoMainnet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/utils/isAleoMainnet/isAleoMainnet.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether a numeric/string chain id points at the Aleo mainnet (`0`)
+ * rather than a testnet. Both numeric and string ids are accepted so
+ * callers can pass `walletAccount.activeNetworkId` (which is stringly-
+ * typed) directly. `undefined` and `null` resolve to `false` so a
+ * stale or unknown id falls back to testnet behaviour at the call
+ * site.
+ *
+ * @not-instrumented
+ */
+export declare const isAleoMainnet: (networkId: number | string | undefined | null) => boolean;
+//# sourceMappingURL=isAleoMainnet.d.ts.map

package/dist/utils/isAleoMainnet/isAleoMainnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAleoMainnet.d.ts","sourceRoot":"","sources":["../../../src/utils/isAleoMainnet/isAleoMainnet.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,eAAO,MAAM,aAAa,cACb,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,KAC5C,OAMF,CAAC"}

package/dist/utils/parseAleoMicrocreditsLiteral/index.d.ts

@@ -0,0 +1,2 @@
+export { parseAleoMicrocreditsLiteral } from './parseAleoMicrocreditsLiteral';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/parseAleoMicrocreditsLiteral/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAleoMicrocreditsLiteral/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ *
+ * @not-instrumented
+ */
+export declare const parseAleoMicrocreditsLiteral: (raw: string) => bigint;
+//# sourceMappingURL=parseAleoMicrocreditsLiteral.d.ts.map

package/dist/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAleoMicrocreditsLiteral.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAleoMicrocreditsLiteral/parseAleoMicrocreditsLiteral.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,4BAA4B,QAAS,MAAM,KAAG,MAiB1D,CAAC"}

package/package.json

@@ -1 +1,40 @@
-{ "name": "@dynamic-labs-sdk/aleo", "version": "0.0.0" }
+{
+  "name": "@dynamic-labs-sdk/aleo",
+  "version": "0.27.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/exports/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/exports/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@dynamic-labs/sdk-api-core": "0.0.968",
+    "@provablehq/aleo-types": "0.3.0-alpha.3",
+    "@provablehq/aleo-wallet-adaptor-core": "0.3.0-alpha.3",
+    "@provablehq/aleo-wallet-adaptor-shield": "0.3.0-alpha.3",
+    "@provablehq/aleo-wallet-standard": "0.3.0-alpha.3",
+    "@dynamic-labs-sdk/assert-package-version": "0.27.1",
+    "@dynamic-labs-sdk/client": "0.27.1"
+  },
+  "devDependencies": {
+    "vitest": "2.1.9"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsdown && pnpm exec tsc --emitDeclarationOnly -p ./tsconfig.lib.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test-with-coverage": "vitest run --coverage",
+    "check-versions": "pnpm --filter @tools/sync-package-versions run sync --check-only --package-filter aleo"
+  }
+}