Trusset Protocol - Infrastructure for Asset Tokenization

POST

customers

api

identity

pending

confirm

curl -X POST "https://api.trusset.org/customers/api/identity/pending/confirm" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["cmg1u7k3p0004l80h2f9s6d1x", "cmg1u9q2m0007l80hc4t8z3wa"],
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "claimTxResults": [
      { "id": "cmg1u7k3p0004l80h2f9s6d1x", "txHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c" }
    ]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/pending/confirm',
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ ids: plan.ids, txHash, claimTxResults })
  }
);
const { data } = await response.json();

for (const row of data.results) {
  if (row.status !== 'CONFIRMED') console.warn(`${row.walletAddress} stays queued: ${row.status}`);
  if (row.investorTypeMismatch) console.warn(`${row.walletAddress} holds a different investor type`);
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 1,
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
        "claimTxHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c"
      },
      {
        "id": "cmg1u9q2m0007l80hc4t8z3wa",
        "walletAddress": "0xff21b8ac28bb6a20c1c0160af42303d2946b99ea",
        "status": "NOT_REGISTERED_ON_CHAIN",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 0,
    "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "registerKind": "TREX",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
        "claimTxHash": "0x58f3da36dfb88fb3d18ccf45fe13ffa7dd0d7370f08247af16999a339125c6c1",
        "onchainId": "0x8986b6a837ccA6c6F6e257526296f07b9fe3fA9f"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "TX_ENTRIES_MISMATCH",
    "message": "Transaction does not cover 1 of the selected wallets"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

Checks the transactions your wallets broadcast for a set of queued rows, then closes every row whose wallet the register now reports as verified. A confirmed row marks its customer verified, and creates the customer record when there is none.

On a Trusset register, Build Pending Registration puts a wallet that already holds an active identity into its own updateIdentity step, so the queued hash, investor type and expiries replace what the register held. Send each of those as updateTxResults. The batch still skips a row whose expiry has passed and any entry it runs out of gas for.A batch built before a wallet’s identity became active can still skip it. Such a wallet that the register reports as verified confirms anyway: its row closes, the register keeps the hash, investor type and expiries it held, and the customer record takes that hash. investorTypeMismatch flags a different investor type, but nothing in the response flags a different hash or expiry. Build the row again instead, so it is renewed.Any other skipped row comes back NOT_REGISTERED_ON_CHAIN and stays queued. A row skipped for gas, or one whose identity has since become active, can be built again. A row whose own expiry has passed is skipped again every time, and a frozen wallet stays NOT_REGISTERED_ON_CHAIN until it is unfrozen.To put a skipped approval on the register, use Verify Identity with the row’s kycHash. It verifies the wallet or updates the identity it already holds, and closes the row if it is still queued.

Body Parameters

array

required

1 to 200 row ids, normally ids from the build. Only rows still PENDING on your instance are checked, and any other id is dropped without an error.

string

The registering transaction. On a Trusset register it is the batch, or a verifyIdentity or updateIdentity call, and it is required unless every row is confirmed through updateTxResults. On an ERC-3643 register it is the registerIdentity or batchRegisterIdentity step. Omit it there when every wallet was already registered.

array

Trusset register only. The renewal steps you broadcast, as [{ id, txHash }] with the row id each updateIdentity step carried. Each must be a mined, successful updateIdentity for the row’s wallet, carrying the row’s queued kycHash, signed by a verified wallet registered to your instance, or the whole call fails with TX_ENTRIES_MISMATCH or UNAUTHORIZED_SIGNER. A confirmed renewal also writes the row’s investor type name to the customer record, and its history entry carries operation: update.

array

The claim steps you broadcast, as [{ id, txHash }] with the row id each step carried. Entries are kept per id, so for a row with two claim steps only the last entry sent is checked. A claim that fails its check is left out of the record and fails nothing else.

What the confirm checks

Check	Trusset register	ERC-3643 register
`txHash`	Required. A mined, successful `batchVerifyIdentities`, `verifyIdentity` or `updateIdentity` call to your register	Optional. A mined, successful `registerIdentity`, `batchRegisterIdentity`, `updateCountry` or `updateIdentity` call to your register. Without it, `claimTxResults` is required
Signer of `txHash`	On the Trusset ID Register, a verified wallet registered to your instance, or the call fails with `UNAUTHORIZED_SIGNER`. On your own register it is logged, not enforced	Logged, not enforced
Coverage	Every selected wallet must be named by `txHash` or renewed by its entry in `updateTxResults`, or the call fails with `TX_ENTRIES_MISMATCH`	Not checked
`claimTxResults`	Read only for rows with a `residencyClaim`. Recorded when the receipt is an `addClaim` on your register for the row’s wallet, carrying the queued residency hash	Recorded when the receipt is an `addClaim` on the wallet’s ONCHAINID
A row confirms when	The transaction verified or updated the wallet, or the register reports it verified	The register’s `isVerified` answers `true` for the wallet, whatever transactions put it there

A failed check of txHash refuses the whole call before any row changes. The per-row outcome comes back in results, and one row’s outcome does not affect another’s.

What a confirmed row changes

The row turns CONFIRMED, with the transaction, its signer and the time.
The customer record with this wallet becomes verified, with the kycHash the register holds and the transaction. Without a record, one is created from the row’s metadata. On an ERC-3643 register the record also gets metadata.onchainId.
The customer audit log gets ON_CHAIN_VERIFIED, with the queued and the registered hash.
A hosted verification checkout behind the row turns VERIFIED, and stock escrow deposits waiting on its ID link are bound to the wallet.
When the row carries notifyEmail, the customer is emailed that verification is complete.
When the verification profile the row was queued under has an eligibility register, the wallet’s admission to it is queued for your wallet to sign. See Eligibility registers.

The customer write is best effort. A failure there is logged, and the row still confirms. A row that does not confirm stays PENDING, and its error says why. Build and confirm it again once the cause is fixed. A repeat call for rows that all confirmed answers NOT_FOUND, because none of them is PENDING any more.

The HTTP status is 200 and success is true even when no row confirmed. Read confirmed and each entry of results.

Response Fields

object

Show child attributes

integer

Rows that confirmed.

integer

Rows that did not, for either reason in results.

string

The checked txHash, or null on an ERC-3643 register when none was sent.

string

The wallet that signed it, or null.

string

TREX on an ERC-3643 register. Absent on a Trusset register.

array

One entry per row checked. See below.

array

Show child attributes

string

The row.

string

Its wallet, lowercased.

string

CONFIRMED; NOT_REGISTERED_ON_CHAIN when the register does not report the wallet as verified; CHAIN_READ_UNAVAILABLE when the register could not be read, which says nothing about the wallet. Both of the latter leave the row queued.

string

The transaction recorded for the row. On an ERC-3643 register without txHash, its claim transaction.

string

The claim transaction that passed its check, or null. CONFIRMED only.

boolean

Trusset register only, present and true when the register holds a different investor type than the row queued. The row still confirms.

string

ERC-3643 register only. The wallet’s ONCHAINID. CONFIRMED only.

curl -X POST "https://api.trusset.org/customers/api/identity/pending/confirm" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["cmg1u7k3p0004l80h2f9s6d1x", "cmg1u9q2m0007l80hc4t8z3wa"],
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "claimTxResults": [
      { "id": "cmg1u7k3p0004l80h2f9s6d1x", "txHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c" }
    ]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/pending/confirm',
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ ids: plan.ids, txHash, claimTxResults })
  }
);
const { data } = await response.json();

