patcito

Frontend Changelog (main → staging)

New Features

PUT Dashboard

• FT Burn Chart — Cumulative FT burned over time with USD values, period selector (1w/1m/3m/6m/1y)
• FT/Capital Ratio Chart — Shows FT Value / Investment Value ratio over time
• Dashboard period dropdown and UI fixes
• stS token added to token config

patcito

PUT Dashboard - Burn Chart & FT/Capital Ratio

API Endpoints

Burn totals (in existing /tge/metrics response)

GET /tge/metrics

Response now includes ft_burns with per-chain cumulative totals and cross-chain total (chain_id: 0).

patcito

Swap Collateral — Frontend Integration Guide

Overview

Users can swap one collateral type for another within the FlyingTulip lending protocol. For example, swap USDC collateral to wS collateral (or any supported pair). The frontend signs an EIP-712 order and submits it to the executor API. The executor handles DEX routing and on-chain execution.

User Flow

1. User has collateral deposited in PositionsManager (e.g., USDC)
2. User signs an EIP-712 swap order specifying sellToken → buyToken

patcito

Swap Collateral via LeverageRfqEngine — Infra / Multisig Guide

Overview

The swapCollateralFlashWithSession function on the LeverageRfqEngine contract allows users to swap one collateral type for another within the FlyingTulip lending protocol (PositionsManager). The executor service acts as the filler, routing swaps through DEX aggregators (Odos) via a flash callback pattern.

Architecture

User signs EIP-712 order → Executor API → Service picks up order

patcito

# ftUSD User Activity — USD Sorting Changes

## What changed

The `/ftusd/user/{address}/transactions` endpoint now sorts by **USD value** instead of raw token amounts when using amount-based sorting.

## Sorting

Use the `sort` query parameter:

patcito

Wallet Widget Endpoint

GET /wallet/{address}

Returns FT token balance, puts/marketplace summary, and the 3 most recent user actions for the wallet widget.

No query parameters needed — aggregates across all chains automatically.

---

patcito

ftUSD Hook Architecture — useFTUSDActions

What changed

We replaced 6 legacy per-action hooks with a single consolidated useFTUSDActions hook. This mirrors the pattern used in lending (useLendingActions).

Deleted hooks

• useMintWithPermitAndFee — buy (mint) ftUSD
• useRedeemWithPermit — sell (redeem) ftUSD
• useStakeWithPermit — stake ftUSD to vault

patcito

FT Withdrawals Report — Ethereum PutManager

Contract: 0xbA49d0AC42f4fBA4e24A8677a22218a4dF75ebaA Event: WithdrawFT(address user, uint256 putId, uint256 amount) Report generated: 2026-02-23 21:28 UTC

Summary

Stat	Value

patcito

ftUSD Dashboard API — Frontend Integration Guide

Endpoint

GET /status/ftusd/dashboard

Query params:

• days — number of days for series (default 7, max 360)

patcito

/mm/lend — New userTransactions Field

What changed

When a ?user=0x... query param is provided, each chain object in the response now includes a userTransactions array containing the user's deposit/withdraw/borrow/repay history on that chain.

Response shape

{