YieldProof Protocol

Trustless Yield Verification Infrastructure for Real World Assets

YieldProof is on-chain yield verification infrastructure for RWAs on Mantle, enabling cryptoeconomic accountability through multi-party attestation with staked capital and automated reward/slashing mechanisms.

Deployed Status: ✅ Live on Mantle Sepolia
Total Lines of Code: ~800 Solidity + 2,000+ TypeScript
Test Coverage: 13/13 tests passing (100% core functionality)
Audit Status: Pre-audit (planned Q2 2025)

Executive Summary

What: YieldProof is on-chain yield verification infrastructure for RWAs on Mantle
Why: Current yield reporting is trust-based with no cryptoeconomic accountability
How: Multi-party attestation with staked capital + automated reward/slashing mechanism

Protocol Flow

flowchart TB
    I[👥 Investors] 
    V[🏦 Yield Vault]
    IS[🏛️ RWA Issuer]
    YP[⚡ YieldProof Protocol]
    AN[🛡️ Attestor Network]
    
    I -->|Deposit Capital| V
    V -->|Deploy to RWA| IS
    IS -->|Generate Yield| IS
    IS -->|Submit Disclosure + Proof| YP
    YP -->|Request Verification| AN
    AN -->|Stake & Verify| YP
    YP -->|Automated Distribution| I
    
    style YP fill:#3b82f6,stroke:#1e40af,color:#fff
    style AN fill:#10b981,stroke:#059669,color:#fff

High Level Attestation Flow

System Architecture

graph TB
    subgraph "User Layer"
        I[Issuers]
        AT[Attestors]
        IN[Investors]
    end
    
    subgraph "Smart Contract Layer - Mantle Sepolia"
        YP[YieldProof Contract<br/>Claim Management]
        AR[AttestorRegistry Contract<br/>Economic Security]
        YV[YieldVault Contract<br/>Capital Management]
    end
    
    subgraph "Data Layer"
        IPFS[IPFS<br/>Document Storage]
        CHAIN[On-Chain State<br/>Immutable Records]
    end
    
    I -->|Submit Claim + Fee| YP
    YP -->|Forward Fee| AR
    YP -->|Store Document Hash| IPFS
    
    AT -->|Register + Stake| AR
    AT -->|Attest to Claim| AR
    AR -->|Reward/Slash| AT
    
    IN -->|Deposit Capital| YV
    YV -->|Query Verified Claims| YP
    YP -->|Query Attestations| AR
    
    YP -.->|Read State| CHAIN
    AR -.->|Read State| CHAIN
    YV -.->|Read State| CHAIN
    
    style YP fill:#3b82f6,stroke:#1e40af,color:#fff
    style AR fill:#10b981,stroke:#059669,color:#fff
    style YV fill:#8b5cf6,stroke:#6d28d9,color:#fff

Complete Verification Workflow

sequenceDiagram
    participant I as Issuer
    participant YP as YieldProof
    participant AR as AttestorRegistry
    participant A1 as Attestor 1
    participant A2 as Attestor 2
    participant A3 as Attestor 3
    
    Note over I,A3: Phase 1: Claim Submission
    I->>YP: submitClaim(assetId, amount, documentHash) + 0.9 MNT
    YP->>AR: payAttestationFee(0.9 MNT)
    YP-->>I: ClaimID #5 Created (Status: Pending)
    
    Note over I,A3: Phase 2: Attestor Registration
    A1->>AR: register() + stake(1 MNT)
    AR-->>A1: Attestor Registered
    A2->>AR: register() + stake(1 MNT)
    AR-->>A2: Attestor Registered
    A3->>AR: register() + stake(1 MNT)
    AR-->>A3: Attestor Registered
    
    Note over I,A3: Phase 3: Multi-Party Verification
    A1->>AR: attestToClaim(5)
    AR-->>A1: Attestation Recorded (1/3)
    A2->>AR: attestToClaim(5)
    AR-->>A2: Attestation Recorded (2/3)
    A3->>AR: attestToClaim(5)
    AR-->>A3: Attestation Recorded (3/3)
    
    Note over I,A3: Phase 4: Finalization
    I->>AR: finalizeAndReward(5)
    AR->>A1: Accrue 0.3 MNT reward
    AR->>A2: Accrue 0.3 MNT reward
    AR->>A3: Accrue 0.3 MNT reward
    AR-->>I: Claim Finalized
    
    Note over I,A3: Phase 5: Status Update
    I->>YP: updateClaimStatus(5)
    YP->>AR: Check totalStakePerClaim(5)
    AR-->>YP: 3 MNT staked
    YP-->>I: Status: Pending → Attested
    
    Note over I,A3: Phase 6: Reward Claiming
    A1->>AR: claimRewards()
    AR-->>A1: Transfer 0.3 MNT

