Protocol Specifications
Comprehensive architectural overview and operational procedures for interacting with the Provr execution network.
System Overview
The protocol establishes a trustless bridge between Originators (Clients) requiring computational or manual labor, and Operators (Workers) capable of execution. Capital is locked programmatically in a smart contract and released strictly upon verification of cryptographic or off-chain proof. The system eliminates intermediaries, discretionary approvals, and settlement friction.
Verification is an autonomous process: the underlying Rialo contract directly interrogates an external verifier API using a native webcall entirely bypassing legacy oracle networks. Execution windows are governed strictly by on-chain timers, negating the need for external keeper bots.
Initialize & Lock
Escrow $RIALO upon pipeline creation.
Native Verification
Autonomous webcall to verifier endpoints.
Automated Settlement
Trustless routing. Zero human intervention.
Execution Pipeline
The protocol lifecycle strictly adheres to a deterministic state machine sequence:Open In Progress Under Review Settled /Clawback /Disputed
Client broadcasts a task to the network, defining the execution parameters, verification method, and deadline. $RIALO is securely locked into the protocol escrow contract.
A verified worker (operator) claims the Open task from the global execution queue. The protocol locks the task to this specific operator address to prevent race conditions.
Operator executes the work off-chain and submits a cryptographic proof or public verifiable URL (e.g., GitHub PR, endpoint) back to the protocol.
The Rialo contract autonomously triggers a native webcall to the specified verifier endpoint. This step requires zero oracles, relayers, or keeper bots.
$RIALO is autonomously routed from escrow to the operator's wallet. Finality is reached.
If the on-chain timer expires without successful verification, escrow is automatically refunded.
If verification fails or client raises an issue, the protocol enters a halted state requiring manual resolution.
Client Operations
Protocol Initialization
- Access the /tasks/create interface to broadcast execution parameters.
- Define the required proof vector (e.g., GitHub PR, live URL, compiled binary link).
- Establish a strict execution window (deadline). On-chain timers will auto-execute clawbacks if unmet.
- Select a designated verification engine (refer to Verification Engine architecture below).
- Execute Initialize Escrow Contract to lock $RIALO liquidity.
Verifier Architecture Configuration
The chosen verification engine dictates how the smart contract validates the operator's proof. Standard operations utilize url_exists or github_commit. For proprietary business logic, deploy a custom_webhook and connect your internal endpoint.
Dispute Resolution Escalation
- Access the active pipeline via the Mission Control dashboard while the state is Under Review.
- Trigger the Dispute command and inject cryptographic or contextual reasoning.
- The pipeline halts. You gain manual authority to route payment to the Operator or initiate a Refund.
- Warning: Resolution must occur before the protocol's grace period expires, or funds auto-route.
Operator Manual
Queue Interrogation
- Monitor the global execution queue at /tasks.
- Utilize telemetry filters to identify optimal reward/complexity ratios.
- Execute the Claim operation on viable pipelines.
- Post-claim, the protocol locks the pipeline exclusively to your wallet address. Parallel execution is disabled.
Proof Delivery Protocol
- Deliver a publicly verifiable URL. The contract verifier must achieve unauthenticated reachability.
- For GitHub integrations, route directly to the specific Commit SHA or Pull Request URL.
- Ensure payload matches client specifications exactly especially for content_match directives.
- Inject operational logs/notes during submission to expedite dispute resolution if triggered.
Settlement Flow
Upon proof delivery, the Rialo contract fires the verification webhook. If the assertion returns true, $RIALO is routed to your wallet with sub-second finality. If false, the pipeline reverts to Under Review, allowing the Originator to manually intervene.
Verification Engine
Provr's verification layer is driven by Rialo's Native Webcall architecture. The L1 smart contract independently executes HTTP requests to external APIs, entirely abstracting away third-party oracle infrastructure.
url_existsRialo's contract autonomously makes a HEAD/GET request to the submitted proof URL. If it returns HTTP 2xx, verification passes.
github_commitVerifier queries the GitHub API to confirm the commit SHA or PR number exists and is successfully merged into the target repository.
content_matchVerifier fetches the proof URL and scans the response body for a cryptographic keyword or specific pattern defined by the client.
custom_webhookRialo POSTs the full execution context directly to your proprietary endpoint. Execute your own logic (e.g. database checks, AI assertions) and return finality.
{
"taskId": "task_001",
"workerAddress": "rialo1abc...xyz",
"proofUrl": "https://github.com/worker/repo/pull/42",
"clientAddress": "rialo1def...uvw",
"verifiedAt": 1715000000
}{
"verified": true,
"reason": "PR #42 successfully merged into main",
"confidence": 99
}Protocol Infrastructure
Contracts directly execute external HTTPS routing. Eliminates Chainlink/Pyth relayer dependencies and enables autonomous verification.
Deterministic deadline enforcement built into the runtime. Triggers automated clawbacks without Gelato or external keeper networks.
Cryptographic wallet derivation via social login (Email, GitHub). Zero-friction onboarding removing seed phrase complexities.
Immediate $RIALO settlement post-verification. Eradicates bridge latency and L1 finality delays.
The SCALE Architecture Pattern
Provr implements Rialo's formalized SCALE methodology for agent-based economic operations:
Originator establishes execution logic and locks escrow capital.
Protocol cryptographically records the pipeline parameters.
Operator claims execution rights and performs off-chain labor.
Operator injects the proof vector back into the on-chain state.
Protocol triggers autonomous webcall verifier and finalizes settlement.
Knowledge Base
Q.Is Provr free to use?
Provr currently charges zero platform protocol fees. You only pay the underlying gas for Rialo network operations (which are minimal) and the $RIALO reward you lock in the smart contract escrow.
Q.What happens if the verifier endpoint is down?
If the target verifier endpoint returns a non-2xx status, errors, or times out, the native verification is marked as failed. The pipeline remains in the Under Review state. The client can manually retry the verification trigger or escalate to a dispute.
Q.Can I cancel a task after broadcasting it?
Yes. If the pipeline is still in the Open state (no operator has locked it), you can execute a termination call and receive an immediate, full clawback of your escrowed $RIALO.
Q.What if I disagree with the automated verification result?
If the verifier script returns true but you identify a critical flaw in the deliverable, you can trigger a Dispute while the task is still Under Review. The protocol halts auto-settlement, giving you manual override control to release or clawback the funds.
Q.Is my $RIALO capital secure in the protocol?
Absolutely. All capital is locked within an audited Rialo smart contract. Funds can strictly only be routed to the verified operator, clawed back to the originator, or resolved via explicit dispute calls. No third party or intermediary has custody.
Q.When will the Provr protocol launch on mainnet?
Provr will transition from devnet to mainnet simultaneously with the public release of the Rialo SDK. Monitor @rialoio for infrastructure deployment updates.
lib/rialo.tsabstraction layer for the comprehensive SDK implementation every function is strictly documented referencing its production counterpart.