Address & Asset Sharing

📘

In This Article

This article will cover the following.

• How to programmatically share an address or asset with a participant on the Taurus Network.

Prerequisites

• Completing this guide requires access to two PROTECT tenants that are both connected to the Taurus Network (TN).
• To complete this guide, you must be comfortable programmatically signing for approval. Please read the relevant SDK and Integration Guide for signing approvals.

Introduction

Before transferring funds, pledging, or initiating settlements, shared addresses must be established with the network participant. Once an address has been shared, the Taurus Network counterparty will see a whitelisted address request that they must sign. After it is signed, the participant will have a verified address to which they can send funds. In addition to visual cues in the GUI, shared addresses will include a tnParticipantID when querying address-related endpoints (such as list addresses, get an address, etc.).

Address Sharing Workflow

1. Share an address (participant)
2. Verify & Sign whitelisted asset request (counterparty)

Sharing an Address (Participant)

1. Identify the necessary parameters:
   1. the ID of the address you want to share.
   2. The Taurus Network (TN) participant ID. You can query participants with the List Participants endpoint.
   3. Optionally, any attributes you wish to override.
2. Call the Share an Address endpoint
3. A 200 response indicates that the request was created successfully. At this point, the counterparty will see a whitelisted address request with your participant ID listed, along with visual indications in the GUI that this is a Taurus Network request.

Verify & Sign (Counterparty)

❗️

Important: Verify Before Signing

It is extremely important to always confirm that the Taurus Network (TN) participant ID belongs to the expected counterparty before signing. An incorrect ID could result in assets being transferred to the wrong party and may lead to significant loss of funds.

Once signed, the address will display a Verified label in the PROTECT GUI and will be marked as a trusted address.

This flow is the same as signing any other whitelist address request.

1. Verify the address is from the expected counterparty.
2. Sign the Whitelisted Address (WLA) request. Taurus Network (TN) shared address requests are treated like any other request Whitelisted address request.