# IceRoot documentation

> Guides and references for IceRoot, Heartwood Core, wallets, native assets, migrations, validators and application integrations.

Start with the overview for your task, then fetch only the relevant Markdown pages below. Each page includes its canonical source; headings in the JSON index link to exact sections.

The documentation distinguishes implementation, sample interfaces and the draft mainnet protocol. Keep Draft, Planned, Demo and network/version labels with the claims they qualify. Proposed parameters and API shapes are not evidence of a deployed feature. Check the selected release and network configuration before implementing an integration.

The explorer API reference describes a read-only sample ledger. Its OpenAPI contract is separate from the proposed node API. Treat API playground output as examples, not live network state.

## Start here

- [IceRoot docs](https://docs.iceroot.com/index.md): Explore IceRoot documentation for wallets, native assets, migrations, validators and Heartwood Core.
- [Welcome to IceRoot](https://docs.iceroot.com/getting-started/introduction/index.md): Find your way around the IceRoot network, wallets, explorer, and validator community.
- [About IceRoot](https://docs.iceroot.com/getting-started/about/index.md): Mono Labs, the relationship between IceRoot and Monolythium, LYTH’s asset lifecycle, and the protocol’s engineering background.
- [Heartwood Core](https://docs.iceroot.com/core/overview/index.md): See what Heartwood Core implements and where to begin working with it.
- [Protocol design](https://docs.iceroot.com/core/protocol-design/index.md): Read the scope of the draft IceRoot whitepaper alongside the implemented Heartwood baseline.
- [Developer overview](https://docs.iceroot.com/developers/overview/index.md): Choose an API, wallet integration, or Heartwood development path.

## Learn

- [What IceRoot is for](https://docs.iceroot.com/getting-started/what-iceroot-is-for/index.md): Understand the asset lifecycle IceRoot is designed for, who decides what, and what the network deliberately leaves out.
- [Consensus and finality](https://docs.iceroot.com/network/consensus/index.md): Understand the draft QDPoS design, scheduled validator activity, and finality signal.
- [Native assets](https://docs.iceroot.com/network/assets/index.md): Understand asset identity, balances, supply, and migration history in IceRoot.
- [ROOT supply and distribution](https://docs.iceroot.com/network/root/index.md): ROOT's genesis supply, the seven genesis pools, the team lock, fee grants, and block rewards in the draft protocol. IceRoot holds no token sale.
- [Migrations and continuity](https://docs.iceroot.com/network/migrations/index.md): Understand how IceRoot models an asset's movement between networks.
- [Lifecycle labels](https://docs.iceroot.com/network/lifecycle/index.md): The two lifecycle flags that consensus keeps for each asset, and the descriptive labels the explorer derives from counters and records.

## Use

- [Choose a wallet](https://docs.iceroot.com/getting-started/choose-wallet/index.md): Compare the mobile, browser, and desktop IceRoot wallets.
- [Desktop wallet](https://docs.iceroot.com/wallets/desktop/index.md): Create a profile, navigate your wallets, and follow an action through its review steps.
- [Browser wallet](https://docs.iceroot.com/wallets/browser/index.md): Navigate the browser wallet, receive an address, and manage a signing identity.
- [Mobile wallet](https://docs.iceroot.com/wallets/mobile/index.md): Find your wallets, send and receive actions, and validator votes on Android and iOS.
- [Send and receive](https://docs.iceroot.com/wallets/send-receive/index.md): Enter transfer details, review the total, and read the result.
- [Sign in with your wallet](https://docs.iceroot.com/wallets/sign-messages/index.md): Review a validator-portal login message and sign it through the browser wallet or manually.
- [Use the explorer](https://docs.iceroot.com/network/explorer/index.md): Find and understand IceRoot blocks, transactions, assets, accounts, and validators.

## Projects

- [Launch a native asset](https://docs.iceroot.com/projects/launch-native-asset/index.md): Plan, create, and distribute a fixed-supply native asset through Seedbed, without a token contract.
- [Launch before your mainnet](https://docs.iceroot.com/projects/launch-before-mainnet/index.md): Launch an asset on IceRoot while your own chain is built, then open a recorded route for holders to move to it.
- [Migration guide](https://docs.iceroot.com/projects/migration/index.md): Move an asset onto IceRoot, retire a chain, leave a smart contract, recover after an incident, and move assets out again.
- [Snapshot Builder](https://docs.iceroot.com/projects/snapshot-builder/index.md): Planned tooling that turns a source chain's ledger into a migration list that validators can reproduce and certify.
- [Connector adapters](https://docs.iceroot.com/projects/connector-adapters/index.md): What a Connector adapter must provide, and how support for a new source network is proposed, reviewed, and certified.

## Build

- [Integration principles](https://docs.iceroot.com/developers/integration-principles/index.md): Handle IceRoot identities, amounts, network state, and errors consistently.
- [Clients and SDK integration](https://docs.iceroot.com/developers/sdk/index.md): Query the explorer with JavaScript and understand the proposed SDK model.
- [Browser wallet provider](https://docs.iceroot.com/developers/wallet-provider/index.md): Connect to a Heartwood devnet identity and request an explicit portal login signature.
- [Architecture](https://docs.iceroot.com/core/architecture/index.md): Explore Heartwood's source layout and the responsibilities of IceRoot applications.
- [Build from source](https://docs.iceroot.com/core/installation/index.md): Set up the Heartwood development workspace and verify its current Rust baseline.
- [Testing and compatibility](https://docs.iceroot.com/core/testing/index.md): Understand Heartwood's reference vectors, differential tests, and release checks.

## Validators

- [Validators and voting](https://docs.iceroot.com/network/validators/index.md): Learn what validators do and how to compare their work before voting.
- [Publish your proposal](https://docs.iceroot.com/validators/proposal/index.md): Introduce your validator and explain what you commit to the IceRoot network.
- [Share contributions](https://docs.iceroot.com/validators/contributions/index.md): Publish a useful, dated record of the work your validator contributes.
- [Validator hardening](https://docs.iceroot.com/validators/hardening/index.md): Separate a validator's keys and processes, keep its relay private behind optional sentry relays, and firewall each host.

## Exchanges

- [Exchanges and custodians](https://docs.iceroot.com/developers/exchanges/index.md): Plan asset identification, deposits, withdrawals, and finality handling against the draft IceRoot integration model.
- [Custody gateways](https://docs.iceroot.com/developers/custody-gateways/index.md): How a custodial operator carries IceRoot units to another chain and back, how gateways are labeled, and what an operator publishes.

## Reference

- [Transactions](https://docs.iceroot.com/core/transactions/index.md): Understand transaction preparation, review, submission, and recorded results.
- [Cryptography](https://docs.iceroot.com/core/cryptography/index.md): Read the current signing formats, crypto features, and proposed mainnet changes.
- [Milestones](https://docs.iceroot.com/core/milestones/index.md): Understand how height-based configuration keeps protocol rules reproducible.
- [Network configuration](https://docs.iceroot.com/core/network-configuration/index.md): Keep mainnet, testnet, devnet identities, and sample data clearly separated.
- [Network status](https://docs.iceroot.com/network/status/index.md): IceRoot's current development status, planned release announcements, and the proposed network status signals.
- [Explorer API](https://docs.iceroot.com/developers/explorer-api/index.md): Query the current read-only IceRoot explorer API and handle its response envelopes.
- [Try the REST API](https://docs.iceroot.com/developers/rest-api/index.md): Send a read-only request, inspect the JSON response, and copy the cURL command.

## Machine-readable contracts and SDK sources

- [Explorer OpenAPI specification](https://docs.iceroot.com/openapi/explorer.json): Paths, parameters and response schemas for the documented explorer API. Sample-ledger service; not the node protocol API.
- [TypeScript SDK](https://github.com/iceroot-network/sdk-typescript): Read the selected branch or release documentation for current package exports, runtime support and installation.
- [Rust SDK](https://github.com/iceroot-network/sdk-rust): Read the selected branch or release documentation for native SDK capabilities and compatibility.

## Optional

- [Whitepaper (draft)](https://docs.iceroot.com/reference/whitepaper/index.md): Long-form proposed protocol. Preserve the draft notice and source revision; use targeted guides first.
- [Full documentation bundle](https://docs.iceroot.com/llms-full.txt): All exported pages in one Markdown text file, including the draft whitepaper. Use only when the complete corpus is needed.
- [Documentation index](https://docs.iceroot.com/docs-index.json): Versioned JSON inventory: titles, summaries, sections, URLs, headings, byte sizes and SHA-256 digests.