GetSettlementContracts

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.

RequestPreapproval PayDvpFee

⌘I

Introduction

Core (read-only)

Transfer

Preapproval

DvP (Delivery vs Payment)

CIP-56 Tokens

Recurring Payments

Onboarding

MultiCall

User Service

Bridge

Request

Response

Example

DvP flow

​Request

​Response

​Example

​DvP flow

Request

Response

Example

DvP flow