Helper module for generating delegated wrapper functions for API endpoints.

This module provides macros to automatically generate snake_case convenience functions that delegate to endpoint modules. It eliminates code duplication between Hyperliquid.Api.Info and Hyperliquid.Api.Exchange.

Usage

In a context module (Info, Exchange, etc.):

defmodule Hyperliquid.Api.Info do
  require Hyperliquid.Api.DelegationHelper
  alias Hyperliquid.Api.Registry

  DelegationHelper.generate_delegated_functions(:info)
end

Generated Functions

For each endpoint module with __endpoint_info__/0, the macro generates:

• endpoint_name/N - Returns {:ok, result} or {:error, reason}
• endpoint_name!/N - Returns result or raises on error

For endpoints with storage enabled:

• fetch_endpoint_name/N - Fetch and persist to storage
• fetch_endpoint_name!/N - Fetch, persist, and raise on error

Parameter Handling

Function signatures are generated based on endpoint metadata:

• No params: endpoint_name() / endpoint_name!()
• Optional only: endpoint_name(opts \\ []) / endpoint_name!(opts \\ [])
• Required + optional: endpoint_name(param1, param2, opts \\ [])
• Required only: endpoint_name(param1, param2)