Integration Tools

Everything you need to build the integration, in the order most people want it.

Let an AI agent do it

Integration skill

npx skills add beexar-games/public-api

Installs the beexar-integration skill into Claude Code, Cursor, Codex, OpenCode and ~80 other agents. It analyses your codebase, picks the right SDK, wires up the launcher and the four wallet callbacks, and knows the parts that are easy to get wrong — raw-body signing, idempotency, tombstones, decimal money.

Unlike a hand-written guide, it is generated from the platform’s own source, so its error-code table and timing budgets cannot drift from what the platform actually does. → How it works

Not using an agent with skill support? Copy a prompt instead.

Or use an SDK

Node / TypeScript

npm install @beexar/sdk

Zero dependencies, ESM + CJS, Node 18+. Guide · GitHub

PHP

composer require beexar/sdk

Zero dependencies — no bcmath, no gmp. PHP 8.1+. Guide · GitHub

go get github.com/beexar-games/beexar-go

Standard library only. Go 1.22+. Guide · GitHub

Python

pip install beexar

Standard library only. Python 3.9+. Guide · GitHub

Each SDK gives you the same two halves: a signed client for launching games, and a wallet server where you implement four methods against your own ledger while the SDK handles signature verification, parsing, validation, decimal money and the error envelope.

Or neither

Generate your own client

The contract is public and small — four callbacks you implement, three calls you make. Point any OpenAPI generator at it:

openapi-generator-cli generate \
  -i https://docs.beexar.com/api/wallet.yaml \
  -g <your-language> -o ./beexar

Spec	What it describes
`/api/wallet.yaml`	the four callbacks you implement
`/api/softswiss/gateway.yaml`	launching a real or demo session
`/api/gateway.yaml`	the operator game catalogue
`/api/common/schemas.yaml`	shared schemas

Then read the manual integration reference for what a generator will not give you: raw-body signing, idempotency, tombstones and the money rules.

Then prove it works

Reference wallet

A complete, correct wallet in ~250 lines, in all four languages. Read it, run it, or copy the parts you need. → Reference wallet

Integration Test Game

29 scenarios against your live callbacks — signature, idempotency, tombstones, insufficient funds, batch atomicity. → Testing