POST /api/mobile/register

Call this once on app launch, and any time device metadata changes (new OS version, new app version).

Request

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

{
  "address": "0x0ffb0d05edcc648bc5dd06e844490b98384df4a1",
  "deviceId": "ios-device-abc-123",
  "os": "iOS",
  "model": "iPhone 15 Pro",
  "appVersion": "1.0.0",
  "region": "BR-SP",
  "hardwareConcurrency": 6,
  "deviceMemory": 8
}

Fields

string

required

Hex-prefixed Ethereum address for the user (EOA).

string

required

Opaque device identifier. On iOS use identifierForVendor; on Android use a stable install ID (not the advertising ID).

string

"iOS" or "Android".

string

Device model string (e.g., "iPhone 15 Pro", "Pixel 8").

string

Semver version of your mobile app.

string

IETF region subtag (e.g., "BR-SP").

integer

Number of logical CPU cores.

integer

RAM in GB.

Response — `200 OK`

{
  "registered": true,
  "deviceId": "ios-device-abc-123",
  "address": "0x0ffb...",
  "serverTime": 1729380000,
  "chainId": 7717
}

Example

curl -X POST https://api.54-237-170-237.sslip.io/api/mobile/register \
  -H 'Content-Type: application/json' \
  -d '{
    "address":"0x0ffb0d05edcc648bc5dd06e844490b98384df4a1",
    "deviceId":"qa-test-device",
    "os":"iOS",
    "model":"iPhone 15 Pro",
    "appVersion":"1.0.0",
    "region":"BR-SP"
  }'

API Reference

JSON-RPC (Ethereum-compatible)

Mobile REST API

Faucet

Block Endorsements

POST /api/mobile/register

Request

Fields

Response — `200 OK`

Example

​Request

​Fields

​Response — 200 OK

​Example

Request

Fields

Response — `200 OK`

Example