empoorio-sdk 0.1.3

# EmpoorioChain Rust SDK 🚀

Official Rust SDK for **EmpoorioChain**, a high-density, **Post-Quantum Secure Layer 1** blockchain. EmpoorioChain is purpose-built for the intersection of **Decentralized AI (DeAI)** and **Real-World Assets (RWA)**, providing a robust infrastructure for the future of value and intelligence.

[![Crates.io](https://img.shields.io/crates/v/empoorio-sdk.svg)](https://crates.io/crates/empoorio-sdk)
[![License](https://img.shields.io/badge/license-Proprietary-red.svg)](LICENSE)

---

## 🏛 The Vision: A Native L1 for the Machine Economy

EmpoorioChain is not just another blockchain; it is a **Native Layer 1** built on the Substrate framework, specifically optimized to handle the compute-heavy and high-security requirements of the machine economy.

### Core Pillars:
- **Post-Quantum Security (PQ)**: Leveraging **Dilithium5** signatures to protect assets against the threat of future quantum computers.
- **Ailoos AI Engine**: A native oracle system for decentralized AI inference, allowing trustless verification of AI model outputs.
- **Dynamic Monetary System (DMS)**: A sophisticated treasury and currency management system designed for stability and growth.
- **Hybrid RWA Layer**: Specialized pallets for tokenizing, fractionalizing, and managing real-world assets with built-in compliance.

---

## 🛠 Key Features

- **Quantum-Safe Vaults**: Full support for Dilithium5 key management and transaction signing.
- **Robust Connectivity**: Built on `subxt` and `jsonrpsee`, supporting both WebSocket (WSS) and HTTP/HTTPS with automatic failover and exponential backoff retries.
- **AI Oracle Interface**: First-class API for submitting inference jobs to specialized AI nodes and retrieving verified proofs.
- **DMS Integration**: Direct access to stablecoin info, treasury proposals, and governance mechanisms.

---

## 🚀 Getting Started

### Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
empoorio-sdk = "0.1.2"
tokio = { version = "1.0", features = ["full"] }
```

### 1. Connecting to the Network

The SDK comes pre-configured with official Testnet and Mainnet endpoints.

```rust
use empoorio_sdk::{EmpoorioClient, SdkConfig, NETWORKS};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Connect to the official Empoorio Testnet
    let config = SdkConfig::for_network("testnet");
    let client = EmpoorioClient::new(config).await?;

    println!("Connected to EmpoorioChain!");
    Ok(())
}
```

### 2. Querying AI Models

Interact with the native AI Registry to discover available models.

```rust
let models = client.ai().get_registered_models().await?;
for model in models {
    println!("Model ID: {}, Accuracy: {}%", model.id, model.accuracy);
}
```

### 3. Secure Transaction Signing

The SDK handles the complexity of hybrid signatures (Classical + Post-Quantum).

```rust
use empoorio_sdk::signer::PqcSigner;

let signer = PqcSigner::from_mnemonic("your secret mnemonic...")?;
let tx_hash = client.transfer(dest_address, amount).sign_and_send(&signer).await?;
println!("Transaction successfully broadcast: {:?}", tx_hash);
```

---

## 📂 Repository Structure

- `src/client.rs`: Robust client with retry logic and error handling.
- `src/config.rs`: Network configuration (Mainnet, Testnet, Local).
- `src/modules/`: Specialized modules for AI, DeFi, and RWA.
- `src/crypto/`: Dilithium5 and Ed25519 implementation.

---

## 📜 License

Copyright (c) 2026 Empoorio Inc. All rights reserved.  
This SDK is provided under a proprietary license. See the [LICENSE](LICENSE) file for more details.

---

## 📞 Support & Community

- **Official Website**: [empooriochain.org](https://empooriochain.org)
- **Documentation**: [docs.empooriochain.org](https://docs.empooriochain.org)
- **Developer Portal**: [dev.empooriochain.org](https://dev.empooriochain.org)