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

# Changelog

> Additions, updates, and fixes to InterwovenKit

**May 9, 2026**

v2.9.0

## Strat perp and vault positions in portfolio

The portfolio now displays Strat perpetual futures positions and vault deposits
alongside other positions. Vault deposits appear inline (without a rewards
breakdown) since they don't accrue claimable rewards, while perp positions are
shown by market.

**April 21, 2026**

v2.8.0

## Exported `EnableAutoSignOptions` type

Minor improvements

**April 21, 2026**

v2.7.0

## Configurable default duration when enabling autosign

[`autoSign.enable()`](https://docs.initia.xyz/interwovenkit/features/autosign/api-reference) now
accepts an optional `defaultDuration` so apps can preselect how long autosign
stays active when the enable dialog opens.

**April 7, 2026**

v2.6.0

## Smarter wallet ordering on sign-in

The wallet connection screen now sorts sign-in wallets by popularity and
recency. Your most recently used wallet appears first, followed by widely used
wallets, so connecting is faster on repeat visits.

## Improved bridge route refresh experience

Bridge and [deposit](https://docs.initia.xyz/interwovenkit/features/transfers/deposit-withdraw.md) flows
now show inline status messages (such as "Refreshing route..." and "Estimating
gas...") while routes are being updated in the background. The confirm button is
disabled until fresh data is ready, and stale route errors automatically retry
when a new quote arrives.

## Bug fixes

* Bridge fee warnings now correctly account for the gas token balance remaining
  after the swap, preventing false warnings on large non-max inputs.
* The bridge now warns when the source gas token balance would be insufficient
  to cover fees after executing a transfer.
* Preview fee checks in the bridge are now guarded for external chains,
  preventing incorrect fee validation on non-Initia sources.
* Tokens with no available price data now display `$-` instead of `$0` in the
  bridge.
* The bridge now shows an insufficient-balance error for tokens with a zero
  balance instead of allowing submission.
* The withdraw button in the deposit flow is now disabled when the balance is
  zero.
* The deposit flow now warns when sending the max amount of a gas token would
  leave no balance to cover the transaction fee.
* Hex addresses are now accepted as bridge recipients on Initia EVM chains.
* Fixed a browser compatibility issue where `.toSorted()` was not available in
  some environments.

**March 26, 2026**

v2.5.1

## Bug fixes

* Fixed [autosign](https://docs.initia.xyz/interwovenkit/features/autosign/introduction.md) failing to
  verify the derived wallet account on MiniEVM rollups. The account existence
  check now uses the correct Initia address format instead of the EVM hex
  address.

**March 25, 2026**

v2.5.0

## Accessibility improvements

The widget now includes comprehensive accessibility attributes across all
interactive elements. Forms, sections, icon-only buttons, collapsible triggers,
and loading states all carry appropriate ARIA labels and roles. Decorative icons
are marked as hidden, and semantic landmarks (`<nav>`, `<section>`) improve
screen reader navigation throughout the widget.

## AUSD deposit source for iUSD

[Deposits](https://docs.initia.xyz/interwovenkit/features/transfers/deposit-withdraw.md) now support AUSD
from Ethereum as an additional source for iUSD transfers, alongside the existing
USDC source.

## Test wallet factories

New `createTestWalletConnector` and `createTestCosmosWallet` factory functions
make it easier to set up automated test environments. Developers can create
in-memory EVM and Cosmos wallets from a mnemonic or private key without needing
browser extensions or external wallet apps.

## Bug fixes

* EVM bridge transactions that exceed the confirmation timeout now save to
  history and show a pending notification instead of failing silently.
* The fee warning in the bridge no longer appears when an alternative gas token
  has sufficient balance on the source chain.
* Deposit route errors are handled more gracefully, preserving the last valid
  route during transient failures and showing clear status messaging.
* Assets with missing price data now display `$-` instead of `$0` in the deposit
  and send flows.
* Deposit validation no longer flags insufficient balance while balances are
  still loading.
* Fixed a layout glitch where switching between the modal and drawer caused the
  container to reset.
* Renamed user-facing references from "appchain" to "app" for consistency with
  current Initia terminology.

**March 2, 2026**

v2.4.6

## Optional address in `useUsernameQuery`

The `useUsernameQuery` hook now accepts an optional `address` parameter. When
provided, the hook resolves the username for the given address instead of the
connected wallet. When omitted, it falls back to the connected wallet address as
before.

**February 26, 2026**

v2.4.5

## Indexer-based asset price queries

Asset price queries now use the Initia indexer API (`indexer.initia.xyz`)
instead of the general REST API, providing faster and more reliable price data.

## Bug fixes

* Fixed deposit source filtering to respect explicitly provided `srcOptions`
  instead of merging them with internal overrides.

**February 26, 2026**

v2.4.4

## Minimum received for swap routes

Bridge swap routes now display the minimum amount the user will receive after
slippage, calculated with full BigNumber precision.

## iUSD deposit sources

Deposits now support iUSD with USDC as an additional external source. The
deposit flow includes source-aware empty-state messaging that explains why no
assets are available and guides users on where to acquire them.

## Route refresh and requoting

Bridge routes now automatically refresh and requote when they become stale
(older than 10 seconds). A new polling system checks route freshness at
intervals based on the route type — 2 seconds for L2, 5 seconds for L1, and 10
seconds for other routes.

## Improvements

* Deposit flow auto-prefills the destination when only a single transfer target
  is available.
* Removed the Civitia integration from the portfolio.

## Bug fixes

* Scoped query cache cleanup to InterwovenKit-prefixed queries only, preventing
  accidental clearing of host application caches.
* Wrapped deposit rendering in an `AsyncBoundary` to prevent Suspense from
  blocking the modal dialog.
* Hidden VIP positions with no remaining value from the portfolio view.
* Fixed unit symbol truncation in activity change entries by removing overflow
  constraints.
* Prevented invalid balance queries when switching chains by adding strict
  bech32 address validation.

**February 23, 2026**

v2.4.3

## CLAMM liquidity positions

The portfolio now displays Concentrated Liquidity AMM (CLAMM) positions
alongside traditional pool-based LP positions. This release includes a full
CLAMM math library ported from the on-chain Move contracts, including Q64.64
fixed-point arithmetic, tick-to-sqrt-price conversions, and liquidity amount
calculations.

Each CLAMM position shows the token pair, in-range or out-of-range status, and
the calculated value of both tokens in the position. The liquidity data layer
was refactored into focused submodules for pools, CLAMM, query keys, and shared
types.

**February 19, 2026**

v2.4.2

## Bug fixes

* Fixed autosign not persisting after page reload when using direct submit. The
  derived wallet is now re-derived once per page session when auto-sign is
  enabled, so direct signing continues to work after reload.

**February 19, 2026**

v2.4.1

## Bug fixes

* Fixed autosign domain verification for subdomains. When the registered
  hostname is an apex domain or `www.` variant, any subdomain under that
  registrable domain is now accepted. For example, registering `www.civitia.org`
  now also allows `app.civitia.org`.

**February 17, 2026**

v2.4.0

## Signature-derived autosign wallet

The autosign system has been rebuilt from the ground up. The previous
Privy-based embedded wallet has been replaced with a signature-derived wallet
that requires no third-party dependencies.

When a user enables autosign, InterwovenKit requests an EIP-191 personal
signature from the connected wallet and derives an HD wallet from it using a
keccak256-to-BIP39-to-SLIP10 derivation path (inspired by dYdX). This derived
wallet signs transactions via authz delegation, with a new `AutoSignFeePolicy`
configuration for controlling gas multipliers and allowed fee denominations.

The release also adds Amino encoding support for `AllowedMsgAllowance` in fee
grants, domain verification using the `psl` package for public suffix awareness,
and comprehensive test coverage across the autosign flow. The
`@privy-io/react-auth` dependency has been fully removed, reducing the bundle
size significantly.

## E2E test wallet

A programmatic test wallet is now available for end-to-end testing. When the
`INITIA_TEST_MNEMONIC` environment variable is set, the example app
automatically creates an EIP-1193 provider from the mnemonic and registers it as
an injected wagmi connector.

**February 16, 2026**

v2.3.0

## Version header in API requests

InterwovenKit now sends an `InterwovenKit-Version` header with every Router API
request, populated from a build-time constant. This enables the Initia backend
to track which version of InterwovenKit is making requests, improving debugging
and compatibility monitoring. The version display in the wallet UI also uses
this build-time constant instead of reading from `package.json` at runtime.

**February 14, 2026**

v2.2.5

## Redesigned wallet connection UI

The wallet connection screen has been completely redesigned. The new UI features
a two-step flow: a primary sign-in view with social login options (Google, X,
Email) and a secondary all-wallets view with search and the WalletConnect
directory. The layout includes slide animations between views and a scrollable
wallet list for mobile. Uninstalled wallets now show as disabled buttons instead
of external links.

## Unified transfer flow

The deposit and withdraw flows have been consolidated into a single shared
`TransferFlow` component that accepts a transfer mode ("deposit" or "withdraw").
This eliminates duplicate field components and ensures consistent behavior
between deposit and withdraw operations, with mode-specific asset key mappings
and empty state copy.

## Bug fixes

* Added `@initia/opinit.proto` as a peer dependency to prevent missing module
  errors.
* Fixed L2 denom resolution by falling back to trace counterparty lookup when
  direct denom matching fails.
* Bridge now falls back to a valid asset with an info notification when the
  selected denom is not supported on the target chain.
* Bridge falls back to alternative routes (preferring OP withdrawal) when the
  primary route returns an error.

**February 4, 2026**

v2.2.4

## VIP rewards in portfolio balance

The portfolio total balance on the Initia L1 chain now includes VIP reward
values. Previously, VIP rewards were displayed separately but not counted toward
the chain's total balance.

## OP bridge migration detection

The bridge now detects whether an OP bridge has been migrated to instant
withdrawal by querying the `/migration_info/by_l1_denom` API. Migrated bridges
skip the OP withdrawal reminder since instant withdrawals don't require a
waiting period.

## Bug fixes

* Fixed deposit and withdraw validation to use BigNumber instead of `Number()`
  for quantity checks, preventing edge cases with large or precise amounts.
* Resolved cross-chain denom logo collisions by using `chainId:denom` composite
  keys in the asset logo map instead of bare denom strings.
* The Fast/Lossless route toggle now only appears when both route options have
  loaded data and the OP withdrawal duration exceeds the default route duration.
* Patched `brace-expansion` transitive vulnerability via dependency override.

**February 1, 2026**

v2.2.3

## Bug fixes

* Fixed a query key collision between `useDenoms` and `WithDenom` where both
  queries shared the same cache key but expected different return types. The
  `useDenoms` query function now returns the full response object and uses a
  `select` transform, giving each query a distinct cache shape.

**January 28, 2026**

v2.2.2

## Improvements

* Increased home navigation icon size from 16px to 20px for better tap targets.
* Simplified SSE reconnection logic by removing exponential backoff and letting
  the server manage reconnection. Added a `useRefreshPortfolio` hook with 1000ms
  throttle for manual portfolio refresh triggers.

**January 24, 2026**

v2.2.1

## Video assets moved to CDN

Transfer completion and loading animations are now loaded from
`assets.initia.xyz/videos/` instead of being bundled with the package. This
removes four `.mp4` files from the build output, reducing the package size.
Video end detection was also improved by switching from the `onEnded` event to
`onTimeUpdate` with a 100ms threshold check.

**January 23, 2026**

v2.2.0

## Portfolio

A complete portfolio view is now available in the wallet. The portfolio is
powered by a real-time Minity SSE connection that streams balance updates as
they happen, with optimized re-rendering that only triggers React Query updates
on aggregated data changes.

The portfolio displays staking positions (delegations, unbonding, and rewards),
DEX liquidity positions, VIP rewards, and per-chain asset breakdowns with
position groups. A dedicated data layer handles Initia staking, liquidity, VIP,
and position total calculations, backed by extensive test coverage.

## Deposit and withdraw

A new transfer flow enables depositing assets from external chains into
Interwoven Rollups and withdrawing them back. The flow includes external and
local asset selection, quantity input with route simulation via the Skip API,
transaction execution with OP bridge withdrawal tracking, and completion
animations with explorer links.

## Improvements

* Upgraded `@base-ui-components/react` to `@base-ui/react` 1.0.0 stable release.
* Added responsive layout with mobile menu to the example application.
* Disabled Minity API calls on testnet to avoid unnecessary errors. Testnet uses
  on-chain balance queries instead.

## Bug fixes

* Bridge now shows a dash (`$-`) instead of `$0` when a route price is
  unavailable.

**January 23, 2026**

v2.1.1

## Autosign safety improvements

Enabling autosign now checks whether the derived wallet account exists on-chain
before proceeding. If the account doesn't exist (no funds), the enable button is
disabled with an appropriate error message.

Additionally, when enabling autosign, any existing authz grants and fee grants
from previous sessions are automatically revoked before creating new ones. The
grant and fee grant API logic has been extracted into a shared `useAutoSignApi`
hook for reuse across enable and disable flows.

**November 18, 2025**

v2.1.0

## Autosign

InterwovenKit now includes a complete autosign system. When enabled,
transactions are automatically signed using a Privy embedded wallet with authz
delegation, removing the need for manual wallet approval on each transaction.

The implementation includes an enable modal with configurable duration options
(10 minutes, 1 hour, 1 day, 7 days, or until revoked), website domain
verification, a settings page for managing active grants with live expiration
countdowns, and a revoke flow. The signing layer wraps messages in `MsgExec` for
authz-delegated execution.

New pages include: autosign enable modal, receive page with QR code, settings
page, and manage autosign page with per-grant revocation.

## IBC NFT transfers

Send NFT now supports IBC transfers across all VM types. The implementation
includes VM-specific parameter generation for EVM (class ID and token ID
mapping), Move (collection name resolution), and Wasm (ICS721 contract mapping).
Each handler resolves the appropriate IBC class trace for cross-chain NFT
transfers.

## Improvements

* Extracted a reusable `NftHeader` component, replacing duplicate header
  implementations.
* Added a generic `Dropdown` component built on Base UI Select.
* Replaced the reject button text with a close icon in the transaction request
  view.
* Added CSS property ordering via stylelint.

**October 16, 2025**

v2.0.6

## Deleted chain fallback

Chains that have been removed from the registry are no longer treated as
missing. InterwovenKit now fetches `profiles.json` as a fallback and returns
minimal chain information for deleted chains, preventing crashes when users have
assets on deprecated rollups. The Skip bridge also uses this fallback for chain
resolution.

## NFT transfer validation

Before sending an NFT, InterwovenKit now simulates the transfer transaction. If
the simulation fails (indicating a non-transferable NFT), the send button is
disabled with a "Non-transferable NFT" message.

## REST API public key fetching

The signer now attempts to fetch the account's public key from the Initia L1
REST API before falling back to signature-based derivation. Retrieved public
keys are cached in localStorage for subsequent uses, reducing the number of
signing prompts needed.

## Improvements

* Chain selector now displays the total USD value and NFT count for each chain.
* Send forms display contextual disabled messages explaining why submission is
  blocked.
* Dependencies updated to React 19.2.0, wagmi 2.17.2, and cosmjs 0.36.1.

## Bug fixes

* Max button is now disabled when the balance is zero.
* Fixed NFT thumbnail rendering by removing conditional display logic.
* Send page no longer throws an error when the asset list is empty if a denom is
  available in navigation state.

**October 15, 2025**

v2.0.5

## Collapsible fee breakdown

When a transaction fee exceeds the user's balance, a new collapsible panel shows
a detailed breakdown of the spend amount, fee amount, total, and current
balance. Fee display precision has also been increased to 8 decimal places for
very small fee amounts that previously showed as `0.000000`.

## Configurable glyph URL

The `glyphUrl` configuration option lets you specify a custom URL for loading
glyph assets, replacing the previously hardcoded URL. Default values are set for
mainnet and testnet.

## Bug fixes

* Fixed drawer backdrop not responding to clicks in production by adding an
  explicit `onClick` handler.
* Chain dropdown now shows all chains with a balance, regardless of their USD
  value.
* Send page now throws a descriptive error when the primary asset is missing
  instead of failing silently.

**October 1, 2025**

v2.0.4

## Transaction timing parameters

`requestTxBlock`, `submitTxBlock`, and `waitForTxConfirmation` now accept
`timeoutMs` and `intervalMs` parameters for configuring transaction polling
behavior. The default poll interval has been reduced from 1000ms to 500ms for
faster confirmation detection. Error handling was also improved by returning
`Error` objects from `normalizeError` instead of plain strings.

**September 30, 2025**

v2.0.3

## Custom fee handling

A new `TxParams` interface and `submitTxBlock`/`submitTxSync` functions give
developers programmatic control over transaction fee configuration, enabling
custom fee logic beyond the built-in fee selector.

## Bridge UI improvements

The bridge has received several UI improvements. Route selection now shows
loading skeletons and redesigned option cards. Bridge history items are grouped
by date with time-only timestamps. The fee selector separates the amount display
from the token selector for clarity.

## Improvements

* Numeric inputs now handle pasted formatted numbers (e.g., `1,234,567.890`) by
  stripping grouping separators.
* Modals use trap-focus behavior for better accessibility, with `tabIndex=-1` on
  auxiliary buttons.

## Bug fixes

* Fixed sequence conflicts in same-chain OP hook transactions by incrementing
  the account sequence by 2 for parallel message execution.

**September 30, 2025**

v2.0.2

## Improvements

* Switched to dedicated indexer endpoints for chain data queries, improving
  response times and reliability.
* Fee denom fetching is now optimized to skip transaction queries when only a
  single fee token is available.
* Activity list guards against entries with missing timestamps to prevent
  rendering errors.

**September 30, 2025**

v2.0.1

## Bug fixes

* Fixed NFT deduplication by using `collection_addr` combined with `token_id` as
  the unique key instead of token ID alone, preventing collisions across
  different NFT collections.


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