# BYOS — Bring Your Own Solver

> A bonded CoW Protocol solver whose solutions are sourced from a permissionless set of external sub-solvers. This site is the normative specification shared by the contracts and service implementations.

## Docs

- [/design-document](https://bleu.github.io/byos-docs/design-document.md): The normative BYOS specification: order flow, trampoline, escrow, proposal schema and API, gas accounting, penalties and attribution. Cited by ADRs in every implementation repo via stable #slugs.
- [/glossary](https://bleu.github.io/byos-docs/glossary.md): The joint domain vocabulary. Every shared term is defined here and nowhere else.
- [/guides/sub-solver-integration](https://bleu.github.io/byos-docs/guides/sub-solver-integration.md): How an external sub-solver goes from zero to a settled proposal.
- [/operations/slo-targets](https://bleu.github.io/byos-docs/operations/slo-targets.md): Latency targets for the proposal API and /solve, and the reasoning behind each.
- [/security/trampoline-settlement-isolation](https://bleu.github.io/byos-docs/security/trampoline-settlement-isolation.md): Adversarial proof that a sub-solver route reaches only its own trampoline instance.
- [/reference/cow-fee-collection](https://bleu.github.io/byos-docs/reference/cow-fee-collection.md): How CoW fees work: a price wedge, settled by weekly accounting. Third-party background.
- [/reference/cow-solver-slashing-policy](https://bleu.github.io/byos-docs/reference/cow-solver-slashing-policy.md): CoW's own penalty framework, which BYOS mirrors toward sub-solvers. Third-party background.
- [/reference/solver-auctions](https://bleu.github.io/byos-docs/reference/solver-auctions.md): CoW's auction mechanism, including the fair combinatorial auction. Third-party background.
- [/reference/solver-cips](https://bleu.github.io/byos-docs/reference/solver-cips.md): The CIPs that govern solver behaviour. Third-party background.

## Optional

- [Full corpus](https://bleu.github.io/byos-docs/llms-full.txt): every page above concatenated, for a single fetch.
- [bleu/byos-contracts](https://github.com/bleu/byos-contracts): Escrow, Trampoline, TrampolineFactory, and the contract-side ADRs.
- [bleu/byos-service](https://github.com/bleu/byos-service): the Rust service, its ADRs, and the proposal API OpenAPI document.
- [bleu/byos-service-ts](https://github.com/bleu/byos-service-ts): the TypeScript service.