D-ASA is a full tokenization framework for ACTUS-compliant debt instruments, issued and executed on the Algorand Virtual Machine.

ACTUS Contract -> AVM Normalization -> ABI Upload -> AVM Execution

The canonical generated artifacts are:

• src/d_asa/artifacts/DASA.arc56.json: D-ASA AppSpec, generates clients and can be used on Lora App Lab;

• src/d_asa/artifacts/dasa_client.py: D-ASA client, expanded by the SDK;

• src/d_asa/artifacts/dasa_avm_client.py: D-ASA AVM client, for on-chain App-2-App calls.

Documentation: https://cusma.github.io/d-asa/

High-level client docs: docs/sdk/overview.md

Interactive notebook examples: examples/README.md

The fastest way to showcase D-ASA is with host AlgoKit for Algorand LocalNet and Docker for the showcase runtime.

• Install AlgoKit
• Install Docker

git clone git@github.com:cusma/d-asa.git
cd d-asa
./d-asa run

What ./d-asa run does:

• builds the local demo image
• starts host AlgoKit LocalNet if it is not already running
• waits for the LocalNet services required by the showcase
• runs the PAM fixed coupon and zero coupon showcase walkthroughs
• leaves LocalNet running so the Lora transaction links remain explorable

When you are finished inspecting the links:

algokit localnet stop

Open the published docs with:

./d-asa docs

Notes:

• targets macOS and Linux
• requires both Docker and AlgoKit on the host
• the demo joins the LocalNet Docker network when available, which keeps the showcase on direct container-to-container networking

The D-ASA project is developed with AlgoKit and Poetry.

Bootstrap the development environment:

make install-dev

Verify your environment:

make doctor

See the available contributor commands:

make help

Start your Algorand LocalNet:

make localnet

Run the default test suite:

make test

Build smart contracts:

make build

Run the showcase tests directly:

make showcase

Serve docs locally with live reload:

make docs-serve

The easiest way to explore the notebooks is using Docker (no local Python dependencies needed):

./d-asa jupyter

Or via make:

make jupyter-docker

This will:

• Build the Docker image with Jupyter Lab included
• Start AlgoKit LocalNet if needed
• Launch Jupyter Lab at http://localhost:8888
• Automatically configure LocalNet connectivity

The notebooks will have full access to the D-ASA framework and LocalNet.

Press Ctrl+C to stop.

If you prefer running Jupyter locally, first install the optional notebook dependencies:

poetry install --with notebooks

Then start Jupyter Lab:

poetry run jupyter lab examples/

Contributor setup and workflow guidance live in CONTRIBUTING.md.