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

400

Bad request

application/json

500

Internal server error

application/json

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

400

Bad request

application/json

500

Internal server error

application/json

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

400

Bad request

application/json

500

Internal server error

application/json

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

101

Switching protocols to WebSocket

200

WebSocket connection established

application/json

statusstringOptionalExample: connected

400

Bad request

application/json

500

Internal server error

application/json

get/ws

GET /ws HTTP/1.1
Host: archipelago-ea-stats.decentraland.org
Accept: */*

{
  "status": "connected"
}