AddressesСоздать адрес

Создать адрес

Полный flow создания адреса:

  1. Расчёт следующего pathIndex для комбинации сегментов (SQL MAX, retry при конкурентном конфликте)
  2. Сборка канонического derivation path
  3. evaluatePolicy (action=create_address) — 403 при deny/block, 202 + id заявки при requireApproval (создание ушло на подпись)
  4. Wallet Service /wallet/raw_address — получение on-chain адреса
  5. Запись Address + синхронная регистрация в tron-events мониторинге; при сбое мониторинга адрес откатывается (всё или ничего)
curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "networkCode": "tron_network",
  "staticSegments": {
    "app_id": "otc_app",
    "purpose": "invoices",
    "asset": "usdt",
    "stage": "prod"
  },
  "label": "example_string",
  "description": "example_string",
  "tags": [
    "example_string"
  ],
  "logoUri": "example_string",
  "color": "#000",
  "emoji": "💳",
  "groupId": "example_string"
}'
{
  "address": {
    "id": "cmr3f41z20001psp7phmyapw3",
    "address": "123 Main St",
    "derivationPath": "example_string",
    "network": "example_string",
    "pathIndex": 42,
    "label": "example_string",
    "description": "example_string"
  }
}
POST
/api/v1/vaults/{code}/addresses
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

better-auth session token. Мобилка/сервисы. Веб использует cookie.

better-auth session token. Мобилка/сервисы. Веб использует cookie.
API Key (cookie: better-auth.session_token)
path
codestring
Required

Уникальный код Vault'а (slug)

Content-Typestring
Required

The media type of the request body

Options: application/json
staticSegmentsobject
Required

Route.code → variant code для всех static-сегментов

logoUristring

Ссылка на логотип адреса

Format: uri • Max length: 2048
colorstring

HEX-цвет

Pattern: ^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$
emojistring

Emoji-иконка

Min length: 1 • Max length: 16
groupIdstring

Создать адрес В группу адресов (нужно право create_address на группе). Новый адрес — member группы, доступен её участникам

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. better-auth session token. Мобилка/сервисы. Веб использует cookie.

path
parameterstring
Required

API Key for authentication. Provide your API key in the cookie.

Path Parameters

codestring
Required

Уникальный код Vault'а (slug)

Example:
demo_vault

Body

application/json
networkCodestring
Required
Example:
tron_network
staticSegmentsobject
Required

Route.code → variant code для всех static-сегментов

Example:
{"app_id":"otc_app","purpose":"invoices","asset":"usdt","stage":"prod"}
logoUristring

Ссылка на логотип адреса

colorstring

HEX-цвет

Example:
#000
emojistring

Emoji-иконка

Example:
💳
groupIdstring

Создать адрес В группу адресов (нужно право create_address на группе). Новый адрес — member группы, доступен её участникам

Responses