Yieldx

Demo

About

The problem it solves Across Africa, millions of exporters face a persistent barrier. Once goods are shipped, payment delays of 30 to 90 days are common. This waiting period creates severe cash flow constraints, limiting the ability of small and medium-sized exporters to accept new orders, grow their businesses, or meet buyer demand. Traditional trade finance solutions are either inaccessible or too slow, weighed down by bureaucracy, collateral requirements, and high interest rates. The result is a forty billion dollar trade finance gap, an urgent structural issue that hinders economic development across the continent. YieldX Protocol offers a new approach. It introduces a blockchain-based infrastructure that transforms verified export invoices into tokenized financial assets. These receivables, minted as ERC721 NFTs, can be funded by global DeFi investors using USDC. This enables exporters to access immediate liquidity, bypassing the traditional months-long payment cycle, and gives investors access to real-world, yield-generating assets. How It Works: End to End Business Flow Exporter Invoice Submission Exporters upload their export invoices along with supporting documents such as bills of lading, customs declarations, and purchase orders directly to the platform. Document Verification and Tokenization Invoices and accompanying documents are automatically verified using Chainlink Functions. These smart oracles interact with government and third-party APIs to authenticate the documents and validate trade data. A risk score is calculated based on exporter history, buyer credibility, currency risk, and geopolitical exposure. Once verified, the invoice is tokenized as an ERC721 NFT with all relevant metadata stored on-chain. Access to Liquidity The verified invoice NFTs are listed on the YieldX vault or marketplace. DeFi investors can review these opportunities and provide liquidity in USDC. Investors may fund invoices fully or fractionally based on their risk appetite. Once funding is complete, capital is released immediately to the exporter. Repayment and Yield Distribution Buyers pay exporters through traditional channels. Payments are tracked and confirmed, then reported on-chain. Smart contracts automatically distribute principal and yield to investors, with dynamic adjustments for early or late repayments. Ongoing Transparency All verification, funding, and repayment data are immutably recorded on-chain. Documents are stored on IPFS, allowing auditors, regulators, and investors to verify authenticity and track every transaction without intermediaries. Who It Is For: Practical Applications Across Stakeholders Exporters Unlock working capital quickly without relying on slow traditional processes Grow their businesses with faster access to funds Investors Invest in real-world, income-generating DeFi assets backed by verified trade invoices Access transparent risk data and documentation before committing funds Auditors and Regulators Verify the authenticity and risk status of invoices in real time Access secure and tamper-proof audit trails on-chain Builders and Developers Build DeFi products, dashboards, and analytics tools using on-chain trade data Extend and innovate on a modular, verified infrastructure Why YieldX Matters YieldX redefines trade finance by removing traditional bottlenecks and embedding trust through automated, Chainlink-powered document verification. Exporters gain fast, cost-effective liquidity; investors earn yield on verifiable assets; regulators and auditors obtain transparent oversight; and developers gain a powerful platform to innovate. This creates a seamless flow of capital across borders and systems, addressing a critical forty billion dollar gap in African trade finance and fostering a more inclusive global economy.

How it's made

Challenges we ran into 1. Handling Chainlink Functions Response Delays We noticed that Chainlink Functions can take anywhere from 30 seconds to 2 minutes to respond far too long for a smooth user experience. To solve this, we built a polling mechanism that checks the status every 4 seconds. We also introduced real-time progress indicators and smart timeout handling to keep users informed. Even better, we implemented persistent status tracking, so if the page refreshes, users don’t lose their progress. 2. Solving Solidity's “Stack Too Deep” Errors While working on the YieldXCore contract, we hit Solidity’s 16-variable stack depth limit; a common pain point. Our fix was to modularize the contract into smaller, focused components. We refactored key logic into view functions with a maximum of four parameters and enabled the viaIR compiler setting in Hardhat for better optimization and stack management. 3. Sepolia ETH Funding Challenges We faced recurring delays when trying to fund our test deployments on Sepolia. Faucet access was unreliable and often slow, which made iteration difficult.