{"id":19030582,"url":"https://github.com/alexbsoft/tonsimpleauction","last_synced_at":"2026-05-02T23:30:15.645Z","repository":{"id":52336345,"uuid":"363204597","full_name":"AlexBSoft/TonSimpleAuction","owner":"AlexBSoft","description":null,"archived":false,"fork":false,"pushed_at":"2021-04-30T17:14:35.000Z","size":62,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-02T04:09:19.757Z","etag":null,"topics":["freeton","solidity"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexBSoft.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-04-30T16:51:57.000Z","updated_at":"2021-10-05T10:14:41.000Z","dependencies_parsed_at":"2022-09-03T08:24:26.765Z","dependency_job_id":null,"html_url":"https://github.com/AlexBSoft/TonSimpleAuction","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/AlexBSoft%2FTonSimpleAuction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexBSoft%2FTonSimpleAuction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexBSoft%2FTonSimpleAuction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexBSoft%2FTonSimpleAuction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexBSoft","download_url":"https://codeload.github.com/AlexBSoft/TonSimpleAuction/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240079641,"owners_count":19744727,"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":["freeton","solidity"],"created_at":"2024-11-08T21:18:38.677Z","updated_at":"2026-05-02T23:30:15.579Z","avatar_url":"https://github.com/AlexBSoft.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple TON Auction\r\n\r\nThis project implements simplified English \u0026 Dutch Auctions if Free TON smart contracts.\r\n\r\nSystem consists of 3 contracts:\r\n\r\n- SimpleRoot (aka Auction deployer)\r\n- SimpleAuction (Auction itself)\r\n- DeBot (Auction iterface)\r\n\r\nSample Root in Devnet\r\n`0:0eb6fef10aa7f2496c8f43c5b120ae01a2f0661508184b98b9b0c8f44052b709`\r\n\r\nSample DeBot in Devnet\r\n`0:ed64f712d1c8e263cbaf338944f1a78e8beaa3acc5534c57e759471a342a4868`\r\n\r\n### SimpleRoot\r\n\r\nSetup Auction contract image in constructor while deploying contract.\r\n\r\nCall `CreateAuction(description, startPrice, auctionDuration)` to deploy new Auction contract. Returns Auction address.\r\n\r\n### English auction\r\n\r\nIt is default auction type in `SimpleAuction.sol`\r\n\r\nBids should be made directly by transfering funds to Auction contract. Auction stores 2 latest bids and automaticully refunds previous bids.\r\n\r\nOnce auction is finished it can deploy new contract or perform any action, the system is flexible and easy to modify.\r\n\r\n#### Commands:\r\n\r\n- Money transfer - place Bid\r\n- `Finish()` - mark auction as finished. Call this function when time for bids ended\r\n- `Withdraw(address dest)` - withdraw the earned amount\r\n\r\n### Dutch auction (reversed auction)\r\n\r\nIt is optional partially implemented auction type in `DutchAuction.sol`\r\n\r\nIn this type of auction, seller should lower price until somebody places bid.\r\n\r\nBids are submitted in the same way as in the English auction, via common transfers.\r\n\r\nAuction created with `StartPrice` and `MinPrice`.\r\n`MinPrice` - the minimum price to which the bid price can drop.\r\n\r\n#### Commands:\r\n- Money transfer - place Bid\r\n- `ReducePrice(value)` - reduce price by amount\r\n- `Finish()` - mark auction as finished. Call this function when time for bids ended\r\n- `Withdraw(address dest)` - withdraw the earned amount\r\n\r\n## Tests\r\n\r\nTests are made using mocha. To run project on local Node SE:\r\n\r\n- Start docker with tonos\r\n- Compile contracts (easiest way is to use TONDev extension in VS Code, jsut right click on .sol files and click Compile)\r\n- Pack contracts `test:pack`\r\n- Run tests `test:common`\r\n\r\n## DeBot\r\n\r\nDeBot allows users to interact with Auctions and deploy new Auctions.\r\n\r\nDeBot is not finished yet, but you still can create new auctions using it.\r\n\r\n### Deploy DeBot\r\n\r\n- Change Root address in file debot.test.ts\r\n- Compile \u0026 pack contracts\r\n- Run `test:debot`\r\n\r\n### Use DeBot\r\n\r\n- Connect to it using `tonos-cli --url http://127.0.0.1 debot fetch \u003caddr\u003e`\r\n- Create new Auction (press 2)\r\n- Enter all data\r\n- Interact with auction (press 1)\r\n\r\n## Deploy\r\n\r\n- Compile contracts (easiest way is to use TONDev extension in VS Code, jsut right click on .sol files and click Compile)\r\n- Pack contracts `test:pack`\r\n- Deploy to devnet `test:deploy`\r\n- Follow instruction in console:\r\n    - Transfer funds to Root address\r\n    - Transfer funds to DeBot address\r\n- Save keys \u0026 you are breathtaking\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexbsoft%2Ftonsimpleauction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexbsoft%2Ftonsimpleauction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexbsoft%2Ftonsimpleauction/lists"}