1_general_forum/currency-ledger

💰 Smartup Zero Currency Ledger System

A git-native, transparent, and democratically governed dual-currency system for collective ownership and fair compensation.

Status: ✅ FULLY OPERATIONAL - Complete system with live transparency on timeline0.org and working task-SC integration

---

🎯 What We Built

The Currency Ledger System is the financial backbone of Smartup Zero, implementing:

• Smartup Credits (SC): 1 SC = €1 treasury claim for completed work
• Social Karma (SK): Non-transferable reputation currency for community contributions
• Book of Owners: Complete organizational chart with team memberships and role assignments
• Progressive Transparency: Public governance with strategic development protection
• Democratic Validation: Community oversight of all currency awards and policy changes
• Pending SC System: Phased validation for large retrospective awards (like founding work)
• Task-Based Work System: Effort-based assessment and SC allocation for collaborative work

🚀 Live Public Transparency

All currency data is publicly visible on timeline0.org:

• 📖 Book of Owners - Live organizational chart
• 💰 Financial Transparency - Complete financial health
• 💱 Currency System - How it all works

Pages auto-generate from CSV ledger data - complete transparency in action.

💎 Founder Accountability Model

Current Status: 82,200 SC pending validation representing 10 years of R&D work

Democratic Vesting Schedule

• Design Phase: 24,660 SC (30%) - Needs Team Captain validation
• Production Phase: 32,880 SC (40%) - Needs community vote
• Organization Phase: 24,660 SC (30%) - Automatic at market success

Integrity Principles

• ✅ Cannot self-validate - Founder subject to same democratic rules
• ✅ Success alignment - Vesting tied to collective achievement
• ✅ Community oversight - Every SC requires external approval
• ✅ Transparent process - All validation public and recorded

This demonstrates Smartup Zero's "no special founders" principle in practice.

---

🏗️ System Architecture

currency-ledger/
├── ledger/                          # Transaction records (public)
│   ├── smartup-credits/             # Live SC awards and redemptions
│   ├── social-karma/               # SK awards and decay events
│   ├── pending-sc/                 # Awaiting democratic validation
│   ├── treasury/                   # EUR balance and liability tracking
│   └── task-management/            # Work session logs and task tracking
├── ownership/                       # Organizational structure (public)
│   ├── book-of-owners.csv          # Public ownership registry with aliases
│   ├── license-transactions.csv    # License purchase/upgrade history
│   └── identity-mapping.csv        # Private: real names ↔ aliases (NEVER COMMITTED)
├── policies/                        # Configuration and rules (public)
│   ├── credit-rates.yml            # SC award rates and ADM split rules
│   ├── karma-rules.yml             # SK categories, thresholds, decay rates
│   ├── validation-rules.yml        # Democratic oversight processes
│   ├── license-policies.yml        # License types and capabilities
│   ├── organizational-structure.yml # Teams, roles, assignment rules
│   └── task-management/            # Effort assessment and work coordination
│       ├── effort-assessment-template.yml
│       └── mission-leader-rules.yml
└── scripts/                         # Management and automation tools
    ├── validate-ledger.py          # System integrity checking
    ├── generate-reports.py         # Financial transparency reports
    ├── manage-owners.py            # License and ownership management
    ├── manage-organization.py      # Team and role assignments
    ├── validate-pending-sc.py      # Pending SC validation workflows
    ├── update-profile.py           # Personal information updates
    ├── generate-public-pages.py    # Auto-generate timeline0.org pages
    ├── system-check.py             # Comprehensive system validation
    ├── destroy-sc.py               # SC destruction for system integrity
    └── task-management/            # Task workflow automation
        ├── create-task-with-budget.py
        └── assess-work-session.py

📊 Current System Status

Financial Health: ✅ EXCELLENT

• Live SC Outstanding: 153 SC (€153 liability)
• Pending SC: 82,200 SC (awaiting validation)
• EUR Treasury: €0 (no current funding)
• 3x Rule: ✅ PENDING (SC outstanding but no treasury funding yet)

Organizational Status: ✅ READY

