# roll.codes

> Integrate verifiable randomness into Solidity contracts on Abstract.

## Docs

- [create-roll-codes CLI](https://docs.roll.codes/cli/create-roll-codes.md): Reference for the starter CLI in this repository that scaffolds a Foundry project wired for roll.codes integration work.
- [Callback security](https://docs.roll.codes/concepts/callback-security.md): Apply the core security checks every roll.codes consumer callback should enforce.
- [How roll.codes works](https://docs.roll.codes/concepts/how-roll-codes-works.md): Understand the request, verification, and callback flow behind roll.codes randomness delivery.
- [Request lifecycle](https://docs.roll.codes/concepts/request-lifecycle.md): Understand how a roll.codes randomness request moves from creation to callback settlement.
- [Consumer patterns](https://docs.roll.codes/contracts/consumer-patterns.md): Use these request-tracking and settlement patterns to keep roll.codes consumers easy to reason about.
- [Coordinator reference](https://docs.roll.codes/contracts/coordinator-reference.md): Reference for the public VRFSystem calls, callback interface, and events used by roll.codes consumers.
- [Deployed addresses](https://docs.roll.codes/contracts/deployed-addresses.md): Network addresses for the roll.codes hosted coordinator on Abstract.
- [Integration pattern](https://docs.roll.codes/contracts/integration-pattern.md): Copy a minimal roll.codes consumer that requests randomness, stores request state, and settles safely in the callback.
- [Troubleshooting](https://docs.roll.codes/faq/troubleshooting.md): Resolve the most common roll.codes integration failures, including install issues, callback authorization problems, and stuck requests.
- [Introduction](https://docs.roll.codes/index.md): Integrate against the roll.codes hosted coordinator from your Solidity contract and receive random numbers through a callback.
- [Install and setup](https://docs.roll.codes/install.md): Set up Foundry, install roll.codes dependencies, and configure your project to use the hosted roll.codes coordinator.
- [Quickstart](https://docs.roll.codes/quickstart.md): Create a new roll.codes project from the starter CLI or integrate the hosted coordinator into an existing Solidity contract.

## OpenAPI Specs

- [openapi](https://docs.roll.codes/api-reference/openapi.json)