@partylayer/sdk 0.2.5 → 0.2.6

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 CantonConnect
+Copyright (c) 2024 PartyLayer
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -270,9 +270,9 @@ import type {
 
 ## Links
 
-- [GitHub Repository](https://github.com/cayvox/PartyLayer)
-- [Documentation](https://github.com/cayvox/PartyLayer#readme)
-- [Report Issues](https://github.com/cayvox/PartyLayer/issues)
+- [GitHub Repository](https://github.com/PartyLayer/PartyLayer)
+- [Documentation](https://github.com/PartyLayer/PartyLayer#readme)
+- [Report Issues](https://github.com/PartyLayer/PartyLayer/issues)
 - [Canton Network](https://www.canton.network/)
 
 ---

package/dist/index.d.mts

@@ -1,11 +1,14 @@
-import { WalletAdapter, NetworkId, StorageAdapter, CryptoAdapter, TelemetryAdapter, LoggerAdapter, WalletId, Session, SessionId, TransactionHash, TransactionStatus, WalletInfo, SignMessageParams, SignedMessage, SignTransactionParams, SignedTransaction, SubmitTransactionParams, TxReceipt } from '@partylayer/core';
-export { AdapterConnectResult, AdapterContext, AdapterDetectResult, PartyLayerError as CantonConnectError, CapabilityKey, CapabilityNotSupportedError, ErrorCode, InternalError, NetworkId, OriginNotAllowedError, PartyId, PartyLayerError, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, Session, SessionExpiredError, SessionId, SignMessageParams, SignTransactionParams, SignedMessage, SignedTransaction, SubmitTransactionParams, TimeoutError, TransactionStatus, TransportError, TxReceipt, UserRejectedError, WalletAdapter, WalletId, WalletInfo, WalletNotFoundError, WalletNotInstalledError } from '@partylayer/core';
+import * as _partylayer_core from '@partylayer/core';
+import { WalletAdapter, NetworkId, StorageAdapter, CryptoAdapter, TelemetryAdapter, LoggerAdapter, WalletId, Session, SessionId, TransactionHash, TransactionStatus, WalletInfo, SignMessageParams, SignedMessage, SignTransactionParams, SignedTransaction, SubmitTransactionParams, TxReceipt, LedgerApiParams, LedgerApiResult } from '@partylayer/core';
+export { AdapterConnectResult, AdapterContext, AdapterDetectResult, PartyLayerError as CantonConnectError, CapabilityKey, CapabilityNotSupportedError, ENABLEMENT_METRICS, ERROR_METRICS, ErrorCode, InternalError, METRICS, MetricName, MetricsPayload, NetworkId, OriginNotAllowedError, PartyId, PartyLayerError, REGISTRY_METRICS, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, Session, SessionExpiredError, SessionId, SignMessageParams, SignTransactionParams, SignedMessage, SignedTransaction, SubmitTransactionParams, TimeoutError, TransactionStatus, TransportError, TxReceipt, UserRejectedError, WalletAdapter, WalletId, WalletInfo, WalletNotFoundError, WalletNotInstalledError, errorMetricName } from '@partylayer/core';
 import { RegistryClient, RegistryStatus } from '@partylayer/registry-client';
 export { RegistryStatus } from '@partylayer/registry-client';
+export { CANTON_NETWORKS, CIP0103Account, CIP0103ConnectResult, CIP0103Event, CIP0103EventBus, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, DiscoveredProvider, JSON_RPC_ERRORS, PartyLayerProvider, PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, createProviderBridge, discoverInjectedProviders, fromCAIP2Network, isCIP0103Provider, isValidCAIP2, toCAIP2Network, waitForProvider } from '@partylayer/provider';
 export { BronAdapter, BronAdapterConfig, BronApiConfig, BronAuthConfig } from '@partylayer/adapter-bron';
 export { Cantor8Adapter } from '@partylayer/adapter-cantor8';
 export { ConsoleAdapter } from '@partylayer/adapter-console';
 export { LoopAdapter } from '@partylayer/adapter-loop';
+export { NightlyAdapter } from '@partylayer/adapter-nightly';
 
 /**
  * Configuration types for PartyLayer SDK
@@ -16,6 +19,53 @@ export { LoopAdapter } from '@partylayer/adapter-loop';
  * This points to the official registry endpoint.
  */
 declare const DEFAULT_REGISTRY_URL = "https://registry.partylayer.xyz";
+/**
+ * Telemetry configuration for opt-in metrics collection
+ *
+ * @since 0.3.0
+ */
+interface TelemetryConfig {
+    /**
+     * Enable telemetry collection
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Metrics backend endpoint URL
+     * If not provided, metrics are collected but not sent
+     */
+    endpoint?: string;
+    /**
+     * Sampling rate (0.0 to 1.0)
+     * @default 1.0 (100% of events)
+     */
+    sampleRate?: number;
+    /**
+     * Application identifier (will be hashed for privacy)
+     * Used to calculate Monthly Active dApps (MAD)
+     */
+    appId?: string;
+    /**
+     * Include hashed origin in metrics
+     * @default false
+     */
+    includeOrigin?: boolean;
+    /**
+     * Number of events to buffer before sending
+     * @default 10
+     */
+    batchSize?: number;
+    /**
+     * Interval to flush metrics in milliseconds
+     * @default 30000 (30 seconds)
+     */
+    flushIntervalMs?: number;
+    /**
+     * Network to include in metrics
+     * If not provided, uses the SDK's configured network
+     */
+    network?: NetworkId;
+}
 /**
  * Adapter class type (for instantiation)
  */
@@ -79,8 +129,17 @@ interface PartyLayerConfig {
     crypto?: CryptoAdapter;
     /** Registry public keys for signature verification (ed25519) */
     registryPublicKeys?: string[];
-    /** Telemetry adapter (optional) */
-    telemetry?: TelemetryAdapter;
+    /**
+     * Telemetry configuration or adapter
+     *
+     * Can be either:
+     * - TelemetryConfig object for built-in metrics collection
+     * - TelemetryAdapter instance for custom telemetry
+     *
+     * @default undefined (telemetry disabled)
+     * @since 0.3.0 - Added TelemetryConfig support
+     */
+    telemetry?: TelemetryAdapter | TelemetryConfig;
     /** Logger adapter (optional) */
     logger?: LoggerAdapter;
     /** Application metadata */
@@ -192,18 +251,6 @@ type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConne
  */
 type EventHandler<T extends PartyLayerEvent = PartyLayerEvent> = (event: T) => void | Promise<void>;
 
-/**
- * PartyLayer Client - Public API Implementation
- *
- * This is the main public API for PartyLayer SDK.
- * All dApps should use this API exclusively.
- *
- * References:
- * - Wallet Integration Guide: https://docs.digitalasset.com/integrate/devnet/index.html
- * - Signing transactions from dApps: https://docs.digitalasset.com/integrate/devnet/signing-transactions-from-dapps/index.html
- * - OpenRPC dApp API spec: https://github.com/hyperledger-labs/splice-wallet-kernel/blob/main/api-specs/openrpc-dapp-api.json
- */
-
 /**
  * PartyLayer Client
  *
@@ -257,6 +304,10 @@ declare class PartyLayerClient {
      * Submit a transaction
      */
     submitTransaction(params: SubmitTransactionParams): Promise<TxReceipt>;
+    /**
+     * Proxy a JSON Ledger API request through the active wallet adapter
+     */
+    ledgerApi(params: LedgerApiParams): Promise<LedgerApiResult>;
     /**
      * Subscribe to events
      */
@@ -265,6 +316,23 @@ declare class PartyLayerClient {
      * Unsubscribe from events
      */
     off<T extends PartyLayerEvent>(event: T['type'], handler: EventHandler<T>): void;
+    /**
+     * Get a CIP-0103 Provider backed by this client.
+     *
+     * This bridge routes all request() calls through the existing
+     * PartyLayerClient methods and maps events to CIP-0103 format.
+     *
+     * The bridge implements the full CIP-0103 specification:
+     * - All 10 mandatory methods including `ledgerApi` (when adapter supports it)
+     * - Full transaction lifecycle: pending -> signed -> executed/failed
+     * - All CIP-0103 events: statusChanged, accountsChanged, txChanged, connected
+     *
+     * **Note:** Async wallets (userUrl pattern) are not supported through the
+     * bridge. For async wallet support, use `PartyLayerProvider` directly.
+     *
+     * @returns CIP-0103 compliant Provider
+     */
+    asProvider(): _partylayer_core.CIP0103Provider;
     /**
      * Destroy client and cleanup
      */
@@ -334,10 +402,98 @@ declare function createPartyLayer(config: PartyLayerConfig): PartyLayerClient;
  * - ConsoleAdapter: Console Wallet browser extension
  * - LoopAdapter: 5N Loop mobile/web wallet
  * - Cantor8Adapter: Cantor8 wallet with deep link transport
+ * - NightlyAdapter: Nightly multichain wallet with Canton support
  *
  * Note: BronAdapter is NOT included by default because it requires OAuth configuration.
  * To use Bron, install @partylayer/adapter-bron and register it manually.
  */
 declare function getBuiltinAdapters(): WalletAdapter[];
 
-export { type AdapterClass, PartyLayerClient as CantonConnectClient, type PartyLayerConfig as CantonConnectConfig, type PartyLayerEvent as CantonConnectEvent, type ConnectOptions, DEFAULT_REGISTRY_URL, type ErrorEvent, type EventHandler, PartyLayerClient, type PartyLayerConfig, type PartyLayerEvent, type RegistryUpdatedEvent, type SessionConnectedEvent, type SessionDisconnectedEvent, type SessionExpiredEvent, type TxStatusEvent, type WalletFilter, PartyLayerClient as _PartyLayerClientInternal, createPartyLayer as createCantonConnect, createPartyLayer, getBuiltinAdapters };
+/**
+ * Metrics Telemetry Adapter
+ *
+ * A privacy-safe telemetry adapter that collects metrics for
+ * ecosystem health monitoring and usage reporting.
+ *
+ * Features:
+ * - Opt-in by default (disabled unless explicitly enabled)
+ * - Privacy-safe payloads (no PII, hashed identifiers)
+ * - Batched sending to reduce network overhead
+ * - Configurable sampling rate
+ * - Automatic flush on interval or batch size
+ *
+ * @since 0.3.0
+ */
+
+/**
+ * Metrics Telemetry Adapter
+ *
+ * Implements TelemetryAdapter interface with metrics-specific functionality.
+ */
+declare class MetricsTelemetryAdapter implements TelemetryAdapter {
+    private config;
+    private metrics;
+    private buffer;
+    private flushTimer;
+    private appIdHash;
+    private originHash;
+    private initialized;
+    constructor(config: TelemetryConfig);
+    /**
+     * Initialize async components (hashing)
+     */
+    private initialize;
+    /**
+     * Check if telemetry is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Track a named event (TelemetryAdapter interface)
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Track an error (TelemetryAdapter interface)
+     */
+    error(error: Error, properties?: Record<string, unknown>): void;
+    /**
+     * Increment a metric counter
+     */
+    increment(metric: string, value?: number): void;
+    /**
+     * Set a gauge metric value
+     */
+    gauge(metric: string, value: number): void;
+    /**
+     * Buffer an event for batched sending
+     */
+    private bufferEvent;
+    /**
+     * Flush buffered metrics to backend
+     */
+    flush(): Promise<void>;
+    /**
+     * Get current metrics snapshot (for testing/debugging)
+     */
+    getMetrics(): Record<string, number>;
+    /**
+     * Reset all metrics (for testing)
+     */
+    reset(): void;
+    /**
+     * Destroy the adapter (cleanup timers)
+     */
+    destroy(): void;
+}
+/**
+ * Check if a value is a TelemetryConfig object
+ */
+declare function isTelemetryConfig(value: unknown): value is TelemetryConfig;
+/**
+ * Create a TelemetryAdapter from config
+ *
+ * If config is already a TelemetryAdapter, returns it.
+ * If config is a TelemetryConfig, creates a MetricsTelemetryAdapter.
+ */
+declare function createTelemetryAdapter(config: TelemetryAdapter | TelemetryConfig | undefined): TelemetryAdapter | undefined;
+
+export { type AdapterClass, PartyLayerClient as CantonConnectClient, type PartyLayerConfig as CantonConnectConfig, type PartyLayerEvent as CantonConnectEvent, type ConnectOptions, DEFAULT_REGISTRY_URL, type ErrorEvent, type EventHandler, MetricsTelemetryAdapter, PartyLayerClient, type PartyLayerConfig, type PartyLayerEvent, type RegistryUpdatedEvent, type SessionConnectedEvent, type SessionDisconnectedEvent, type SessionExpiredEvent, type TelemetryConfig, type TxStatusEvent, type WalletFilter, PartyLayerClient as _PartyLayerClientInternal, createPartyLayer as createCantonConnect, createPartyLayer, createTelemetryAdapter, getBuiltinAdapters, isTelemetryConfig };

package/dist/index.d.ts

@@ -1,11 +1,14 @@
-import { WalletAdapter, NetworkId, StorageAdapter, CryptoAdapter, TelemetryAdapter, LoggerAdapter, WalletId, Session, SessionId, TransactionHash, TransactionStatus, WalletInfo, SignMessageParams, SignedMessage, SignTransactionParams, SignedTransaction, SubmitTransactionParams, TxReceipt } from '@partylayer/core';
-export { AdapterConnectResult, AdapterContext, AdapterDetectResult, PartyLayerError as CantonConnectError, CapabilityKey, CapabilityNotSupportedError, ErrorCode, InternalError, NetworkId, OriginNotAllowedError, PartyId, PartyLayerError, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, Session, SessionExpiredError, SessionId, SignMessageParams, SignTransactionParams, SignedMessage, SignedTransaction, SubmitTransactionParams, TimeoutError, TransactionStatus, TransportError, TxReceipt, UserRejectedError, WalletAdapter, WalletId, WalletInfo, WalletNotFoundError, WalletNotInstalledError } from '@partylayer/core';
+import * as _partylayer_core from '@partylayer/core';
+import { WalletAdapter, NetworkId, StorageAdapter, CryptoAdapter, TelemetryAdapter, LoggerAdapter, WalletId, Session, SessionId, TransactionHash, TransactionStatus, WalletInfo, SignMessageParams, SignedMessage, SignTransactionParams, SignedTransaction, SubmitTransactionParams, TxReceipt, LedgerApiParams, LedgerApiResult } from '@partylayer/core';
+export { AdapterConnectResult, AdapterContext, AdapterDetectResult, PartyLayerError as CantonConnectError, CapabilityKey, CapabilityNotSupportedError, ENABLEMENT_METRICS, ERROR_METRICS, ErrorCode, InternalError, METRICS, MetricName, MetricsPayload, NetworkId, OriginNotAllowedError, PartyId, PartyLayerError, REGISTRY_METRICS, RegistryFetchFailedError, RegistrySchemaInvalidError, RegistryVerificationFailedError, Session, SessionExpiredError, SessionId, SignMessageParams, SignTransactionParams, SignedMessage, SignedTransaction, SubmitTransactionParams, TimeoutError, TransactionStatus, TransportError, TxReceipt, UserRejectedError, WalletAdapter, WalletId, WalletInfo, WalletNotFoundError, WalletNotInstalledError, errorMetricName } from '@partylayer/core';
 import { RegistryClient, RegistryStatus } from '@partylayer/registry-client';
 export { RegistryStatus } from '@partylayer/registry-client';
+export { CANTON_NETWORKS, CIP0103Account, CIP0103ConnectResult, CIP0103Event, CIP0103EventBus, CIP0103Method, CIP0103Network, CIP0103Provider, CIP0103StatusEvent, CIP0103TxChangedEvent, CIP0103TxStatus, CIP0103_EVENTS, CIP0103_MANDATORY_METHODS, CIP0103_METHODS, DiscoveredProvider, JSON_RPC_ERRORS, PartyLayerProvider, PartyLayerProviderOptions, ProviderRpcError, RPC_ERRORS, createProviderBridge, discoverInjectedProviders, fromCAIP2Network, isCIP0103Provider, isValidCAIP2, toCAIP2Network, waitForProvider } from '@partylayer/provider';
 export { BronAdapter, BronAdapterConfig, BronApiConfig, BronAuthConfig } from '@partylayer/adapter-bron';
 export { Cantor8Adapter } from '@partylayer/adapter-cantor8';
 export { ConsoleAdapter } from '@partylayer/adapter-console';
 export { LoopAdapter } from '@partylayer/adapter-loop';
+export { NightlyAdapter } from '@partylayer/adapter-nightly';
 
 /**
  * Configuration types for PartyLayer SDK
@@ -16,6 +19,53 @@ export { LoopAdapter } from '@partylayer/adapter-loop';
  * This points to the official registry endpoint.
  */
 declare const DEFAULT_REGISTRY_URL = "https://registry.partylayer.xyz";
+/**
+ * Telemetry configuration for opt-in metrics collection
+ *
+ * @since 0.3.0
+ */
+interface TelemetryConfig {
+    /**
+     * Enable telemetry collection
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Metrics backend endpoint URL
+     * If not provided, metrics are collected but not sent
+     */
+    endpoint?: string;
+    /**
+     * Sampling rate (0.0 to 1.0)
+     * @default 1.0 (100% of events)
+     */
+    sampleRate?: number;
+    /**
+     * Application identifier (will be hashed for privacy)
+     * Used to calculate Monthly Active dApps (MAD)
+     */
+    appId?: string;
+    /**
+     * Include hashed origin in metrics
+     * @default false
+     */
+    includeOrigin?: boolean;
+    /**
+     * Number of events to buffer before sending
+     * @default 10
+     */
+    batchSize?: number;
+    /**
+     * Interval to flush metrics in milliseconds
+     * @default 30000 (30 seconds)
+     */
+    flushIntervalMs?: number;
+    /**
+     * Network to include in metrics
+     * If not provided, uses the SDK's configured network
+     */
+    network?: NetworkId;
+}
 /**
  * Adapter class type (for instantiation)
  */
@@ -79,8 +129,17 @@ interface PartyLayerConfig {
     crypto?: CryptoAdapter;
     /** Registry public keys for signature verification (ed25519) */
     registryPublicKeys?: string[];
-    /** Telemetry adapter (optional) */
-    telemetry?: TelemetryAdapter;
+    /**
+     * Telemetry configuration or adapter
+     *
+     * Can be either:
+     * - TelemetryConfig object for built-in metrics collection
+     * - TelemetryAdapter instance for custom telemetry
+     *
+     * @default undefined (telemetry disabled)
+     * @since 0.3.0 - Added TelemetryConfig support
+     */
+    telemetry?: TelemetryAdapter | TelemetryConfig;
     /** Logger adapter (optional) */
     logger?: LoggerAdapter;
     /** Application metadata */
@@ -192,18 +251,6 @@ type PartyLayerEvent = RegistryUpdatedEvent | RegistryStatusEvent | SessionConne
  */
 type EventHandler<T extends PartyLayerEvent = PartyLayerEvent> = (event: T) => void | Promise<void>;
 
-/**
- * PartyLayer Client - Public API Implementation
- *
- * This is the main public API for PartyLayer SDK.
- * All dApps should use this API exclusively.
- *
- * References:
- * - Wallet Integration Guide: https://docs.digitalasset.com/integrate/devnet/index.html
- * - Signing transactions from dApps: https://docs.digitalasset.com/integrate/devnet/signing-transactions-from-dapps/index.html
- * - OpenRPC dApp API spec: https://github.com/hyperledger-labs/splice-wallet-kernel/blob/main/api-specs/openrpc-dapp-api.json
- */
-
 /**
  * PartyLayer Client
  *
@@ -257,6 +304,10 @@ declare class PartyLayerClient {
      * Submit a transaction
      */
     submitTransaction(params: SubmitTransactionParams): Promise<TxReceipt>;
+    /**
+     * Proxy a JSON Ledger API request through the active wallet adapter
+     */
+    ledgerApi(params: LedgerApiParams): Promise<LedgerApiResult>;
     /**
      * Subscribe to events
      */
@@ -265,6 +316,23 @@ declare class PartyLayerClient {
      * Unsubscribe from events
      */
     off<T extends PartyLayerEvent>(event: T['type'], handler: EventHandler<T>): void;
+    /**
+     * Get a CIP-0103 Provider backed by this client.
+     *
+     * This bridge routes all request() calls through the existing
+     * PartyLayerClient methods and maps events to CIP-0103 format.
+     *
+     * The bridge implements the full CIP-0103 specification:
+     * - All 10 mandatory methods including `ledgerApi` (when adapter supports it)
+     * - Full transaction lifecycle: pending -> signed -> executed/failed
+     * - All CIP-0103 events: statusChanged, accountsChanged, txChanged, connected
+     *
+     * **Note:** Async wallets (userUrl pattern) are not supported through the
+     * bridge. For async wallet support, use `PartyLayerProvider` directly.
+     *
+     * @returns CIP-0103 compliant Provider
+     */
+    asProvider(): _partylayer_core.CIP0103Provider;
     /**
      * Destroy client and cleanup
      */
@@ -334,10 +402,98 @@ declare function createPartyLayer(config: PartyLayerConfig): PartyLayerClient;
  * - ConsoleAdapter: Console Wallet browser extension
  * - LoopAdapter: 5N Loop mobile/web wallet
  * - Cantor8Adapter: Cantor8 wallet with deep link transport
+ * - NightlyAdapter: Nightly multichain wallet with Canton support
  *
  * Note: BronAdapter is NOT included by default because it requires OAuth configuration.
  * To use Bron, install @partylayer/adapter-bron and register it manually.
  */
 declare function getBuiltinAdapters(): WalletAdapter[];
 
-export { type AdapterClass, PartyLayerClient as CantonConnectClient, type PartyLayerConfig as CantonConnectConfig, type PartyLayerEvent as CantonConnectEvent, type ConnectOptions, DEFAULT_REGISTRY_URL, type ErrorEvent, type EventHandler, PartyLayerClient, type PartyLayerConfig, type PartyLayerEvent, type RegistryUpdatedEvent, type SessionConnectedEvent, type SessionDisconnectedEvent, type SessionExpiredEvent, type TxStatusEvent, type WalletFilter, PartyLayerClient as _PartyLayerClientInternal, createPartyLayer as createCantonConnect, createPartyLayer, getBuiltinAdapters };
+/**
+ * Metrics Telemetry Adapter
+ *
+ * A privacy-safe telemetry adapter that collects metrics for
+ * ecosystem health monitoring and usage reporting.
+ *
+ * Features:
+ * - Opt-in by default (disabled unless explicitly enabled)
+ * - Privacy-safe payloads (no PII, hashed identifiers)
+ * - Batched sending to reduce network overhead
+ * - Configurable sampling rate
+ * - Automatic flush on interval or batch size
+ *
+ * @since 0.3.0
+ */
+
+/**
+ * Metrics Telemetry Adapter
+ *
+ * Implements TelemetryAdapter interface with metrics-specific functionality.
+ */
+declare class MetricsTelemetryAdapter implements TelemetryAdapter {
+    private config;
+    private metrics;
+    private buffer;
+    private flushTimer;
+    private appIdHash;
+    private originHash;
+    private initialized;
+    constructor(config: TelemetryConfig);
+    /**
+     * Initialize async components (hashing)
+     */
+    private initialize;
+    /**
+     * Check if telemetry is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Track a named event (TelemetryAdapter interface)
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Track an error (TelemetryAdapter interface)
+     */
+    error(error: Error, properties?: Record<string, unknown>): void;
+    /**
+     * Increment a metric counter
+     */
+    increment(metric: string, value?: number): void;
+    /**
+     * Set a gauge metric value
+     */
+    gauge(metric: string, value: number): void;
+    /**
+     * Buffer an event for batched sending
+     */
+    private bufferEvent;
+    /**
+     * Flush buffered metrics to backend
+     */
+    flush(): Promise<void>;
+    /**
+     * Get current metrics snapshot (for testing/debugging)
+     */
+    getMetrics(): Record<string, number>;
+    /**
+     * Reset all metrics (for testing)
+     */
+    reset(): void;
+    /**
+     * Destroy the adapter (cleanup timers)
+     */
+    destroy(): void;
+}
+/**
+ * Check if a value is a TelemetryConfig object
+ */
+declare function isTelemetryConfig(value: unknown): value is TelemetryConfig;
+/**
+ * Create a TelemetryAdapter from config
+ *
+ * If config is already a TelemetryAdapter, returns it.
+ * If config is a TelemetryConfig, creates a MetricsTelemetryAdapter.
+ */
+declare function createTelemetryAdapter(config: TelemetryAdapter | TelemetryConfig | undefined): TelemetryAdapter | undefined;
+
+export { type AdapterClass, PartyLayerClient as CantonConnectClient, type PartyLayerConfig as CantonConnectConfig, type PartyLayerEvent as CantonConnectEvent, type ConnectOptions, DEFAULT_REGISTRY_URL, type ErrorEvent, type EventHandler, MetricsTelemetryAdapter, PartyLayerClient, type PartyLayerConfig, type PartyLayerEvent, type RegistryUpdatedEvent, type SessionConnectedEvent, type SessionDisconnectedEvent, type SessionExpiredEvent, type TelemetryConfig, type TxStatusEvent, type WalletFilter, PartyLayerClient as _PartyLayerClientInternal, createPartyLayer as createCantonConnect, createPartyLayer, createTelemetryAdapter, getBuiltinAdapters, isTelemetryConfig };