npmpackage.info

Gathering detailed insights and metrics for @daml/react

Other packages similar to @daml/react

@daml/hub-react

1.1.5

Daml React functions for Daml Hub

@damlakoksal/feedbackly-react

0.1.3

Gathering detailed insights and metrics for @daml/react

@daml/react - 2.10.1 | npmpackage.info

@daml/react

The Daml smart contract language

2.10.1

817

Apache-2.0

Scala

133.54 kB

6.4

Installations

npm install @daml/react

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

18.12.1

NPM Version

8.19.2 Score

72.3

Supply Chain

97.6

Quality

Maintenance

100

Vulnerability

99.3

License

Pull Requests

Open

79

Total

17,903

Closed

2,605

Merged

15,219

Issues

Open

563

Total

3,609

Closed

3,046

Releases

521

3.4.0-snapshot.20250710.0

v3.4.0-snapshot.20250710.0

Updated on Jul 10, 2025

3.4.0-snapshot.20250709.0

v3.4.0-snapshot.20250709.0

Updated on Jul 09, 2025

3.4.0-snapshot.20250702.0

v3.4.0-snapshot.20250702.0

Updated on Jul 02, 2025

3.4.0-snapshot.20250625.0

v3.4.0-snapshot.20250625.0

Updated on Jun 25, 2025

3.4.0-snapshot.20250618.0

v3.4.0-snapshot.20250618.0

Updated on Jun 18, 2025

2.10.1

v2.10.1

Updated on Jun 02, 2025

View All 521 releases

Languages

Scala

Haskell

Starlark

Java

Shell

TypeScript

Python

Nix

TeX

PLpgSQL

PowerShell

C++

Smarty

Makefile

JavaScript

Batchfile

Dockerfile

HTML

NASL

Groovy

CSS

sed

Scala (80.6%)

Haskell (12.69%)

Starlark (2.33%)

Java (2.04%)

Shell (0.73%)

TypeScript (0.66%)

Python (0.41%)

Nix (0.12%)

TeX (0.11%)

PLpgSQL (0.09%)

PowerShell (0.07%)

C++ (0.03%)

Smarty (0.02%)

Makefile (0.01%)

JavaScript (0.01%)

Batchfile (0.01%)

Go (0.01%)

jq (0.01%)

Dockerfile (0.01%)

HTML (0.01%)

NASL (0.01%)

Developer

digital-asset

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

Apache-2.0 License

817 Stars

14,001 Commits

214 Forks

31 Watchers

386 Branches

222 Contributors

Updated on Jul 11, 2025

Maintainers

View All 222 Contributors

Package Meta Information

Latest Version

2.10.1

Package Id

@daml/react@2.10.1

Unpacked Size

133.54 kB

Size

23.24 kB

File Count

NPM Version

8.19.2

Node Version

18.12.1

Published on

May 30, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

@daml/react

React framework for Daml applications

Documentation

Comprehensive documentation for @daml/react can be found here.

Usage

The best way to get you started quickly is to use the create-daml-app template:

daml new --template=create-daml-app my-project-name

and to read the Quickstart Guide.

To get an overview on how to build a Daml application, please read the application architecture overview.

To use @daml/react your application needs to be connected to the JSON API of a Daml ledger. If your JSON API server for the ledger runs on the local host on port 7575, set

1"proxy": "http://localhost:7575"

in your package.json and wrap your main component in the DamlLedger component of @daml/react

1import DamlLedger from @daml/react
2
3const App: React.FC = () => {
4     <DamlLedger
5      token: <your authentication token>
6      httpBaseUrl?: <optional http base url>
7      wsBaseUrl?: <optional websocket base url>
8      reconnectThreshold?: <optional delay in ms>
9      party: <the logged in party>
10    >
11      <MainScreen />
12    </DamlLedger>
13};

Now you can use the following React hooks to interact with a Daml ledger:

`useParty`

useParty returns the party, for which commands are currently send to the ledger.

1const party = useParty();

`useLedger`

useLedger returns an instance of the Ledger class of @daml/ledger to interact with the Daml ledger.

1const ledger = useLedger();
2const newContract = await ledger.create(ContractTemplate, arguments);
3const archiveEvent = await Ledger.archive(ContractTemplate, contractId);
4const [choiceReturnValue, events] = await ledger.exercise(ContractChoice, contractId, choiceArguments);

