UniPay

UniPay is a Telegram-based, DeFi-powered payment orchestrator that enables users to send a single payment using multiple wallets, tokens, and chains, while allowing the receiver to control how the funds are finally settled. A sender can register a primary wallet, add secondary wallets with available funds, and initiate a payment by specifying multiple payment “legs” (amount in USD, token, chain, and source wallet) directly in a Telegram message.

The bot parses this intent, validates balances and routes, and uses LI.FI Composer to orchestrate multi-step cross-chain swaps and bridges into a single atomic workflow. If the receiver has set a preferred token and chain, all incoming funds are automatically swapped and bridged to that preference. If no preference is set, funds are either delivered as-is or temporarily held in an escrow contract until the receiver defines their settlement preference.

By abstracting complex DeFi actions behind a simple conversational interface, the project turns fragmented, multi-chain payments into a seamless, one-command experience while leveraging LI.FI as the cross-chain execution and liquidity layer.

The project is built as a modular system with a lightweight frontend, a Telegram bot interface, a backend orchestration layer, and minimal on-chain contracts. The frontend is built with Next.js and serves as a landing page and demo interface, while all user interactions happen through a Telegram bot built using grammY, which provides structured conversational flows and command handling.

The Telegram bot acts purely as a UX layer. It parses user intent, validates inputs, and forwards structured payment instructions to the backend. The backend is written in Node.js with TypeScript and is responsible for orchestration, validation, and execution. It integrates LI.FI Composer to construct and execute multi-step DeFi workflows, including token swaps and cross-chain bridges, allowing multiple payment legs to be aggregated and settled atomically.

On-chain logic is kept minimal and focused, with an optional escrow smart contract used when a receiver has not yet defined settlement preferences. This contract safely holds funds until preferences are set or a fallback condition is met. ENS resolution, route validation, and slippage checks are handled off-chain to keep transactions efficient. A notable “hacky” aspect is the conversational payment format, which allows users to express complex multi-chain payment intent directly in a Telegram message and have it executed as a single composable DeFi flow.