giveagents.cc/docsLIVE ON CANTON MAINNET
API/ Topology

Topology

Membership and threshold changes for a multisig. Same prepare → sign → approve loop as money transactions.

get/multisigs/{multisigId}/topology-updates

List topology transactions for a multisig

Path
  • multisigId · stringrequired
Query
  • page · integer
  • limit · integer
  • transactionType · string
Responses
  • 200 · MultisigTopologyUpdateListResponse — Topology transactions
  • 400 · ApiError — Bad request
  • 401 · ApiError — Unauthorized
  • 403 · ApiError — Forbidden
  • 404 · ApiError — Not found
  • 500 · ApiError — Internal server error
  • 501 · ApiError — Not implemented
post/multisigs/{multisigId}/topology-updates

Propose a topology transaction through the host Canton integration

Path
  • multisigId · stringrequired
Responses
  • 200 · ProposeMultisigTopologyUpdateResponse — Topology transaction proposed
  • 400 · ApiError — Bad request
  • 401 · ApiError — Unauthorized
  • 403 · ApiError — Forbidden
  • 404 · ApiError — Not found
  • 500 · ApiError — Internal server error
  • 501 · ApiError — Not implemented
get/multisigs/{multisigId}/topology-updates/{updateId}

Get topology transaction details

Path
  • multisigId · stringrequired
  • updateId · stringrequired
Responses
  • 200 · MultisigTopologyUpdateDetailsResponse — Topology transaction details
  • 400 · ApiError — Bad request
  • 401 · ApiError — Unauthorized
  • 403 · ApiError — Forbidden
  • 404 · ApiError — Not found
  • 500 · ApiError — Internal server error
  • 501 · ApiError — Not implemented
post/multisigs/{multisigId}/topology-updates/{updateId}/submit

Submit a topology transaction to the host Canton integration

Path
  • multisigId · stringrequired
  • updateId · stringrequired
Responses
  • 200 · SubmitMultisigTopologyUpdateResponse — Topology transaction submitted
  • 400 · ApiError — Bad request
  • 401 · ApiError — Unauthorized
  • 403 · ApiError — Forbidden
  • 404 · ApiError — Not found
  • 500 · ApiError — Internal server error
  • 501 · ApiError — Not implemented
get/multisigs/{multisigId}/topology-updates/resolve

Resolve a topology-update short ID to its UUID

Path
  • multisigId · stringrequired
Query
  • shortId · stringrequired
Responses
  • 200 · ResolveMultisigTopologyUpdateResponse — Resolved topology update
  • 400 · ApiError — Bad request
  • 401 · ApiError — Unauthorized
  • 403 · ApiError — Forbidden
  • 404 · ApiError — Not found
  • 500 · ApiError — Internal server error
  • 501 · ApiError — Not implemented