{"id":28990542,"url":"https://github.com/skaaalper/zkverify-relayer","last_synced_at":"2025-10-24T10:48:28.319Z","repository":{"id":300005030,"uuid":"1004897623","full_name":"SKaaalper/zkverify-relayer","owner":"SKaaalper","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-08T06:57:50.000Z","size":46,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-07T00:44:08.641Z","etag":null,"topics":["airdrop","airdrops-farming","groth16","relayer","zkverify"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SKaaalper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-19T10:53:23.000Z","updated_at":"2025-07-08T06:57:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"9d95b83a-2139-42be-bd30-7885bb8a5223","html_url":"https://github.com/SKaaalper/zkverify-relayer","commit_stats":null,"previous_names":["skaaalper/zkverify-relayer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SKaaalper/zkverify-relayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SKaaalper%2Fzkverify-relayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SKaaalper%2Fzkverify-relayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SKaaalper%2Fzkverify-relayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SKaaalper%2Fzkverify-relayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SKaaalper","download_url":"https://codeload.github.com/SKaaalper/zkverify-relayer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SKaaalper%2Fzkverify-relayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280783852,"owners_count":26390277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airdrop","airdrops-farming","groth16","relayer","zkverify"],"created_at":"2025-06-25T00:12:00.194Z","updated_at":"2025-10-24T10:48:28.312Z","avatar_url":"https://github.com/SKaaalper.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zkVerify Groth16 Proof Submission Guide\n\n![image](https://github.com/user-attachments/assets/b56d86ce-9a0f-4c2e-93a6-8e7c387ec583)\n\n**100% working tutorial for generating, proving, and submitting ZK proofs to zkVerify using Circom, SnarkJS, and the Relayer API**\n\n🏆 **zkVerify ProofPoints is LIVE**!\n\n**Track your progress, climb the leaderboard, and earn your spot in ZK history**.\n\n📍 **Register to start earning points**:\n- Go to: [https://points.zkverify.io/](https://points.zkverify.io/loyalty?referral_code=VORW83R9)\n  - Complete Social task\n  - Connect Gmail\n  - Connect the same EVM wallet you used with Galxe\n  - Do daily Check in\n  - Connect Discord\n  - Connect Telegram\n\n### This task is part of the `Technical Challenges` 🛠️\n  - Rewards: **620** Zk Points\n\n🔐 **You Need an API Key Before Running**\n\nThe zkVerify Relayer API Key is not public and not included in the Swagger documentation. You must manually request it from the Horizen Labs team.\n\n📝 **How to get your API key**:\n1. Join their Discord:\n  - Go to: https://discord.gg/XBcpATZtM4\n\n2. Open a support ticket:\n  - Go to the `#ticket-support` channel and **create a new ticket**\n  - Request access to the **zkVerify Relayer API Key**\n\n⚠️ You won't be able to use the script without a valid API key.\n\n![image](https://github.com/user-attachments/assets/c5d9c693-e527-4dc1-9348-cb53c1df539d)\n\n### Prerequisites (Handled by Script):\n  - Install all required dependencies\n  - Compile your Circom circuit\n  - Generate the Groth16 proof\n  - Submit it to zkVerify via the Relayer API Key from [zkVerify Docs](https://docs.zkverify.io/relayer-api/api-key)\n\n## Installation \u0026 Setup:\n\n### 1. You can use [GitHub Codespaces](https://github.com/codespaces) to run this command or use VPS server.\n\n![image](https://github.com/user-attachments/assets/176fbecc-1ec1-4a1d-b23a-2f920aadd5b3)\n\n### 2. One-Click Command to Run the Full Setup:\n```\ncd ~ \u0026\u0026 \\\nrm -rf zkverify-relayer \u0026\u0026 \\\ngit clone https://github.com/SKaaalper/zkverify-relayer.git \u0026\u0026 \\\ncd zkverify-relayer \u0026\u0026 \\\nchmod +x zkverify-groth16.sh \u0026\u0026 \\\n./zkverify-groth16.sh\n```\n  - Paste your `API KEY` and wait to finish\n  \n![image](https://github.com/user-attachments/assets/ac609c4a-5e06-46a1-8bd2-3b0649d982c9)\n\n### 3. Claim Your Points:\n  - Go to: [https://docs.google.com/forms/d/e/1FAIpQLSe-oZe](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform)\n  - Fill `Job-ID` , `txn Hash` , `Your Wallet Address` , `Your Email` and most importantly, give them feedback to receive additional rewards.\n\n![image](https://github.com/user-attachments/assets/0b7fbe5c-ce3b-4b49-9353-e97918bd07ad)\n\n### 📈 Volume-Based Rewards:\n\n| Total Proofs Submitted | Bonus Points |\n| ---------------------- | ------------ |\n| 100                    | 50           |\n| 250                    | 100          |\n| 500                    | 200          |\n| 1000+                  | 500 🚀       |\n\n⏫ **The more proofs you submit, the more bonus points you earn.**\n\n### 4. Deploy More Proof:\n```\ncd zkverify-relayer\n./zkverify-groth16.sh\n```\n\n### Provide Feedback on the Relayer:\n- Complete the Relayer [Feedback Form](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform): `50 points`\n- Report an unknown bug (include sufficient details and screenshots): `+50 points`\n\n### How to Claim Points:\n- Fill out the [submission form](https://docs.google.com/forms/d/e/1FAIpQLSe-oZe2r5nSvDIuPQvVKSVSiPofUX9ZnhuuN46MFuI2m4X_2Q/viewform)\n- Provide your `EVM wallet address` and the `Job ID` or `transaction hash` for the proof you submitted via the Relayer\n- The zkVerify team will verify your submission and assign points accordingly\n\n### Summary (TL;DR):\n✅ Submit different proof types = +20 each\n\n📈 **Submit a lot of proofs = bonus points (100 = +50, 1000+ = +500)**\n\n🔑 **Use API key (public or private)**\n\n📝 **Fill out the form with Job ID / wallet**\n\n💡 **Add feedback or bug reports for more points**\n\n**Want more airdrop grinds? Join my [Telegram](https://t.me/KatayanAirdropGnC)**\n\n  \u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://komarev.com/ghpvc/?username=SKaaalper\u0026color=yellow\" alt=\"Profile Views\" /\u003e\n\u003c/p\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskaaalper%2Fzkverify-relayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskaaalper%2Fzkverify-relayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskaaalper%2Fzkverify-relayer/lists"}