Communications

Get scene communication adapter

post

/get-scene-adapter

Generates LiveKit credentials for a user to join a scene's communication room. This endpoint handles authentication, blacklist checking, scene ban verification, and generates appropriate permissions for the user. Requires Signed Fetch authentication from decentraland-kernel-scene. Must include the complete identity header chain: x-identity-auth-chain-0, x-identity-auth-chain-1, x-identity-auth-chain-2, x-identity-timestamp, and x-identity-metadata.

Authorizations

x-identitystringRequired

Signed Fetch authentication for scene-based requests. Requires a chain of identity headers:

• x-identity-auth-chain-0: Signer information
• x-identity-auth-chain-1: Ephemeral key information
• x-identity-auth-chain-2: Signed entity information
• x-identity-timestamp: Request timestamp
• x-identity-metadata: Request metadata Used for authentication from decentraland-kernel-scene.

Body

objectOptional

Signed fetch request with scene and user information

Responses

200

Scene adapter generated successfully

application/json

adapterstringRequired

LiveKit connection URL for the scene

400

Invalid request

application/json

401

Unauthorized - Invalid authentication or blacklisted user

application/json

403

Forbidden - User is banned from this scene

application/json

404

Not found - Realm or scene not found

application/json

500

Internal server error

application/json

post/get-scene-adapter

POST /get-scene-adapter HTTP/1.1
Host: comms-gatekeeper.decentraland.org
x-identity: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "adapter": "text"
}

Get scene participants

get

/scene-participants

Retrieves the list of participant wallet addresses connected to a scene or world room.

Query Parameters:

• pointer + realm_name: For scene rooms (pointer is the base parcel, e.g., "-7,-2"). The scene ID is resolved from the catalyst. realm_name defaults to "main".

• realm_name alone: Treated as a world name (e.g., "mycoolworld.dcl.eth")

Response: Returns an array of wallet addresses (lowercase, 42 characters) of users currently connected to the room. Returns an empty array if the room doesn't exist or has no participants.

Query parameters

pointerstringOptional

Scene base parcel (e.g., "-7,-2"). The scene ID is resolved from the catalyst using this pointer. When provided, realm_name defaults to "main" if not specified.

Pattern: ^-?\d{1,3},-?\d{1,3}$

realm_namestringOptional

When used with pointer: identifies the realm for scene rooms (default: "main"). When used alone (without pointer): treated as a world name (must end with .dcl.eth).

Responses

200

Room participants retrieved successfully

application/json

okbooleanOptionalExample: true

400

Invalid request - must provide either world_name or (pointer + realm_name)

application/json

404

No scene found for the provided pointer

application/json

500

Internal server error

application/json

get/scene-participants

GET /scene-participants HTTP/1.1
Host: comms-gatekeeper.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "addresses": [
      "0x1234567890abcdef1234567890abcdef12345678"
    ]
  }
}