{"id":16561513,"url":"https://github.com/jcnelson/poxl","last_synced_at":"2025-07-31T13:38:08.044Z","repository":{"id":42485359,"uuid":"349347487","full_name":"jcnelson/poxl","owner":"jcnelson","description":"PoX-Lite Stackable Token (POXL)","archived":false,"fork":false,"pushed_at":"2022-06-02T16:15:14.000Z","size":29,"stargazers_count":17,"open_issues_count":0,"forks_count":25,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-01-15T14:41:40.453Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Clarity","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/jcnelson.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-03-19T08:12:39.000Z","updated_at":"2022-12-22T17:21:39.000Z","dependencies_parsed_at":"2022-09-09T11:12:18.514Z","dependency_job_id":null,"html_url":"https://github.com/jcnelson/poxl","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/jcnelson%2Fpoxl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcnelson%2Fpoxl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcnelson%2Fpoxl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jcnelson%2Fpoxl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jcnelson","download_url":"https://codeload.github.com/jcnelson/poxl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241965705,"owners_count":20050313,"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-10-11T20:33:23.774Z","updated_at":"2025-03-05T04:29:12.980Z","avatar_url":"https://github.com/jcnelson.png","language":"Clarity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# poxl\n\nA PoX-Lite Stackable Token (POXL).\n\n**This code is for educational and demonstration purposes only.  IT HAS NOT BEEN\nAUDITED.**\n\n## How to Use\n\nTokens are minted through a mining process.  Anyone can call the `(mine-tokens)`\npublic function to commit STX to the contract in a bid to win the current Stacks\nblock's POXL reward.  A batch of POXL tokens are only minted if at least one\nminer attempts to do so.\n\nThe POXL token is mined in a two-phase process.  First, miners commit STX to the\ncontract in a bid to \"win\" the current Stacks block's POXLs by calling the\n`(mine-tokens)` public function.  The POXL coinbase is set at 500.000000 POXLs in perpetuity,\nbut a batch is only minted if at least one miner attempts to mine.  Second, after the token maturity\nwindow passes (100 Stacks blocks), miners check to see if the VRF seed at\nthe end of this window selected them to receive the POXLs.  If so, then the\nwinning miner may claim the POXLs at any time afterwards.  Note that both the\nact of mining and then claiming the POXLs are required to increase the total POXL supply\n-- unclaimed POXLs are never minted.\n\nLike STX, these tokens can be Stacked to produce a STX yield.  The POXL holder\ncalls `(stack-tokens)` to lock up their POXLs and earn the right to claim a \nportion of all STX committed by miners over a given number of reward cycles.\nThis portion is determined on a reawrd cycle basis by what fraction of the\nlocked POXLs the Stacker has locked versus all other Stackers.\n\nThis contract confirms to the draft version of [SIP\n010](https://github.com/stacksgov/sips/pull/5/) for token transfers, making\nit possible to trade POXLs via a standard API.\n\n## How to Develop\n\nTo run (and hack on) the tests, you will need to build and install `clarity-cli` from the\n[Stacks Blockchain](https://github.com/blockstack/stacks-blockchain) repo, and\nput it in your `$PATH`.  From there, you can run the tests as follows:\n\n```bash\n$ cd tests/ \u0026\u0026 ./run-tests.sh\n```\n\nThe test framework is very rudimentary -- it simply concatenates the\n`poxl.clar` contract with another snippet of Clarity code containing the\nunit tests, grabs a list of test functions from a `list-tests` function, and\nexecutes them in order via the `clarity-cli` binary.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcnelson%2Fpoxl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjcnelson%2Fpoxl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcnelson%2Fpoxl/lists"}