Rujira.Prices behaviour (rujira_ex v0.0.4)

Behaviour and configurable delegator for asset price lookups.

Ships with two built-in implementations:

Consumers can override via application env:

config :rujira_ex, prices: MyApp.CustomPrices

Cache TTL

The default implementation memoizes prices using the global cache TTL. See Rujira.cache_ttl/0.

get(t)

get(ticker)

Fetches the USD price for an asset.

@callback get(String.t()) :: {:ok, Decimal.t()} | {:error, term()}

@callback value_usd(String.t(), integer(), integer()) :: integer()

@spec get(String.t()) :: {:ok, Decimal.t()} | {:error, term()}

Fetches the USD price for an asset.

ticker must be the bare ticker from Rujira.Assets.Asset.ticker (e.g. "USDC"), not the full symbol (e.g. "USDC-0xAbc...").

@spec value_usd(String.t(), integer(), integer()) :: integer()