DApp 身份钱包静默登录

接入示例

nonce 仅接受 16～128 位字母数字，由 DApp 后端生成、保存并与当前登录会话绑定。调用前无需 eth_requestAccounts。

// nonce 由后端生成：随机、一次性，绑定当前登录会话。
const { nonce } = await fetch('/auth/challenge').then(r => r.json());
const proof = await window.ethereum.request({
  method: 'gpc_login',
  params: [{ nonce }],
});
// 也可使用：const proof = await window.gpc.login({ nonce });
await fetch('/auth/verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(proof),
});

旧客户端返回不支持方法时，可提示用户更新钱包；不要把返回的钱包地址直接视为登录成功。

返回凭证

消息按以下固定模板生成，各行使用 \n，结尾没有换行：

{origin 的 host，含非默认端口} wants you to sign in with your Ethereum account:
{address}

Sign in to this DApp with your GPC identity wallet. This request grants no transaction or asset permissions.

URI: {origin}
Version: 1
Chain ID: {chainId}
Nonce: {nonce}
Issued At: {issuedAt}
Expiration Time: {expirationTime}

服务端验证

1. 核对预期的 origin、网络，以及当前登录会话保存的 nonce。来源必须与自己的站点完全一致。
2. 校验签发时间和过期时间，凭证期限应为 5 分钟，拒绝已过期或异常未来时间。
3. 按上方模板重建消息，确认与 message 完全一致。
4. 使用 ethers.verifyMessage(message, signature) 恢复签名地址，与 address 比较。
5. 验证成功后原子消费 nonce，再签发业务登录会话，阻止凭证重放。

DApp 自行管理登录会话和退出。钱包不替 DApp 签发服务端令牌。不能仅凭地址建立登录，也不能只验签而忽略来源和 nonce。

权限与错误码

仅接受单个 { nonce } 参数。额外字段、任意消息、类型化数据和交易参数均拒绝。接口不会授予 eth_accounts 权限，也不会改变 window.ethereum.selectedAddress；身份地址可能与当前付款钱包不同。

资金连接、personal_sign、类型化签名和交易仍使用原有确认流程。DApp 应分别管理身份登录与付款钱包连接。