Operator environment

Settings

Local source configuration, trust posture, storage evidence, and compatibility guidance. Reef never asks for private keys or Fiber secret passwords.

Environment

State: limited
Source: Reef source coverage check
Detail: 4 source warnings in this environment.

Fiber RPC

available

CKB RPC

available

Metrics

not configured

Local store

available

Connection Setup

Reef validates every configured live source before saving. Optional WebSocket, metrics, and CKB fields can be left empty; polling remains active without WebSocket.

PUT /api/settings

Configuration is read-only through the hosted dashboard. Open Reef from localhost to validate or save operator settings.

Required connection

Fiber RPC HTTP URL

Optional data sourcesWebSocket, Prometheus metrics, and CKB RPC increase coverage but are not required.

Fiber RPC WebSocket URLFiber metrics URLCKB RPC URL

Collection and retentionTune polling only when the defaults do not match your node or infrastructure.

Core RPC interval msMetrics interval msCKB interval msGraph interval msRetention days

Read-only authenticationAdd a Biscuit bearer token without exposing signing secrets to Reef.

Read-only Biscuit bearer tokenClear saved token

Tokens stay in process memory unless REEF_ENCRYPTION_KEY enables authenticated encrypted storage. Leave blank to keep the current token. Reef never requests a private key or secret-key password.

Effective configurationRedacted endpoints, collection intervals, thresholds, and retention

Fiber RPC HTTP URL: [redacted endpoint]
Fiber WebSocket URL: not configured; polling is active
Fiber metrics URL: not configured
Fiber log path: not configured
CKB RPC URL: [redacted endpoint]
Public routing data API: not configured
Routing data network: testnet
Biscuit token: configured, redacted
Fiber RPC exposure: local or private endpoint
Observation mode: polling active; WebSocket not configured
Secure minimum Fiber version: not configured
Low outbound alert threshold: 1 shannons
Gossip rejection alert threshold: 10.0%
Gossip sync timeout alert threshold: 20.0%
PostgreSQL observation store: DATABASE_URL
Core RPC collection interval: 30000ms
Metrics collection interval: 15000ms
CKB collection interval: 60000ms
Routing collection interval: 300000ms
History retention: 7 days
Fiber fleet: 4 configured nodes; independently collected through read-only RPC
Encrypted secret storage: not configured; token is memory-only

Fiber RPC method evidenceIndependent status for each configured read-only method

Fiber RPC Method Status

Each read method is tracked independently so one failure does not hide successful node, channel, peer, payment, or routing observations.

6 methods

graph_channels

Fiber RPC graph_channels at [redacted endpoint] succeeded: 1222 graph channels collected across all pages

graph_channels

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC graph_channels at [redacted endpoint] succeeded: 1222 graph channels collected across all pages
Checked: 2026-08-13T23:21:45.686Z
Latency: 804ms

graph_nodes

Fiber RPC graph_nodes at [redacted endpoint] succeeded: 137 graph nodes collected across all pages

graph_nodes

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC graph_nodes at [redacted endpoint] succeeded: 137 graph nodes collected across all pages
Checked: 2026-08-13T23:21:45.543Z
Latency: 671ms

list_channels

Fiber RPC list_channels at [redacted endpoint] succeeded: 1 channels collected

list_channels

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC list_channels at [redacted endpoint] succeeded: 1 channels collected
Checked: 2026-08-13T23:22:28.820Z
Latency: 201ms

list_payments

Fiber RPC list_payments at [redacted endpoint] succeeded: 0 payments collected across all pages

list_payments

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC list_payments at [redacted endpoint] succeeded: 0 payments collected across all pages
Checked: 2026-08-13T23:22:28.844Z
Latency: 27ms

list_peers

Fiber RPC list_peers at [redacted endpoint] succeeded: 4 peers collected

list_peers

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC list_peers at [redacted endpoint] succeeded: 4 peers collected
Checked: 2026-08-13T23:22:28.831Z
Latency: 212ms

node_info

Fiber RPC node_info at [redacted endpoint] succeeded: node identity collected

node_info

State: available
Source: fiber-rpc:[redacted endpoint]
Detail: Fiber RPC node_info at [redacted endpoint] succeeded: node identity collected
Checked: 2026-08-13T23:22:28.817Z
Latency: 201ms

Fiber Migration Compatibility

Version-aware storage guidance without assuming the node's on-disk database version.

GET /api/compatibility

