> ## Documentation Index
> Fetch the complete documentation index at: /go/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget

> Selected updates and improvements to the `@skip-go/widget` [npm package](https://www.npmjs.com/package/@skip-go/widget).

## September 2026

### Keplr Connection Fix (v3.18.3)

* Removed Quicksilver from the default and fallback initial connection lists to fix Keplr connection failures caused by missing Quicksilver chain information.

### Asset Annotation Display (v3.18.2)

* Removed warning icons from `assetAnnotations`. The swap page shows the badge, and the token selector shows the description line and border highlight. Colors and `selector.pinToTop` behavior are unchanged.

### Per-Asset Annotations (v3.18.0)

* **`assetAnnotations` prop:** Added per-asset notices (keyed by recommended symbol) to guide users. At introduction, the swap page showed a badge and a warning icon next to the asset; the token selector showed a border highlight and a detail line, with optional pinning to the top of the list. Supports `info` / `warning` / `error` variants. [See configuration](/go/widget/configuration.md#assetannotations).
* **Breaking — `ibcEurekaHighlightedAssets` prop removed:** Use `assetAnnotations` for per-asset highlighting instead (`selector.description` + highlight, optionally `pinToTop`). The IBC Eureka transfer/protocol handling is unaffected — only the selector-highlighting prop was removed.
* **(v3.18.1)** Pinned (`pinToTop`) assets now stay at the top of the token selector even while searching.

## August 2026

### CCTP v2 Support (v3.16.1–v3.17.5)

* Added support for CCTP v2 transfers, including the CCTP relayed flow, and correct handling of `cctp_transfer_v2` entries in transaction status responses (previously these could show as `failed` while still pending and produce broken explorer links).

## July 2026

### Custom Explorer URL (v3.16.0)

* **`skipExplorerUrl` prop:** Point transaction history links at a different Skip explorer. Defaults to `https://explorer.skip.build`, so existing behavior is unchanged.

## May 2026

### Wallet Support Change

* **Leap wallet support removed** following Leap's service shutdown. This removes the Cosmos browser extension (`WalletType.LEAP`), the mobile WalletConnect entry (`WalletType.WC_LEAP_MOBILE`), and the MetaMask Snap variant (`WalletType.METAMASK_SNAP_LEAP`) from the wallet selector.

## November 2025

### Manual Address Safety

* **Cross-chain manual address warning:** Users must now explicitly acknowledge the risk before entering a manual destination address on cross-chain swaps, to prevent accidental fund loss to centralized-exchange addresses.

## October 2025

### Swap UX

* **EVM same-chain swaps:** The edit-destination button is now hidden for EVM same-chain swaps, since EVM DEX contracts return tokens to `msg.sender` and editing the destination has no effect.

## September 2025

### New Props & Performance

* **`modalZIndex` prop:** Specify a custom `z-index` for all modals.
* **Faster page loads:** Assets, chains, bridges, and venues are now cached for faster subsequent loads on slower connections.
* **Cleanup:** Removed the legacy gas-station logic, and the route-preference selector is no longer shown when `goFast: false` is passed.

## August 2025

### Gas on Receive Feature

* **Gas on Receive (v3.14.0+):** Intelligent gas management feature that helps users obtain native gas tokens on destination chains during cross-chain swaps. Prevents users from getting "stuck" with assets they can't use due to lacking gas for future transactions. The widget auto-detects insufficient gas balances and shows a toggle for users to enable gas top-up routes. Supports Cosmos chains (0.10 USD) and EVM L2 chains (2.00 USD). [Learn more about Gas on Receive](/go/widget/gas-on-receive.md).

## June 2025

### Visual Widget Builder Launch

We're excited to announce the launch of **[studio.skip.build](https://studio.skip.build)** - our new interactive widget builder.

**Key Features:**

* **Visual Configuration:** Experiment with themes, colors, and settings through an intuitive interface
* **Live Preview:** See your changes in real-time before implementing them in code
* **Asset & Route Testing:** Test different asset combinations and routing scenarios
* **Code Generation:** Generate the exact props needed for your widget implementation

This tool significantly reduces integration time and helps developers create the perfect widget experience for their users without trial and error in their development environment.

### Transaction Signing Enhancement

* Added `batchSignTxs` prop to control transaction signing behavior. When enabled (default: true), all transactions in a multi-transaction route are signed upfront.

## Recent Key Updates (Spring 2025)

The Skip Go Widget has seen several improvements focusing on core functionality, user experience, and developer integration.

* **Updated Core Client Dependency:** The widget now utilizes `@skip-go/client` v1.x. This update brings underlying improvements in efficiency and API consistency from the client library.
* **User Interface and Experience:**
  * Swap settings changes now trigger an automatic refetch of route information.
  * Display of asset amounts and number formatting has been refined for better clarity.
  * The "Signature Required" prompt is now hidden after a transaction is signed.
  * Improved the display of estimated transaction fees, providing a more transparent breakdown of potential costs for all routes.
* **Developer Integration:**
  * **New Visual Widget Builder:** Launched [studio.skip.build](https://studio.skip.build) - an interactive tool that allows developers to visually configure widget settings, customize themes, test different asset combinations, and preview changes in real-time before implementing them in code.
  * Introduced an `onSourceAndDestinationSwapped` callback, allowing integrators to add custom logic when users switch the source and destination assets.

For a detailed list of all changes, including dependency updates and minor fixes, please refer to the [full CHANGELOG.md on GitHub](https://github.com/skip-mev/skip-go/blob/main/packages/widget/CHANGELOG.md).

## v2.5.2

* Change default fee asset selection on chain change.

## v2.5.0

* Fix max button & corresponding gas calculation and
* Remove gas amount option in settings


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.