{"id":18794451,"url":"https://github.com/chainstacklabs/unstoppable-rpc","last_synced_at":"2025-10-12T17:07:43.627Z","repository":{"id":173092372,"uuid":"650048447","full_name":"chainstacklabs/unstoppable-rpc","owner":"chainstacklabs","description":"ETH Belgrade Hackaton 2023 project","archived":false,"fork":false,"pushed_at":"2024-09-12T18:14:41.000Z","size":742,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-19T07:44:50.630Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/chainstacklabs.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}},"created_at":"2023-06-06T08:16:32.000Z","updated_at":"2024-12-05T18:40:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"b3208eb3-84aa-4208-b4ae-45e1d1147a96","html_url":"https://github.com/chainstacklabs/unstoppable-rpc","commit_stats":null,"previous_names":["chainstacklabs/unstoppable-rpc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chainstacklabs/unstoppable-rpc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Funstoppable-rpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Funstoppable-rpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Funstoppable-rpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Funstoppable-rpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chainstacklabs","download_url":"https://codeload.github.com/chainstacklabs/unstoppable-rpc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainstacklabs%2Funstoppable-rpc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279012177,"owners_count":26085078,"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-12T02:00:06.719Z","response_time":53,"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":[],"created_at":"2024-11-07T21:29:28.154Z","updated_at":"2025-10-12T17:07:43.589Z","avatar_url":"https://github.com/chainstacklabs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eThe Unstoppable RPC Endpoint\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    The Unstoppable RPC Endpoint: Aggregating RPC endpoints for improved availability, low latency, and enhanced security. \n    Open source and accessible to all DApp projects.\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n## Architecture\n\nSolution is based on [Cloudflare Workers](https://workers.cloudflare.com/), using Cloudflare KV Storage plugin and Cloudflare Caching API.\n\n![Architecture](assets/architecture.jpg)\n\n## Getting Started\n\n### Installation\n\n1. Install npm and yarn locally\n2. Create Cloudflare account\n3. Install dependencies\n\n```bash\nyarn install\n```\n\n4. Login into wrangler locally\n\n```bash\nyarn run wrangler login\n```\n\n### Node list configuration\n\n1. Create KV namespace in Cloudflare KV\n\n* for development create preview KV\n\n```shell\nyarn run wrangler kv:namespace create CONFIG_KV --preview\n```\n\n* for production create regular KV\n\n```shell\nyarn run wrangler kv:namespace create CONFIG_KV\n```\n\nadd config from console output into `wrangler.toml` file, example:\n\n* dev:\n```toml\nkv_namespaces = [\n    { binding = \"CONFIG_KV\", preview_id = \"PREVIEW_ID\" }\n]\n```\n\n* prod:\n```toml\nkv_namespaces = [\n    { binding = \"CONFIG_KV\", id = \"ID\" },\n]\n```\n\n2. Prepare node list data with your list of endpoints\n\nExample and structure could be found in [node-config-example.json](node-config-example.json)\n\nTips:\n\n* you can specify coordinates of node to get geo routing benefits and minimize latency\n    * this info could be extracted from IP by external services such [IP Info](https://ipinfo.io/)\n\n3. Enter node list data into created KV namespace\n\n* go to Cloudflare UI -\u003e Workers KV page\n* select your created namespace\n* create new item(entry) into namespace\n    * key - `origins`\n    * value - valid JSON as array, example could be found in [node-config-example.json](node-config-example.json).\n\n### Develop\n\n1. Make sure KV namespace is created and node list is configured\n2. Run web server locally\n\n```shell\nyarn run wrangler dev\n```\n\n### Publish\n\n1. Make sure KV namespace is created and node list is configured\n2. Publish worker code to Cloudflare Workers\n\n```shell\nyarn run wrangler publish\n```\n\n## Acknowledgments\n\nThe project was done for [ETH Belgrade hackathon 2023](https://taikai.network/ethbelgrade/hackathons/hackathon-2023)\n\nTeam members:\n\n* [Vasily Rudomanov](https://www.linkedin.com/in/vrudomanov/)\n* [Andrey Larionov](https://www.linkedin.com/in/alarionov/)\n* [Nikita Iugov](https://www.linkedin.com/in/nikita-yugov/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainstacklabs%2Funstoppable-rpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainstacklabs%2Funstoppable-rpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainstacklabs%2Funstoppable-rpc/lists"}