Documentation

Everything you need to integrate Genin402 privacy scoring.

# Installation

terminal
pip install genin402

# Quick Start

example.py
from genin402 import PrivacyEngine, ShadowTransfer

engine = PrivacyEngine()

transfer = ShadowTransfer(
    wallet_address="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    transfer_amount_sol=25.0,
    hop_count=7,
    mixer_pools_used=3,
    decoy_tx_count=15,
    payment_gate_active=1,
    route_splits=4,
    time_delay_blocks=35,
    dummy_outputs=7,
    memo_obfuscated=1,
    token_program_obscured=1,
    fee_randomized=1,
)

report = engine.analyze(transfer)
print(report.verdict)        # JONIN
print(report.privacy_score)  # 81.4
print(report.cloak_status)   # dark
print(report.shadows)        # ['multi_hop', 'pool_routed', ...]

# Privacy Scoring

Five metrics. Each scored 0-100. Weighted into a single privacy score.

metrics
stealth_score     ██████░░░░  0.25   shadow pattern depth
route_entropy     ██████░░░░  0.25   hop complexity + split routing
payment_shield    █████░░░░░  0.20   402 gate + mixer pool coverage
trace_resistance  █████░░░░░  0.20   decoy noise + obfuscation layers
shadow_depth      ███░░░░░░░  0.10   layering effectiveness

# Stealth Patterns

10 binary patterns that determine your stealth score.

multi_hophop_count >= 5
pool_routedmixer_pools_used >= 2
decoy_flooddecoy_tx_count >= 10
gate_activepayment_gate_active == 1
split_routeroute_splits >= 3
time_shiftedtime_delay_blocks >= 20
dummy_outputsdummy_outputs >= 5
memo_darkmemo_obfuscated == 1
program_maskedtoken_program_obscured == 1
fee_noisefee_randomized == 1
Back to AppView Examples