EchoMirror VS Code Extension

The EchoMirror VS Code extension brings Stellar wallet tools, mood logging, and blockchain sync monitoring directly into your editor.

Install

From Source (Development)

cd extensions/vscode
npm install
npm run build

Then press F5 in VS Code to launch the Extension Development Host, or package with npm run package and install the resulting .vsix.

From VS Code Marketplace

search "EchoMirror SDK" in the Extensions panel (once published).

Features

Status Bar — Live ECHO Balance

When echomirror.statusBarPublicKey is set and echomirror.showStatusBar is true, a status bar item on the right shows your live ECHO token balance. Click it to refresh.

Log Mood (echomirror.logMood)

Opens a multi-step quick pick:

1. Select a mood score (1–10)
2. Optionally add a note
3. Optionally select tags (work, health, social, focus, stress)

The mood status bar item updates with a colored indicator (green ≥ 7, yellow ≥ 4, red < 4).

View Streak (echomirror.viewStreak)

Shows your current and longest mood logging streaks in a notification.

Check Stellar Balance (echomirror.checkBalance)

Fetches XLM and ECHO balances for a Stellar public key. Uses the configured statusBarPublicKey if set, otherwise prompts for a G-address.

Validate Stellar Address (echomirror.validateAddress)

Validates that an address is a well-formed Stellar G-address (56 alphanumeric characters starting with G).

Fund Testnet Account (echomirror.fundTestnet)

Funds a testnet account with 10,000 XLM via Friendbot. Only available when echomirror.network is set to testnet.

Open Sync Explorer (echomirror.openSyncExplorer)

Opens a webview panel that streams real-time Stellar transactions for any account. The panel connects to the Stellar Horizon API for the configured network and displays transactions as they arrive.

• Pre-fills with statusBarPublicKey if configured
• Shows a network badge (testnet / mainnet)
• Auto-starts watching when a key is pre-filled
• Events are color-coded: green for transactions, red for errors

Insert Mood Log Snippet (echomirror.insertMoodLogSnippet)

Inserts a code snippet for logging mood. Detects the active editor language:

• Dart: Inserts EchoMirror.instance.mood.log(...) snippet
• TypeScript/JavaScript: Inserts logMood(client, {...}) snippet

Sign In / Sign Out (echomirror.signIn, echomirror.signOut)

Manages your EchoMirror API key. The key is stored in VS Code's encrypted SecretStorage — it is never written to settings or disk in plaintext.

Configuration

Setting	Type	Default	Description
echomirror.apiKey	string	""	EchoMirror API key (use Sign In command instead)
echomirror.network	"mainnet" | "testnet"	"testnet"	Stellar network to connect to
echomirror.statusBarPublicKey	string	""	Public key for live ECHO balance in status bar
echomirror.showStatusBar	boolean	true	Show live ECHO balance in status bar

Snippets

The extension provides code snippets for TypeScript and JavaScript:

Prefix	Description
em-mood	Log a mood entry
em-streak	Get the user's mood streak
em-balance	Get Stellar XLM and ECHO balance
em-freighter	Connect Freighter wallet
em-send	Send ECHO tokens
em-provider	Wrap app with EchoMirror React Provider
em-friendbot	Fund a testnet account
em-sync	Start a blockchain sync engine
echomirror-init	Boilerplate EchoMirror client setup

Known Limitations

• The Sync Explorer panel uses Horizon REST polling (5-second intervals), not the full SSE-based sync engine. For production sync, use @echomirror/core or the Rust echomirror-sync crate directly.
• The echomirror.apiKey setting in VS Code configuration is redundant — the extension reads the API key from SecretStorage only. Use the Sign In command.
• The Activity Bar sidebar views (Blockchain Sync Explorer, Stellar Wallet) are declared but not yet wired to TreeDataProviders. Use the command palette to open the Sync Explorer panel.