@v3finance/monitoring-sdk 0.0.0-stage → 0.1.0

package/dist/cjs/resources/clients.d.ts

@@ -0,0 +1,84 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import { type Page } from '../core/pagination.js';
+import type { ApiKey, Client, IssueKeyRequest, IssuedKey, Member, TestWebhookRequest, TestWebhookResult } from '../generated/types.js';
+export interface ListClientsParams {
+    /** Размер страницы, до 1000; по умолчанию 100 */
+    limit?: number;
+    /** Курсор: `next` прошлой страницы */
+    after?: string;
+}
+/** Что изменить у клиента; не переданное не меняется */
+export interface UpdateClientParams {
+    /** Название; `null` — убрать */
+    name?: string | null;
+    /** URL вебхука: только https, без логина и пароля */
+    webhookUrl?: string;
+}
+export interface RotateSecretParams {
+    /** Свой секрет (от 16 символов); без него — сгенерируется */
+    secretKey?: string;
+}
+export interface RotateSecretResult {
+    /** Новый секрет подписи вебхуков — показывается один раз, сохраните его */
+    secretKey: string;
+}
+/** Ключи клиента: доступ к адресам, истории и транзакциям этого клиента. Управляют owner и admin клиента */
+export declare class ClientKeysResource {
+    #private;
+    constructor(http: HttpClient);
+    /** Ключи клиента (без самих ключей — только начало) */
+    list(clientId: string, options?: RequestOptions): Promise<ApiKey[]>;
+    /**
+     * Выпускает ключ клиента. Полный ключ — в `key`, показывается один раз.
+     *
+     * @example
+     * ```ts
+     * const { key } = await monitoring.clients.keys.create(clientId, { name: 'backend', expiresInDays: 365 })
+     * ```
+     */
+    create(clientId: string, params?: IssueKeyRequest, options?: RequestOptions): Promise<IssuedKey>;
+    /** Отзывает ключ — он перестаёт работать сразу */
+    revoke(clientId: string, keyId: string, options?: RequestOptions): Promise<void>;
+}
+/**
+ * Ваш клиент: URL вебхука, секрет подписи, ключи, участники, тестовый вебхук.
+ *
+ * Права: смотреть — любой участник и ключ клиента; менять — owner и admin клиента по сессии или личному ключу.
+ */
+export declare class ClientsResource {
+    #private;
+    /** Ключи клиента */
+    readonly keys: ClientKeysResource;
+    constructor(http: HttpClient);
+    /** Страница ваших клиентов: где вы участник; для ключа клиента — он сам */
+    list(params?: ListClientsParams, options?: RequestOptions): Promise<Page<Client, string>>;
+    /** Все ваши клиенты — страница за страницей */
+    iterate(params?: Omit<ListClientsParams, 'after'>, options?: RequestOptions): AsyncGenerator<Client, void, undefined>;
+    get(clientId: string, options?: RequestOptions): Promise<Client>;
+    /**
+     * Меняет название или URL вебхука.
+     *
+     * @example
+     * ```ts
+     * await monitoring.clients.update(clientId, { webhookUrl: 'https://example.com/webhooks/monitoring' })
+     * ```
+     */
+    update(clientId: string, params: UpdateClientParams, options?: RequestOptions): Promise<Client>;
+    /** Новый секрет подписи вебхуков. Старый перестаёт действовать сразу — обновите его у себя до следующего вебхука */
+    rotateSecret(clientId: string, params?: RotateSecretParams, options?: RequestOptions): Promise<RotateSecretResult>;
+    /**
+     * Отправляет тестовый вебхук на URL клиента и возвращает результат: доставлен ли, ваш ответ, подпись и точное
+     * тело. Тестовый вебхук помечен `"test": true` и заголовком `x-webhook-test: 1` — не зачисляйте его.
+     * Не больше 10 в минуту.
+     *
+     * @example
+     * ```ts
+     * const r = await monitoring.clients.sendTestWebhook(clientId, { asset: 'USDT' })
+     * if (!r.delivery.ok) console.log('ваш сервер ответил', r.delivery.status ?? r.delivery.error)
+     * ```
+     */
+    sendTestWebhook(clientId: string, params?: TestWebhookRequest, options?: RequestOptions): Promise<TestWebhookResult>;
+    /** Участники клиента и их роли */
+    members(clientId: string, options?: RequestOptions): Promise<Member[]>;
+}
+//# sourceMappingURL=clients.d.ts.map

