Перейти к содержанию

Глоссарий

Справочник терминов, которые встречаются в документации, REST API и интерфейсах Pert. Термины сгруппированы по доменам; внутри домена идут от общих понятий к частным.

Как пользоваться

Если встретили в API, в ответе или в Customer Console незнакомое слово — ищите его здесь по Ctrl+F. В описаниях есть ссылки на подробные разделы документации.


Платформа и доступ

Pert

Платформа для хранения и операций с цифровыми активами. MPC-подписание использует CMP для ECDSA и FROST для Schnorr/Ed25519. При обычной подписи полный приватный ключ не собирается; восстановление из резервной копии может восстановить его на изолированной машине владельца.

Компания

Юридическое лицо — клиент Pert. Может владеть несколькими workspace (например, разные подразделения, продукты, тестовое и боевое окружения).

Workspace (рабочее пространство)

Изолированная единица учёта внутри Pert: набор vault, кошельков, пользователей, политик, AML-настроек и устройств-подписантов. Ключи разных workspace друг с другом не пересекаются; роли, политики и балансы — изолированы. Подробнее — Структура кошельков.

Тенант (tenant)

Так рабочее пространство называется в путях API и в кодах ошибок: /api/v2/admin/tenants/{tenant_uuid}/…, разделы Tenant, Change Approval и Quorum справочника ошибок. tenant_uuid — идентификатор рабочего пространства.

Workspace Owner (владелец)

Пользователь с ролью OWNER — инициатор создания workspace. Имеет полный набор прав внутри своего workspace, включая создание бэкапа ключей и добавление новых подписантов.

Пользователь workspace

Учётная запись внутри workspace с одной из ролей: OWNER, ADMIN, NON_SIGNING_ADMIN, SIGNER, APPROVER, EDITOR, VIEWER. Роли определяют, что пользователь может видеть и делать: подписывать транзакции, аппрувить, управлять политиками, просматривать историю.

API-пользователь (api_user)

Машинный пользователь рабочего пространства для интеграции по API: как и обычный пользователь, имеет роль, но мобильного устройства не имеет и аутентифицируется через API-ключ. В карточках согласования изменений — user_type: api_user.

Сервисный аккаунт

Учётная запись компонента платформы, а не человека. В карточке запроса на согласование встречается среди участников описания изменения (service_account) — например, как автор изменения, сделанного платформой.

API-ключ (API key)

Идентификатор API-пользователя и связанная с ним пара Ed25519. Приватный ключ подписывает запрос получения access-токена; JWT выдаёт платформа. Публичный ключ загружается в Pert, приватный остаётся у клиента. См. Авторизация.

Устройство (device)

Привязанное к пользователю устройство — второй фактор его действий: мобильное приложение Pert Mobile (подпись и аппрув транзакций, подтверждение изменений) либо Co-Signer — headless-инстанс на стороне клиента для API-сценариев (подпись и аппрув по назначению политики). Долю MPC-ключа устройство хранит у подписанта. Привязывается к учётной записи через процесс pairing.

Pairing (привязка устройства)

Процесс ассоциации нового устройства с пользователем workspace. Устройство генерирует ключевую пару, регистрирует публичный ключ в Pert, после чего владелец workspace сверяет отпечаток ключа и выдаёт устройству MPC-долю, если роль пользователя даёт право подписи.

Отпечаток ключа устройства

Короткая запись публичного ключа шифрования устройства: восемь групп по четыре шестнадцатеричных символа. Владелец workspace сверяет его с устройством подписанта перед выдачей доли ключа. См. Сверка ключа устройства.


Хранение активов

Vault (vault-аккаунт)

Логическая группа кошельков рабочего пространства с общим назначением и префиксом деривации. Роли назначаются на workspace, а политики могут выбирать отдельные vault. Заморозка vault блокирует исходящие операции. См. Структура кошельков.

Wallet (кошелёк)

Контейнер активов одного блокчейна внутри vault: баланс, адрес для приёма средств и история транзакций по конкретной сети/ассету. Бывает двух типов: внутренний (custodial, ключами владеет MPC-схема Pert) и внешний whitelisted (зарегистрированный адрес контрагента). См. Структура кошельков.

