Skip to content

Game Fairness

Overview

The Game Fairness component enables users to verify the integrity of game results through provably fair tools. It also provides tabs for managing active seeds and viewing the history of rotated seeds.

Script URL

This web component is provided as a script and can be loaded from the CDN using the following URL pattern:

https://<cdn-url>/<bundle-version>/game-fairness.js

Example:

https://cdn.prod-gt-demo-games.gamnify.tech/v1.1.0/game-fairness.js

Both <cdn-url> and <bundle-version> values will be provided to you.

If making use of the browser's Subresource Integrity feature, the integrity hash will also be provided.

Component Details

Once the script is loaded, the Game Fairness component can be added to the page by using the element <gt-game-fairness>.

Required Attributes

Attribute Type Description
roundId string The unique identifier of the game round to display.

Optional Attributes

Attribute Type Description
initialTab string The initially selected tab. Accepted values: verifier, seeds, history. Default: verifier.
locale string The locale code for content localization (e.g. en-US).
settledDateUtc string The settlement date of the round in ISO 8601 UTC format (e.g. 2025-10-22T00:00:00.000Z).
theme string The visual theme to apply (e.g. dark, light). Falls back to the default theme if invalid.
token string The session token used for authentication.

Example

<gt-game-fairness 
  roundId="1234-5678-9012"
  initialTab="verifier"
  settledDateUtc="2025-10-22T00:00:00.000Z"
  token="auth-token-value"
></gt-game-fairness>

Events

The following is a list of all available events supported by this component.

Details on how to listen for and dispatch events can be found here.

Outgoing Events

gtGameFairness.out.error

Fairness error occurred.

{
  code: string;
  message: string;
}

gtGameFairness.out.init

Fairness initialized.

{
  roundId?: string;
}

gtGameFairness.out.seedCopied

Seed value copied to clipboard.

{
  seedType: 'client' | 'server';
}