- Overview
- Setup
- Tutorials
- How Tos
- Reference
- DAR Versions
- API Reference
- Commercials API
- Credential API
- Registry API
- Utility.Registry
- Utility.Registry.V0.Configuration.AppReward
- Utility.Registry.V0.Configuration.Instrument
- Utility.Registry.V0.Holding.Allocation
- Utility.Registry.V0.Holding.Burn
- Utility.Registry.V0.Holding.Lock
- Utility.Registry.V0.Holding.Mint
- Utility.Registry.V0.Holding.Transfer
- Utility.Registry.V0.Holding.Unlock
- Utility.Registry.V0.Rule.Transfer
- Utility.Registry.V0.Types
- Utility.Registry.V0.Util
- Utility.Registry.App
- Utility.Holding
- Utility.Registry
- Settlement Utility API
- Collateral Utility API
- Operator Backend API
Utility Operator Backend API¶
The Utility Operator backend exposes a set of publicly accessible endpoints serving information essential to the fulfillment of the Utility Daml workflows.
It is used by the Utility UI to source reference information, such as the operator’s party identifier of the operator, as well as the set of available instruments.
It is used by wallets and third-party apps to source off-ledger information to advance token standard workflows (through the use of explicit contract disclosure).
Base URLs¶
Environment |
Base URL |
|---|---|
Devnet |
|
Testnet |
|
Mainnet |
Token Standard endpoints¶
The API specification for the Token Standard endpoints can be found in the Token Standard documentation.
The Utility allows multiple instrument admins to manage tokens through its Registry module. The Token Standard endpoints for each instrument admin are exposed under the following URL prefixes:
Environment |
Base Token Standard URL |
|---|---|
Devnet |
https://api.utilities.digitalasset-dev.com/api/token-standard/v0/registrars/<admin-party-id> |
Testnet |
https://api.utilities.digitalasset-staging.com/api/token-standard/v0/registrars/<admin-party-id> |
Mainnet |
https://api.utilities.digitalasset.com/api/token-standard/v0/registrars/<admin-party-id> |
where <admin-party-id> is the party identifier of the corresponding instrument admin.
For instance, the list of instruments administered by the Utility operator party on Mainnet can be retrieved from https://api.utilities.digitalasset.com/api/token-standard/v0/registrars/auth0_007c6643538f2eadd3e573dd05b9::12205bcc106efa0eaa7f18dc491e5c6f5fb9b0cc68dc110ae66f4ed6467475d7c78e/registry/metadata/v1/instruments.
Other API specifications¶
The OpenAPI specification for the Utility-specific operator backend is available at the following links:
Environment |
OpenAPI spec URL |
|---|---|
Devnet |
https://api.utilities.digitalasset-dev.com/api/utilities/v0/openapi |
Testnet |
https://api.utilities.digitalasset-staging.com/api/utilities/v0/openapi |
Mainnet |
https://api.utilities.digitalasset.com/api/utilities/v0/openapi |