@dynamic-labs/aleo 4.91.3 → 4.91.4

package/CHANGELOG.md

@@ -1,4 +1,12 @@
 
+### [4.91.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.3...v4.91.4) (2026-07-01)
+
+
+### Bug Fixes
+
+* conditionally use /op/ route for AA transactions based on block explorer support ([#11628](https://github.com/dynamic-labs/dynamic-auth/issues/11628)) ([95822dc](https://github.com/dynamic-labs/dynamic-auth/commit/95822dc0edbcd739afe870f0b3881555fdb17eb6))
+* require error codes in all SDK error classes ([#11761](https://github.com/dynamic-labs/dynamic-auth/issues/11761)) ([5744811](https://github.com/dynamic-labs/dynamic-auth/commit/5744811efdd1e415aaf51eec5b3300b323ec1347))
+
 ### [4.91.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.2...v4.91.3) (2026-06-30)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.91.3";
+var version = "4.91.4";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.91.3";
+var version = "4.91.4";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/aleo",
-  "version": "4.91.3",
+  "version": "4.91.4",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,19 +18,19 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.91.3",
+    "@dynamic-labs/assert-package-version": "4.91.4",
     "@dynamic-labs-sdk/client": "1.12.1",
     "@dynamic-labs/sdk-api-core": "0.0.1046",
     "@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",
     "@provablehq/aleo-types": "0.3.0-alpha.3",
-    "@dynamic-labs/logger": "4.91.3",
-    "@dynamic-labs/types": "4.91.3",
-    "@dynamic-labs/utils": "4.91.3",
-    "@dynamic-labs/waas": "4.91.3",
-    "@dynamic-labs/wallet-book": "4.91.3",
-    "@dynamic-labs/wallet-connector-core": "4.91.3"
+    "@dynamic-labs/logger": "4.91.4",
+    "@dynamic-labs/types": "4.91.4",
+    "@dynamic-labs/utils": "4.91.4",
+    "@dynamic-labs/waas": "4.91.4",
+    "@dynamic-labs/wallet-book": "4.91.4",
+    "@dynamic-labs/wallet-connector-core": "4.91.4"
   },
   "peerDependencies": {}
 }

package/src/connectors/AleoWalletAdapterConnector/AleoWalletAdapterConnector.cjs

@@ -169,7 +169,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
                 yield this.adapter.connect(this.selectedNetwork, aleoWalletStandard.WalletDecryptPermission.UponRequest);
             }
             catch (error) {
-                throw new utils.DynamicError(`Failed to connect to ${this.name}: ${error}`);
+                throw new utils.DynamicError(`Failed to connect to ${this.name}: ${error}`, 'connect_to');
             }
         });
     }
@@ -180,7 +180,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
                 this.adapter = this.createAdapter();
             }
             if (!this.adapter) {
-                throw new utils.DynamicError('No adapter found');
+                throw new utils.DynamicError('No adapter found', 'no_adapter_found');
             }
             const { account } = this.adapter;
             if (account === null || account === void 0 ? void 0 : account.address) {
@@ -211,7 +211,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
                 return _super.signMessage.call(this, messageToSign);
             }
             if (!this.adapter.connected) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             try {
                 const messageBytes = new TextEncoder().encode(messageToSign);
@@ -220,7 +220,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
             }
             catch (error) {
                 walletConnectorCore.logger.error(`[${this.name}] Sign message failed:`, error);
-                throw new utils.DynamicError(`Failed to sign message: ${error}`);
+                throw new utils.DynamicError(`Failed to sign message: ${error}`, 'sign_message');
             }
         });
     }
@@ -267,7 +267,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
             }
             const [transition] = transaction.transitions;
             if (!transition) {
-                throw new utils.DynamicError('Transaction must have at least one transition');
+                throw new utils.DynamicError('Transaction must have at least one transition', 'transaction_must_have_at_least_one');
             }
             const options = {
                 fee: transaction.fee,
@@ -289,7 +289,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
                 return _super.decrypt.call(this, ciphertext, options);
             }
             if (!this.adapter.connected) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             return this.adapter.decrypt(ciphertext, options === null || options === void 0 ? void 0 : options.tpk, options === null || options === void 0 ? void 0 : options.programId, options === null || options === void 0 ? void 0 : options.functionName, options === null || options === void 0 ? void 0 : options.index);
         });
@@ -304,7 +304,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector.AleoWalletConnector
                 return _super.requestRecords.call(this, program, options);
             }
             if (!this.adapter.connected) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             return this.adapter.requestRecords(program, (_a = options === null || options === void 0 ? void 0 : options.plaintext) !== null && _a !== void 0 ? _a : false);
         });

package/src/connectors/AleoWalletAdapterConnector/AleoWalletAdapterConnector.js

@@ -165,7 +165,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
                 yield this.adapter.connect(this.selectedNetwork, WalletDecryptPermission.UponRequest);
             }
             catch (error) {
-                throw new DynamicError(`Failed to connect to ${this.name}: ${error}`);
+                throw new DynamicError(`Failed to connect to ${this.name}: ${error}`, 'connect_to');
             }
         });
     }
