Blockchain Events

Endpoints for forwarding blockchain events with signed fetch authentication

Forward Blockchain Events

post

/forward-blockchain

Forwards blockchain events using ADR-44 signed fetch authentication. Currently supports tip events (MANA transfers). Validates the transaction on-chain by decoding the meta-transaction to verify sender, receiver, and amount.

Supported event types:

• tip_received: MANA tip transfers via meta-transaction

Requests from scenes (decentraland-kernel-scene) are blocked.

Authorizations

X-Identity-AuthChain-0stringRequired

ADR-44 signed fetch headers (X-Identity-AuthChain-*, X-Identity-Timestamp, X-Identity-Metadata).

Body

typestring · enumRequired

Blockchain event type

Example: tip_receivedPossible values:

transactionHashstringRequired

Transaction hash of the meta-transaction. The receiver and amount are extracted from the transaction data.

Example: 0x5e9f2231e36f3c7a1c23f1485d2f61b7718f9830b0b5a7d37c07f1e4f2c6d1aa

Responses

204

Blockchain event accepted and forwarded

No content

400

Invalid request data or transaction mismatch

application/json

401

Signed fetch authentication failed or expired

application/json

403

Transaction sender mismatch

application/json

409

Transaction not mined or not sufficiently confirmed

application/json

500

Internal error publishing the event

application/json

post/forward-blockchain

POST /forward-blockchain HTTP/1.1
Host: events-notifier.decentraland.org
X-Identity-AuthChain-0: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "type": "tip_received",
  "transactionHash": "0x5e9f2231e36f3c7a1c23f1485d2f61b7718f9830b0b5a7d37c07f1e4f2c6d1aa"
}

No content