Skip to content

IdentiFI-Protocol/identifi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

IdentiFI Protocol

The Stateless Cryptographic Engine for Zero-Knowledge Possession Validation

Rust WebAssembly ZK-SNARK EVM

"IT'S NOT A WALLET — IT'S A SIGNAL OF POWER."


Table of Contents


Abstract

IdentiFI is a Stateless Possession Validation Protocol — a sovereign cryptographic engine that enables operators to prove unified control over a cluster of EVM wallets without exposing private keys, linking addresses on public blockchain explorers, or relying on any centralized database.

The protocol operates entirely in volatile memory via client-side WebAssembly (compiled from native Rust). Every session terminates with a full cryptographic purge. What remains is only the mathematical proof of authorized cluster membership — nothing else.

By utilizing a high-performance Groth16 ZK-SNARK circuit powered by the arkworks ecosystem, IdentiFI removes the need for centralized identity providers, off-chain registries, or on-chain linkages. Verification is instant, private, and local.


The Problem

Existing identity and wallet association models in Web3 operate under a fundamental security vulnerability:

Constraint Status Quo IdentiFI Resolution
Multi-Wallet Ownership Public on-chain transactions or centralized databases link clusters Zero public linkage. Cluster membership proven via ZK-SNARKs
Session Persistence Persistent cookies, local storage, or JWTs expose wallet graphs Volatile memory only. Irreversible purge upon session exit
Authority Verification Trust-based or server-dependent validation Client-side, locally forged zero-knowledge proofs
Data Sovereignty Custodial indexing makes investors public targets Selective transparency. The operator holds the only keys to disclosure

IdentiFI does not bridge or log identities. It proves possession mathematically and vanishes.


The SKINWALKER Paradigm

The core design philosophy of IdentiFI is the SKINWALKER Protocol: the absolute separation of asset ownership from the operator's active identity.

  • Dynamic Identity Rotation: The user binds a master wallet to a set of sub-wallets (Strands). The operator can execute actions using any sub-wallet, proving they belong to an authorized cluster without exposing the master wallet or any sister wallet.
  • Immediate Immunity (The Reset): If a sub-wallet is monitored or compromised, the user simply transfers funds, rotates keys locally, and generates a new cryptographic signal. The previous link is instantly severed, leaving zero historical trace of association.
  • Selective Transparency: Visualizations and data linkages remain in the possession of the operator. Third parties and auditors only receive a binary validation output: TRUE or FALSE.

Core ZK-Engine Architecture

The engine shifts validation from legacy symmetric obfuscation to local zero-knowledge mathematical constraints.

graph TB
    subgraph CLIENT ["CLIENT-SIDE (Browser / WASM Runtime)"]
        direction TB
        A["Master Wallet & Strands<br/><i>Private Witness Inputs</i>"] --> B["Merkle Tree Generation<br/><i>Poseidon Hash Circuit</i>"]
        B --> C["arkworks Prover Engine<br/><i>Groth16 ZK Proving</i>"]
        C --> D["ZK-Proof Payload<br/><i>Opaque Elliptic Curve Points</i>"]
    end

    subgraph AUDITOR ["SDK AUDITOR (Local Verification)"]
        direction TB
        E["Public Constraints<br/><i>iat, exp, active address</i>"] --> F["ark-groth16 Verifier<br/><i>Sub-millisecond verification</i>"]
        D --> F
        F --> G["Audit Result<br/><i>Boolean (TRUE / FALSE)</i>"]
    end

    D -->|"Stateless Delivery"| F

    style CLIENT fill:#0a0a0a,stroke:#00d9ff,stroke-width:2px,color:#e0e0e0
    style AUDITOR fill:#0a0a0a,stroke:#00ffaa,stroke-width:2px,color:#e0e0e0
    style A fill:#111,stroke:#00d9ff,color:#fff
    style B fill:#111,stroke:#00d9ff,color:#fff
    style C fill:#111,stroke:#00d9ff,color:#fff
    style D fill:#111,stroke:#00ffaa,color:#fff
    style E fill:#111,stroke:#00ffaa,color:#fff
    style F fill:#111,stroke:#00ffaa,color:#fff
    style G fill:#111,stroke:#00ffaa,color:#fff
Loading

Circuit Constraint Schema

The cryptographic circuit enforces validation by dividing parameters strictly into private witnesses and public variables:

  • Private Inputs (Witnesses):
    • Master Wallet Address ($m$)
    • List of bound Strand Addresses ($c_1, c_2, ..., c_n$)
    • Elliptic curve signatures validating co-ownership of the cluster nodes
  • Public Inputs (Exposed Variables):
    • Current Active Transaction Address ($a$)
    • Issuance Timestamp ($iat$)
    • Expiry Timestamp ($exp$)
    • Merkle Root of the Cluster ($R$)

Execution Flow

The end-to-end local lifecycle of a zero-knowledge possession proof:

sequenceDiagram
    autonumber
    participant User as Operator (Browser)
    participant Core as X-Core Engine (WASM/Rust)
    participant Memory as Linear WebAssembly Memory
    participant SDK as SDK Auditor (Verifier)

    User->>Core: Supply Master & Strand Credentials
    Note over Core,Memory: Build local Merkle Tree & Witness
    Core->>Core: Compute Groth16 Prover (arkworks)
    Core->>User: Export Opaque Proof & Public Inputs
    Note over Core,Memory: THE PURGE — All plaintext credentials zeroized
    User->>SDK: Submit Proof & Public Constraints
    SDK->>SDK: Evaluate Groth16 Verifier (sub-25ms)
    SDK-->>User: Return Verification Result (TRUE/FALSE)
Loading

The Purge Principle: Immediately following proof generation, the WASM memory space executes aggressive clearing routines (zeroize). Buffers, temporary signatures, and plaintext wallet addresses are irreversibly wiped using unsafe Rust operations to prevent V8 engine memory dumps.


SDK & Auditor Integration

The IdentiFI SDK is designed to run natively in TypeScript environments, serving as a wrapper around the compiled WASM binary.

Key API Layout

  • Prover Interface:
    • generate_possession_proof(private_inputs, public_inputs) -> Promise<ZkProofPayload>
    • Executes local Merkle tree structuring, Poseidon hashing, and Groth16 proving.
  • Auditor Interface:
    • verify_possession_proof(proof, public_inputs) -> boolean
    • Validates that the mathematical proof matches the public parameters and the commitment root.

Performance Benchmarks

Execution performance measured on client-side environments (running the native WASM engine locally):

1. Generating Merkle Tree (local)...
   Merkle root: 0x0b015d3771810ae636b73f3e9d77e062cc92ffb881666aaf68fffffce596bc81
   -> Merkle Tree Compute: 98.133ms

2. Generating ZK Proof (Client-side WASM)...
   Proof cryptographically computed successfully!
   -> Prover Execution (Groth16): 7.082s

3. Auditing Proof Verification (SDK Verifier)...
   ✅ SUCCESS: Proof 100% Valid in the Groth16 Circuit!
   -> Verification Time: 22.177ms

------------------------------------
Total cycle time: 7.228s

Security & Memory Model

IdentiFI's security guarantees are enforced at the architectural level:

  • Sandbox Isolation: The Rust engine compiles to a standard WebAssembly target, executing strictly within the browser's WASM sandbox. It has zero DOM access and makes no network calls.
  • Cryptographic Commitment: No raw wallet lists are exported. The outer environment only sees the Merkle root ($R$) and the cryptographic proof.
  • Prover-Verifier Asymmetry: Proving is computationally intensive (~7s client-side) to secure the witness. Verification is lightweight (~22ms), allowing seamless integration into high-throughput SDK auditing clients.

System Requirements

Tool Minimum Version Purpose
Node.js 18+ SDK execution and test orchestration
Rust 1.75+ ZK circuit compilation
wasm-pack Latest WebAssembly generation

License & Intellectual Property

IdentiFI Protocol is proprietary software. All source code, compiled WASM binaries, cryptographic circuits, and architectural blueprints are the exclusive property of the IdentiFI engineering team.

  • Source Code: Unauthorized redistribution, modification, or copying is strictly prohibited.
  • WASM Binaries: Sealed execution units. Reverse engineering or binary decompilation is prohibited.


IdentiFI Protocol
The Stateless ZK-Engine for Possession Validation

Status: OPERATIONAL  |  Engine: ZK-Core (Rust/WASM)  |  Compliance: 100% Stateless

© 2026 IdentiFI Protocol — All Rights Reserved.

About

🛡️ The IdentiFI Protocol: Decentralized, privacy-preserving authority layer for Web3. Orchestrating client-side ZK-SNARKs and local identity clusters.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors