Skip to content

Documentation

For watchers

Stake $PRTN, probe endpoints, attest to failures in an ERC-8004 compatible format, and get paid from seized bonds.

Role

Watchers make the bond credible. They measure endpoints against what each series promised and report failures on-chain. A bond with nobody watching is only collateral; a bond with staked watchers is a guarantee.

Staking

Watchers stake $PRTN in the Slasher.

  • A minimum stake is required to attest. It is a governance parameter.
  • Stake earns a share of protocol fees: 50 % of every fee goes to $PRTN stakers, pro rata.
  • Stake is at risk: abusive attestations are penalised (see below).
  • Unstaking has a delay, longer than the dispute window, so a watcher cannot attest and leave before the outcome.

Probing endpoints

A watcher chooses which series to follow and runs checks against their endpoints.

CheckWhat is measuredTypical method
UptimeShare of requests answered over a windowScheduled requests from several regions
Latencyp95 time to first byte or to completionTimed requests with a fixed prompt set
ModelWhether the served model matches the declarationFingerprint prompts, token-level log-probabilities, output length profiles

Paid endpoints need paid probes. Watchers hold small amounts of the series they watch and redeem them like any buyer, which also tests the redemption path. Third-party endpoint scores approved by governance can serve as default oracles.

Attestation format

Attestations are EIP-712 signed structs, designed to be recorded as ERC-8004 validation responses so they are readable outside PORTION.

solidity
struct Attestation {
    uint256 seriesId;
    uint8 check;            // 0 uptime, 1 latency, 2 model
    uint64 windowStart;
    uint64 windowEnd;
    uint256 observed;       // e.g. uptime in bps, latency in ms
    uint256 threshold;      // what the series promised
    bytes32 evidenceHash;   // hash of the probe log
    string evidenceURI;     // where the probe log can be fetched
    bytes32 erc8004Ref;     // ERC-8004 validation record, or zero
}

The evidence log must contain the raw requests and responses, timestamps and, for model checks, the method used. An attestation without retrievable evidence can be contested and will fail.

Dispute window

When attestations for a series reach the quorum set by governance, the Slasher opens a 24-hour window. Trading of the series stops. The provider can contest by submitting counter-evidence covering the same window. At the end:

  • No contest, or contest rejected: the series is slashed.
  • Contest upheld: the dispute closes, trading resumes, and the attesting watchers are penalised.

Rewards

On a slash, 10 % of the seized bond, a governance parameter, goes to the watchers who attested, pro rata to their stake, paid in $PRTN. The rest funds USDC refunds to holders; anything left is burned.

Watchers also receive their share of protocol fees as stakers, whether or not they attest.

Penalties

  • An attestation overturned in a dispute costs the watcher part of their stake, paid to the provider.
  • Repeated attestations without evidence, or attestations copied from other watchers without independent probing, can be penalised by governance.
  • Colluding with a provider to hide a failure is not attestable by design, but it is visible: other watchers can attest, and the colluding watcher earns nothing from the slash.