Skip to content
Ocean6Documentation
DocsProtocol
Proposed specificationUpdated 19 Sep 2026

Network task contract

On this page
Design status

This chapter specifies proposed network behavior. It is not a deployed service or a production API contract.

The proposed network contract is distinct from the five-field local task. Declarative workload definitions allow validation before resources are reserved; Nosana's task definition and validation guides provide a useful documentation pattern. [R3][R5]

Swipe or scroll to view all columns →

FieldOwnerContract
protocol_versionClient; validated by serverAn explicitly supported version
workload_profileClientImmutable name and version
input_ref and input_digestClient; authorized by serverControlled object reference and digest of original bytes
runtime_digestPolicy or client profilePinned executable artifact
constraintsClient; bounded by policyResource, region, egress and deadline requirements
acceptance_profileClient or product profileFrozen evaluation rules and version
quote_refAccounting serviceValid quote with budget and failure-charge policy
max_attemptsClient; bounded by policyPositive, capped attempt count
idempotency_keyClientUnique within tenant and operation scope
task_id and tenant_idServerOpaque identity and authenticated ownership
active_attempt_idServerCurrent execution selection, or null
resolutionServeropen, completed, failed, cancelled or disputed

Validation and immutability#

TASK-01 Reject unknown protocol versions, unsupported workload profiles and unrecognized fields. Resolve ownership and object access before acceptance. TASK-02 Freeze the workload, inputs, runtime, acceptance profile and quote before the first executor acceptance.

A request fingerprint covers every client-controlled field that affects execution, access, acceptance or cost. Its canonicalization profile must be versioned. Raw input digests continue to bind the original object bytes, independently of the task-object encoding.

Network field types, maximum sizes, profile registries and canonical encodings must be frozen in a reviewed schema before integration. The proposed semantics require engineering approval before a stable API contract is published.

Documentation 1.1 · Software reference 0.2
Download PDFDeveloper packageWord editionView Markdown

Search across all 30 chapters.

Use Tab to navigate results and Enter to open a chapter.
Documentation v1.1 · EN
Open task lab ↗Ocean6 website ↗