Адрес (address)

On-chain адрес, создаваемый вместе с кошельком и переиспользуемый для поступлений. Деривация зависит от сети: BIP-32 для secp256k1, отдельная схема Ed25519 для Solana. См. Адрес.

Whitelisted wallet / адрес

Внешний кошелёк или адрес контрагента, заранее добавленный в whitelist workspace. На whitelisted-адреса можно настроить упрощённый аппрув или автоматический пропуск через политику; выводы на любые другие адреса (см. one-time) обычно требуют более строгого подтверждения.

Тег (метка)

Именованная метка workspace, которую навешивают на vault-аккаунты (до 20 тегов на аккаунт). Теги группируют аккаунты, позволяют фильтровать список по нескольким меткам сразу и могут использоваться как условие выбора источника или назначения в правилах политик. Подробнее — в разделе Теги.

One-time address

Свободно введённый адрес назначения, не входящий в whitelist. На оценке политик такой адрес учитывается отдельно и обычно требует более строгого аппрува.

Asset

Описание токена/монеты: тикер, decimals, блокчейн, контракт (для ERC-20/TRC-20 и т. п.). Один wallet может содержать несколько asset (нативная монета + токены этой же сети).

Smart-contract (custom asset)

Пользовательский токен/контракт, заведённый администратором workspace. После регистрации становится обычным asset, к которому применяются те же политики и лимиты.

Balance

Доступный и заблокированный баланс по активу. При создании исходящей транзакции система проверяет, что доступного баланса достаточно с учётом комиссии (если она списывается тем же активом).

Газ-станция (gas station)

Назначенный vault, который автоматически снабжает базовым активом (газом) остальные vault'ы того же workspace — чтобы переводы токенов не застревали из-за нехватки газа на оплату комиссии. Одна на workspace; применима только к сетям с моделью газа (EVM). Подробнее — Газ-станция и автозаправка.

Автозаправка (autofuel)

Признак на отдельном vault: разрешено ли газ-станции автоматически доливать ему газ. Включается и выключается на каждый vault отдельно; пока не включена, заправок нет. См. Как работает автозаправка.

Порог / Лимит баланса / Комиссия за газ (газ-станция)

Параметры заправки, задаваемые на каждый базовый актив (в скобках — поле API): порог (threshold) — граница, ниже которой запускается долив; лимит баланса (cap) — целевой баланс, до которого доливают газ; комиссия за газ, макс (max_gas_price) — лимит комиссии за одну заправку. Текущие значения по умолчанию.


Криптография и подписание

MPC (Multi-Party Computation)

Криптографический протокол вычислений над секретом, разделённым между несколькими сторонами. Никто из участников не имеет полного ключа — подпись формируется в результате взаимодействия минимум t из n сторон (threshold). Это основа некастодиальности Pert.

MPC-CMP

Протокол пороговой ECDSA-подписи. Используется для соответствующих ключей; Schnorr и Ed25519 обслуживаются FROST.

Доля ключа (key share)

Часть приватного ключа, хранимая одной MPC-стороной. По отдельной доле невозможно ни восстановить ключ, ни подделать подпись. Доли распределяются при активации workspace и пересчитываются при добавлении новых подписантов (без изменения публичного ключа).

Keygen / Sign / Refresh

Основные операции MPC: Keygen создаёт корневые ключи при активации workspace, Sign подписывает операцию, Refresh обновляет доли с сохранением публичного ключа. Создание каждого vault не запускает Keygen.

Threshold (порог)

t-of-n — минимальное число долей, нужное для подписи. В типовой конфигурации Pert схема — 2-of-3: две доли на стороне Pert (в защищённой серверной среде) и одна доля на стороне клиента — либо на headless-устройстве Co-Signer, либо в мобильном приложении Pert Mobile у пользователя-подписанта.

Подписант (signer)

Пользователь workspace с правом подписи и привязанным устройством. Технически — владелец одной MPC-доли. На стадии подписания получает запрос «подписать транзакцию» на своё устройство и подтверждает операцию вручную (Pert Mobile) или автоматически по политикам (Co-Signer).

