SmartLogix
The Operating System for Trustless Supply Chains.
About
The problem it solves ## 💡 The Problem & Solution ### The Problem: A Broken, Slow, and Opaque Supply Chain Global logistics is currently stuck in the past, facing three critical bottlenecks that cost the industry billions annually: 1. **The "Cash Flow" Trap:** Small carriers and truckers are the backbone of logistics, yet they are forced to wait **60-90 days** for payment on completed jobs. This lack of liquidity kills small businesses. 2. **The Compliance Black Hole:** Cross-border shipping involves navigating complex, ever-changing customs regulations. Manual errors in HS Code classification or missing documents lead to **stalled shipments and massive fines**. 3. **Greenwashing:** Everyone talks about sustainable shipping, but there is no **verifiable incentive** for drivers to choose cleaner routes. "Eco-friendly" is often just a marketing buzzword with no proof. ### The Solution: SmartLogix – The AI + DePIN Logistics OS SmartLogix bridges the gap between **Generative AI** and **Decentralized Finance (DeFi)** to build a trustless, autonomous supply chain. * **💸 Logi-Fi (DeFi for Logistics):** We solved the cash flow problem by tokenizing invoices. Our **"Instant Factoring"** smart contract allows carriers to sell their future invoice claims to a liquidity pool for **98% immediate cash**. No banks, no waiting—just code. * **🤖 AI Compliance Agent:** Using **Google Gemini 2.0**, we built an intelligent customs broker. Users essentially drag-and-drop a product image, and the AI automatically determines the **HS Code**, checks international **WCO trade laws**, and generates a risk assessment score in milliseconds. * **🌱 Proof of Eco-Driving:** We moved sustainability from "goodwill" to "profit." Our routing algorithms calculate the carbon footprint of every path. Drivers who verifiable take the lower-carbon route are automatically rewarded with **SLX-CC (Carbon Credit) tokens** on-chain, creating a real financial incentive to save the planet. --- ### 🎨 One-Liner > *"SmartLogix is an AI-powered logistics platform that automates compliance, tokenizes invoices for instant liquidity provided by DeFi pools, and incentivizes eco-friendly driving with on-chain carbon credits."*
How it's made
Challenges we ran into ## ⚠️ Challenges We Ran Into ### 1. The "Hallucinating AI" JSON Parser **Problem:** Our AI Compliance Officer (Gemini 2.0) would occasionally return explanations *outside* the requested JSON format, or include Markdown code blocks (```json) that broke our standard `JSON.parse` logic. This caused the backend to crash unpredictably during demos. **Solution:** We implemented a robust **"Aggressive Sanitization" layer** in [complianceRoutes.js](cci:7://file:///c:/Users/dhruv/projects/SmartLogix/backend/Routes/complianceRoutes.js:0:0-0:0). It uses regex to isolate the JSON object from the AI's "chatter," strips Markdown artifacts, and even auto-corrects syntax errors like trailing commas before parsing. ### 2. Geocoding "Fuzzy" Logistics Data **Problem:** Real-world shipping data is messy. Inputs like "Jawaharlal Nehru Port" would fail standard geocoders, breaking our route optimization map. The API would return "No Results," leaving the UI blank. **Solution:** We built a **Multi-Strategy Fallback Geocoder**. If the exact port name fails, our algorithm automatically progressively simplifies the query: stripping suffixes (e.g., "International Airport"), trying only the city name, and finally defaulting to the region. This ensures the map *always* renders a valid path. ### 3. Bridging Web2 AI with Web3 Transactions **Problem:** Triggering blockchain transactions from AI events was tricky. We needed a way to verify that a driver *actually* took the AI-suggested green route before minting Carbon Credits, without requiring the user to be a blockchain expert. **Solution:** We created a seamless "Proof of Eco-Driving" flow. The frontend acts as an oracle: it verifies the route parameters against the AI's sustainability score combined with the user's selection and acts as the signer for the transaction, allowing users to mint `SLX-CC` tokens with a single click, abstracting away the complex contract interaction. ### 4. Smart Contract Liquidity for "Logi-Fi" **Problem:** Our "Instant Factoring" feature (Logi-Fi) initially failed because the deployed contract had no ETH to pay out users, causing `estimateGas` errors that looked like code bugs. **Solution:** We realized we needed to bootstrap the **DeFi Liquidity Pool**. We added a dedicated "Add Liquidity" interface for the DAO admins to fund the contract, ensuring that when a carrier clicks "Get Instant Cash," the contract has the solvency to execute the transfer immediately.