Pulse

Pulse – Following Highlighter (Chrome Extension)

Liste, badge e notifiche su siti supportati, con AI-Trading opzionale. Questo README è una vetrina funzionale dell’estensione: spiega cosa fa e come si usa, senza esporre implementazione o dettagli server.

---

🚀 Cos'è

Pulse è un’estensione per Chrome (manifest v3) che aggiunge:

• Pulse Lists: Following / Blacklist con badge inline e azioni rapide.
• Floating Checkboxes: overlay leggero per segnare utenti direttamente dalla pagina.
• Centro Notifiche: pannello nel popup per attivare/disattivare le notifiche.
• AI-Trading (Pro): lista “mints/contratti” da monitorare con finestra temporale e soglia di segnale.
• Integrazioni opzionali (Pro): invio notifiche verso Telegram e Discord.

Le informazioni sensibili e qualsiasi endpoint/chiave non sono esposti in questo README.

---

🖼️ Anteprima rapida

Login	Lists: Following / Blacklist
Floating Checkboxes	Centro Notifiche
AI-Trading (Pro)	Impostazioni, tema, Telegram/Discord (Pro)
Pro Panel	Inline Badges & Fresh

---

✨ Funzionalità

0) Pro Panel (UI avanzata)

Dov'è
Un pulsante “⚙️ Pro Panel” compare nell'header delle pagine Pulse supportate. Cliccandolo si apre un pannello modale con tab.

Tab & opzioni

• General
  • Visibility & Display: Compact vs Expanded pill layout (impaginazione dei pill/badge).
  • Fresh Data Controls:
    • Enable Fresh stats (attiva/disattiva metrica “Fresh”).
    • Fresh window (selettore a chip della finestra di analisi).
    • Fresh buys threshold (soglia di conteggio acquisti nella finestra).
    • Toggle buys count ↔ volume (SOL) (commuta tra conteggio e volume).
• Pills
  • Show/Hide pill types: followers, following, members, age, freshStats.
• Lists
  • Per-list visibility: mostra/nascondi badge/azioni su pagine Following e Blacklist.

Come si usa

1. Apri Pulse → clic su ⚙️ Pro Panel.
2. Regola le opzioni nella tab desiderata.
3. Premi Done per salvare. Le preferenze sono salvate in locale e applicate subito.

Screenshot

---

1) Login

Cosa fa
Abilita l’estensione sui siti supportati dopo autenticazione locale.

Come si usa

1. Apri il popup dell’estensione.
2. Inserisci username e password, quindi premi Accedi.
3. In caso di errore, riprova o verifica le credenziali.

Screenshot

---

2) Pulse Lists — Following / Blacklist

Cosa fa
Gestisce due liste (una per riga, formato consigliato: @utente - nota) e mostra badge inline e azioni rapide nelle pagine supportate.

Punti chiave

• Campi dedicati: Following e Blacklist con contatori (countFollowing, countBlacklist).
• Ricerca e Ordinamento per entrambe le liste (searchFollowing, searchBlacklist, sortFollowing, sortBlacklist).
• Import da file .txt / .json / .csv (Importa file).
• Pulsanti Salva e Cancella per persistere/ripulire le liste.

Come si usa

1. Compila le liste nel popup (uno per riga).
2. Salva. I badge/azioni diventano disponibili nelle pagine supportate.
3. Usa ricerca/ordine per filtrare velocemente le voci.

Screenshot

Note

• Le liste sono locali al browser (archiviazione dell’estensione).
• Non includere dati sensibili negli screenshot.

---

3) Floating Checkboxes (Edge+)

Cosa fa
Mostra un overlay di checkbox per segnare rapidamente utenti come following o blacklist direttamente dalla pagina (es. hover-card/social).

Punti chiave

• Toggle dedicato: Enable floating checkboxes overlay (floatingCheckboxToggle).
• Opzione Evita duplicati (una sola notifica per creator) (avoidDuplicatesToggle).

Come si usa

1. Abilita l’overlay nel popup.
2. Passa il mouse sulle card/elenchi utenti: compaiono le checkbox e i badge inline.

Screenshot

---

4) Centro Notifiche

Cosa fa
Toggle on/off per notifiche con vista aggiornata dinamicamente.

Come si usa

1. Apri il popup → Centro Notifiche.
2. Consulta la lista e apri i dettagli quando disponibili.

Screenshot

Note

• Le notifiche rispettano le preferenze (es. Evita duplicati).

---

5) AI-Trading (Pro)

Cosa fa
Consente di monitorare una lista di mints/contratti e visualizzare un segnale in base a finestra temporale e soglia BUY.

Punti chiave

• Toggle Enable AI-Trading e barra preferenze.
• Finestra: 45s / 60s / 120s (aiWindow).
• Soglia BUY con slider (es. 0.70) (aiBuyThresh, aiBuyThreshVal).
• Lista dinamica degli elementi monitorati (ai-list), stato e tempo da primo avvistamento.
• Azioni: Clear all, Add mint (debug), rimozione per singolo elemento.

Come si usa

1. Abilita AI-Trading.
2. Imposta Finestra e Soglia BUY.
3. Aggiungi eventuali mints/contratti da monitorare.

Screenshot

Note

• L’algoritmo gira lato estensione: il README non espone alcuna logica o endpoint.

---

6) Impostazioni & integrazioni

Cosa fa
Pannello Tema e integrazioni Telegram/Discord (piano Pro) accessibili dal popup o dalla pagina Impostazioni.

Punti chiave

• Tema: Dark / Twilight / Light (persistito).
• Telegram (Pro): toggle, Bot Token e Chat ID.
• Discord (Pro): toggle, Webhook URL.
• Pulsanti Salva impostazioni / Annulla.

Come si usa

1. Apri Impostazioni dal popup.
2. Seleziona tema.
3. (Pro) Abilita integrazioni e inserisci credenziali.

Screenshot

Note

• Non condividere token, chat-ID o webhook negli screenshot.
• Le integrazioni sono opzionali e possono essere disattivate in qualsiasi momento.

---

8) Inline Badges & Fresh Engine (content_pulse_auto.js)

Cosa fa
Inserisce pill/badge inline accanto al nome creator e nella barra destra delle righe in Pulse, senza alterare l’altezza della riga né rompere il virtual scroller. Mostra stato (following/blacklist), 👥 followers, ➡️ following, 👪 members, 🕒 age e le 🍃 Fresh stats (buys e holding %). Sulla pagina /meme aggiunge un mini-pannello in header con le stesse metriche.

Dove appare

• Lista / feed Pulse
• Pagina /meme (widget in header)

Punti chiave

• Gating: i badge compaiono solo per creator presenti in Following/Blacklist, secondo le preferenze del Pro Panel (visibilità per lista e tipi di pill).
• Fresh Engine: estrae il mint dalla riga/pagina, si sottoscrive agli aggiornamenti (WS/AI) via FreshDataManager e aggiorna in tempo reale 🍃 buys e 🍃 holding %.
• Hydration community: tramite bridge in-page recupera handle e metriche (followers/following/members/age) e le cache in locale.
• UX/Perf: MutationObserver solo su childList, nessun aumento altezza riga, Virtualizer Shim passivo, CSS minimale per pill + shimmer opzionale.
• Notifiche: invia un notify al background quando trova un match (debounce 15s) per Following/Blacklist/Watchlist.
• Safety: cleanup su scadenza token, unsubscribe per riga/mint, storage locale.

Come si usa (utente)

1. Effettua login (token valido).
2. Popola Following/Blacklist.
3. Nel Pro Panel, abilita: visibilità su Following/Blacklist e i Pill types che vuoi vedere (es. freshStats, followers, following, members, age).
4. (Opz.) Attiva Shimmer e regola Fresh window/threshold.
5. Naviga nella lista Pulse o nella pagina /meme: i badge compaiono e le metriche si aggiornano live.

Screenshot

---

🧭 Flusso d’uso (utente)

1. Accedi dal popup.
2. Configura Following/Blacklist e (opzionale) abilita Floating Checkboxes.
3. Consulta il Centro Notifiche.
4. (Pro) Configura AI-Trading e/o integrazioni Telegram/Discord.

---

---

🔒 Privacy & Sicurezza (alto livello)

• Questo README non espone codice, endpoint, chiavi o logiche server.
• Le liste sono salvate localmente nell’estensione.
• Oscura/anonimizza sempre dati reali negli screenshot.

---

❓ FAQ

Il codice sorgente è disponibile?
No. Questo repository funge da vetrina del prodotto con materiale visivo e guida d’uso.

Serve un piano a pagamento?
Alcune funzioni (es. AI-Trading, integrazioni) richiedono un piano Edge/Pro.

---

📞 Contatti

• Email / Sito / LinkedIn / GitHub: …

---

📄 Licenza

Scegli una licenza adatta (anche “All Rights Reserved” se non vuoi redistribuzione).