Setting up a Chainalysis Know Your Transaction (KYT) integration

Chainalysis Know Your Transaction (KYT) integration

With the Know Your Transactions (KYT) integration powered by Chainalysis, organizations can now streamline crypto monitoring and investigations directly within the Persona platform. Crypto transfers can be registered in Chainalysis, and alerts triggered in Chainalysis can automatically generate Cases in Persona.

This is useful for organizations who are looking to reduce tool switching and centralize their anti-money laundering (AML) workflows. By streamlining the end-to-end process within a single platform, teams can work more efficiently, reduce context switching, and accelerate investigations.

Chainalysis integrations available within Persona include the Address Screening Report and Know Your Transaction (KYT)-related workflow action steps. KYT-related workflow steps include:

  • Register Transfer – Registers a cryptocurrency transfer in Chainalysis system to begin compliance monitoring
  • Get Transfer Summary – Retrieves details of a registered transfer
  • Get All Alerts – Retrieves all alerts information within your organization. By default, only transfer alerts will be returned
  • Update An Alert’s Status – Updates the status of a specific alert and optionally adds a comment

Use of these steps require proper set up of Chainalysis credentials within the Persona marketplace. For directions on how to do this and all Chainalysis integrations with Persona, review the Chainalysis integration overview.

Know Your Transaction (KYT)

⚠️ A common use case is to use a combination of these Chainalysis KYT-related Workflow action steps alongside the rest of the features available on the Persona platform to create a solution that monitors for high risk transfers from high risk identities. Transfers, as you may refer to them as, are modeled or mapped into Persona as Transactions. This article describes how to construct a basic KYT solution within Persona.

Chainalysis Know Your Transaction (KYT) example Case template

Example Case view focused on transaction monitoring

How to register a Transfer

Note: These steps require use of Transactions and a Workflow triggered on Transaction Created.Transactions can be generated via API or created through a CSV Import.

Transaction Type

  1. Create a new transaction type (Note: an apt name may be Virtual Transactions) with the following schema:

Chainalysis KYT-related Transaction Type schema - Note: While your schema can include other fields, these are the fields that are required to register a transaction within Chainalysis

Workflow

  1. Create a workflow with the following steps:
    1. Trigger workflow is Transaction created (filtered by the transaction type you just created)
    2. Add the Register a Transfer in Chainalysis workflow step
    3. Map the transaction fields to the required Chainalysis fields for:
      • User ID
      • Asset
      • Network
      • Direction
      • Transfer Reference

Chainalysis KYT-related Workflow example: Register a Transfer 2. Add a 10 second Wait Step 3. Add a step to Get a Transfer Summary from Chainalysis. Pass in the External ID created in the previous step register_a_transfer_in_chainalysis.externalID Get a Transfer Summary Workflows step

How to configure ongoing transaction monitoring

Note: These steps require the use of a similar Transaction Type outlined above in How to register a Transfer, a Case Template with a specific field schema, and a Workflow with a Recurring trigger.

Case Template

  1. Create a Case Template with the following minimum fields using the Cases Field Editor:

Minimum required fields for Chainalysis KYT-related Case Template

Workflow

  1. Set up an Recurring trigger for a Workflow:
    • Schedule: Every Day
    • Start Time: Choose a time that makes sense
    • Object Type: Transaction
    • Filter Criteria
      • transaction_type (the transaction type you just created)
      • id (pick a transaction ID. Note: this is important otherwise you’ll create a workflow run for every single transaction of the type you just created)

Recurring Workflow Trigger Example 2. Add an Evaluate code step - Add a custom code that calculates the current time - X hours so that it fetches all the transactions created in the last X hours Example Workflow with Evaluate Code Step 3. Add a Get All Alerts step - Action: Get all alerts in Chainalysis - Integration Credentials: Make sure your Chainalysis instance's specific API credentials are selected here Get All Alerts Chainalysis workflow step 4. Add a Loop step - Loop type: for each - Loop through list: get_all_alerts.data - Loop Mode: Sequential Loop step configuration in Workflows 5. Add a Create Case step within the loop - Map the alert fields to the fields on the Case Template Example of Chainalysis KYT-related Create Case step

Related articles