GetSettlementContracts

Discover on-chain DvpProposal and Dvp contracts for active settlements

Look up on-chain DvpProposal and Dvp contracts for a given list of settlement IDs. Use it to discover the state of active settlements before proposing, accepting, or allocating.

Request

settlement_ids · string[] · required

Settlement identifiers to look up.

message GetSettlementContractsRequest {
  repeated string settlement_ids = 1;
}

Response

contracts · DiscoveredContract[]

Matching DvP-related contracts, each with contract ID, template ID, and payload.

Example

grpcurl -d '{"settlement_ids": ["sett-123"]}' \
  rpc-devnet.modo-api.app:443 \
  silvana.ledger.v1.DAppProviderService/GetSettlementContracts

DvP flow

GetSettlementContracts is typically called by the counterparty before AcceptDvp, and by the proposer before Allocate, to discover the relevant contract IDs.

Full sequence: PayDvpFee → ProposeDvp → AcceptDvp → PayAllocFee → Allocate.