Rust NEAR协议Gas费计算库near-gas的使用

near-gas是一个用于在Rust项目中便捷操作NEAR协议gas单位的库。该库提供了NearGas类型和构造函数，可以方便地在NearGas和u64类型值之间进行转换。

基础示例

use near_gas::NearGas;

fn main() {
    let data = "12.657 tgas";

    let near_gas: NearGas = data.parse().unwrap();

    // 将值转换为最精确的"gas"单位
    assert_eq!(near_gas.as_gas(), 12657000000000);
    // 将值转换为"gigagas"单位
    assert_eq!(near_gas.as_ggas(), 12657);
    
    // 显示Gas。将打印:"Here is 12.7 Tgas"
    println!("Here is {}", near_gas);

    // 当启用`serde`功能时，NearGas可用于serde可序列化的结构体
    // NearGas将被序列化为gas精度的u64值，编码为字符串
    #[derive(serde::Serialize)]
    struct FunctionCallDetails {
        used_gas: NearGas,
    }

    let details = FunctionCallDetails { used_gas: near_gas };

    assert_eq!(serde_json::to_string(&details).unwrap(), r#"{"used_gas":"12657000000000"}"#);
}

完整智能合约示例

以下是一个更完整的智能合约示例，展示如何使用near-gas库来估算和管理gas费用：

use near_gas::NearGas;
use near_sdk::borsh::{self, BorshDeserialize, BorshSerialize};
use near_sdk::{env, near_bindgen};

// 定义合约结构体
#[near_bindgen]
#[derive(BorshDeserialize, BorshSerialize)]
pub struct GasOptimizationContract {
    total_gas_used: NearGas,  // 记录总gas使用量
}

// 默认实现
impl Default for GasOptimizationContract {
    fn default() -> Self {
        Self {
            total_gas_used: NearGas::from_ggas(0), // 初始化为0 Ggas
        }
    }
}

#[near_bindgen]
impl GasOptimizationContract {
    // 执行需要gas估算的操作
    pub fn perform_operation(&mut self, complexity: u64) {
        // 根据操作复杂度估算gas消耗
        let estimated_gas = self.estimate_gas_cost(complexity);
        
        // 记录当前gas使用情况
        let current_gas = NearGas::from_gas(env::used_gas());
        
        // 更新总gas使用量
        self.total_gas_used = self.total_gas_used + current_gas;
        
        // 打印gas使用信息
        println!("Estimated gas: {}", estimated_gas);
        println!("Actual gas used: {}", current_gas);
        println!("Total gas used so far: {}", self.total_gas_used);
        
        // 比较估算和实际使用情况
        if current_gas > estimated_gas {
            println!("Warning: Gas usage exceeded estimate by {}", current_gas - estimated_gas);
        }
    }
    
    // 估算gas成本的方法
    fn estimate_gas_cost(&self, complexity: u64) -> NearGas {
        // 简单的线性模型来估算gas
        // 基础gas + 复杂度系数 * 复杂度
        let base_gas = NearGas::from_ggas(5); // 5 Ggas基础成本
        let coefficient = NearGas::from_ggas(2); // 2 Ggas每单位复杂度
        
        base_gas + coefficient * complexity
    }
    
    // 获取总gas使用量
    pub fn get_total_gas_used(&self) -> String {
        format!("{}", self.total_gas_used)
    }
}

// 单元测试
#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn test_gas_estimation() {
        let contract = GasOptimizationContract::default();
        
        // 测试简单操作
        let simple_op = contract.estimate_gas_cost(1);
        assert_eq!(simple_op.as_ggas(), 7); // 5 + 2*1 = 7 Ggas
        
        // 测试复杂操作
        let complex_op = contract.estimate_gas_cost(10);
        assert_eq!(complex_op.as_ggas(), 25); // 5 + 2*10 = 25 Ggas
    }
    
    #[test]
    fn test_gas_operations() {
        let gas1 = NearGas::from_ggas(5);
        let gas2 = NearGas::from_ggas(3);
        
        // 测试加法
        assert_eq!(gas1 + gas2, NearGas::from_ggas(8));
        
        // 测试乘法
        assert_eq!(gas2 * 2, NearGas::from_ggas(6));
        
        // 测试减法
        assert_eq!(gas1 - gas2, NearGas::from_ggas(2));
    }
}

安装和使用

要在项目中使用near-gas库，可以通过以下方式添加依赖：

在Cargo.toml中添加：

[dependencies]
near-gas = "0.3.1"

或者直接运行Cargo命令：

cargo add near-gas

特性支持

near-gas库提供了多个可选特性：

• serde - 支持serde序列化
• borsh - 支持borsh序列化
• abi - 支持near-abi
• schemars - 支持schemars
• interactive-clap - 支持interactive-clap

许可证

该项目采用MIT许可证和Apache-2.0许可证双重授权。