oinch 0.1.3

<p align="center">
  <img src="https://raw.githubusercontent.com/yldfi/yldfi-rs/main/logo-128.png" alt="yld_fi" width="128" height="128">
</p>

<h1 align="center">oneinch</h1>

<p align="center">
  Unofficial Rust client for the <a href="https://1inch.io/">1inch</a> DEX Aggregator Swap API v6.0
</p>

<p align="center">
  <a href="https://crates.io/crates/oinch"><img src="https://img.shields.io/crates/v/oneinch.svg" alt="crates.io"></a>
  <a href="https://github.com/yldfi/yldfi-rs/blob/main/crates/oneinch/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
</p>

## Overview

1inch is one of the most popular DEX aggregators, offering optimal swap routes across hundreds of liquidity sources on multiple chains.

## Features

- Multi-chain support (Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, etc.)
- Advanced Pathfinder algorithm for optimal routing
- Type-safe request/response handling
- Automatic rate limiting awareness
- Token approval helpers

## Authentication

The 1inch API requires an API key. Get yours at [portal.1inch.dev](https://portal.1inch.dev).

## Rate Limits

- **Free tier**: 1 request per second, 100,000 calls per month
- Higher tiers available for production use

## Quick Start

```rust
use oinch::{Client, Chain, QuoteRequest};

#[tokio::main]
async fn main() -> Result<(), oinch::Error> {
    // Create client with your API key
    let client = Client::new("your-api-key")?;

    // Get a quote for swapping 1 ETH to USDC on Ethereum
    let request = QuoteRequest::new(
        "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE", // Native ETH
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
        "1000000000000000000", // 1 ETH in wei
    );

    let quote = client.get_quote(Chain::Ethereum, &request).await?;
    println!("Expected output: {} USDC", quote.to_amount);

    Ok(())
}
```

## Installation

```toml
[dependencies]
oinch = "0.1"
tokio = { version = "1", features = ["full"] }
```

## Terms of Service

This is an **unofficial** client. By using this library, you agree to comply with [1inch Terms of Use](https://1inch.io/terms-of-use/).

## Disclaimer

This crate is not affiliated with or endorsed by 1inch Network.

## License

MIT