The Trinity Beast – EAM Admin Panel

1. What Is the EAM?

EAM stands for Exchange Asset Map. It is the Aurora table (exchange_asset_map) that is the single source of truth for every crypto asset The Trinity Beast tracks. Each row answers three questions about one asset on one exchange:

Current Scale

2. Why It Matters

Before the EAM Admin Panel, managing the asset map required three separate manual steps every time an asset needed to be added, toggled, or rebalanced:

3. Panel Overview

The EAM Admin Panel is a standalone HTML page at /docs/eam-admin.html. It is admin-key authenticated — all API calls include the X-Admin-Key header. No login screen; access is controlled at the WAF and network level.

3.1 Main Asset Table

The default view shows all 221 EAM rows across all exchanges. The table is sortable by asset name or exchange, searchable by asset symbol or exchange ticker, and filterable by state.

Figure 3.1 — Main asset table showing all exchanges. Sidebar shows per-exchange enabled/prewarmed counts. Stats bar updates as filters are applied.

3.2 Exchange Sidebar

Clicking any exchange tab filters the table to that exchange only. The sidebar shows two numbers per exchange: enabled/total and the prewarmed count in purple. The active tab is highlighted in amber.

Figure 3.2 — Gemini tab selected. Stats bar updates to show Gemini-only counts. Disabled rows (APE, AVAX) show Off/REST toggles — they exist in EAM but are not active.

3.3 Inline Toggle Switches

Each asset row has two independent toggle switches. Changes are applied immediately via POST /admin/exchange-assets/toggle — no save button required. The UI updates optimistically and reverts if the API call fails.

3.4 Add / Edit Asset Modal

The + Add Asset button opens a two-step picker. For a new asset, the panel first calls POST /admin/eam/discover to fetch the top 18 uncovered candidates for the current exchange, ranked by 24h volume. You see a grid of cards — each showing the asset name, exchange symbol, price, and 24h volume. Click to select one or more, choose a category, set Enabled and Prewarm, then click Add Selected.

If you need to enter an asset manually (e.g. a newly listed token not yet ranked), click Enter manually to switch to the form view. The edit flow (pencil icon on row hover) always opens the form view directly — Asset and Exchange are locked since they form the primary key.

Figure 3.4 — Add Asset modal (manual entry view). The default view shows the discovery picker with top 18 uncovered candidates. Click "Enter manually" to reach this form. Both Enabled and Prewarm default to checked.

3.5 Sync & Deploy Panel

The Sync & Deploy button (header or sidebar) reveals the sync panel. This is a two-step operation: Run Sync writes the current EAM state to application_parameters, then Force Deploy (unlocked after sync) pushes those parameters to all running containers immediately.

Figure 3.5 — Sync panel after a successful sync + force-deploy. Each exchange parameter is confirmed individually. Force Deploy is unlocked only after a successful sync.

4. Standard Workflow

The most common operations and the exact steps to perform them in the panel.

Run a prewarm audit

1. Click Audit in the header (or Prewarm Audit in the sidebar).
2. Click Run Audit. The panel shows a spinner while the audit runs (~12–15s).
3. Results render automatically: per-exchange Layer 1 bars, drift status for Layers 2 & 3, smoke test chips for Layer 4.
4. If dead assets are found, click Disable next to each one, then run Sync & Deploy.
5. If drift is detected, click Fix: Run Sync to open the Sync & Deploy panel.

Toggle a single asset on or off

1. Find the asset (use the search box or select the exchange tab).
2. Click the Enabled toggle. The change is applied immediately — no sync needed for dropdown visibility.
3. If you also changed Prewarm, run Sync & Deploy to push the updated prewarm list to running containers.

Add a new asset

1. Select the target exchange tab in the sidebar.
2. Click + Add Asset. The panel fetches the top 18 uncovered candidates from that exchange (~10–30s, shows a spinner).
3. Click one or more asset cards to select them. Each card shows the asset name, exchange symbol, price, and 24h volume.
4. Choose a category, confirm Enabled and Prewarm are checked, click Add N Assets.
5. Click Sync & Deploy → Run Sync → Force Deploy to activate the WebSocket subscriptions on running containers.
6. If the asset you want isn't in the picker (newly listed, very low volume), click Enter manually to type the asset and exchange symbol directly.

Replace a dead/delisted asset

1. Run the Prewarm Audit. Dead assets appear with Disable and Replace buttons.
2. Click Replace next to the dead asset. The picker opens pre-loaded for that exchange.
3. Select the replacement asset(s) and click Add Selected. The dead asset is automatically disabled and the new asset is added in one step.
4. Run Sync & Deploy to push the change to running containers.

Rebalance an exchange (add multiple assets)

For bulk additions, use the asset-rebalance KCC command which handles discovery, deduplication, and volume ranking automatically. The panel is best for individual asset management and state inspection.

bash scripts/kcc.sh asset-rebalance gemini 5           # preview top 5 candidates
bash scripts/kcc.sh asset-rebalance gemini 5 --apply   # commit + sync + deploy

After the rebalance command completes, refresh the EAM Admin Panel to see the new rows.

Disable a delisted asset

1. Find the asset in the table.
2. Toggle Enabled off and Prewarm off.
3. Run Sync & Deploy to remove it from the prewarm list on running containers.
4. Optionally delete the row entirely using the trash icon (row hover).

5. API Endpoints

All endpoints require the X-Admin-Key header. All responses use the standard UME envelope.

6. Data Model

exchange_asset_map

Downstream: application_parameters

After a sync, the following keys are written to application_parameters:

7. Access & Security

The EAM Admin Panel is an admin-only tool. It is not linked from any public page.