for (const row of data.results) {
  if (row.status !== 'CONFIRMED') console.warn(`${row.walletAddress} stays queued: ${row.status}`);
  if (row.investorTypeMismatch) console.warn(`${row.walletAddress} holds a different investor type`);
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 1,
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
        "claimTxHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c"
      },
      {
        "id": "cmg1u9q2m0007l80hc4t8z3wa",
        "walletAddress": "0xff21b8ac28bb6a20c1c0160af42303d2946b99ea",
        "status": "NOT_REGISTERED_ON_CHAIN",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 0,
    "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "registerKind": "TREX",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
        "claimTxHash": "0x58f3da36dfb88fb3d18ccf45fe13ffa7dd0d7370f08247af16999a339125c6c1",
        "onchainId": "0x8986b6a837ccA6c6F6e257526296f07b9fe3fA9f"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "TX_ENTRIES_MISMATCH",
    "message": "Transaction does not cover 1 of the selected wallets"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	`ids` is not an array of 1 to 200 ids, on a Trusset register neither `txHash` nor `updateTxResults` was sent, or on an ERC-3643 register neither `txHash` nor `claimTxResults` was sent
`INVALID_TX`	`400`	`txHash` is not a 32-byte hex hash
`TX_REVERTED`	`400`	The transaction reverted
`TX_WRONG_TARGET`	`400`	Trusset register: the transaction was not sent to your register. ERC-3643 register: it created a contract
`TX_WRONG_FUNCTION`	`400`	The transaction calls a function this confirm does not accept
`TX_TARGET_MISMATCH`	`400`	ERC-3643 register: `txHash` is a claim transaction. Send it in `claimTxResults`
`TX_ENTRIES_MISMATCH`	`400`	Trusset register: the transactions do not cover every selected wallet, or a renewal renews a different wallet or carries a different hash than its row queued
`UNAUTHORIZED_SIGNER`	`403`	Trusset ID Register: the transaction was not signed by a verified wallet registered to your instance. The rows stay queued. Register that wallet, then confirm the same `txHash` again
`NOT_FOUND`	`404`	None of the `ids` is a `PENDING` row of your instance, or the instance no longer exists
`TX_NOT_FOUND`	`404`	The transaction is not mined yet, or does not exist
`OWN_REGISTRY_NOT_CONFIGURED`	`409`	Your instance is set to its own register but holds no valid register address
`CHAIN_UNAVAILABLE`	`503`	ERC-3643 register: the transaction could not be read. Retry shortly
`REGISTRY_PROBE_FAILED`	`503`	The register could not be read to tell its interface. Retry shortly
`PENDING_CONFIRM_FAILED`	`400`	A chain read failed, including a transaction that could not be read on a Trusset register
`PENDING_CONFIRM_FAILED`	`500`	Any other failure

curl -X POST "https://api.trusset.org/customers/api/identity/pending/confirm" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["cmg1u7k3p0004l80h2f9s6d1x", "cmg1u9q2m0007l80hc4t8z3wa"],
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "claimTxResults": [
      { "id": "cmg1u7k3p0004l80h2f9s6d1x", "txHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c" }
    ]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/identity/pending/confirm',
  {
    method: 'POST',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ ids: plan.ids, txHash, claimTxResults })
  }
);
const { data } = await response.json();

