@ledgerhq/live-network

live-network

Status: STABLE — Production-ready; API is considered stable.

@ledgerhq/live-network is the shared network layer for Ledger Live. It wraps the underlying HTTP client with Ledger-specific logging, error normalisation, and request optimisation utilities so all services in the monorepo make network calls consistently.

What it does

• Exposes a network() helper that wraps axios with automatic logging (via @ledgerhq/logs) and maps HTTP errors into typed Ledger errors.
• Provides a request batcher (batcher/) that coalesces concurrent requests for the same resource into a single in-flight call, reducing redundant network traffic.
• Provides a cache layer (cache.ts) for memoising responses with configurable TTL.

Key exports / concepts

• Default export network(options) — drop-in replacement for axios with logging and error handling.
• seconds(n) / minutes(n) / hours(n) — helpers that produce CacheOptions for use with lru-cache.
• makeBatcher(request, params) — batches concurrent calls within the same event-loop tick into a single upstream request (via @ledgerhq/live-network/batcher).

Usage context

Used throughout libs/ledger-live-common, coin modules, and service clients. Both desktop and mobile depend on it transitively. It is the single place to configure global request behaviour (timeouts, base URLs via @ledgerhq/live-env).