@flayerlabs/gamemode-gate 0.1.0 → 0.3.0

package/src/store.ts

@@ -10,8 +10,16 @@ import type { Pool, PoolClient } from 'pg';
 export const SCHEMA = `
 create table if not exists rounds (
   id             text primary key,
+  game_id        text not null check (game_id <> ''),
   wei_per_point  numeric(78,0) not null check (wei_per_point > 0),
   wallet_cap_wei numeric(78,0) not null check (wallet_cap_wei > 0),
+  -- The two settings that produced wei_per_point, frozen beside it. They are gate-process config,
+  -- so an operator who restarts with a new ETH price must not retroactively change what a round
+  -- was priced at.
+  points_per_dollar double precision not null check (points_per_dollar > 0),
+  usd_per_eth       double precision not null check (usd_per_eth > 0),
+  max_points_per_player bigint not null check (max_points_per_player > 0),
+  score_authority text not null check (score_authority in ('rules', 'external-server')),
   pool_id        text not null,
   opens_at       bigint not null,
   closes_at      bigint not null,
@@ -29,6 +37,37 @@ create table if not exists rounds (
   constraint rounds_books_tail check (books_close_at >= closes_at)
 );
 
+-- A developer may already have run the first published schema without creating any rounds. Add
+-- the new authority fields in place for that empty setup. Existing round data needs a deliberate
+-- reset because its original reward bound cannot be reconstructed safely.
+alter table rounds
+  add column if not exists game_id text check (game_id <> '');
+alter table rounds
+  add column if not exists max_points_per_player bigint check (max_points_per_player > 0);
+alter table rounds
+  add column if not exists score_authority text check (score_authority in ('rules', 'external-server'));
+alter table rounds
+  add column if not exists points_per_dollar double precision check (points_per_dollar > 0);
+alter table rounds
+  add column if not exists usd_per_eth double precision check (usd_per_eth > 0);
+do $$
+begin
+  if exists (
+    select 1 from rounds
+    where game_id is null or max_points_per_player is null or score_authority is null
+       or points_per_dollar is null or usd_per_eth is null
+  ) then
+    raise exception 'pre-release round rows cannot be upgraded safely'
+      using hint = 'Delete the pre-release round data, then run migrate(pool) again.';
+  end if;
+end
+$$;
+alter table rounds alter column game_id set not null;
+alter table rounds alter column max_points_per_player set not null;
+alter table rounds alter column score_authority set not null;
+alter table rounds alter column points_per_dollar set not null;
+alter table rounds alter column usd_per_eth set not null;
+
 create table if not exists balances (
   round_id text not null references rounds(id) on delete cascade,
   player   text not null,
@@ -61,6 +100,18 @@ create table if not exists claims (
 
 create index if not exists claims_by_player on claims (round_id, player) where status = 'held';
 
+-- Trusted creator servers use one stable event id for every score increment. The event and the
+-- balance update commit together, so a retry can recover the first result without paying twice.
+create table if not exists award_events (
+  round_id  text not null references rounds(id) on delete cascade,
+  event_id  varchar(128) not null check (event_id <> ''),
+  player    text not null,
+  points    bigint not null check (points > 0),
+  total_points bigint not null check (total_points >= points),
+  created_at timestamptz not null default now(),
+  primary key (round_id, event_id)
+);
+
 -- Which game a coin plays. Addresses are chain-local, so the pin is one row per (chain, coin).
 create table if not exists registrations (
   chain_id    bigint not null check (chain_id > 0),
@@ -68,8 +119,10 @@ create table if not exists registrations (
   game_id     text not null check (game_id <> ''),
   gate_origin text not null check (gate_origin <> ''),
   deploy_id   text not null check (deploy_id <> ''),
+  game_server_origins text[] not null default '{}'::text[],
   disabled_at timestamptz,
   updated_at  timestamptz not null default now(),
+  constraint registrations_game_server_origins_bounded check (cardinality(game_server_origins) <= 4),
   primary key (chain_id, coin)
 );