Rust地址处理库 cw-address-like 使用指南

cw-address-like 是一个专门用于处理类地址字符串的Rust库，提供高效的解析和验证功能，特别适合区块链地址、哈希值等类地址格式的处理。

主要特性

• 轻量级高性能的地址解析
• 灵活的验证规则配置
• 支持多种编码格式（Base16, Base58, Bech32等）
• 提供标准化的地址格式化输出

安装方法

在Cargo.toml中添加依赖：

[dependencies]
cw-address-like = "0.3.0"

基本使用方法

1. 简单验证地址

use cw_address_like::AddressLike;

fn main() {
    let addr = "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02";
    
    if addr.is_address_like() {
        println!("有效的类地址字符串");
    } else {
        println!("无效的地址格式");
    }
}

2. 带前缀的地址验证

use cw_address_like::{AddressLike, Prefix};

fn main() {
    let addr = "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02";
    let prefix = Prefix::new("cosmos");
    
    match addr.validate_with_prefix(&prefix) {
        Ok(_) => println!("地址格式和前缀都有效"),
        Err(e) => println!("验证失败: {}", e),
    }
}

3. 解析地址获取详细信息

use cw_address_like::AddressLike;

fn main() {
    let addr = "0x71C7656EC7ab88b098defB751B7401B5f6d8976F";
    
    if let Some(info) = addr.parse_address_like() {
        println!("地址类型: {:?}", info.address_type());
        println!("原始数据: {:?}", info.raw_data());
        println!("格式化输出: {}", info.to_string());
    }
}

高级用法

自定义验证规则

use cw_address_like::{AddressLike, ValidationOptions};

fn main() {
    let options = ValidationOptions::new()
        .with_min_length(20)
        .with_max_length(40)
        .with_allowed_chars("0123456789abcdefABCDEF");
    
    let addr = "0x1a2b3c4d5e";
    
    match addr.validate_with_options(&options) {
        Ok(_) => println!("符合自定义验证规则"),
        Err(e) => println!("验证失败: {}", e),
    }
}

Bech32地址处理

use cw_address_like::{Bech32Address, Prefix};

fn main() {
    let prefix = Prefix::new("cosmos");
    let addr = Bech32Address::new(
        "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02",
        &prefix
    ).unwrap();
    
    println!("HRP: {}", addr.hrp());
    println!("数据部分: {:?}", addr.data());
}

性能提示

对于批量地址验证，建议使用AddressLikeBatchValidator以提高性能：

use cw_address_like::{AddressLikeBatchValidator, Prefix};

fn main() {
    let prefix = Prefix::new("cosmos");
    let mut validator = AddressLikeBatchValidator::new().with_prefix(&prefix);
    
    let addresses = vec![
        "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02",
        "cosmos1invalidaddress",
        "cosmos1anothervalidone",
    ];
    
    let results = validator.validate_all(&addresses);
    
    for (addr, result) in addresses.iter().zip(results.iter()) {
        println!("{}: {}", addr, if *result { "有效" } else { "无效" });
    }
}

完整示例

下面是一个完整的示例，展示了如何使用cw-address-like库进行地址的创建、验证和解析：

use cw_address_like::{
    AddressLike, 
    Prefix, 
    Bech32Address, 
    ValidationOptions,
    AddressLikeBatchValidator
};

fn main() {
    // 1. 简单地址验证
    let cosmos_addr = "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02";
    println!("验证地址 {}: {}", cosmos_addr, cosmos_addr.is_address_like());
    
    // 2. 带前缀的地址验证
    let prefix = Prefix::new("cosmos");
    match cosmos_addr.validate_with_prefix(&prefix) {
        Ok(_) => println!("前缀验证通过"),
        Err(e) => println!("前缀验证失败: {}", e),
    }
    
    // 3. 解析以太坊地址
    let eth_addr = "0x71C7656EC7ab88b098defB751B7401B5f6d8976F";
    if let Some(info) = eth_addr.parse_address_like() {
        println!("解析以太坊地址成功:");
        println!("类型: {:?}", info.address_type());
        println!("原始数据: {:?}", info.raw_data());
    }
    
    // 4. 自定义验证规则
    let options = ValidationOptions::new()
        .with_min_length(20)
        .with_max_length(40)
        .with_allowed_chars("0123456789abcdefABCDEF");
    
    let test_addr = "0x1a2b3c4d5e";
    match test_addr.validate_with_options(&options) {
        Ok(_) => println!("自定义规则验证通过"),
        Err(e) => println!("自定义规则验证失败: {}", e),
    }
    
    // 5. Bech32地址处理
    let bech32_addr = Bech32Address::new(cosmos_addr, &prefix).unwrap();
    println!("Bech32地址解析:");
    println!("HRP: {}", bech32_addr.hrp());
    println!("数据: {:?}", bech32_addr.data());
    
    // 6. 批量验证
    let mut validator = AddressLikeBatchValidator::new().with_prefix(&prefix);
    let addresses = vec![
        "cosmos1hsk6jryyqjfhp5dhc55tc9jtckygx0eph6dd02",
        "cosmos1invalidaddress",
        "cosmos1anothervalidone",
    ];
    
    let results = validator.validate_all(&addresses);
    for (addr, result) in addresses.iter().zip(results.iter()) {
        println!("地址 {} 验证结果: {}", addr, if *result { "有效" } else { "无效" });
    }
}

这个完整示例演示了cw-address-like库的主要功能，包括地址验证、前缀检查、地址解析、自定义规则验证、Bech32地址处理以及批量验证等功能。