# hexdocs

> 

- Documentation: https://pr-1-9bee85ef9c41.thally.app
- GitHub: https://github.com/Timidan/hexdocs
- Full docs for LLMs: https://pr-1-9bee85ef9c41.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://pr-1-9bee85ef9c41.thally.app/ai.txt
- Structured docs index (JSON): https://pr-1-9bee85ef9c41.thally.app/api/docs-index
- OpenAPI spec: https://pr-1-9bee85ef9c41.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://pr-1-9bee85ef9c41.thally.app/api/docs/{page-id}
- Search API: https://pr-1-9bee85ef9c41.thally.app/api/search?q={query}
- Capability manifest (skill): https://pr-1-9bee85ef9c41.thally.app/skill.md
- Agent guidance (editing these docs): https://pr-1-9bee85ef9c41.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://pr-1-9bee85ef9c41.thally.app/api/mcp
- Agent readiness: https://pr-1-9bee85ef9c41.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://pr-1-9bee85ef9c41.thally.app/): What Hexkit is and what you can do with it.
- [Quickstart](https://pr-1-9bee85ef9c41.thally.app/quickstart): Open Hexkit and complete your first task — no install, no account.

### Concepts

- [How intent orders work](https://pr-1-9bee85ef9c41.thally.app/concepts/intent-orders): Escrow, deadlines, solvers, settlement, and refunds for cross-chain vault routes.

### Run your own

- [Self-hosting and configuration](https://pr-1-9bee85ef9c41.thally.app/self-hosting): Run your own Hexkit instance — setup, environment variables, proxy routes, and contracts.

## Guides

### Decode & identify

- [Decode calldata](https://pr-1-9bee85ef9c41.thally.app/guides/decode-a-transaction): Turn a hex blob into a readable function call with named parameters.
- [Identify an unknown function](https://pr-1-9bee85ef9c41.thally.app/guides/signature-lookup): Turn a 4-byte selector or event topic into a readable signature.
- [Add your own signatures](https://pr-1-9bee85ef9c41.thally.app/guides/custom-signatures): Teach Hexkit about your contracts so it names them everywhere.

### Simulate

- [Simulate a transaction](https://pr-1-9bee85ef9c41.thally.app/guides/simulate-a-transaction): Run a transaction against real chain state without broadcasting it.
- [Read simulation results](https://pr-1-9bee85ef9c41.thally.app/guides/read-simulation-results): Find your way around the results page — summary, contracts, and events.
- [See what moved](https://pr-1-9bee85ef9c41.thally.app/guides/asset-changes): Read the ETH and token movements a transaction would cause.
- [See what storage changed](https://pr-1-9bee85ef9c41.thally.app/guides/state-changes): Read the storage slots a transaction would write, decoded to variable names.
- [Follow the execution trace](https://pr-1-9bee85ef9c41.thally.app/guides/execution-trace): Read the call-by-call record of what a transaction actually did.
- [Step through a transaction](https://pr-1-9bee85ef9c41.thally.app/guides/debugger): Walk execution line by line with source, stack, and variable state.

### Inspect contracts

- [Read a contract's source](https://pr-1-9bee85ef9c41.thally.app/guides/explore-contract-source): Fetch verified Solidity for any address and see through proxies.
- [Compare two contracts](https://pr-1-9bee85ef9c41.thally.app/guides/compare-bytecode): Check whether two deployments are byte-for-byte identical.
- [Inspect contract storage](https://pr-1-9bee85ef9c41.thally.app/guides/inspect-storage): Read a live contract's storage slots, decoded to variable names.

### Interact

- [Call a contract](https://pr-1-9bee85ef9c41.thally.app/guides/call-a-contract): Read state and send transactions against any contract, on any supported chain.

### LI.FI Earn

- [Deposit into a vault](https://pr-1-9bee85ef9c41.thally.app/guides/deposits): Put funds into a yield vault, including from a chain you don't hold them on.
- [Withdraw from a vault](https://pr-1-9bee85ef9c41.thally.app/guides/withdrawals): Take funds out of a vault and move them where you want them.
- [Get vault recommendations](https://pr-1-9bee85ef9c41.thally.app/guides/ai-concierge): Find idle funds and rank vaults, by scanning your wallet or by describing a goal.

### Support

- [Troubleshooting](https://pr-1-9bee85ef9c41.thally.app/troubleshooting): What each error means and how to get your funds moving again.

## API Reference

Interactive API reference available at https://pr-1-9bee85ef9c41.thally.app/api