> For the complete documentation index, see [llms.txt](https://suigar.gitbook.io/suigar-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://suigar.gitbook.io/suigar-docs/public.md).

# Public docs source

Suigar is a provably fair, **on-chain casino on the Sui blockchain**. Every bet and result is settled and publicly verifiable on-chain using Sui's on-chain randomness — there is no off-chain server RNG. Players connect a Sui wallet and play directly against audited smart contracts, with instant on-chain payouts.

These docs cover Suigar developer tooling for integrating Suigar's provably fair games into your own on-chain app. Player guides and the SweetHouse staking protocol are documented at the resources linked below.

## Quick facts

* **Product:** Suigar — provably fair, on-chain casino (GambleFi) on Sui
* **Blockchain:** Sui — outcomes use on-chain randomness and are independently verifiable
* **Games:** 8 first-party games — Coinflip, Range, Limbo, Plinko, Wheel, Slots, Rock-Paper-Scissors, and PvP Coinflip — plus the SuiRoyale battle-royale raffle
* **Payouts:** instant, settled on-chain
* **Security:** smart contracts independently audited by [MoveBit](https://movebit.xyz/reports/Suigar-Audit-Report-2025-11-10.pdf) (report dated 2025-11-10)
* **SDK and MCP source:** [github.com/Suigar-Gaming/ts-sdks](https://github.com/Suigar-Gaming/ts-sdks)

## Developer Tools

The TypeScript SDKs repository ships the `@suigar/sdk` client extension and the `@suigar/mcp` server for agent-assisted transaction workflows. The MCP server can read Suigar config, describe game inputs, build unsigned transaction bytes, and dry-run supported game transactions without signing or executing them.

* [SDK overview](/suigar-docs/public/sdk.md) — what the SDK does and how it fits together
* [Integration guide](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/integration.md) — install the SDK, set up a partner, build a transaction, handle validation and errors, with an end-to-end example
* [MCP guide](/suigar-docs/public/mcp.md) — configure the Suigar MCP server, use its tools, and understand build, dry-run, and read-only modes
* Per-game references: [Coinflip](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/coinflip.md), [Limbo](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/limbo.md), [Plinko](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/plinko.md), [Range](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/range.md), [Wheel](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/wheel.md), [PvP Coinflip](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/pvp-coinflip.md)

AI coding agents can also install Suigar-specific skills from [Suigar-Gaming/agent-skills](https://github.com/Suigar-Gaming/agent-skills). Use those skills when an agent is setting up the SDK, building standard or PvP game flows, or operating the MCP server.

## How provably fair works

Suigar derives every outcome from Sui's on-chain randomness rather than a private server RNG. Because the randomness source, the bet, and the settlement all live on-chain, any player can independently verify that a result was not manipulated. This is the core difference between an on-chain casino like Suigar and a conventional online casino.

## FAQ

### What is Suigar?

A provably fair, on-chain casino on the Sui blockchain. Players bet directly against audited smart contracts, and every result is verifiable on-chain.

### Are the games provably fair?

Yes. Outcomes use Sui's on-chain randomness, and the bet and settlement are recorded on-chain, so results are independently verifiable.

### How do I integrate Suigar games?

Use the Suigar SDK. Start with the [Integration guide](https://github.com/Suigar-Gaming/suigar/tree/main/docs/public/sdk/integration.md), then see the per-game references above.

### Are the contracts audited?

Yes — the smart contracts are independently audited by MoveBit (report dated 2025-11-10).

## More resources

* [Suigar (play)](https://suigar.com/) — the main on-chain casino
* [Suigar Blog](https://suigar.com/blog/) — strategy guides and probability deep dives
* [SweetHouse](https://house.suigar.com/) — liquidity-staking protocol that backs the house
* Community: [X / Twitter](https://x.com/Suigar_com) · [Discord](https://discord.gg/tAYGd46ZUK) · [Telegram](https://t.me/suigarofficial)

*Last updated: 2026-07-07 (July 7, 2026).*