package/dist/cjs/resources/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../../src/resources/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEtI,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,4GAA4G;AAC5G,qBAAa,kBAAkB;;IAE7B,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED,uDAAuD;IACjD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGxE;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,eAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAEnG;IAED,kDAAkD;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;CACF;AAED;;;;GAIG;AACH,qBAAa,eAAe;;IAE1B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IAEjC,YAAY,IAAI,EAAE,UAAU,EAG3B;IAED,2EAA2E;IAC3E,IAAI,CAAC,MAAM,GAAE,iBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE5F;IAED,+CAA+C;IAC/C,OAAO,CAAC,MAAM,GAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAExH;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/D;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9F;IAED,oHAAoH;IACpH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAErH;IAED;;;;;;;;;;OAUG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAUvH;IAED,kCAAkC;IAC5B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG3E;CACF"}

package/dist/cjs/resources/clients.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientsResource = exports.ClientKeysResource = void 0;
+const http_js_1 = require("../core/http.js");
+const pagination_js_1 = require("../core/pagination.js");
+/** Ключи клиента: доступ к адресам, истории и транзакциям этого клиента. Управляют owner и admin клиента */
+class ClientKeysResource {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    /** Ключи клиента (без самих ключей — только начало) */
+    async list(clientId, options) {
+        const r = await this.#http.request({ method: 'GET', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/keys`, idempotent: true, options });
+        return r.items;
+    }
+    /**
+     * Выпускает ключ клиента. Полный ключ — в `key`, показывается один раз.
+     *
+     * @example
+     * ```ts
+     * const { key } = await monitoring.clients.keys.create(clientId, { name: 'backend', expiresInDays: 365 })
+     * ```
+     */
+    create(clientId, params = {}, options) {
+        return this.#http.request({ method: 'POST', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/keys`, body: params, idempotent: false, options });
+    }
+    /** Отзывает ключ — он перестаёт работать сразу */
+    async revoke(clientId, keyId, options) {
+        await this.#http.request({ method: 'DELETE', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/keys/${(0, http_js_1.seg)(keyId)}`, idempotent: true, options });
+    }
+}
+exports.ClientKeysResource = ClientKeysResource;
+/**
+ * Ваш клиент: URL вебхука, секрет подписи, ключи, участники, тестовый вебхук.
+ *
+ * Права: смотреть — любой участник и ключ клиента; менять — owner и admin клиента по сессии или личному ключу.
+ */
+class ClientsResource {
+    #http;
+    /** Ключи клиента */
+    keys;
+    constructor(http) {
+        this.#http = http;
+        this.keys = new ClientKeysResource(http);
+    }
+    /** Страница ваших клиентов: где вы участник; для ключа клиента — он сам */
+    list(params = {}, options) {
+        return this.#http.request({ method: 'GET', path: '/v1/clients', query: { ...params }, idempotent: true, options });
+    }
+    /** Все ваши клиенты — страница за страницей */
+    iterate(params = {}, options) {
+        return (0, pagination_js_1.paginate)((after) => this.list({ ...params, after }, options));
+    }
+    get(clientId, options) {
+        return this.#http.request({ method: 'GET', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}`, idempotent: true, options });
+    }
+    /**
+     * Меняет название или URL вебхука.
+     *
+     * @example
+     * ```ts
+     * await monitoring.clients.update(clientId, { webhookUrl: 'https://example.com/webhooks/monitoring' })
+     * ```
+     */
+    update(clientId, params, options) {
+        return this.#http.request({ method: 'PATCH', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}`, body: params, idempotent: true, options });
+    }
+    /** Новый секрет подписи вебхуков. Старый перестаёт действовать сразу — обновите его у себя до следующего вебхука */
+    rotateSecret(clientId, params = {}, options) {
+        return this.#http.request({ method: 'POST', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/secret`, body: params, idempotent: false, options });
+    }
+    /**
+     * Отправляет тестовый вебхук на URL клиента и возвращает результат: доставлен ли, ваш ответ, подпись и точное
+     * тело. Тестовый вебхук помечен `"test": true` и заголовком `x-webhook-test: 1` — не зачисляйте его.
+     * Не больше 10 в минуту.
+     *
+     * @example
+     * ```ts
+     * const r = await monitoring.clients.sendTestWebhook(clientId, { asset: 'USDT' })
+     * if (!r.delivery.ok) console.log('ваш сервер ответил', r.delivery.status ?? r.delivery.error)
+     * ```
+     */
+    sendTestWebhook(clientId, params = {}, options) {
+        return this.#http.request({
+            method: 'POST',
+            path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/webhooks/test`,
+            body: params,
+            idempotent: false,
+            // 502 — «не доставлен»: это результат проверки, а не ошибка запроса
+            acceptStatuses: [502],
+            options,
+        });
+    }
+    /** Участники клиента и их роли */
+    async members(clientId, options) {
+        const r = await this.#http.request({ method: 'GET', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/members`, idempotent: true, options });
+        return r.items;
+    }
+}
+exports.ClientsResource = ClientsResource;
+//# sourceMappingURL=clients.js.map