Sighash

Хэш payload транзакции, который непосредственно подписывается. Для EVM/TRON — один хэш на транзакцию; для BTC — по одному на каждый UTXO-вход.

Derivation (HD path)

Путь получения дочернего ключа из корневого. Алгоритм зависит от кривой и сети. MPC-участники вычисляют подпись для дочернего ключа, не собирая полный корневой приватный ключ.

Backup ключей

Экспорт зашифрованных MPC-долей в файл, который владелец может хранить у себя. Шифруется на публичный ключ из desktop-приложения Pert Backup и используется для восстановления при потере устройств-подписантов.


Транзакции

Transaction (транзакция)

Учётная запись об исходящем выводе средств (withdrawal) или входящем зачислении (deposit). Хранит источник, назначение, актив, сумму, статус и историю переходов.

Withdrawal

Исходящая транзакция: создаётся вашим приложением через POST /transaction, проходит проверку политик и AML, после аппрувов подписывается по MPC и отправляется в блокчейн.

Deposit

Входящая on-chain транзакция, обнаруженная Pert на одном из адресов workspace. Создаётся сразу с финальным статусом — никаких аппрувов и подписей со стороны клиента не требуется.

Статусы транзакции

Жизненный цикл исходящей транзакции описывается набором статусов (pending, awaiting_approvals, approved, awaiting_broadcast, broadcast, finished, declined, frozen и т. п.) — схема и описание этапов в Жизненном цикле транзакции. Текущий статус и история переходов доступны через REST API и приходят событиями в webhooks.

Approval (аппрув)

Подтверждение исходящей транзакции одним из назначенных аппруверов. Подписывается устройством аппрувера. Сколько и каких аппрувов нужно — определяет политика workspace.

Approval set / quorum

Набор аппруверов, из которых нужно собрать t подписей для пропуска транзакции. Политика может требовать нескольких независимых наборов (например, «2-of-3 финансистов и 1-of-2 руководителей»).

Согласование изменений (change approval)

Одобрение подтверждающими административного изменения в рабочем пространстве — пользователей, групп, тегов, белого списка, разрешения one-time переводов, политик и самих правил согласования — до его применения. В отличие от аппрува транзакции задаётся правилом на действие, а не политикой: подтверждающие — владелец, администраторы кворума или выбранная группа — голосуют на привязанном устройстве. См. Согласование изменений.

Запрос на согласование (change request)

Заявка на одно изменение, в API — request_uuid: что меняется, кто подтверждает, голоса и статус. Запрос в работе — ждёт подтверждений (PENDING) или подтверждён и применяется (APPROVED); пока он есть, другое изменение того же объекта не принимается.

Подтверждающий

Участник запроса на согласование, который вправе подтвердить или отклонить изменение с привязанного устройства: владелец, администратор кворума или участник группы — по правилу действия. Состав подтверждающих фиксируется при создании запроса и дальше только сокращается.

Администратор кворума

Пользователь, которого владелец назначил подтверждать изменения в режиме «Кворум администраторов»; назначить можно администратора, в том числе неподписывающего. Подтверждает, пока остаётся администратором и вправе подтверждать; роль администратора без назначения в состав не вводит. См. Администраторы кворума.

Выбывший

Подтверждающий, который после создания запроса потерял право подтверждать: сменилась роль, его убрали из группы или сняли с назначения администратором кворума, отвязано последнее устройство, пользователь заблокирован. Исключается из запроса при ближайшем голосе, повторной отправке того же изменения или другом изменении того же объекта; его голос не засчитывается, и вернув право, он в запрос не возвращается. См. Кто подтверждает.

Версия настроек кворума

Настройки кворума рабочего пространства целиком — порог администраторов, правила, состав групп из правил и администраторы кворума, — которые владелец подписал на своём устройстве. Отпечаток версии — восемь групп по четыре шестнадцатеричных символа; владелец сверяет его в консоли и в приложении. См. Сверка настроек кворума.

Инициатор

