Settings Reference

Hologram's Settings page contains 14 configuration sections. This guide covers the key areas.

Settings Overview

TELA Server Manager

Manage TELA content servers running on your machine.

Active Servers

View all running TELA servers with:

• Port: The port each server is running on
• SCID/Path: What content is being served
• Uptime: How long the server has been running

Server Controls

API Reference

// List all running servers
GetRunningServers() -> {
    servers: [
        { port: 8080, scid: "abc123...", uptime: "2h 15m" },
        ...
    ]
}
 
// Shutdown a specific server
ShutdownServer(port int) -> { success: true }
 
// Shutdown all servers
ShutdownAllServers() -> { success: true, count: 3 }
 
// Configure server limits
SetMaxServers(count int) -> { success: true }
SetPortStart(port int) -> { success: true }

Console

Real-time application logs for debugging and monitoring.

Features

• Live Logs: See all application events in real-time
• Auto-scroll: Automatically scrolls to newest entries
• User Scroll Detection: Pauses auto-scroll when you scroll up
• Copy Buttons: Quick copy last 25 or 50 log lines
• Clear: Clear all logs (both UI and backend)

Log Levels

Keyboard Shortcuts

• Scroll Up: Pause auto-scroll, review history
• Scroll to Bottom: Resume auto-scroll

API Reference

// Get recent logs
GetConsoleLogs() -> {
    logs: [
        { timestamp: "...", level: "INFO", message: "..." },
        ...
    ]
}
 
// Clear all logs
ClearConsoleLogs() -> { success: true }

Gnomon Configuration

Configure the Gnomon indexer for content discovery.

Auto-start

Toggle whether Gnomon starts automatically when Hologram launches.

SetGnomonAutostart(enabled bool) -> { success: true }
GetGnomonAutostart() -> { enabled: bool }

Status Indicator

The sidebar displays Gnomon sync status with a visual progress bar:

The progress bar shows exact percentage (e.g., "42%") so you always know sync status at a glance. Click the Gnomon row to jump to Settings > Gnomon.

Resync Database

If Gnomon gets out of sync or corrupted:

1. Click Resync Database
2. Wait for reindexing to complete
3. All TELA apps will be rediscovered

ResyncGnomon() -> { success: true, message: "Resyncing..." }

Fastsync Limitations

What this means:

• Gnomon fastsync bootstraps quickly by skipping full block validation
• However, it may miss historical SCID interaction data for older contracts
• Newly discovered SCIDs work fine; historical queries may return incomplete results

Symptoms:

• Version History shows fewer commits than expected
• SC variable timeline missing early snapshots
• Search results missing older apps

Workarounds:

1. Full Resync — Click "Resync Database" to re-index from block 0 (slow but complete)
2. Wait for upstream fix — The Gnomon addscid_toindex feature will allow on-demand historical indexing

Search Exclusions

Filter out specific SCIDs from search results:

1. Find the Search Exclusions section
2. Enter SCID or pattern to exclude
3. Click Add

Excluded content won't appear in:

• OmniSearch results
• Discover tab
• App suggestions

Min-Likes Filter

Set a minimum approval percentage for search results:

• 0%: Show all apps
• 50%: Show apps with majority approval
• 80%: Show only highly-rated apps

Time Machine Watch List

Monitor smart contracts for state changes over time. The Watch List appears in Settings > Gnomon and shows all SCs you're tracking.

Watched SCs Panel

+--------------------------------------------------------------+
| ◎ WATCHED SMART CONTRACTS                      [Refresh All] |
+--------------------------------------------------------------+
| My Voting App                                                |
| abc123...xyz789  │  Since Jan 3  │  3 changes      [Unwatch] |
+--------------------------------------------------------------+
| Token Contract                                               |
| def456...uvw012  │  Since Jan 5  │  0 changes      [Unwatch] |
+--------------------------------------------------------------+
| 2 SCs being watched                                          |
+--------------------------------------------------------------+

Features

Adding to Watch List

You can add SCs to your watch list from two places:

1. Explorer SC Header — Click the Watch button next to the balance
2. Time Machine Panel — Expand Time Machine section and click Watch

WebSocket Query API

The Gnomon WebSocket API allows external tools to query indexed blockchain data without embedding Gnomon themselves. This is useful for:

• TELA dApps needing indexer access
• External monitoring tools
• Custom blockchain explorers
• Automated trading bots

Enabling the WebSocket Server

1. Navigate to Settings > Gnomon
2. Find the Simple-Gnomon Features card
3. Toggle WebSocket API to enable
4. Optionally configure the port (default: auto-detect)

+----------------------------------------------------------+
|  [Zap] Simple-Gnomon Features                             |
+----------------------------------------------------------+
|  WebSocket API                                            |
|  Expose Gnomon queries via WebSocket for external apps    |
|                                                           |
|  [ON/OFF Toggle]  Port: [44400]  Status: Running          |
+----------------------------------------------------------+

API Reference

// Start the WebSocket server
StartGnomonWSServer(address) -> {
    success: bool,
    address: string,  // "127.0.0.1:44400"
    message: string,
}
 
// Stop the WebSocket server
StopGnomonWSServer() -> {
    success: bool,
    message: string,
}
 
// Check server status
GetGnomonWSStatus() -> {
    success: bool,
    running: bool,
    address: string,
    port: int,
}

WebSocket Protocol

Connect via WebSocket and send JSON-RPC 2.0 requests:

const ws = new WebSocket('ws://127.0.0.1:44400/gnomon');
 
ws.onopen = () => {
    ws.send(JSON.stringify({
        jsonrpc: '2.0',
        id: 1,
        method: 'GetAllTags',
        params: {}
    }));
};
 
ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    console.log(response.result); // { tags: ["tela", "g45", ...] }
};

Available Methods

Connected Apps

Manage permissions granted to TELA dApps.

Viewing Permissions

Each connected app shows:

• App Name/Origin: The dApp identifier
• Permissions: What access was granted
• Last Used: When the app last made a request

Permission Types

Revoking Access

• Revoke All: Remove all permissions for an app
• Revoke Specific: Remove individual permissions

RevokeAppPermissions(origin string) -> { success: true }
RevokeAppPermission(origin, permission string) -> { success: true }

Advanced Node Options

For power users running the embedded node.

Fast Sync

Skip full block verification for faster initial sync:

SetNodeAdvancedConfig({
    fastSync: true,
    pruneHistory: 0
}) -> { success: true }

Pruning

Reduce disk usage by pruning old block data:

Network Mode

Switch between networks without restarting:

SetNetworkMode(mode string) -> { success: true }
// mode: "mainnet", "simulator"

Keyboard Shortcuts

Global keyboard shortcuts available throughout Hologram: