Elisia Agent
Documentation

Set up Elisia without handing over custody.

Elisia is a read-only behavioral intelligence agent for traders. It connects wallet identity, public on-chain activity and optional terminal events, then turns that context into an AWARE score and an AI assistant.

Open appDownload extension

Quick Start

  1. Open elisiaagent.xyz/app.
  2. Connect an EVM wallet with MetaMask, Rabby, Trust or another injected wallet, or paste a public address for read-only analysis.
  3. Install the Chrome extension from the zip, open its popup and press Pair device.
  4. Approve the pairing link inside the app. The extension receives a device token; it never receives a seed phrase or private key.
  5. Open a supported terminal page. Elisia observes visible-tab interaction events and sends them to the AWARE engine.
Elisia does not place trades, sign transactions, custody assets or ask for seed phrases.

Wallet Login

Wallet login uses a signed message flow. The backend creates a nonce, the wallet signs it, and the server opens a secure session after verifying the signature.

MetaMask / RabbyEVM login and address ownership verification.
PhantomUsed where the browser exposes an EVM-compatible provider or for future Solana paths.
Read-only modePaste any public address to analyze without connecting a wallet.

Extension Pairing

  1. Download elisia-agent-0.1.0-chrome.zip.
  2. Unzip it locally.
  3. Open chrome://extensions, enable Developer mode and choose Load unpacked.
  4. Select the unzipped extension folder.
  5. Open the Elisia popup and pair the device through the app.

The extension is scoped to supported trading sites and elisiaagent.xyz. It records structured UI events only while the tab is visible.

AWARE Score

AWARE is a 0-100 behavioral pressure score. It is not a buy or sell signal. It reads pace, repetition and reaction patterns so the trader can notice pressure before acting into it.

SignalMeaningWeight
ACTActivity load across recent actions.0.25
WKFWorkflow repetition and looped behavior.0.15
VELAction-to-execution velocity.0.15
RTPRoundtrip loops and re-entry patterns.0.15
OUTLoss response and size changes after adverse outcomes.0.15
BASDrift away from the trader's own baseline.0.15

Wallet Analysis

Elisia can read public Robinhood Chain activity through configured providers and explorer data. The app shows summaries, realized behavior and current profile state. Exact results depend on provider availability and the address history.

AI Agent

The assistant answers questions about the trader's own activity and AWARE state. It can explain the drivers behind a score, summarize recent sessions and point out behavioral patterns. It should not be treated as financial advice.

API Overview

RoutePurpose
/api/healthProduction health check.
/api/v1/auth/*Wallet nonce, verification and session management.
/api/v1/meCurrent authenticated account.
/api/v1/pairing/*Extension pairing request, approval, status and enrollment.
/api/v1/analysis/*Wallet analysis and provider-backed chain reads.
/api/v1/assistant/*AI assistant conversations and messages.

Privacy and Safety

  • No seed phrases, private keys or transaction signing.
  • Device pairing requires explicit approval from an authenticated app session.
  • Private API routes require a wallet session or device token.
  • Extension observations are limited to supported host permissions.
  • Assistant output is informational and not financial advice.

Production Status

Working now

Landing, app routes, API health, secure wallet login, extension pairing, device enrollment and AI assistant messaging have been smoke-tested on production.

Still to harden

Chrome Web Store publishing, live terminal-specific DOM adapters and optional provider keys should be verified before a public launch push.

Last updated: August 28, 2026