Kinetic Trust Protocol (KTP) - Trust Oracle Specification¶
This document specifies the Trust Oracle for the Kinetic Trust Protocol (KTP). The Trust Oracle is the authoritative source of trust state within a zone—issuing Trust Proofs, co-signing trajectory records, calculating environmental stability (E), and enforcing Digital Gravity. The specification covers Oracle architecture, consensus mechanisms, threshold signatures, mesh topology, Oracle accountability, and Oracle-to-Oracle federation.
Introduction¶
The Trust Oracle is the nerve center of a KTP zone. It performs the calculations that make Digital Gravity possible:
-
Collects Context Signal measurements
-
Calculates Risk Factor (R) and Environmental Stability (E)
-
Issues Trust Proofs to agents
-
Co-signs trajectory chain transactions
-
Enforces the Zeroth Law (A ≤ E)
-
Applies gravity constraints when needed
-
Attests to agent behavior for Proof of Resilience
Without a functioning Trust Oracle, KTP cannot operate. The Oracle is both critical infrastructure and potential single point of failure. This specification addresses both the capabilities required and the resilience necessary.
Design Principles¶
The Trust Oracle embodies these principles:
-
Availability: The Oracle MUST be available for zone operation. Downtime means agents cannot act.
-
Integrity: Oracle decisions MUST be consistent and correct. Corrupted Oracles corrupt the entire trust system.
-
Accountability: Oracles are themselves subject to KTP. They cannot exempt themselves from the constraints.
-
Transparency: Oracle operations MUST be auditable. Trust requires visibility.
-
Resilience: Single Oracle failure MUST NOT disable the zone. Redundancy is required.
-
Performance: Oracle latency MUST NOT bottleneck agent operations. Speed matters.
Requirements Language¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 (RFC 2119 and RFC 8174).
Terminology¶
Attestation: A signed statement by the Oracle confirming some fact about an agent or transaction.
Consensus: Agreement among multiple Oracle nodes on trust state.
Oracle Mesh: A network of connected Oracle nodes providing redundancy and consensus.
Oracle Node: A single instance of Trust Oracle software and associated cryptographic identity.
Quorum: The minimum number of Oracle nodes required for valid decisions.
Split Brain: A failure mode where Oracle nodes disagree and cannot reach consensus.
Threshold Signature: A cryptographic signature requiring M-of-N participants to produce.
Trust Proof: A signed attestation of an agent's current trust state, issued by the Oracle.
Oracle Architecture¶
Single Node Architecture¶
A single Oracle node contains:
+------------------------------------------------------------------+
| TRUST ORACLE NODE |
| |
| +------------------------------------------------------------+ |
| | Signal Collector | |
| | Receives measurements from all six signal domains | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Risk Calculator | |
| | R = weighted_aggregate(domain_risks) | |
| | E = E_base × (1 - R) | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Zeroth Law Engine | |
| | Evaluates A ≤ E for every action request | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Gravity Calculator | |
| | G = f(A, E, threshold) — determines constraint level | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Trust Proof Issuer | |
| | Issues signed Trust Proofs to agents | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Trajectory Co-Signer | |
| | Co-signs agent transaction records | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Attestation Engine | |
| | Issues Proof of Resilience attestations | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Key Management | |
| | HSM-backed cryptographic operations | |
| +------------------------------------------------------------+ |
| | |
| +------------------------------------------------------------+ |
| | Consensus Client | |
| | Participates in Oracle Mesh consensus | |
| +------------------------------------------------------------+ |
| |
+------------------------------------------------------------------+
Component Specifications¶
Signal Collector¶
The Signal Collector receives measurements from Context Signal instrumentation:
-
Input: Body domain Source: Infrastructure monitoring Rate: 1-100 Hz
-
Input: World domain Source: Environmental sensors/simulation Rate: 0.1-10 Hz
-
Input: Time domain Source: Time subsystem Rate: Per transaction
-
Input: Relational domain Source: Relationship monitoring Rate: Per interaction
-
Input: Information domain Source: Information environment monitoring Rate: 1 Hz
The Collector MUST:
-
Validate incoming measurements
-
Detect anomalous or spoofed data
-
Maintain measurement history for smoothing
-
Provide current Risk Factor state on demand
Risk Calculator¶
The Risk Calculator computes R from Risk Factor measurements:
Where weights sum to 1.0 (default):
soul_weight = 0.25
body_weight = 0.10
world_weight = 0.15
time_weight = 0.15
relational_weight = 0.20
signal_weight = 0.15
The Calculator MUST:
-
Update R within 10ms of an input change
-
Apply temporal smoothing to prevent oscillation
-
Handle missing input data gracefully
-
Log R changes for audit
Zeroth Law Engine¶
The Zeroth Law Engine evaluates A ≤ E for every action:
Input:
Process:
1. Calculate A = autonomy(action_request)
2. Retrieve agent E_base
3. Get current R
4. Calculate E = E_base × (1 - R)
5. Evaluate A ≤ E
Output:
The Engine MUST:
-
Complete evaluation within 1ms
-
Be deterministic (same inputs → same outputs)
-
Log all evaluations
-
Handle concurrent requests
Trust Proof Issuer¶
The Trust Proof Issuer creates signed Trust Proofs:
{
"proof_id": "tp-2025-12-03-001",
"agent_id": "agent:independent:3gen:acme:abc123",
"issued_at": "2025-12-03T14:32:15.123Z",
"expires_at": "2025-12-03T14:32:25.123Z",
"trust_state": {
"e_base": 55,
"e_trust": 44,
"r_current": 0.2,
"tier": "analyst",
"lineage": "independent",
"generation": 3
},
"constraints": {
"max_action_risk": 44,
"restricted_actions": [],
"gravity_active": false
},
"oracle_id": "oracle:zone-blue-prod-01:primary",
"signature": "sig:oracle:..."
}
Trust Proofs MUST:
-
Have short expiration (default: 10 seconds)
-
Be signed by Oracle key
-
Include current trust state
-
Be verifiable by any party with Oracle public key
Trajectory Co-Signer¶
The Co-Signer adds Oracle attestation to trajectory records:
Input: transaction_record (agent-signed)
Process:
1. Verify agent signature
2. Verify action was permitted
3. Verify state transitions are valid
4. Capture Risk Factor snapshot
5. Add Oracle attestation
6. Sign complete record
Output: transaction_record (co-signed)
The Co-Signer MUST:
-
Verify before signing (never blind sign)
-
Include the Risk Factor snapshot at time of transaction
-
Refuse to sign invalid records
-
Log all signing operations
Oracle Mesh¶
Mesh Topology¶
Production deployments MUST use multiple Oracle nodes in a mesh:
+------------------+ +------------------+
| Oracle Node 1 |<---->| Oracle Node 2 |
+------------------+ +------------------+
^ ^
| |
v v
+------------------+ +------------------+
| Oracle Node 3 |<---->| Oracle Node 4 |
+------------------+ +------------------+
^ ^
| |
v v
+------------------+ +------------------+
| Oracle Node 5 |<---->| Oracle Node 6 |
+------------------+ +------------------+
Mesh Requirements¶
-
Requirement: Geographic distribution Minimum: 2 locations Recommended: 3+ locations
-
Requirement: Network latency (inter-node) Minimum: <100ms Recommended: <50ms
-
Requirement: Quorum for operations Minimum: (N/2)+1 Recommended: (2N/3)+1
Node Roles¶
All nodes are peers, but roles may be assigned:
-
Role: Primary Responsibility: Receives requests, initiates consensus
-
Role: Secondary Responsibility: Participates in consensus, can become primary
-
Role: Witness Responsibility: Participates in consensus, does not serve requests
Primary selection uses leader election:
-
Highest-uptime node becomes primary
-
Automatic failover on primary failure
-
No single primary required (multi-primary possible)
Consensus Mechanisms¶
Consensus Requirements¶
Oracle consensus must achieve:
-
Agreement: All honest nodes reach same decision
-
Validity: Decision reflects actual trust state
-
Termination: Decision is reached in bounded time
-
Fault tolerance: Tolerates f < N/3 Byzantine failures
Consensus Protocol¶
The Oracle Mesh uses a simplified PBFT-style consensus:
Phase 1: PRE-PREPARE
Primary receives request
Primary assigns sequence number
Primary broadcasts <PRE-PREPARE, seq, request> to all nodes
Phase 2: PREPARE
Nodes verify request
Nodes broadcast <PREPARE, seq, digest> to all nodes
Node enters PREPARED state when 2f+1 PREPARE messages received
Phase 3: COMMIT
Nodes broadcast <COMMIT, seq, digest> to all nodes
Node enters COMMITTED state when 2f+1 COMMIT messages received
Node executes request and responds to client
Consensus Scope¶
Not all operations require full consensus:
-
Operation: Zeroth Law evaluation Consensus Required: No (single node sufficient)
-
Operation: Trust Proof issuance Consensus Required: No (single node sufficient)
-
Operation: Trajectory co-signing Consensus Required: Yes (quorum required)
-
Operation: E_base modification Consensus Required: Yes (quorum required)
-
Operation: Agent Genesis Consensus Required: Yes (quorum required)
-
Operation: Zone configuration change Consensus Required: Yes (supermajority required)
Split Brain Prevention¶
Split brain occurs when network partition creates multiple sub-quorums. Prevention:
-
Quorum requirement: Operations require (N/2)+1 nodes
-
Fencing: Partitioned nodes fence themselves
-
Witness nodes: Odd number of nodes prevents even splits
-
Merge protocol: Reconciliation when partition heals
Threshold Signatures¶
Overview¶
Critical Oracle operations use threshold signatures—requiring M of N Oracle nodes to produce a valid signature.
Example (3-of-5):
Node 1 holds share 1
Node 2 holds share 2
Node 3 holds share 3
Node 4 holds share 4
Node 5 holds share 5
Any 3 nodes can combine shares to produce valid signature
No single node can sign alone
Signature is indistinguishable from standard signature
Threshold Scheme¶
The Oracle uses Shamir's Secret Sharing with threshold ECDSA:
-
Parameter: N Description: Total number of nodes Default: 5
-
Parameter: M Description: Threshold for signing Default: 3
-
Parameter: Curve Description: Elliptic curve Default: secp256k1
-
Parameter: Hash Description: Hash algorithm Default: SHA-256
Key Ceremony¶
Threshold keys are generated in a key ceremony:
-
All N nodes generate random contributions
-
Contributions are combined using DKG protocol
-
Each node receives its key share
-
No node ever sees complete private key
-
Public key is published
-
Ceremony is recorded and witnessed
Operations Requiring Threshold Signature¶
-
Operation: E_base modification Threshold: 3-of-5
-
Operation: Zone configuration change Threshold: 4-of-5
-
Operation: Oracle key rotation Threshold: 4-of-5
-
Operation: Zone dissolution Threshold: 5-of-5
Trust Proof Lifecycle¶
Issuance¶
Trust Proofs are issued on demand:
Oracle:
1. Verify agent identity
2. Calculate current E_trust
3. Determine tier and constraints
4. Create Trust Proof
5. Sign with Oracle key
Validation¶
Any party can validate a Trust Proof:
Validator:
1. Check proof not expired
2. Verify Oracle signature against known public key
3. Verify agent_id matches expected agent
4. Check constraints are appropriate for action
Refresh¶
Trust Proofs expire quickly and must be refreshed:
-
Zone Type: Blue Default Expiration: 10 seconds Refresh Recommendation: Every 5 seconds
-
Zone Type: Cyan Default Expiration: 30 seconds Refresh Recommendation: Every 15 seconds
-
Zone Type: Green Default Expiration: 60 seconds Refresh Recommendation: Every 30 seconds
Revocation¶
Trust Proofs can be revoked before expiration:
Oracle: RevokeTrustProof(proof_id, reason)
1. Add proof_id to revocation list
2. Broadcast revocation to mesh
3. Notify agent
4. Log revocation
Revocation reasons:
-
Agent violation detected
-
E_base reduced
-
Zone policy change
-
Security incident
Oracle Accountability¶
Oracles Under Gravity¶
The recursive constraint principle: Oracles are subject to KTP.
Oracle actions have autonomy (A):
-
Issuing Trust Proof: A = 10
-
Co-signing transaction: A = 20
-
Modifying E_base: A = 60
-
Changing zone config: A = 80
Oracle has E_base based on its own trajectory:
-
Uptime history
-
Decision accuracy
-
Consensus participation
-
No Byzantine behavior
Oracle actions are constrained: A_oracle ≤ E_oracle
Oracle Trajectory¶
Oracles maintain their own trajectory chains:
{
"oracle_id": "oracle:zone-blue-prod-01:node-1",
"trajectory": {
"genesis_date": "2025-01-15T00:00:00Z",
"uptime_percentage": 99.97,
"transactions_co-signed": 4847293,
"consensus_participation_rate": 0.998,
"byzantine_incidents": 0,
"e_base": 95
}
}
Oracle Audit¶
Oracle operations are logged to Flight Recorder:
-
Event: Transaction co-signed Logged Data: Transaction hash, agent, result
-
Event: Zeroth Law evaluation Logged Data: A, E, result, agent, action
-
Event: Consensus participation Logged Data: Vote, sequence, outcome
-
Event: Configuration change Logged Data: Change details, authorizer
Oracle Misbehavior¶
Detected misbehavior triggers consequences:
-
Misbehavior: Consensus equivocation Detection: Protocol detection Consequence: Removal from mesh
-
Misbehavior: Availability failure Detection: Heartbeat timeout Consequence: Temporary removal
-
Misbehavior: Byzantine behavior Detection: BFT detection Consequence: Permanent removal
Federation¶
Oracle-to-Oracle Federation¶
Oracles in different zones can federate:
Federation enables:
-
Cross-zone Trust Proof validation
-
Trajectory verification requests
-
Exit Attestation verification
-
Coordinated emergency response
Federation Establishment¶
-
Zone A Oracle requests federation with Zone B
-
Zone B reviews Zone A governance and attestations
-
Both zones sign Federation Agreement
-
Public keys exchanged
-
Trust factors established
-
Federation active
Federation Trust Factor¶
Trust is discounted across federation:
{
"federation": {
"zone_a": "zone-blue-prod-01",
"zone_b": "zone-blue-prod-02",
"trust_factor_a_to_b": 0.9,
"trust_factor_b_to_a": 0.9,
"established": "2025-06-01T00:00:00Z",
"last_verified": "2025-12-01T00:00:00Z"
}
}
Cross-Zone Operations¶
-
Operation: Verify foreign trajectory Federation Requirement: Federation active
-
Operation: Accept Exit Attestation Federation Requirement: Federation active
-
Operation: Cross-zone agent migration Federation Requirement: Federation active
Performance Requirements¶
Latency Targets¶
-
Operation: Zeroth Law evaluation Target: 1ms Maximum: 5ms
-
Operation: Trust Proof issuance Target: 5ms Maximum: 20ms
-
Operation: Transaction co-signing Target: 10ms Maximum: 50ms
-
Operation: Consensus round Target: 50ms Maximum: 200ms
Throughput Targets¶
-
Metric: Evaluations/second Target: 100,000 Notes: Per node
-
Metric: Co-signatures/second Target: 1,000 Notes: Consensus limited
Mesh and node availability targets¶
-
Metric: Mesh availability Target: 99.99%
-
Metric: Single node availability Target: 99.9%
-
Metric: Recovery time (node failure) Target: <10 seconds
-
Metric: Recovery time (quorum loss) Target: <60 seconds
Deployment Models¶
Cloud Deployment¶
+------------------+ +------------------+ +------------------+
| Region A | | Region B | | Region C |
| +----------+ | | +----------+ | | +----------+ |
| | Oracle 1 | | | | Oracle 2 | | | | Oracle 3 | |
| +----------+ | | +----------+ | | +----------+ |
| | Oracle 4 | | | | Oracle 5 | | | |
| +----------+ | | +----------+ | | |
+------------------+ +------------------+ +------------------+
On-Premises Deployment¶
+------------------+ +------------------+
| Data Center A | | Data Center B |
| +----------+ | | +----------+ |
| | Oracle 1 | | | | Oracle 3 | |
| +----------+ | | +----------+ |
| | Oracle 2 | | | | Oracle 4 | |
| +----------+ | | +----------+ |
| | | | Oracle 5 | |
| | | +----------+ |
+------------------+ +------------------+
Hybrid Deployment¶
+------------------+ +------------------+ +------------------+
| On-Premises | | Cloud A | | Cloud B |
| +----------+ | | +----------+ | | +----------+ |
| | Oracle 1 | | | | Oracle 3 | | | | Oracle 5 | |
| +----------+ | | +----------+ | | +----------+ |
| | Oracle 2 | | | | Oracle 4 | | | |
| +----------+ | | +----------+ | | |
+------------------+ +------------------+ +------------------+
Security Considerations¶
Key Protection¶
Oracle private keys MUST be protected:
-
HSM storage required for production
-
Key shares never assembled outside ceremony
-
Access controls on key operations
-
Audit logging of all key use
Network Security¶
Oracle mesh communication MUST be secured:
-
Mutual TLS between all nodes
-
Certificate pinning
-
Network isolation where possible
-
DDoS protection
Byzantine Fault Tolerance¶
The mesh tolerates Byzantine (malicious) nodes:
-
Up to f < N/3 Byzantine nodes tolerated
-
Byzantine behavior detected by protocol
-
Detected Byzantine nodes removed
-
Mesh continues with remaining honest nodes
Oracle Compromise Response¶
If Oracle compromise is detected:
-
Isolate compromised node
-
Revoke node's key share
-
Issue key rotation if threshold compromised
-
Audit all recent decisions
-
Notify affected agents
-
Post-incident review
IANA Considerations¶
This document has no IANA actions.
Back Matter¶
Oracle Node Specification¶
Hardware and software requirements for Oracle nodes.
Minimum Hardware:
-
Component: CPU Requirement: 8 cores
-
Component: RAM Requirement: 32 GB
-
Component: Storage Requirement: 500 GB NVMe SSD
-
Component: Network Requirement: 1 Gbps
-
Component: HSM Requirement: FIPS 140-2 Level 3
Recommended Hardware:
-
Component: CPU Requirement: 16+ cores
-
Component: RAM Requirement: 64 GB
-
Component: Storage Requirement: 1 TB NVMe SSD (RAID)
-
Component: Network Requirement: 10 Gbps
-
Component: HSM Requirement: FIPS 140-2 Level 3, HA
Consensus Protocol Details¶
Detailed specification of the consensus protocol.
Threshold Signature Implementation¶
Implementation guidance for threshold ECDSA.
Acknowledgments
The Trust Oracle design draws on distributed systems research, Byzantine fault tolerance literature, and production experience with consensus systems.