https://github.com/trisacrypto/trisa

Travel Rule Information Sharing Architecture for Virtual Asset Service Providers
https://github.com/trisacrypto/trisa

compliance protocol rpc travelrule

Last synced: 20 days ago
JSON representation

Travel Rule Information Sharing Architecture for Virtual Asset Service Providers

• Host: GitHub
• URL: https://github.com/trisacrypto/trisa
• Owner: trisacrypto
• License: mit
• Created: 2019-08-29T01:03:22.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-07-15T20:47:18.000Z (9 months ago)
• Last Synced: 2025-08-15T14:59:23.054Z (8 months ago)
• Topics: compliance, protocol, rpc, travelrule
• Language: Go
• Homepage: https://trisa.dev
• Size: 18.5 MB
• Stars: 47
• Watchers: 12
• Forks: 30
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# Travel Rule Information Sharing Architecture (TRISA) for Virtual Asset Service Providers

[![Go Reference](https://pkg.go.dev/badge/github.com/trisacrypto/trisa/pkg.svg)](https://pkg.go.dev/github.com/trisacrypto/trisa/pkg)

[![Go Report Card](https://goreportcard.com/badge/github.com/trisacrypto/trisa)](https://goreportcard.com/report/github.com/trisacrypto/trisa)

Please visit the [TRISA website](https://travelrule.io) for more information and the [TRISA documentation](https://testnet.directory) for developer docs and integration.

# Contributing to TRISA

Looking to contribute to the TRISA open source project?

If you're a developer whose organization is using (or planning to adopt) the TRISA protocol, this section is for you!

## Navigating the Repository

This repository contains a gRPC implementation of the TRISA protocol as described by the [white paper](https://travelrule.io/trisa-whitepaper/), which leverages [protocol buffers](https://grpc.io/) and Golang.

The `proto` folder contains the core RPC definitions, including:

 - the interVASP Messaging Standard (IVMS) message definitions, which serve as the basis for how two VASP peers should mutually describe entities involved in cryptographic transfers, including names, locations, and government identifiers. This is the spec that will allow originators to identify themselves to beneficiaries and to request information from those beneficiaries to meet the legal requirements of their regulators.

 - the TRISA Network's service definitions, essentially how the different parts of the API work — from the exchange of keys (to ensure both peers have the requisite details to exchange information) to the transfer of "secure envelopes" (cryptographically sealed protocol buffer messages that can only be decrypted by the intended recipient). The `trisa` subfolder also contains generic message types for transactions that are intended to provide maximum flexibility for a wide range of TRISA use cases.

The `pkg` folder contains the reference implementation code, including compiled code generated from the protocol buffer definitions in the `proto` folder[^1].

 - The `iso3166` folder contains language codes.

 - The `ivms101` folder extends the generated protobuf code with JSON loading utilities, validation helpers, short constants, etc.

 - The `trisa` folder contains structs and methods for a range of TRISA-related tasks, such as performing cryptography and making mTLS connections.

 The `lib` folder is intended to showcase utility code similar to that in the `pkg` folder, but for languages other than Go. If you work in a language other than go, this would be a great place to start your contribution!

[^1]: Note that these compiled files are compiled for Golang; but this is certainly not the only option. Those interested in building implementation code in a different language should look to the `lib` folder, which currently contains placeholder folders but is intended to showcase such other implementations (including compiled protocol buffer code for these other languages).

## The Global Directory Service

Another integral part of the TRISA protocol is the Global Directory Service, which serves as a look-up tool for TRISA members to identify peers with which they wish to exchange information. For RPC definitions and implementation code related to the Global Directory Service, visit the companion [directory repository](https://github.com/trisacrypto/directory). To learn more about how to become a member of the directory, visit [trisa.directory](https://trisa.directory/).

## Translations

Translations of the documentation on trisa.dev are done periodically by human translators, and may become out-of-sync with the English text or reflect errors. If you notice an error, please open a [bug report](https://github.com/trisacrypto/trisa/issues/new) to notify us.