自定义Cosmos链前端MsgDelegate签名验证失败问题求助

核心错误拆解 #

报错signature verification failed; please verify account number (72), sequence (52) and chain-id (layertest-4): unauthorized的本质是链端对交易签名的合法性校验不通过，重点从交易元数据一致性、消息结构合规性、链配置兼容性三个方向排查。

具体排查步骤 #

• 强制同步账户最新元数据
  不要依赖本地缓存的account number和sequence，每次发起交易前直接调用链的auth/accounts/{address}接口拉取最新数据，确保这两个参数和链上状态完全一致。自定义链可能存在缓存同步延迟，手动拉取是最稳妥的方式。

• 校验MsgDelegate的完整结构
  标准Cosmos质押模块的MsgDelegate必须包含所有必填字段，示例结构如下：

  {
    "type": "cosmos.staking.v1beta1.MsgDelegate",
    "value": {
      "delegator_address": "自定义链前缀1xxxxxx",
      "validator_address": "自定义链验证人前缀1xxxxxx",
      "amount": {
        "denom": "链上原生最小单位denom",
        "amount": "1000000"
      }
    }
  }
  

  重点检查：denom是否匹配链上配置、验证人地址是否为验证人操作地址（而非普通账户地址）、金额是否使用链上最小单位。

• 排查experimentalSuggestChain的链配置细节
  确保链配置参数和链端完全匹配：

  • chainId：必须和genesis.json中的chain_id完全一致，注意大小写、连字符位置
  • bech32Config：尤其是bech32PrefixAccAddr、bech32PrefixValAddr，自定义链若修改前缀，此处必须同步更新
  • coinType：默认是118，自定义链若修改BIP44路径，需同步调整
  • rpc/rest：确保指向已同步完成的全节点，避免使用未同步节点

• 用CLI发起交易做对比验证
  使用自定义链的二进制客户端直接发起质押交易：

  customd tx staking delegate 验证人地址 1000000denom --from 委托账户地址 --chain-id layertest-4 --node http://你的RPC节点:26657
  

  如果CLI能成功，说明问题出在前端签名流程；如果CLI也失败，需排查链端配置（比如质押模块未启用、验证人处于非活跃状态等）。

• 检查链端质押模块配置
  查看链genesis.json中app_state.staking的配置：

  • 确认params.unbonding_time、params.max_validators等参数正常
  • 检查目标验证人状态，是否处于BOND_STATUS_BONDED，未被拉黑或jailed
  • 确认链端未对cosmos.staking.v1beta1.MsgDelegate添加额外权限校验

• 对比自定义消息与标准消息的签名流程差异
  既然自定义消息Amino签名能成功，逐步骤对比两者的签名流程：

  • 检查Amino注册：确认标准MsgDelegate的Amino类型已注册到链的Amino codec中，自定义链若修改codec可能遗漏标准模块的注册
  • 对比signDoc结构：确保chain_id、account_number、sequence、fee、memo等字段完全一致，尤其是fee的denom和金额是否符合链的要求

内容的提问来源于stack exchange，提问作者Rayn