{"id":13338201,"url":"https://github.com/TegroTON/TON-token-Rest-API","last_synced_at":"2025-03-11T08:32:38.454Z","repository":{"id":166120765,"uuid":"641523656","full_name":"TegroTON/TON-token-Rest-API","owner":"TegroTON","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-29T02:31:48.000Z","size":32,"stargazers_count":5,"open_issues_count":8,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T16:09:40.270Z","etag":null,"topics":["api","rest-api","tegro","token","ton","web3"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TegroTON.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"github":"TegroTON","patreon":"gusev","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"TON","issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-05-16T16:42:26.000Z","updated_at":"2023-10-09T10:40:25.000Z","dependencies_parsed_at":"2024-03-29T03:28:53.917Z","dependency_job_id":"03dc1e77-9e90-49c0-95fb-ba74c8c16ddc","html_url":"https://github.com/TegroTON/TON-token-Rest-API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TegroTON%2FTON-token-Rest-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TegroTON%2FTON-token-Rest-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TegroTON%2FTON-token-Rest-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TegroTON%2FTON-token-Rest-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TegroTON","download_url":"https://codeload.github.com/TegroTON/TON-token-Rest-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243001002,"owners_count":20219788,"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":["api","rest-api","tegro","token","ton","web3"],"created_at":"2024-07-29T19:15:37.308Z","updated_at":"2025-03-11T08:32:38.119Z","avatar_url":"https://github.com/TegroTON.png","language":"JavaScript","funding_links":["https://github.com/sponsors/TegroTON","https://patreon.com/gusev","https://liberapay.com/TON"],"categories":[],"sub_categories":[],"readme":"\u003cbr/\u003e\n\u003cp align=\"center\"\u003e\n  \u003ch3 align=\"center\"\u003eTON Jetton — Rest API Open-Source\u003c/h3\u003e\n  \u003cp align=\"center\"\u003e\n    An efficient and straightforward solution for interacting with the TON Blockchain\n    \u003cbr/\u003e\n    \u003cbr/\u003e\n    \u003ca href=\"https://github.com/ShaanCoding/ReadME-Generator/issues\"\u003eReport Bug\u003c/a\u003e\n    .\n    \u003ca href=\"https://github.com/ShaanCoding/ReadME-Generator/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n![Downloads](https://img.shields.io/github/downloads/ShaanCoding/ReadME-Generator/total) ![Contributors](https://img.shields.io/github/contributors/ShaanCoding/ReadME-Generator?color=dark-green) ![License](https://img.shields.io/github/license/ShaanCoding/ReadME-Generator) \n\n## Table Of Contents\n\n* [About the Project](#about-the-project)\n* [Built With](#built-with)\n* [Getting Started](#getting-started)\n  * [Prerequisites](#prerequisites)\n  * [Installation](#installation)\n* [Expanded Usage Instructions](#expanded-usage-instructions)\n* [Enhanced Contribution Guidelines](#enhanced-contribution-guidelines)\n* [Licensing Details](#licensing-details)\n* [Acknowledgements](#acknowledgements-the-authors)\n\n## About The Project\n\nThis project emerged from the need for a reliable and efficient way to interface with the TON Network, managing balances, payments, and transactions of TON coins and TGR tokens. It provides a user-friendly PHP interface for setting up wallet creation, balance checking, payment sending, and viewing transaction statistics.\n\n## Built With\n\nThe project comprises a docker container developed in .JS, which interfaces with the TON network's jsonRPC. The user interface is built using PHP for ease of use and accessibility.\n\n## Getting Started\n\nEnsure your docker version is up to date:\n```sh\ndocker -v\n```\nExample output:\nDocker version 23.0.6, build ef23cbc\n\n## Prerequisites\n\nDocker installed on the server.\nOpen the necessary port in iptables, e.g., 5885.\n\n## Installation\n1. Obtain an API Key from http://toncenter.com/api or set up your own ton-http API.\n\n2. Set up the ton-server:\n\n- Upload ton-server to your server.\n- Navigate to the ton-server folder:\n\nGo to the ton-server folder:\n```sh\ncd ton-server\n```\nBuild and run docker:\n```sh\ndocker build -t ton-server .\n```\n```sh\ndocker run -d -p 127.0.0.1:5881:80 ton-server\n```\n\n3. Install ton-http-api if you don't want to use https://toncenter.com/:\n```sh\nchmod +x /usr/local/bin/docker-compose\n```\n```sh\ngit clone https://github.com/toncenter/ton-http-api\n```\n```sh\ncd ton-http-api/\n```\n```sh\nmkdir private\n```\n```sh\ncurl -sL https://ton-blockchain.github.io/global.config.json \u003e private/mainnet.json\n```\n```sh\n./configure.py\n```\n4. Open .env and change the TON_API_HTTP_PORT port to any free port, for example 5885.\n\n5. If you do not have docker-compose installed, you can do it with the command below:\n```sh\ncurl -L \"https://github.com/docker/compose/releases/download/v2.6.0/docker-compose-$(uname -s)-$(uname -m)\" -o /usr/local/bin/docker-compose\n```\n\n```sh\ndocker-compose build\n```\n```sh\ndocker-compose up -d\n```\n## Expanded Usage Instructions\n\n1. **Editing the PHP Script:**\n   - Locate the `php/index.php` file in your project directory.\n   - Update the following configurations:\n     a) Insert your API Key for the TON API service at https://toncenter.com/api/v2/jsonRPC. Alternatively, if you are using a custom ton-http API, modify the host details accordingly.\n     b) Identify the section in the script where actions are defined. Uncomment the lines corresponding to the actions you want to perform (e.g., wallet creation, balance inquiry). Ensure you input the correct parameters in these lines for accurate functioning.\n\n2. **Deploying the Script:**\n   - Once the `php/index.php` file is configured, prepare to upload it to your server.\n   - Transfer the entire \"php\" folder to a directory on your server that is accessible via the web. This ensures that the script can be executed through a web interface.\n\n3. **Running the Script:**\n   - After uploading, navigate to the location of the `index.php` file through your web browser.\n   - Execute the script by accessing its URL. The script will interact with the TON Blockchain as per the configured actions and parameters.\n\n## Enhanced Contribution Guidelines\n\nContributions are a vital part of the open-source community, fostering learning, inspiration, and creativity. Here's how you can contribute:\n\n* **Suggesting Changes:**\n  - If you have ideas for improvements or notice any issues, please feel free to [open an issue](https://github.com/ShaanCoding/ReadME-Generator/issues/new) on our GitHub repository. This could include adding new features or removing existing ones.\n  - When suggesting changes, please be clear and concise in your descriptions to facilitate understanding and implementation.\n\n* **Before Contributing:**\n  - Ensure your contributions are well-considered and carefully planned.\n  - Pay attention to spelling and grammar in your contributions to maintain the quality of documentation.\n  - For each suggestion or improvement, create a separate pull request (PR). This helps in better tracking and managing changes.\n\n* **Adhering to Conduct:**\n  - Before you submit your first contribution, please read through our [Code Of Conduct](https://github.com/ShaanCoding/ReadME-Generator/blob/main/CODE_OF_CONDUCT.md). This ensures a respectful and collaborative environment for all contributors.\n\n### Step-by-Step Guide for Pull Requests\n\n1. **Forking the Project:**\n   - Begin by forking the repository. This creates a copy of the project in your GitHub account, allowing you to make changes without affecting the original.\n\n2. **Creating a Feature Branch:**\n   - In your forked repository, create a new branch for your feature or fix. Use the command: `git checkout -b feature/AmazingFeature` (replace 'AmazingFeature' with a descriptive name for your feature).\n\n3. **Committing Changes:**\n   - Make your changes in the new branch and commit them with a clear and descriptive message, using: `git commit -m 'Add some AmazingFeature'`.\n\n4. **Pushing to GitHub:**\n   - Push the changes to your GitHub repository using: `git push origin feature/AmazingFeature`. \n\n5. **Opening a Pull Request:**\n\n   - Once your feature is ready and pushed to GitHub, navigate to the original repository you forked.\n   - Click on the 'Pull Request' button and then on 'New Pull Request'.\n   - Select your 'feature/AmazingFeature' branch and provide a detailed description of the changes you've made.\n   - Submit the pull request for review by the project maintainers.\n\n## Licensing Details\n\nThis project is distributed under the MIT License, offering wide-reaching flexibility and freedom for use and modification.\nSee [LICENSE](https://github.com/ShaanCoding/ReadME-Generator/blob/main/LICENSE.md) for more information.\n\n## Acknowledgements the Authors\n\n   - Primary Developer: [Lana Cool](https://github.com/lana4cool/)\n   - Expertise: Development of Telegram bots using PHP.\n   - GitHub Profile: Lana Cool\n   - Lana has been instrumental in developing and maintaining this project, ensuring it remains a robust and user-friendly tool for interacting with the TON Blockchain.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTegroTON%2FTON-token-Rest-API","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTegroTON%2FTON-token-Rest-API","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTegroTON%2FTON-token-Rest-API/lists"}