1Book

1Book is a comprehensive DeFi dashboard that integrates deeply with the 1inch API ecosystem, offering a unified view of your crypto activity across multiple EVM-compatible blockchains. It provides tools for portfolio tracking, token swaps, intent-based gasless trades (Fusion), and cross-chain swaps (Fusion+), with a user-friendly interface designed for both casual users and advanced DeFi participants.

Core Features

1. Balance & Portfolio Tracking View wallet balances and token holdings across all supported EVM chains. Select a base currency (USD, ETH, BTC, etc.) to view portfolio valuation. Filter tokens by chain, symbol, or name. Export holdings to CSV for reporting or Proof of Reserve (PoR) use cases.

2. Classic Swaps (1inch Aggregation) Discover available tokens for swap on each chain using the 1inch Aggregation Protocol. View a list of supported liquidity sources (e.g., BALANCER_V2, UNISWAP_V3). Access 1inch Router contract addresses with explorer links. Generate real-time swap quotes with detailed gas cost estimates across urgency levels (standard, fast, instant, etc.).

3. Fusion (Intent-Based Gasless Swaps) View all active Fusion swap orders across chains. Expand orders to view fill status and associated transactions. Access settlement contract addresses and resolver metadata.

4. Fusion+ (Cross-Chain Swaps) Track cross-chain swap orders with full visibility into source/destination assets and chains. View escrow contract addresses per chain with links to explorers. Check the fill status and related transactions for each order, including gas and execution details.

5. Token Data Lookup Fetch native asset info from external providers (CoinGecko, CoinMarketCap). Retrieve token metadata using contract addresses and provider selection.

6. Chain Health & Explorer Monitor synced block numbers across supported chains. View live gas prices and chain status. Access explorer links and RPC endpoint status.

1Book is a full-stack web application built to unify access to portfolio, swap, and intent-based trading data using the 1inch API ecosystem and various external data providers.

This project is organized into two separate branches within a single GitHub repository:

frontend branch – Contains the Angular 18-based web application, including wallet integration, swap UI, and data visualization components.

backend branch – Contains the Node.js (Express) backend code responsible for interacting with the 1inch APIs, external providers (CoinGecko/CMC), and any planned indexing logic.

This structure helps maintain a clear separation of concerns while enabling easy deployment and updates to both layers independently.

Technologies Used Frontend Framework: Angular 18 Used for building a modular, reactive, and highly performant UI with route-based lazy loading and form controls.

Wallet Integration: wagmi, ethers.js, and WalletConnect v2 are used for EVM wallet integration and chain switching. Users can connect their MetaMask wallet to fetch balances and interact with swap quote modules.

UI Components:

Custom Angular Material-based components. Table views with advanced filtering (network, protocol, status) and expandable rows for nested data (e.g., Fusion order fills).

CSV Export: Uses papaparse and FileSaver to export wallet portfolios or order data.

Backend Runtime: Node.js (Express server)

Data Sources:

1inch APIs – For: Token metadata (/tokens) Swap quotes (/quote) Liquidity sources (/protocols)

Fusion & Fusion+ order status (custom reverse-engineered endpoints) CoinGecko / CoinMarketCap – For: Token prices and metadata resolution Native asset data (USD, ETH, BTC conversion)

Custom Indexer (in progress): Building a background sync service to index Fusion+ order states, filled txns, and escrow contract events using Ethers.js and JSON-RPC.

Multi-Chain Support Chains Supported: Ethereum, BNB Chain, Polygon, Arbitrum, Avalanche, Base, zkSync Era, Optimism, Linea, and others supported by 1inch.

Cross-chain Orders: Uses factory contract addresses from Fusion+ deployments to track escrowed orders and their cross-chain resolutions. Order tracking requires stitching together txns on source and destination chains via hash correlation.

Hacky/Interesting Bits Fallback pricing: When CoinGecko fails, it auto-switches to CMC without user disruption. 1inch Fusion+ isn't fully public: Reverse-engineered some undocumented API behavior and matched on-chain escrow txns with orders. Gas estimations: Normalized gas costs by urgency level and converted to both native token + USD. Order status UX: Built expandable table rows with recursive data-fetching to show sub-txns (fills) on click. Routing to explorers: Constructed deep links dynamically using chain config data, keeping Etherscan, BscScan, etc., unified via templates.

🤝 Partner Technology Benefits 1inch APIs were the backbone: saved weeks of development by exposing swap data, Fusion orders, router info, and token metadata via simple REST calls. wagmi + WalletConnect v2 made wallet onboarding smooth and cross-device friendly. CoinGecko & CMC API fallback ensures robustness against outages.