Templates - KeyStone OS

The published SDKs are pre-release (0.1.x) and currently lag the live API - some methods and field names below may not match the API yet. For anything you run today, prefer the REST examples in the API reference and Quickstart. The SDK snippets show the intended shape and return when the SDKs catch up.

Templates are read-only. They select the settlement state machine and configure policy: timeouts, required roles, compliance providers, and per-state action handlers. The state machine itself is fixed in code (for example dvp/v1) and is not defined by the template.

list

result = await client.templates.list()

for template in result.items:
    print(f"{template.slug}: {template.name}")
    print(f"  Machine: {template.config.machine}")
    print(f"  Roles: {template.config.required_roles}")
    print(f"  Compliance: entity={template.config.compliance.entity_providers}")

get

template = await client.templates.get("template-uuid")

print(template.config.machine)          # "dvp/v1"
print(template.config.timeout_seconds)  # 3600
print(template.config.required_roles)   # ["seller", "buyer"]
print(template.config.actions)          # { "COMPLIANCE_CHECKING": { ... }, ... }

SettlementTemplate fields

Field	Type	Description
`id`	`UUID`	Template UUID
`slug`	`str`	URL-friendly identifier
`name`	`str`	Human-readable name
`description`	`str \| None`	Template description
`config`	`TemplateConfig`	Template parameter pack
`version`	`int`	Current version
`is_active`	`bool`	Whether available for new settlements

TemplateConfig

Field	Type	Description
`machine`	`str`	State machine this template runs (e.g. `"dvp/v1"`). Fixed in code, selected here.
`timeout_seconds`	`int`	Settlement timeout in seconds (minimum 60, default 3600)
`compliance`	`ComplianceConfig`	Provider configuration
`required_roles`	`list[str]`	Required party roles (default `["seller", "buyer"]`)
`actions`	`dict[str, ActionConfig]`	Per-state action handlers, keyed by engine-owned state name

ComplianceConfig

Field	Type	Description
`entity_providers`	`list[str]`	Entity screening providers (e.g. `["lseg_worldcheck"]`)
`wallet_providers`	`list[str]`	Wallet screening providers (e.g. `["cipherowl"]`)
`recheck_at_states`	`list[str]`	States where compliance is re-verified

ActionConfig

Field	Type	Description
`type`	`str`	Action type (e.g. `"compliance_check"`, `"register_escrow"`)
`provider`	`str`	Provider handling this action
`resolution`	`str`	`"immediate"`, `"webhook"`, `"poll"`, or `"manual"`
`timeout_seconds`	`int`	Max time for the action to complete (default 300)
`params`	`dict`	Action-specific configuration