在 WarmUp Chain 上开发

链参数

测试网 · 开发者预览。链上状态可能重置，暂不提供稳定性承诺。

添加到钱包

一键把 WarmUp Chain 测试网加入 MetaMask 等 EVM 钱包。公开 RPC 是只读的：钱包能查看余额和交易，要发交易请在钱包里换成你的开发者 RPC。

网络名称	WarmUp Chain Testnet
链 ID	931931 十六进制 0xe385b
公开 RPC	https://rpc.warmupchain.com 只读；每个 IP 10 次/秒，批量 ≤ 20，eth_getLogs ≤ 5,000 块
开发者 RPC	https://rpc.warmupchain.com/<token> 可以发交易，另开放 debug_trace、trace_
区块浏览器	scan.warmupchain.com
浏览器 API	https://api.warmupchain.com/api/v2 兼容 Blockscout v2
合约注册表	api.warmupchain.com/registry/contracts.json 平台合约的名称、地址、版本、状态和 ABI
原生币	WGAS（只用于 gas，价格为 0）
出块	有交易时约 1 秒；空闲时 60 秒一个空块
gas	价格 0；区块 gas 上限 3,000 万；每个地址最多排队 64 笔
EVM	cancun；平台合约用 Solidity 0.8.36
稳定币	wUSD，6 位小数，与 BSC 金库里的 USDT 1:1 对应测试用 sbUSD：自助领取，每次 ≤ 10,000，每天 ≤ 50,000

申请开发者权限

读链不需要任何权限。要部署合约、发交易，需要三样东西：一个白名单地址、一个开发者 RPC token、一些测试币。

1在自己电脑上生成密钥。只把地址交给团队，私钥永远不要发给任何人。MetaMask 账户的地址也可以。
2联系 WarmUp 团队。团队会把你的地址加入发送者白名单（立即生效），发给你个人的 RPC token，需要的话再发一些测试 wUSD。
3用 sbUSD 免费测试。sbUSD 是链上的沙盒币，任何人都能自助领取和授权，不需要审核。测通之后，再提交审核、切换到 wUSD。

Foundry

cast wallet new
# Address:     0x…   ← 发给团队
# Private key: 0x…   ← 存进密码管理器或环境变量

不要提交密钥。RPC token 和私钥放在环境变量或不进版本库的 .env 里。

第一次调用

不需要任何权限，现在就能试：

curl

curl -s https://rpc.warmupchain.com \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

viem

import { defineChain, createPublicClient, http } from 'viem';

export const warmup = defineChain({
  id: 931931,
  name: 'WarmUp Chain Testnet',
  nativeCurrency: { name: 'WarmUp Gas', symbol: 'WGAS', decimals: 18 },
  rpcUrls: { default: { http: ['https://rpc.warmupchain.com'] } },
  blockExplorers: { default: { name: 'WarmUp Scan', url: 'https://scan.warmupchain.com' } },
});

const client = createPublicClient({ chain: warmup, transport: http() });
console.log(await client.getBlockNumber());

拿到 token 后，把 RPC 换成 https://rpc.warmupchain.com/$WARMUP_RPC_TOKEN，或者保持地址不变、用 Authorization: Bearer 请求头带上 token。

两种写法

两种写法跑在同一条链上，用同一个 wUSD。从别的 EVM 链迁过来的游戏，通常选模式 A。

	模式 A · 标准 EVM	模式 B · 签名 + 中继
谁发交易	平台用玩家的托管密钥代签代发	中继提交玩家的 EIP-712 签名
资金怎么动	`approve` + `transferFrom`，每个游戏有授权上限	绑定在签名上的扣款
移植已有 EVM 游戏	改动小，通常只换随机数	改动大，每个入口都要处理签名
适合	大多数游戏	需要第三方中继，或每笔扣款都要玩家签名

随机数推荐用 drand：继承平台提供的 DrandRandom 库，下注截止时就确定用哪一轮，任何人都能提交那一轮的签名开奖，签名由链上的 DrandEvmnet 合约验证。不要用区块哈希做随机数。详见公平性。

注意事项

发传统交易，gas 价格 0：Foundry 用 --legacy --with-gas-price 0，cast 用 --gas-price 0。部分工具默认要求小费大于 0。
对时间敏感的调用要指定 gas limit：链空闲时 60 秒才出一个块，eth_call 和 gas 预估用的是最新区块的时间戳，可能滞后约 60 秒。drand 开奖这类调用请直接带 --gas-limit，跳过预估。
合约不能超过 24 KB（EIP-170）。
新合约一分钟内被浏览器识别：平台合约进注册表后，浏览器会显示名称、版本并解码调用。
上线要审核：用 sbUSD 测通后，提交合约地址、源码、测试和部署脚本。审计通过后由一人标记“通过”、另一人点“上线”。