feat(wallet): add element copied amplitude event (#10268)

# Description of change

Please write a summary of your changes and why you made them.

## Links to any relevant issues

fixes #10174
## How the change has been tested

Describe the tests that you ran to verify your changes.

Make sure to provide instructions for the maintainer as well as any
relevant configurations.

---------

Co-authored-by: Juliana <115430927+Juligs@users.noreply.github.com>
Co-authored-by: JCNoguera <88061365+VmMad@users.noreply.github.com>

Author: 3 people

apps/wallet/src/shared/analytics/ampli/index.ts

@@ -390,7 +390,7 @@ export interface DisconnectedApplicationProperties {
     sourceFlow?: string;
 }
 
-export interface ExternalLinkOpenedProperties {
+export interface ElementCopiedProperties {
     type: string;
     value?: string;
     /**
@@ -401,6 +401,16 @@ export interface ExternalLinkOpenedProperties {
     visibility?: 'private' | 'public';
 }
 
+export interface ExternalLinkOpenedProperties {
+    type: string;
+    value?: string;
+    /**
+     * | Rule | Value |
+     * |---|---|
+     * | Enum Values | private, public |
+     */
+    visibility?: 'private' | 'public';
+}
 export interface IotaStakedProperties {
     /**
      * | Rule | Value |
@@ -904,6 +914,14 @@ export class DisconnectedApplication implements BaseEvent {
     }
 }
 
+export class ElementCopied implements BaseEvent {
+    event_type = 'element copied';
+
+    constructor(public event_properties: ElementCopiedProperties) {
+        this.event_properties = event_properties;
+    }
+}
+
 export class ExternalLinkOpened implements BaseEvent {
     event_type = 'external link opened';
 
@@ -1729,6 +1747,24 @@ export class Ampli {
     return this.track(new DisconnectedApplication(properties), options);
   }
 
+  /**
+   * element copied
+   *
+   * [View in Tracking Plan](https://data.eu.amplitude.com/iota-foundation/IOTA%20Wallet/events/main/latest/element%20copied)
+   *
+   * Event has no description in tracking plan.
+   *
+   * @param properties The event's properties (e.g. type)
+   * @param options Amplitude event options.
+   */
+  elementCopied(
+    properties: ElementCopiedProperties,
+    options?: EventOptions,
+  ) {
+    return this.track(new ElementCopied(properties), options);
+  }
+
+  /*
   /**
    * external link opened
    *

apps/wallet/src/shared/analytics/amplitude.ts

@@ -7,7 +7,7 @@ import { LogLevel } from '@amplitude/analytics-types';
 import { attachEnvironmentPlugin, getCustomNetwork } from '@iota/core';
 import { getNetwork, type Network } from '@iota/iota-sdk/client';
 import { ampli } from './ampli';
-import { externalLinkOpenedPrivacyPlugin } from './plugins';
+import { elementCopiedPrivacyPlugin, externalLinkOpenedPrivacyPlugin } from './plugins';
 import { dialogContextPlugin } from './plugins/dialogContextPlugin';
 
 const IS_ENABLED = process.env.BUILD_ENV === 'production';
@@ -62,6 +62,7 @@ export async function initAmplitude() {
     // Add environment plugin to set prefix dev events
     ampli.client.add(attachEnvironmentPlugin(IS_DEV));
 
+    ampli.client.add(elementCopiedPrivacyPlugin());
     ampli.client.add(externalLinkOpenedPrivacyPlugin());
 }
 

apps/wallet/src/shared/analytics/plugins/elementCopiedPrivacyPlugin.ts

@@ -0,0 +1,45 @@
+// Copyright (c) 2026 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import type { EnrichmentPlugin, Event } from '@amplitude/analytics-types';
+
+// these are the types that are always private
+const PRIVATE_TYPES = new Set<string>(['address', 'digest', 'object', 'mnemonic']);
+
+export function elementCopiedPrivacyPlugin(): EnrichmentPlugin {
+    return {
+        name: 'element-copied-privacy',
+        type: 'enrichment',
+
+        async execute(event: Event) {
+            if (!event.event_type?.endsWith('element copied')) {
+                return event;
+            }
+
+            let props = { ...(event.event_properties ?? {}) } as Record<string, unknown>;
+
+            const type =
+                typeof props.type === 'string' && props.type.trim() ? props.type : 'unknown';
+
+            let visibility: 'private' | 'public' =
+                props.visibility === 'public' ? 'public' : 'private';
+
+            if (PRIVATE_TYPES.has(type)) {
+                visibility = 'private';
+            }
+
+            props.type = type;
+            props.visibility = visibility;
+
+            if (visibility === 'private') {
+                const { value, ...rest } = props;
+                props = rest;
+            }
+
+            return {
+                ...event,
+                event_properties: { ...props },
+            };
+        },
+    };
+}

…ics/plugins/externalLinkPrivacyPlugin.ts …ugins/externalLinkOpenedPrivacyPlugin.tsapps/wallet/src/shared/analytics/plugins/externalLinkPrivacyPlugin.ts renamed to apps/wallet/src/shared/analytics/plugins/externalLinkOpenedPrivacyPlugin.ts apps/wallet/src/shared/analytics/plugins/externalLinkPrivacyPlugin.ts renamed to apps/wallet/src/shared/analytics/plugins/externalLinkOpenedPrivacyPlugin.ts

@@ -3,9 +3,8 @@
 
 import type { EnrichmentPlugin, Event } from '@amplitude/analytics-types';
 
-export const PUBLIC_TYPES = new Set<string>(['documentation', 'application', 'support']);
 // these are the types that are always private
-export const PRIVATE_TYPES = new Set<string>(['address', 'digest', 'object']);
+const PRIVATE_TYPES = new Set<string>(['address', 'digest', 'object']);
 
 export function externalLinkOpenedPrivacyPlugin(): EnrichmentPlugin {
     return {

apps/wallet/src/shared/analytics/plugins/index.ts

@@ -1,4 +1,5 @@
 // Copyright (c) 2026 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-export * from './externalLinkPrivacyPlugin';
+export * from './elementCopiedPrivacyPlugin';
+export * from './externalLinkOpenedPrivacyPlugin';

apps/wallet/src/ui/app/components/HideShowDisplayBox.tsx

@@ -4,6 +4,7 @@
 
 import { Button, ButtonType, TextArea } from '@iota/apps-ui-kit';
 import { toast } from '@iota/core';
+import { ampli } from '_src/shared/analytics/ampli';
 
 export interface HideShowDisplayBoxProps {
     value: string | string[];
@@ -25,6 +26,10 @@ export function HideShowDisplayBox({
         const textToCopy = Array.isArray(value) ? value.join(' ') : value;
         try {
             await navigator.clipboard.writeText(textToCopy);
+            ampli.elementCopied({
+                type: 'mnemonic',
+                value: textToCopy,
+            });
             toast(copiedMessage || 'Copied');
         } catch {
             toast.error('Failed to copy');

apps/wallet/src/ui/app/components/accounts/AccountItem.tsx

@@ -35,6 +35,7 @@ export function AccountItem({
     const accountName = formatAccountName(account?.nickname, iotaName, account?.address);
     const copyAddress = useCopyToClipboard(account?.address || '', {
         copySuccessMessage: 'Address copied',
+        textType: 'address',
     });
     const explorerHref = useExplorerLink({
         type: ExplorerLinkType.Address,

apps/wallet/src/ui/app/components/receipt-card/index.tsx

@@ -15,6 +15,7 @@ import { type IotaTransactionBlockResponse } from '@iota/iota-sdk/client';
 
 import { ExplorerLinkHelper } from '../ExplorerLinkHelper';
 import { ExplorerLink } from '../explorer-link';
+import { ampli } from '_src/shared/analytics/ampli';
 
 interface ReceiptCardProps {
     txn: IotaTransactionBlockResponse;
@@ -54,9 +55,13 @@ export function ReceiptCard({ txn, activeAddress }: ReceiptCardProps) {
                 <div className="self-center">
                     <OutlinedCopyButton
                         textToCopy={digest ?? ''}
-                        onCopySuccess={() =>
-                            toast.success('Transaction digest copied to clipboard')
-                        }
+                        onCopySuccess={() => {
+                            ampli.elementCopied({
+                                type: 'digest',
+                                value: digest,
+                            });
+                            toast.success('Transaction digest copied to clipboard');
+                        }}
                     />
                 </div>
             </div>

apps/wallet/src/ui/app/hooks/useCopyToClipboard.ts

@@ -4,14 +4,18 @@
 
 import { useCallback, type MouseEventHandler } from 'react';
 import { toast } from '@iota/core';
+import { ampli } from '_src/shared/analytics/ampli';
 
 export type CopyOptions = {
     copySuccessMessage?: string;
+    textType: string;
+    trackEvent?: boolean;
+    isPublic?: boolean;
 };
 
 export function useCopyToClipboard(
     textToCopy: string,
-    { copySuccessMessage = 'Copied' }: CopyOptions = {},
+    { copySuccessMessage = 'Copied', textType, isPublic = false, trackEvent = true }: CopyOptions,
 ) {
     return useCallback<MouseEventHandler>(
         async (e) => {
@@ -20,10 +24,17 @@ export function useCopyToClipboard(
             try {
                 await navigator.clipboard.writeText(textToCopy);
                 toast(copySuccessMessage);
+                if (trackEvent) {
+                    ampli.elementCopied({
+                        type: textType,
+                        value: isPublic ? textToCopy : undefined,
+                        visibility: isPublic ? 'public' : 'private',
+                    });
+                }
             } catch (e) {
                 // silence clipboard errors
             }
         },
-        [textToCopy, copySuccessMessage],
+        [textToCopy, copySuccessMessage, textType, isPublic, trackEvent],
     );
 }

apps/wallet/src/ui/app/pages/accounts/manage/AccountGroupItem.tsx

@@ -16,7 +16,7 @@ import { RemoveDialog } from './RemoveDialog';
 import { Portal } from '_app/shared/Portal';
 import { formatAccountName } from '_src/ui/app/helpers';
 import { isLegacyAccount } from '_src/background/accounts/isLegacyAccount';
-import { ACCOUNT_TYPE_TO_AMPLI_ACCOUNT_TYPE, ampli } from '_src/shared/analytics';
+import { ampli, ACCOUNT_TYPE_TO_AMPLI_ACCOUNT_TYPE } from '_src/shared/analytics';
 
 interface AccountGroupItemProps {
     account: SerializedUIAccount;
@@ -50,6 +50,10 @@ export function AccountGroupItem({
     });
 
     async function handleCopySuccess() {
+        ampli.elementCopied({
+            type: 'address',
+            value: account.address,
+        });
         toast('Address copied');
     }