# Aptos Developer Documentation

> Developer documentation for the Aptos blockchain — Move smart contracts, SDKs, APIs, indexer, node operations, and AI tools.

Canonical site: https://aptos.dev
Sitemap: https://aptos.dev/sitemap.xml

This file is a compact router for LLMs and coding agents. It highlights the most useful Aptos docs first, while the full corpus remains available separately.

Machine-readable documentation:
- [Curated low-token docs](https://aptos.dev/llms-small.txt): concise Aptos reference for agents and IDE assistants.
- [Full documentation corpus](https://aptos.dev/llms-full.txt): complete rendered Aptos documentation for large-context ingestion.

Structured API assets (non-Markdown):
- [Aptos Fullnode OpenAPI 3 spec](https://aptos.dev/aptos-spec.json): OpenAPI document for the node REST API (accounts, transactions, view functions, events).
- [REST API reference (HTML)](https://aptos.dev/rest-api): browsable docs generated from the same spec on this site.

Agent tooling and canonical sources:
- [Aptos MCP on npm](https://www.npmjs.com/package/@aptos-labs/aptos-mcp): run `npx @aptos-labs/aptos-mcp` to give IDEs on-chain queries, REST helpers, and Move tooling.
- [Aptos Agent Skills](https://github.com/aptos-labs/aptos-agent-skills): installable skills for Move, TypeScript SDK, and dApp scaffolding.
- [AI tools hub](https://aptos.dev/build/ai.md): MCP setup, Agent Skills, and LLMs.txt usage on one page (Markdown).
- [auth.md](https://aptos.dev/auth.md): agent authentication for aptos.dev (public docs; Testnet Faucet uses human Google OIDC).
- [OAuth Protected Resource Metadata](https://aptos.dev/.well-known/oauth-protected-resource): RFC 9728 document for this origin.
- [Aptos Labs on GitHub](https://github.com/aptos-labs): official SDKs, tools, and sample code.
- [Aptos Explorer](https://explorer.aptoslabs.com/): look up accounts, transactions, validators, and network health.
- [Aptos standards (AIPs)](https://aptos.dev/build/smart-contracts/aptos-standards.md): tokens, naming, and other Aptos Improvement Proposal standards.
- [Indexer GraphQL reference](https://aptos.dev/build/indexer/indexer-api/indexer-reference.md): schema-oriented reference for historical on-chain data (pairs with REST OpenAPI above).

External Move language and framework references:
- [Move Book](https://aptos-labs.github.io/move-book/): full Move language reference (mdBook).
- [Move Book — single-page print](https://aptos-labs.github.io/move-book/print.html): the entire Move Book as one HTML page (~0.5 MB); recommended for LLM ingestion.
- [Aptos Framework Book](https://aptos-labs.github.io/framework-book/): reference for `aptos-framework`, `aptos-stdlib`, `move-stdlib`, `aptos-token-objects`, and related packages (mdBook). Browse per-module pages — the consolidated print page is ~7 MB and not recommended for ingestion.

Markdown access:
- Documentation pages are available as rendered Markdown by appending `.md` to the canonical page URL.
- Example: https://aptos.dev/build/guides/first-transaction -> https://aptos.dev/build/guides/first-transaction.md

## Start Here

- [Get Started Building on Aptos](https://aptos.dev/build/get-started.md): Learn how to build on Aptos with smart contracts, indexer queries, SDKs, APIs, and comprehensive developer resources
- [Learn from Guides](https://aptos.dev/build/guides.md): Step-by-step tutorials for building on Aptos, from first transactions and Move modules to orderless transactions, keyless accounts, and exchange integration.
- [Ethereum to Aptos Migration Guide](https://aptos.dev/build/get-started/ethereum-cheatsheet.md): Comprehensive comparison and migration guide for Ethereum developers transitioning to Aptos blockchain development
- [Your First Transaction](https://aptos.dev/build/guides/first-transaction.md): Create and submit your first transaction on Aptos blockchain - transfer coins between accounts with TypeScript, Python, Go, and Rust examples.
- [Payments on Aptos](https://aptos.dev/build/guides/payments.md): Build payments on Aptos: latency, fees, transfers, confidential transfers, sponsored and orderless options, and multi-agent two-party agreement.
- [Your First Move Module](https://aptos.dev/build/guides/first-move-module.md): Learn to compile, test, publish, and interact with Move smart contracts on Aptos blockchain from setup to deployment.
- [Accounts](https://aptos.dev/network/blockchain/accounts.md): Understand Aptos accounts, their addresses, authentication schemes, key rotation, sequence numbers, and how they control assets and resources on-chain.
- [Transactions and States](https://aptos.dev/network/blockchain/txns-states.md): Understand how transactions modify the blockchain state on Aptos, including transaction types, execution states, and the versioned database model.
- [SDKs Overview](https://aptos.dev/build/sdks.md): Official Aptos software development kits for TypeScript, Python, Go, and Rust, plus wallet adapter tooling
- [Aptos CLI – Install, Setup, and Use the Command-Line Interface](https://aptos.dev/build/cli.md): Learn how to install, configure, and use the Aptos CLI to compile Move contracts, interact with the blockchain, run a local network, and manage nodes.

## Concepts

- [Aptos Blockchain](https://aptos.dev/network/blockchain.md): Core concepts of the Aptos blockchain, including accounts, transactions, Move, execution, staking, and how nodes reach consensus.
- [Move - A Web3 Language and Runtime](https://aptos.dev/network/blockchain/move.md): Explore Move on Aptos: resource safety, comparison with other VMs, and Aptos-specific features such as objects, Block-STM, and fungible assets.
- [Execution](https://aptos.dev/network/blockchain/execution.md): Explore transaction execution on Aptos, including deterministic processing, Block-STM parallel execution, and why that keeps block times low.
- [Blocks](https://aptos.dev/network/blockchain/blocks.md): Understand blocks on Aptos, including system transactions, block epilogues, epochs, and how the versioned ledger stores per-transaction state.
- [Gas and Storage Fees](https://aptos.dev/network/blockchain/gas-txn-fee.md): Learn about gas fees and storage costs on Aptos, including execution costs, storage fees, gas pricing, and optimization strategies for efficient transactions.
- [Staking](https://aptos.dev/network/blockchain/staking.md): Understand staking on Aptos blockchain, including validator operations, rewards, lockup periods, and the owner-operator-voter model for network participation.

## Smart Contracts

- [Smart Contracts](https://aptos.dev/build/smart-contracts.md): Learn to write secure, efficient smart contracts on Aptos using the Move programming language with examples, tutorials, and developer resources
- [Building with Objects](https://aptos.dev/build/smart-contracts/objects.md): Learn about objects for Aptos Objects in smart contract development.
- [Randomness API](https://aptos.dev/build/smart-contracts/randomness.md): Learn about randomness for Move smart contract development on Aptos blockchain.

## APIs And Data

- [Aptos APIs](https://aptos.dev/build/apis.md): Access the Aptos blockchain through the Fullnode REST API, Indexer GraphQL, Transaction Stream gRPC, faucet, and Geomi-hosted endpoints
- [Fullnode REST API](https://aptos.dev/build/apis/fullnode-rest-api.md): Low-level REST API for reading state, submitting transactions, and simulating operations on the Aptos blockchain
- [Faucet API](https://aptos.dev/build/apis/faucet-api.md): Mint test APT on Devnet and Testnet using the faucet API, SDKs, CLI, or the Testnet mint page
- [Exchange Integration Guide](https://aptos.dev/build/guides/exchanges.md): Comprehensive guide for integrating Aptos and its assets into cryptocurrency exchanges with balance tracking and testing.
- [Indexer API Access](https://aptos.dev/build/indexer/indexer-api.md): Access Aptos Indexer GraphQL API for historical data, transactions, fungible assets, and tokens with SDK integration and direct endpoints
- [Indexer API Reference](https://aptos.dev/build/indexer/indexer-api/indexer-reference.md): Complete GraphQL API reference for Aptos Indexer with table schemas, query examples, and field documentation for tokens and accounts
- [Transaction Stream Service](https://aptos.dev/build/indexer/txn-stream.md): Real-time transaction streaming service for Aptos blockchain data, supporting both Aptos-hosted and self-hosted deployment options

## SDKs

- [TypeScript SDK](https://aptos.dev/build/sdks/ts-sdk.md): Official TypeScript SDK for building applications on Aptos - the most comprehensive and up-to-date SDK
- [TypeScript SDK Quickstart](https://aptos.dev/build/sdks/ts-sdk/quickstart.md): Get started with the Aptos TypeScript SDK by creating accounts, funding them, and transferring APT tokens between accounts
- [Python SDK](https://aptos.dev/build/sdks/python-sdk.md): Official Python SDK for Aptos blockchain development with accounts, data fetching, and transaction building
- [Python SDK Quickstart](https://aptos.dev/build/sdks/python-sdk/quickstart.md): Get started with the Aptos Python SDK by creating accounts, funding them, and transferring APT
- [Go SDK](https://aptos.dev/build/sdks/go-sdk.md): Official Go SDK for Aptos blockchain development with comprehensive examples and transaction building capabilities
- [Go SDK Quickstart](https://aptos.dev/build/sdks/go-sdk/quickstart.md): Get started with the Aptos Go SDK by creating accounts, funding them, and transferring APT
- [Rust SDK](https://aptos.dev/build/sdks/rust-sdk.md): Official Rust SDK for Aptos blockchain development with accounts, data fetching, and transaction building
- [Rust SDK Quickstart](https://aptos.dev/build/sdks/rust-sdk/quickstart.md): Get started with the Aptos Rust SDK by creating accounts, funding them, and transferring APT

## Advanced Topics

- [Sponsored Transactions](https://aptos.dev/build/guides/sponsored-transactions.md): Allow applications to pay transaction fees for users, simplifying onboarding by removing the need for gas tokens.
- [Orderless Transactions](https://aptos.dev/build/guides/orderless-transactions.md): Execute transactions out of order for multi-machine signing scenarios while maintaining replay protection and security.
- [Encrypted Pending Transactions](https://aptos.dev/build/guides/encrypted-pending-transactions.md): Encrypt transaction payloads before they reach consensus so pending execution details stay confidential on supported networks.
- [Aptos Keyless](https://aptos.dev/build/guides/aptos-keyless.md): Integrate Keyless accounts for seamless user onboarding using social logins instead of traditional private key management.
- [Transaction Management](https://aptos.dev/build/guides/transaction-management.md): Build scalable transaction management systems on Aptos with proper account handling and sequence number management.

## AI Tooling

- [AI Tools for Aptos Development](https://aptos.dev/build/ai.md): Use AI tools like Claude, Cursor, Codex, and GitHub Copilot to build on Aptos faster. Access the Aptos MCP server and LLMs.txt documentation feeds.
- [Aptos Model Context Protocol (MCP)](https://aptos.dev/build/ai/aptos-mcp.md): Learn how to use the Aptos MCP server to build applications with AI tools like Cursor, Claude Code, and Codex
- [Aptos Agent Skills](https://aptos.dev/build/ai/aptos-agent-skills.md): Pre-built AI skills for Claude Code, Cursor, and GitHub Copilot to write Move smart contracts, use the Aptos TypeScript SDK, and build full Aptos dApps.
- [LLMs.txt](https://aptos.dev/llms-txt.md): How to get tools like Cursor, GitHub Copilot, ChatGPT, Claude, Codex, and Devin to understand Aptos documentation.

## Nodes And Operations

- [Aptos Network Nodes](https://aptos.dev/network/nodes.md): Learn about validator nodes, validator fullnodes, and public fullnodes that power the Aptos network
- [Run a Public Fullnode](https://aptos.dev/network/nodes/full-node.md): Deploy and operate your own public fullnode (PFN) to synchronize with the Aptos blockchain and stay up-to-date with the latest state.
- [Run a Validator and VFN](https://aptos.dev/network/nodes/validator-node.md): Learn how to participate in the Aptos consensus protocol by deploying and running a validator node and validator fullnode (VFN) with step-by-step guidance.
- [Latest Aptos Releases](https://aptos.dev/network/releases.md): Find the latest Aptos releases for mainnet, testnet, and devnet with their corresponding GitHub branches

## Reference

- [Aptos Glossary](https://aptos.dev/network/glossary.md): Comprehensive glossary of terms and concepts used throughout the Aptos ecosystem and documentation
- [Aptos Error Codes](https://aptos.dev/build/smart-contracts/error-codes.md): Learn about error codes for Move smart contract development on Aptos blockchain.
- [Transaction Payloads and BCS](https://aptos.dev/network/blockchain/transaction-payloads.md): Learn the Aptos transaction payload types, how REST JSON maps to BCS, and how to build and decode payloads with TypeScript.
- [Aptos Improvement Proposals (AIPs)](https://aptos.dev/build/aips.md): Learn about Aptos Improvement Proposals - how the community proposes changes and improvements to the Aptos protocol
- [External Resources](https://aptos.dev/build/external-resources.md): Official and community references, learning material, and tools for building on Aptos