@dynamic-labs/sdk-react-core 4.80.0 → 4.82.0

package/src/lib/utils/functions/compareChains/compareChains.cjs

@@ -12,6 +12,7 @@ const synonyms = {
     cosmos: 'COSMOS',
     eip155: 'EVM',
     flow: 'FLOW',
+    midnight: 'MIDNIGHT',
     solana: 'SOL',
     starknet: 'STARK',
     stellar: 'STELLAR',

package/src/lib/utils/functions/compareChains/compareChains.js

@@ -8,6 +8,7 @@ const synonyms = {
     cosmos: 'COSMOS',
     eip155: 'EVM',
     flow: 'FLOW',
+    midnight: 'MIDNIGHT',
     solana: 'SOL',
     starknet: 'STARK',
     stellar: 'STELLAR',

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.cjs

@@ -20,6 +20,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return `${url.origin}/#/transaction/${hash}`;
         },
     },
+    {
+        // Provable hosts both mainnet (`explorer.provable.com`) and testnet
+        //  (`testnet.explorer.provable.com`). Matching the bare
+        //  `explorer.provable.com` substring covers both subdomains.
+        description: 'Aleo (Provable) - Uses /transaction/{hash}',
+        domain: 'explorer.provable.com',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            url.pathname = `/transaction/${hash}`;
+            return url.toString();
+        },
+    },
 ];
 /**
  * Default pattern for standard block explorers

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.js

@@ -16,6 +16,18 @@ const BLOCK_EXPLORER_PATTERNS = [
             return `${url.origin}/#/transaction/${hash}`;
         },
     },
+    {
+        // Provable hosts both mainnet (`explorer.provable.com`) and testnet
+        //  (`testnet.explorer.provable.com`). Matching the bare
+        //  `explorer.provable.com` substring covers both subdomains.
+        description: 'Aleo (Provable) - Uses /transaction/{hash}',
+        domain: 'explorer.provable.com',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            url.pathname = `/transaction/${hash}`;
+            return url.toString();
+        },
+    },
 ];
 /**
  * Default pattern for standard block explorers

package/src/lib/utils/hooks/useAleoAutoMergeRecords/index.d.ts

@@ -0,0 +1 @@
+export { useAleoAutoMergeRecords } from './useAleoAutoMergeRecords';

package/src/lib/utils/hooks/useAleoAutoMergeRecords/useAleoAutoMergeRecords.cjs

@@ -0,0 +1,246 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var React = require('react');
+var sdkApiCore = require('@dynamic-labs/sdk-api-core');
+require('../../../context/DynamicContext/DynamicContext.cjs');
+require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
+require('@dynamic-labs/iconic');
+require('@dynamic-labs/wallet-connector-core');
+require('react/jsx-runtime');
+require('../../../context/ViewContext/ViewContext.cjs');
+require('../../../shared/logger.cjs');
+require('@dynamic-labs/wallet-book');
+require('@dynamic-labs/utils');
+require('../../constants/colors.cjs');
+require('../../constants/values.cjs');
+require('../../../shared/consts/index.cjs');
+require('../../../events/dynamicEvents.cjs');
+require('../../../context/CaptchaContext/CaptchaContext.cjs');
+require('../../../context/ErrorContext/ErrorContext.cjs');
+require('@dynamic-labs/multi-wallet');
+require('react-international-phone');
+require('../../../store/state/nonce/nonce.cjs');
+require('@dynamic-labs-sdk/client/core');
+require('eventemitter3');
+require('@dynamic-labs-sdk/client');
+require('../../../config/ApiEndpoint.cjs');
+require('@dynamic-labs/locale');
+require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
+require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
+require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
+require('../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.cjs');
+require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
+require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
+require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
+require('../../../store/state/authMode/authMode.cjs');
+require('../../../context/VerificationContext/VerificationContext.cjs');
+require('react-dom');
+require('../../functions/compareChains/compareChains.cjs');
+require('../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.cjs');
+require('../../../context/ThemeContext/ThemeContext.cjs');
+require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
+require('bs58');
+require('@dynamic-labs/types');
+require('../../../context/SocialRedirectContext/SocialRedirectContext.cjs');
+require('../../../context/LoadingContext/LoadingContext.cjs');
+require('../../../context/WalletContext/WalletContext.cjs');
+require('../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
+require('yup');
+require('../../../context/MockContext/MockContext.cjs');
+require('../../../views/CollectUserDataView/useFields.cjs');
+require('../../../context/FieldsStateContext/FieldsStateContext.cjs');
+require('../../../context/UserFieldEditorContext/UserFieldEditorContext.cjs');
+require('@dynamic-labs/rpc-providers');
+require('../../../store/state/walletOptions/walletOptions.cjs');
+require('react-i18next');
+require('../../../components/Accordion/components/AccordionItem/AccordionItem.cjs');
+require('../../../components/Alert/Alert.cjs');
+require('../../../components/ShadowDOM/ShadowDOM.cjs');
+require('../../../components/IconButton/IconButton.cjs');
+require('../../../components/InlineWidget/InlineWidget.cjs');
+require('../../../components/Input/Input.cjs');
+require('../../../components/IsBrowser/IsBrowser.cjs');
+require('../../../components/MenuList/Dropdown/Dropdown.cjs');
+require('../../../components/OverlayCard/OverlayCard.cjs');
+require('../../../components/Transition/ZoomTransition/ZoomTransition.cjs');
+require('../../../components/Transition/SlideInUpTransition/SlideInUpTransition.cjs');
+require('../../../components/Transition/OpacityTransition/OpacityTransition.cjs');
+require('../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
+require('../../../components/Popper/Popper/Popper.cjs');
+require('../../../components/Popper/PopperContext/PopperContext.cjs');
+require('react-focus-lock');
+require('qrcode');
+require('formik');
+require('../useSubdomainCheck/useSubdomainCheck.cjs');
+require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
+require('../../../widgets/DynamicWidget/context/DynamicWidgetContext.cjs');
+require('../useGetMfaToken/useGetMfaToken.cjs');
+require('../useWalletBackup/useWalletBackup.cjs');
+require('../useWalletBackup/types.cjs');
+require('../useWalletBackup/cloudProviders.cjs');
+require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
+require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
+require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
+require('@hcaptcha/react-hcaptcha');
+require('../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.cjs');
+require('../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.cjs');
+require('../../../context/ErrorContext/hooks/useErrorText/useErrorText.cjs');
+require('../../../context/FooterAnimationContext/index.cjs');
+require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
+require('../../../context/PasskeyContext/PasskeyContext.cjs');
+require('../../../context/OnrampContext/OnrampContext.cjs');
+require('../../../store/state/sendBalances.cjs');
+require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
+require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
+require('../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
+require('../../../views/TransactionConfirmationView/TransactionConfirmationView.cjs');
+require('../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.cjs');
+require('../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.cjs');
+require('../../../../index.cjs');
+require('../../../widgets/DynamicWidget/views/ManagePasskeysMfaWidgetView/ManagePasskeysMfaWidgetView.cjs');
+require('../../../widgets/DynamicWidget/views/ManageTotpMfaWidgetView/ManageTotpMfaWidgetView.cjs');
+require('../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.cjs');
+require('../../../store/state/tokenBalances.cjs');
+require('../../../store/state/multichainBalances.cjs');
+require('@dynamic-labs/store');
+require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+var useInternalDynamicContext = require('../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.cjs');
+
+/**
+ * Programs whose `join` transition the Aleo Feemaster has historically
+ * sponsored — `credits.aleo` and the two stablecoins. ARC-21 lives on
+ * `token_registry.aleo` which is per-`token_id` and out of scope for v1.
+ *
+ * The list is intentionally explicit (not pulled from the connector's
+ * private allowlist) so adding a program here is a deliberate decision
+ * coupled to Feemaster coverage rather than an automatic side-effect of a
+ * shape-registry change.
+ */
+const AUTO_MERGE_PROGRAMS = [
+    'credits.aleo',
+    'usad_stablecoin.aleo',
+    'usdcx_stablecoin.aleo',
+    'test_usad_stablecoin.aleo',
+    'test_usdcx_stablecoin.aleo',
+];
+/**
+ * On Aleo wallet load, scan the user's owned records and silently fire a
+ * merge ceremony for every program with ≥2 records that the Feemaster
+ * currently sponsors. Programs the Feemaster doesn't cover are skipped —
+ * the user can still trigger a manual merge via the explicit "Merge all
+ * records" CTA, which dispatches with user-paid fees.
+ *
+ * Idempotency is per-session, keyed by `(accountAddress, programId)`. A
+ * page reload re-runs auto-merge once; mid-session balance refreshes do
+ * not re-trigger merges for the same program. On error the program key
+ * is removed from the seen-set so the next refresh can retry.
+ *
+ * Failures are swallowed by design — auto-merge is a background
+ * optimisation, not a user-facing flow. Errors surface only via the
+ * connector's own logger.
+ */
+const useAleoAutoMergeRecords = () => {
+    const { primaryWallet } = useInternalDynamicContext.useInternalDynamicContext();
+    // Tracks `(accountAddress:programId)` pairs we've already attempted in
+    //  this React session. Cleared implicitly on a full page reload (the ref
+    //  lives in module-private React state). We do NOT persist to
+    //  localStorage on purpose — the Feemaster check on every attempt is
+    //  cheap server-side and survives mid-session policy changes.
+    const seenKeysRef = React.useRef(new Set());
+    React.useEffect(() => {
+        var _a;
+        const connector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
+        if (!connector)
+            return;
+        const isAleo = ((_a = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector) === null || _a === void 0 ? void 0 : _a.connectedChain) === sdkApiCore.ChainEnum.Aleo;
+        if (!isAleo)
+            return;
+        if (typeof connector.listOwnedRecords !== 'function' ||
+            typeof connector.isFeemasterSponsored !== 'function' ||
+            typeof connector.joinRecords !== 'function') {
+            return;
+        }
+        let cancelled = false;
+        const accountAddress = primaryWallet
+            .address;
+        if (!accountAddress)
+            return;
+        const run = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _b, _c, _d, _e, _f, _g;
+            const result = yield ((_b = connector.listOwnedRecords) === null || _b === void 0 ? void 0 : _b.call(connector));
+            if (cancelled)
+                return;
+            const records = ((_c = result === null || result === void 0 ? void 0 : result.records) !== null && _c !== void 0 ? _c : []).filter((r) => Boolean(r === null || r === void 0 ? void 0 : r.program_name) && typeof (r === null || r === void 0 ? void 0 : r.record_plaintext) === 'string');
+            // Group record counts per program.
+            const countsByProgram = new Map();
+            for (const record of records) {
+                const programId = record.program_name;
+                countsByProgram.set(programId, ((_d = countsByProgram.get(programId)) !== null && _d !== void 0 ? _d : 0) + 1);
+            }
+            const candidates = AUTO_MERGE_PROGRAMS.filter((programId) => {
+                var _a;
+                const count = (_a = countsByProgram.get(programId)) !== null && _a !== void 0 ? _a : 0;
+                if (count < 2)
+                    return false;
+                const key = `${accountAddress}:${programId}`;
+                return !seenKeysRef.current.has(key);
+            });
+            for (const programId of candidates) {
+                if (cancelled)
+                    return;
+                const key = `${accountAddress}:${programId}`;
+                seenKeysRef.current.add(key);
+                let sponsored = false;
+                try {
+                    sponsored =
+                        (_f = (yield ((_e = connector.isFeemasterSponsored) === null || _e === void 0 ? void 0 : _e.call(connector, {
+                            functionName: 'join',
+                            programId,
+                        })))) !== null && _f !== void 0 ? _f : false;
+                }
+                catch (_h) {
+                    sponsored = false;
+                }
+                if (cancelled)
+                    return;
+                if (!sponsored) {
+                    // Allow a future attempt if Feemaster coverage flips on later in
+                    //  the session (e.g. after a policy refresh).
+                    seenKeysRef.current.delete(key);
+                    continue;
+                }
+                try {
+                    yield ((_g = connector.joinRecords) === null || _g === void 0 ? void 0 : _g.call(connector, { programIds: [programId] }));
+                }
+                catch (_j) {
+                    // Background optimisation — swallow and let the next session
+                    //  retry. Removing the key allows a retry on the next records
+                    //  refresh.
+                    seenKeysRef.current.delete(key);
+                }
+            }
+        });
+        run().catch(() => {
+            /* swallow — see method jsdoc */
+        });
+        return () => {
+            cancelled = true;
+        };
+        // Depend on the stable address + connector reference rather than the
+        //  whole `primaryWallet` object. The wallet object can be re-created
+        //  on every context update (balance refreshes, metadata churn, etc.),
+        //  which would re-fire this effect even when no merge-relevant state
+        //  has changed and re-spam `listOwnedRecords` / `isFeemasterSponsored`.
+        //  Address + connector are the only fields the effect actually reads.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.address,
+        primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector,
+    ]);
+};
+
+exports.useAleoAutoMergeRecords = useAleoAutoMergeRecords;

