- finalized request and response interfaces