group-approve-verifier

CLI tool to verify Group Approve configurations against token pair data for Wanchain Bridge cross-chain registration.

Install

npm install -g group-approve-verifier

Usage

# Verify group approve against token pair
group-approve-verifier <groupApprove.json> <tokenPair.json>

# Show help
group-approve-verifier --help

# Output as JSON
group-approve-verifier <groupApprove.json> <tokenPair.json> --json

# Only show failures
group-approve-verifier <groupApprove.json> <tokenPair.json> --quiet

Development

# Install dependencies
bun install

# Run directly from source
bun run src/cli.ts <groupApprove.json> <tokenPair.json>

# Build
bun run build

Validation Checks

The tool performs 4 checks for each Group Approve entry:

| # | Check | Description | |---|-------|-------------| | 1 | Address | Validates proposal address matches expected GroupApprove contract | | 2 | Chain ID | Validates BIP44 chain ID maps to a known chain | | 3 | Proposal ID | Checks format, range (< taskCount), and not already executed on-chain | | 4 | Proposal Data | Matches on-chain proposal data against token pair params[2] |

Additionally validates that the total count of Group Approve entries matches Token Pair entries.

Input Formats

groupApprove.json:

{
  "tag": "Group Approve",
  "data": "[{\"chainID\":\"2147483708\",\"chainName\":\"ETH\",\"address\":\"0x...\",\"proposalID\":\"0\"}]"
}

tokenPair.json:

[
  {
    "abi": {},
    "params": ["bip44ChainId", "tokenManagerAddress", "encodedCalldata"],
    "chain": "ETH"
  }
]

Supported Chains

ETH, BSC, WAN, TRX, BASE, ARB, OPT, AVAX, MATIC, FTM, LINEAETH, MATICETH, ZKETH, BLASTETH, OPBNB, CELO, ZEN, PLYR, XDC, MOVR, GLMR, DIONE, NRG, SGB, FX, OKT, METIS, VC, GMELD, TLOS, OKB, BROCK, WATER, CLV, ASTR, WORLDETH, UNIETH, SEI, 0G, S