Ledger API Connectivity to the CSP

Table of Contents

Getting started

To get started with Ledger API connectivity it is necessary to install the DAML Software Development Kit (SDK).

The following documentation provides further reading with regards to Ledger API connectivity and the DAML SDK:

The ASX recommends using a robust Java IDE (Integrated Development Environment) such as IntelliJ IDEA.

Additional development language support will be made available in the DAML SDK in the future.

Developers should review the following sections in the DAML SDK documentation and work through examples as indicated below:

The gRPC API need not be invoked directly.

In this section, SDK 100.13.38 was used to create the code fragments.

What's needed / provided?

The following steps provide a summary of how to use the Ledger API to interact directly with CSP:

  1. Open a channel and connect to the ASX CSP Ledger
  2. Download the DAML package containing the template for the participant’s Master Contract
  3. Subscribe to the Transaction Service to receive transactions (which contain Events - the results of Commands)
    • Receive the Master Contract creation event on the Transaction Service stream
  4. Send commands to exercise choices on the Master Contract, using the Command Submission Service
    • Command Completions can be observed on the Command Completion Service
    • Resulting events (e.g. contract creations/ archivals) can be received on the Transaction Service stream

For further information on these steps, please refer to the below example documentation regarding building a Ledger API connectivity application.

Please note, in the sections containing sample code:

This sample code is provided for illustrative purposes only on an “as is” basis. This code has not been thoroughly tested under all conditions. ASX limited (ABN 98 008 624 691) and its related bodies corporate (“ASX”) make no representation or warranty with respect to the accuracy, reliability, function or completeness of the sample code. To the extent permitted by law, ASX and its employees, officers and contractors shall not be liable for any loss or damage arising in any way (including by way of negligence) from or in connection with any use of this sample code.

© 2020 ASX Limited ABN 98 008 624 691



Related Pages:

There are no related labels.

Browse Popular Pages:

No labels match these criteria.



This document provides general information only. ASX Limited (ABN 98 008 624 691) and its related bodies corporate (“ASX”) makes no representation or warranty with respect to the accuracy, reliability or completeness of the information. To the extent permitted by law, ASX and its employees, officers and contractors shall not be liable for any loss or damage arising in any way (including by way of negligence) from or in connection with any information provided or omitted or from anyone acting or refraining to act in reliance on this information.

© 2022 ASX Limited ABN 98 008 624 691


The following macros are not currently supported in the footer:
  • style