for (const row of data.results) {
  if (row.status !== 'CONFIRMED') console.warn(`${row.walletAddress} stays queued: ${row.status}`);
  if (row.investorTypeMismatch) console.warn(`${row.walletAddress} holds a different investor type`);
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 1,
    "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35",
        "claimTxHash": "0x717b88a4537d14a797577ce70e9dd36c90652b2c487997de02dcfa5bd7a5466c"
      },
      {
        "id": "cmg1u9q2m0007l80hc4t8z3wa",
        "walletAddress": "0xff21b8ac28bb6a20c1c0160af42303d2946b99ea",
        "status": "NOT_REGISTERED_ON_CHAIN",
        "txHash": "0x22eacbdb9dfefdd4633fe2b22760dce1cc62179d409eecdcdc541c9dfd52df35"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": true,
  "data": {
    "confirmed": 1,
    "notRegistered": 0,
    "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
    "signedBy": "0xCD92134767aEC2562be15d2a2062A082dA17dD84",
    "registerKind": "TREX",
    "results": [
      {
        "id": "cmg1u7k3p0004l80h2f9s6d1x",
        "walletAddress": "0x96c5822784130360f904372b83e130be4a1894d6",
        "status": "CONFIRMED",
        "txHash": "0x33972a14e4b0dc60dffb07f253c189f6135bf06a16cc2b978f482ba339d6b915",
        "claimTxHash": "0x58f3da36dfb88fb3d18ccf45fe13ffa7dd0d7370f08247af16999a339125c6c1",
        "onchainId": "0x8986b6a837ccA6c6F6e257526296f07b9fe3fA9f"
      }
    ]
  },
  "error": null,
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "TX_ENTRIES_MISMATCH",
    "message": "Transaction does not cover 1 of the selected wallets"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-09-30T10:00:00.000Z"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Operators

Asset Register

Vaults

Confirm Pending Registration

Body Parameters

What the confirm checks

What a confirmed row changes

Response Fields

Error Codes

​Body Parameters

​What the confirm checks

​What a confirmed row changes

​Response Fields

​Error Codes

Body Parameters

What the confirm checks

What a confirmed row changes

Response Fields

Error Codes