@@ -176,7 +176,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
                 this.adapter = this.createAdapter();
             }
             if (!this.adapter) {
-                throw new DynamicError('No adapter found');
+                throw new DynamicError('No adapter found', 'no_adapter_found');
             }
             const { account } = this.adapter;
             if (account === null || account === void 0 ? void 0 : account.address) {
@@ -207,7 +207,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
                 return _super.signMessage.call(this, messageToSign);
             }
             if (!this.adapter.connected) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             try {
                 const messageBytes = new TextEncoder().encode(messageToSign);
@@ -216,7 +216,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
             }
             catch (error) {
                 logger.error(`[${this.name}] Sign message failed:`, error);
-                throw new DynamicError(`Failed to sign message: ${error}`);
+                throw new DynamicError(`Failed to sign message: ${error}`, 'sign_message');
             }
         });
     }
@@ -263,7 +263,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
             }
             const [transition] = transaction.transitions;
             if (!transition) {
-                throw new DynamicError('Transaction must have at least one transition');
+                throw new DynamicError('Transaction must have at least one transition', 'transaction_must_have_at_least_one');
             }
             const options = {
                 fee: transaction.fee,
@@ -285,7 +285,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
                 return _super.decrypt.call(this, ciphertext, options);
             }
             if (!this.adapter.connected) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             return this.adapter.decrypt(ciphertext, options === null || options === void 0 ? void 0 : options.tpk, options === null || options === void 0 ? void 0 : options.programId, options === null || options === void 0 ? void 0 : options.functionName, options === null || options === void 0 ? void 0 : options.index);
         });
@@ -300,7 +300,7 @@ class AleoWalletAdapterConnector extends AleoWalletConnector {
                 return _super.requestRecords.call(this, program, options);
             }
             if (!this.adapter.connected) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             return this.adapter.requestRecords(program, (_a = options === null || options === void 0 ? void 0 : options.plaintext) !== null && _a !== void 0 ? _a : false);
         });

package/src/connectors/AleoWalletConnector/AleoWalletConnector.cjs

@@ -61,11 +61,11 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
             var _a, _b;
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new utils.DynamicError(`${this.name} is not installed`);
+                throw new utils.DynamicError(`${this.name} is not installed`, 'is_not_installed');
             }
             const connectFeature = wallet.features[aleoWalletStandard.WalletFeatureName.CONNECT];
             if (!(connectFeature === null || connectFeature === void 0 ? void 0 : connectFeature.available)) {
-                throw new utils.DynamicError(`${this.name} does not support connect`);
+                throw new utils.DynamicError(`${this.name} does not support connect`, 'does_not_support_connect');
             }
             const networkId = (_a = this.aleoNetworks[0]) === null || _a === void 0 ? void 0 : _a.networkId;
             const chain = (_b = NetworkIdToAleoChain[String(networkId)]) !== null && _b !== void 0 ? _b : aleoWalletStandard.ALEO_CHAINS.MAINNET;
@@ -73,7 +73,7 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
                 yield connectFeature.connect(aleoWalletStandard.WalletDecryptPermission.UponRequest, chain);
             }
             catch (error) {
-                throw new utils.DynamicError(`Failed to connect to ${this.name}: ${error}`);
+                throw new utils.DynamicError(`Failed to connect to ${this.name}: ${error}`, 'connect_to');
             }
             const accountsFeature = wallet.features[aleoWalletStandard.WalletFeatureName.ACCOUNTS];
             if (accountsFeature === null || accountsFeature === void 0 ? void 0 : accountsFeature.available) {
@@ -137,18 +137,18 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const signFeature = wallet.features[aleoWalletStandard.WalletFeatureName.SIGN];
             if (!(signFeature === null || signFeature === void 0 ? void 0 : signFeature.available)) {
-                throw new utils.DynamicError(`${this.name} does not support message signing`);
+                throw new utils.DynamicError(`${this.name} does not support message signing`, 'does_not_support_message_signing');
             }
             try {
                 return yield signFeature.signMessage(messageToSign);
             }
             catch (error) {
                 walletConnectorCore.logger.error(`[${this.name}] Sign message failed:`, error);
-                throw new utils.DynamicError(`Failed to sign message: ${error}`);
+                throw new utils.DynamicError(`Failed to sign message: ${error}`, 'sign_message');
             }
         });
     }
@@ -156,11 +156,11 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const executeFeature = wallet.features[aleoWalletStandard.WalletFeatureName.EXECUTE];
             if (!(executeFeature === null || executeFeature === void 0 ? void 0 : executeFeature.available)) {
-                throw new utils.DynamicError(`${this.name} does not support transaction execution`);
+                throw new utils.DynamicError(`${this.name} does not support transaction execution`, 'does_not_support_transaction_execution');
             }
             return executeFeature.requestTransaction(transaction);
         });
@@ -169,11 +169,11 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const decryptFeature = wallet.features[aleoWalletStandard.WalletFeatureName.DECRYPT];
             if (!(decryptFeature === null || decryptFeature === void 0 ? void 0 : decryptFeature.available)) {
-                throw new utils.DynamicError(`${this.name} does not support decryption`);
+                throw new utils.DynamicError(`${this.name} does not support decryption`, 'does_not_support_decryption');
             }
             return decryptFeature.decrypt(ciphertext, options);
         });
