Trusset Protocol - Infrastructure for Asset Tokenization

POST

customers

api

identity

revoke

curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_your_key_here" \
  -d '{ "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD" }'

const url = 'https://api.trusset.org/customers/api/identity/revoke';
const headers = {
  'Content-Type': 'application/json',
  'X-API-Key': 'trusset_your_key_here'
};
const walletAddress = '0xaBc123DEf456789012345678901234567890aBCD';

const res = await fetch(url, { method: 'POST', headers, body: JSON.stringify({ walletAddress }) });
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

await fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify({ walletAddress, txHash: tx.hash })
});

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xEf244c4Bd4d71Bd9A30EDF6Edef7CCC72642291a",
      "data": "0x0ebddd17..."
    },
    "functionName": "revokeIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "registerKind": "TRUSSET",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "register": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
    "registerKind": "TREX",
    "signerAddress": "0x51A4F0c3B2e8d7A6c5B4e3f2A1d0c9b8e7f6A5D4",
    "action": "SIGN_TRANSACTION",
    "stepType": "revoke",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "transaction": {
      "to": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
      "data": "0xa8d29d1d..."
    },
    "functionName": "deleteIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "status": "revoked",
    "txHash": "0x2404b4cd06b02a65d7bc0fe19be869fa7237e5b73bb807564254ab045045420f",
    "gasUsed": "42150"
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:05:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "NOT_REGISTERED",
    "message": "0xaBc123DEf456789012345678901234567890aBCD holds no identity on the register 0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9, so there is nothing to revoke."
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

Revokes a wallet’s identity on the register your instance writes to, and marks the customer record revoked. Use it when a customer fails ongoing compliance checks or their verification must be invalidated.

On an ERC-3643 register, revoking deletes the wallet’s entry from the register and nothing else. The ONCHAINID and its KYC claim stay as they are. To invalidate the claim as well, call Revoke Claim first. Once the entry is deleted, the claim can no longer be found through the wallet.

Both registers answer with one transaction. What it does depends on registerKind:

`registerKind`	Transaction	Effect	Who sends it
`TRUSSET`	`revokeIdentity` on the register	The identity stays on the register and reads as `revoked`	A wallet with `REGISTER_OPERATOR_ROLE`
`TREX`	`deleteIdentity` on the register	The wallet’s entry is removed from the register	An agent of the register

Call it once without txHash to get the calldata, and again with txHash once the transaction is mined. The record is updated on the second call.

Body Parameters

string

required

The wallet to revoke. Checksummed or lowercase.

string

ERC-3643 only. Returned as signerAddress, in place of your primary wallet. The API does not check it.

string

The hash of the mined transaction. Send it to confirm the revocation and update the record. Omit it to receive the calldata.

Response Fields

object

Show Calldata leg

string

SIGN_TRANSACTION.

object

{ to, data }, where to is the register.

string

revokeIdentity on a Trusset register, deleteIdentity on an ERC-3643 register.

string

What the transaction does.

string

TRUSSET or TREX.

string

The wallet, checksummed.

string

ERC-3643 only. The register address.

string

ERC-3643 only. Your primary wallet, or the signerAddress you sent. It is not checked to be an agent.

string

ERC-3643 only. Always revoke.

object

{ endpoint: "POST /customers/api/identity/revoke", field: "txHash" }.

Show Confirm leg

string

The wallet, checksummed.

string

Always revoked.

string

The confirmed transaction.

string

Gas used.

Before the calldata

On a Trusset register, the API refuses with REGISTER_OPERATOR_ROLE_MISSING when it can read that none of your instance’s wallets holds the role. Grant it with Grant on-chain roles on the wallet page of the issuer app (see Customers). On the Trusset ID Register, which every instance without a register of its own shares, it refuses with IDENTITY_HELD_BY_ANOTHER_ISSUER when the identity was registered by a wallet that is not one of your instance’s, and with CHAIN_UNAVAILABLE when the register cannot be read to tell. A wallet with no active identity there is refused with 409 IDENTITY_NOT_REGISTERED, because revoking it would revert on chain. On an ERC-3643 register, it refuses with REGISTRY_AGENT_MISSING when none of your instance’s wallets is an agent. It refuses with NOT_REGISTERED when the wallet is not on the register.

Confirm

The confirm leg checks that the transaction is mined, succeeded, and calls revokeIdentity or deleteIdentity on the register for the wallet you named. A receipt for a different wallet is refused with TX_TARGET_MISMATCH, and nothing changes. On the Trusset ID Register the transaction must be signed by a verified wallet of your instance, or the confirm is refused with UNAUTHORIZED_SIGNER. The revocation is recorded once in your instance’s verification history as a REVOKE entry with the transaction and its signer. It then sets the customer record for that wallet to revoked with revokedAt, archived or not. When no record exists, nothing is written and the call still succeeds. Revoking on your instance register does not take the wallet off an eligibility register. The confirm queues that removal, with reason REVOKED, from every eligibility register the wallet is on, and cancels its admissions still waiting. Until your wallet signs the removal, lending markets and vaults that read the eligibility register still admit the wallet. See Eligibility registers.

curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_your_key_here" \
  -d '{ "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD" }'