• Total Owners: 1 (robbert_founder)
• Teams Formed: 1 (Leadership Team)
• Roles Assigned: 1 (Founding Entrepreneur)
• License Distribution: 1 Work License

---

🎯 Task-Based Work System

The ADM Triangle for Collaborative Work

Every task involves three roles:

• Attacker (Senior): Performs primary work, mentors junior (90% SC)
• Defender (Junior): Learns, provides QA, documents process (10% SC)
• Midfielder (Bot): Coordinates, logs activity, handles administration

Effort-Based Assessment

Work sessions are evaluated using structured criteria:

• Attacker Effort (1-10): Time investment, approach quality, communication, mentoring
• Defender Learning (1-10): Engagement level, skill acquisition, contributions
• Collaborative Quality (1-10): Team coordination, problem-solving, documentation

SC Payout Based on Effort Quality

• Excellent Session (27-30 points): 95-100% of budgeted SC
• Good Session (24-27 points): 80-95% of budgeted SC
• Adequate Session (18-24 points): 60-80% of budgeted SC
• Poor Session (6-18 points): 20-60% of budgeted SC
• Failed Session (0-6 points): 0-20% of budgeted SC

---

🚀 How to Use the System

For Team Captains

# Create a new task with SC budget
python3 scripts/task-management/create-task-with-budget.py \
  --objective 5_3_0 \
  --team-repo 3_1_leadership_team \
  --title "Fix authentication bug" \
  --description "Resolve login issues in mobile app" \
  --sc-budget 100 \
  --captain your_alias \
  --attacker senior_dev \
  --defender junior_dev

# Assess completed work session
python3 scripts/task-management/assess-work-session.py \
  --task-id 6_1_3_0 \
  --mission-leader your_alias \
  --start-time 2025-01-16T14:00:00Z \
  --end-time 2025-01-16T18:00:00Z \
  --attacker-effort-score 8 \
  --defender-learning-score 7 \
  --collaboration-score 9 \
  --session-notes "Detailed assessment of work quality and collaboration"

🚀 How to Use the System

For Current Owner (robbert_founder)

# Check system health
python3 currency-ledger/scripts/system-check.py

# View organizational chart
python3 currency-ledger/scripts/manage-organization.py

# Generate transparency reports
python3 currency-ledger/scripts/generate-reports.py

# Update public website pages
python3 currency-ledger/scripts/generate-public-pages.py

# Update personal profile
python3 currency-ledger/scripts/update-profile.py

For Future Team Captains

# Review pending SC validations
python3 currency-ledger/scripts/validate-pending-sc.py

# Validate founder's design phase work (24,660 SC)
# Process: Review work → Community discussion → Leadership vote → Validation

🔧 Key Operations

Adding New Owners

from scripts.manage_owners import OwnershipManager
manager = OwnershipManager()
manager.add_new_owner(
    real_name="Alice Johnson",
    email="alice@example.com", 
    display_name="alice_builder",
    license_type="work",
    payment_eur=200
)

For Contributors

1. Join: Purchase license via Open Collective
2. Onboard: Get added to Book of Owners
3. Contribute: Claim tasks, work in ADM pairs
4. Progress: Advance through license tiers based on SK accumulation
5. Lead: Become Team Captain, validate others' work

🔧 Key Operations

SC Lifecycle Management

1. Task Creation: Captain allocates SC budget to specific objectives
2. Work Session: ADM pair collaborates on task completion
3. Effort Assessment: Mission leader evaluates session quality
4. Pending Validation: SC awards go to pending-sc for review
5. Democratic Approval: Team Captain validates through existing system
6. SC Award: Validated SC moves to live ledger

SC Destruction (System Integrity)

# Destroy SC for system corrections or personal choice
python3 scripts/destroy-sc.py \
  --owner account_alias \
  --amount 50 \
  --reason "System integrity correction" \
  --destroyer captain_alias

Treasury Management

# Monitor system health and 3x rule compliance
python3 scripts/generate-reports.py

# Validate pending SC entries
python3 scripts/validate-pending-sc.py