`useQuery`

useQuery returns the contracts matching a given query. The query matches for a given contract template and specified field values of the contracts of that template.

1const {contracts, loading} = useQuery(ContractTemplate, () => {field: value}, [dependency1,
2dependency2, ...]);

If the query is omitted, all visible contracts of the given template are returned.

1const {contracts, loading} = useQuery(ContractTemplate);

`useReload`

useReload returns a function to reload the results of queries.

1const reload = useReload();
2const onClick = reload;

`useStreamQuery`

Deprecated: prefer useStreamQueries

useStreamQuery has the same signature as useQuery, but it constantly refreshes the results.

1const {contracts, loading} = useStreamQuery(ContractTemplate, () => {field: value}, [dependency1,
2dependency2, ...]);

If the query is omitted, all visible contracts of the given template are returned.

1const {contracts, loading} = useStreamQuery(ContractTemplate);

`useStreamQueries`

useStreamQueries is similar to useQuery, except that:

It constantly refreshes the results.
The factory function is expected to return a list of queries, and the resulting set of contracts is the union of all the contracts that match at least one query.
Like useQuery, if no factory function is provided, or if the provided function returns an empty array, the set will contain all contracts of that template.

1const {contracts, loading} = useStreamQueries(ContractTemplate,
2                                              () => [{field: value}, ...],
3                                              [dependency1, dependency2, ...]);

You can additionally pass in an extra function to handle WebSocket connection failures.

`useFetchByKey`

useFetchByKey returns the unique contract of a given template and a given contract key.

1const {contract, loading} = useFetchByKey(ContractTemplate, () => key, [dependency1, dependency2, ...]);

`useStreamFetchByKey`

Deprecated: prefer useStreamFetchByKeys

useStreamFetchByKey has the same signature as useFetchByKey, but it constantly keeps refreshing the result.

1const {contract, loading} = useStreamFetchByKey(ContractTemplate, () => key, [dependency1, dependency2, ...]);

`useStreamFetchByKeys`

useStreamFetchByKeys takes a template and a factory that returns a list of keys, and returns a list of contracts that correspond to those keys (or null if no contract matches the corresponding key). This hook will keep an open WebSocket connection and listen for any change to the corresponding contracts.

If the factory function returns an empty array, the hook will similarly produce an empty array of contracts.

1const {contracts, loading} = useStreamFetchByKeys(ContractTemplate,
2                                                  () => [key1, key2, ...],
3                                                  [dependency1, dependency2, ...]);

You can additionally pass in an extra function to handle WebSocket connection failures.

Advanced Usage

In order to interact as multiple parties or to connect to several ledgers, one needs to create an extra DamlLedger contexts specific to your requirement.

`createLedgerContext`

createLedgerContext returns another DamlLedger context and associated hooks (useParty, useLedger ... etc) that will look up their connection within that returned context.

Source

https://github.com/digital-asset/daml.

License

Apache-2.0

No vulnerabilities found.

10

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

10

Maintained

Determines if the project is "actively maintained".

10

Security-Policy

Determines if the project has published a security policy.

10

License

Determines if the project has defined a license.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Fuzzing

Determines if the project uses fuzzing.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

8

Signed-Releases

Determines if the project cryptographically signs release artifacts.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

SAST

Determines if the project uses static code analysis.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

6.4

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @daml/react

Other packages similar to @daml/react

@daml/react

Installations

Developer Guide

Yes

CommonJS

18.12.1

8.19.2

Score

Pull Requests

79

17,903

2,605

15,219

Issues

563

3,609

3,046

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

@daml/react

Documentation

Usage

useParty

useLedger

useQuery

useReload

useStreamQuery

useStreamQueries

useFetchByKey

useStreamFetchByKey

useStreamFetchByKeys

Advanced Usage

createLedgerContext

Source

License

10

10

10

10

10

10

10

8

0

0

0

0

0

6.4

/10

`useParty`

`useLedger`

`useQuery`

`useReload`

`useStreamQuery`

`useStreamQueries`

`useFetchByKey`

`useStreamFetchByKey`

`useStreamFetchByKeys`

`createLedgerContext`