注册

在 Sequencer 开始为某个参与者建立索引之前，该用户（或机器人）必须先在新的 API 中完成注册。注册过程会为账号绑定一把 Ed25519 公钥以及与 TIP 兼容的 PIN。

检查注册状态

使用此接口确认某个用户是否已经接入 Sequencer：

API 端点 URL

GET https://api.mixin.one/safe/me

Response

{
  "data": {
    "user_id": "UUID-USER",
    "identity_number": "123456",
    "phone": "+8610010",
    "full_name": "",
    "biography": "",
    "avatar_url": "",
    "relationship": "",
    "mute_until": "0001-01-01T00:00:00Z",
    "created_at": "0001-01-01T00:00:00Z",
    "code_id": "UUID-CODE",
    "code_url": "",
    "features": [],
    "has_safe": true, // if true, user have register safe.
    "session_id": "UUID-SESSION",
    "device_status": "",
    "has_pin": false,
    "receive_message_source": "",
    "accept_conversation_source": "",
    "accept_search_source": "",
    "fiat_currency": "",
    "transfer_notification_threshold": 0,
    "transfer_confirmation_threshold": 0,
    "pin_token_base64": "",
    "salt_base64": "",
    "tip_key_base64": "",
    "tip_counter": 0,
    "has_emergency_contact": false
  }
}

注册用户或机器人

如果用户尚未注册，请提交公钥、签名和 PIN 负载以激活账号。建议每位用户使用独立的 Ed25519 密钥对，以便将权限与 Session secret 隔离。

API 端点 URL

POST https://api.mixin.one/safe/users

请求体

{
"public_key": "ED25519-PUBLIC-KEY-HEX",
"signature": "ED25519-SIGNATURE-OF-USER-UUID-HEX",
"pin_base64": "TIP-PIN-BASE64"
}

Response

{
  "data": {
    "user_id": "UUID-USER",
    "identity_number": "123456",
    "phone": "+8610010",
    "full_name": "",
    "biography": "",
    "avatar_url": "",
    "relationship": "",
    "mute_until": "0001-01-01T00:00:00Z",
    "created_at": "0001-01-01T00:00:00Z",
    "code_id": "UUID-CODE",
    "code_url": "",
    "features": [],
    "has_safe": true, // if true, user have register safe.
    "session_id": "UUID-SESSION",
    "device_status": "",
    "has_pin": false,
    "receive_message_source": "",
    "accept_conversation_source": "",
    "accept_search_source": "",
    "fiat_currency": "",
    "transfer_notification_threshold": 0,
    "transfer_confirmation_threshold": 0,
    "pin_token_base64": "",
    "salt_base64": "",
    "tip_key_base64": "",
    "tip_counter": 0,
    "has_emergency_contact": false
  }
}

签名应来源于 sha256.Sum256([]byte("SEQUENCER:REGISTER:" + USER-UUID + PUBLIC-KEY-HEX))。