Trust

Table

Description: Defines a Trust as a legal entity. It contains the core, verifiable components of a trust's identity required for Know Your Trust (KYT) compliance checks. Fields essential for verification are noted but are not strictly mandatory for creating the record.

note

The protobuf file is the authoritative source of documentation. Please refer to the Protobuf tab when in doubt about field definitions, validation rules, or type specifications.

Field	Type	Description	Required	Validation
registered_name	string	The official, registered name of the trust as it appears in its prospectus or formation documents. Required for verification.	No	Length max: 255 characters
registration_number	string	The unique registration or identification number assigned by a regulatory body or authority. Examples: SEC CIK number, LEI (Legal Entity Identifier). Required for verification.	No	Length max: 100 characters
tax_identifier	string	The primary tax identifier for the trust. Example: TIN in the US.	No	Length max: 50 characters
country_of_domicile	string	The ISO 3166-1 alpha-2 country code where the trust is domiciled (e.g., "KY" for Cayman Islands, "LU" for Luxembourg). The value must be the uppercase, two-letter code. See: https://www.iso.org/iso-3166-country-codes.html Required for verification.	No	country_of_domicile must be empty or a valid ISO 3166-1 alpha-2 country code
date_of_inception	Date	The date on which the trust was established or began operations (inception date). Required for verification.	Yes	None

Protobuf

syntax = "proto3";

package meshtrade.compliance.client.v1;

import "buf/validate/validate.proto";
import "google/type/date.proto";

option go_package = "github.com/meshtrade/api/go/compliance/client/v1;client_v1";
option java_package = "co.meshtrade.api.compliance.client.v1";

/*
   Defines a Trust as a legal entity. It contains the core, verifiable components of a trust's
   identity required for Know Your Trust (KYT) compliance checks.
   Fields essential for verification are noted but are not strictly mandatory for creating the record.
*/
message Trust {
  /*
     The official, registered name of the trust as it appears in its prospectus or formation documents.
     Required for verification.
  */
  string registered_name = 1 [(buf.validate.field) = {
    string: {
      max_len: 255
    }
  }];

  /*
     The unique registration or identification number assigned by a regulatory body or authority.
     Examples: SEC CIK number, LEI (Legal Entity Identifier).
     Required for verification.
  */
  string registration_number = 2 [(buf.validate.field) = {
    string: {
      max_len: 100
    }
  }];

  /*
     The primary tax identifier for the trust.
     Example: TIN in the US.
  */
  string tax_identifier = 3 [(buf.validate.field) = {
    string: {
      max_len: 50
    }
  }];

  /*
     The ISO 3166-1 alpha-2 country code where the trust is domiciled (e.g., "KY" for Cayman Islands, "LU" for Luxembourg).
     The value must be the uppercase, two-letter code.
     See: https://www.iso.org/iso-3166-country-codes.html
     Required for verification.
  */
  string country_of_domicile = 4 [(buf.validate.field) = {
    cel: {
      id: "country_code.format.optional",
      message: "country_of_domicile must be empty or a valid ISO 3166-1 alpha-2 country code",
      expression: "size(this) == 0 || this.matches('^[A-Z]{2}$')"
    }
  }];

  /*
     The date on which the trust was established or began operations (inception date).
     Required for verification.
  */
  google.type.Date date_of_inception = 5;
}