For the complete documentation index, see llms.txt. This page is also available as Markdown.

Web Socket Connector Service

Get service status

get
/status

Returns service status with version, commit hash, current time, and user count

Responses
200

Service status

application/json
versionstringRequired

Service version

commitHashstringRequired

Git commit hash

currentTimestring · date-timeRequired

Current server time

userCountnumberRequired

Number of connected users

get/status
GET /status HTTP/1.1
Host: archipelago-ea-stats.decentraland.org
Accept: */*
{
  "version": "text",
  "commitHash": "text",
  "currentTime": "2026-01-01T00:00:00.000Z",
  "userCount": 1
}

Get Prometheus metrics

get
/metrics

Returns Prometheus metrics for monitoring

Responses
200

Prometheus metrics

text/plain
stringOptional
get/metrics
GET /metrics HTTP/1.1
Host: archipelago-ea-stats.decentraland.org
Accept: */*
text

Liveness probe

get
/health/live

Returns 'alive' for liveness checks

Responses
200

Service is alive

text/plain
stringOptionalExample: alive
get/health/live
GET /health/live HTTP/1.1
Host: archipelago-ea-stats.decentraland.org
Accept: */*
alive

WebSocket connection

get
/ws

Establishes a WebSocket connection for real-time communication in the Archipelago system. This endpoint enables peer-to-peer communication, position synchronization, and island management for Decentraland clients.

Authentication Flow:

  1. Client initiates connection with an Ethereum address

  2. Server responds with a challenge string to sign

  3. Client sends signed challenge with AuthChain

  4. Server validates signature and assigns peer ID

Supported Message Types:

  • challengeRequest: Initial connection with address

  • challengeResponse: Server-provided challenge

  • signedChallenge: Client-provided signed challenge with AuthChain

  • welcome: Server confirmation with assigned peer ID

  • heartbeat: Keep-alive messages

  • kicked: Disconnection notification

Once authenticated, the peer receives real-time updates about island assignments, nearby peers, and position changes as they move through Decentraland's metaverse.

Responses
200

WebSocket connection established

application/json
statusstringOptionalExample: connected
get/ws
GET /ws HTTP/1.1
Host: archipelago-ea-stats.decentraland.org
Accept: */*
{
  "status": "connected"
}

Last updated