https://github.com/skaaalper/zkverify-relayer
https://github.com/skaaalper/zkverify-relayer
airdrop airdrops-farming groth16 relayer zkverify
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/skaaalper/zkverify-relayer
- Owner: SKaaalper
- Created: 2025-06-19T10:53:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-08T06:57:50.000Z (12 months ago)
- Last Synced: 2025-10-07T00:44:08.641Z (9 months ago)
- Topics: airdrop, airdrops-farming, groth16, relayer, zkverify
- Language: Shell
- Homepage:
- Size: 44.9 KB
- Stars: 5
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# zkVerify Groth16 Proof Submission Guide
**100% working tutorial for generating, proving, and submitting ZK proofs to zkVerify using Circom, SnarkJS, and the Relayer API**
🏆 **zkVerify ProofPoints is LIVE**!
**Track your progress, climb the leaderboard, and earn your spot in ZK history**.
📍 **Register to start earning points**:
- Go to: [https://points.zkverify.io/](https://points.zkverify.io/loyalty?referral_code=VORW83R9)
- Complete Social task
- Connect Gmail
- Connect the same EVM wallet you used with Galxe
- Do daily Check in
- Connect Discord
- Connect Telegram
### This task is part of the `Technical Challenges` 🛠️
- Rewards: **620** Zk Points
🔐 **You Need an API Key Before Running**
The zkVerify Relayer API Key is not public and not included in the Swagger documentation. You must manually request it from the Horizen Labs team.
📝 **How to get your API key**:
1. Join their Discord:
- Go to: https://discord.gg/XBcpATZtM4
2. Open a support ticket:
- Go to the `#ticket-support` channel and **create a new ticket**
- Request access to the **zkVerify Relayer API Key**
⚠️ You won't be able to use the script without a valid API key.
### Prerequisites (Handled by Script):
- Install all required dependencies
- Compile your Circom circuit
- Generate the Groth16 proof
- Submit it to zkVerify via the Relayer API Key from [zkVerify Docs](https://docs.zkverify.io/relayer-api/api-key)
## Installation & Setup:
### 1. You can use [GitHub Codespaces](https://github.com/codespaces) to run this command or use VPS server.
### 2. One-Click Command to Run the Full Setup:
```
cd ~ && \
rm -rf zkverify-relayer && \
git clone https://github.com/SKaaalper/zkverify-relayer.git && \
cd zkverify-relayer && \
chmod +x zkverify-groth16.sh && \
./zkverify-groth16.sh
```
- Paste your `API KEY` and wait to finish
### 3. Claim Your Points:
- Go to: [https://docs.google.com/forms/d/e/1FAIpQLSe-oZe](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform)
- Fill `Job-ID` , `txn Hash` , `Your Wallet Address` , `Your Email` and most importantly, give them feedback to receive additional rewards.
### 📈 Volume-Based Rewards:
| Total Proofs Submitted | Bonus Points |
| ---------------------- | ------------ |
| 100 | 50 |
| 250 | 100 |
| 500 | 200 |
| 1000+ | 500 🚀 |
⏫ **The more proofs you submit, the more bonus points you earn.**
### 4. Deploy More Proof:
```
cd zkverify-relayer
./zkverify-groth16.sh
```
### Provide Feedback on the Relayer:
- Complete the Relayer [Feedback Form](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform): `50 points`
- Report an unknown bug (include sufficient details and screenshots): `+50 points`
### How to Claim Points:
- Fill out the [submission form](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform)
- Provide your `EVM wallet address` and the `Job ID` or `transaction hash` for the proof you submitted via the Relayer
- The zkVerify team will verify your submission and assign points accordingly
### Summary (TL;DR):
✅ Submit different proof types = +20 each
📈 **Submit a lot of proofs = bonus points (100 = +50, 1000+ = +500)**
🔑 **Use API key (public or private)**
📝 **Fill out the form with Job ID / wallet**
💡 **Add feedback or bug reports for more points**
**Want more airdrop grinds? Join my [Telegram](https://t.me/KatayanAirdropGnC)**
