> For the complete documentation index, see [llms.txt](https://trumarket.gitbook.io/trumarket-tokenomics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trumarket.gitbook.io/trumarket-tokenomics/trumarket-tokenomics/welcome-to-trumarket.md). # Welcome to TruMarket ## ## Token Overview ### Token Identity | Parameter | Details | | -------------------------- | ------------------------------------------------ | | Token Name | TruMarket Token 3 | | Token Symbol | $TRU3 | | Token Standard | ERC-20 (Ethereum blockchain) | | Acquisition Method | Received when staking USDC in the liquidity pool | | Total Supply | 100,000,000 $TRU3 | | Initial Circulating Supply | 20,000,000 $TRU3 (20%) | ### $USDC-TRU3 Representation $USDC-TRU3 represents the stake of liquidity providers in the pool 1:1 to their position in USDC. This token serves as proof of liquidity provision and entitles holders to returns generated from the platform's operations. ### Token Distribution The total supply of 100,000,000 $TRU3 tokens will be distributed as follows: | Allocation | Percentage | Amount ($TRU3) | Purpose | | --------------------------- | ---------- | -------------- | -------------------------------------------- | | Liquidity Provision Rewards | 45% | 45,000,000 | Distributed to USDC stakers | | Team & Advisors | 15% | 15,000,000 | To incentivize the team and advisors | | Ecosystem Growth | 20% | 20,000,000 | For partnerships, marketing, and development | | Community Rewards | 10% | 10,000,000 | To reward users and community participation | | Reserve Treasury | 10% | 10,000,000 | For market stability and future initiatives | ### Vesting Schedule To ensure long-term commitment and prevent market disruption: * Liquidity Provision Rewards: Released as USDC is staked into the liquidity pool * Team & Advisors: 2-year vesting with 6-month cliff * Ecosystem Growth: 3-year linear release * Community Rewards: Released based on platform milestones * Reserve Treasury: Strategic release for market stability ### Example: Team Token Vesting For a team member allocated 100,000 $TRU3 tokens: * Months 1-6: 0 $TRU3 (cliff period) * Month 7: 12,500 $TRU3 released (6.25% of total allocation) * Months 8-24: 4,861 $TRU3 released monthly (2.43% of total allocation per month) * After 24 months: All 100,000 $TRU3 tokens fully vested ## Business Model & Fee Structure ### Value-Based Fee Structure TruMarket charges an 8% fee on the total value transacted through the platform, representing the value provided through secure trading, risk assessment, and financing facilitation: * Fee Source: Charged to Suppliers/Buyers for each agricultural trade facilitated * Fee Calculation: 8% of the total transaction value * Fee Collection: Automatically deducted at deal completion * Value Delivered: Security, risk mitigation, financing access, and trade verification ### Fee Distribution The 8% platform fee is distributed as follows: | Allocation | Percentage | Purpose | | -------------------------- | ---------- | ----------------------------------------------------------- | | Liquidity Provider Returns | 70% | To pay APY to USDC stakers who enable trade financing | | Platform Operations | 15% | For ongoing development and security enhancements | | Buyback and Burn | 10% | To reduce $TRU3 supply and increase value | | Insurance Fund | 5% | To protect against default risks and enhance trade security | ### Example: Fee Calculation and Distribution Let's consider a secure trade for exporting Peruvian avocados worth $500,000: * Total Platform Fee: $500,000 × 8% = $40,000 * Fee Distribution: * Liquidity Provider Returns: $40,000 × 70% = $28,000 * Platform Operations: $40,000 × 15% = $6,000 * Buyback and Burn: $40,000 × 10% = $4,000 * Insurance Fund: $40,000 × 5% = $2,000 * Impact on Stakeholders: * Supplier/Buyer pays: $500,000 + $40,000 = $540,000 for a secure, verified trade * Liquidity providers share: $28,000 (distributed based on stake proportion and APY) * Platform receives: $6,000 for operations and security enhancements * $4,000 worth of $TRU3 tokens are bought back and burned * $2,000 is added to the insurance fund to enhance trade security ## USDC Staking Mechanism ### Core Mechanism * Liquidity providers stake USDC into a single unified pool * For each USDC staked, providers receive $TRU3 tokens based on the current issuance rate * Initial issuance rate: 1 USDC = 1 $TRU3 * Issuance rate decreases over time as more USDC is staked, creating scarcity * Liquidity providers receive $USDC-TRU3 tokens representing their stake in the pool 1:1 to their position in USDC ### Issuance Schedule The $TRU3 issuance rate follows a decreasing schedule to reward early participants and create token scarcity over time: | Phase | USDC Staked | Issuance Rate | | ------- | ---------------- | ------------------ | | Phase 1 | First 10M USDC | 1 USDC = 1 $TRU3 | | Phase 2 | 10M-30M USDC | 1 USDC = 0.8 $TRU3 | | Phase 3 | 30M-60M USDC | 1 USDC = 0.6 $TRU3 | | Phase 4 | 60M-100M USDC | 1 USDC = 0.4 $TRU3 | | Phase 5 | Beyond 100M USDC | 1 USDC = 0.2 $TRU3 | ### Example: $TRU3 Token Issuance **Scenario 1: Early Platform Adoption** Alice stakes 10,000 USDC when the platform has only 5M USDC staked in total: * Current phase: Phase 1 (First 10M USDC) * Issuance rate: 1 USDC = 1 $TRU3 * $TRU3 tokens received: 10,000 USDC × 1 = 10,000 $TRU3 * $USDC-TRU3 tokens received: 10,000 $USDC-TRU3 **Scenario 2: Mid-Stage Platform Adoption** Bob stakes 10,000 USDC when the platform has 20M USDC staked in total: * Current phase: Phase 2 (10M-30M USDC) * Issuance rate: 1 USDC = 0.8 $TRU3 * $TRU3 tokens received: 10,000 USDC × 0.8 = 8,000 $TRU3 * $USDC-TRU3 tokens received: 10,000 $USDC-TRU3 **Scenario 3: Mature Platform** Charlie stakes 10,000 USDC when the platform has 80M USDC staked in total: * Current phase: Phase 4 (60M-100M USDC) * Issuance rate: 1 USDC = 0.4 $TRU3 * $TRU3 tokens received: 10,000 USDC × 0.4 = 4,000 $TRU3 * $USDC-TRU3 tokens received: 10,000 $USDC-TRU3 This decreasing issuance rate incentivizes early participation and creates token scarcity over time, potentially increasing the value of $TRU3 tokens for early adopters. ### Dynamic APY System #### APY Range Liquidity providers earn a dynamic APY on their USDC stakes: * Base APY Range: 10% to 18% * Payment Currency: USDC * Payment Schedule: Upon successful deal completion #### Early Participation Incentives The APY follows a decreasing curve based on pool fill percentage: | Pool Fill Percentage | APY Modifier | | -------------------- | --------------------- | | 0-20% filled | +4% (Maximum 18% APY) | | 21-40% filled | +2% (Maximum 16% APY) | | 41-60% filled | +1% (Maximum 15% APY) | | 61-80% filled | +0% (Base 14% APY) | | 81-100% filled | -1% (Minimum 13% APY) | ### Risk Measurement Mechanisms The base APY is adjusted according to multiple risk factors: #### 1. Deal Risk Score Each agricultural deal is assigned a risk score (1-5) based on factors like counterparty reliability, contract terms, and market conditions: | Risk Score | Description | APY Modifier | | ---------- | ------------ | ------------- | | 1 | Lowest Risk | -3% | | 2 | Low Risk | -1.5% | | 3 | Medium Risk | No adjustment | | 4 | High Risk | +1.5% | | 5 | Highest Risk | +3% | #### 2. Geographic Risk Regions are categorized by risk level based on political stability, climate patterns, and infrastructure quality: | Region Risk | Description | APY Modifier | | ----------- | ------------------------------------------- | ------------- | | Low | Stable regions with reliable infrastructure | -1% | | Medium | Moderate stability and infrastructure | No adjustment | | High | Regions with higher uncertainty | +1% | #### 3. Seasonal Risk Seasonal factors affect agricultural outcomes based on historical data and climate forecasts: | Season Risk | Description | APY Modifier | | ----------- | ---------------------------- | ------------- | | Optimal | Ideal growing conditions | -1% | | Transition | Average conditions | No adjustment | | Challenging | Difficult growing conditions | +1% | #### 4. Product Type Risk Different agricultural products carry different risks based on perishability, market volatility, and handling requirements: | Product Risk | Examples | APY Modifier | | ------------ | ---------------------- | ------------- | | Stable | Grains, nuts | -1% | | Moderate | Citrus, apples | No adjustment | | Volatile | Berries, exotic fruits | +1% | ### APY Calculation Formula The final APY for a liquidity provider is calculated as: Final APY = Base APY (14%)\ \+ Early Participation Modifier\ \+ Deal Risk Score Modifier\ \+ Geographic Risk Modifier\ \+ Seasonal Risk Modifier\ \+ Product Type Risk Modifier Constraints: * Minimum APY: 10% * Maximum APY: 18% ## Real-World Trade Flow ### Comprehensive Trade Process The TruMarket platform facilitates secure global trading through a comprehensive, transparent process that protects all participants: #### 1. Trade Proposal and Acceptance * **Supplier Initiation**: Suppliers create detailed trade proposals including product specifications, quantities, pricing, delivery timelines, and quality standards * **Documentation Verification**: Platform verifies supplier credentials, certifications, and production capacity * **Buyer Discovery**: Verified buyers browse available trade opportunities or receive matched recommendations * **Counterparty Verification**: Both parties undergo KYC/AML checks before trade acceptance * **Terms Negotiation**: Secure messaging system allows counterparties to negotiate and finalize terms * **Digital Contract Formation**: Smart contract captures all agreed terms with digital signatures #### 2. Trade Listing and Risk Assessment * **Listing Fee Payment**: Deal creators pay $TRU3 tokens (purchased with USDC) to have their trades listed * **Multi-factor Risk Analysis**: * Counterparty reliability and historical performance * Geographic and political risk factors * Seasonal and climate considerations * Product-specific risks (perishability, market volatility) * Logistics and supply chain vulnerabilities * **Independent Auditor Review**: Multiple independent risk assessors evaluate the trade * **Collateralized Assessment**: Assessors stake $TRU3 as collateral to ensure honest evaluation * **Risk Score Calculation**: Final risk score determines APY and financing terms #### 3. Secure Financing and Milestone Execution * **Financing Approval**: Based on risk assessment, the platform approves trade financing * **USDC Conversion**: Funds from the unified pool are converted to required fiat currency * **Milestone Definition**: Clear, verifiable milestones are established for the trade lifecycle * **Escrow Creation**: Funds are held in secure escrow until milestone completion * **Milestone Verification**: * Production verification (photos, third-party inspections) * Shipping documentation validation * Customs clearance confirmation * Quality inspection reports * Delivery confirmation * **Conditional Release**: Funds are released to Suppliers only upon verified milestone completion * **Real-time Tracking**: All parties can monitor trade progress through the platform dashboard #### 4. Trade Finalization and Repayment * **Delivery Confirmation**: Buyer confirms receipt and acceptance of goods * **Quality Verification**: Any quality disputes are resolved through the platform's arbitration process * **Final Payment**: Buyer completes payment in fiat currency * **Currency Conversion**: Fiat payments are converted back to USDC through regulated exchanges * **Pool Replenishment**: USDC returns to the unified liquidity pool * **Performance Recording**: Trade performance metrics are recorded for future risk assessments #### 5. Returns Distribution * **$USDC-TRU3 Exchange**: USDC is exchanged with $USDC-TRU3 positions * **APY Calculation**: Returns are calculated based on the dynamic APY system and risk factors * **Principal Return**: Liquidity providers receive their original principal * **Yield Distribution**: APY returns are distributed proportionally to stake size * **Performance Reporting**: Detailed performance reports are provided to all liquidity providers ### Legal Framework TruMarket operates within a comprehensive legal framework designed to protect all participants and ensure regulatory compliance across jurisdictions: #### 1. Contractual Structure * **Master Services Agreement**: Governs the relationship between TruMarket and platform users * **Digital Trade Agreements**: Legally binding contracts between Suppliers and Buyers * **Liquidity Provider Terms**: Clear terms for USDC staking and returns * **Risk Assessor Agreements**: Terms for risk assessment participation and liability #### 2. Regulatory Compliance * **KYC/AML Procedures**: Comprehensive identity verification and anti-money laundering checks * **Cross-border Trade Regulations**: Compliance with international trade laws and sanctions * **Financial Services Licensing**: Appropriate licensing for financing activities in relevant jurisdictions * **Data Protection**: GDPR and other privacy regulation compliance * **Agricultural Product Regulations**: Compliance with food safety and agricultural product standards #### 3. Dispute Resolution * **Tiered Resolution Process**: * Direct negotiation between parties * Platform-facilitated mediation * Binding arbitration through designated international arbitration bodies * **Evidence Repository**: Secure storage of all trade documentation and communication * **Expert Arbitrators**: Industry-specific arbitrators for agricultural trade disputes * **Enforceable Outcomes**: Arbitration decisions enforceable in relevant jurisdictions #### 4. Insurance and Liability * **Coface Insurance Partnership**: Coverage for up to 80% of trade value * **Platform Insurance Policy**: Additional coverage for platform operational risks * **Clear Liability Limitations**: Well-defined limitations of liability for all participants * **Force Majeure Provisions**: Handling of extraordinary events and circumstances #### 5. Jurisdictional Considerations * **Governing Law Selection**: Clear choice of law provisions in all agreements * **Jurisdictional Adaptability**: Flexible legal framework adaptable to local requirements * **Regulatory Monitoring**: Continuous monitoring of regulatory changes in key markets * **Local Legal Partnerships**: Network of legal partners in major agricultural trading regions ## Liquidity Pool Mechanism ### Secure Trade Financing Pool The core innovation of TruMarket's tokenomics is the unified liquidity pool that enables secure financing for global agricultural trades: * **Creation**: TruMarket maintains a single USDC staking pool that finances all agricultural trades * **Funding**: Liquidity providers stake USDC in this pool and receive $TRU3 and $USDC-TRU3 tokens * **Security**: The pool is collateralized by all underlying agricultural assets across multiple trades * **Returns**: USDC returns are generated from the 8% value-based fee collected from all trades * **Risk Diversification**: All liquidity providers have exposure to all trades in the platform, reducing individual trade risk ## Pool Lifecycle and Risk Mitigation ### Enhanced Pool Lifecycle The unified liquidity pool undergoes a continuous lifecycle that ensures optimal capital utilization, risk management, and returns for all participants: #### 1. Pool Initialization and Management * **Initial Pool Setup**: The platform establishes the unified USDC staking pool with transparent parameters * **Governance Oversight**: $TRU3 token holders vote on key pool parameters and risk thresholds * **Dynamic Capacity Adjustment**: Pool capacity adjusts based on market demand and risk exposure * **Liquidity Reserves**: Minimum 10% of pool funds maintained as reserves for immediate withdrawal needs * **Continuous Risk Monitoring**: Real-time monitoring of aggregate pool risk exposure across all trades * **Parameter Optimization**: Machine learning algorithms optimize pool parameters based on historical performance #### 2. Advanced Liquidity Provision * **Flexible Entry Options**: * One-time staking with auto-compounding * Recurring staking schedules * Automated dollar-cost averaging * **Tiered Participation Levels**: * Standard: 100-9,999 USDC * Premium: 10,000-99,999 USDC * Institutional: 100,000+ USDC * **Stake Verification**: Multi-signature verification of large stakes to prevent errors * **Position Tracking**: Real-time dashboard showing stake value, earned returns, and projected APY * **$USDC-TRU3 Tokenization**: Automatic issuance of $USDC-TRU3 tokens representing 1:1 stake position * **Secondary Market Options**: Ability to trade $USDC-TRU3 tokens on supported exchanges * **Withdrawal Scheduling**: Planned withdrawal functionality to optimize pool stability #### 3. Comprehensive Trade Portfolio Management * **Diversification Requirements**: * Maximum 15% of pool allocated to any single trade * Maximum 30% exposure to any single geographic region * Maximum 40% exposure to any single product category * **Risk-Weighted Allocation**: Capital allocation prioritized based on risk-adjusted return potential * **Vintage Diversification**: Balanced exposure across different trade durations and seasons * **Continuous Deal Flow**: Ongoing onboarding of new trades as existing ones complete * **Performance Analytics**: Advanced analytics on portfolio performance by region, product, and counterparty * **Stress Testing**: Regular stress testing of portfolio against market shocks and default scenarios #### 4. Sophisticated Fee Management * **Transparent Fee Collection**: All 8% fees collected and recorded on-chain * **Automated Distribution**: Smart contract-based distribution to designated allocations * **Fee Optimization**: Periodic review and adjustment of fee distribution percentages * **Buyback Execution**: Automated execution of $TRU3 buyback and burn operations * **Insurance Fund Growth**: Strategic growth of insurance reserves based on risk exposure * **Operational Efficiency**: Continuous optimization of platform operations to maximize fee value #### 5. Enhanced Returns Distribution * **Predictable Distribution Schedule**: Regular distribution cycles (monthly/quarterly) * **Performance-Based Bonuses**: Additional returns for long-term liquidity providers * **Tax Optimization**: Tax-efficient distribution mechanisms where applicable * **Reinvestment Options**: Automatic reinvestment of returns for compounding growth * **Detailed Reporting**: Comprehensive reporting on returns, sources, and performance metrics * **Benchmark Comparisons**: Performance comparison against relevant market benchmarks ### Comprehensive Risk Mitigation Framework TruMarket implements a multi-layered risk mitigation framework to protect liquidity providers and ensure platform stability: #### 1. Preventative Measures * **Rigorous Counterparty Verification**: * Comprehensive KYC/AML procedures * Business history and performance verification * Credit scoring and financial health assessment * Reputation analysis within industry networks * **Multi-factor Risk Assessment**: * Independent assessment by multiple auditors * Collateralized stake requirement for assessors * Standardized risk scoring methodology * Continuous improvement through machine learning * **Diversification Requirements**: * Mandatory diversification across trades, regions, and products * Exposure limits for individual counterparties * Balanced portfolio construction algorithms * **Smart Contract Security**: * Regular security audits by leading firms * Formal verification of critical contract functions * Bug bounty program for vulnerability discovery * Time-locked upgrades with governance approval #### 2. Active Monitoring and Management * **Real-time Trade Tracking**: * Milestone completion verification * Deviation alerts for delayed milestones * Early warning system for potential issues * **Continuous Risk Reassessment**: * Ongoing monitoring of political and regional risks * Weather and climate condition tracking * Market price volatility assessment * Supply chain disruption monitoring * **Proactive Intervention Protocols**: * Structured escalation procedures * Early mediation for emerging disputes * Renegotiation facilitation for changing conditions * **Liquidity Management**: * Strategic reserves maintenance * Withdrawal pacing during high demand * Secondary market support for $USDC-TRU3 tokens #### 3. Insurance and Recovery Mechanisms * **Dedicated Insurance Fund**: * 5% of all platform fees allocated to insurance reserves * Grows proportionally with platform activity * First line of defense against defaults * Governed by transparent usage policies * **Coface Insurance Partnership**: * **Coverage Scope**: Comprehensive insurance policy with Coface, a global leader in trade credit insurance * **Coverage Percentage**: Protection for up to 80% of the value of all qualified trades * **Qualification Criteria**: Trades meeting Coface's underwriting standards automatically covered * **Claim Process**: Streamlined claim process with 30-day maximum resolution time * **Premium Structure**: Insurance premiums built into the platform fee structure * **Policy Management**: Continuous policy optimization based on portfolio performance * **Exclusions**: Clear documentation of any exclusions or limitations * **Renewal Terms**: Guaranteed renewal terms based on portfolio performance metrics * **Staged Recovery Process**: * Structured default management procedures * Collateral liquidation protocols where applicable * Legal recovery through partner network * Loss sharing mechanisms as last resort #### 4. Default Scenario Management In the event of a trade default, TruMarket follows a structured process to minimize impact on liquidity providers: 1. **Default Detection and Verification**: * Automated detection of missed milestones or payments * Verification of default circumstances * Classification of default severity 2. **Immediate Mitigation Actions**: * Freeze remaining funds allocated to the trade * Notification to all affected parties * Activation of recovery team 3. **Recovery Attempt**: * Direct negotiation with defaulting party * Restructuring options where viable * Legal demand notices when necessary 4. **Insurance Claim Process**: * Documentation compilation for insurance claim * Submission to insurance fund committee * If approved, initial coverage from platform insurance fund * Submission to Coface for 80% coverage of remaining exposure 5. **Loss Allocation (if necessary)**: * Coverage of up to 5% of default from insurance fund * Coverage of up to 80% of remaining exposure from Coface Insurance * Remaining loss (approximately 15% of default value) distributed proportionally among liquidity providers 6. **Continuous Improvement**: * Post-default analysis and lessons learned * Risk model refinement based on default patterns * Enhancement of preventative measures #### 5. Risk-Adjusted Returns The platform's comprehensive risk mitigation framework enables it to offer competitive, risk-adjusted returns to liquidity providers: * **Base APY**: 14% baseline APY for liquidity providers * **Risk Adjustments**: Modifications based on comprehensive risk assessment * **Net Target Returns**: 10-18% APY after accounting for all risk factors * **Default Impact Modeling**: Expected returns factor in historical default rates * **Comparative Advantage**: Returns significantly higher than traditional financial instruments with similar risk profiles ## Risk Assessment Participation Mechanism ### Overview The Risk Assessment Participation mechanism is a critical component of TruMarket's security infrastructure, where staked $TRU3 tokens serve as collateral for risk assessors, ensuring they have "skin in the game" when evaluating trades on the platform. ### Core Mechanism #### Staking Requirements 1. **Base Staking Requirement**: * Minimum stake: 5,000 $TRU3 tokens to participate as a risk assessor * Staking period: Minimum 3-month lock-up period * Staking tiers: * Tier 1: 5,000-24,999 $TRU3 (eligible for small trades) * Tier 2: 25,000-99,999 $TRU3 (eligible for medium trades) * Tier 3: 100,000+ $TRU3 (eligible for all trades) 2. **Trade-Specific Collateral**: * Additional collateral requirement based on trade size: * 0.5% of trade value for trades up to $500,000 * 0.3% of trade value for trades between $500,000 and $2,000,000 * 0.2% of trade value for trades above $2,000,000 * Maximum collateral cap: 50,000 $TRU3 per trade #### Risk Assessment Process 1. **Assessor Selection**: * Platform randomly selects 3-5 eligible assessors for each trade based on their staking tier * Selected assessors must opt-in within 24 hours or forfeit the opportunity * Assessors must lock the required trade-specific collateral in addition to their base stake 2. **Assessment Submission**: * Assessors independently evaluate the trade based on standardized criteria * Each assessor submits: * Risk score (1-5) * Geographic risk assessment * Seasonal risk assessment * Product type risk assessment * Detailed justification for each rating 3. **Consensus Mechanism**: * Final risk parameters are determined through a weighted average of assessor inputs * Outlier detection algorithm identifies significantly divergent assessments * Consensus score is used to set the APY modifiers for the trade #### Reward and Penalty Structure 1. **Reward Mechanism**: * Base reward: 50 $TRU3 tokens per correctly assessed trade * Performance multiplier based on assessment accuracy: * High accuracy (within 5% of actual performance): 2x multiplier * Medium accuracy (within 10% of actual performance): 1.5x multiplier * Standard accuracy (within 15% of actual performance): 1x multiplier * Trade size bonus: Additional 0.01% of trade value in $TRU3 tokens * Consistency bonus: +10% reward for each consecutive accurate assessment (up to 50%) 2. **Penalty Mechanism**: * Inaccurate assessment (>20% deviation from actual performance): * Minor inaccuracy (20-30% deviation): 10% of collateral slashed * Moderate inaccuracy (30-50% deviation): 25% of collateral slashed * Severe inaccuracy (>50% deviation): 50% of collateral slashed * Malicious collusion (detected through pattern analysis): * 100% of collateral slashed * Permanent ban from assessment participation * Failure to submit assessment after opt-in: * 5% of collateral slashed * Temporary 7-day suspension from assessment opportunities 3. **Performance Tracking**: * Each assessor receives an on-chain reputation score * Score factors: * Assessment accuracy history * Number of trades assessed * Total value of assessed trades * Consistency of participation * Higher reputation scores unlock additional rewards and opportunities ### Benefits to the Platform 1. **Higher Quality Risk Assessments**: * Assessors have financial incentive to provide accurate assessments * "Skin in the game" reduces likelihood of negligent or malicious assessments * Reputation system encourages consistent quality 2. **Decentralized Risk Evaluation**: * Multiple independent assessors reduce single points of failure * Consensus mechanism prevents manipulation by individual assessors * Diverse perspectives lead to more balanced risk evaluation 3. **Increased $TRU3 Utility and Demand**: * Creates additional utility for $TRU3 tokens * Locks tokens in staking contracts, reducing circulating supply * Rewards are paid in $TRU3, creating sustainable token velocity 4. **Self-Improving System**: * Performance-based rewards attract and retain skilled assessors * Penalty mechanism removes poor performers * Reputation system creates long-term incentives for quality 5. **Enhanced Platform Security**: * Collateral requirements deter Sybil attacks * Tiered access prevents new/small assessors from evaluating high-value trades * Slashing penalties for collusion protect against coordinated manipulation ## Token Utility The $TRU3 token is designed with multiple utilities to create value within the TruMarket secure trading ecosystem: ### 1. Trade Governance Rights Token holders can vote on: * Platform security enhancements * Trade approval and risk parameters * Fee structures and distribution * Protocol upgrades Voting power is proportional to $TRU3 holdings, ensuring those with the greatest stake in the platform's success have appropriate influence. **Example: Governance Voting** A proposal to adjust the fee structure from 8% to 7.5% is submitted: * Minimum participation required: 10% of circulating supply (2,000,000 $TRU3) * Approval threshold: >50% of votes * Voting results: * 1,500,000 $TRU3 votes FOR * 1,000,000 $TRU3 votes AGAINST * Total participation: 2,500,000 $TRU3 (12.5% of circulating supply) * Approval percentage: 60% (1,500,000 ÷ 2,500,000) * Outcome: Proposal passes and fee structure is adjusted to 7.5% ### 2. Trade Fee Discounts $TRU3 holders receive discounted platform fees, reducing the cost of secure global trading: * Tiered discount structure based on token holdings: * Tier 1 (1,000-9,999 $TRU3): 1% discount (7% effective fee) * Tier 2 (10,000-99,999 $TRU3): 2% discount (6% effective fee) * Tier 3 (100,000+ $TRU3): 3% discount (5% effective fee) **Example: Fee Discount Calculation** A supplier with 50,000 $TRU3 tokens (Tier 2) is facilitating a secure trade worth $500,000: * Standard fee: $500,000 × 8% = $40,000 * Tier 2 discount: 2% * Effective fee rate: 8% - 2% = 6% * Discounted fee: $500,000 × 6% = $30,000 * Savings: $10,000 ### 3. Priority Access to Trade Financing $TRU3 holders get priority access to new agricultural trade financing opportunities: * Tiered access windows based on token holdings: * Tier 3 (100,000+ $TRU3): 48-hour early access * Tier 2 (10,000-99,999 $TRU3): 24-hour early access * Tier 1 (1,000-9,999 $TRU3): 12-hour early access **Example: Priority Access Timeline** For a new high-demand coffee export trade worth $2,000,000: * Day 1, 00:00 UTC: Trade financing opens for Tier 3 holders only * Day 2, 00:00 UTC: Trade financing opens for Tier 2 holders * Day 2, 12:00 UTC: Trade financing opens for Tier 1 holders * Day 3, 00:00 UTC: Trade financing opens for all users By the time the trade opens to all users, Tier 3 holders have already filled 60% of the pool, securing the highest APY rates. ### 4. Risk Assessment Participation Token holders can stake $TRU3 to participate in trade risk assessment, ensuring trade security: * Staked $TRU3 serves as collateral, ensuring assessors have "skin in the game" * Successful risk assessors earn additional $TRU3 rewards * This mechanism maintains the integrity of the risk scoring system * Assessors with higher stakes can evaluate larger trades **Example: Risk Assessment Rewards** A user stakes 5,000 $TRU3 to participate in risk assessment for 10 trades: * Base reward per correct assessment: 50 $TRU3 * User correctly assesses 8 out of 10 trades * Total rewards: 8 × 50 = 400 $TRU3 * Return on staked $TRU3: 8% (400 ÷ 5,000) ### 5. Trade Listing and Assessment $TRU3 is used as the payment token for: * Trade creators to list their trades on the platform * Paying auditors for risk assessment services This creates a practical utility and demand for the token within the platform's operational flow, directly tying token value to the volume of secure global trading facilitated by the platform. ## Technical Implementation ### Smart Contract Architecture Based on the TruMarket GitHub repository (), the platform implements several key smart contracts: 1. **DealsManager.sol**: Core contract that manages the entire trade lifecycle, including: * Trade creation and registration * Milestone tracking and verification * Fund disbursement based on milestone completion * Trade completion and finalization 2. **Tru3Token.sol**: ERC-20 implementation with added functionality for the platform's token economy: * Standard token functions (transfer, approve, etc.) * Minting capabilities for rewards distribution * Burning mechanism for fee reduction and token value appreciation 3. **USDCStakingPool.sol**: Manages the unified USDC staking pool: * Stake acceptance and tracking * $TRU3 and $USDC-TRU3 token issuance * APY calculation and distribution * Withdrawal processing 4. **USDC\_Tru3Token.sol**: ERC-20 implementation representing liquidity provider positions: * 1:1 representation of USDC staked * Transferability for secondary market trading * Redemption for underlying USDC plus returns 5. **RiskAssessmentStaking.sol**: Implements the collateralized risk assessment system: * Assessor registration and tier assignment * Collateral management * Assessment submission and consensus calculation * Reward and penalty distribution ### DealsManager Contract Implementation The DealsManager contract is a central component of the TruMarket platform, implementing the OpenZeppelin ERC721 standard for NFT representation of trades and providing comprehensive trade management functionality: ```solidity // SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts/token/ERC721/ERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; contract DealsManager is ERC721, ERC721Burnable, Ownable { // Events for tracking trade lifecycle event DealCreated(uint256 dealId); event DealMilestoneChanged(uint256 dealId, uint8 milestone); event DealCompleted(uint256 dealId); // Trade structure struct Deal { uint8 status; uint8[] milestones; uint256 maxDeposit; address borrower; } // Contract state variables address private underlying; // USDC uint256 private _nextTokenId; Deal[] private deals; // Constructor initializes the contract constructor(address initialOwner, address _underlying) ERC721("Deal", "DEAL") Ownable(initialOwner) { underlying = _underlying; } // Create a new trade function createDeal() public returns (uint256 dealId) { // Implementation details } // Update trade milestone function updateDealMilestone(uint256 dealId, uint8 milestone) public { // Implementation details } // Complete a trade function completeDeal(uint256 dealId) public { // Implementation details } // Additional helper functions // ... } ``` ### Integration with Global Trading Infrastructure The platform integrates with existing global trading infrastructure to provide a seamless experience: 1. **Payment Gateways**: Integration with fiat on/off ramps for global currency support 2. **Logistics Tracking**: API connections to shipping and logistics providers for real-time tracking 3. **Regulatory Compliance**: Built-in compliance checks for international trade regulations 4. **Documentation Management**: Secure storage and verification of trade documentation ## Internet Computer Protocol (ICP) Integration TruMarket will integrate with the Internet Computer Protocol (ICP) to enhance its infrastructure for hosting information and deal management. The following features have been selected for implementation: ### 1. Deal Documentation Storage and Verification * **Feature**: Store all deal-related documentation (contracts, certificates, shipping documents) on ICP * **Benefits**: * Immutable record-keeping * Tamper-proof document verification * Decentralized access control * **Implementation Complexity**: Medium * **Timeline**: 2-3 months ### 2. Decentralized Identity Management * **Feature**: Implement decentralized identity solutions for suppliers and buyers using Internet Identity on ICP * **Benefits**: * Self-sovereign identity for platform participants * Reduced KYC friction while maintaining compliance * Enhanced privacy for sensitive business information * **Implementation Complexity**: High * **Timeline**: 4-6 months ### 3. Decentralized Frontend Hosting * **Feature**: Host TruMarket's web interface on ICP canisters * **Benefits**: * Censorship-resistant access * Reduced infrastructure costs * Improved global availability * **Implementation Complexity**: Low * **Timeline**: 1-2 months ### 4. Decentralized Analytics and Reporting * **Feature**: Build analytics and reporting infrastructure on ICP * **Benefits**: * Privacy-preserving data analytics * Real-time reporting without centralized databases * Transparent yet secure access to platform metrics * **Implementation Complexity**: Medium * **Timeline**: 3-4 months ### Phased Implementation Approach #### Phase 1: Foundation (Months 1-3) * Decentralized Frontend Hosting * Initial Deal Documentation Storage #### Phase 2: Core Functionality (Months 4-8) * Decentralized Identity Management * Decentralized Analytics and Reporting ## Project Roadmap ### Overview This roadmap outlines the development phases of the TruMarket platform, highlighting both completed milestones and upcoming features. ### Phase 1: Foundation (Completed) #### Core Infrastructure * [x] Set up development environment with Node.js * [x] Implement Docker containerization for local development * [x] Create CI/CD pipeline with GitHub Actions * [x] Establish project structure and architecture #### Smart Contract Development * [x] Scaffold smart contract architecture * [x] Implement DealsManager contract for trade lifecycle management * [x] Create ERC20 mock for testing purposes * [x] Set up Hardhat development environment for Ethereum contracts #### API Development * [x] Develop core API structure * [x] Implement repository pattern for data access * [x] Create deals endpoints for trade management * [x] Abstract repositories in services for better separation of concerns #### Frontend Foundation * [x] Set up Next.js framework for web interface * [x] Implement basic UI components * [x] Configure authentication system * [x] Add frontend and associated local development environment ### Phase 2: Core Functionality (In Progress) #### Enhanced Security * [x] Implement KYC integration * [x] Add Auth0 authentication * [ ] Implement role-based access control * [ ] Add multi-factor authentication #### Smart Contract Enhancements * [ ] Implement $TRU3 token contract * [ ] Create $USDC-TRU3 representation token * [ ] Develop unified liquidity pool contract * [ ] Implement risk assessment staking mechanism #### Platform Features * [ ] Build comprehensive dashboard for users * [ ] Develop trade creation and management interface * [ ] Implement milestone tracking and verification * [ ] Create liquidity provider interface #### Testing and Auditing * [ ] Conduct comprehensive smart contract testing * [ ] Perform security audit of platform * [ ] Implement automated testing for frontend * [ ] Complete integration testing of full platform ### Phase 3: Advanced Features (Upcoming) #### Internet Computer Protocol Integration * [ ] Implement deal documentation storage and verification on ICP * [ ] Develop decentralized identity management using Internet Identity * [ ] Deploy decentralized frontend hosting on ICP canisters * [ ] Build decentralized analytics and reporting infrastructure #### Enhanced Tokenomics * [ ] Launch $TRU3 token * [ ] Implement dynamic APY system * [ ] Deploy fee distribution mechanism * [ ] Activate buyback and burn program #### Risk Management System * [ ] Implement comprehensive risk assessment framework * [ ] Integrate Coface Insurance partnership (80% coverage) * [ ] Develop default scenario management system * [ ] Create risk analytics dashboard #### Global Expansion * [ ] Add multi-currency support * [ ] Implement localization for key markets * [ ] Develop region-specific compliance features * [ ] Create partnerships with regional agricultural organizations ### Phase 4: Ecosystem Development (Future) #### Platform Extensions * [ ] Develop mobile application * [ ] Create API for third-party integrations * [ ] Implement advanced analytics and reporting * [ ] Build marketplace for agricultural services #### Governance and Community * [ ] Launch DAO governance for platform direction * [ ] Implement community-driven proposal system * [ ] Create incentive programs for ecosystem participants * [ ] Develop grants program for ecosystem expansion #### Advanced Financial Products * [ ] Implement agricultural derivatives * [ ] Develop yield farming opportunities * [ ] Create cross-chain liquidity solutions * [ ] Build advanced risk management products ### Timeline * **Phase 1**: Completed (2024) * **Phase 2**: Q2 2025 - Q3 2025 * **Phase 3**: Q4 2025 - Q2 2026 * **Phase 4**: Q3 2026 onwards ## Conclusion The TruMarket tokenomics model creates a sustainable economic system that aligns the interests of all stakeholders in the agricultural supply chain. By implementing an 8% value-based fee and a dynamic APY system (10-18%) with early participation incentives and risk measurement mechanisms, the model provides clear value to liquidity providers while ensuring platform sustainability. As a tool for secure global trading of agricultural products, TruMarket delivers specific benefits to all participants: **For Suppliers:** * Access to global financing without traditional banking constraints * Fair, risk-based pricing for trade financing * Transparent milestone-based fund release * Verified buyer relationships reducing counterparty risk **For Buyers:** * Verified supplier credentials and performance history * Secure payment mechanisms tied to delivery milestones * Reduced risk of fraud or non-performance * Access to a global network of qualified suppliers **For Liquidity Providers:** * Risk-adjusted returns through the dynamic APY system * Diversified exposure across multiple agricultural trades * Protection through comprehensive risk assessment and Coface Insurance covering 80% of trade values * Transparent fee distribution and return calculation **For Risk Assessors:** * Additional utility for $TRU3 tokens through staking * Performance-based rewards for accurate assessments * Reputation building within the platform ecosystem * Participation in platform security and risk management The combination of a unified USDC staking pool, $TRU3 token rewards, $USDC-TRU3 representation, risk-adjusted returns, and collateralized risk assessment creates a balanced ecosystem that can drive long-term growth and adoption. This approach positions TruMarket at the forefront of agricultural finance innovation, creating a bridge between traditional agriculture and decentralized finance that benefits producers, buyers, investors, and risk assessors alike. The revised tokenomics model with its single pool structure ensures that all liquidity providers have exposure to all trades, creating a more diversified risk profile and more stable returns. The real-world flow from trade proposal to completion is streamlined, with $TRU3 tokens playing a crucial role in trade listing, risk assessment, and governance. By focusing on being a tool for secure global trading rather than simply a marketplace, TruMarket creates tangible value for all participants, justifying its fee structure and creating sustainable demand for the $TRU3 token. ## Glossary **APY**: Annual Percentage Yield, the rate of return earned on an investment over a year. **Buyback and Burn**: The process of a project purchasing its own tokens from the market and permanently removing them from circulation. **Coface Insurance**: A global trade credit insurance provider that partners with TruMarket to provide coverage for up to 80% of qualified trade values. **DAO**: Decentralized Autonomous Organization, a community-led entity with no central authority. **DealsManager**: The smart contract responsible for managing the lifecycle of trades on the TruMarket platform. **ERC-20**: A technical standard used for smart contracts on the Ethereum blockchain for implementing tokens. **ICP**: Internet Computer Protocol, a decentralized computing platform that extends the functionality of the public internet. **Liquidity Pool**: A collection of funds locked in a smart contract to facilitate trading, lending, or other financial activities. **Risk Assessment**: The process of evaluating potential risks associated with agricultural trades using multiple factors and independent assessors. **Risk Assessment Participation**: The mechanism where users stake $TRU3 tokens to participate in evaluating trade risks with collateralized positions. **Staking**: The process of locking up cryptocurrency holdings to earn rewards or interest. **Tokenomics**: The study of the economics of a cryptocurrency or token. **$TRU3**: The native utility token of the TruMarket platform. **USDC**: USD Coin, a stablecoin pegged to the US dollar. **$USDC-TRU3**: Token representing the stake of liquidity providers in the pool 1:1 to their position in USDC. **Vesting**: A process by which tokens are gradually released to stakeholders according to a predetermined schedule.