> For the complete documentation index, see [llms.txt](https://whitepaper.litho.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.litho.ai/makalu/packages/blockchain-core.md).

# @lithosphere/blockchain-core

Lithosphere L1 Blockchain Core Implementation

## Overview

This package contains the core blockchain implementation for Lithosphere, including:

* **Smart Contracts**: LEP100 token standard, DeFi protocols, and governance contracts
* **SDK**: Developer tools and libraries for building on Lithosphere
* **Chain Implementation**: Core blockchain protocols and consensus mechanisms

## Project Structure

```
blockchain-core/
├── src/
│   ├── contracts/       # Smart contracts (Solidity/Rust)
│   ├── sdk/            # TypeScript/JavaScript SDK
│   ├── chain/          # Blockchain core implementation
│   ├── consensus/      # Consensus mechanism (Linear Communication BFT)
│   └── crypto/         # Cryptographic utilities (MDKM, ring signatures)
├── test/               # Tests
└── docs/               # Technical documentation
```

## Getting Started

This package is currently a placeholder for future development. When implementing:

1. Add smart contracts to `src/contracts/`
2. Implement SDK in `src/sdk/`
3. Add chain logic to `src/chain/`
4. Write comprehensive tests in `test/`

## Development

```bash
# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

# Type checking
pnpm typecheck
```

## Technologies

* **Smart Contracts**: Solidity / CosmWasm (Rust)
* **SDK**: TypeScript
* **Blockchain**: Custom L1 implementation
* **Consensus**: Linear Communication BFT
* **Cryptography**: MDKM (Myriad Distributed Key Management)

## Related Documentation

See the `@lithosphere/docs` package for:

* Whitepaper and technical specifications
* LEP100 token standard documentation
* Architecture and design documents
* API documentation

## License

\[Add your license here]