https://github.com/ora-io/zkKYC-story-hackathon

KYC with zkOracle and Story Protocol Hooks
https://github.com/ora-io/zkKYC-story-hackathon

Last synced: 2 months ago
JSON representation

KYC with zkOracle and Story Protocol Hooks

• Host: GitHub
• URL: https://github.com/ora-io/zkKYC-story-hackathon
• Owner: ora-io
• Created: 2023-12-10T00:35:54.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-10T20:32:10.000Z (about 1 year ago)
• Last Synced: 2024-08-02T13:29:25.710Z (5 months ago)
• Language: Solidity
• Size: 367 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ora - zkKYC - based hook that brings offchain kyc data to onchain Story Protocol. This project was [developed during Story Protocol Alpha Hackathon and won second place](https://twitter.com/StoryProtocol/status/1734259414591512932). (🔮 ZK Oracle Ecosystem / General)

README

        
# zkKYC with zkOracle and Story Protocol Hook

> This project was built during [Story Protocol Alpha Hackathon](https://twitter.com/StoryProtocol/status/1724821270968307989).

zkKYC enables KYC verification for Story Protocol using zkOracle and Story Protocol hook.

Currently, zkKYC supports integration of CEX KYC status with Story Protocol.

## Why?

- **Connects Offchain Data with Onchain Story Protocol**

- **Decentralized**: KYCHook allows users to be KYCed without relying on a centralized admin, and users can permissionlessly submit their own KYC proofs.

- **Trustless**: KYCHook verifies the zk proof of KYC status onchain, so Story Protocol IPOrg can trust the KYC status without trusting any third party.

- **Privacy**: zkKYC only proves a user is KYCed without revealing any of their information.

## Usage

- Compliance for mass adoption and regulation

- Configuration for different countries IP related policies

- Can be extended to other offchain data sources (eg. geo location, age, etc.)

## Architecture

zkKYC consists of 2 parts: zkOracle (generates zkp of user KYC status) and KYCHook (integrates Story Protocol with zkOracle).

![Architecture](./architecture.png)

Components:

- [zkOracle](zkoracle/README.md): Generates zk proofs of KYC status.

- [KYCHook](story-hook/README.md): Story Protocol hook that checks if a user is KYCed by verifying the zk proof.

## Future Steps

- Customized KYC status: add different KYC related data such as country-specific KYC status, KYC completion date, etc.

- Async Hook: use async hook to let user go through the complete KYC process for different IPOrg.