web/docs/api/examples/member-channel.examples.md

Member App Channel API Examples

Register Device Channel

Request

POST /member/channel/device/register
Authorization: Bearer <wallet-session>
Content-Type: application/json

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "chain_id": 8453,
  "device_id": "desktop-7f6f3a9b",
  "platform": "desktop",
  "app_version": "0.1.0",
  "push_provider": "none"
}

Response

{
  "channel_binding_id": "ch_01J9A4MQQ6V7H1S0A7R7ME7D4J",
  "status": "active",
  "poll_interval_seconds": 30,
  "server_time": "2026-02-17T20:43:18Z"
}

Poll Events

Request

GET /member/channel/events?wallet=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&device_id=desktop-7f6f3a9b&cursor=evt_1030&limit=25
Authorization: Bearer <wallet-session>

Response

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "device_id": "desktop-7f6f3a9b",
  "events": [
    {
      "event_id": "evt_1031",
      "class": "platform_update",
      "created_at": "2026-02-17T20:42:11Z",
      "title": "Platform update available",
      "body": "A deterministic runtime update is ready for your current platform channel.",
      "dedupe_key": "platform_update:0.1.1",
      "requires_ack": true,
      "policy_hash": "sha256:8b903f0d3a...",
      "payload": {
        "version": "0.1.1",
        "channel": "stable"
      }
    }
  ],
  "next_cursor": "evt_1031",
  "server_time": "2026-02-17T20:43:20Z"
}

Acknowledge Event

Request

POST /member/channel/events/evt_1031/ack
Authorization: Bearer <wallet-session>
Content-Type: application/json

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "device_id": "desktop-7f6f3a9b",
  "acknowledged_at": "2026-02-17T20:43:25Z"
}

Response

{
  "status": "acknowledged",
  "event_id": "evt_1031",
  "acknowledged_at": "2026-02-17T20:43:25Z"
}

Membership Inactive Error

{
  "error": "membership_inactive",
  "code": "membership_inactive",
  "correlation_id": "req_01J9A4Q9GPDXDNZEWJ2FJS6F5R"
}