zakat

A comprehensive, type-safe, and Fiqh-compliant Zakat calculation library for Rust.

Overview

This crate provides a complete solution for calculating Islamic Zakat obligations across all asset classes. It implements classical Fiqh rules with support for multiple schools of thought (Madhabs).

Features

• Type-safe calculations using rust_decimal for financial precision
• Support for Gold, Silver, Business, Agriculture, Livestock, Income, and Modern Assets
• Madhab-aware calculation strategies (Hanafi, Shafi'i, Maliki, Hanbali)
• Internationalization with RTL language support
• Hawl (lunar year) tracking
• Live metal pricing integration
• Multiple platform targets: Native, WASM, Python, Dart, Kotlin

Installation

[dependencies]
zakat = "1.0"

Quick Start

use zakat::prelude::*;

fn main() -> Result<(), ZakatError> {
    // Configure with Hanafi rules
    let config = ZakatConfig::hanafi()
        .gold_price_per_gram(65.0)
        .silver_price_per_gram(0.80)
        .build()?;

    // Calculate gold zakat
    let gold = PreciousMetals::gold(100.0)
        .purity(24)
        .calculate_zakat(&config)?;

    println!("Zakat due: {}", gold.zakat_due);

    // Portfolio calculation
    let mut portfolio = ZakatPortfolio::new();
    portfolio.add(PreciousMetals::gold(100.0));
    portfolio.add(BusinessZakat::new().cash(50000.0).inventory(25000.0));

    let total = portfolio.calculate_total(&config)?;
    println!("Total Zakat: {}", total.total_zakat);

    Ok(())
}

Asset Types

Feature Flags

Crate Structure

This is a facade crate that re-exports functionality from:

Platform Support

Documentation

• Rust API Docs
• Python Usage
• JavaScript/WASM Usage
• Flutter Usage

License

MIT