@dynamic-labs-sdk/aleo 0.0.0 → 0.27.1

package/README.md

@@ -0,0 +1,21 @@
+# @dynamic-labs-sdk/aleo
+
+This package contains the Aleo integration for the Dynamic SDK. It enables support for Aleo external wallets via the [Aleo Wallet Standard](https://github.com/ProvableHQ/aleo-wallet-standard) and adapter-based wallets (e.g. Shield).
+
+## Installation
+
+```sh
+pnpm add @dynamic-labs-sdk/aleo
+```
+
+## Usage
+
+```ts
+import { addAleoExtension } from '@dynamic-labs-sdk/aleo';
+import { createDynamicClient } from '@dynamic-labs-sdk/client';
+
+const dynamicClient = createDynamicClient({
+  environmentId: '123',
+});
+addAleoExtension(dynamicClient);
+```

package/dist/AleoNetworkProvider.types.d.ts

@@ -0,0 +1,8 @@
+import type { BaseNetworkProvider } from '@dynamic-labs-sdk/client/core';
+export type AleoNetworkProvider = BaseNetworkProvider<'ALEO'>;
+declare global {
+    interface NetworkProviderMap {
+        ALEO: AleoNetworkProvider;
+    }
+}
+//# sourceMappingURL=AleoNetworkProvider.types.d.ts.map

package/dist/AleoNetworkProvider.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AleoNetworkProvider.types.d.ts","sourceRoot":"","sources":["../src/AleoNetworkProvider.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE9D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,kBAAkB;QAC1B,IAAI,EAAE,mBAAmB,CAAC;KAC3B;CACF"}

package/dist/AleoWalletAccount.types.d.ts

@@ -0,0 +1,8 @@
+import type { BaseWalletAccount } from '@dynamic-labs-sdk/client/core';
+export type AleoWalletAccount = BaseWalletAccount<'ALEO'>;
+declare global {
+    interface WalletAccountMap {
+        ALEO: AleoWalletAccount;
+    }
+}
+//# sourceMappingURL=AleoWalletAccount.types.d.ts.map

package/dist/AleoWalletAccount.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AleoWalletAccount.types.d.ts","sourceRoot":"","sources":["../src/AleoWalletAccount.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,gBAAgB;QACxB,IAAI,EAAE,iBAAiB,CAAC;KACzB;CACF"}

package/dist/AleoWalletProvider.types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Aleo wallet provider specific types
+ */
+import type { WalletProvider } from '@dynamic-labs-sdk/client/core';
+import type { AleoWalletAccount } from './AleoWalletAccount.types';
+/**
+ * A transition is a single function execution within an Aleo transaction —
+ * one program invocation with its inputs.
+ */
+export type AleoTransition = {
+    functionName: string;
+    inputs: unknown[];
+    program: string;
+};
+/**
+ * An Aleo transaction is a bundle of transitions submitted together with a
+ * single fee. `feePrivate` selects between the private and public fee paths.
+ */
+export type AleoTransaction = {
+    address: string;
+    chainId: string;
+    fee: number;
+    feePrivate: boolean;
+    transitions: AleoTransition[];
+};
+/**
+ * Options passed to `decrypt` when the wallet should decrypt a ciphertext
+ * that originated from a transition output (`tpk` + program/function/index
+ * are needed to derive the decryption key for that record position).
+ */
+export type AleoDecryptOptions = {
+    functionName?: string;
+    index?: number;
+    programId?: string;
+    tpk?: string;
+};
+/**
+ * Options for `requestRecords`. `plaintext` controls whether the wallet
+ * should return the raw plaintext records (when supported) or the encrypted
+ * record ciphertexts.
+ */
+export type AleoRequestRecordsOptions = {
+    plaintext?: boolean;
+};
+export type AleoWalletProvider = WalletProvider & {
+    chain: 'ALEO';
+    /**
+     * Decrypts an Aleo record ciphertext belonging to the connected wallet.
+     * Optional — not every wallet exposes the decrypt feature.
+     */
+    decrypt?: (args: {
+        ciphertext: string;
+        options?: AleoDecryptOptions;
+        walletAccount: AleoWalletAccount;
+    }) => Promise<{
+        plaintext: string;
+    }>;
+    /**
+     * Requests the wallet to return records owned by the connected account for
+     * a given program. Optional — not every wallet exposes the records feature.
+     */
+    requestRecords?: (args: {
+        options?: AleoRequestRecordsOptions;
+        program: string;
+        walletAccount: AleoWalletAccount;
+    }) => Promise<{
+        records: unknown[];
+    }>;
+    /**
+     * Submits an Aleo transaction (one or more transitions + fee) to the wallet
+     * for signing and broadcast. Returns the on-chain transaction id.
+     */
+    requestTransaction: (args: {
+        transaction: AleoTransaction;
+        walletAccount: AleoWalletAccount;
+    }) => Promise<{
+        transactionId: string;
+    }>;
+};
+//# sourceMappingURL=AleoWalletProvider.types.d.ts.map

package/dist/AleoWalletProvider.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AleoWalletProvider.types.d.ts","sourceRoot":"","sources":["../src/AleoWalletProvider.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,kBAAkB,CAAC;QAC7B,aAAa,EAAE,iBAAiB,CAAC;KAClC,KAAK,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,OAAO,CAAC,EAAE,yBAAyB,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,iBAAiB,CAAC;KAClC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACtC;;;OAGG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,eAAe,CAAC;QAC7B,aAAa,EAAE,iBAAiB,CAAC;KAClC,KAAK,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1C,CAAC"}

package/dist/errors/AleoFeatureUnsupportedError/AleoFeatureUnsupportedError.d.ts

@@ -0,0 +1,16 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+/**
+ * Thrown when an Aleo wallet does not advertise a feature the caller asked
+ * for — e.g. a wallet that lacks `aleo:decrypt` when `decrypt(...)` is
+ * invoked. Carries the feature name and the wallet display name so the
+ * UI / logs can surface which wallet was missing what.
+ */
+export declare class AleoFeatureUnsupportedError extends BaseError {
+    readonly featureName: string;
+    readonly walletName: string;
+    constructor(params: {
+        featureName: string;
+        walletName: string;
+    });
+}
+//# sourceMappingURL=AleoFeatureUnsupportedError.d.ts.map

package/dist/errors/AleoFeatureUnsupportedError/AleoFeatureUnsupportedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AleoFeatureUnsupportedError.d.ts","sourceRoot":"","sources":["../../../src/errors/AleoFeatureUnsupportedError/AleoFeatureUnsupportedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,SAAS;IACxD,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAYhE"}

package/dist/errors/AleoFeatureUnsupportedError/index.d.ts

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

package/dist/errors/AleoFeatureUnsupportedError/index.d.ts.map

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

package/dist/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+/**
+ * Thrown when an input meant to be an Aleo transaction id (`at1...`) does
+ * not match the bech32 pattern. Carries the offending value on `txId` for
+ * inclusion in error logs / UI surfaces.
+ */
+export declare class InvalidAleoTransactionIdError extends BaseError {
+    readonly txId: string;
+    constructor(params: {
+        txId: string;
+    });
+}
+//# sourceMappingURL=InvalidAleoTransactionIdError.d.ts.map

package/dist/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidAleoTransactionIdError.d.ts","sourceRoot":"","sources":["../../../src/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,SAAS;IAC1D,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CAWrC"}

package/dist/errors/InvalidAleoTransactionIdError/index.d.ts

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

package/dist/errors/InvalidAleoTransactionIdError/index.d.ts.map

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

package/dist/errors/NotAleoProviderError/NotAleoProviderError.d.ts

@@ -0,0 +1,15 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+/**
+ * Thrown by Aleo-specific top-level helpers (`signMessage`,
+ * `requestTransaction`, `decrypt`, `requestRecords`) when the wallet
+ * provider resolved from a wallet account is not an Aleo provider — i.e.
+ * the caller passed a wallet account from a different chain. Carries the
+ * offending provider's key on `providerKey`.
+ */
+export declare class NotAleoProviderError extends BaseError {
+    readonly providerKey: string;
+    constructor(params: {
+        providerKey: string;
+    });
+}
+//# sourceMappingURL=NotAleoProviderError.d.ts.map

package/dist/errors/NotAleoProviderError/NotAleoProviderError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotAleoProviderError.d.ts","sourceRoot":"","sources":["../../../src/errors/NotAleoProviderError/NotAleoProviderError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;CAW5C"}

package/dist/errors/NotAleoProviderError/index.d.ts

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

package/dist/errors/NotAleoProviderError/index.d.ts.map

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

package/dist/exports/index.d.ts

@@ -0,0 +1,13 @@
+export { AleoFeatureUnsupportedError } from '../errors/AleoFeatureUnsupportedError';
+export { InvalidAleoTransactionIdError } from '../errors/InvalidAleoTransactionIdError';
+export { NotAleoProviderError } from '../errors/NotAleoProviderError';
+export { isAleoNetworkProvider } from '../isAleoNetworkProvider';
+export { isAleoWalletAccount } from '../isAleoWalletAccount';
+export { isAleoWalletProvider } from '../isAleoWalletProvider';
+export type { AleoNetworkProvider } from '../AleoNetworkProvider.types';
+export type { AleoWalletAccount } from '../AleoWalletAccount.types';
+export type { AleoDecryptOptions, AleoRequestRecordsOptions, AleoTransaction, AleoTransition, AleoWalletProvider, } from '../AleoWalletProvider.types';
+export { getAleoExplorerTxUrl } from '../utils/getAleoExplorerTxUrl';
+export { ALEO_NETWORK_TO_ID_MAP, getNetworkByChainId, } from '../utils/getNetworkByChainId';
+export { ALEO_MAINNET_NETWORK_ID, ALEO_TESTNET_NETWORK_ID, MICROCREDITS_PER_CREDIT, } from '../utils/constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/exports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exports/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,211 @@
+let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
+let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
+let _provablehq_aleo_types = require("@provablehq/aleo-types");
+
+//#region package.json
+var name = "@dynamic-labs-sdk/aleo";
+var version = "0.27.1";
+
+//#endregion
+//#region src/errors/AleoFeatureUnsupportedError/AleoFeatureUnsupportedError.ts
+/**
+* Thrown when an Aleo wallet does not advertise a feature the caller asked
+* for — e.g. a wallet that lacks `aleo:decrypt` when `decrypt(...)` is
+* invoked. Carries the feature name and the wallet display name so the
+* UI / logs can surface which wallet was missing what.
+*/
+var AleoFeatureUnsupportedError = class extends _dynamic_labs_sdk_client.BaseError {
+	featureName;
+	walletName;
+	constructor(params) {
+		super({
+			cause: null,
+			code: "aleo_feature_unsupported_error",
+			docsUrl: null,
+			name: "AleoFeatureUnsupportedError",
+			shortMessage: `${params.walletName} does not support ${params.featureName}`
+		});
+		this.featureName = params.featureName;
+		this.walletName = params.walletName;
+	}
+};
+
+//#endregion
+//#region src/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.ts
+/**
+* Thrown when an input meant to be an Aleo transaction id (`at1...`) does
+* not match the bech32 pattern. Carries the offending value on `txId` for
+* inclusion in error logs / UI surfaces.
+*/
+var InvalidAleoTransactionIdError = class extends _dynamic_labs_sdk_client.BaseError {
+	txId;
+	constructor(params) {
+		super({
+			cause: null,
+			code: "invalid_aleo_transaction_id_error",
+			docsUrl: null,
+			name: "InvalidAleoTransactionIdError",
+			shortMessage: `Invalid Aleo transaction id: ${params.txId}`
+		});
+		this.txId = params.txId;
+	}
+};
+
+//#endregion
+//#region src/errors/NotAleoProviderError/NotAleoProviderError.ts
+/**
+* Thrown by Aleo-specific top-level helpers (`signMessage`,
+* `requestTransaction`, `decrypt`, `requestRecords`) when the wallet
+* provider resolved from a wallet account is not an Aleo provider — i.e.
+* the caller passed a wallet account from a different chain. Carries the
+* offending provider's key on `providerKey`.
+*/
+var NotAleoProviderError = class extends _dynamic_labs_sdk_client.BaseError {
+	providerKey;
+	constructor(params) {
+		super({
+			cause: null,
+			code: "not_aleo_provider_error",
+			docsUrl: null,
+			name: "NotAleoProviderError",
+			shortMessage: "Provider is not an Aleo wallet provider"
+		});
+		this.providerKey = params.providerKey;
+	}
+};
+
+//#endregion
+//#region src/isAleoNetworkProvider/isAleoNetworkProvider.ts
+/**
+* Type guard narrowing a generic `NetworkProvider` to `AleoNetworkProvider`.
+* Use this to filter the network-provider registry down to the Aleo
+* network providers.
+*
+* @not-instrumented
+*/
+const isAleoNetworkProvider = (networkProvider) => networkProvider.chain === "ALEO";
+
+//#endregion
+//#region src/isAleoWalletAccount/isAleoWalletAccount.ts
+/**
+* Type guard narrowing a generic `WalletAccount` to `AleoWalletAccount`.
+* Use this to filter mixed-chain wallet account lists down to the Aleo
+* accounts.
+*
+* @not-instrumented
+*/
+const isAleoWalletAccount = (walletAccount) => walletAccount.chain === "ALEO";
+
+//#endregion
+//#region src/isAleoWalletProvider/isAleoWalletProvider.ts
+/**
+* Type guard narrowing a generic `WalletProvider` to `AleoWalletProvider`.
+* Returns `true` when the provider's chain is `'ALEO'`. Mirrors the
+* `is{Chain}WalletProvider` pattern used by the sibling chain packages
+* (Tron, Sui, Aptos) — exposes the Aleo-specific methods like
+* `requestTransaction`, `decrypt`, and `requestRecords` to the caller.
+*
+* @not-instrumented
+*/
+const isAleoWalletProvider = (provider) => {
+	return provider.chain === "ALEO";
+};
+
+//#endregion
+//#region src/utils/constants.ts
+/**
+* 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.
+*/
+const MICROCREDITS_PER_CREDIT = 1e6;
+const ALEO_MAINNET_NETWORK_ID = 0;
+const ALEO_TESTNET_NETWORK_ID = 1;
+
+//#endregion
+//#region src/utils/isAleoMainnet/isAleoMainnet.ts
+/**
+* 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
+*/
+const isAleoMainnet = (networkId) => {
+	if (networkId === void 0 || networkId === null) return false;
+	if (typeof networkId === "number") return networkId === ALEO_MAINNET_NETWORK_ID;
+	return Number(networkId) === ALEO_MAINNET_NETWORK_ID;
+};
+
+//#endregion
+//#region src/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.ts
+/**
+* Aleo transaction ids are bech32-encoded with the `at1` prefix and a body
+* of lowercase alphanumerics — same character set as account addresses. We
+* validate strictly before letting the id reach the URL, refusing `/`, `?`,
+* `#`, `..`, etc. so a hostile id cannot produce path traversal or an open
+* redirect when the rendered URL is opened.
+*/
+const ALEO_TX_ID_PATTERN = /^at1[a-z0-9]{1,62}$/;
+/**
+* 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
+*/
+const getAleoExplorerTxUrl = ({ txId, networkId }) => {
+	if (!ALEO_TX_ID_PATTERN.test(txId)) throw new InvalidAleoTransactionIdError({ txId });
+	return `https://${isAleoMainnet(networkId) ? "" : "testnet."}explorer.provable.com/transaction/${txId}`;
+};
+
+//#endregion
+//#region src/utils/getNetworkByChainId/getNetworkByChainId.ts
+/**
+* Map from `@provablehq/aleo-types` Network enum to the numeric chain id used
+* everywhere else in the SDK (`0` = mainnet, `1` = testnet).
+*/
+const ALEO_NETWORK_TO_ID_MAP = {
+	[_provablehq_aleo_types.Network.MAINNET]: ALEO_MAINNET_NETWORK_ID,
+	[_provablehq_aleo_types.Network.TESTNET]: ALEO_TESTNET_NETWORK_ID
+};
+/**
+* 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
+*/
+const getNetworkByChainId = ({ chainId }) => {
+	return Object.entries(ALEO_NETWORK_TO_ID_MAP).find(([, id]) => id === chainId)?.[0];
+};
+
+//#endregion
+//#region src/exports/index.ts
+(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(name, version);
+
+//#endregion
+exports.ALEO_MAINNET_NETWORK_ID = ALEO_MAINNET_NETWORK_ID;
+exports.ALEO_NETWORK_TO_ID_MAP = ALEO_NETWORK_TO_ID_MAP;
+exports.ALEO_TESTNET_NETWORK_ID = ALEO_TESTNET_NETWORK_ID;
+exports.AleoFeatureUnsupportedError = AleoFeatureUnsupportedError;
+exports.InvalidAleoTransactionIdError = InvalidAleoTransactionIdError;
+exports.MICROCREDITS_PER_CREDIT = MICROCREDITS_PER_CREDIT;
+exports.NotAleoProviderError = NotAleoProviderError;
+exports.getAleoExplorerTxUrl = getAleoExplorerTxUrl;
+exports.getNetworkByChainId = getNetworkByChainId;
+exports.isAleoNetworkProvider = isAleoNetworkProvider;
+exports.isAleoWalletAccount = isAleoWalletAccount;
+exports.isAleoWalletProvider = isAleoWalletProvider;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["BaseError","BaseError","BaseError","ALEO_NETWORK_TO_ID_MAP: Partial<Record<Network, number>>","Network","packageName","packageVersion"],"sources":["../package.json","../src/errors/AleoFeatureUnsupportedError/AleoFeatureUnsupportedError.ts","../src/errors/InvalidAleoTransactionIdError/InvalidAleoTransactionIdError.ts","../src/errors/NotAleoProviderError/NotAleoProviderError.ts","../src/isAleoNetworkProvider/isAleoNetworkProvider.ts","../src/isAleoWalletAccount/isAleoWalletAccount.ts","../src/isAleoWalletProvider/isAleoWalletProvider.ts","../src/utils/constants.ts","../src/utils/isAleoMainnet/isAleoMainnet.ts","../src/utils/getAleoExplorerTxUrl/getAleoExplorerTxUrl.ts","../src/utils/getNetworkByChainId/getNetworkByChainId.ts","../src/exports/index.ts"],"sourcesContent":["","import { BaseError } from '@dynamic-labs-sdk/client';\n\n/**\n * Thrown when an Aleo wallet does not advertise a feature the caller asked\n * for — e.g. a wallet that lacks `aleo:decrypt` when `decrypt(...)` is\n * invoked. Carries the feature name and the wallet display name so the\n * UI / logs can surface which wallet was missing what.\n */\nexport class AleoFeatureUnsupportedError extends BaseError {\n  public readonly featureName: string;\n\n  public readonly walletName: string;\n\n  constructor(params: { featureName: string; walletName: string }) {\n    super({\n      cause: null,\n      code: 'aleo_feature_unsupported_error',\n      docsUrl: null,\n      name: 'AleoFeatureUnsupportedError',\n      shortMessage: `${params.walletName} does not support ${params.featureName}`,\n    });\n\n    this.featureName = params.featureName;\n    this.walletName = params.walletName;\n  }\n}\n","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 * @not-instrumented\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 * @not-instrumented\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 * @not-instrumented\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","/**\n * Aleo credits are denominated in microcredits — 1 credit = 1,000,000 mc.\n * Mirrors the SUN_PER_TRX / lamports-per-sol pattern in sibling chain packages.\n */\nexport const MICROCREDITS_PER_CREDIT = 1_000_000;\n\nexport const ALEO_MAINNET_NETWORK_ID = 0;\nexport const ALEO_TESTNET_NETWORK_ID = 1;\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 * @not-instrumented\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 * Examples:\n *   getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 0 })\n *     → 'https://explorer.provable.com/transaction/at1abc...'\n *   getAleoExplorerTxUrl({ txId: 'at1abc...', networkId: 1 })\n *     → 'https://testnet.explorer.provable.com/transaction/at1abc...'\n *\n * @throws InvalidAleoTransactionIdError when `txId` is not a well-formed\n *         bech32 Aleo transaction id.\n * @not-instrumented\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 { Network } from '@provablehq/aleo-types';\n\nimport {\n  ALEO_MAINNET_NETWORK_ID,\n  ALEO_TESTNET_NETWORK_ID,\n} from '../constants';\n\n/**\n * Map from `@provablehq/aleo-types` Network enum to the numeric chain id used\n * everywhere else in the SDK (`0` = mainnet, `1` = testnet).\n */\nexport const ALEO_NETWORK_TO_ID_MAP: Partial<Record<Network, number>> = {\n  [Network.MAINNET]: ALEO_MAINNET_NETWORK_ID,\n  [Network.TESTNET]: ALEO_TESTNET_NETWORK_ID,\n};\n\ntype GetNetworkByChainIdParams = {\n  chainId: number;\n};\n\n/**\n * Resolve the `@provablehq/aleo-types` Network enum value for a numeric\n * chain id, the bridge between the SDK's chain ids and the on-chain\n * network identifier the Aleo libraries expect.\n *\n * @param params.chainId The numeric chain id (`0` = mainnet, `1` = testnet).\n * @returns The matching `Network` enum value, or `undefined` when the id is\n *          not a known Aleo network.\n * @not-instrumented\n */\nexport const getNetworkByChainId = ({\n  chainId,\n}: GetNetworkByChainIdParams): Network | undefined => {\n  const entry = (\n    Object.entries(ALEO_NETWORK_TO_ID_MAP) as [Network, number][]\n  ).find(([, id]) => id === chainId);\n  return entry?.[0];\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":";;;;;;;;;;;;;;;;ACQA,IAAa,8BAAb,cAAiDA,mCAAU;CACzD,AAAgB;CAEhB,AAAgB;CAEhB,YAAY,QAAqD;AAC/D,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc,GAAG,OAAO,WAAW,oBAAoB,OAAO;GAC/D,CAAC;AAEF,OAAK,cAAc,OAAO;AAC1B,OAAK,aAAa,OAAO;;;;;;;;;;;AChB7B,IAAa,gCAAb,cAAmDC,mCAAU;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,cAA0CC,mCAAU;CAClD,AAAgB;CAEhB,YAAY,QAAiC;AAC3C,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cAAc;GACf,CAAC;AAEF,OAAK,cAAc,OAAO;;;;;;;;;;;;;ACV9B,MAAa,yBACX,oBAC2C,gBAAgB,UAAU;;;;;;;;;;;ACFvE,MAAa,uBACX,kBACuC,cAAc,UAAU;;;;;;;;;;;;;ACCjE,MAAa,wBACX,aACmC;AACnC,QAAO,SAAS,UAAU;;;;;;;;;ACb5B,MAAa,0BAA0B;AAEvC,MAAa,0BAA0B;AACvC,MAAa,0BAA0B;;;;;;;;;;;;;;ACMvC,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;;;;;;;;;;;;;;AA0B3B,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;;;;;;;;;ACjClE,MAAaC,yBAA2D;EACrEC,+BAAQ,UAAU;EAClBA,+BAAQ,UAAU;CACpB;;;;;;;;;;;AAgBD,MAAa,uBAAuB,EAClC,cACoD;AAIpD,QAFE,OAAO,QAAQ,uBAAuB,CACtC,MAAM,GAAG,QAAQ,OAAO,QAAQ,GACnB;;;;;mEC9BIC,MAAaC,QAAe"}