@@ -182,11 +182,11 @@ class AleoWalletConnector extends walletConnectorCore.WalletConnectorBase {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new utils.DynamicError(WALLET_NOT_CONNECTED);
+                throw new utils.DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const recordsFeature = wallet.features[aleoWalletStandard.WalletFeatureName.REQUEST_RECORDS];
             if (!(recordsFeature === null || recordsFeature === void 0 ? void 0 : recordsFeature.available)) {
-                throw new utils.DynamicError(`${this.name} does not support record requests`);
+                throw new utils.DynamicError(`${this.name} does not support record requests`, 'does_not_support_record_requests');
             }
             return recordsFeature.requestRecords(program, options);
         });

package/src/connectors/AleoWalletConnector/AleoWalletConnector.js

@@ -57,11 +57,11 @@ class AleoWalletConnector extends WalletConnectorBase {
             var _a, _b;
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new DynamicError(`${this.name} is not installed`);
+                throw new DynamicError(`${this.name} is not installed`, 'is_not_installed');
             }
             const connectFeature = wallet.features[WalletFeatureName.CONNECT];
             if (!(connectFeature === null || connectFeature === void 0 ? void 0 : connectFeature.available)) {
-                throw new DynamicError(`${this.name} does not support connect`);
+                throw new DynamicError(`${this.name} does not support connect`, 'does_not_support_connect');
             }
             const networkId = (_a = this.aleoNetworks[0]) === null || _a === void 0 ? void 0 : _a.networkId;
             const chain = (_b = NetworkIdToAleoChain[String(networkId)]) !== null && _b !== void 0 ? _b : ALEO_CHAINS.MAINNET;
@@ -69,7 +69,7 @@ class AleoWalletConnector extends WalletConnectorBase {
                 yield connectFeature.connect(WalletDecryptPermission.UponRequest, chain);
             }
             catch (error) {
-                throw new DynamicError(`Failed to connect to ${this.name}: ${error}`);
+                throw new DynamicError(`Failed to connect to ${this.name}: ${error}`, 'connect_to');
             }
             const accountsFeature = wallet.features[WalletFeatureName.ACCOUNTS];
             if (accountsFeature === null || accountsFeature === void 0 ? void 0 : accountsFeature.available) {
@@ -133,18 +133,18 @@ class AleoWalletConnector extends WalletConnectorBase {
         return __awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const signFeature = wallet.features[WalletFeatureName.SIGN];
             if (!(signFeature === null || signFeature === void 0 ? void 0 : signFeature.available)) {
-                throw new DynamicError(`${this.name} does not support message signing`);
+                throw new DynamicError(`${this.name} does not support message signing`, 'does_not_support_message_signing');
             }
             try {
                 return yield signFeature.signMessage(messageToSign);
             }
             catch (error) {
                 logger.error(`[${this.name}] Sign message failed:`, error);
-                throw new DynamicError(`Failed to sign message: ${error}`);
+                throw new DynamicError(`Failed to sign message: ${error}`, 'sign_message');
             }
         });
     }
@@ -152,11 +152,11 @@ class AleoWalletConnector extends WalletConnectorBase {
         return __awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const executeFeature = wallet.features[WalletFeatureName.EXECUTE];
             if (!(executeFeature === null || executeFeature === void 0 ? void 0 : executeFeature.available)) {
-                throw new DynamicError(`${this.name} does not support transaction execution`);
+                throw new DynamicError(`${this.name} does not support transaction execution`, 'does_not_support_transaction_execution');
             }
             return executeFeature.requestTransaction(transaction);
         });
@@ -165,11 +165,11 @@ class AleoWalletConnector extends WalletConnectorBase {
         return __awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const decryptFeature = wallet.features[WalletFeatureName.DECRYPT];
             if (!(decryptFeature === null || decryptFeature === void 0 ? void 0 : decryptFeature.available)) {
-                throw new DynamicError(`${this.name} does not support decryption`);
+                throw new DynamicError(`${this.name} does not support decryption`, 'does_not_support_decryption');
             }
             return decryptFeature.decrypt(ciphertext, options);
         });
