Dso info

GET /api/scan/v0/dso

Request

curl --request GET \
  --url 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/dso'

200 response

{
  "sv_user": "string",
  "sv_party_id": "string",
  "dso_party_id": "string",
  "voting_threshold": 0,
  "latest_mining_round": {
    "contract": {},
    "domain_id": "string"
  },
  "amulet_rules": {
    "contract": {},
    "domain_id": "string"
  },
  "dso_rules": {
    "contract": {},
    "domain_id": "string"
  },
  "sv_node_states": [
    {}
  ],
  "initial_round": "string"
}

Scan API

Dso info

OpenAPISince 0.5.10

Protocol Details

Operation IDgetDsoInfo

Published0.7.4

SpecificationDownload OpenAPI

Inputs

Outputs

200

application/json

sv_user · string · required

User ID representing the SV

sv_party_id · string · required

Party representing the SV

dso_party_id · string · required

Party representing the whole DSO; for Scan only, also returned by /v0/dso-party-id

voting_threshold · integer · required

Threshold required to pass vote requests; also known as the “governance threshold”, it is always derived from the number of svs in dso_rules

latest_mining_round · ContractWithState · required

amulet_rules · ContractWithState · required

dso_rules · ContractWithState · required

sv_node_states · ContractWithState[] · required

For every one of svs listed in dso_rules, a contract of the Daml template Splice.DSO.SvState.SvNodeState. This does not include states for offboarded SVs, though they may still have an on-ledger state contract

initial_round · string

Initial round from which the network bootstraps

History

Introduced0.5.10

Request

curl --request GET \
  --url 'https://scan.sv-1.global.canton.network.sync.global/api/scan/v0/dso'

200 response

{
  "sv_user": "string",
  "sv_party_id": "string",
  "dso_party_id": "string",
  "voting_threshold": 0,
  "latest_mining_round": {
    "contract": {},
    "domain_id": "string"
  },
  "amulet_rules": {
    "contract": {},
    "domain_id": "string"
  },
  "dso_rules": {
    "contract": {},
    "domain_id": "string"
  },
  "sv_node_states": [
    {}
  ],
  "initial_round": "string"
}