Blockchain Relay

The relay is a TypeScript service on the Bun runtime that sits between the player-facing application and the blockchains. It provisions deposit addresses, tracks submitted transactions to confirmation, and posts confirmations to the ledger API so a balance moves only after the chain says it should.

It holds no game state and makes no gameplay decisions. Separating it from the engine means chain outages, reorgs and congestion are contained in one service instead of stalling a table.

Seven chains are wired: Solana, Ethereum (ERC-20), BNB Chain, Tron (TRC-20), Bitcoin, Bitcoin on the Omni Layer, and Liquid — carrying eleven assets between them, including BTC, ETH, SOL, BNB, TRX, USDT, USDC, DAI, WBTC, BUSD and USDP.

The demo environment runs on test networks — Solana devnet, Ethereum Sepolia, BNB testnet, Bitcoin signet, Liquid testnet — so an operator can walk the entire deposit and withdrawal path end to end without moving real value. The network for each chain is configuration, not code.

Four provisioning models are supported: a Solana program-derived address, a dedicated Solana keypair address per user and asset, an EVM address per user on Ethereum and BNB Chain, and a custodial Bitcoin address. The client requests an address, the player sends funds, the client submits the transaction id, and the relay follows it to confirmation.

Confirmed deposits are pushed to the ledger API as a settlement callback, and a WebSocket event stream lets the interface reflect a deposit the moment it lands rather than on the next poll.

The relay also answers exchange-rate queries against multiple market sources, estimates network fees per chain, applies the deposit commission policy, and exposes chain queries for transactions, addresses and UTXOs.

For flows that need custody guarantees it implements 2-of-3 multisig escrow on both EVM chains and Bitcoin. Every player-facing endpoint is authenticated with a bearer token and rate-limited per user; internal endpoints sit behind separate credentials.