# Tsamara

> Sovereign sukuk in $10 units on Solana, with every transfer rule enforced onchain. An unlicensed devnet prototype with a mock series; the docs say what is proven and what is not.

Links point at Markdown (`.md`). Drop the suffix for HTML.

## Docs

- [Acknowledgements](https://docs.tsamara.xyz/docs/acknowledgements.md): What Tsamara is built with.
- [Operator API](https://docs.tsamara.xyz/docs/api.md): The HTTP service that holds the operator's keys.
- [For builders](https://docs.tsamara.xyz/docs/builders.md): The parts of Tsamara, what each one is responsible for, and how to run them.
- [Compliance mapping](https://docs.tsamara.xyz/docs/compliance-mapping.md): What a regulated sukuk offering needs, what Tsamara does about each item today, and what code cannot solve.
- [Compliance program](https://docs.tsamara.xyz/docs/compliance-program.md): The Anchor program Token-2022 calls on every transfer of the sukuk.
- [Contributing](https://docs.tsamara.xyz/docs/contributing.md): How changes are made in this repository.
- [Deployment](https://docs.tsamara.xyz/docs/deployment.md): Five containers, one per service, each configured from the environment.
- [Distributions](https://docs.tsamara.xyz/docs/distributions.md): How the periodic distribution is calculated, paid, and kept from being paid twice.
- [Eligibility and transfers](https://docs.tsamara.xyz/docs/eligibility.md): Who may hold units, what every transfer is checked against, and what the compliance authority can do.
- [FAQ](https://docs.tsamara.xyz/docs/faq.md): Short answers, with the caveats kept.
- [How it works](https://docs.tsamara.xyz/docs/how-it-works.md): From a published series to a distribution, in five steps.
- [Indexer](https://docs.tsamara.xyz/docs/indexer.md): A Rust service that turns the series' transactions into holders and events.
- [Introduction](https://docs.tsamara.xyz/docs/introduction.md): Sovereign sukuk in $10 units on Solana, with every transfer rule enforced onchain.
- [llms.txt](https://docs.tsamara.xyz/docs/llms-txt.md): These docs as Markdown, for AI agents.
- [MCP server](https://docs.tsamara.xyz/docs/mcp-server.md): Live access to these docs for an AI agent.
- [Regulatory and sharia notes](https://docs.tsamara.xyz/docs/regulation.md): What a real version of Tsamara would have to satisfy, and what follows for the design and for what we may say.
- [Status](https://docs.tsamara.xyz/docs/status.md): What is deployed, what has been proven, and what is not true yet.
- [The sukuk library](https://docs.tsamara.xyz/docs/sukuk-library.md): packages/sukuk builds every instruction Tsamara sends.
- [Testing](https://docs.tsamara.xyz/docs/testing.md): What each layer of tests covers and how to run it.
- [Try the demo](https://docs.tsamara.xyz/docs/try-the-demo.md): Subscribe to the demo series on devnet with a test wallet, in a few minutes.

## Optional

- [Full documentation](https://docs.tsamara.xyz/llms-full.txt): All pages in one Markdown file
- [MCP server](https://docs.tsamara.xyz/api/mcp): list_pages, search_docs, get_page
- [GitHub](https://github.com/tsamara-xyz/tsamara): Source, tests and the compliance mapping