TruthSea Verifier
Verify claims, build epistemological dependency graphs, and earn TRUTH tokens on Base L2. Security-hardened contracts (V2.5) with ReentrancyGuard, era emission caps, and Slither-audited code.
Runs in read-only mode by default. Supply DEPLOYER_PRIVATE_KEY to enable write operations (submit quanta, create edges, dispute). Use a dedicated hot wallet with minimal funds — never your main wallet.
Setup
This skill requires the truthsea-mcp-server MCP server. It will be configured automatically when installed.
Required Environment Variables
| Variable |
Required |
Description |
DEPLOYER_PRIVATE_KEY |
Yes, for write ops |
Wallet private key for on-chain transactions. Without it, the server runs in read-only mode. Use a dedicated hot wallet, not your main wallet. |
TRUTHSEA_NETWORK |
No |
Network to use. Default: base_sepolia |
TRUTH_DAG_ADDRESS |
Yes, for V2 DAG |
TruthDAG contract address. Without it, V2 DAG tools are disabled. |
TRUTH_STAKING_ADDRESS |
Yes, for V2 DAG |
TruthStaking contract address. Required for edge creation and staking. |
Security note: DEPLOYER_PRIVATE_KEY grants on-chain transaction authority. Always use a dedicated hot wallet with minimal funds. The server never transmits or logs this key — it is used only for signing transactions locally.
Tools
Truth Verification (V1)
truthsea_submit_quantum — Submit a new truth quantum with a claim, 4-pillar truth scores, and 8-dimensional moral vector. Requires wallet.
truthsea_verify_quantum — Submit verification scores for an existing quantum. Requires wallet.
truthsea_query — Query and search quanta by discipline, score threshold, or claim text. Read-only.
truthsea_dispute — Challenge a quantum with counter-evidence. Creates a fork and slashes the original host. Requires wallet.
Bounty Bridge (CrowdedSea)
crowdedsea_list_bounties — List bounties filtered by status, discipline, and minimum reward. Read-only.
crowdedsea_claim_bounty — Claim a bounty for investigation. Requires wallet.
Dependency Graph (V2 DAG)
truthsea_create_edge — Create a dependency edge between two quanta. Stakes TRUTH tokens as collateral. Requires wallet + DAG configured.
truthsea_dispute_edge — Challenge a dependency edge. If justified, earn TRUTH from the proposer's slashed stake. Requires wallet.
truthsea_get_chain_score — Get the propagated chain score for a quantum. Shows how dependency strength, contradiction penalties, and weakest links affect the score. Read-only.
truthsea_explore_dag — Navigate the epistemological dependency graph in ancestors, descendants, or both directions via BFS traversal. Read-only.
truthsea_find_weak_links — Find weak foundations in the dependency chain — edges below confidence or score thresholds. Read-only.
truthsea_flag_weak_link — Flag a weak edge for the bounty program. Earn 100 TRUTH if the edge is later invalidated within 30 days. Requires wallet.
Chain Score Formula
chainScore = intrinsicScore * (floor + damping * weakestDepChainScore / 10000) / 10000
Where:
intrinsicScore = weighted average of 4 truth frameworks (30% correspondence, 25% coherence, 25% convergence, 20% pragmatism)
floor = 3000 (0.30 minimum preservation)
damping = 7000 (0.70 attenuation factor)
- Contradiction penalty: -15% per contradicting edge (min 40% preservation)
Scoring System
Truth Frameworks (0-100 each)
- Correspondence — Maps to observable reality
- Coherence — Fits the web of known truths
- Convergence — Independent sources agree over time
- Pragmatism — Works in practice
Moral Vector (-100 to +100 each)
- Care / Harm
- Fairness / Cheating
- Loyalty / Betrayal
- Authority / Subversion
- Sanctity / Degradation
- Liberty / Oppression
- Epistemic Humility / Dogmatism
- Temporal Stewardship / Short-term Extraction
Commands
Truth Verification (V1)
| Command |
Description |
/verify <claim> |
Submit a claim for multi-dimensional truth verification |
/truth query <search> |
Search verified truth quanta |
/dispute <id> <claim> |
Challenge a quantum with counter-evidence |
Dependency Graph (V2)
| Command |
Description |
/edge create <sourceId> <targetId> |
Create a dependency edge between quanta |
/edge dispute <edgeId> |
Challenge an edge — earn TRUTH if justified |
/dag explore <quantumId> |
Navigate the dependency graph |
/dag score <quantumId> |
Get the propagated chain score |
/dag weak-links <quantumId> |
Find weak foundations in the dependency chain |
/dag flag <edgeId> |
Flag a weak edge — earn 100 TRUTH bounty if validated |
Bounties (CrowdedSea)
| Command |
Description |
/bounty list |
List available truth bounties with ETH rewards |
/bounty claim <id> |
Claim a bounty for investigation |
Note: V2 DAG commands require TruthDAG contract address to be configured.
Token Incentives
| Action |
Reward |
| Host a quantum |
100 TRUTH |
| Verify a quantum |
10 TRUTH |
| Create an edge (survives 7 days) |
20 TRUTH |
| Trigger score propagation |
2 TRUTH |
| Validated weak-link flag |
100 TRUTH |
| Win edge dispute |
60% of proposer's stake + 20 TRUTH |
Contracts (Base Sepolia)
- TruthToken:
0x18D825cE88089beFC99B0e293f39318D992FA07D
- TruthRegistryV2:
0xbEE32455c12002b32bE654c8E70E876Fd557d653
- BountyBridge:
0xA255A98F2D497c47a7068c4D1ad1C1968f88E0C5
Security (V2.5)
- ReentrancyGuard on all ETH transfer functions
- Per-era emission caps enforced (halving schedule)
- Slither static analysis with 0 high/critical findings
- API rate limiting, CORS whitelist, CSP headers
Links
1---2name: truthsea3description: Verify claims, build epistemological dependency graphs, and earn TRUTH tokens on Base L2. Security-hardened contracts (V2.5) with ReentrancyGuard, era emission caps, and Slither-audited code.4---5
6
7# TruthSea Verifier
8
9Verify claims, build epistemological dependency graphs, and earn TRUTH tokens on Base L2. Security-hardened contracts (V2.5) with ReentrancyGuard, era emission caps, and Slither-audited code.
10
11**Runs in read-only mode by default.** Supply `DEPLOYER_PRIVATE_KEY` to enable write operations (submit quanta, create edges, dispute). Use a dedicated hot wallet with minimal funds — never your main wallet.
12
13## Setup
14
15This skill requires the `truthsea-mcp-server` MCP server. It will be configured automatically when installed.
16
17### Required Environment Variables
18
19| Variable | Required | Description |
20|----------|----------|-------------|
21| `DEPLOYER_PRIVATE_KEY` | **Yes, for write ops** | Wallet private key for on-chain transactions. Without it, the server runs in **read-only mode**. Use a dedicated hot wallet, not your main wallet. |
22| `TRUTHSEA_NETWORK` | No | Network to use. Default: `base_sepolia` |
23| `TRUTH_DAG_ADDRESS` | **Yes, for V2 DAG** | TruthDAG contract address. Without it, V2 DAG tools are disabled. |
24| `TRUTH_STAKING_ADDRESS` | **Yes, for V2 DAG** | TruthStaking contract address. Required for edge creation and staking. |
25
26> **Security note:** `DEPLOYER_PRIVATE_KEY` grants on-chain transaction authority. Always use a dedicated hot wallet with minimal funds. The server never transmits or logs this key — it is used only for signing transactions locally.
27
28## Tools
29
30### Truth Verification (V1)
31
32- **`truthsea_submit_quantum`** — Submit a new truth quantum with a claim, 4-pillar truth scores, and 8-dimensional moral vector. Requires wallet.
33- **`truthsea_verify_quantum`** — Submit verification scores for an existing quantum. Requires wallet.
34- **`truthsea_query`** — Query and search quanta by discipline, score threshold, or claim text. Read-only.
35- **`truthsea_dispute`** — Challenge a quantum with counter-evidence. Creates a fork and slashes the original host. Requires wallet.
36
37### Bounty Bridge (CrowdedSea)
38
39- **`crowdedsea_list_bounties`** — List bounties filtered by status, discipline, and minimum reward. Read-only.
40- **`crowdedsea_claim_bounty`** — Claim a bounty for investigation. Requires wallet.
41
42### Dependency Graph (V2 DAG)
43
44- **`truthsea_create_edge`** — Create a dependency edge between two quanta. Stakes TRUTH tokens as collateral. Requires wallet + DAG configured.
45- **`truthsea_dispute_edge`** — Challenge a dependency edge. If justified, earn TRUTH from the proposer's slashed stake. Requires wallet.
46- **`truthsea_get_chain_score`** — Get the propagated chain score for a quantum. Shows how dependency strength, contradiction penalties, and weakest links affect the score. Read-only.
47- **`truthsea_explore_dag`** — Navigate the epistemological dependency graph in ancestors, descendants, or both directions via BFS traversal. Read-only.
48- **`truthsea_find_weak_links`** — Find weak foundations in the dependency chain — edges below confidence or score thresholds. Read-only.
49- **`truthsea_flag_weak_link`** — Flag a weak edge for the bounty program. Earn 100 TRUTH if the edge is later invalidated within 30 days. Requires wallet.
50
51### Chain Score Formula
52
53```
54chainScore = intrinsicScore * (floor + damping * weakestDepChainScore / 10000) / 10000
55```
56
57Where:
58- `intrinsicScore` = weighted average of 4 truth frameworks (30% correspondence, 25% coherence, 25% convergence, 20% pragmatism)
59- `floor` = 3000 (0.30 minimum preservation)
60- `damping` = 7000 (0.70 attenuation factor)
61- Contradiction penalty: -15% per contradicting edge (min 40% preservation)
62
63## Scoring System
64
65### Truth Frameworks (0-100 each)
66
671. **Correspondence** — Maps to observable reality
682. **Coherence** — Fits the web of known truths
693. **Convergence** — Independent sources agree over time
704. **Pragmatism** — Works in practice
71
72### Moral Vector (-100 to +100 each)
73
741. **Care** / Harm
752. **Fairness** / Cheating
763. **Loyalty** / Betrayal
774. **Authority** / Subversion
785. **Sanctity** / Degradation
796. **Liberty** / Oppression
807. **Epistemic Humility** / Dogmatism
818. **Temporal Stewardship** / Short-term Extraction
82
83## Commands
84
85### Truth Verification (V1)
86
87| Command | Description |
88|---------|-------------|
89| `/verify <claim>` | Submit a claim for multi-dimensional truth verification |
90| `/truth query <search>` | Search verified truth quanta |
91| `/dispute <id> <claim>` | Challenge a quantum with counter-evidence |
92
93### Dependency Graph (V2)
94
95| Command | Description |
96|---------|-------------|
97| `/edge create <sourceId> <targetId>` | Create a dependency edge between quanta |
98| `/edge dispute <edgeId>` | Challenge an edge — earn TRUTH if justified |
99| `/dag explore <quantumId>` | Navigate the dependency graph |
100| `/dag score <quantumId>` | Get the propagated chain score |
101| `/dag weak-links <quantumId>` | Find weak foundations in the dependency chain |
102| `/dag flag <edgeId>` | Flag a weak edge — earn 100 TRUTH bounty if validated |
103
104### Bounties (CrowdedSea)
105
106| Command | Description |
107|---------|-------------|
108| `/bounty list` | List available truth bounties with ETH rewards |
109| `/bounty claim <id>` | Claim a bounty for investigation |
110
111> **Note:** V2 DAG commands require TruthDAG contract address to be configured.
112
113## Token Incentives
114
115| Action | Reward |
116|--------|--------|
117| Host a quantum | 100 TRUTH |
118| Verify a quantum | 10 TRUTH |
119| Create an edge (survives 7 days) | 20 TRUTH |
120| Trigger score propagation | 2 TRUTH |
121| Validated weak-link flag | 100 TRUTH |
122| Win edge dispute | 60% of proposer's stake + 20 TRUTH |
123
124## Contracts (Base Sepolia)
125
126- **TruthToken**: `0x18D825cE88089beFC99B0e293f39318D992FA07D`
127- **TruthRegistryV2**: `0xbEE32455c12002b32bE654c8E70E876Fd557d653`
128- **BountyBridge**: `0xA255A98F2D497c47a7068c4D1ad1C1968f88E0C5`
129
130## Security (V2.5)
131
132- ReentrancyGuard on all ETH transfer functions
133- Per-era emission caps enforced (halving schedule)
134- Slither static analysis with 0 high/critical findings
135- API rate limiting, CORS whitelist, CSP headers
136
137## Links
138
139- [GitHub](https://github.com/turfptax/TruthSea)
140- [Website](https://truthsea.io)
141- [API Docs](https://truthsea.io/api/v1)
142- [Contracts on Basescan](https://sepolia.basescan.org/address/0xbEE32455c12002b32bE654c8E70E876Fd557d653)