Пользователь, чьё действие породило запрос на согласование. Подтверждает его наравне с остальными, если входит в состав подтверждающих; при одобрении его право на изменение проверяется заново.

Описание изменения (changes)

«Было → стало» в карточке запроса на момент его создания; summary — однострочная сводка, changes_hash — отпечаток описания, который устройство подтверждает вместе с голосом.

Freeze / Unfreeze

AML может заморозить исходящую транзакцию или vault при рискованном депозите. Заморозка vault запрещает исходящие операции. Разморозка транзакции возобновляет pipeline со следующей стадии. См. Жизненный цикл.

Broadcast

Отправка подписанной транзакции в блокчейн. После broadcast транзакция считается отправленной; финализация наступает после подтверждения сетью (см. Reconciliation).

Reconciliation

Сверка статуса транзакции в блокчейне с локальным состоянием Pert. По факту достаточного числа сетевых подтверждений транзакция финализируется (finished) либо отклоняется (declined).

Idempotency-Key

Заголовок X-Idempotency-Key на POST /transaction: уникальный ключ запроса. Повтор с тем же ключом возвращает ошибку конфликта HTTP 409 — это позволяет безопасно ретраить запросы.


Политики и AML

Policy (политика)

Правило обработки транзакций, заданное на уровне workspace. Описывает условия (источник, назначение, сумма, частота, актив) и действие (allow / require approval / block). Подробнее — Политики.

Transfer policy

Подкласс политик, оценивающих исходящие транзакции. Может ссылаться на vault, whitelisted-кошельки и one-time адреса — например, «выводы на whitelisted из vault payouts до 10 000 USD/сутки проходят без аппрува, всё остальное — с аппрувом 2-of-3». См. Transfer-политики.

AML rule (pre-screening / post-screening)

Правило AML-провайдера, делящееся на:

  • Pre-screening — локальная проверка адреса назначения до вызова провайдера, позволяет сэкономить запросы. См. AML pre-screening.
  • Post-screening — обработка результата провайдера, в том числе автоматическая заморозка vault при рискованном входящем депозите. См. AML post-screening.

Limit / Timeframe

Накопительный порог суммы операций за окно времени. Незавершённые транзакции могут резервировать сумму; при failed, declined, expired или dropped_by_platform обработчик событий освобождает резерв. Завершённые операции учитываются до выхода из окна. См. Transfer.

Approval requirement

Запись о том, какие аппруверы и в каком количестве должны подписать конкретную транзакцию. Формируется по политикам workspace в момент оценки транзакции.


Интеграция

Webhook

HTTP-callback на ваш URL: Pert отправляет события о создании транзакции, смене статуса, депозите и других изменениях. Доставка использует повторные попытки. Получатель проверяет подпись, чтобы вы могли убедиться в подлинности уведомления. Можно повторно проиграть пропущенные события через replay. См. Webhooks.

Подпись webhook

Криптографическая подпись тела события, передаваемая в HTTP-заголовке. Позволяет вашему приложению удостовериться, что событие пришло от Pert и не было изменено. См. Подпись webhook.

Replay (повторное проигрывание)

Механизм повторной отправки сохранённых webhook-событий за выбранный интервал. Используется при сбое на стороне получателя в пределах срока хранения и правил replay. См. Replay.


Приложения Pert

Pert Console

Web-интерфейс клиента: управление workspace, vault, кошельками, политиками, аппрувами, whitelist'ом, пользователями и API-пользователями.

Pert Mobile

Мобильное приложение пользователя workspace. Вручную владельцем устройства подтверждает подписание (у подписанта хранит долю MPC-ключа), аппрувы транзакций и согласование изменений — последняя линия обороны некастодиальной модели.

Co-Signer

Headless-устройство клиента, разворачиваемое на собственной инфраструктуре. В отличие от Pert Mobile действует автоматически на основании политик — используется для API-интеграций и высокочастотных операций без участия человека на каждой подписи.

Pert Backup

Приложение для подготовки ключа восстановления и восстановления MPC-долей. Публичный ключ передаётся платформе для шифрования долей; приватный ключ восстановления остаётся у владельца. См. Резервные копии.