MPC API

API endpoints

MPC API

MPC endpoints ініціалізують default MPC key організації та повертають готовність Co-Signer і окремих мереж.

Ініціалізація MPC

POST /api/v1/mpc/initialize

Необхідний scope: mpc:initialize

Це request із порожнім body. Не надсилайте {}. Поточний Swagger позначає X-Api-Body-Hash як обов’язковий, але перевірена поведінка staging відрізняється: надішліть явний zero-length body з Content-Type: application/x-www-form-urlencoded, залиште canonical BODY_HASH line порожнім і не додавайте X-Api-Body-Hash. Bundled client враховує цей виняток.

Операція idempotent у межах організації та idempotency key. Після timeout повторіть той самий empty-body request із тим самим ключем. Конфлікт fingerprint повертає 400 mpc.errors.IDEMPOTENCY_CONFLICT.

Читання статусу MPC

GET /api/v1/mpc/status

Необхідний scope: mpc:read

Response містить:

  • orgId;
  • nullable keyId;
  • nullable keyStatus: PROVISIONING або ACTIVE;
  • статус Co-Signer;
  • готовність кожної мережі в chains.

Не створюйте гаманці, доки відповідна мережа не готова, а Co-Signer не має статус Online.

Операційна послідовність

  1. Встановіть і запустіть клієнтський Co-Signer.
  2. Перевірте його локальний health endpoint.
  3. Перевірте статус Online у BroSettlement Console.
  4. Один раз викличте MPC initialization із надійно збереженим idempotency key.
  5. Перевіряйте MPC status до готовності ключа й цільової мережі.