package/dist/cjs/resources/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../../src/resources/clients.ts"],"names":[],"mappings":"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"}

package/dist/cjs/resources/deliveries.d.ts

@@ -0,0 +1,50 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import { type Page } from '../core/pagination.js';
+import type { Delivery, DeliveryDetail, DeliveryStatus } from '../generated/types.js';
+/** Фильтры истории; все необязательны и сочетаются */
+export interface DeliveryFilter {
+    /** `delivered` — вы ответили 2xx, `retrying` — будет повтор, `failed` — повторы исчерпаны */
+    status?: DeliveryStatus;
+    /** Сеть: slug или CAIP-2 */
+    network?: string;
+    /** Символ актива */
+    asset?: string;
+    /** Хеш транзакции */
+    tx?: string;
+    /** Отправитель или получатель */
+    address?: string;
+    /** Первая попытка не раньше (дата или время) */
+    since?: Date | string;
+    /** Первая попытка раньше (не включая) */
+    until?: Date | string;
+}
+export interface ListDeliveriesParams extends DeliveryFilter {
+    /** Размер страницы, до 500; по умолчанию 100 */
+    limit?: number;
+    /** Курсор: `next` прошлой страницы */
+    before?: number;
+}
+/**
+ * История вебхуков клиента: что, когда и куда отправлено, сколько было попыток и что вы ответили.
+ * Повторы одного вебхука — одна запись. Хранится 90 дней.
+ */
+export declare class DeliveriesResource {
+    #private;
+    constructor(http: HttpClient);
+    /**
+     * Страница истории, новые сверху.
+     *
+     * @example
+     * ```ts
+     * const { items } = await monitoring.deliveries.list(clientId, { status: 'failed', since: new Date(Date.now() - 86_400_000) })
+     * ```
+     */
+    list(clientId: string, params?: ListDeliveriesParams, options?: RequestOptions): Promise<Page<Delivery, number>>;
+    /** Вся история по фильтру — от новых к старым, страница за страницей */
+    iterate(clientId: string, filter?: DeliveryFilter & {
+        limit?: number;
+    }, options?: RequestOptions): AsyncGenerator<Delivery, void, undefined>;
+    /** Одна запись с URL последней попытки и точным телом запроса */
+    get(clientId: string, deliveryId: number, options?: RequestOptions): Promise<DeliveryDetail>;
+}
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/cjs/resources/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../../src/resources/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErF,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,qBAAa,kBAAkB;;IAE7B,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAQnH;IAED,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAE/I;IAED,iEAAiE;IACjE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAE3F;CACF"}

