Reads a mined removal transaction from the chain and records every wallet it took off an eligibility register. Build Removal returns one transaction per wallet, so confirm each hash on its own once it is mined.
What the confirm reads
The transaction must be mined, successful, and sent to the eligibility register of one of your profiles. Every wallet the register’s IdentityRemoved logs in the receipt name is then checked live on the register:
A wallet no longer on the register, with an admission recorded here, is recorded REMOVED, with the transaction, its sender as signedBy and the block time as removedAt. Its removalReason stays as queued, or MANUAL when none was.
A wallet registered again since is reported with a note and not recorded.
A wallet removed on chain that no admission was recorded for is reported with a note.
The sender is not checked against your wallets. Sending the same hash again changes nothing and answers alreadyRecorded: true for each wallet.
In the CLAIM mode
A removal there revokes the wallet’s profile claim on the claim issuer, so its transaction carries no IdentityRemoved log. When the receipt has none, the confirm reads the revokeClaimByDigest calls in the transaction instead, sent directly or through a smart-account wallet. A call on the claim issuer of a CLAIM mode profile whose digest is the profile claim of a wallet with an admission of that profile names that wallet. The wallet is then checked live with the register’s isVerified: one that no longer reads as verified is recorded REMOVED as above.
Body Parameters
string
required
One removal transaction, 0x followed by 64 hex characters.
Response Fields
object
Show child attributes
string
The transaction, lowercased.
string
The eligibility register it called, checksummed.
object
{ key, name, entityType, professionalOnly, requirementsHash } of the profile bound to the register.
string
The wallet that sent the transaction, checksummed.
integer
The block it was mined in.
array
One entry per wallet the logs name.
Show child attributes
string
The wallet, checksummed.
string
REMOVED when recorded now. Otherwise the admission’s status as it stands, or null when there is none.
string
The admission recorded. Present with REMOVED.
boolean
Present and true when this transaction was already recorded for the wallet.
string
Present when the wallet is on the register again, or when no admission was recorded for it.
The transaction did not call the eligibility register of one of your profiles
TX_REMOVED_NOBODY
400
The receipt carries no IdentityRemoved log from the register, and the transaction revokes no profile claim of a wallet with an admission of a CLAIM mode profile
INSTANCE_NOT_FOUND
404
The instance behind your key is archived or no longer exists
TX_NOT_FOUND
404
No transaction with this hash on your instance’s network
TX_PENDING
409
The transaction is not mined yet. Confirm again once it is
ELIGIBILITY_NETWORK_UNSUPPORTED
409
Your instance is not on Ethereum
RATE_LIMIT_EXCEEDED
429
Your instance went over its budget of 120 eligibility requests per minute
CONFIRM_REMOVAL_FAILED
500
The result could not be recorded
CHAIN_UNAVAILABLE
503
The transaction or the register could not be read in time. Retry shortly: a wallet recorded before the failure answers alreadyRecorded