Integrating Roblox Games with SUBTC Protocol — A Step-by-Step Study

The **SUBTC Protocol** allows Roblox developers to integrate Bitcoin payments and rewards into their games securely, using a middleware layer. This ensures no direct access to the blockchain from Roblox, keeping all transactions safe and deterministic.

Base API: https://subtc.net/api

---

## 🕹️ Integration Architecture

[Roblox Game / Players] | | 1️⃣ Request Payment or Data (HTTPService) v [Middleware Server / API Layer] |
| 2️⃣ Verify Requests & Signatures v [SUBTC Protocol API / Wallets] | | 3️⃣ Manage Wallets & Send/Receive BTC v [Blockchain / Testnet / Mainnet]

---

## 1. Roblox Game Layer

- Player triggers an event (buy item, claim reward, earn points)
- Uses **HTTPService** to send request to the Middleware Server
- Example: purchase in-game currency with BTC

---

## 2. Middleware Server

- Acts as a **security layer** between Roblox and SUBTC
- Verifies request signatures and authenticity
- Calls SUBTC API endpoints:
- `wallet_create`
- `wallet_receive`
- `wallet_send`
- `wallet_wait_event`

- Returns transaction status to the Roblox game

---

## 3. SUBTC Protocol API

- Manages user wallets securely
- Handles Bitcoin network fees and confirmations
- Provides deterministic responses for automated game logic
- Testnet and Mainnet support

Example:

curl -sS -X POST "https://api.subtc.net/v1/btc?mode=wallet_receive" \
-H "X-SUBTC-KEY: $KEY" \
-H "Content-Type: application/json" \
-d '{"wallet_id":"<wallet_id>"}'

---

4. Blockchain Layer

Testnet for development, Mainnet for production

Transactions are logged and confirmed on Bitcoin network

Middleware returns success/failure to Roblox

---

💡 Key Notes

1. Roblox cannot access blockchain directly

2. Middleware is mandatory for security and transaction integrity

3. Optional: WebSocket between Middleware and Roblox for real-time balance updates

4. Use Docker for Middleware isolation

5. Store SUBTC-KEY in .env files, not in game code

---

5. Use Cases in Roblox

In-game purchases with BTC

Rewards or prizes for competitive events

Player-to-player transactions in a secure environment

Automated payout bots integrated with AI agents

---

6. Recommended Stack

Middleware: Go, Python, Node.js

Real-time updates: WebSocket or HTTP polling

Wallet management via SUBTC API only

Daily transfer to cold storage for security

---

Conclusion

Integrating Roblox + SUBTC Protocol allows:

Secure in-game BTC transactions

Automation and AI integration

Testnet support for development

Deterministic wallet and payment handling

Roblox developers gain a flexible Bitcoin payment infrastructure while keeping players and game logic isolated from the blockchain.