package/dist/cjs/resources/deliveries.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveriesResource = void 0;
+const http_js_1 = require("../core/http.js");
+const pagination_js_1 = require("../core/pagination.js");
+const iso = (v) => (v instanceof Date ? v.toISOString() : v);
+/**
+ * История вебхуков клиента: что, когда и куда отправлено, сколько было попыток и что вы ответили.
+ * Повторы одного вебхука — одна запись. Хранится 90 дней.
+ */
+class DeliveriesResource {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * Страница истории, новые сверху.
+     *
+     * @example
+     * ```ts
+     * const { items } = await monitoring.deliveries.list(clientId, { status: 'failed', since: new Date(Date.now() - 86_400_000) })
+     * ```
+     */
+    list(clientId, params = {}, options) {
+        return this.#http.request({
+            method: 'GET',
+            path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/deliveries`,
+            query: { ...params, since: iso(params.since), until: iso(params.until) },
+            idempotent: true,
+            options,
+        });
+    }
+    /** Вся история по фильтру — от новых к старым, страница за страницей */
+    iterate(clientId, filter = {}, options) {
+        return (0, pagination_js_1.paginate)((before) => this.list(clientId, { ...filter, before }, options));
+    }
+    /** Одна запись с URL последней попытки и точным телом запроса */
+    get(clientId, deliveryId, options) {
+        return this.#http.request({ method: 'GET', path: `/v1/clients/${(0, http_js_1.seg)(clientId)}/deliveries/${(0, http_js_1.seg)(deliveryId)}`, idempotent: true, options });
+    }
+}
+exports.DeliveriesResource = DeliveriesResource;
+//# sourceMappingURL=deliveries.js.map

package/dist/cjs/resources/deliveries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.js","sourceRoot":"","sources":["../../../src/resources/deliveries.ts"],"names":[],"mappings":";;;AAAA,6CAA2E;AAC3E,yDAA2D;AA4B3D,MAAM,GAAG,GAAG,CAAC,CAA4B,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvF;;;GAGG;AACH;IACW,KAAK,CAAY;IAC1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,QAAgB,EAAE,MAAM,GAAyB,EAAE,EAAE,OAAwB;QAChF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,IAAA,aAAG,EAAC,QAAQ,CAAC,aAAa;YAC/C,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACxE,UAAU,EAAE,IAAI;YAChB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED,wEAAwE;IACxE,OAAO,CAAC,QAAgB,EAAE,MAAM,GAAwC,EAAE,EAAE,OAAwB;QAClG,OAAO,IAAA,wBAAQ,EAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACpG,CAAC;IAED,iEAAiE;IACjE,GAAG,CAAC,QAAgB,EAAE,UAAkB,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,IAAA,aAAG,EAAC,QAAQ,CAAC,eAAe,IAAA,aAAG,EAAC,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAC7I,CAAC;CACF"}

package/dist/cjs/resources/transactions.d.ts

@@ -0,0 +1,28 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import type { Transaction } from '../generated/types.js';
+/** Любая транзакция сети по хешу — не только те, о которых пришёл вебхук */
+export declare class TransactionsResource {
+    #private;
+    constructor(http: HttpClient);
+    /**
+     * Статус, блок, подтверждения, финальность, комиссия и все переводы внутри транзакции; для ваших адресов —
+     * направление и вебхуки, которые мы по ней отправили.
+     *
+     * `final: true` — транзакцию уже не отменить: в TRON блок солидифицирован (около минуты), в EVM —
+     * финализирован (Ethereum — около 13 минут). Крупные суммы зачисляйте после `final`.
+     *
+     * Не больше 60 запросов в минуту на ключ; при превышении SDK подождёт и повторит.
+     *
+     * @param network - slug (`tron`, `ethereum`) или CAIP-2
+     * @param hash - EVM — `0x` + 64 hex; TRON — 64 hex (можно с `0x`)
+     * @throws {@link MonitoringApiError} 404 — такой транзакции в сети нет
+     *
+     * @example
+     * ```ts
+     * const tx = await monitoring.transactions.get('tron', webhook.tx.id)
+     * if (tx.status === 'success' && tx.final) credit(webhook)
+     * ```
+     */
+    get(network: string, hash: string, options?: RequestOptions): Promise<Transaction>;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/cjs/resources/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,4EAA4E;AAC5E,qBAAa,oBAAoB;;IAE/B,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAEjF;CACF"}

package/dist/cjs/resources/transactions.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionsResource = void 0;
+const http_js_1 = require("../core/http.js");
+/** Любая транзакция сети по хешу — не только те, о которых пришёл вебхук */
+class TransactionsResource {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * Статус, блок, подтверждения, финальность, комиссия и все переводы внутри транзакции; для ваших адресов —
+     * направление и вебхуки, которые мы по ней отправили.
+     *
+     * `final: true` — транзакцию уже не отменить: в TRON блок солидифицирован (около минуты), в EVM —
+     * финализирован (Ethereum — около 13 минут). Крупные суммы зачисляйте после `final`.
+     *
+     * Не больше 60 запросов в минуту на ключ; при превышении SDK подождёт и повторит.
+     *
+     * @param network - slug (`tron`, `ethereum`) или CAIP-2
+     * @param hash - EVM — `0x` + 64 hex; TRON — 64 hex (можно с `0x`)
+     * @throws {@link MonitoringApiError} 404 — такой транзакции в сети нет
+     *
+     * @example
+     * ```ts
+     * const tx = await monitoring.transactions.get('tron', webhook.tx.id)
+     * if (tx.status === 'success' && tx.final) credit(webhook)
+     * ```
+     */
+    get(network, hash, options) {
+        return this.#http.request({ method: 'GET', path: `/v1/networks/${(0, http_js_1.seg)(network)}/transactions/${(0, http_js_1.seg)(hash)}`, idempotent: true, options });
+    }
+}
+exports.TransactionsResource = TransactionsResource;
+//# sourceMappingURL=transactions.js.map

package/dist/cjs/resources/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":";;;AAAA,6CAA2E;AAG3E,4EAA4E;AAC5E;IACW,KAAK,CAAY;IAC1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,OAAe,EAAE,IAAY,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,IAAA,aAAG,EAAC,OAAO,CAAC,iBAAiB,IAAA,aAAG,EAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACzI,CAAC;CACF"}

package/dist/cjs/units.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Суммы в API и вебхуках — строки в минимальных единицах (sun, wei; у USDT 6 знаков после запятой): uint256 не
+ * помещается в `number`. Эти функции переводят их в привычный вид и обратно без потери точности.
+ * Знаки после запятой актива — `decimals` из `monitoring.assets.list()`.
+ */
+/**
+ * Минимальные единицы → строка в монетах.
+ *
+ * @example
+ * ```ts
+ * formatUnits('100000000', 6)            // '100'     — 100 USDT
+ * formatUnits('1500000', 6)              // '1.5'
+ * formatUnits('10090000000000000', 18)   // '0.01009' — ETH
+ * ```
+ */
+export declare function formatUnits(value: string | bigint, decimals: number): string;
+/**
+ * Строка в монетах → минимальные единицы.
+ *
+ * @throws RangeError — больше знаков после запятой, чем у актива, или не число
+ *
+ * @example
+ * ```ts
+ * parseUnits('1.5', 6)   // '1500000'
+ * parseUnits('100', 6)   // '100000000'
+ * ```
+ */
+export declare function parseUnits(amount: string, decimals: number): string;
+//# sourceMappingURL=units.d.ts.map

package/dist/cjs/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnE"}

package/dist/cjs/units.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Суммы в API и вебхуках — строки в минимальных единицах (sun, wei; у USDT 6 знаков после запятой): uint256 не
+ * помещается в `number`. Эти функции переводят их в привычный вид и обратно без потери точности.
+ * Знаки после запятой актива — `decimals` из `monitoring.assets.list()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUnits = formatUnits;
+exports.parseUnits = parseUnits;
+const INTEGER = /^-?\d+$/;
+const DECIMAL = /^(\d+)(?:\.(\d+))?$/;
+/**
+ * Минимальные единицы → строка в монетах.
+ *
+ * @example
+ * ```ts
+ * formatUnits('100000000', 6)            // '100'     — 100 USDT
+ * formatUnits('1500000', 6)              // '1.5'
+ * formatUnits('10090000000000000', 18)   // '0.01009' — ETH
+ * ```
+ */
+function formatUnits(value, decimals) {
+    assertDecimals(decimals);
+    const raw = typeof value === 'bigint' ? value.toString() : value.trim();
+    if (!INTEGER.test(raw))
+        throw new RangeError(`formatUnits: integer in minimal units expected, got ${JSON.stringify(value)}`);
+    const negative = raw.startsWith('-');
+    const digits = (negative ? raw.slice(1) : raw).replace(/^0+(?=\d)/, '');
+    if (decimals === 0)
+        return (negative && digits !== '0' ? '-' : '') + digits;
+    const padded = digits.padStart(decimals + 1, '0');
+    const whole = padded.slice(0, -decimals);
+    const fraction = padded.slice(-decimals).replace(/0+$/, '');
+    const sign = negative && (whole !== '0' || fraction) ? '-' : '';
+    return `${sign}${whole}${fraction ? `.${fraction}` : ''}`;
+}
+/**
+ * Строка в монетах → минимальные единицы.
+ *
+ * @throws RangeError — больше знаков после запятой, чем у актива, или не число
+ *
+ * @example
+ * ```ts
+ * parseUnits('1.5', 6)   // '1500000'
+ * parseUnits('100', 6)   // '100000000'
+ * ```
+ */
+function parseUnits(amount, decimals) {
+    assertDecimals(decimals);
+    const m = DECIMAL.exec(amount.trim());
+    if (!m)
+        throw new RangeError(`parseUnits: non-negative decimal expected, got ${JSON.stringify(amount)}`);
+    const fraction = m[2] ?? '';
+    if (fraction.length > decimals)
+        throw new RangeError(`parseUnits: ${amount} has more than ${decimals} decimal places`);
+    return BigInt(m[1] + fraction.padEnd(decimals, '0')).toString();
+}
+function assertDecimals(decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 255)
+        throw new RangeError(`decimals: integer 0..255 expected, got ${decimals}`);
+}
+//# sourceMappingURL=units.js.map

package/dist/cjs/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,MAAM,OAAO,GAAG,SAAS,CAAA;AACzB,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAErC;;;;;;;;;GASG;AACH,qBAA4B,KAAsB,EAAE,QAAgB;IAClE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACvE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,uDAAuD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC5H,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACvE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAA;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC3D,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/D,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,oBAA2B,MAAc,EAAE,QAAgB;IACzD,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kDAAkD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxG,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,MAAM,kBAAkB,QAAQ,iBAAiB,CAAC,CAAA;IACtH,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAA;AAC/I,CAAC"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,5 @@
+/** Версия SDK: уходит в заголовке `user-agent`. Тест сверяет её с package.json */
+export declare const SDK_VERSION = "0.1.0";
+/** Адрес API по умолчанию */
+export declare const DEFAULT_BASE_URL = "https://monitoring.v3.finance";
+//# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,kCAAkC,CAAA"}

package/dist/cjs/version.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BASE_URL = exports.SDK_VERSION = void 0;
+/** Версия SDK: уходит в заголовке `user-agent`. Тест сверяет её с package.json */
+exports.SDK_VERSION = '0.1.0';
+/** Адрес API по умолчанию */
+exports.DEFAULT_BASE_URL = 'https://monitoring.v3.finance';
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,kFAAkF;AACrE,QAAA,WAAW,GAAG,OAAO,CAAA;AAElC,6BAA6B;AAChB,QAAA,gBAAgB,GAAG,+BAA+B,CAAA"}

package/dist/cjs/webhooks.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Приём вебхуков: проверка подписи и разбор тела. Работает без клиента API и без сети — нужен только секрет
+ * подписи клиента. Использует WebCrypto: Node.js 20+, Bun, Deno, Cloudflare Workers.
+ */
+import type { WebhookPayload } from './generated/types.js';
+/** Заголовки вебхука */
+export declare const WEBHOOK_HEADERS: {
+    /** HMAC-SHA256 сырого тела секретом клиента, hex в нижнем регистре */
+    readonly signature: 'x-signature';
+    /** id клиента */
+    readonly clientId: 'x-client-id';
+    /** `1` у тестового вебхука — такой не зачислять */
+    readonly test: 'x-webhook-test';
+};
+/**
+ * Тело вебхука ровно как пришло — сырые байты или строка. Не `JSON.parse` + `JSON.stringify`: подпись считается
+ * по исходным байтам, и любое переформатирование её ломает.
+ */
+export type WebhookBody = string | Uint8Array | ArrayBuffer;
+/**
+ * Откуда взять подпись: значение заголовка `x-signature` или все заголовки запроса — Fetch `Headers`
+ * (Hono, Next.js, Workers) или объект Node.js (`req.headers` в Express, Fastify).
+ */
+export type SignatureSource = string | null | undefined | Headers | Record<string, string | string[] | undefined>;
+/**
+ * Подпись тела секретом клиента — как её считает сервис. Нужна в тестах вашего обработчика вебхуков.
+ *
+ * @example
+ * ```ts
+ * const body = JSON.stringify({ tx: { …, id: 'test' } })
+ * await fetch('http://localhost:3000/webhooks', { method: 'POST', body, headers: { 'x-signature': await signWebhookBody(body, secret) } })
+ * ```
+ */
+export declare function signWebhookBody(body: WebhookBody, secret: string): Promise<string>;
+/**
+ * Проверяет подпись вебхука: `true` — тело пришло от сервиса и не изменено.
+ *
+ * @param body - сырое тело запроса
+ * @param signature - заголовок `x-signature` или все заголовки запроса
+ * @param secret - секрет подписи клиента
+ */
+export declare function verifyWebhookSignature(body: WebhookBody, signature: SignatureSource, secret: string): Promise<boolean>;
+/**
+ * Проверяет подпись и возвращает разобранный вебхук.
+ *
+ * Дальше — по правилам приёма: тестовый вебхук ({@link isTestWebhook}) не зачислять; один и тот же вебхук может
+ * прийти повторно — обрабатывайте идемпотентно по {@link webhookIdempotencyKey}; ответьте 2xx в течение 15 секунд.
+ * Вебхук уходит, как только перевод попал в блок, — для крупных сумм дождитесь финальности
+ * (`monitoring.transactions.get(...).final`).
+ *
+ * @throws {@link WebhookSignatureError} подпись не совпала — ответьте 401 и ничего не зачисляйте
+ *
+ * @example Express — нужен сырой body
+ * ```ts
+ * app.post('/webhooks/monitoring', express.raw({ type: 'application/json' }), async (req, res) => {
+ *   const event = await parseWebhook(req.body, req.headers, process.env.MONITORING_WEBHOOK_SECRET!)
+ *   if (!isTestWebhook(event)) await creditOnce(webhookIdempotencyKey(event), event.tx)
+ *   res.sendStatus(200)
+ * })
+ * ```
+ *
+ * @example Hono, Next.js route handler, Cloudflare Workers
+ * ```ts
+ * const event = await parseWebhook(await request.text(), request.headers, env.MONITORING_WEBHOOK_SECRET)
+ * ```
+ */
+export declare function parseWebhook(body: WebhookBody, signature: SignatureSource, secret: string): Promise<WebhookPayload>;
+/** Тестовый вебхук (из панели или `clients.sendTestWebhook`) — такой не зачислять */
+export declare function isTestWebhook(event: WebhookPayload): boolean;
+/**
+ * Ключ идемпотентности вебхука: сеть, транзакция и номер лога. Один перевод — один ключ, даже если вебхук пришёл
+ * несколько раз. В одной транзакции EVM может быть несколько переводов токенов — у них разный `logIndex`.
+ *
+ * @example `"TRON:1249cb…a5fc45:"`, `"ETHEREUM:0x3fbc…1d57:7"`
+ */
+export declare function webhookIdempotencyKey(event: WebhookPayload): string;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/cjs/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,wBAAwB;AACxB,eAAO,MAAM,eAAe;IAC1B,sEAAsE;aACtE,SAAS,EAAE,aAAa;IACxB,iBAAiB;aACjB,QAAQ,EAAE,aAAa;IACvB,mDAAmD;aACnD,IAAI,EAAE,gBAAgB;CACd,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;AAE3D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;AA0BjH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxF;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5H;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAWzH;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEnE"}