const url = 'https://api.trusset.org/customers/api/identity/revoke';
const headers = {
  'Content-Type': 'application/json',
  'X-API-Key': 'trusset_your_key_here'
};
const walletAddress = '0xaBc123DEf456789012345678901234567890aBCD';

const res = await fetch(url, { method: 'POST', headers, body: JSON.stringify({ walletAddress }) });
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

await fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify({ walletAddress, txHash: tx.hash })
});

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xEf244c4Bd4d71Bd9A30EDF6Edef7CCC72642291a",
      "data": "0x0ebddd17..."
    },
    "functionName": "revokeIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "registerKind": "TRUSSET",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "register": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
    "registerKind": "TREX",
    "signerAddress": "0x51A4F0c3B2e8d7A6c5B4e3f2A1d0c9b8e7f6A5D4",
    "action": "SIGN_TRANSACTION",
    "stepType": "revoke",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "transaction": {
      "to": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
      "data": "0xa8d29d1d..."
    },
    "functionName": "deleteIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "status": "revoked",
    "txHash": "0x2404b4cd06b02a65d7bc0fe19be869fa7237e5b73bb807564254ab045045420f",
    "gasUsed": "42150"
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:05:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "NOT_REGISTERED",
    "message": "0xaBc123DEf456789012345678901234567890aBCD holds no identity on the register 0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9, so there is nothing to revoke."
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`INVALID_ADDRESS`	`400`	`walletAddress` is missing or not a valid address
`REGISTER_OPERATOR_ROLE_MISSING`	`403`	Trusset register: none of your instance’s wallets holds `REGISTER_OPERATOR_ROLE`
`IDENTITY_HELD_BY_ANOTHER_ISSUER`	`403`	Trusset ID Register: the identity was registered by a wallet that is not one of your instance’s
`IDENTITY_NOT_REGISTERED`	`409`	Trusset ID Register: the wallet holds no active identity, so there is nothing to revoke. Calldata leg only
`UNAUTHORIZED_SIGNER`	`403`	Trusset ID Register, confirm leg: the transaction was not signed by a verified wallet of your instance
`REGISTRY_AGENT_MISSING`	`403`	ERC-3643: none of your instance’s wallets is an agent of the register
`NOT_REGISTERED`	`409`	ERC-3643: the wallet is not on the register
`OWN_REGISTRY_NOT_CONFIGURED`	`409`	The instance is bound to its own register but no valid register address is set
`REGISTRY_PROBE_FAILED`	`503`	Your own register could not be read to tell its kind
`INVALID_TX`	`400`	`txHash` is not 32-byte hex
`TX_NOT_FOUND`	`404`	The transaction is not mined yet
`TX_REVERTED`	`400`	The transaction reverted
`TX_WRONG_TARGET`	`400`	The transaction does not write to the register
`TX_WRONG_FUNCTION`	`400`	The transaction does not call `revokeIdentity` or `deleteIdentity`
`TX_TARGET_MISMATCH`	`400`	The transaction revokes a different wallet
`CHAIN_UNAVAILABLE`	`503`	ERC-3643: the transaction could not be read. Trusset ID Register: the identity could not be read to check who registered it. Retry
`REVOKE_FAILED`	`400`, `500`	Any other failure. `400` when a chain call failed

curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_your_key_here" \
  -d '{ "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD" }'

const url = 'https://api.trusset.org/customers/api/identity/revoke';
const headers = {
  'Content-Type': 'application/json',
  'X-API-Key': 'trusset_your_key_here'
};
const walletAddress = '0xaBc123DEf456789012345678901234567890aBCD';

const res = await fetch(url, { method: 'POST', headers, body: JSON.stringify({ walletAddress }) });
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

await fetch(url, {
  method: 'POST',
  headers,
  body: JSON.stringify({ walletAddress, txHash: tx.hash })
});

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xEf244c4Bd4d71Bd9A30EDF6Edef7CCC72642291a",
      "data": "0x0ebddd17..."
    },
    "functionName": "revokeIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "registerKind": "TRUSSET",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "register": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
    "registerKind": "TREX",
    "signerAddress": "0x51A4F0c3B2e8d7A6c5B4e3f2A1d0c9b8e7f6A5D4",
    "action": "SIGN_TRANSACTION",
    "stepType": "revoke",
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "transaction": {
      "to": "0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9",
      "data": "0xa8d29d1d..."
    },
    "functionName": "deleteIdentity",
    "description": "Revoke 0xaBc123DEf456789012345678901234567890aBCD on the identity registry",
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/revoke",
      "field": "txHash"
    }
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
    "status": "revoked",
    "txHash": "0x2404b4cd06b02a65d7bc0fe19be869fa7237e5b73bb807564254ab045045420f",
    "gasUsed": "42150"
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:05:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "NOT_REGISTERED",
    "message": "0xaBc123DEf456789012345678901234567890aBCD holds no identity on the register 0x4C2b1a0f9E8d7c6B5a4938271605F4e3D2c1B0A9, so there is nothing to revoke."
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T12:00:00.000Z"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Operators

Asset Register

Vaults

Seller Financing

Revoke Identity

Body Parameters

Response Fields

Before the calldata

Confirm

Error Codes

​Body Parameters

​Response Fields

​Before the calldata

​Confirm

​Error Codes

Body Parameters

Response Fields

Before the calldata

Confirm

Error Codes