{"id":18893964,"url":"https://github.com/bard/gs-log","last_synced_at":"2026-02-27T05:30:15.420Z","repository":{"id":212668900,"uuid":"732025855","full_name":"bard/gs-log","owner":"bard","description":"Composable command-line blockchain logger for Gitcoin's Grants Stack","archived":false,"fork":false,"pushed_at":"2023-12-15T23:50:14.000Z","size":442,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-14T03:28:55.145Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://bard.github.io/gitcoin-hackathon-2023-presentation/","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/bard.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-12-15T13:04:04.000Z","updated_at":"2023-12-18T16:23:03.000Z","dependencies_parsed_at":"2023-12-15T14:43:35.686Z","dependency_job_id":"cc063c17-c824-45f4-8fcc-3ac28398b805","html_url":"https://github.com/bard/gs-log","commit_stats":null,"previous_names":["bard/gs-log"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Fgs-log","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Fgs-log/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Fgs-log/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Fgs-log/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bard","download_url":"https://codeload.github.com/bard/gs-log/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239869219,"owners_count":19710485,"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":"2024-11-08T08:17:04.517Z","updated_at":"2026-02-27T05:30:15.364Z","avatar_url":"https://github.com/bard.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gs-log\n\nBlockchain event logger for [Allo (v1)](https://github.com/gitcoinco/grants-stack-allo-contracts-v1) contracts. Built for Gitcoin's December 2023 hackathon ([presentation](https://github.com/bard/gitcoin-hackathon-2023-presentation)). Companion to [gs-index](https://github.com/bard/gs-index).\n\n## Features\n\n- outputs events as JSON lines to stdout for easy composition: save to file, send to network, pipe into [gs-index](https://github.com/bard/gs-index), etc.\n- one-shot or continuous operation\n- watch multiple chains with independent ranges\n- resumable: just feed it a past log to pick up from where it stopped\n\n## Installation\n\n```sh\n$ npm i -g https://github.com/bard/gs-log\n```\n\n## Examples\n\nLog events on PGN testnet from origin to current block:\n\n```sh\n$ gs-log --chains 58008:origin..last\n```\n\nSame, but keep watching for new events after reaching current block:\n\n```sh\n$ gs-log --chains 58008:origin..ongoing\n```\n\nSame, but for Ethereum and Optimism at the same time:\n\n```sh\n$ gs-log --chains 1:origin..ongoing,10:origin..ongoing\n```\n\nLog events from origin, manually interrupt, and pick up from it left, while keeping a log:\n\n```sh\n$ gs-log --chains 58008:origin..ongoing | tee event_log.ndjson\n# ...\n^C\n# ...later...\n$ cat event_log.ndjson | gs-log --resume | tee -a event_log.ndjson\n```\n\nLog events, process them with [gs-index](https://github.com/bard/gs-index), and save them to Postgres:\n\n```sh\n$ gs-log --chains 58008:origin..ongoing | gs-index | psql mydb\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbard%2Fgs-log","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbard%2Fgs-log","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbard%2Fgs-log/lists"}