Trusset Protocol - Infrastructure for Asset Tokenization

POST

customers

api

identity

add-claim

curl -X POST "https://api.trusset.org/customers/api/identity/add-claim" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataInput": "screened-2026-09-06-clear",
    "expiryDays": 90
  }'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": { "to": "0xe9114c40934f6fb6bb317935156b731f7a86d006", "data": "0x..." },
    "functionName": "addClaim",
    "description": "Add SANCTIONS_CHECK claim for 0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataHash": "0x5c1980fe3b47a2091d6e8fc0453b71a29d84e6f5027cab3819740de6b25fa3c1",
    "expiry": 1796472000,
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/add-claim",
      "field": "txHash"
    }
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PROOF_REQUIRED",
    "message": "This claim type must be added from a KYC proof; use /claims/from-proof"
  }
}

Writes a claim to the registry from a hash you supply. It covers the four slots that are not backed by a proof.

KYC, ACCREDITATION, RESIDENCY and CITIZENSHIP are refused here with PROOF_REQUIRED. Those four slots are reserved so that a residency attestation always means a proof was verified, rather than something anyone with an API key could write. File them with Add Claims from Proof.

Body Parameters

string

required

The subject.

string | integer

required

One of AML, TAX_RESIDENCY, SANCTIONS_CHECK, PEP_CHECK, by name or index.

string

The claim’s payload as a 32-byte hex hash. What it commits to is your convention.

string

A string to derive the hash from instead. It is hashed together with the claim type and the wallet, so the same input under a different slot or subject gives a different hash.Supply this or dataHash.

integer

Days until the claim expires, between 0 and 36500. 0 or omitted means no expiry.

string

Send it to confirm. Omit it to receive the calldata.

Response Fields

object

Show child attributes

string

SIGN_TRANSACTION. Calldata leg only.

object

The unsigned registry call. Calldata leg only.

string

addClaim. Calldata leg only.

string

The subject, checksummed.

string

The slot, by name. On the confirm leg it is read back from the mined transaction, not echoed.

string

The hash written, lowercased.

integer

Unix seconds, or 0.

string

The confirmed transaction. Confirm leg only.

string

Gas used. Confirm leg only.

object

{ endpoint, field: "txHash" }. Calldata leg only.

The confirm leg reads the claim type, hash and expiry back out of the mined transaction rather than trusting what you sent, and refuses a receipt that targets a different wallet.

curl -X POST "https://api.trusset.org/customers/api/identity/add-claim" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataInput": "screened-2026-09-06-clear",
    "expiryDays": 90
  }'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": { "to": "0xe9114c40934f6fb6bb317935156b731f7a86d006", "data": "0x..." },
    "functionName": "addClaim",
    "description": "Add SANCTIONS_CHECK claim for 0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataHash": "0x5c1980fe3b47a2091d6e8fc0453b71a29d84e6f5027cab3819740de6b25fa3c1",
    "expiry": 1796472000,
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/add-claim",
      "field": "txHash"
    }
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PROOF_REQUIRED",
    "message": "This claim type must be added from a KYC proof; use /claims/from-proof"
  }
}

Error Codes

Code	HTTP	Cause
`INVALID_ADDRESS`	`400`	`walletAddress` is missing or malformed
`INVALID_CLAIM_TYPE`	`400`	`claimType` is not a slot between 0 and 7
`PROOF_REQUIRED`	`400`	One of the four reserved slots was named
`INVALID_HASH`	`400`	Neither a valid `dataHash` nor a non-empty `dataInput` was supplied
`INVALID_EXPIRY`	`400`	`expiryDays` is outside 0 to 36500
`TX_TARGET_MISMATCH`	`400`	The confirmed transaction targets a different wallet
`ADD_CLAIM_FAILED`	`400`	The claim could not be prepared or confirmed

curl -X POST "https://api.trusset.org/customers/api/identity/add-claim" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataInput": "screened-2026-09-06-clear",
    "expiryDays": 90
  }'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": { "to": "0xe9114c40934f6fb6bb317935156b731f7a86d006", "data": "0x..." },
    "functionName": "addClaim",
    "description": "Add SANCTIONS_CHECK claim for 0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "walletAddress": "0xAbCdEf0123456789AbCdEf0123456789AbCdEf01",
    "claimType": "SANCTIONS_CHECK",
    "dataHash": "0x5c1980fe3b47a2091d6e8fc0453b71a29d84e6f5027cab3819740de6b25fa3c1",
    "expiry": 1796472000,
    "confirmWith": {
      "endpoint": "POST /customers/api/identity/add-claim",
      "field": "txHash"
    }
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PROOF_REQUIRED",
    "message": "This claim type must be added from a KYC proof; use /claims/from-proof"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Add Claim

Body Parameters

Response Fields

Error Codes

​Body Parameters

​Response Fields

​Error Codes

Body Parameters

Response Fields

Error Codes