Smart Contracts

Contract	Address (Sepolia)	Purpose	Status
AttestorRegistry	`0x1c152de6172BDB84b0871731Ef494d12C7691C07`	Economic security, staking, rewards	✅ Deployed
YieldProof	`0x723A0992D07Ed6e6789Fcdcfd63b05634302586c`	Claim lifecycle management	✅ Deployed
YieldVault	`0x671dA4C8D9277429e58fbFCa46C3163a17b97294`	Investor capital management	✅ Deployed

Network: Mantle Sepolia Testnet
Chain ID: 5003
RPC: https://rpc.sepolia.mantle.xyz
Explorer: https://sepolia.mantlescan.xyz

AttestorRegistry.sol

Purpose: Manages attestor registration, staking, rewards, slashing, and reputation tracking.

Key Features:

✅ ETH staking mechanism
✅ Multi-party attestation coordination
✅ Automated reward distribution
✅ Trust score algorithm (0-100)
✅ Flagging system for suspicious claims
⚠️ Owner-controlled slashing (pending DAO governance)

State Variables

Variable	Type	Description
`attestors`	`mapping(address => Attestor)`	Attestor registration and stake amounts
`hasAttested`	`mapping(uint256 => mapping(address => bool))`	Tracks which attestors verified which claims
`totalStakePerClaim`	`mapping(uint256 => uint256)`	Total stake backing each claim
`attestorCountPerClaim`	`mapping(uint256 => uint256)`	Number of attestors per claim
`successfulAttestations`	`mapping(address => uint256)`	Attestor performance tracking
`rewardsEarned`	`mapping(address => uint256)`	Unclaimed rewards per attestor
`MIN_REQUIRED_ATTESTORS`	`uint256`	Minimum attestations required (3)
`REWARD_PER_ATTESTATION`	`uint256`	0.3 ETH per successful attestation
`ATTESTATION_FEE`	`uint256`	0.9 ETH per claim submission

Core Functions

register() - Registers caller as attestor with optional initial stake
attestToClaim(uint256 claimId) - Records attestor's verification of a claim
finalizeAndReward(uint256 claimId) - Permissionless finalization for claims with 3+ attestations
claimRewards() - Transfers accumulated rewards to caller
getTrustScore(address attestor) - Calculates trust score (0-100)

Trust Score Formula

accuracyRate = (successfulAttestations * 100) / totalAttestations
accuracyScore = (accuracyRate * 70) / 100  // 0-70 points
experienceBonus = min(totalAttestations, 15) * 2  // 0-30 points
trustScore = min(accuracyScore + experienceBonus, 100)

YieldProof.sol

Purpose: Manages yield claim lifecycle from submission to verification.

Key Features:

✅ Claim submission with IPFS document hash
✅ Automatic attestation fee payment
✅ Status lifecycle management
✅ Integration with AttestorRegistry

Claim Lifecycle

