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

# EVM Compatibility

## Overview

BitBadges Chain integrates the Cosmos `x/evm` module to enable Ethereum Virtual Machine (EVM) compatibility. Solidity contracts can interact with the tokenization module through precompiled contracts.

## Architecture

```
Solidity Contract → EVM Precompile → Tokenization Module → Cosmos SDK State
```

**Precompile Address:** `0x0000000000000000000000000000000000001001`

## Documentation

* [**Setup & Configuration**](/token-standard/evm_integration/setup-and-configuration.md) - Chain config, MetaMask setup, dApp setup
* [**Developer Guide**](/token-standard/evm_integration/developer-guide.md) - Transaction signing, address conversion, limitations
* [**Architecture**](/token-standard/evm_integration/architecture.md) - System architecture details
* [**ERC-3643 Security Token Template**](https://github.com/trevormil/bitbadges-docs/blob/master/evm/evm-precompiles/erc3643-template.md) - Standardized security token template
* [**Tokenization Precompile API**](/token-standard/evm_integration/tokenization-precompile/api.md) - Complete API reference
* [**Error Handling**](/token-standard/evm_integration/tokenization-precompile/errors.md) - Error codes and handling
* [**Gas Costs**](/token-standard/evm_integration/tokenization-precompile/gas.md) - Gas calculation and optimization
* [**Security**](/token-standard/evm_integration/tokenization-precompile/security.md) - Security best practices

## Resources

* [Cosmos SDK EVM Documentation](https://docs.cosmos.network/evm/v0.5.0/documentation/overview)
* [Tokenization Module](/token-standard/x-tokenization.md)
* [Counter dApp Example](https://github.com/BitBadges/bitbadgeschain/tree/evm-poc/counter-dapp)
* [Contracts Folder](https://github.com/BitBadges/bitbadgeschain/tree/evm-poc/contracts)