# Armchain Developer Docs

## Welcome to Armchain

**Post-Quantum Secure · EVM-Compatible · Instant Finality**

Armchain is a Layer 1 blockchain built for the post-quantum era. If you're familiar with Ethereum development, you'll feel right at home, deploy the same Solidity contracts you already know, but with quantum-resistant security and instant transaction finality.

Under the hood, Armchain replaces traditional ECDSA signatures with **ML-DSA44** (a NIST-standardized post-quantum algorithm) and uses **Lachesis aBFT** consensus so transactions are final the moment they're confirmed. No waiting, no rollbacks.

[Get Started](/get-started/overview.md) · [Quickstart](/get-started/quickstart.md) · [SDK Reference](/developers/overview-1.md) · [API Docs](/api-reference/json-rpc.md)

***

### Why Armchain?

* **Quantum-resistant from day one**: All signatures use ML-DSA44 (NIST FIPS 204), protecting against future quantum attacks
* **Instant finality**: Transactions are final the moment they're confirmed. No waiting for block confirmations
* **EVM compatible**: Write and deploy Solidity smart contracts just like on Ethereum (London fork)
* **High throughput**: DAG-based consensus lets all validators work in parallel, not one at a time
* **ARM token**: Native token for gas fees, staking, and governance

### Network at a Glance

| Parameter               | Value                             |
| ----------------------- | --------------------------------- |
| **Chain ID**            | `55`                              |
| **Native Token**        | ARM                               |
| **RPC URL**             | `https://www.armchain.org/devnet` |
| **Finality**            | Instant (aBFT)                    |
| **EVM Version**         | London                            |
| **Signature Algorithm** | ML-DSA44                          |

> **Quick test**: Verify connectivity with a single curl command:
>
> ```bash
> curl -s -X POST https://www.armchain.org/devnet \
>   -H "Content-Type: application/json" \
>   -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
> ```

***

### Documentation

#### Getting Started

| Guide                                                          | Description                           |
| -------------------------------------------------------------- | ------------------------------------- |
| [Overview](/get-started/overview.md)                           | What Armchain is and why it matters   |
| [Quickstart](/get-started/quickstart.md)                       | Deploy your first contract in minutes |
| [Network Configuration](/get-started/network-configuration.md) | Connect your tools to Armchain        |

#### Developers

| Guide                                            | Description                                    |
| ------------------------------------------------ | ---------------------------------------------- |
| [Smart Contracts](/developers/overview.md)       | Writing and deploying Solidity contracts       |
| [Armchain Ethers SDK](/developers/overview-1.md) | Drop-in ethers.js replacement with PQC signing |
| [Wallet Integration](/developers/overview-2.md)  | Connect your dApp to a wallet                  |

#### Architecture

| Guide                                                           | Description                                     |
| --------------------------------------------------------------- | ----------------------------------------------- |
| [Consensus (Lachesis aBFT)](/architecture/consensus.md)         | How Armchain achieves instant finality          |
| [DAG Structure](/architecture/dag.md)                           | The directed acyclic graph powering the network |
| [EVM Integration](/architecture/evm.md)                         | How the EVM runs on Armchain                    |
| [Transaction Lifecycle](/architecture/transaction-lifecycle.md) | From submission to finality                     |

#### Post-Quantum Cryptography

| Guide                                          | Description                                 |
| ---------------------------------------------- | ------------------------------------------- |
| [PQC Overview](/pqc/overview.md)               | Why Armchain uses post-quantum cryptography |
| [ML-DSA44 Deep Dive](/pqc/mldsa44.md)          | Algorithm parameters and performance        |
| [Transaction Types](/pqc/transaction-types.md) | Type 3 PQC transaction format               |

#### Node Operators

| Guide                                                       | Description                         |
| ----------------------------------------------------------- | ----------------------------------- |
| [Node Types](/node-operators/node-types.md)                 | Choose the right node configuration |
| [Fakenet](/node-operators/fakenet.md)                       | Local development network           |
| [Configuration Reference](/node-operators/configuration.md) | All node configuration options      |

#### Tools & Infrastructure

| Guide                                | Description                                |
| ------------------------------------ | ------------------------------------------ |
| [Block Explorer](/tools/explorer.md) | Browse blocks, transactions, and contracts |
| [Armchain Wallet](/tools/wallet.md)  | Official browser extension wallet          |
| [Faucet](/tools/faucet.md)           | Get devnet ARM tokens                      |

#### API Reference

| Guide                                           | Description                                     |
| ----------------------------------------------- | ----------------------------------------------- |
| [JSON-RPC API](/api-reference/json-rpc.md)      | Ethereum-compatible JSON-RPC endpoints          |
| [Armchain APIs](/api-reference/armchain-api.md) | DAG, validator, and Armchain-specific endpoints |

#### Resources

| Guide                                      | Description                 |
| ------------------------------------------ | --------------------------- |
| [FAQ](/resources/faq.md)                   | Answers to common questions |
| [Glossary](/resources/glossary.md)         | Key terms and definitions   |
| [Contributing](/resources/contributing.md) | How to contribute           |

***

[**armchain.org**](https://www.armchain.org) · [**Explorer**](https://www.armchain.org/explorer)

*Maintained by the Armchain team · Last updated March 2026*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.armchain.org/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
