WINChainWINChain
开发者文档

在 WINChain 上构建

连接网络、查询链上数据、部署合约，并使用 WinScan 检查每笔交易。

连接网络API 参考

verify-chain.sh

shell

curl https://rpc.winchain.win \
  -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

响应

{"jsonrpc":"2.0","id":1,"result":"0x523d0b4"}

网络配置

使用下列参数连接 WINChain。测试合约和交易时，请先选择测试网并从水龙头领取测试币。

主网

WIN Mainnet

浏览器
Chain ID
862332680x523d0b4
原生代币
WIN / 18 decimals
RPC URL
https://rpc.winchain.win

测试网

WIN-TEST

浏览器
Chain ID
862332670x523d0b3
原生代币
WIN / 18 decimals
RPC URL
https://testnet-rpc.winchain.win
领取测试币

添加到钱包

支持 EIP-1193 的钱包可通过 wallet_addEthereumChain 添加网络。用户仍需在钱包中确认。

WIN Mainnet / wallet.ts

typescript

await window.ethereum.request({
  method: "wallet_addEthereumChain",
  params: [{
    chainId: "0x523d0b4",
    chainName: "WIN Mainnet",
    nativeCurrency: {
      name: "WIN",
      symbol: "WIN",
      decimals: 18,
    },
    rpcUrls: ["https://rpc.winchain.win"],
    blockExplorerUrls: ["https://winscan.co"],
  }],
})

JSON-RPC

通过标准 JSON-RPC 2.0 请求读取链上状态、调用合约并广播已签名交易。

链节点 RPC 用于钱包、ethers 和 viem。WinScan API 用于查询浏览器已经索引的数据，两者用途不同。

网络与区块

eth_chainId

读取当前 Chain ID

eth_blockNumber

读取最新区块高度

账户与合约

eth_getBalance

查询账户 WIN 余额

eth_call

只读调用合约

交易生命周期

eth_sendRawTransaction

广播已签名交易

eth_getTransactionReceipt

查询交易回执

latest-block.sh

shell

curl https://rpc.winchain.win \
  -H 'content-type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "method":"eth_blockNumber",
    "params":[],
    "id":1
  }'

方法参数与返回值遵循 Ethereum JSON-RPC 规范。 查看规范

浏览器 API

使用 WinScan 获取已索引的区块、交易、账户、代币与合约数据。完整参数和 schema 以交互式文档为准。

基础地址

主网
https://winscan.co/api/v2
测试网
https://testnet.winscan.co/api/v2
打开完整 REST 文档

winscan-stats.sh

shell

curl https://winscan.co/api/v2/stats

常用 REST 端点

链与交易

  • GET/stats
  • GET/blocks
  • GET/transactions
  • GET/transactions/{transaction_hash}

账户与资产

  • GET/addresses/{address_hash}
  • GET/addresses/{address_hash}/transactions
  • GET/addresses/{address_hash}/token-balances
  • GET/tokens

合约

  • GET/smart-contracts
  • GET/smart-contracts/{address_hash}

分页响应包含 next_page_params 时，将其中字段原样带入下一次请求，直到该字段不再返回。

REST API

区块、交易、地址、代币和合约数据。

/api/v2

ETH RPC API

WinScan 提供的 Ethereum 格式查询方法。

POST /api/eth-rpc

兼容 RPC API

面向 Etherscan API 迁移场景的 GET 与 POST 接口。

/api?module=...&action=...

GraphQL API

在 GraphiQL 中探索 schema 并按需查询字段。

POST /api/v1/graphql

合约开发

使用熟悉的 Solidity、Hardhat、Foundry 和 ethers 工具链。先在测试网部署，再通过 WinScan 检查交易与合约。

先验证，再上主网

等待交易回执并检查 status，再把部署地址写入应用配置。

保护签名密钥

私钥只从本地环境或密钥管理器读取，不要提交到仓库或发送到浏览器 API。

查看 WINChain GitHub

hardhat.config.ts

typescript

import type { HardhatUserConfig } from "hardhat/config"

const config: HardhatUserConfig = {
  solidity: "0.8.24",
  networks: {
    winchain: {
      url: process.env.WINCHAIN_RPC_URL ??
        "https://rpc.winchain.win",
      chainId: 86233268,
      accounts: process.env.DEPLOYER_PRIVATE_KEY
        ? [process.env.DEPLOYER_PRIVATE_KEY]
        : [],
    },
  },
}

export default config