{"id":28759871,"url":"https://github.com/subsquid/yellowstone-geyser-proxy","last_synced_at":"2025-06-17T05:32:15.707Z","repository":{"id":290622969,"uuid":"972849420","full_name":"subsquid/yellowstone-geyser-proxy","owner":"subsquid","description":"JSON-RPC proxy for Yellowstone gRPC Geyser plugin","archived":false,"fork":false,"pushed_at":"2025-06-01T12:28:29.000Z","size":100,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-01T21:28:20.313Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/subsquid.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-04-25T19:11:44.000Z","updated_at":"2025-06-01T12:28:32.000Z","dependencies_parsed_at":"2025-05-21T14:45:39.652Z","dependency_job_id":"20839c90-e684-4c87-8ab6-477c37b67199","html_url":"https://github.com/subsquid/yellowstone-geyser-proxy","commit_stats":null,"previous_names":["subsquid/yellowstone-geyser-proxy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/subsquid/yellowstone-geyser-proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fyellowstone-geyser-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fyellowstone-geyser-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fyellowstone-geyser-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fyellowstone-geyser-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subsquid","download_url":"https://codeload.github.com/subsquid/yellowstone-geyser-proxy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fyellowstone-geyser-proxy/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260298344,"owners_count":22988400,"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","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":"2025-06-17T05:30:30.079Z","updated_at":"2025-06-17T05:32:15.678Z","avatar_url":"https://github.com/subsquid.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# yellowstone-geyser-proxy\n\n`sqd-yellowstone-geyser-proxy(1)` allows to receive new Solana blocks via JavaScript friendly [JSON-RPC websocket subscription](https://geth.ethereum.org/docs/interacting-with-geth/rpc/pubsub). \n\nIt works as a proxy for [Yellowstone gRPC Geyser plugin](https://github.com/rpcpool/yellowstone-grpc).\n\nAt SQD, we use it as a temporary workaround before we migrate our entire data ingestion stack from JavaScript to Rust.\n\n## Why not to use gRPC directly?\n\n* Yellowstone gRPC delivers account ids in a binary form, \nbut you want base58 encodings most of the time. Base58 encodings are too expensive to produce on JS side.\n* Yellowstone gRPC whole block subscription does not allow to exclude vote transactions.\n* JavaScript gRPC stack is heavy and ugly.\n\n## Usage\n\nOnly single subscription kind is supported, that delivers the whole block data.\n\n* `geyser_blockSubscribe` - subscription method (no parameters)\n* `geyser_blockNotification` - data message\n* `geyser_blockUnsubscribe` - subscription cancellation.\n\nFormat of the data message is `{\"slot\": \u003cnumber\u003e, \"block\": \u003cGetBlock\u003e}`,\nwhere `GetBlock` is akin to [getBlock result](https://solana.com/ru/docs/rpc/http/getblock) except:\n\n* Each transaction is annotated with additional `_index` property to identify \nits original position within a block (in case vote transactions where excluded).\n* All integer fields, that can potentially overflow JavaScript safe integer are replaced with number strings.\n\n## Setup\n\n```\nUsage: sqd-yellowstone-geyser-proxy [OPTIONS] --geyser-url \u003cURL\u003e\n\nOptions:\n      --geyser-url \u003cURL\u003e               Yellowstone gRPC service\n      --geyser-x-token \u003cTOKEN\u003e         add X-Token header to gRPC requests\n      --geyser-x-access-token \u003cTOKEN\u003e  add X-Access-Token header to gRPC requests\n      --with-votes                     disable removal of vote transactions\n      --port \u003cPORT\u003e                    [default: 3000]\n      --mapping-threads \u003cN\u003e            number of threads to use for data transformation\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubsquid%2Fyellowstone-geyser-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubsquid%2Fyellowstone-geyser-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubsquid%2Fyellowstone-geyser-proxy/lists"}