Admin ERC-3643 Register Identity

post/api/v2/{coin}/admin/erc3643/registerIdentity

Register one or all wallet identities with an ERC-3643 IdentityRegistry contract. Pass walletId="all" or walletId="*" to process every wallet that has both identityAddress and baseAddress set. Wallets already registered are skipped. The signing key must hold the RegistryAgent role on the IdentityRegistry.

Path Parameters

  • coinstringRequired
    The coin type (e.g. thbarevm, hbarevm)
    Example: thbarevm

Request Body

walletId string required
Wallet ID or "all" / "*" to process every wallet on this coin
keyId string required
KMS key ID used to sign the on-chain transaction
identityRegistryAddress string required
The IdentityRegistry contract address (EVM, checksummed or lowercase)
investorCountry number required
ISO 3166-1 numeric country code for the investor (uint16, 0–65535)

200 Response

txHashes array[string] required
Transaction hashes for successfully submitted registerIdentity transactions
identitiesProcessed number required
Number of identities that were processed
failures array[object] required
Wallets that failed to process
walletId string required
The wallet ID that failed
error string required
Error message describing the failure
skipped array[object] required
Wallets intentionally skipped because identity was already registered on-chain
walletId string required
The wallet ID that was skipped
reason string required
Reason the wallet was skipped (e.g. already registered on-chain)

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

500 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id