MPC API

API endpoints

MPC API

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

Відкрити SwaggerЗареєструватися

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

POST /api/v1/mpc/initialize

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

Надішліть точний двобайтовий JSON body {} з Content-Type: application/json. Встановіть X-Api-Body-Hash і canonical BODY_HASH line у 44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a. Zero-length body для цієї операції невалідний. Bundled client автоматично додає та підписує {}.

Операція idempotent у межах організації та idempotency key. Після timeout повторіть той самий {} 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 до готовності ключа й цільової мережі.