> For the complete documentation index, see [llms.txt](https://dexhunter.gitbook.io/dexhunter-partners/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dexhunter.gitbook.io/dexhunter-partners/partners/changelog.md).

# Changelog

All notable changes to the DexHunter Swap Widget will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

***

## \[2.0.3] - Current

### Features

* React 19 compatibility
* Enhanced swap component with improved UI/UX
* Support for multiple order types (SWAP, LIMIT, DCA)
* Customizable themes (dark/light)
* Custom color theming support
* Wallet connection callbacks
* Support for 10+ Cardano wallets
* **Iframe integration** - Embed swap widget without JavaScript dependencies
* **Chart and Orders support** - Display price charts and order books via iframe

### Props

* `partnerName` and `partnerCode` for partner identification
* `theme` for color scheme selection
* `orderTypes` for enabling/disabling order types
* `defaultToken` for token initialization (React component)
* `defaultTokenIn` and `defaultTokenOut` for token pair initialization (iframe)
* `supportedTokens` for token filtering
* `width` and `height` for custom widget dimensions
* `showChart`, `showOrders` for chart and orders display (iframe only)
* `chartWidth`, `swapWidth`, `ordersWidth` for layout customization (iframe only)
* `colors` for custom color theming
* `onSwapSuccess`, `onSwapError`, `onWalletConnect` callbacks
* `displayType` for different widget display modes (DEFAULT, BUTTON, WIDGET)

***

## \[0.0.198] - 2024

### Added

* **Iframe Integration**: Embed swap widget via iframe at `https://swap.dexhunter.io`
* **Price Chart**: Display real-time price charts via iframe `showChart` parameter
* **Orders Table**: Show token pair order book via iframe `showOrders` parameter
* **Dual Token Selection**: Set both `defaultTokenIn` and `defaultTokenOut` URL parameters for precise token pair initialization
* Redesigned swap component with enhanced features

### Changed

* Improved component layout and styling
* Enhanced chart and orders integration
* Updated documentation with iframe examples

***

## \[Unreleased]

### Planned

* Additional customization options
* Performance improvements
* New wallet integrations

***

## Version Compatibility

| React Version | Package Version |
| ------------- | --------------- |
| React 19+     | 2.0.0+          |
| React 18      | 2.0.0+          |

***

## Migration Guide

### Upgrading from 0.0.198 to 2.0.0+

No breaking changes. The API remains backward compatible. You can upgrade by updating your package version:

```bash
npm i @dexhunterio/swaps@latest
```

***

## Support

For issues, questions, or feature requests:

* **Email:** <support@dexhunter.io>
* **Discord:** [discord.gg/sCrG7zVn](https://discord.gg/sCrG7zVn)