stateDiagram-v2
    [*] --> Pending: submitClaim()
    Pending --> Attested: updateClaimStatus()
    Attested --> Approved: admin approval
    Pending --> Challenged: flagged by attestor
    Attested --> Challenged: evidence of fraud
    Challenged --> [*]: resolved
    Approved --> [*]: finalized

Core Functions

submitClaim(string assetId, string period, uint256 yieldAmount, string documentHash) - Submit new yield claim with 0.9 MNT fee
updateClaimStatus(uint256 claimId) - Permissionless status update based on attestations
getTotalClaims() - Returns total number of claims submitted

Economic Model

Fee Structure

Role	Action	Cost	Benefit
Issuer	Submit claim	0.9 MNT	Verified yield disclosure
Attestor	Stake capital	1+ MNT	Earn 0.3 MNT per verification
Investor	View verified claims	Free	Transparent yield data

Attestor Economics

Revenue Model:

Monthly Verifications: 20 claims
Reward per Verification: 0.3 MNT
Monthly Earnings: 6 MNT
Annual Earnings: 72 MNT

ROI on 1 MNT stake: 7,200% APY
ROI on 10 MNT stake: 720% APY

Economic Viability (Test Results):

✅ PROFITABLE: Attestors earn ~0.299 MNT net profit per attestation
✅ Economic Balance: Total fees (0.9 MNT) = Total rewards (3 × 0.3 MNT)
✅ Gas Efficient: Total gas cost ~0.0002 MNT per attestation

Live Application

🌐 Live on Mantle Sepolia: https://yield-proof.vercel.app

User Roles

🏛️ Issuers: Submit yield disclosures with cryptographic proof
🛡️ Attestors: Verify disclosures and earn rewards for accurate validation
👥 Investors: Deposit capital and receive verified yield distributions

Quick Start

Prerequisites

Node.js 18+
Git

Installation

# Clone the repository
git clone https://github.com/imanishbarnwal/YieldProof.git
cd YieldProof

# Install dependencies
npm install

# Navigate to frontend
cd frontend
npm install

Environment Setup

Create frontend/.env.local:

NEXT_PUBLIC_RPC_URL=https://rpc.sepolia.mantle.xyz
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id

Run Development Server

# Start the frontend
cd frontend
npm run dev

Smart Contract Development

# Navigate to contracts
cd contracts

# Install dependencies
npm install

# Compile contracts
npx hardhat compile

# Run tests
npm test

# Deploy to Mantle Sepolia
npm run deploy

Integration Guide

For Issuers

1. Submit Claim

const fee = await yieldProofContract.getRequiredAttestationFee();
const tx = await yieldProofContract.submitClaim(
    "TREASURY-VAULT-001",  // assetId
    "2024-Q4",             // period
    ethers.utils.parseEther("150"),  // yieldAmount
    "QmHash123...",        // IPFS document hash
    { value: fee }
);

For Attestors

1. Register & Stake

await attestorRegistryContract.register({
    value: ethers.utils.parseEther("10.0")  // 10 MNT stake
});

2. Attest to Claim

await attestorRegistryContract.attestToClaim(claimId);

3. Claim Rewards

await attestorRegistryContract.claimRewards();

Testing

Run Tests

cd contracts
npm test

Test Coverage

✅ 13/13 tests passing (100% core functionality)

✅ Economic constants verification
✅ Attestor registration with staking
✅ Multi-party attestation coordination
✅ Reward accrual and claiming
✅ Trust score calculation
✅ Economic viability analysis
✅ Lifetime rewards tracking

Security Considerations

Known Limitations

1. Centralized Governance

⚠️ Owner can slash attestors
⚠️ Owner can unflag claims
Mitigation: Roadmap includes multi-sig + DAO migration

2. No Challenge Mechanism

⚠️ Fraud detection relies on flagging
⚠️ No permissionless dispute resolution
Mitigation: Building challenge system with bounties (4-6 weeks)

3. Economic Attacks

Sybil: Mitigated by staking requirement
Collusion: Partially mitigated by flagging
51% Attack: Requires 67% of stake (expensive)

