Synthesis (Ghostwriter)
Synthesis is a multi-source agent capable of querying across private Knowledge Graphs for collaborative research. It enables AI agents and researchers to compile comprehensive reports from multiple independent creators while ensuring proper attribution and royalties.
Status: Synthesis is currently in development. The API endpoints below represent the planned implementation.
Overview
Synthesis (codenamed "Ghostwriter") breaks down the traditional research workflow:
Traditional Research:
Creator A's Blog → Creator B's Article → Creator C's Paper → Write Report
(You must subscribe to all, manually synthesize)
Synthesis:
AI queries multiple KGs → Compiles report → Pays each creator → You get synthesis
What is Synthesis?
Synthesis is a collaborative research engine that:
- Queries multiple private Knowledge Graphs simultaneously
- Aggregates facts and findings from different creators
- Maintains proper attribution throughout
- Generates comprehensive reports with citations
- Handles payments to all contributing creators
The Synthesis Request Model
Properties
- Name
id- Type
- string
- Description
Unique identifier for the synthesis request.
- Name
query- Type
- string
- Description
The research query or topic.
- Name
sources- Type
- array
- Description
List of creator addresses to query.
- Name
depth- Type
- enum
- Description
Research depth:
quick,standard,comprehensive.
- Name
status- Type
- enum
- Description
Status:
pending,processing,completed,failed.
- Name
created_at- Type
- timestamp
- Description
When the request was created.
- Name
completed_at- Type
- timestamp
- Description
When the synthesis was completed.
- Name
total_fee- Type
- string
- Description
Total fee for the synthesis (base + query royalties).
Create Synthesis Request
Create a new synthesis request for collaborative research.
Required attributes
- Name
query- Type
- string
- Description
The research topic or question.
- Name
sources- Type
- array
- Description
Array of creator Sui addresses to query from.
Optional attributes
- Name
depth- Type
- enum
- Description
Research depth:
quick(1-2 sources),standard(3-5),comprehensive(5+).
- Name
specific_triples- Type
- array
- Description
Pre-identified triple IDs to include.
Fee structure
- Synthesis Fee: Flat fee based on depth ($0.01 - $0.10)
- Query Royalties: Per-triple fees (80% to creators)
Request
curl https://api.zing.protocol/v1/synthesis/request \
-H "Authorization: Bearer {jwt_token}" \
-d query="What are the latest developments in AI safety research?" \
-d sources='["0xcreator...alice", "0xcreator...bob", "0xcreator...carol"]' \
-d depth="standard"
Get Synthesis Result
Get the result of a synthesis request.
Path parameters
- Name
id- Type
- string
- Description
The synthesis request ID.
Request
curl https://api.zing.protocol/v1/synthesis/synth_abc123 \
-H "Authorization: Bearer {jwt_token}"
List Synthesis History
Get the history of synthesis requests for the authenticated user.
Query parameters
- Name
status- Type
- enum
- Description
Filter by status:
pending,processing,completed,failed.
- Name
limit- Type
- integer
- Description
Number of results (default: 10).
Request
curl https://api.zing.protocol/v1/synthesis/history \
-H "Authorization: Bearer {jwt_token}"
Synthesis Flow
1. User submits research query
↓
2. System identifies relevant creators/sources
↓
3. For each source:
┌─────────────────────────────────────┐
│ PPQ Query via /v1/ppq/initiate │
└─────────────────────────────────────┘
↓
4. Aggregate all triples
↓
5. Generate synthesis with citations
↓
6. Calculate total fees (base + royalties)
↓
7. User pays all fees atomically
↓
8. Attribution records created for all
↓
9. Synthesis delivered with full citations
Fee Structure
| Depth | Synthesis Base Fee | Max Query Royalties |
|---|---|---|
| Quick | $0.01 | $0.05 |
| Standard | $0.02 | $0.10 |
| Comprehensive | $0.05 | $0.25 |
Example Calculation
Query: "Latest AI safety developments"
Sources: 3 creators (alice, bob, carol)
Depth: standard
Synthesis base: $0.02
Query royalties:
- alice: 15 triples × $0.001 = $0.015
- bob: 18 triples × $0.001 = $0.018
- carol: 12 triples × $0.001 = $0.012
Total: $0.02 + $0.045 = $0.065
Creator total: $0.036 (80% of $0.045)
Citation Format
Each fact in the synthesis includes citation:
{
"fact": "New interpretability techniques emerge in 2024",
"confidence": 0.92,
"citations": [
{
"creator": "0xcreator...alice",
"attribution": "@alice",
"blob_id": "walrus_blob_abc123",
"triple_id": "triple_042",
"fee_paid": "0.001"
}
]
}
Use Cases
| Use Case | Description |
|---|---|
| Research Papers | Compile findings from multiple experts |
| Market Analysis | Aggregate insights from multiple analysts |
| Technical Documentation | Synthesize tutorials from different creators |
| Due Diligence | Gather information from multiple sources |
| Trend Reports | Combine perspectives on emerging topics |
Creator Benefits
| Benefit | Description |
|---|---|
| New Revenue | Earn royalties from synthesis queries |
| Exposure | Get featured in research across topics |
| Low Effort | Content automatically included (opt-out available) |
| Attribution | Full citation for every fact used |
Next Steps
- Pay-Per-Query API - Individual triple access
- Attribution Ledger - Track usage attribution
- Knowledge Graph - Explore available triples