package/src/lib/utils/hooks/useAleoAutoMergeRecords/useAleoAutoMergeRecords.d.ts

@@ -0,0 +1,17 @@
+/**
+ * On Aleo wallet load, scan the user's owned records and silently fire a
+ * merge ceremony for every program with ≥2 records that the Feemaster
+ * currently sponsors. Programs the Feemaster doesn't cover are skipped —
+ * the user can still trigger a manual merge via the explicit "Merge all
+ * records" CTA, which dispatches with user-paid fees.
+ *
+ * Idempotency is per-session, keyed by `(accountAddress, programId)`. A
+ * page reload re-runs auto-merge once; mid-session balance refreshes do
+ * not re-trigger merges for the same program. On error the program key
+ * is removed from the seen-set so the next refresh can retry.
+ *
+ * Failures are swallowed by design — auto-merge is a background
+ * optimisation, not a user-facing flow. Errors surface only via the
+ * connector's own logger.
+ */
+export declare const useAleoAutoMergeRecords: () => void;

package/src/lib/utils/hooks/useAleoAutoMergeRecords/useAleoAutoMergeRecords.js

@@ -0,0 +1,242 @@
+'use client'
+import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { useRef, useEffect } from 'react';
+import { ChainEnum } from '@dynamic-labs/sdk-api-core';
+import '../../../context/DynamicContext/DynamicContext.js';
+import '../../../store/state/loadingAndLifecycle/loadingAndLifecycle.js';
+import '@dynamic-labs/iconic';
+import '@dynamic-labs/wallet-connector-core';
+import 'react/jsx-runtime';
+import '../../../context/ViewContext/ViewContext.js';
+import '../../../shared/logger.js';
+import '@dynamic-labs/wallet-book';
+import '@dynamic-labs/utils';
+import '../../constants/colors.js';
+import '../../constants/values.js';
+import '../../../shared/consts/index.js';
+import '../../../events/dynamicEvents.js';
+import '../../../context/CaptchaContext/CaptchaContext.js';
+import '../../../context/ErrorContext/ErrorContext.js';
+import '@dynamic-labs/multi-wallet';
+import 'react-international-phone';
+import '../../../store/state/nonce/nonce.js';
+import '@dynamic-labs-sdk/client/core';
+import 'eventemitter3';
+import '@dynamic-labs-sdk/client';
+import '../../../config/ApiEndpoint.js';
+import '@dynamic-labs/locale';
+import '../../../store/state/dynamicContextProps/dynamicContextProps.js';
+import '../../../store/state/primaryWalletId/primaryWalletId.js';
+import '../../../store/state/connectedWalletsInfo/connectedWalletsInfo.js';
+import '../../functions/getWaasAddressTypeLabel/getWaasAddressTypeLabel.js';
+import '../../../context/AccessDeniedContext/AccessDeniedContext.js';
+import '../../../context/AccountExistsContext/AccountExistsContext.js';
+import '../../../context/UserWalletsContext/UserWalletsContext.js';
+import '../../../store/state/authMode/authMode.js';
+import '../../../context/VerificationContext/VerificationContext.js';
+import 'react-dom';
+import '../../functions/compareChains/compareChains.js';
+import '../../../views/Passkey/utils/findPrimaryEmbeddedChain/findPrimaryEmbeddedChain.js';
+import '../../../context/ThemeContext/ThemeContext.js';
+import '../useUserUpdateRequest/useUpdateUser/userFieldsSchema.js';
+import 'bs58';
+import '@dynamic-labs/types';
+import '../../../context/SocialRedirectContext/SocialRedirectContext.js';
+import '../../../context/LoadingContext/LoadingContext.js';
+import '../../../context/WalletContext/WalletContext.js';
+import '../useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
+import 'yup';
+import '../../../context/MockContext/MockContext.js';
+import '../../../views/CollectUserDataView/useFields.js';
+import '../../../context/FieldsStateContext/FieldsStateContext.js';
+import '../../../context/UserFieldEditorContext/UserFieldEditorContext.js';
+import '@dynamic-labs/rpc-providers';
+import '../../../store/state/walletOptions/walletOptions.js';
+import 'react-i18next';
+import '../../../components/Accordion/components/AccordionItem/AccordionItem.js';
+import '../../../components/Alert/Alert.js';
+import '../../../components/ShadowDOM/ShadowDOM.js';
+import '../../../components/IconButton/IconButton.js';
+import '../../../components/InlineWidget/InlineWidget.js';
+import '../../../components/Input/Input.js';
+import '../../../components/IsBrowser/IsBrowser.js';
+import '../../../components/MenuList/Dropdown/Dropdown.js';
+import '../../../components/OverlayCard/OverlayCard.js';
+import '../../../components/Transition/ZoomTransition/ZoomTransition.js';
+import '../../../components/Transition/SlideInUpTransition/SlideInUpTransition.js';
+import '../../../components/Transition/OpacityTransition/OpacityTransition.js';
+import '../../../components/PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.js';
+import '../../../components/Popper/Popper/Popper.js';
+import '../../../components/Popper/PopperContext/PopperContext.js';
+import 'react-focus-lock';
+import 'qrcode';
+import 'formik';
+import '../useSubdomainCheck/useSubdomainCheck.js';
+import '../../../context/WalletGroupContext/WalletGroupContext.js';
+import '../../../widgets/DynamicWidget/context/DynamicWidgetContext.js';
+import '../useGetMfaToken/useGetMfaToken.js';
+import '../useWalletBackup/useWalletBackup.js';
+import '../useWalletBackup/types.js';
+import '../useWalletBackup/cloudProviders.js';
+import '../../../context/IpConfigurationContext/IpConfigurationContext.js';
+import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
+import '../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.js';
+import '@hcaptcha/react-hcaptcha';
+import '../../../widgets/DynamicWidget/helpers/convertExchangeKeyAndProviderEnum.js';
+import '../../../views/ExchangeWhitelistWarning/ExchangeWhitelistWarning.js';
+import '../../../context/ErrorContext/hooks/useErrorText/useErrorText.js';
+import '../../../context/FooterAnimationContext/index.js';
+import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
+import '../../../context/PasskeyContext/PasskeyContext.js';
+import '../../../context/OnrampContext/OnrampContext.js';
+import '../../../store/state/sendBalances.js';
+import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
+import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
+import '../../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
+import '../../../views/TransactionConfirmationView/TransactionConfirmationView.js';
+import '../../../widgets/DynamicWidget/components/PasskeyCard/PasskeyCard.js';
+import '../../../widgets/DynamicWidget/views/CryptoComOnramp/CryptoComOnramp.js';
+import '../../../../index.js';
+import '../../../widgets/DynamicWidget/views/ManagePasskeysMfaWidgetView/ManagePasskeysMfaWidgetView.js';
+import '../../../widgets/DynamicWidget/views/ManageTotpMfaWidgetView/ManageTotpMfaWidgetView.js';
+import '../../../widgets/DynamicWidget/views/ReceiveWalletFunds/ReceiveWalletFunds.js';
+import '../../../store/state/tokenBalances.js';
+import '../../../store/state/multichainBalances.js';
+import '@dynamic-labs/store';
+import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
+
+/**
+ * Programs whose `join` transition the Aleo Feemaster has historically
+ * sponsored — `credits.aleo` and the two stablecoins. ARC-21 lives on
+ * `token_registry.aleo` which is per-`token_id` and out of scope for v1.
+ *
+ * The list is intentionally explicit (not pulled from the connector's
+ * private allowlist) so adding a program here is a deliberate decision
+ * coupled to Feemaster coverage rather than an automatic side-effect of a
+ * shape-registry change.
+ */
+const AUTO_MERGE_PROGRAMS = [
+    'credits.aleo',
+    'usad_stablecoin.aleo',
+    'usdcx_stablecoin.aleo',
+    'test_usad_stablecoin.aleo',
+    'test_usdcx_stablecoin.aleo',
+];
+/**
+ * On Aleo wallet load, scan the user's owned records and silently fire a
+ * merge ceremony for every program with ≥2 records that the Feemaster
+ * currently sponsors. Programs the Feemaster doesn't cover are skipped —
+ * the user can still trigger a manual merge via the explicit "Merge all
+ * records" CTA, which dispatches with user-paid fees.
+ *
+ * Idempotency is per-session, keyed by `(accountAddress, programId)`. A
+ * page reload re-runs auto-merge once; mid-session balance refreshes do
+ * not re-trigger merges for the same program. On error the program key
+ * is removed from the seen-set so the next refresh can retry.
+ *
+ * Failures are swallowed by design — auto-merge is a background
+ * optimisation, not a user-facing flow. Errors surface only via the
+ * connector's own logger.
+ */
+const useAleoAutoMergeRecords = () => {
+    const { primaryWallet } = useInternalDynamicContext();
+    // Tracks `(accountAddress:programId)` pairs we've already attempted in
+    //  this React session. Cleared implicitly on a full page reload (the ref
+    //  lives in module-private React state). We do NOT persist to
+    //  localStorage on purpose — the Feemaster check on every attempt is
+    //  cheap server-side and survives mid-session policy changes.
+    const seenKeysRef = useRef(new Set());
+    useEffect(() => {
+        var _a;
+        const connector = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector;
+        if (!connector)
+            return;
+        const isAleo = ((_a = primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector) === null || _a === void 0 ? void 0 : _a.connectedChain) === ChainEnum.Aleo;
+        if (!isAleo)
+            return;
+        if (typeof connector.listOwnedRecords !== 'function' ||
+            typeof connector.isFeemasterSponsored !== 'function' ||
+            typeof connector.joinRecords !== 'function') {
+            return;
+        }
+        let cancelled = false;
+        const accountAddress = primaryWallet
+            .address;
+        if (!accountAddress)
+            return;
+        const run = () => __awaiter(void 0, void 0, void 0, function* () {
+            var _b, _c, _d, _e, _f, _g;
+            const result = yield ((_b = connector.listOwnedRecords) === null || _b === void 0 ? void 0 : _b.call(connector));
+            if (cancelled)
+                return;
+            const records = ((_c = result === null || result === void 0 ? void 0 : result.records) !== null && _c !== void 0 ? _c : []).filter((r) => Boolean(r === null || r === void 0 ? void 0 : r.program_name) && typeof (r === null || r === void 0 ? void 0 : r.record_plaintext) === 'string');
+            // Group record counts per program.
+            const countsByProgram = new Map();
+            for (const record of records) {
+                const programId = record.program_name;
+                countsByProgram.set(programId, ((_d = countsByProgram.get(programId)) !== null && _d !== void 0 ? _d : 0) + 1);
+            }
+            const candidates = AUTO_MERGE_PROGRAMS.filter((programId) => {
+                var _a;
+                const count = (_a = countsByProgram.get(programId)) !== null && _a !== void 0 ? _a : 0;
+                if (count < 2)
+                    return false;
+                const key = `${accountAddress}:${programId}`;
+                return !seenKeysRef.current.has(key);
+            });
+            for (const programId of candidates) {
+                if (cancelled)
+                    return;
+                const key = `${accountAddress}:${programId}`;
+                seenKeysRef.current.add(key);
+                let sponsored = false;
+                try {
+                    sponsored =
+                        (_f = (yield ((_e = connector.isFeemasterSponsored) === null || _e === void 0 ? void 0 : _e.call(connector, {
+                            functionName: 'join',
+                            programId,
+                        })))) !== null && _f !== void 0 ? _f : false;
+                }
+                catch (_h) {
+                    sponsored = false;
+                }
+                if (cancelled)
+                    return;
+                if (!sponsored) {
+                    // Allow a future attempt if Feemaster coverage flips on later in
+                    //  the session (e.g. after a policy refresh).
+                    seenKeysRef.current.delete(key);
+                    continue;
+                }
+                try {
+                    yield ((_g = connector.joinRecords) === null || _g === void 0 ? void 0 : _g.call(connector, { programIds: [programId] }));
+                }
+                catch (_j) {
+                    // Background optimisation — swallow and let the next session
+                    //  retry. Removing the key allows a retry on the next records
+                    //  refresh.
+                    seenKeysRef.current.delete(key);
+                }
+            }
+        });
+        run().catch(() => {
+            /* swallow — see method jsdoc */
+        });
+        return () => {
+            cancelled = true;
+        };
+        // Depend on the stable address + connector reference rather than the
+        //  whole `primaryWallet` object. The wallet object can be re-created
+        //  on every context update (balance refreshes, metadata churn, etc.),
+        //  which would re-fire this effect even when no merge-relevant state
+        //  has changed and re-spam `listOwnedRecords` / `isFeemasterSponsored`.
+        //  Address + connector are the only fields the effect actually reads.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.address,
+        primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector,
+    ]);
+};
+
+export { useAleoAutoMergeRecords };

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/index.d.ts

@@ -0,0 +1 @@
+export { useAleoAutoShieldSponsoredTokens } from './useAleoAutoShieldSponsoredTokens';