@v3finance/monitoring-sdk 0.0.0-stage → 0.2.0

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,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,uDAAuD;AACvD,qBAAa,oBAAoB;;IAG/B,gBAAgB;IAChB,YAAY,KAAK,EAAE,KAAK,EAEvB;IAED;;;;;;;;;;;;;;;;OAgBG;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,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionsResource = void 0;
+const http_js_1 = require("../core/http.js");
+/** Any transaction on a supported network, by hash. */
+class TransactionsResource {
+    #scope;
+    /** @internal */
+    constructor(scope) {
+        this.#scope = scope;
+    }
+    /**
+     * Retrieves a transaction — not only the ones you were notified about: status, confirmations, finality, fee and
+     * every transfer inside it, plus your monitored addresses and the webhooks sent to you for it.
+     *
+     * `final: true` means the transaction can no longer be reverted: on TRON the block is solidified (about 1 minute),
+     * on EVM networks it is finalized (about 13 minutes on Ethereum). Credit large amounts once the transaction is final.
+     *
+     * @param network - Network slug (`tron`, `ethereum`) or CAIP-2 ID.
+     * @param hash - EVM: `0x` followed by 64 hex characters. TRON: 64 hex characters.
+     * @throws {@link MonitoringApiError} `404` when the transaction does not exist on the network.
+     *
+     * @example
+     * ```ts
+     * const tx = await monitoring.transactions.get('tron', event.tx.id)
+     * if (tx.status === 'success' && tx.final) await credit(event.tx)
+     * ```
+     */
+    get(network, hash, options) {
+        return this.#scope.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,6CAA0D;AAI1D,uDAAuD;AACvD;IACW,MAAM,CAAO;IAEtB,gBAAgB;IAChB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,OAAe,EAAE,IAAY,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,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;IAC/I,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+import type { RequestOptions } from '../core/http.js';
+import type { Scope } from '../core/scope.js';
+import type { TestWebhookRequest, TestWebhookResult } from '../generated/types.js';
+/** Test your webhook endpoint. To receive webhooks, see {@link parseWebhook}. */
+export declare class WebhooksResource {
+    #private;
+    /** @internal */
+    constructor(scope: Scope);
+    /**
+     * Sends a signed test webhook to your webhook URL and returns the outcome, the signature and the exact body sent.
+     * Test webhooks have `"test": true` in the body and the `x-webhook-test: 1` header — do not credit them.
+     * Limited to 10 per minute.
+     *
+     * @example
+     * ```ts
+     * const { delivery } = await monitoring.webhooks.sendTest({ asset: 'USDT' })
+     * if (!delivery.ok) console.error('Endpoint responded with', delivery.status ?? delivery.error)
+     * ```
+     */
+    sendTest(params?: TestWebhookRequest, options?: RequestOptions): Promise<TestWebhookResult>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/resources/webhooks.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,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAElF,iFAAiF;AACjF,qBAAa,gBAAgB;;IAG3B,gBAAgB;IAChB,YAAY,KAAK,EAAE,KAAK,EAEvB;IAED;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,GAAE,kBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAUpG;CACF"}

package/dist/cjs/resources/webhooks.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhooksResource = void 0;
+/** Test your webhook endpoint. To receive webhooks, see {@link parseWebhook}. */
+class WebhooksResource {
+    #scope;
+    /** @internal */
+    constructor(scope) {
+        this.#scope = scope;
+    }
+    /**
+     * Sends a signed test webhook to your webhook URL and returns the outcome, the signature and the exact body sent.
+     * Test webhooks have `"test": true` in the body and the `x-webhook-test: 1` header — do not credit them.
+     * Limited to 10 per minute.
+     *
+     * @example
+     * ```ts
+     * const { delivery } = await monitoring.webhooks.sendTest({ asset: 'USDT' })
+     * if (!delivery.ok) console.error('Endpoint responded with', delivery.status ?? delivery.error)
+     * ```
+     */
+    async sendTest(params = {}, options) {
+        return this.#scope.http.request({
+            method: 'POST',
+            path: `${await this.#scope.clientPath()}/webhooks/test`,
+            body: params,
+            idempotent: false,
+            // 502 means "your endpoint did not accept it": an outcome, not a failed request
+            acceptStatuses: [502],
+            options,
+        });
+    }
+}
+exports.WebhooksResource = WebhooksResource;
+//# sourceMappingURL=webhooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/resources/webhooks.ts"],"names":[],"mappings":";;;AAIA,iFAAiF;AACjF;IACW,MAAM,CAAO;IAEtB,gBAAgB;IAChB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAuB,EAAE,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB;YACvD,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,KAAK;YACjB,gFAAgF;YAChF,cAAc,EAAE,CAAC,GAAG,CAAC;YACrB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/cjs/units.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Amounts in the API and in webhooks are decimal strings in the asset's smallest unit (sun, wei; USDT has 6 decimals),
+ * because uint256 values do not fit in a `number`. These helpers convert them without losing precision. The decimals
+ * of every asset are returned by `monitoring.assets.list()`.
+ */
+/**
+ * Converts an amount in the smallest unit to a decimal string.
+ *
+ * @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;
+/**
+ * Converts a decimal string to an amount in the smallest unit.
+ *
+ * @throws RangeError when the amount is not a non-negative decimal or has more decimal places than the asset.
+ *
+ * @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";
+/**
+ * Amounts in the API and in webhooks are decimal strings in the asset's smallest unit (sun, wei; USDT has 6 decimals),
+ * because uint256 values do not fit in a `number`. These helpers convert them without losing precision. The decimals
+ * of every asset are returned by `monitoring.assets.list()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatUnits = formatUnits;
+exports.parseUnits = parseUnits;
+const INTEGER = /^-?\d+$/;
+const DECIMAL = /^(\d+)(?:\.(\d+))?$/;
+/**
+ * Converts an amount in the smallest unit to a decimal string.
+ *
+ * @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: expected an integer amount in the smallest unit, 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}` : ''}`;
+}
+/**
+ * Converts a decimal string to an amount in the smallest unit.
+ *
+ * @throws RangeError when the amount is not a non-negative decimal or has more decimal places than the asset.
+ *
+ * @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: expected a non-negative decimal, 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: expected an integer from 0 to 255, 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,qEAAqE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1I,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,oDAAoD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC1G,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,oDAAoD,QAAQ,EAAE,CAAC,CAAA;AACzJ,CAAC"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,5 @@
+/** SDK version, sent in the `user-agent` header. */
+export declare const SDK_VERSION = "0.2.0";
+/** Default API base URL. */
+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,oDAAoD;AACpD,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC,4BAA4B;AAC5B,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 version, sent in the `user-agent` header. */
+exports.SDK_VERSION = '0.2.0';
+/** Default API base URL. */
+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,oDAAoD;AACvC,QAAA,WAAW,GAAG,OAAO,CAAA;AAElC,4BAA4B;AACf,QAAA,gBAAgB,GAAG,+BAA+B,CAAA"}

package/dist/cjs/webhooks.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Receiving webhooks: signature verification and parsing. No API key or network access is needed — only your
+ * webhook secret. Uses Web Crypto, so it runs on Node.js 20+, Bun, Deno and Cloudflare Workers.
+ */
+import type { WebhookPayload } from './generated/types.js';
+/** Headers sent with every webhook. */
+export declare const WEBHOOK_HEADERS: {
+    /** HMAC-SHA256 of the raw body keyed with your webhook secret, hex-encoded. */
+    readonly signature: 'x-signature';
+    /** Your client ID. */
+    readonly clientId: 'x-client-id';
+    /** `1` for test webhooks. */
+    readonly test: 'x-webhook-test';
+};
+/**
+ * The raw request body, exactly as received. Do not parse and re-serialize the JSON: the signature is computed over
+ * the original bytes.
+ */
+export type WebhookBody = string | Uint8Array | ArrayBuffer;
+/**
+ * Where to read the signature from: the value of the `x-signature` header, or all request headers — a Fetch
+ * `Headers` object (Next.js, Hono, Cloudflare Workers) or a Node.js headers object (`req.headers` in Express, Fastify).
+ */
+export type SignatureSource = string | null | undefined | Headers | Record<string, string | string[] | undefined>;
+/**
+ * Computes the signature of a body the way the API does. Useful for testing your webhook handler.
+ *
+ * @example
+ * ```ts
+ * const body = JSON.stringify({ tx: { network: 'TRON', asset: 'USDT', … } })
+ * await fetch('http://localhost:3000/webhooks/monitoring', {
+ *   method: 'POST',
+ *   body,
+ *   headers: { 'content-type': 'application/json', 'x-signature': await signWebhookBody(body, secret) },
+ * })
+ * ```
+ */
+export declare function signWebhookBody(body: WebhookBody, secret: string): Promise<string>;
+/**
+ * Verifies a webhook signature. Returns `true` when the body was sent by the API and was not modified.
+ *
+ * @param body - Raw request body.
+ * @param signature - The `x-signature` header, or all request headers.
+ * @param secret - Your webhook secret.
+ */
+export declare function verifyWebhookSignature(body: WebhookBody, signature: SignatureSource, secret: string): Promise<boolean>;
+/**
+ * Verifies the signature and returns the parsed webhook.
+ *
+ * Respond with a 2xx status within 15 seconds. Process webhooks idempotently by {@link webhookIdempotencyKey} — the
+ * same webhook may arrive more than once — and do not credit test webhooks ({@link isTestWebhook}). Webhooks are sent
+ * as soon as a transfer is included in a block; before crediting large amounts, check that the transaction is final
+ * with `monitoring.transactions.get()`.
+ *
+ * @throws {@link WebhookSignatureError} when the signature does not match. Respond with `401` and do not process it.
+ *
+ * @example Express (use the raw 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 Next.js route handlers, Hono, 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>;
+/** `true` for test webhooks. Do not credit them. */
+export declare function isTestWebhook(event: WebhookPayload): boolean;
+/**
+ * Idempotency key of a webhook: network, transaction hash and log index. A transfer always has the same key, however
+ * many times its webhook is delivered. An EVM transaction can contain several token transfers; they differ by
+ * `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,uCAAuC;AACvC,eAAO,MAAM,eAAe;IAC1B,+EAA+E;aAC/E,SAAS,EAAE,aAAa;IACxB,sBAAsB;aACtB,QAAQ,EAAE,aAAa;IACvB,6BAA6B;aAC7B,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;;;;;;;;;;;;GAYG;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,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEnE"}

package/dist/cjs/webhooks.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Receiving webhooks: signature verification and parsing. No API key or network access is needed — only your
+ * webhook secret. Uses Web Crypto, so it runs on Node.js 20+, Bun, Deno and Cloudflare Workers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_HEADERS = void 0;
+exports.signWebhookBody = signWebhookBody;
+exports.verifyWebhookSignature = verifyWebhookSignature;
+exports.parseWebhook = parseWebhook;
+exports.isTestWebhook = isTestWebhook;
+exports.webhookIdempotencyKey = webhookIdempotencyKey;
+const errors_js_1 = require("./core/errors.js");
+/** Headers sent with every webhook. */
+exports.WEBHOOK_HEADERS = {
+    /** HMAC-SHA256 of the raw body keyed with your webhook secret, hex-encoded. */
+    signature: 'x-signature',
+    /** Your client ID. */
+    clientId: 'x-client-id',
+    /** `1` for test webhooks. */
+    test: 'x-webhook-test',
+};
+const encoder = new TextEncoder();
+function bytesOf(body) {
+    if (typeof body === 'string')
+        return encoder.encode(body);
+    // copy: Web Crypto does not accept views over a SharedArrayBuffer (a Node.js Buffer is a Uint8Array too)
+    return body instanceof Uint8Array ? new Uint8Array(body) : new Uint8Array(body);
+}
+function signatureOf(source) {
+    if (source === null || source === undefined)
+        return undefined;
+    if (typeof source === 'string')
+        return source;
+    if (typeof source.get === 'function')
+        return source.get(exports.WEBHOOK_HEADERS.signature) ?? undefined;
+    const value = source[exports.WEBHOOK_HEADERS.signature];
+    return Array.isArray(value) ? value[0] : value;
+}
+/** Constant-time comparison. */
+function safeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    return diff === 0;
+}
+/**
+ * Computes the signature of a body the way the API does. Useful for testing your webhook handler.
+ *
+ * @example
+ * ```ts
+ * const body = JSON.stringify({ tx: { network: 'TRON', asset: 'USDT', … } })
+ * await fetch('http://localhost:3000/webhooks/monitoring', {
+ *   method: 'POST',
+ *   body,
+ *   headers: { 'content-type': 'application/json', 'x-signature': await signWebhookBody(body, secret) },
+ * })
+ * ```
+ */
+async function signWebhookBody(body, secret) {
+    const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    const mac = new Uint8Array(await crypto.subtle.sign('HMAC', key, bytesOf(body)));
+    return Array.from(mac, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Verifies a webhook signature. Returns `true` when the body was sent by the API and was not modified.
+ *
+ * @param body - Raw request body.
+ * @param signature - The `x-signature` header, or all request headers.
+ * @param secret - Your webhook secret.
+ */
+async function verifyWebhookSignature(body, signature, secret) {
+    const given = signatureOf(signature)?.trim().toLowerCase();
+    if (!given)
+        return false;
+    return safeEqual(await signWebhookBody(body, secret), given);
+}
+/**
+ * Verifies the signature and returns the parsed webhook.
+ *
+ * Respond with a 2xx status within 15 seconds. Process webhooks idempotently by {@link webhookIdempotencyKey} — the
+ * same webhook may arrive more than once — and do not credit test webhooks ({@link isTestWebhook}). Webhooks are sent
+ * as soon as a transfer is included in a block; before crediting large amounts, check that the transaction is final
+ * with `monitoring.transactions.get()`.
+ *
+ * @throws {@link WebhookSignatureError} when the signature does not match. Respond with `401` and do not process it.
+ *
+ * @example Express (use the raw 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 Next.js route handlers, Hono, Cloudflare Workers
+ * ```ts
+ * const event = await parseWebhook(await request.text(), request.headers, env.MONITORING_WEBHOOK_SECRET)
+ * ```
+ */
+async function parseWebhook(body, signature, secret) {
+    if (!(await verifyWebhookSignature(body, signature, secret)))
+        throw new errors_js_1.WebhookSignatureError();
+    let payload;
+    try {
+        payload = JSON.parse(typeof body === 'string' ? body : new TextDecoder().decode(bytesOf(body)));
+    }
+    catch (error) {
+        throw new errors_js_1.MonitoringError('webhook body is not valid JSON', { cause: error });
+    }
+    const tx = payload?.tx;
+    if (typeof tx !== 'object' || tx === null || typeof tx.id !== 'string')
+        throw new errors_js_1.MonitoringError('webhook body has no tx');
+    return payload;
+}
+/** `true` for test webhooks. Do not credit them. */
+function isTestWebhook(event) {
+    return event.test === true;
+}
+/**
+ * Idempotency key of a webhook: network, transaction hash and log index. A transfer always has the same key, however
+ * many times its webhook is delivered. An EVM transaction can contain several token transfers; they differ by
+ * `logIndex`.
+ *
+ * @example `"TRON:1249cb…a5fc45:"`, `"ETHEREUM:0x3fbc…1d57:7"`
+ */
+function webhookIdempotencyKey(event) {
+    return `${event.tx.network}:${event.tx.id}:${event.tx.logIndex ?? ''}`;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/cjs/webhooks.js.map

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

package/dist/esm/client.d.ts

@@ -0,0 +1,46 @@
+import { type ClientOptions } from './core/http.js';
+import { AccountResource } from './resources/account.js';
+import { AddressesResource } from './resources/addresses.js';
+import { AssetsResource, NetworksResource } from './resources/catalog.js';
+import { DeliveriesResource } from './resources/deliveries.js';
+import { TransactionsResource } from './resources/transactions.js';
+import { WebhooksResource } from './resources/webhooks.js';
+/**
+ * Client for the V3 Finance Monitoring API.
+ *
+ * Use it on the server only: an API key in a browser is visible to anyone.
+ *
+ * @example
+ * ```ts
+ * import { MonitoringClient } from '@v3finance/monitoring-sdk'
+ *
+ * const monitoring = new MonitoringClient({ apiKey: process.env.MONITORING_API_KEY! })
+ *
+ * await monitoring.addresses.add([{ network: 'tron', address: 'TA8Hg…' }], { assets: ['USDT'], direction: 'in' })
+ * ```
+ */
+export declare class MonitoringClient {
+    #private;
+    /** Your client: the account your API key belongs to. */
+    readonly account: AccountResource;
+    /** Addresses you monitor and their subscriptions. */
+    readonly addresses: AddressesResource;
+    /** Test your webhook endpoint. */
+    readonly webhooks: WebhooksResource;
+    /** History of webhooks sent to you. */
+    readonly deliveries: DeliveriesResource;
+    /** Any transaction by hash, with confirmations and finality. */
+    readonly transactions: TransactionsResource;
+    /** Supported networks. */
+    readonly networks: NetworksResource;
+    /** Supported native coins and tokens. */
+    readonly assets: AssetsResource;
+    /**
+     * @param options - API key and optional settings.
+     * @throws {@link MonitoringError} when `apiKey` is missing or `fetch` is not available.
+     */
+    constructor(options: ClientOptions);
+    /** API base URL this client sends requests to. */
+    get baseUrl(): string;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG1D;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAK/B;;;OAGG;IACH,YAAY,OAAO,EAAE,aAAa,EAWjC;IAED,kDAAkD;IAClD,IAAI,OAAO,IAAI,MAAM,CAEpB;CAiBF"}

package/dist/esm/client.js

@@ -0,0 +1,76 @@
+import { MonitoringError } from './core/errors.js';
+import { HttpClient, seg } from './core/http.js';
+import { AccountResource } from './resources/account.js';
+import { AddressesResource } from './resources/addresses.js';
+import { AssetsResource, NetworksResource } from './resources/catalog.js';
+import { DeliveriesResource } from './resources/deliveries.js';
+import { TransactionsResource } from './resources/transactions.js';
+import { WebhooksResource } from './resources/webhooks.js';
+import { DEFAULT_BASE_URL } from './version.js';
+/**
+ * Client for the V3 Finance Monitoring API.
+ *
+ * Use it on the server only: an API key in a browser is visible to anyone.
+ *
+ * @example
+ * ```ts
+ * import { MonitoringClient } from '@v3finance/monitoring-sdk'
+ *
+ * const monitoring = new MonitoringClient({ apiKey: process.env.MONITORING_API_KEY! })
+ *
+ * await monitoring.addresses.add([{ network: 'tron', address: 'TA8Hg…' }], { assets: ['USDT'], direction: 'in' })
+ * ```
+ */
+export class MonitoringClient {
+    /** Your client: the account your API key belongs to. */
+    account;
+    /** Addresses you monitor and their subscriptions. */
+    addresses;
+    /** Test your webhook endpoint. */
+    webhooks;
+    /** History of webhooks sent to you. */
+    deliveries;
+    /** Any transaction by hash, with confirmations and finality. */
+    transactions;
+    /** Supported networks. */
+    networks;
+    /** Supported native coins and tokens. */
+    assets;
+    #http;
+    #clientId;
+    /**
+     * @param options - API key and optional settings.
+     * @throws {@link MonitoringError} when `apiKey` is missing or `fetch` is not available.
+     */
+    constructor(options) {
+        this.#http = new HttpClient(options, DEFAULT_BASE_URL);
+        if (options.clientId)
+            this.#clientId = Promise.resolve(options.clientId);
+        const scope = { http: this.#http, clientPath: async () => `/v1/clients/${seg(await this.#resolveClientId())}` };
+        this.account = new AccountResource(scope, () => this.#resolveClientId());
+        this.addresses = new AddressesResource(scope);
+        this.webhooks = new WebhooksResource(scope);
+        this.deliveries = new DeliveriesResource(scope);
+        this.transactions = new TransactionsResource(scope);
+        this.networks = new NetworksResource(scope);
+        this.assets = new AssetsResource(scope);
+    }
+    /** API base URL this client sends requests to. */
+    get baseUrl() {
+        return this.#http.baseUrl;
+    }
+    /** Client ID of the API key: from the options, or resolved once from the API and cached. */
+    #resolveClientId() {
+        this.#clientId ??= this.#http.request({ method: 'GET', path: '/v1/me', idempotent: true }).then((identity) => {
+            if (!identity.actor.clientId)
+                throw new MonitoringError('this API key is not bound to a client: pass clientId in the options');
+            return identity.actor.clientId;
+        }, (error) => {
+            // a failed lookup is not cached: the next call tries again
+            this.#clientId = undefined;
+            throw error;
+        });
+        return this.#clientId;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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