> For the complete documentation index, see [llms.txt](https://docs.bitplanet.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bitplanet.ai/developer-guides/developer-guides.md).

# Overview

Build on Bitplanet's BitSDK blockchain with full EVM compatibility, bridging the Cosmos and Ethereum ecosystems.

## Overview

Enables developers to seamlessly build applications using both BitSDK modules and Ethereum smart contracts.

**Key Features:**

* BitSDK (built on Cosmos SDK v0.53.3) with CometBFT consensus
* Full EVM compatibility via BitEVM v1.0.0-rc2
* Custom modules: `x/brahma` for AI token economics, `x/precompile` for EVM bridge
* IBC v10.0.0-beta for cross-chain communication
* Native token: `bplcoin` with automated reward distribution

## Documentation

### Core Development

* [**Module API**](/developer-guides/module-api.md) - x/brahma and x/precompile module APIs
* [**Smart Contract Integration**](/developer-guides/smart-contract.md) - GemCoreNFT, ERC1155, and adapter contracts
* [**Module Interaction**](/developer-guides/module-interaction.md) - Architecture and event processing

### Implementation

* [**Security Considerations**](/developer-guides/security-considerations.md) - DoS prevention, validation, and credential management
* [**Quick Start**](/developer-guides/quick-start.md) - Setup, build, test, and deploy

## Quick Start

```bash
# Clone and build
git clone https://github.com/BitPlanet/Bitplanet-CosmosEVM.git
cd Bitplanet-CosmosEVM

# Initialize credentials (required)
make init-env-deterministic  # Same test credentials every time

# Start testnet
make sh-testnet

# Endpoints available:
# - JSON-RPC: http://localhost:8545
# - Cosmos RPC: http://localhost:26657
# - REST API: http://localhost:1317
# - gRPC: localhost:9090
```

## Network Details

* **Chain ID**: 9001
* **Native Token**: bplcoin (18 decimals)
* **Block Time**: \~1 second
* **Consensus**: CometBFT