Audit Status

Status: Pre-audit
Planned: Q2 2025
Scope: All smart contracts + economic model

Development Roadmap

Phase 1: MVP (✅ Complete)

✅ AttestorRegistry with staking
✅ YieldProof claim management
✅ Trust score algorithm
✅ Frontend deployment
✅ Mantle Sepolia deployment

Phase 2: Economic Security (In Progress - 4-6 weeks)

🚧 Challenge/dispute mechanism
🚧 Automated fraud detection for on-chain yields
🚧 Slashing bounties (50% to challenger)
🚧 DAO governance migration

Phase 3: Mainnet Launch (8-12 weeks)

⏳ Security audit
⏳ Multi-sig governance
⏳ Mantle mainnet deployment
⏳ Attestor network recruitment (15-20 founding attestors)

Phase 4: Ecosystem Integration (12-24 weeks)

⏳ API for protocol integrations
⏳ Automated verification modules (LST, restaking, DeFi)
⏳ Cross-chain expansion (Ethereum, Arbitrum)
⏳ Institutional partnerships

Technical Stack

Frontend: Next.js 14, TypeScript, Tailwind CSS, Framer Motion
Blockchain: Solidity smart contracts on Mantle Sepolia
Web3: Wagmi, RainbowKit, Viem
Storage: IPFS for document hashes
UI/UX: Professional glass-morphism design system

FAQ

Q: Why Mantle?
A: Mantle is positioning as the institutional L2 for RWAs. Low gas costs enable frequent verifications. Ecosystem alignment with tokenized treasuries, real estate, and credit markets.

Q: How is this different from Chainlink PoR?
A: Chainlink PoR verifies custodial reserves ("Does the vault have the assets?"). YieldProof verifies yield generation ("Did the vault earn the returns claimed?"). Different problems, complementary solutions.

Q: What prevents attestor spam?
A: Staking requirement. Each attestor must lock capital. Spam attacks require locking capital across many identities, making it economically irrational.

Q: When mainnet?
A: Target Q2 2025 after security audit and DAO governance implementation.

Team

Manish Kumar Barnwal - Smart Contract Engineering & Full-Stack Development
Mouli Chakraborty - Protocol Design & Backend Architecture
Jishnu Baruah - Frontend Development & Product Management

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

git clone https://github.com/imanishbarnwal/YieldProof.git
cd YieldProof

# Install contract dependencies
cd contracts && npm install

# Install frontend dependencies
cd ../frontend && npm install

Contact & Support

Website: https://yield-proof.vercel.app
GitHub: https://github.com/imanishbarnwal/YieldProof
Issues: Report bugs or request features

License

MIT License - see LICENSE

Built with ❤️ for Mantle's RWA ecosystem

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
.vscode		.vscode
contracts		contracts
docs		docs
frontend		frontend
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
UPGRADE_NOTES.md		UPGRADE_NOTES.md
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

YieldProof Protocol

Executive Summary

Protocol Flow

High Level Attestation Flow

System Architecture

Complete Verification Workflow

Smart Contracts

AttestorRegistry.sol

State Variables

Core Functions

Trust Score Formula

YieldProof.sol

Claim Lifecycle

Core Functions

Economic Model

Fee Structure

Attestor Economics

Live Application

User Roles

Quick Start

Prerequisites

Installation

Environment Setup

Run Development Server

Smart Contract Development

Integration Guide

For Issuers

For Attestors

Testing

Run Tests

Test Coverage

Security Considerations

Known Limitations

Audit Status

Development Roadmap

Phase 1: MVP (✅ Complete)

Phase 2: Economic Security (In Progress - 4-6 weeks)

Phase 3: Mainnet Launch (8-12 weeks)

Phase 4: Ecosystem Integration (12-24 weeks)

Technical Stack

FAQ

Team

Contributing

Development Setup

Contact & Support

License

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages