Registration

Register Validators

Command Structure

taiyi-cli register-validators [OPTIONS]

Options

OptionDescriptionEnvironment VariableDefault
--execution-rpc-urlEthereum RPC endpoint URLEXECUTION_RPC_URL-
--private-keyPrivate key in hex formatPRIVATE_KEY-
--taiyi-middleware-addressTaiyi EigenLayer Middleware contract addressTAIYI_MIDDLEWARE_ADDRESS-
--bls-private-keysComma-separated list of BLS private keysBLS_PRIVATE_KEY-
--operator-addressOperator addressOPERATOR_ADDRESS-
--collateralCollateral amount for registrationCOLLATERAL-

Example

taiyi-cli register-validators \
  --execution-rpc-url https://ethereum-holesky.publicnode.com \
  --private-key 0x123... \
  --taiyi-middleware-address 0x456... \
  --bls-private-keys 0x789...,0xabc... \
  --operator-address 0xdef... \
  --collateral 1000000000000000000

Register For Operator Sets

Command Structure

taiyi-cli register-for-operator-sets [OPTIONS]

Options

OptionDescriptionEnvironment VariableDefault
--execution-rpc-urlEthereum RPC endpoint URLEXECUTION_RPC_URL-
--private-keyPrivate key in hex formatPRIVATE_KEY-
--operator-bls-keyOperator BLS public keyOPERATOR_BLS_KEY-
--avs-addressAVS contract address--
--allocation-manager-addressAllocation Manager contract address--
--avs-directory-addressAVS Directory contract address--
--operator-set-idsComma-separated list of operator set IDs--
--socketOperator socket address--
--saltUnique salt value for registrationSALT-

Example

taiyi-cli register-for-operator-sets \
  --execution-rpc-url https://ethereum-holesky.publicnode.com \
  --private-key 0x123... \
  --operator-bls-key 0x456... \
  --avs-address 0x789... \
  --allocation-manager-address 0xabc... \
  --avs-directory-address 0xdef... \
  --operator-set-ids 1,2,3 \
  --socket "example.socket.addr:8080" \
  --salt 0xff...

Registration Process

  1. For Validator Registration:

    • Signs validator messages with provided BLS private keys
    • Registers validators with the Taiyi Middleware contract
    • Includes collateral payment as specified
  2. For Operator Set Registration:

    • Creates operator signature for BLS public key verification
    • Generates a registration digest hash and signs it
    • Registers the operator for the specified operator sets

Important Notes

  1. Private Key Security:

    • Never share your private keys
    • Preferably use environment variables for sensitive data
    • Ensure secure key management practices
  2. Transaction Costs:

    • Registration requires gas fees
    • Ensure sufficient ETH balance in operator account

Troubleshooting

Common issues and solutions:

  1. Transaction Failure:

    • Verify contract addresses are correct
    • Ensure sufficient ETH for gas
    • Check if operator is already registered
  2. Invalid Private Key:

    • Ensure private key is in correct hex format
    • Verify key has necessary permissions
  3. RPC Connection Issues:

    • Verify RPC URL is accessible
    • Try alternative RPC endpoints

For additional support, check the operator documentation or join our tg support channel.