开发者文档

五分钟上手

点开下面任意一项，都是已经在跑的实服务，不是占位。

网络参数

复制下面的参数，或直接用「一键添加网络」的 JSON。

{
  "chainId": "0x3016",
  "chainName": "XUL Testnet",
  "rpcUrls": ["https://scan.xulchain.com/rpc"],
  "nativeCurrency": { "name": "XUL", "symbol": "XUL", "decimals": 18 },
  "blockExplorerUrls": ["https://scan.xulchain.com"]
}复制

# 链 ID（应返回 0x3016）
curl -s -X POST https://scan.xulchain.com/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

# 最新区块号
curl -s -X POST https://scan.xulchain.com/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'复制

把上面两条贴进终端，看到 0x3016 和一个不断增长的区块号，说明你已连上 XUL 测试网。

账户抽象（AA）合约

ERC-4337 范式合约已部署在测试网 12310，可在浏览器直接查看。

创作确权（Creation）

把一段文字 / 图片 / 视频确权为链上资产：AI 生成 → IPFS 主权存储 → 链上登记 → Paymaster 赞助实现零 Gas 确权。

import { JsonRpcProvider, Wallet } from "ethers";

// 1) 连接 XUL 测试网
const provider = new JsonRpcProvider("https://scan.xulchain.com/rpc");
const net = await provider.getNetwork();
console.log("chainId =", net.chainId); // 12310n

// 2) 用私钥构造钱包（仅本地签名，勿在前端暴露私钥）
const wallet = new Wallet("0xYOUR_PRIVATE_KEY", provider);

// 3) 查询余额（领完水龙头后应有测试 XUL）
const bal = await provider.getBalance(wallet.address);
console.log("balance =", ethers.formatEther(bal), "XUL");

// 4) 发一笔测试转账
const tx = await wallet.sendTransaction({
  to: "0xRecipientAddress",
  value: ethers.parseEther("0.01"),
});
console.log("tx sent:", tx.hash);
console.log("explorer:", "https://scan.xulchain.com/tx/" + tx.hash);复制

AI 网关

XUL 自带 AI 网关，已为官网 AI 对话、生图、SaaS 控制台供能。

curl -s https://xulchain.com/xul-ai-api/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $XUL_API_KEY" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role":"user","content":"用一句话介绍 XUL Chain"}],
    "stream": false
  }'复制

API Key 向注册开发者发放；未授权调用会被网关拒绝。鉴权支持 X-API-Key 或 Authorization: Bearer 两种头。模型以标准对话协议兼容的模型别名调用，可用模型清单见开发者控制台。生图 / 视频 endpoint 同构（前缀 /xul-ai-api/），详见控制台文档。

核心资源