@@ -178,11 +178,11 @@ class AleoWalletConnector extends WalletConnectorBase {
         return __awaiter(this, void 0, void 0, function* () {
             const wallet = this.getStandardWallet();
             if (!wallet) {
-                throw new DynamicError(WALLET_NOT_CONNECTED);
+                throw new DynamicError(WALLET_NOT_CONNECTED, 'wallet_not_connected');
             }
             const recordsFeature = wallet.features[WalletFeatureName.REQUEST_RECORDS];
             if (!(recordsFeature === null || recordsFeature === void 0 ? void 0 : recordsFeature.available)) {
-                throw new DynamicError(`${this.name} does not support record requests`);
+                throw new DynamicError(`${this.name} does not support record requests`, 'does_not_support_record_requests');
             }
             return recordsFeature.requestRecords(program, options);
         });

package/src/connectors/DynamicWaasAleoConnector/DynamicWaasAleoConnector.cjs

@@ -144,7 +144,7 @@ const buildPublicTransferInputs = (args) => {
     }
     // arc21 — token_registry.aleo/transfer_public(token_id, recipient, amount).
     if (!token.tokenId) {
-        throw new utils.DynamicError(`transfer_public: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`);
+        throw new utils.DynamicError(`transfer_public: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`, 'transferpublic_arc21_token_is_missing_tokenid');
     }
     return {
         functionName,
@@ -188,7 +188,7 @@ const buildShieldInputs = (args) => {
     }
     // arc21
     if (!token.tokenId) {
-        throw new utils.DynamicError(`shieldToken: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`);
+        throw new utils.DynamicError(`shieldToken: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`, 'shieldtoken_arc21_token_is_missing_tokenid');
     }
     const externalAuth = token.externalAuthRequired ? 'true' : 'false';
     return {
@@ -205,7 +205,7 @@ const buildShieldInputs = (args) => {
 const joinShapeForProgram = (programId) => {
     const shape = JOIN_PROGRAM_SHAPES[programId];
     if (!shape) {
-        throw new utils.DynamicError(`joinRecords: program ${programId} has no registered join-record shape.`);
+        throw new utils.DynamicError(`joinRecords: program ${programId} has no registered join-record shape.`, 'joinrecords_program_has_no_registered_joinrecord');
     }
     return shape;
 };
@@ -285,7 +285,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
             var _a;
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new utils.DynamicError('Signed session ID is required');
+                throw new utils.DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             return signedSessionId;
         });
@@ -301,7 +301,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 signedSessionId,
             });
             if (!targetWallet) {
-                throw new utils.DynamicError('Account not found');
+                throw new utils.DynamicError('Account not found', 'account_not_found');
             }
             const isWalletActive = walletConnectorCore.isSameAddress(targetWallet.accountAddress, this.activeAccountAddress || '', this.connectedChain);
             if (!isWalletActive) {
@@ -339,19 +339,19 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     signMessage(message) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
-            throw new utils.DynamicError('Aleo signMessage is not supported yet — pending EdBls12377.sign(bytes) from Sodot');
+            throw new utils.DynamicError('Aleo signMessage is not supported yet — pending EdBls12377.sign(bytes) from Sodot', 'aleo_signmessage_is_not_supported_yet');
         });
     }
     /* eslint-disable @typescript-eslint/no-unused-vars */
     signMessageWithContext({ message, context, }) {
         /* eslint-enable @typescript-eslint/no-unused-vars */
-        throw new utils.DynamicError('Method not implemented.');
+        throw new utils.DynamicError('Method not implemented.', 'method_not_implemented');
     }
     // Phase 1: signTransaction not supported (signAleoRequest ceremony not wired up)
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     signTransaction(_transaction) {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
-            throw new utils.DynamicError('Aleo signTransaction is not supported yet — coming in Phase 2');
+            throw new utils.DynamicError('Aleo signTransaction is not supported yet — coming in Phase 2', 'aleo_signtransaction_is_not_supported_yet');
         });
     }
     /**
@@ -363,7 +363,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
             var _a, _b;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const walletClient = yield this.getWaasWalletClient();
             const signedSessionId = yield this.requireSignedSessionId();
@@ -405,10 +405,10 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             var _a;
             if (!((_a = transaction.transitions) === null || _a === void 0 ? void 0 : _a.length)) {
-                throw new utils.DynamicError('AleoTransaction must have at least one transition');
+                throw new utils.DynamicError('AleoTransaction must have at least one transition', 'aleotransaction_must_have_at_least_one');
             }
             if (transaction.transitions.length > 1) {
-                throw new utils.DynamicError('requestTransaction supports a single transition; use proveTransaction for multi-transition flows');
+                throw new utils.DynamicError('requestTransaction supports a single transition; use proveTransaction for multi-transition flows', 'requesttransaction_supports_a_single_transition_use');
             }
             const [{ program, functionName, inputs }] = transaction.transitions;
             const stringInputs = inputs.map(String);
@@ -420,7 +420,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 programId: program,
             });
             if (!txId) {
-                throw new utils.DynamicError('Transaction broadcast did not return a transaction id.');
+                throw new utils.DynamicError('Transaction broadcast did not return a transaction id.', 'transaction_broadcast_did_not_return_a');
             }
             return txId;
         });
@@ -444,7 +444,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
             var _a, _b;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const walletClient = yield this.getWaasWalletClient();
             const signedSessionId = yield this.requireSignedSessionId();
@@ -499,7 +499,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
             var _a;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const byProgram = yield this.fetchAndGroupOwnedRecords(opts === null || opts === void 0 ? void 0 : opts.filterRecord);
             // Caller-supplied list takes precedence; default merges every program
@@ -671,7 +671,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `[joinRecords:${expectedProgramName}] polling: fresh=${fresh.length}/${expectedNewCount}`);
                 yield new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
             }
-            throw new utils.DynamicError(`joinRecords timed out waiting for ${expectedProgramName} joined outputs from RecordScanner. The transactions may have broadcast successfully — try calling joinRecords again after the network settles.`);
+            throw new utils.DynamicError(`joinRecords timed out waiting for ${expectedProgramName} joined outputs from RecordScanner. The transactions may have broadcast successfully — try calling joinRecords again after the network settles.`, 'joinrecords_timed_out_waiting_for_joined');
         });
     }
     /**
@@ -780,7 +780,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                         programId: token.programId,
                     });
                     if (!result.txId) {
-                        throw new utils.DynamicError('Aleo transfer broadcast did not return a transaction id.');
+                        throw new utils.DynamicError('Aleo transfer broadcast did not return a transaction id.', 'aleo_transfer_broadcast_did_not_return');
                     }
                     return result.txId;
                 }),
@@ -891,17 +891,17 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
         return _tslib.__awaiter(this, void 0, void 0, function* () {
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new utils.DynamicError('Active account address is required');
+                throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             if (args.amount <= BigInt(0)) {
-                throw new utils.DynamicError('Shield amount must be > 0.');
+                throw new utils.DynamicError('Shield amount must be > 0.', 'shield_amount_must_be_0');
             }
             const token = this.resolveShieldableToken({
                 address: args.tokenAddress,
                 isNative: args.isNative,
             });
             if (!token) {
-                throw new utils.DynamicError(`shieldToken: ${args.tokenAddress} is not a registered shieldable Aleo token on the current network.`);
+                throw new utils.DynamicError(`shieldToken: ${args.tokenAddress} is not a registered shieldable Aleo token on the current network.`, 'shieldtoken_is_not_a_registered_shieldable');
             }
             // Dedup by `(activeAccountAddress, programId)`. We deliberately ignore
             //  `args.amount` in the key — if two call sites race, they're reading
@@ -945,7 +945,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 programId: token.programId,
             });
             if (!result.txId) {
-                throw new utils.DynamicError('Aleo shield broadcast did not return a transaction id.');
+                throw new utils.DynamicError('Aleo shield broadcast did not return a transaction id.', 'aleo_shield_broadcast_did_not_return');
             }
             return result.txId;
         });
@@ -968,7 +968,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
             const tokens = aleoSendableTokens.getAleoSendableTokensForNetwork(networkId);
             const token = tokens.find((t) => t.programId === programId);
             if (!token) {
-                throw new utils.DynamicError(`sendBalance: Aleo token '${programId}' is not supported on this network. Use proveTransaction for custom programs.`);
+                throw new utils.DynamicError(`sendBalance: Aleo token '${programId}' is not supported on this network. Use proveTransaction for custom programs.`, 'sendbalance_aleo_token_is_not_supported');
             }
             const value = BigInt(Math.round(parseFloat(amount) * Math.pow(10, token.decimals)));
             const { records: rawRecords } = yield this.listOwnedRecords();
@@ -988,12 +988,12 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 return 0;
             });
             if (fitting.length === 0) {
-                throw new utils.DynamicError('No single private record covers this amount. Merge records first via wallet.joinRecords().');
+                throw new utils.DynamicError('No single private record covers this amount. Merge records first via wallet.joinRecords().', 'no_single_private_record_covers_this');
             }
             const recordPlaintext = fitting[0].plaintext;
             if (mode === 'exchange') {
                 if (!this.activeAccountAddress) {
-                    throw new utils.DynamicError('Active account address is required');
+                    throw new utils.DynamicError('Active account address is required', 'active_account_address_is_required');
                 }
                 return this.submitExchangeTransfer({
                     from: this.activeAccountAddress,
@@ -1018,7 +1018,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                 programId: token.programId,
             });
             if (!result.txId) {
-                throw new utils.DynamicError('Aleo transfer_private did not return a transaction id.');
+                throw new utils.DynamicError('Aleo transfer_private did not return a transaction id.', 'aleo_transferprivate_did_not_return_a');
             }
             return result.txId;
         });
@@ -1069,7 +1069,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                     programId: token.programId,
                 });
                 if (!step1Result.txId) {
-                    throw new utils.DynamicError('Aleo Exchange step 1 (unshield) did not return a transaction id.');
+                    throw new utils.DynamicError('Aleo Exchange step 1 (unshield) did not return a transaction id.', 'aleo_exchange_step_1_unshield_did');
                 }
                 (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `[exchangeTransfer:${token.programId}] step 1 (unshield) tx: ${step1Result.txId}`);
                 // Wait for step 1 to finalize and surface in public balance before
@@ -1088,7 +1088,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                             programId: token.programId,
                         });
                         if (!step2Result.txId) {
-                            throw new utils.DynamicError('Aleo Exchange step 2 (public transfer) did not return a transaction id.');
+                            throw new utils.DynamicError('Aleo Exchange step 2 (public transfer) did not return a transaction id.', 'aleo_exchange_step_2_public_transfer');
                         }
                         (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `[exchangeTransfer:${token.programId}] step 2 (public transfer) tx: ${step2Result.txId}`);
                         return step2Result.txId;
@@ -1101,7 +1101,7 @@ class DynamicWaasAleoConnector extends waas.withDynamicWaas(WaasAleoWalletConnec
                         }
                     }
                 }
-                throw new utils.DynamicError(`Aleo Exchange step 2 (public transfer) failed after ${EXCHANGE_STEP2_MAX_RETRIES + 1} attempts. Step 1 unshield (tx ${step1Result.txId}) succeeded — your funds are now in your public balance and can be sent to the exchange via a manual public transfer. Last error: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+                throw new utils.DynamicError(`Aleo Exchange step 2 (public transfer) failed after ${EXCHANGE_STEP2_MAX_RETRIES + 1} attempts. Step 1 unshield (tx ${step1Result.txId}) succeeded — your funds are now in your public balance and can be sent to the exchange via a manual public transfer. Last error: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`, 'aleo_exchange_step_2_public_transfer');
             }
             finally {
                 this.tokensPendingExchange.delete(token.programId);

package/src/connectors/DynamicWaasAleoConnector/DynamicWaasAleoConnector.d.ts

@@ -167,7 +167,23 @@ declare const DynamicWaasAleoConnector_base: (abstract new (...args: any[]) => {
     }): Promise<import("@dynamic-labs-wallet/browser-wallet-client").WalletRecoveryState>;
     endSession(reason?: LogoutReason | undefined): Promise<void>;
     getActiveAccountAddress(): Promise<string | undefined>;
-    getConnectedAccounts(): Promise<string[]>;
+    getConnectedAccounts(): Promise<string[]>; /**
+     * Builds the `(functionName, inputs, inputTypes)` triple for a
+     * `<program>/transfer_public_to_private` shield call to self. Mirrors
+     * `buildTransferInputs` shape — three program kinds, three signatures:
+     *
+     *  - `credits`     u64 amounts. inputs `[recipient, amount]`.
+     *  - `stablecoin`  u128 amounts. inputs `[recipient, amount]`. Sealance
+     *                  proof is NOT appended for `transfer_public_to_private`
+     *                  (verified against the iframe's
+     *                  `SEALANCE_FUNCTIONS_REQUIRING_PROOF` set, which only
+     *                  covers `transfer_private` / `transfer_private_to_public`).
+     *  - `arc21`       u128 amounts. inputs `[token_id, recipient, amount,
+     *                  external_auth_required]`. Token_id from the registry;
+     *                  external_auth from the per-token registry entry
+     *                  (defaults to `false` when unset). Verified against
+     *                  `token_registry.aleo` source via the Provable explorer.
+     */
     generateTraceId(): string;
     buildErrorInstrumentContext(error: unknown): {
         errorCode: string | import("@dynamic-labs/utils").ErrorCode;

package/src/connectors/DynamicWaasAleoConnector/DynamicWaasAleoConnector.js

@@ -140,7 +140,7 @@ const buildPublicTransferInputs = (args) => {
     }
     // arc21 — token_registry.aleo/transfer_public(token_id, recipient, amount).
     if (!token.tokenId) {
-        throw new DynamicError(`transfer_public: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`);
+        throw new DynamicError(`transfer_public: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`, 'transferpublic_arc21_token_is_missing_tokenid');
     }
     return {
         functionName,
@@ -184,7 +184,7 @@ const buildShieldInputs = (args) => {
     }
     // arc21
     if (!token.tokenId) {
-        throw new DynamicError(`shieldToken: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`);
+        throw new DynamicError(`shieldToken: ARC-21 token ${token.contractAddress} is missing tokenId in registry.`, 'shieldtoken_arc21_token_is_missing_tokenid');
     }
     const externalAuth = token.externalAuthRequired ? 'true' : 'false';
     return {
@@ -201,7 +201,7 @@ const buildShieldInputs = (args) => {
 const joinShapeForProgram = (programId) => {
     const shape = JOIN_PROGRAM_SHAPES[programId];
     if (!shape) {
-        throw new DynamicError(`joinRecords: program ${programId} has no registered join-record shape.`);
+        throw new DynamicError(`joinRecords: program ${programId} has no registered join-record shape.`, 'joinrecords_program_has_no_registered_joinrecord');
     }
     return shape;
 };
@@ -281,7 +281,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
             var _a;
             const signedSessionId = yield ((_a = this.getSignedSessionId) === null || _a === void 0 ? void 0 : _a.call(this));
             if (!signedSessionId) {
-                throw new DynamicError('Signed session ID is required');
+                throw new DynamicError('Signed session ID is required', 'signed_session_id_is_required');
             }
             return signedSessionId;
         });
@@ -297,7 +297,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 signedSessionId,
             });
             if (!targetWallet) {
-                throw new DynamicError('Account not found');
+                throw new DynamicError('Account not found', 'account_not_found');
             }
             const isWalletActive = isSameAddress(targetWallet.accountAddress, this.activeAccountAddress || '', this.connectedChain);
             if (!isWalletActive) {
@@ -335,19 +335,19 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     signMessage(message) {
         return __awaiter(this, void 0, void 0, function* () {
-            throw new DynamicError('Aleo signMessage is not supported yet — pending EdBls12377.sign(bytes) from Sodot');
+            throw new DynamicError('Aleo signMessage is not supported yet — pending EdBls12377.sign(bytes) from Sodot', 'aleo_signmessage_is_not_supported_yet');
         });
     }
     /* eslint-disable @typescript-eslint/no-unused-vars */
     signMessageWithContext({ message, context, }) {
         /* eslint-enable @typescript-eslint/no-unused-vars */
-        throw new DynamicError('Method not implemented.');
+        throw new DynamicError('Method not implemented.', 'method_not_implemented');
     }
     // Phase 1: signTransaction not supported (signAleoRequest ceremony not wired up)
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     signTransaction(_transaction) {
         return __awaiter(this, void 0, void 0, function* () {
-            throw new DynamicError('Aleo signTransaction is not supported yet — coming in Phase 2');
+            throw new DynamicError('Aleo signTransaction is not supported yet — coming in Phase 2', 'aleo_signtransaction_is_not_supported_yet');
         });
     }
     /**
@@ -359,7 +359,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
             var _a, _b;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const walletClient = yield this.getWaasWalletClient();
             const signedSessionId = yield this.requireSignedSessionId();
@@ -401,10 +401,10 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
             if (!((_a = transaction.transitions) === null || _a === void 0 ? void 0 : _a.length)) {
-                throw new DynamicError('AleoTransaction must have at least one transition');
+                throw new DynamicError('AleoTransaction must have at least one transition', 'aleotransaction_must_have_at_least_one');
             }
             if (transaction.transitions.length > 1) {
-                throw new DynamicError('requestTransaction supports a single transition; use proveTransaction for multi-transition flows');
+                throw new DynamicError('requestTransaction supports a single transition; use proveTransaction for multi-transition flows', 'requesttransaction_supports_a_single_transition_use');
             }
             const [{ program, functionName, inputs }] = transaction.transitions;
             const stringInputs = inputs.map(String);
@@ -416,7 +416,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 programId: program,
             });
             if (!txId) {
-                throw new DynamicError('Transaction broadcast did not return a transaction id.');
+                throw new DynamicError('Transaction broadcast did not return a transaction id.', 'transaction_broadcast_did_not_return_a');
             }
             return txId;
         });
@@ -440,7 +440,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
             var _a, _b;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const walletClient = yield this.getWaasWalletClient();
             const signedSessionId = yield this.requireSignedSessionId();
@@ -495,7 +495,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
             var _a;
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             const byProgram = yield this.fetchAndGroupOwnedRecords(opts === null || opts === void 0 ? void 0 : opts.filterRecord);
             // Caller-supplied list takes precedence; default merges every program
@@ -667,7 +667,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `[joinRecords:${expectedProgramName}] polling: fresh=${fresh.length}/${expectedNewCount}`);
                 yield new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
             }
-            throw new DynamicError(`joinRecords timed out waiting for ${expectedProgramName} joined outputs from RecordScanner. The transactions may have broadcast successfully — try calling joinRecords again after the network settles.`);
+            throw new DynamicError(`joinRecords timed out waiting for ${expectedProgramName} joined outputs from RecordScanner. The transactions may have broadcast successfully — try calling joinRecords again after the network settles.`, 'joinrecords_timed_out_waiting_for_joined');
         });
     }
     /**
@@ -776,7 +776,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                         programId: token.programId,
                     });
                     if (!result.txId) {
-                        throw new DynamicError('Aleo transfer broadcast did not return a transaction id.');
+                        throw new DynamicError('Aleo transfer broadcast did not return a transaction id.', 'aleo_transfer_broadcast_did_not_return');
                     }
                     return result.txId;
                 }),
@@ -887,17 +887,17 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
         return __awaiter(this, void 0, void 0, function* () {
             this.ensureActiveAccountFromVerifiedCredentials();
             if (!this.activeAccountAddress) {
-                throw new DynamicError('Active account address is required');
+                throw new DynamicError('Active account address is required', 'active_account_address_is_required');
             }
             if (args.amount <= BigInt(0)) {
-                throw new DynamicError('Shield amount must be > 0.');
+                throw new DynamicError('Shield amount must be > 0.', 'shield_amount_must_be_0');
             }
             const token = this.resolveShieldableToken({
                 address: args.tokenAddress,
                 isNative: args.isNative,
             });
             if (!token) {
-                throw new DynamicError(`shieldToken: ${args.tokenAddress} is not a registered shieldable Aleo token on the current network.`);
+                throw new DynamicError(`shieldToken: ${args.tokenAddress} is not a registered shieldable Aleo token on the current network.`, 'shieldtoken_is_not_a_registered_shieldable');
             }
             // Dedup by `(activeAccountAddress, programId)`. We deliberately ignore
             //  `args.amount` in the key — if two call sites race, they're reading
@@ -941,7 +941,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 programId: token.programId,
             });
             if (!result.txId) {
-                throw new DynamicError('Aleo shield broadcast did not return a transaction id.');
+                throw new DynamicError('Aleo shield broadcast did not return a transaction id.', 'aleo_shield_broadcast_did_not_return');
             }
             return result.txId;
         });
@@ -964,7 +964,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
             const tokens = getAleoSendableTokensForNetwork(networkId);
             const token = tokens.find((t) => t.programId === programId);
             if (!token) {
-                throw new DynamicError(`sendBalance: Aleo token '${programId}' is not supported on this network. Use proveTransaction for custom programs.`);
+                throw new DynamicError(`sendBalance: Aleo token '${programId}' is not supported on this network. Use proveTransaction for custom programs.`, 'sendbalance_aleo_token_is_not_supported');
             }
             const value = BigInt(Math.round(parseFloat(amount) * Math.pow(10, token.decimals)));
             const { records: rawRecords } = yield this.listOwnedRecords();
@@ -984,12 +984,12 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 return 0;
             });
             if (fitting.length === 0) {
-                throw new DynamicError('No single private record covers this amount. Merge records first via wallet.joinRecords().');
+                throw new DynamicError('No single private record covers this amount. Merge records first via wallet.joinRecords().', 'no_single_private_record_covers_this');
             }
             const recordPlaintext = fitting[0].plaintext;
             if (mode === 'exchange') {
                 if (!this.activeAccountAddress) {
-                    throw new DynamicError('Active account address is required');
+                    throw new DynamicError('Active account address is required', 'active_account_address_is_required');
                 }
                 return this.submitExchangeTransfer({
                     from: this.activeAccountAddress,
@@ -1014,7 +1014,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                 programId: token.programId,
             });
             if (!result.txId) {
-                throw new DynamicError('Aleo transfer_private did not return a transaction id.');
+                throw new DynamicError('Aleo transfer_private did not return a transaction id.', 'aleo_transferprivate_did_not_return_a');
             }
             return result.txId;
         });
@@ -1065,7 +1065,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                     programId: token.programId,
                 });
                 if (!step1Result.txId) {
-                    throw new DynamicError('Aleo Exchange step 1 (unshield) did not return a transaction id.');
+                    throw new DynamicError('Aleo Exchange step 1 (unshield) did not return a transaction id.', 'aleo_exchange_step_1_unshield_did');
                 }
                 (_b = (_a = this.logger).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `[exchangeTransfer:${token.programId}] step 1 (unshield) tx: ${step1Result.txId}`);
                 // Wait for step 1 to finalize and surface in public balance before
@@ -1084,7 +1084,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                             programId: token.programId,
                         });
                         if (!step2Result.txId) {
-                            throw new DynamicError('Aleo Exchange step 2 (public transfer) did not return a transaction id.');
+                            throw new DynamicError('Aleo Exchange step 2 (public transfer) did not return a transaction id.', 'aleo_exchange_step_2_public_transfer');
                         }
                         (_d = (_c = this.logger).debug) === null || _d === void 0 ? void 0 : _d.call(_c, `[exchangeTransfer:${token.programId}] step 2 (public transfer) tx: ${step2Result.txId}`);
                         return step2Result.txId;
@@ -1097,7 +1097,7 @@ class DynamicWaasAleoConnector extends withDynamicWaas(WaasAleoWalletConnector)
                         }
                     }
                 }
-                throw new DynamicError(`Aleo Exchange step 2 (public transfer) failed after ${EXCHANGE_STEP2_MAX_RETRIES + 1} attempts. Step 1 unshield (tx ${step1Result.txId}) succeeded — your funds are now in your public balance and can be sent to the exchange via a manual public transfer. Last error: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
+                throw new DynamicError(`Aleo Exchange step 2 (public transfer) failed after ${EXCHANGE_STEP2_MAX_RETRIES + 1} attempts. Step 1 unshield (tx ${step1Result.txId}) succeeded — your funds are now in your public balance and can be sent to the exchange via a manual public transfer. Last error: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`, 'aleo_exchange_step_2_public_transfer');
             }
             finally {
                 this.tokensPendingExchange.delete(token.programId);

package/src/wallet/AleoWallet/AleoWallet.cjs

@@ -66,7 +66,7 @@ class AleoWallet extends walletConnectorCore.Wallet {
             const messageString = typeof message === 'string' ? message : new TextDecoder().decode(message);
             const signature = yield this._connector.signMessage(messageString);
             if (!signature) {
-                throw new utils.DynamicError('Failed to sign message');
+                throw new utils.DynamicError('Failed to sign message', 'sign_message_failed');
             }
             return signature;
         });
@@ -131,7 +131,7 @@ class AleoWallet extends walletConnectorCore.Wallet {
     getWaasConnectorOrThrow(methodName) {
         const c = this._connector;
         if (typeof c.proveTransaction !== 'function') {
-            throw new utils.DynamicError(`AleoWallet.${methodName}() is only available on embedded Aleo wallets (Dynamic WaaS). For Wallet Adapter Aleo wallets use \`requestTransaction\` / \`requestRecords\` instead.`);
+            throw new utils.DynamicError(`AleoWallet.${methodName}() is only available on embedded Aleo wallets (Dynamic WaaS). For Wallet Adapter Aleo wallets use \`requestTransaction\` / \`requestRecords\` instead.`, 'aleowallet_is_only_available_on_embedded');
         }
         c.activeAccountAddress = this.address;
         return c;

package/src/wallet/AleoWallet/AleoWallet.js

@@ -62,7 +62,7 @@ class AleoWallet extends Wallet {
             const messageString = typeof message === 'string' ? message : new TextDecoder().decode(message);
             const signature = yield this._connector.signMessage(messageString);
             if (!signature) {
-                throw new DynamicError('Failed to sign message');
+                throw new DynamicError('Failed to sign message', 'sign_message_failed');
             }
             return signature;
         });
@@ -127,7 +127,7 @@ class AleoWallet extends Wallet {
     getWaasConnectorOrThrow(methodName) {
         const c = this._connector;
         if (typeof c.proveTransaction !== 'function') {
-            throw new DynamicError(`AleoWallet.${methodName}() is only available on embedded Aleo wallets (Dynamic WaaS). For Wallet Adapter Aleo wallets use \`requestTransaction\` / \`requestRecords\` instead.`);
+            throw new DynamicError(`AleoWallet.${methodName}() is only available on embedded Aleo wallets (Dynamic WaaS). For Wallet Adapter Aleo wallets use \`requestTransaction\` / \`requestRecords\` instead.`, 'aleowallet_is_only_available_on_embedded');
         }
         c.activeAccountAddress = this.address;
         return c;