Observed Fiber version: 0.9.0-rc7
Migration mode: unified
Unified migration epoch: 20260302100001

Version evidence: Fiber 0.9.0-rc7 is in the 0.9-or-later release family, whose current storage path runs unified migrations when opening the store.
Source limit: Fiber node_info does not expose the on-disk database migration version, so Reef cannot determine whether a database predates the unified migration epoch.
Safe next action: Back up and stop the node before upgrading. If the database version is older than 20260302100001, first run the v0.8.x fnn-migrate binary; then start the current Fiber release so unified migrations can continue.

PostgreSQL Storage

Deduplicated observation and lifecycle row counts after transactional retention.

PostgreSQL storage

State: available
Source: Reef PostgreSQL store
Detail: Retention is 7 days; unchanged entity observations are content-deduplicated.

Observation runs: 2016
Channels: 6
Payments: 5
Peers: 71
Graph nodes: 1611
Graph channels: 3297
Metric samples: 0
Alert events: 122
Database bytes: 121,445,399
Table bytes: 63,660,032
Index bytes: 14,458,880
Live tuples: 9,095
Dead tuples: 8,789
Dead tuple ratio: 49.1%

Live Environment Setup

Source coverage from current configuration and latest Fiber evidence.

Source: environment status and local config

Fiber RPC

reef-fiber-testnet 029d74db88f1153ba5fbaff8ead933d10f7675128154dcdb846aaebc5a79ac6ef6 reported 1 channels, 4 peers, and 0 payments.

Fiber RPC

State: pass
Source: fiber-rpc:[redacted endpoint]
Detail: reef-fiber-testnet 029d74db88f1153ba5fbaff8ead933d10f7675128154dcdb846aaebc5a79ac6ef6 reported 1 channels, 4 peers, and 0 payments.

Use this endpoint for live Reef operations.

CKB RPC

get_tip_header succeeded

CKB RPC

State: pass
Source: ckb-rpc:[redacted endpoint]
Detail: get_tip_header succeeded

Keep this endpoint configured for funding transaction evidence.

Metrics

Fiber metrics not configured

Metrics

State: warn
Source: fiber-metrics:not-configured
Detail: Fiber metrics not configured

Configure REEF_FIBER_METRICS_URL to a real Fiber Prometheus endpoint.

WebSocket

Fiber WebSocket URL not configured; polling is active

WebSocket

State: warn
Source: fiber-ws:not-configured
Detail: Fiber WebSocket URL not configured; polling is active

Configure REEF_FIBER_WS_URL to a node that accepts subscribe_store_changes.

Fiber logs

Fiber log path not configured

Fiber logs

State: warn
Source: fiber-logs:not-configured
Detail: Fiber log path not configured

Configure REEF_FIBER_LOG_PATH to a readable real Fiber node log.

Read-only Biscuit

Biscuit token is configured and redacted in Reef.

Read-only Biscuit

State: pass
Source: fiber-rpc:[redacted endpoint]
Detail: Biscuit token is configured and redacted in Reef.

Keep the token scoped to read-only Fiber RPC methods.

Local store

latest Fiber observation loaded from PostgreSQL without live collection

Local store

State: pass
Source: Reef PostgreSQL store
Detail: latest Fiber observation loaded from PostgreSQL without live collection

Use cached navigation and explicit Refresh for operational review.

Live Environment

4 source warnings in this environment.

Default public testnet mode can show source gaps because public endpoints usually do not expose operator metrics, WebSocket events, logs, or read-only Biscuit posture. Use an operator-controlled node for full environment coverage.

Source coverage

Environment status

State: limited
Source: Reef source coverage check
Detail: 4 source warnings in this environment.

Status: limited
Source gaps: 0
Warnings: 4

Run after changing source configuration: npm run check:environment
Fresh source coverage API: GET /api/environment/status?refresh=1

Fiber RPC

fiber-rpc:[redacted endpoint]

Fiber RPC

State: pass
Source: fiber-rpc:[redacted endpoint]
Detail: reef-fiber-testnet 029d74db88f1153ba5fbaff8ead933d10f7675128154dcdb846aaebc5a79ac6ef6 reported 1 channels, 4 peers, and 0 payments.

Evidence: reef-fiber-testnet 029d74db88f1153ba5fbaff8ead933d10f7675128154dcdb846aaebc5a79ac6ef6 reported 1 channels, 4 peers, and 0 payments.
Next action: Use this endpoint for live Reef operations.

CKB RPC

