{"id":24674102,"url":"https://github.com/jabolol/hawk","last_synced_at":"2026-05-19T09:35:45.501Z","repository":{"id":203395963,"uuid":"709216586","full_name":"Jabolol/hawk","owner":"Jabolol","description":"Telegram XDC utilities bot built at European Blockchain Convention 2023","archived":false,"fork":false,"pushed_at":"2023-10-26T05:16:12.000Z","size":7868,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T11:15:01.455Z","etag":null,"topics":["deno","telegram","typescript","xdc"],"latest_commit_sha":null,"homepage":"https://hawk.deno.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jabolol.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}},"created_at":"2023-10-24T09:06:11.000Z","updated_at":"2023-12-18T16:31:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"f99bb383-1b55-4cad-bb9c-8a633dd4c145","html_url":"https://github.com/Jabolol/hawk","commit_stats":null,"previous_names":["jabolol/hawk"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jabolol%2Fhawk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jabolol%2Fhawk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jabolol%2Fhawk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jabolol%2Fhawk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jabolol","download_url":"https://codeload.github.com/Jabolol/hawk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244825380,"owners_count":20516589,"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":["deno","telegram","typescript","xdc"],"created_at":"2025-01-26T11:15:07.462Z","updated_at":"2026-05-19T09:35:45.454Z","avatar_url":"https://github.com/Jabolol.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](./assets/banner.png)\n\n# hawk\n\n**Hawk** is a multi-purpose Telegram crypto bot. Its main purpose is to provide\na simple way to get crypto prices and charts on Telegram, as well as to manage\ndifferent statistics and alerts on the [`XDC`](https://xdc.network/) network.\n\nYou can invite **hawk** by clicking [here](https://t.me/xdc_hawk_bot) and enjoy\nthe following features:\n\n- Employ the NFT `viewer` feature for an instant NFT preview right.\n- Seamlessly export blockchain `blocks` to the pastebin.\n- Access real-time statistics on trading prices with the `spot` trading feature.\n- Delve into comprehensive `details` and perform lookups for XDC tokens.\n- Instantly retrieve address details and check the `balance`.\n\nIt is built with [Deno](https://deno.land/) and\n[Cloudflare Workers](https://workers.cloudflare.com/). It is also powered by\n[Telegram](https://telegram.org/) and [XinFin](https://xinfin.org/).\n\n## index\n\n- [commands](#commands)\n- [features](#features)\n- [setup](#setup)\n- [contributing](#contributing)\n- [license](#license)\n\n## commands\n\n### start\n\n```sh\n/start\n```\n\nShows the welcome message. This message includes a brief description of the bot\nand a link to the source code. It also includes the technology stack used to\nbuild the bot.\n\n![start](./assets/start.png)\n\n### help\n\n```sh\n/help\n```\n\nShows the help message. This message includes a list of all the available\ncommands and a brief description of each one of them.\n\n![help](./assets/help.png)\n\n### nft\n\n```sh\n/nft \u003caddress\u003e \u003cid\u003e\n```\n\nQueries the **XDC** network for the details of a given NFT. It includes a link\nto the NFT on the [XinFin](https://xinfin.org/) explorer, as well as a preview\nof the NFT and miscellaneous details.\n\n![nft](./assets/nft.png)\n\n### dump\n\n```sh\n/dump \u003cfrom_block\u003e \u003cto_block\u003e\n```\n\nAllows the user to dump a range of blocks from the **XDC** network to pastebin.\nThe user can specify the range of blocks to dump, with a maximum of 100 blocks\nper dump.\n\n![dump](./assets/dump.png)\n\n### token\n\n```sh\n/token \u003caddress\u003e\n```\n\nQueries the **XDC** network for the details of a given token. It includes a link\nto the token on the [XinFin](https://xinfin.org/) explorer, as well as a preview\nof the token and miscellaneous details.\n\n![token](./assets/token.png)\n\n### balance\n\n```sh\n/balance \u003caddress\u003e\n```\n\nQueries the **XDC** network for the balance of a given address. It shows details\nof the given address such as the balance, the amount of transactions, and the\ncreation date.\n\n![balance](./assets/balance.png)\n\n### info\n\n```sh\n/info\n```\n\nShows details about the **XDC** network itself. It includes the total supply,\nthe market cap, the current price, and the current circulating supply, as well\nas the fluctuation of the price in the last 24 hours.\n\n![info](./assets/info.png)\n\n### graph\n\n```sh\n/graph\n```\n\nShows real-time statistics about the price of the **XDC** token. It includes the\nlatest `spot` trading price, as well as the range in which people are buying and\nselling the token, to give a lightning-fast overview of the current market\n\n![graph](./assets/graph.png)\n\n## features\n\nThis project was built using a `monadic` architecture. This means that each\nfeature is built as a standalone module, and it can be easily added or removed\nfrom the project. This allows for a high degree of modularity and extensibility.\n\nThe following features are currently available:\n\n- [x] **NFT Viewer**: Allows the user to preview NFTs on Telegram.\n- [x] **Block Dumper**: Allows the user to dump blocks to pastebin.\n- [x] **Token Details**: Allows the user to query the details of a token.\n- [x] **Address Balance**: Allows the user to query the balance of an address.\n- [x] **Spot Trading**: Allows the user to query the spot trading price.\n- [x] **Network Info**: Allows the user to query the network information.\n- [x] **Graph**: Allows the user to query the price graph of the token.\n\nOn top of this, the project has been throughly tested to ensure that the inputs\nare sanitized and that the outputs are properly parsed. This ensures that the\nuser experience is as smooth as possible.\n\nAll commands have several options, and all have been tested to ensure that they\nwork as expected.\n\n![tests](./assets/test.png)\n\n## setup\n\nInstall deno if you haven't already:\n\n```sh\ncurl -fsSL https://deno.land/x/install/install.sh | sh\n```\n\nClone the repo\n\n```sh\ndeno task build\n```\n\nPopulate `wranger.toml` with your Cloudflare credentials\n\n```sh\ncp example.toml wrangler.toml \u0026\u0026 vim wrangler.toml\n```\n\nBuild the project\n\n```sh\ndeno task build\n```\n\nDeploy the project\n\n```sh\ndeno task deploy\n```\n\n## contributing\n\nContributions, issues and feature requests are welcome! Feel free to drop a\nmessage in the issues if you have any doubts or questions.\n\nAll pull requests must follow the\n[conventional commits](https://www.conventionalcommits.org/en/v1.0.0/)\nspecification.\n\nPlease format and lint your code before committing.\n\n```sh\ndeno fmt \u0026\u0026 deno lint\n```\n\n## license\n\nHawk is licensed under the MIT license. See [LICENSE](LICENSE) for more\ninformation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjabolol%2Fhawk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjabolol%2Fhawk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjabolol%2Fhawk/lists"}