The Cointacted Social Terminal includes an optional wallet indicator that shows basic, non-intrusive blockchain-related information — but only if a browser wallet (like MetaMask) is already exposing it.

This feature is 100% passive and safe, and fully WordPress.org–compliant.

---

1. What the Wallet Indicator Shows #

If a user’s browser already has an unlocked wallet, the terminal can display:

✔ Wallet Installed #

Detects whether a browser wallet extension (e.g., MetaMask) exists.

✔ Network / Chain ID #

Shows the current chain the wallet is connected to.

✔ Chain Name #

Displays a readable label (e.g., “Polygon”, “Ethereum Mainnet”).

✔ Account Address #

Shows the active address only if the wallet is already unlocked.

No popup, no request, no connection — the extension exposes this information automatically.

---

2. What the Core Plugin NEVER Does #

The terminal does not perform any blockchain interaction.

It does not:

• ❌ request connection
• ❌ trigger wallet popups
• ❌ ask for accounts
• ❌ sign messages
• ❌ read balances
• ❌ send transactions
• ❌ call RPC endpoints
• ❌ load contract ABIs
• ❌ store any wallet data

The Social Terminal core plugin is intentionally read-only to stay safe, compliant, and lightweight.

All real blockchain operations live only inside optional add-ons.

---

3. Where the Wallet Indicator Appears #

The wallet indicator appears in the Actions row below the terminal window.

It may show something like:

Wallet: Detected
Chain: Polygon (137)
Account: 0xAbC…123

If the user has no wallet installed or their wallet is locked, the indicator either hides or shows:

Wallet: Not detected

Add-ons can extend or customize this display.

---

4. When the Wallet Indicator Is Active #

The indicator appears only when both conditions are met:

1. The feature is enabled in the plugin settings
2. The browser wallet itself exposes public info

If MetaMask or another wallet does not expose chain/account data, the terminal displays nothing related to wallets.

This prevents confusion and avoids unnecessary output.

---

5. Why It’s Safe #

The wallet indicator only uses the standard provider object:

window.ethereum

It simply reads:

• ethereum.isMetaMask
• ethereum.chainId
• ethereum.selectedAddress

These are already public values, exposed by the wallet by design.

Nothing is requested or fetched.

---

6. Add-Ons Enhance Wallet Features #

Add-ons like:

• Cointacted EVM Integration
• Social Mining
• Solana Lite
• Rewards / On-Chain Logging

can display:

• balances
• point-to-token mappings
• transaction hashes
• claimable rewards
• connections to specific networks

These add-ons handle all real wallet interaction using wallet popups, not WordPress code.

The core plugin remains 100% safe and passive.

---

Summary #

The wallet indicator:

✔ Shows only publicly exposed wallet info #

✔ Is read-only #

✔ Is safe and compliant #

✔ Does not request access #

✔ Does not connect or sign #

✔ Appears only if a wallet is already unlocked #

✔ Serves as the foundation for future add-ons #

This gives your terminal Web3 awareness without any risk — and without violating WordPress.org policies.