ckb-rpc:[redacted endpoint]

CKB RPC

State: pass
Source: ckb-rpc:[redacted endpoint]
Detail: get_tip_header succeeded

Evidence: get_tip_header succeeded
Next action: Keep this endpoint configured for funding transaction evidence.

Public routing data

fiber-public-routing:not-configured

Public routing data

State: warn
Source: fiber-public-routing:not-configured
Detail: public routing data source not configured

Evidence: public routing data source not configured
Next action: Configure public routing data or ensure Fiber RPC has public routing records available.

Fiber metrics

fiber-metrics:not-configured

Fiber metrics

State: warn
Source: fiber-metrics:not-configured
Detail: Fiber metrics not configured

Evidence: Fiber metrics not configured
Next action: Configure REEF_FIBER_METRICS_URL to a real Fiber Prometheus endpoint.

Fiber WebSocket

fiber-ws:not-configured

Fiber WebSocket

State: warn
Source: fiber-ws:not-configured
Detail: Fiber WebSocket URL not configured; polling is active

Evidence: Fiber WebSocket URL not configured; polling is active
Next action: Configure REEF_FIBER_WS_URL to a node that accepts subscribe_store_changes.

Fiber logs

fiber-logs:not-configured

Fiber logs

State: warn
Source: fiber-logs:not-configured
Detail: Fiber log path not configured

Evidence: Fiber log path not configured
Next action: Configure REEF_FIBER_LOG_PATH to a readable real Fiber node log.

CCH order state

fiber-cch-orders:[redacted endpoint]

CCH order state

State: pass
Source: fiber-cch-orders:[redacted endpoint]
Detail: 0 CCH order rows available from read-only lookups.

Evidence: 0 CCH order rows available from read-only lookups.
Next action: Use Payments to show redacted CCH order evidence.

Security posture

fiber-rpc:[redacted endpoint]

Security posture

State: pass
Source: fiber-rpc:[redacted endpoint]
Detail: No active unsafe public RPC exposure alert in the current observation.

Evidence: No active unsafe public RPC exposure alert in the current observation.
Next action: Keep using read-only endpoints and redacted local operational data.

PostgreSQL observation store

Reef PostgreSQL store

PostgreSQL observation store

State: pass
Source: Reef PostgreSQL store
Detail: latest Fiber observation loaded from PostgreSQL without live collection

Evidence: latest Fiber observation loaded from PostgreSQL without live collection
Next action: Use cached navigation and explicit Refresh for operational review.

Connection Check

Read-only Fiber RPC node_info check with endpoint, timeout, HTTP status, and retry evidence.

GET /api/connections/check

RPC endpoint: [redacted endpoint]
Check method: node_info
Cached status: available

Source Evidence

Latest redacted Fiber RPC payload evidence and Fiber metric samples from the current observation.

GET /api/source/evidence

Fiber RPC evidence rows: 1365
Metric samples: 0
Row limit: 50 by default, use ?limit=

Observability Coverage

Which Reef capabilities are backed by the latest real sources, and what source is missing when coverage is limited.

Source: latest local observation

Node and channel state

fiber-rpc:[redacted endpoint]

Coverage

State: covered
Source: fiber-rpc:[redacted endpoint]
Detail: 4 peers and 1 channels from Fiber RPC

Evidence: 4 peers and 1 channels from Fiber RPC
Next action: Use Channels and Peers to inspect live Fiber state.

Payment diagnostics

fiber-rpc:[redacted endpoint]

Coverage

State: covered
Source: fiber-rpc:[redacted endpoint]
Detail: 0 payments from Fiber RPC list_payments

Evidence: 0 payments from Fiber RPC list_payments
Next action: Use Payments for path checks, failure, stale in-flight, and fee evidence.

CCH order state

fiber-cch-orders:[redacted endpoint]

Coverage

State: covered
Source: fiber-cch-orders:[redacted endpoint]
Detail: no payment hashes available for CCH order lookup

Evidence: no payment hashes available for CCH order lookup
Next action: Use Payments to inspect redacted CCH order status.

Funding and settlement evidence

ckb-rpc:[redacted endpoint]

Coverage

State: covered
Source: ckb-rpc:[redacted endpoint]
Detail: 1 funding transactions checked; get_tip_header succeeded

Evidence: 1 funding transactions checked; get_tip_header succeeded
Next action: Use Channels to inspect CKB funding transaction status.

Routing and route confidence

fiber-public-routing:not-configured

Coverage

State: covered
Source: fiber-public-routing:not-configured
Detail: 137 routing nodes and 1222 routing channels

Evidence: 137 routing nodes and 1222 routing channels
Next action: Use Network for routing topology and remember private liquidity is not visible.

Gossip metrics

fiber-metrics:not-configured

Coverage

State: missing_source
Source: fiber-metrics:not-configured
Detail: Fiber metrics not configured

Evidence: Fiber metrics not configured
Next action: Configure Fiber Prometheus metrics for gossip health.

Event timelines

fiber-logs:not-configured; fiber-ws:not-configured

Coverage

State: missing_source
Source: fiber-logs:not-configured; fiber-ws:not-configured
Detail: 0 timeline events; Fiber log path not configured; Fiber WebSocket URL not configured; polling is active

Evidence: 0 timeline events; Fiber log path not configured; Fiber WebSocket URL not configured; polling is active
Next action: Configure Fiber logs or WebSocket for event timelines.

Transport, storage, sync, and security events

fiber-logs:not-configured; fiber-ws:not-configured

Coverage

State: missing_source
Source: fiber-logs:not-configured; fiber-ws:not-configured
Detail: 0 hardening events from Fiber logs or store changes

Evidence: 0 hardening events from Fiber logs or store changes
Next action: Configure Fiber logs or WebSocket and inspect Fiber node logs for hardening evidence.

Alert delivery

alert-webhook:not-configured

Coverage

State: missing_source
Source: alert-webhook:not-configured
Detail: alert webhook URL not configured

Evidence: alert webhook URL not configured
Next action: Configure REEF_ALERT_WEBHOOK_URL to enable optional alert delivery.

Environment variablesAdvanced source, threshold, retention, and local security controls

Fiber RPC HTTP: REEF_FIBER_RPC_HTTP_URL
Fiber WebSocket: REEF_FIBER_WS_URL
Fiber metrics: REEF_FIBER_METRICS_URL
Fiber log path: REEF_FIBER_LOG_PATH
Biscuit bearer token: REEF_BISCUIT_TOKEN, redacted in UI
Alert webhook URL: REEF_ALERT_WEBHOOK_URL, redacted in UI
Alert webhook attempts: REEF_ALERT_WEBHOOK_MAX_ATTEMPTS
Muted alert rules: REEF_MUTED_ALERT_RULES
Muted alert entities: REEF_MUTED_ALERT_ENTITIES
CKB RPC: REEF_CKB_RPC_URL
Local database URL: DATABASE_URL
Public routing data API: REEF_PUBLIC_GRAPH_API_URL
Routing data network: REEF_PUBLIC_GRAPH_NETWORK
Secure minimum Fiber version: REEF_SECURE_MINIMUM_FIBER_VERSION
Low outbound alert threshold: REEF_LOW_OUTBOUND_LIQUIDITY_SHANNONS
Gossip rejection alert threshold: REEF_GOSSIP_REJECTION_RATE_THRESHOLD
Gossip sync timeout alert threshold: REEF_GOSSIP_SYNC_TIMEOUT_RATE_THRESHOLD
Gossip counter window: REEF_GOSSIP_RATE_WINDOW_MS
Payment failure window: REEF_PAYMENT_FAILURE_WINDOW_MS
Payment failure minimum samples: REEF_PAYMENT_FAILURE_MINIMUM_SAMPLES
Per-asset outbound thresholds: REEF_LOW_OUTBOUND_LIQUIDITY_BY_ASSET_JSON
Source collection timeout: REEF_SOURCE_TIMEOUT_MS
Refresh response timeout: REEF_REFRESH_TIMEOUT_MS
CKB funding scan limit: REEF_CKB_FUNDING_TX_LIMIT
Core RPC collection interval: REEF_CORE_RPC_INTERVAL_MS
Metrics collection interval: REEF_METRICS_INTERVAL_MS
CKB collection interval: REEF_CKB_INTERVAL_MS
Graph collection interval: REEF_GRAPH_INTERVAL_MS
WebSocket refresh debounce: REEF_WS_REFRESH_DEBOUNCE_MS
WebSocket reconnect minimum: REEF_WS_RECONNECT_MIN_MS
WebSocket reconnect maximum: REEF_WS_RECONNECT_MAX_MS
History retention: REEF_RETENTION_DAYS
Settings encryption key: REEF_ENCRYPTION_KEY, never displayed
Settings mutation: localhost only