---

🎯 Success Metrics

The currency system succeeds when:

• Democratic: All owners can see and influence how money flows
• Fair: Contributors earn proportional to verified effort and value created
• Sustainable: Treasury growth keeps pace with SC awards
• Scalable: System works at 10x, 100x current contributor count
• Aligned: Individual incentives serve collective SDG mission
• Transparent: Every transaction auditable by anyone, anytime

📈 Live System Data

First Task-Based SC Awards (Historic):

• Task 6_1_3_0: Prototype Effort-Based Task-SC Integration System
• Session Score: 26/30 (85% payout)
• Awards: 153 SC (robbert_founder), 17 SC (test_defender - system test account, later destroyed)
• Evidence: Complete audit trail in session logs and transaction records

System Test Account: test_defender appears in financial records as a documented system testing artifact used during development of the effort-based assessment system.

---

🔄 Integration Roadmap

Phase 1: ✅ COMPLETE (Validation Phase)

• ✅ Complete currency system operational
• ✅ Public transparency live on timeline0.org
• ✅ Task-SC integration system built and tested
• ✅ Effort-based assessment framework implemented
• ✅ First SC awards through collaborative work sessions

Phase 2: Design Phase

• 🎯 Team Captains validate 24,660 SC (Design tranche)
• 🎯 Engelbot integration for automated task coordination
• 🎯 Open Collective treasury sync for funding flows
• 🎯 Matrix/Element integration for real-time session notifications
• 🎯 Advanced mission leader dashboard and assessment tools

Phase 3: Production Phase

• 🎯 Community validates 32,880 SC (Production tranche)
• 🎯 Advanced reporting and analytics dashboards
• 🎯 Automated treasury management and redemption processing
• 🎯 50+ owners with mature democratic governance
• 🎯 Cross-team collaboration and skill development tracking

Phase 4: Organization Phase

• 🎯 Final 24,660 SC automatically vests at market success
• 🎯 Full production deployment with global 24/7 coverage
• 🎯 Template system for launching additional Smartups
• 🎯 Proven model scaling to multiple SDG-focused organizations

🤝 Contributing to the System

This currency system is itself a collective creation. Improvements welcome:

1. Identify Enhancement: System limitation or optimization opportunity
2. Propose Solution: Detailed proposal in General Forum
3. Community Discussion: Democratic debate and refinement
4. Implementation: Code changes with full testing and validation
5. Integration: Merge with updated documentation and transparency reports

📋 Development History

Task 6_0_3_0 - System Foundation (August 2025): Complete prototype of effort-based task-SC integration system built through collaborative work session between robbert_founder (attacker) and test_defender (defender). Established foundational workflows for task creation, effort assessment, and SC distribution through existing democratic validation system.

Key Innovations Implemented:

• Structured effort assessment using 30-point scoring system
• Session-based work logging with complete audit trails
• Integration with existing currency ledger validation workflows
• SC destruction capabilities for system integrity maintenance
• Mission leader role for real-time work coordination

System Integrity Measures:

• Book of Owners integration ensures only licensed members earn SC
• Progressive transparency maintains public accountability
• Democratic validation prevents unilateral SC awards
• Complete audit trails enable full transaction history review

---

🌍 Planetary Organization Vision

This system enables:

• 24/7 Global Operations: Contributors worldwide working across timezones
• Equal Compensation: Same SC rates regardless of geographic location
• Borderless Collaboration: Skills and contributions valued over nationality
• Democratic Governance: All major decisions subject to community oversight
• Sustainable Economics: Treasury growth balanced with SC liability management

Built with transparency and democratic accountability in mind.

This system embodies the core Smartup principle: Technology should serve collective human needs, built by and for the communities that use it, with full democratic accountability and protection from extraction.

Ready to earn your first Smartup Credits? Complete a task, demonstrate effort and collaboration, and join the future of work! 🚀

---

Version: 1.1 (Updated August 2025)
Status: Production-ready with active task-based SC system
Next Update: Integration with Engelbot automation and expanded team operations