Глоссарий
Справочник терминов, которые встречаются в документации, 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-долей. Публичный ключ передаётся платформе для шифрования долей; приватный ключ восстановления остаётся у владельца. См. Резервные копии.