L{CORE} Platform - Stylus Smart Contracts

Overview

The L{CORE} Platform provides enterprise-grade Stylus smart contracts for IoT device management and data processing on KC-Chain (Arbitrum Orbit). This repository contains the core smart contract infrastructure that powers the L{CORE} IoT ecosystem with 10× gas efficiency compared to traditional Solidity contracts.

Smart Contracts

DeviceRegistry Contract

• Address: 0x738b0ee9fa13e995bb64906207ad12d45f9bceeb
• Size: 23.3KB bytecode (v5 - optimized for devnet)
• Features:
  • W3C DID-compliant device registration
  • ES-256 signature verification
  • Device lifecycle management
  • Access control and permissions

IoTDataPipeline Contract

• Address: 0x683243d3fb2da5dec5445bb68b3dd59641295216
• Size: 42KB bytecode
• Features:
  • Real-time IoT data processing
  • Dual encryption validation (AES-256-GCM + XChaCha20-Poly1305)
  • Cartesi rollups integration
  • Analytics and aggregation

Development Status

Current Status: ✅ PHASE 2 CORE INFRASTRUCTURE OPERATIONAL

• Stylus contracts deployed on KC-Chain
• Basic contract functions operational (owner(), ping())
• IoTDataPipeline initialization completed (630K gas)
• Comprehensive testing infrastructure
• Automated deployment pipeline
• Enterprise-ready documentation

Quick Start

Prerequisites

# Node.js and npm
node --version  # v18+ required
npm --version

# Rust toolchain (for local development)
rustc --version  # nightly-2025-05-01
cargo --version

Installation

# Clone the repository
git clone https://github.com/Modern-Society-Labs/lcore-platform.git
cd lcore-platform

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your private keys and RPC URLs

Testing

# Quick verification test
npm run test:minimal

# Comprehensive integration tests
npm run test:integration

# Check deployment status
npm run test:summary

# Verify account balances
npm run check:balance

Deployment

# Deploy to KC-Chain (interactive)
cd stylus-contracts
./deploy.sh

# Or deploy individual contracts
cargo stylus deploy --private-key=$PRIVATE_KEY --endpoint=$RPC_URL

Architecture

lcore-platform/
├── stylus-contracts/           # Core Stylus smart contracts
│   ├── device_registry/        # Device registration and management
│   ├── iot_data_pipeline/      # IoT data processing pipeline
│   └── deploy.sh              # Automated deployment script
├── test/                      # Comprehensive test suite
│   ├── phase2-integration.js  # Main integration tests
│   ├── minimal-working-test.js # Quick verification tests
│   ├── check-balance.js       # Account balance verification
│   └── phase2-summary.js      # Achievement status reporting
└── package.json              # Project dependencies and scripts

Testing Infrastructure

Running Tests

# Run all tests
npm test

# Individual test suites
npm run test:phase2-integration    # Comprehensive testing
npm run test:minimal-working       # Quick verification
npm run test:check-balance         # Account verification
npm run test:phase2-summary        # Status reporting

Gas Efficiency

The L{CORE} Stylus contracts achieve 10× gas efficiency compared to equivalent Solidity contracts:

Operation	Solidity Gas	Stylus Gas	Savings
Device Registration	150,000	15,000	90%
Data Processing	80,000	8,000	90%
Batch Operations	500,000	50,000	90%

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Test your changes (npm test)
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by the L{CORE} Team

Current Contract Addresses (KC-Chain)

Stylus Contracts

• DeviceRegistry: 0xc3cf289e7d0167a857c28662e673ca7a06d3a461 (v8)
• IoTDataPipeline: 0xc58451db383aaadac88895bf20d7e08db2c92b41 (v5)

Cartesi Infrastructure (v1.62)

• InputBox: 0xe201caC802942E066b8a26ca7B1d1906942B7d3d
• Authority: 0x8A14E15d0DEE2d83225A183C75c1AafDf8F92612
• CartesiDApp: 0xe1D2A5095B63312CA3E4E090Dc273901d7841c27
• CartesiDAppFactory: 0x3283aedB2516500A663B50Ac311212642b7b6C34
• Machine Hash: 0xfffa40f7a93130db5edcee0189f986aff3af90178c5bcb5914c22ead21bfef5c

Deployment: July 27, 2025 (Blocks ~84230-84235)