POST /api/mobile/engagement

Call this every time the user performs a trackable action in your app (post, like, share, comment, watch, NFT create, tip). The server builds a recordAction(address,uint8,uint256,bytes32) calldata targeting the EngagementOracle contract, signs with the provided key, and submits the tx to the mempool. A tx hash is returned immediately.

Request

POST /api/mobile/engagement
Content-Type: application/json

{
  "address": "0x0ffb0d05edcc648bc5dd06e844490b98384df4a1",
  "actionType": "like",
  "targetId": "post_xyz123",
  "deviceInfo": {
    "os": "iOS",
    "model": "iPhone 15 Pro",
    "batteryLevel": 0.87,
    "networkType": "5g",
    "region": "BR-SP"
  },
  "clientTimestamp": 1729380000,
  "privateKey": "0x0101010101010101010101010101010101010101010101010101010101010101"
}

Fields

string

required

Acting user’s address.

string

required

One of post, like, share, comment, watch, nft_create, tip.

string

required

Opaque string identifying the content acted upon (hashed to bytes32 on-chain).

object

Device context used for the quality signal (see Engagement Score).

integer

Unix seconds. Used to flag clock skew; the canonical timestamp is still the block’s.

string

deprecated

Ignored. Older builds required this; the indexer now always relays via the oracle wallet, so the field is no-op and safe to omit. Do not ship user private keys in app builds.

Prefer POST /api/mobile/engagement-onbehalf for clarity — it documents the no-private-key contract explicitly and has the same semantics.

Action weights

actionType	Weight
`post`	1.00
`like`	0.20
`share`	0.50
`comment`	0.30
`watch`	0.15
`nft_create`	2.00
`tip`	0.80

Response — `200 OK`

{
  "txHash": "0x...",
  "actionType": "like",
  "rewardPreviewYce": "40000000000000000",
  "weight": 0.2,
  "status": "pending"
}

Poll eth_getTransactionReceipt or /api/mobile/actions/:address to watch it move to confirmed.

Example

curl -X POST https://api.72-62-139-238.sslip.io/api/mobile/engagement \
  -H 'Content-Type: application/json' \
  -d '{
    "address":"0x0ffb0d05edcc648bc5dd06e844490b98384df4a1",
    "actionType":"like",
    "targetId":"post_xyz123"
  }'

The indexer ALWAYS signs recordAction(user, actionType, weight, targetId) with the authorized oracle wallet (EngagementOracle.recordAction is onlyOracle). The user’s address is attributed inside the calldata, not the tx signer. App teams do not need — and should not handle — user private keys for engagement.

API Reference

JSON-RPC (Ethereum-compatible)

Mobile REST API

Faucet

Validator Attestations

POST /api/mobile/engagement

Request

Fields

Action weights

Response — `200 OK`

Example

​Request

​Fields

​Action weights

​Response — 200 OK

​Example

Request

Fields

Action weights

Response — `200 OK`

Example