# NAC以太坊桥接模块

NAC到以太坊的跨链桥接功能，实现资产锁定/解锁、事件监听、交易验证和安全机制。

## 功能特性

### 1. 资产锁定/解锁

- ✅ NAC资产锁定
- ✅ 以太坊资产解锁
- ✅ 反向桥接
- ✅ 多签验证

### 2. 事件监听

- ✅ NAC链事件监听
- ✅ 以太坊事件监听
- ✅ 事件过滤
- ✅ 事件重放保护

### 3. 交易验证

- ✅ 跨链交易验证
- ✅ Merkle证明验证
- ✅ SPV验证
- ✅ 欺诈证明

### 4. 安全机制

- ✅ 资金上限控制
- ✅ 暂停机制
- ✅ 紧急提款
- ✅ 审计日志

## 使用示例

```rust
use nac_bridge_ethereum::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建桥接插件
    let bridge = EthereumBridgePlugin::new(
        "https://eth-mainnet.g.alchemy.com/v2/your-api-key",
        1,
        "0x1234567890123456789012345678901234567890".to_string(),
    ).await?;

    // 查询余额
    let balance = bridge.get_eth_balance("0xYourAddress").await?;
    println!("Balance: {}", balance);

    // 创建锁定/解锁管理器
    let signers = vec!["signer1".to_string(), "signer2".to_string()];
    let mut manager = LockUnlockManager::new(2, signers);

    // 记录锁定
    let lock = LockRecord {
        lock_id: "lock1".to_string(),
        eth_tx_hash: "0x123".to_string(),
        amount: 1000,
        token_address: None,
        nac_target_address: [0u8; 32],
        locked_at: 1234567890,
        status: LockStatus::Pending,
        signatures: vec![],
    };
    manager.record_lock(lock)?;

    // 创建事件监听器
    let mut listener = EventListener::new();

    // 创建安全管理器
    let config = SecurityConfig::default();
    let mut security = SecurityManager::new(config);

    // 验证交易金额
    security.validate_amount(1000, "ETH")?;

    Ok(())
}
```

## 测试

运行测试：

```bash
cargo test
```

测试覆盖范围：
- 锁定/解锁管理（3个测试）
- 事件监听（3个测试）
- 安全机制（3个测试）
- 以太坊桥接（2个测试）
- SPV验证（4个测试）

## 依赖

- `ethers`: 以太坊客户端
- `tokio`: 异步运行时
- `serde`: 序列化
- `chrono`: 时间处理
- `sha3`: 哈希算法
- `hex`: 十六进制编码

## 版本历史

### v0.4.0 (2026-02-18)

- ✅ 实现完整的资产锁定/解锁机制
- ✅ 实现事件监听系统
- ✅ 实现安全机制
- ✅ 添加15个单元测试
- ✅ 代码行数从594行增加到1500+行

### v0.3.0

- 基础的以太坊桥接功能

## 许可证

NAC公链项目专有

## 作者

NAC开发团队