@v3finance/monitoring-sdk 0.0.0-stage → 0.2.0

package/dist/esm/generated/types.d.ts

@@ -0,0 +1,336 @@
+export interface ApiErrorBody {
+    error: {
+        /**
+         * Machine-readable error code.
+         * @example "invalid_request"
+         */
+        code: string;
+        /** Human-readable description. */
+        message: string;
+        /** Per-item problems of a batch request. */
+        details?: Array<{
+            /** Index of the item in the request. */
+            index: number;
+            message: string;
+        }>;
+    };
+}
+export interface User {
+    id: string;
+    email: string;
+    name: string;
+    role?: "admin" | "user";
+    banned?: boolean;
+    createdAt?: string;
+}
+export interface Identity {
+    actor: {
+        /** `client-key` for a client API key. */
+        kind: "client-key" | "user" | "admin";
+        /** Your client ID (client API keys). */
+        clientId?: string;
+        /** ID of the API key (client API keys). */
+        keyId?: string;
+        userId?: string | null;
+        via?: "session" | "api-key" | "token";
+    };
+    user: User | null;
+    memberships: Array<{
+        clientId: string;
+        role: "owner" | "admin" | "member";
+    }>;
+}
+export interface Client {
+    /** Client ID. */
+    id: string;
+    name: string | null;
+    /** Where webhooks are sent. */
+    webhookUrl: string;
+    /** `disabled` — webhooks are not sent. */
+    status: "active" | "disabled";
+    /** format: date-time */
+    createdAt: string;
+}
+export interface Network {
+    id: number;
+    /**
+     * Network identifier used across the API.
+     * @example "tron"
+     */
+    slug: string;
+    /**
+     * CAIP-2 chain ID.
+     * @example "tron:0x2b6653dc"
+     */
+    caip2: string;
+    chainId: number;
+    name: string;
+    shortName: string | null;
+    /** 1 for L1 networks, 2 for L2 rollups. */
+    layer: 1 | 2;
+    parent: string | null;
+    l2Type: string | null;
+    l2Stack: string | null;
+    isTestnet: boolean;
+    explorerUrl: string | null;
+    /** Transfers on this network are monitored. */
+    enabled: boolean;
+}
+export interface NetworkList {
+    items: Network[];
+}
+export interface Asset {
+    id: number;
+    /** Network slug. */
+    network: string;
+    /** CAIP-19 asset ID. */
+    caip19: string;
+    standard: "native" | "erc20" | "trc20";
+    contract: string | null;
+    /** @example "USDT" */
+    symbol: string;
+    name: string;
+    decimals: number;
+    /** Smallest transfer you are notified about, in the smallest unit (inclusive). */
+    minAmount: string;
+    /** Transfers of this asset are monitored. */
+    enabled: boolean;
+}
+export interface AssetList {
+    items: Asset[];
+}
+/** `in` — the address receives, `out` — the address sends, `both` — either. */
+export type Direction = "in" | "out" | "both";
+/** Asset symbols (`USDT`) or contract addresses. `null` — all assets of the network, including ones added later. */
+export type AssetSelection = string[] | null;
+export interface AddressInput {
+    /** Network slug or CAIP-2 ID. */
+    network: string;
+    address: string;
+    /**
+     * Your reference, e.g. a user or account ID.
+     *
+     * length: 0..200
+     */
+    label?: string;
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface AddAddressesRequest {
+    /** items: 1..1000 */
+    addresses: AddressInput[];
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface AddAddressesResult {
+    /** Addresses that started being monitored. */
+    added: number;
+    /** Addresses that were already monitored and left unchanged. */
+    alreadyWatched: number;
+}
+export interface AddressUpdate {
+    network: string;
+    address: string;
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface UpdateAddressesRequest {
+    /** items: 1..1000 */
+    addresses: AddressUpdate[];
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface UpdateAddressesResult {
+    /** Addresses whose subscription was changed. */
+    updated: number;
+    /** Addresses that are not monitored. */
+    notWatched: number;
+}
+export interface AddressRef {
+    /** Network slug or CAIP-2 ID. */
+    network: string;
+    address: string;
+}
+export interface RemoveAddressesRequest {
+    /** items: 1..1000 */
+    addresses: AddressRef[];
+}
+export interface RemoveAddressesResult {
+    /** Addresses that stopped being monitored. */
+    removed: number;
+    /** Addresses that were not monitored. */
+    notWatched: number;
+}
+export interface Address {
+    id: number;
+    network: string;
+    /** CAIP-10 account ID. */
+    caip10: string;
+    address: string;
+    label: string | null;
+    /** Subscribed asset symbols; `null` — all assets. */
+    assets: string[] | null;
+    direction: Direction;
+    /** format: date-time */
+    createdAt: string;
+}
+/** A page of addresses. */
+export interface AddressPage {
+    items: Address[];
+    /** Cursor for the next page — pass it as `after`. `null` when there are no more pages. */
+    next: number | null;
+}
+/** `delivered` — you responded with 2xx; `retrying` — the last attempt failed and will be retried; `failed` — all attempts failed. */
+export type DeliveryStatus = "delivered" | "retrying" | "failed";
+export interface Delivery {
+    id: number;
+    clientId: string;
+    network: string;
+    asset: string;
+    contract: string;
+    /** Transaction hash. */
+    txId: string;
+    logIndex: number | null;
+    block: number;
+    /** Block time, milliseconds since epoch. */
+    blockTime: number;
+    from: string;
+    to: string;
+    /** Amount in the smallest unit. */
+    value: string;
+    status: DeliveryStatus;
+    attempts: number;
+    lastHttpStatus: number | null;
+    lastError: string | null;
+    lastDurationMs: number | null;
+    /** format: date-time */
+    firstAttemptAt: string;
+    /** format: date-time */
+    lastAttemptAt: string;
+    deliveredAt: string | null;
+}
+export type DeliveryDetail = Delivery & {
+    /** URL of the last attempt. */
+    url: string;
+    /** Exact request body. */
+    body: string;
+};
+/** A page of deliveries, newest first. */
+export interface DeliveryPage {
+    items: Delivery[];
+    /** Cursor for the next page — pass it as `before`. `null` when there are no more pages. */
+    next: number | null;
+}
+export interface TxTransfer {
+    /** `native` — sent by the transaction itself; `token` — a token Transfer event; `internal` — TRX sent by a contract; `trc10` — a TRC-10 token. */
+    kind: "native" | "token" | "internal" | "trc10";
+    asset: string | null;
+    /** Token contract address, `native`, or the TRC-10 token ID. */
+    contract: string;
+    from: string;
+    to: string;
+    /** Amount in the smallest unit. */
+    value: string;
+    logIndex?: number;
+    /** The asset is monitored: transfers of at least its `minAmount` are notified. */
+    tracked: boolean;
+}
+export interface Transaction {
+    network: string;
+    caip2: string;
+    txId: string;
+    /** `pending` — not yet included in a block. */
+    status: "success" | "failed" | "pending";
+    failure: string | null;
+    block: number | null;
+    blockTime: number | null;
+    /** Blocks since inclusion, counting the block itself; `0` when pending. */
+    confirmations: number;
+    /** The transaction can no longer be reverted. */
+    final: boolean;
+    /** Signer of the transaction. */
+    from: string;
+    to: string | null;
+    /** TRON contract type (`TransferContract`, `TriggerSmartContract`, …) or, on EVM networks, `transfer`, `contract_call` or `contract_creation`. */
+    type: string;
+    /** Native amount sent by the transaction itself. */
+    value: string;
+    fee: {
+        asset: string;
+        value: string;
+    } | null;
+    transfers: TxTransfer[];
+    /** Your monitored addresses involved in the transaction. */
+    watched: Array<{
+        clientId: string;
+        address: string;
+        direction: Direction;
+    }>;
+    /** Webhooks sent to you for this transaction. */
+    webhooks: Array<{
+        id: number;
+        clientId: string;
+        asset: string;
+        value: string;
+        status: DeliveryStatus;
+        attempts: number;
+        deliveredAt: string | null;
+    }>;
+}
+export interface WebhookTx {
+    /**
+     * Network slug in upper case.
+     * @example "TRON"
+     * @example "ETHEREUM"
+     */
+    network: string;
+    /** @example "USDT" */
+    asset: string;
+    /** Token contract address or `native`. */
+    contract: string;
+    /** Always `TOPUP`, for both directions: compare `from` and `to` with your addresses. */
+    type: "TOPUP";
+    /** Transaction hash. */
+    id: string;
+    block: number;
+    /** Block time, milliseconds since epoch. */
+    timestamp: number;
+    from: string;
+    to: string;
+    /** Amount in the smallest unit. */
+    value: string;
+    /** Position of the transfer in the block, for EVM token transfers. */
+    logIndex?: number;
+}
+export interface WebhookPayload {
+    tx: WebhookTx;
+    /** Present on test webhooks only. */
+    test?: true;
+}
+export interface TestWebhookRequest {
+    /** @defaultValue "USDT" */
+    asset?: "USDT" | "A7A5" | "TRX";
+    /** TRON address. */
+    from?: string;
+    /** TRON address. */
+    to?: string;
+    /** Amount in the smallest unit. */
+    value?: string;
+}
+export interface TestDelivery {
+    /** Your endpoint responded with 2xx. */
+    ok: boolean;
+    /** Status code of your response. */
+    status?: number;
+    /** Connection error. */
+    error?: string;
+    durationMs: number;
+}
+export interface TestWebhookResult {
+    delivery: TestDelivery;
+    /** Value of the `x-signature` header. */
+    signature: string;
+    /** Exact request body. */
+    body: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/generated/types.d.ts.map

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

package/dist/esm/generated/types.js

@@ -0,0 +1,4 @@
+// Generated from openapi/openapi.json by scripts/generate.ts — do not edit by hand.
+// V3 Finance Monitoring API 1.0.0. Regenerate: npm run spec:update && npm run generate
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/generated/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/generated/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uFAAuF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Official TypeScript SDK for the V3 Finance Monitoring API: monitor addresses on TRON and EVM networks and receive
+ * signed webhooks for every incoming and outgoing transfer.
+ *
+ * API reference: https://monitoring.v3.finance/docs
+ *
+ * @packageDocumentation
+ */
+export { MonitoringClient } from './client.js';
+export type { ClientOptions, RequestOptions } from './core/http.js';
+export type { Page } from './core/pagination.js';
+export { MonitoringApiError, MonitoringConnectionError, MonitoringError, MonitoringTimeoutError, WebhookSignatureError, type ErrorDetail, } from './core/errors.js';
+export { AccountResource } from './resources/account.js';
+export { ADDRESS_BATCH_SIZE, AddressesResource, type ListAddressesParams, type SubscriptionDefaults } from './resources/addresses.js';
+export { AssetsResource, NetworksResource } from './resources/catalog.js';
+export { DeliveriesResource, type DeliveryFilter, type ListDeliveriesParams } from './resources/deliveries.js';
+export { TransactionsResource } from './resources/transactions.js';
+export { WebhooksResource } from './resources/webhooks.js';
+export { isTestWebhook, parseWebhook, signWebhookBody, verifyWebhookSignature, WEBHOOK_HEADERS, webhookIdempotencyKey, type SignatureSource, type WebhookBody, } from './webhooks.js';
+export { formatUnits, parseUnits } from './units.js';
+export { DEFAULT_BASE_URL, SDK_VERSION } from './version.js';
+export type * from './generated/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,YAAY,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AACrI,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG5D,mBAAmB,sBAAsB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,20 @@
+/**
+ * Official TypeScript SDK for the V3 Finance Monitoring API: monitor addresses on TRON and EVM networks and receive
+ * signed webhooks for every incoming and outgoing transfer.
+ *
+ * API reference: https://monitoring.v3.finance/docs
+ *
+ * @packageDocumentation
+ */
+export { MonitoringClient } from './client.js';
+export { MonitoringApiError, MonitoringConnectionError, MonitoringError, MonitoringTimeoutError, WebhookSignatureError, } from './core/errors.js';
+export { AccountResource } from './resources/account.js';
+export { ADDRESS_BATCH_SIZE, AddressesResource } from './resources/addresses.js';
+export { AssetsResource, NetworksResource } from './resources/catalog.js';
+export { DeliveriesResource } from './resources/deliveries.js';
+export { TransactionsResource } from './resources/transactions.js';
+export { WebhooksResource } from './resources/webhooks.js';
+export { isTestWebhook, parseWebhook, signWebhookBody, verifyWebhookSignature, WEBHOOK_HEADERS, webhookIdempotencyKey, } from './webhooks.js';
+export { formatUnits, parseUnits } from './units.js';
+export { DEFAULT_BASE_URL, SDK_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAuD,MAAM,0BAA0B,CAAA;AACrI,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAkD,MAAM,2BAA2B,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,GAGtB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/esm/resources/account.d.ts

@@ -0,0 +1,22 @@
+import type { RequestOptions } from '../core/http.js';
+import type { Scope } from '../core/scope.js';
+import type { Client } from '../generated/types.js';
+/** Your client: the account your API key belongs to. */
+export declare class AccountResource {
+    #private;
+    /** @internal */
+    constructor(scope: Scope, resolveId: () => Promise<string>);
+    /**
+     * Retrieves your client, including its webhook URL and status.
+     *
+     * @example
+     * ```ts
+     * const account = await monitoring.account.get()
+     * console.log(account.webhookUrl, account.status)
+     * ```
+     */
+    get(options?: RequestOptions): Promise<Client>;
+    /** Returns your client ID — the value of the `x-client-id` header on every webhook. */
+    id(): Promise<string>;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/esm/resources/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,wDAAwD;AACxD,qBAAa,eAAe;;IAI1B,gBAAgB;IAChB,YAAY,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAGzD;IAED;;;;;;;;OAQG;IACG,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnD;IAED,uFAAuF;IACvF,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,CAEpB;CACF"}

package/dist/esm/resources/account.js

@@ -0,0 +1,27 @@
+/** Your client: the account your API key belongs to. */
+export class AccountResource {
+    #scope;
+    #resolveId;
+    /** @internal */
+    constructor(scope, resolveId) {
+        this.#scope = scope;
+        this.#resolveId = resolveId;
+    }
+    /**
+     * Retrieves your client, including its webhook URL and status.
+     *
+     * @example
+     * ```ts
+     * const account = await monitoring.account.get()
+     * console.log(account.webhookUrl, account.status)
+     * ```
+     */
+    async get(options) {
+        return this.#scope.http.request({ method: 'GET', path: await this.#scope.clientPath(), idempotent: true, options });
+    }
+    /** Returns your client ID — the value of the `x-client-id` header on every webhook. */
+    id() {
+        return this.#resolveId();
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/esm/resources/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAIA,wDAAwD;AACxD,MAAM,OAAO,eAAe;IACjB,MAAM,CAAO;IACb,UAAU,CAAuB;IAE1C,gBAAgB;IAChB,YAAY,KAAY,EAAE,SAAgC;QACxD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CAAC,OAAwB;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACrH,CAAC;IAED,uFAAuF;IACvF,EAAE;QACA,OAAO,IAAI,CAAC,UAAU,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/esm/resources/addresses.d.ts

@@ -0,0 +1,93 @@
+import type { RequestOptions } from '../core/http.js';
+import type { Scope } from '../core/scope.js';
+import type { AddAddressesResult, Address, AddressInput, AddressPage, AddressRef, AddressUpdate, AssetSelection, Direction, RemoveAddressesResult, UpdateAddressesResult } from '../generated/types.js';
+/** Maximum number of addresses the API accepts per request. Larger lists are split into batches automatically. */
+export declare const ADDRESS_BATCH_SIZE = 1000;
+/**
+ * Default subscription for every address in a request that does not set its own. Without it, an address is notified
+ * about all assets of its network in both directions.
+ */
+export interface SubscriptionDefaults {
+    /** Asset symbols (`USDT`) or contract addresses. `null` — all assets of the network, including ones added later. */
+    assets?: AssetSelection;
+    /** `in` — incoming only, `out` — outgoing only, `both` — either. */
+    direction?: Direction;
+}
+/** Parameters of {@link AddressesResource.list}. */
+export interface ListAddressesParams {
+    /** Only addresses on this network. */
+    network?: string;
+    /** Page size, up to 5000. Defaults to 500. */
+    limit?: number;
+    /** Cursor: `next` of the previous page. */
+    after?: number;
+}
+/** Addresses you monitor and their subscriptions: which assets and which direction you are notified about. */
+export declare class AddressesResource {
+    #private;
+    /** @internal */
+    constructor(scope: Scope);
+    /**
+     * Lists monitored addresses, one page at a time.
+     *
+     * @example
+     * ```ts
+     * const { items, next } = await monitoring.addresses.list({ network: 'tron' })
+     * ```
+     */
+    list(params?: ListAddressesParams, options?: RequestOptions): Promise<AddressPage>;
+    /**
+     * Iterates over all monitored addresses, fetching pages as needed.
+     *
+     * @example
+     * ```ts
+     * for await (const address of monitoring.addresses.iterate({ network: 'tron' })) {
+     *   console.log(address.address, address.assets ?? 'all assets', address.direction)
+     * }
+     * ```
+     */
+    iterate(params?: Omit<ListAddressesParams, 'after'>, options?: RequestOptions): AsyncGenerator<Address, void, undefined>;
+    /**
+     * Starts monitoring addresses. New addresses are picked up within seconds. Addresses that are already monitored are
+     * left unchanged — use {@link AddressesResource.update} to change their subscription.
+     *
+     * Each batch of up to {@link ADDRESS_BATCH_SIZE} addresses is validated as a whole: if any item is invalid, the
+     * batch is not applied. Larger lists are sent in batches, in order; if a batch fails, the previous batches have
+     * already been applied, and the indexes in `error.details` refer to your original list. Retrying is safe.
+     *
+     * @param addresses - Addresses to monitor. An EVM address is monitored per network: add it once per network.
+     * @param defaults - Subscription for addresses that do not set their own.
+     * @throws {@link MonitoringApiError} `400` with `details` when an address is invalid for its network or an asset
+     * is unknown.
+     *
+     * @example
+     * ```ts
+     * // deposit addresses: incoming USDT only
+     * await monitoring.addresses.add([{ network: 'tron', address: 'TA8Hg…', label: 'user-42' }], {
+     *   assets: ['USDT'],
+     *   direction: 'in',
+     * })
+     * ```
+     */
+    add(addresses: AddressInput[], defaults?: SubscriptionDefaults, options?: RequestOptions): Promise<AddAddressesResult>;
+    /**
+     * Changes the subscription of monitored addresses. Only the fields you pass are changed: omit `assets` to keep the
+     * current assets, or pass `null` to subscribe to all assets of the network.
+     *
+     * @example
+     * ```ts
+     * await monitoring.addresses.update([{ network: 'tron', address: 'TA8Hg…' }], { direction: 'both' })
+     * ```
+     */
+    update(addresses: AddressUpdate[], defaults?: SubscriptionDefaults, options?: RequestOptions): Promise<UpdateAddressesResult>;
+    /**
+     * Stops monitoring addresses.
+     *
+     * @example
+     * ```ts
+     * await monitoring.addresses.remove([{ network: 'tron', address: 'TA8Hg…' }])
+     * ```
+     */
+    remove(addresses: AddressRef[], options?: RequestOptions): Promise<RemoveAddressesResult>;
+}
+//# sourceMappingURL=addresses.d.ts.map

package/dist/esm/resources/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../src/resources/addresses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAClB,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,kHAAkH;AAClH,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,oHAAoH;IACpH,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,oEAAoE;IACpE,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,8GAA8G;AAC9G,qBAAa,iBAAiB;;IAG5B,gBAAgB;IAChB,YAAY,KAAK,EAAE,KAAK,EAEvB;IAED;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,GAAE,mBAAwB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAE3F;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,GAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAE3H;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,QAAQ,GAAE,oBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQ/H;IAED;;;;;;;;OAQG;IACG,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,QAAQ,GAAE,oBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQtI;IAED;;;;;;;OAOG;IACG,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ9F;CAqBF"}