Documentation
Building the future of value-aligned decentralized systems. Resources, guides, and tools for developers.
Why Sharia Capital Standard?
Most DeFi primitives assume interest-based yield or implicit guarantees. Sharia Capital Standard provides composable smart contract primitives aligned with AAOIFI standards, enabling halal capital formation natively on-chain.
Supported Environments
Standards Architecture
Capital Primitives
- Profit sharing by pre-agreed ratio
- Loss borne by capital provider
- Manager liability for misconduct
- ERC-20 compatible
- Flexible profit ratios
- Loss ratio equals capital ratio
- Multi-partner support
- AAOIFI Standard #12 compliant
Infrastructure Layer
- Epoch-based accounting
- NAV calculation
- Strategy management
- ERC-4626 standard
- No guaranteed returns
- Profit-sharing validation
- Fixed-yield prevention
- Compliance checks
Governance Layer
- SSB oversight
- Multi-signature approval
- Prohibited asset screening
- Financial ratio validation
Architecture Overview
Users
Capital Providers
Vault Engine
SCS-3
Capital Modules
SCS-1, SCS-2
Enforcement
SCS-4
SSB Governance
SCS-5
AAOIFI Compliance Validation
Every transaction flows through the enforcement layer (SCS-4) which validates against AAOIFI standards before execution. The SSB Governance layer (SCS-5) provides ongoing oversight and can update compliance rules through multi-signature approval.
Installation
Choose your preferred development environment and get started in minutes
Step 1: Install Dependency
forge install tawf-labs/Sharia-Capital-StandardStep 2: Configure Remappings
@sharia-capital/=lib/Sharia-Capital-Standard/evm/src/Step 3: Import Contracts
import "@sharia-capital/SCS1/MudarabahPool.sol";
import "@sharia-capital/SCS2/MusharakahPool.sol";
import "@sharia-capital/SCS3/VaultEngine.sol";
import "@sharia-capital/SCS4/SCSEnforcement.sol";
import "@sharia-capital/SCS5/AAOIFIGovernance.sol";Usage Examples
Production-ready code examples for each standard
// Create Mudarabah pool
MudarabahFactory factory = new MudarabahFactory(enforcementAddress);
address pool = factory.createPool(
usdcAddress,
managerAddress,
capitalProviderAddress,
2000, // 20% manager share (basis points)
8000, // 80% provider share (basis points)
"USDC Mudarabah Pool",
"MDP-USDC"
);
// Deposit capital
MudarabahPool mudarabah = MudarabahPool(pool);
usdc.approve(pool, 1000e6);
mudarabah.deposit(1000e6);
// Deploy to strategy
mudarabah.deployCapital(strategyAddress, 500e6);No capital guarantee mechanisms exist at protocol level in accordance with AAOIFI standards.
External audit recommended before production deployment. Obtain SSB approval and conduct independent Sharia review.
Who Should Use This?
Sharia Capital Standard is designed for organizations and developers building Sharia-compliant financial infrastructure
Islamic Fintech Startups
Build Sharia-compliant DeFi products with production-ready primitives for halal capital formation.
Web3 Protocols (MENA/SEA)
Integrate Islamic finance capabilities to serve Muslim-majority markets with compliant infrastructure.
DAOs Structuring Halal Capital
Implement transparent, on-chain governance with Sharia Supervisory Board oversight mechanisms.
Institutional Sharia-Compliant Funds
Deploy auditable, AAOIFI-compliant investment vehicles with built-in compliance enforcement.
Documentation Sections
Resources & Community
Access the SDK, explore the codebase, and connect with developers building Sharia-compliant DeFi infrastructure.
GitHub Repository
Explore the Sharia Capital Standard codebase, contribute to development, and report issues.
npm Package
Install the SDK via npm and integrate Sharia-compliant primitives into your project.
Join Development
Connect with our team and community of developers building the future of Islamic Web3.
Start Building Today
Production-ready smart contracts for Sharia-compliant capital formation. Install via npm or explore the source code on GitHub.