Overview

The Events Notifier API is a service that processes and forwards blockchain and web events from the Decentraland ecosystem. It handles events from various sources including the Decentraland Explorer, web applications, and blockchain data sources.

Key Features

• Event Processing: Processes and validates events from multiple sources

• Blockchain Integration: Monitors blockchain events for marketplace activities, rentals, and collections

• Web Event Handling: Processes web analytics events with user validation

• Admin Operations: Provides administrative endpoints for managing event producers and user data

• Security: Implements signature validation and authentication for secure event processing

Event Types

• Client Events: User interactions within the Decentraland Explorer (movement, emotes, login, etc.)

• Web Events: Analytics events from web applications

• Blockchain Events: Marketplace transactions, rentals, and collection activities

Authentication

Most endpoints require authentication via bearer tokens or signature validation. Admin endpoints require additional authorization

Endpoints

• Forward Explorer Events: /forward

• Forward Web Events: /forward-web

• Forward Blockchain Events: /forward-blockchain

• Set Producer Cursor: /producers/{producer}/set-since

• Retrieve Anonymous IDs: /admin/anonids

• Unflag Anonymous IDs: /admin/anonids/unflag

Security

• Signature Validation: HMAC-SHA1 signature validation for event validation

• Bearer Token Authentication: Bearer token authentication for admin endpoints

• Anonymous ID Validation: Anonymous ID validation and flagging for web events

• Event Validation: Event validation for client events

• Web Event Validation: Web event validation for web events