{"id":25847658,"url":"https://github.com/4lgn/bep-20-templates","last_synced_at":"2026-01-25T19:35:33.038Z","repository":{"id":43273262,"uuid":"414158126","full_name":"4lgn/bep-20-templates","owner":"4lgn","description":"Solidity v0.8^ smart contract templates for BEP20 compliant tokens to be deployed to the Binance Smart Chain (BSC) blockchains","archived":false,"fork":false,"pushed_at":"2022-03-10T19:20:11.000Z","size":106,"stargazers_count":16,"open_issues_count":1,"forks_count":17,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-03-08T01:05:23.433Z","etag":null,"topics":["binance-smart-chain","blockchain","cryptocurrency","smart-contracts","solidity","solidity-contracts"],"latest_commit_sha":null,"homepage":"","language":"Solidity","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/4lgn.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}},"created_at":"2021-10-06T10:00:33.000Z","updated_at":"2023-02-23T20:50:13.000Z","dependencies_parsed_at":"2022-09-06T07:54:31.670Z","dependency_job_id":null,"html_url":"https://github.com/4lgn/bep-20-templates","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4lgn%2Fbep-20-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4lgn%2Fbep-20-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4lgn%2Fbep-20-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4lgn%2Fbep-20-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4lgn","download_url":"https://codeload.github.com/4lgn/bep-20-templates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241353936,"owners_count":19949131,"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":["binance-smart-chain","blockchain","cryptocurrency","smart-contracts","solidity","solidity-contracts"],"created_at":"2025-03-01T10:34:00.044Z","updated_at":"2026-01-25T19:35:28.018Z","avatar_url":"https://github.com/4lgn.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bep-20-templates 💱\n\nSolidity v0.8^ smart contract templates for BEP20 compliant tokens to be deployed to the Binance Smart Chain (BSC) blockchains. Developed using Truffle and Ganache for easy testing and deployments, please consult to each of said tools for instructions on how to run this project. \n\nThe templates range from a simple token `SimpleCoin` to tokens with more \"shitcoin\"-inspired tokenomics such as `ReflectFeeCoin` that implements common tokenomics found in most garbage meme coins and as seen in SafeMoon, etc.\n\n## What can I find here?\n\n### Token templates\n\n- `SimpleCoin`: Dead-simple implementation of the BEP20 token standard\n- `ReflectCoin`: SimpleCoin but with reflection tokenomics ontop\n- `ReflectFeeCoin`: ReflectCoin but with extra fees on each transaction taken to user-defined wallet addresses (marketing, developer, etc.) and a taxable percentage goes to the liquidity pool. On a transaction, the fees are converted from the native token to BNB and transferred to the user-defined wallet addresses, the liquidity pool fee is split evenly and transferred to the liquidity pool. (this token uses, and depends on, the external PancakeSwap contract)\n\n### Scripts\n\n- `add-liquidity.js`: Script to programmatically create a PancakeSwap pair, and add liquidity to the pool, to allow other users to swap tokens for the given token through PancakeSwap.\n- `airdrop.js`: Used to programmatically airdrop your token to a list of wallet addresses - can incur large transaction costs due to each airdrop being its on transaction on the network.\n- `swap-tokens.js`: Can be used to test the liquidity pool of a token. Essentially \"buys\" the native token using BNB by swapping BNB to the native token through the PancakeSwap router contract.\n\n\n### Tests\n\nSome tests are found under the `test/` folder, including for `ReflectCoin` and `ReflectFeeCoin`. Bear in mind the last test in `ReflectFeeCoin` shows a tiny backdoor that can be used if ownership is not renounced (transfer ownership to `0x0` address). Essentially, one might lock up the liquidity pool using an external locker for `x` days, and people will usually perceive the token to be at least safe for those `x` days. However, it is completely possible to just set `maxTxPercent` to `0`, which essentially completely disables transfers with the contract (disabling the ability to \"sell\", or swap away from the token to BNB). Thus the malicious owner could just wait out the `x` days with no activity, and then remove the liquidity once the lock is over.\n\n## Disclaimer\n\nPlease do not use these scripts or contracts without general knowledge of smart contract development and blockchain deployments ... at least not on any mainnets with your own wallet - feel free to do stupid stuff on your local Ganache server or testnets.\n\nAnd then for anyone that do not understand the above message:\n\n```\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n\n## License\n\nCopyright (c) 2021 Alexander G. Nielsen. See [LICENSE](https://github.com/4lgn/bep-20-templates/blob/master/LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4lgn%2Fbep-20-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4lgn%2Fbep-20-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4lgn%2Fbep-20-templates/lists"}