SOCIALCAP AI // CORE DOCUMENTATION

import socialcap

# Initialize — token rotates automatically every 90 days
client = socialcap.Client(api_key="sc_live_zk_992f")

# ZK-verified proximity check (no PII disclosed)
matrix = client.vectors.verify_congruence(
    source_node="Sovereign-APAC-01",
    target_node="Sovereign-Nordic-01",
    min_confidence_level=0.95
)

print(f"Alignment Proved : {matrix.is_verified}")   # True
print(f"Confidence Level : {matrix.confidence:.2%}") # 98.42%
print(f"Dunbar Degree    : Ring-{matrix.dunbar_degree}")  # Ring-2
print(f"ZK Merkle Root   : {matrix.merkle_root[:20]}...")

# Stream all APAC hubs above $3T AUM with LIVE or URGENT status
for hub in client.hubs.stream(
    region="APAC",
    min_aum_t_usd=3.0,
    temporal_states=["LIVE", "URGENT"]
):
    print(f"{hub.city:15s}  {hub.aum:8s}  {hub.temporal_state}")

# Designed for LLM tool-use: returns serialisable dict
result = client.graph.shortest_path(
    source="Sovereign-APAC-01",
    target="Sovereign-EU-03",
    max_hops=3,
    verified_only=True          # Only ZK-proven edges
)

# Serialize for GPT-4o / Claude tool_result
print(result.to_json())

# Output:
# {
#   "path_length": 2,
#   "hops": ["SIN", "DXB", "LDN"],
#   "path_aum_total_t_usd": 31.5,
#   "confidence": 0.961
# }

import asyncio, socialcap

async def monitor_aviation():
    async with socialcap.AsyncClient(api_key="sc_live_zk_992f") as client:
        async for event in client.aviation.stream(corridor="ME_APAC"):
            print(f"[{event.timestamp}] {event.route}  {event.status}")
            # [2026-06-07T14:21Z]  DXB → SIN  EN ROUTE

asyncio.run(monitor_aviation())

ER_score(A, B) =
  0.40 × jaro_winkler(name_hash_A, name_hash_B)   // String similarity
+ 0.35 × shared_neighbors(A, B) / max_neighbors    // Graph topology
+ 0.25 × co_event_appearances(A, B) / total_events // Conference co-presence

merge_threshold = 0.88   // Nodes merged when ER_score ≥ 0.88
pii_scrub       = True   // Raw source strings purged post-merge

{
  "node_id": "Sovereign-APAC-01",
  "resolution_confidence": 0.994,
  "source_cluster_count": 3,        // Merged from 3 input domains
  "pii_status": "SCRUBBED",         // Raw strings purged
  "dunbar_ring_1_count": 5,
  "dunbar_ring_2_count": 12,
  "dunbar_ring_3_count": 38,
  "aum_b_usd": 12500,
  "temporal_state": "LIVE",
  "hub_city": "Singapore"           // Non-PII geographic anchor retained
}

                    [ Root R ]                  ← Published on-chain
                   /            \
           [ H(L1∥L2) ]     [ H(L3∥L4) ]
           /        \         /        \
   [L1: SIN→DXB] [L2: DXB→LDN] [L3: Board] [L4: LP-overlap]
   SHA-256 hash  SHA-256 hash   SHA-256     SHA-256

   Proof for L1 = { H(L2), H(L3∥L4) }   // 2 hashes, O(log N)
   Verifier computes: H(H(L1∥L2) ∥ H(L3∥L4)) == R  → VALID

# Verify edge SIN→DXB exists in graph WITHOUT decrypting metadata
proof = client.zkp.verify_edge(
    edge_hash="sha256:3f4a91bc...",   # Hash of the claimed edge
    merkle_root="0x7a91bf32cde8...",  # Published root (on-chain)
    sibling_path=["0x4bc1...", "0x9de3..."]  # Path from API
)

print(f"Proof Valid : {proof.is_valid}")   # True
print(f"Leaf Index  : {proof.leaf_index}") # 0
print(f"Tree Height : {proof.tree_height}")# 18
print(f"PII Exposed : none")               # Zero-knowledge guarantee

External Source Data
        │
        ▼ (client-side, off-chain)
  SHA-256 Hash(entity_alias + jurisdiction_salt)
        │
        ▼
  Hashed Leaf → Merkle Tree Commit
        │  No raw strings cross this boundary
        ▼
  Graph Resolution Engine
        │
        ▼
  Sovereign Node  (PII_STATUS: "SCRUBBED")