Daml Finance supports the modeling of financial and non-financial use cases in Daml. It provides a standard way to represent assets on Daml ledgers and defines common behaviours and rules. There are two main benefits to using the library in your application:
Implementing basic financial concepts like ownership or economic terms of an asset is a complex and tedious task. By providing common building blocks, Daml Finance increases delivery velocity and shortens the time-to-market when building Daml applications. The rich set of functionality of Daml Finance is at your disposal so you don’t have to reinvent the wheel.
Building your application on Daml Finance makes it compatible with other platforms in the wider ecosystem. By using a shared library assets become “mobile”, allowing them to be used seamlessly across application boundaries without the need for translation or integration layers. For instance, a Daml Finance-based asset that is originated in a bond issuance application can be used in the context of a secondary market trading application that is also built on Daml Finance.
Daml Finance optimizes for the following aspects:
The library is designed to have a low barrier to entry. Users familiar with Daml can get started quickly and leverage the provided functionality easily.
Building with Daml Finance decouples your application code from the underlying representation of assets. This allows the application to evolve without the need to migrate assets from one version to another, and makes maintenance easier.
Various extension points allow customization and extension of the library as required. If an existing implementation does not fulfill the requirements it is straightforward to provide a custom extension.
The library covers the following areas:
- Holdings: modeling of ownership structures, custodial relationships, intermediated securities, and accounts
- Instruments: structuring the economic terms of an asset and the events that govern its evolution
- Settlement: executing complex transactions involving multiple parties and assets
- Lifecycling: governing the evolution of financial instruments over their lifetime
Daml Finance comes with broad asset and workflow capabilities to allow for a variety of use cases to be modeled:
- Simple tokens: digital representation of traditional assets
- Central bank digital currency: retail or wholesale distribution models
- Standard asset classes: equities with corporate actions, bonds with flexible cash flow modeling
- Derivatives: time- and path-dependent derivatives with optionality
- Synchronized lifecycling: atomic, intermediated lifecycling and settlement of cash flows across investors and custodians
- Cross-entity issuance: atomic, multi-party issuance across investors, issuer, risk book, and treasury
- Asset-agnostic trading facility: generic delivery-vs-payment and immediate, guaranteed settlement
- Exotic asset types: non-fungible and non-transferable assets
Exploring the Library¶
If you want to review the Daml Finance codebase in more detail you can clone the repository locally on your machine. This allows you to navigate the code, including both the template definitions and the tests. In particular the tests are useful to show how the library works and how the different components interact with each other. If you need to view the code for a specific package release, you can check out the corresponding tag.
As a pre-requisite, the Daml SDK needs to be installed on your machine.
In order to download the repository, open a terminal and run:
git clone email@example.com:digital-asset/daml-finance.git
This creates a new folder
daml-finance containing the Daml Finance source code. Navigate to the
folder and run:
This downloads all required packages and builds the project. You can then run:
to open the code editor and inspect the code.
In addition to Daml Finance, there is also a separate Demo Application, showcasing several of the library’s capabilities in a web-based graphical user interface.
If you are interested in trying out the app locally, you can clone the corresponding repo and follow the installation instructions on the Daml Finance Demo App GitHub page.