Documentation/canton-network-docs/Ledger APIgRPC APIPackagesv2.adminServicesPartyManagementServiceView on canton-network-docs ↗
canton-network-docs/Ledger APIgRPC APIPackagesv2.adminServicesPartyManagementService

GenerateExternalPartyTopology

Ledger API›gRPC API›v2.admin›GenerateExternalPartyTopology

com.daml.ledger.api.v2.admin

​
GenerateExternalPartyTopology

gRPCSince 3.4.4
RPC/com.daml.ledger.api.v2.admin.PartyManagementService/GenerateExternalPartyTopology

​
Protocol Details

​
Inputs

​
GenerateExternalPartyTopologyRequest

synchronizerstring
party_hintstring
public_keySigningPublicKey
local_participant_observation_onlybool
other_confirming_participant_uidsrepeated string
confirmation_thresholduint32
observing_participant_uidsrepeated string

​
Outputs

​
GenerateExternalPartyTopologyResponse

party_idstring
public_key_fingerprintstring
topology_transactionsrepeated bytes
multi_hashbytes

​
Lifecycle Changes

3.4.4introduced

com.daml.ledger.api.v2.admin.GenerateExternalPartyTopologyRequest

synchronizerstring
party_hintstring
public_keySigningPublicKey
local_participant_observation_onlybool
other_confirming_participant_uidsrepeated string
confirmation_thresholduint32
observing_participant_uidsrepeated string

com.daml.ledger.api.v2.SigningPublicKey

formatCryptoKeyFormat
key_databytes
key_specSigningKeySpec

com.daml.ledger.api.v2.CryptoKeyFormat

  • CRYPTO_KEY_FORMAT_UNSPECIFIED
  • CRYPTO_KEY_FORMAT_DER
  • CRYPTO_KEY_FORMAT_RAW
  • CRYPTO_KEY_FORMAT_DER_X509_SUBJECT_PUBLIC_KEY_INFO

com.daml.ledger.api.v2.SigningKeySpec

  • SIGNING_KEY_SPEC_UNSPECIFIED
  • SIGNING_KEY_SPEC_EC_CURVE25519
  • SIGNING_KEY_SPEC_EC_P256
  • SIGNING_KEY_SPEC_EC_P384
  • SIGNING_KEY_SPEC_EC_SECP256K1

com.daml.ledger.api.v2.admin.GenerateExternalPartyTopologyResponse

party_idstring
public_key_fingerprintstring
topology_transactionsrepeated bytes
multi_hashbytes
grpcurl
grpcurl
# Add -plaintext if the server is not using TLS.
grpcurl \
  -d @ \
  <HOST:PORT> \
  com.daml.ledger.api.v2.admin.PartyManagementService/GenerateExternalPartyTopology <<'EOF'
{
  "synchronizer": "string",
  "partyHint": "string",
  "publicKey": {
    "format": "CRYPTO_KEY_FORMAT_UNSPECIFIED",
    "keyData": "BASE64_ENCODED_BYTES",
    "keySpec": "SIGNING_KEY_SPEC_UNSPECIFIED"
  },
  "localParticipantObservationOnly": true,
  "otherConfirmingParticipantUids": [
    "string"
  ],
  "confirmationThreshold": 0,
  "observingParticipantUids": [
    "string"
  ]
}
EOF
OKapplication/json
OK
{
  "partyId": "string",
  "publicKeyFingerprint": "string",
  "topologyTransactions": [
    "BASE64_ENCODED_BYTES"
  ],
  "multiHash": "BASE64_ENCODED_BYTES"
}