Rollerz SDK

Appearance

Environments reference ​

For a quick overview and setup instructions, see Environments. This page covers the full details of each environment and how they combine.

SDK environments ​

Testing ​

The testing environment is a hosted SDK server at https://rollerz-sdk-testing.up.railway.app/. No local server setup needed.

  • Users are separate from production data
  • Useful for verifying the full flow (init, open game, bet, animation, collect)
html
<script src="https://rollerzsdk-testing.up.railway.app/sdk"></script>
<script>
  const sdk = window.RollerzSDK;
  await sdk.init('my-game', { enableLogging: true });
</script>

Production ​

The production environment at https://prod.rollerz.dev connects to live systems with real balances, real currency, and real players.

  • Auth is persistent and shared across all users. This is managed by the platform, not the SDK.
  • CORS_ORIGIN and BRIDGE_ALLOWED_ORIGINS are restricted to whitelisted domains
  • MATH_SERVER_ALLOWED_HOSTS is set to an exact-match list of trusted math-server hosts — required to prevent body-driven ?server= overrides from reaching arbitrary URLs (SSRF). See RGS Math Servers → Launch URL parameters.
  • Logging should be disabled for end users
html
<script src="https://rollerzsdk.up.railway.app/sdk"></script>
<script>
  const sdk = window.RollerzSDK;
  // No enableLogging in production
  await sdk.init('my-game');
</script>

WARNING

Before deploying to production, ensure your game's domain is whitelisted in the SDK server's CORS configuration. Contact the Rollerz team to register your domain.

RGS environments ​

Local Dev (mock) ​

You can build your own mock RGS for local development. The only requirement is that it conforms to the same request/response contract as the real RGS — see RGS Math Servers for the expected structures. This gives you full control over bet outcomes during development without depending on a hosted backend.

Staging ​

The staging RGS at https://math-test-nl.reelsoft.net/{provider}-v102/mock behaves like production but is isolated. Use it for final QA — test the full player journey with realistic math responses.

Production ​

The live RGS at https://math-test-nl.reelsoft.net/{provider}-v102. Real math results, real currency, real payouts.

Proxy Server

In the future, games will not talk to the RGS directly. Both staging and production RGS traffic will go through the Proxy Server instead, with the Staging SDK communicating with the Proxy Server wired to the Staging RGS ("Staging Proxy Server"), and the Production SDK communicating with the Proxy Server wired to the Production RGS ("Production Proxy Server").