{"id":19147791,"url":"https://github.com/refcell/seals","last_synced_at":"2025-07-23T21:32:18.592Z","repository":{"id":150177861,"uuid":"455450995","full_name":"refcell/seals","owner":"refcell","description":"Sealed Auctions with Commitment Schemes.","archived":false,"fork":false,"pushed_at":"2022-02-23T00:11:59.000Z","size":39,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-20T06:58:23.935Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/refcell.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}},"created_at":"2022-02-04T06:56:35.000Z","updated_at":"2023-07-25T14:54:04.000Z","dependencies_parsed_at":"2023-08-27T02:18:38.467Z","dependency_job_id":null,"html_url":"https://github.com/refcell/seals","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"refcell/femplate","purl":"pkg:github/refcell/seals","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fseals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fseals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fseals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fseals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/refcell","download_url":"https://codeload.github.com/refcell/seals/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/refcell%2Fseals/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266753670,"owners_count":23979139,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-09T07:52:23.166Z","updated_at":"2025-07-23T21:32:18.570Z","avatar_url":"https://github.com/refcell.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# seals  • [![tests](https://github.com/abigger87/seals/actions/workflows/tests.yml/badge.svg)](https://github.com/abigger87/seals/actions/workflows/tests.yml) [![lints](https://github.com/abigger87/seals/actions/workflows/lints.yml/badge.svg)](https://github.com/abigger87/seals/actions/workflows/lints.yml) ![GitHub](https://img.shields.io/github/license/abigger87/seals) ![GitHub package.json version](https://img.shields.io/github/package-json/v/abigger87/seals)\n\nSealed Commitment Auctions with Overcollateralized Bid Bands.\n\n```m\n        .---.\n       /o   o\\\n    __(=  \"  =)__\n     //\\'-=-'/\\\\\n        )   (_\n       /      `\"=-._\n      /       \\     ``\"=.\n     /  /   \\  \\         `=..--.\n ___/  /     \\  \\___      _,  , `\\\n`-----' `\"\"\"\"`'-----``\"\"\"`  \\  \\_/\n                             `-`\n```\n\n## Overview\n\n`Seals` is a ***highly*** modular, unconventially named Protocol to run Sealed Auctions using Commitment Schemes.\n\nEach Sealed Commitment Auction is created using [wighawag](https://twitter.com/wighawag) and [ZeframLou's](https://twitter.com/boredGenius) [Clones With Immutable Args](https://github.com/wighawag/clones-with-immutable-args) factory pattern.\n\nThe factory contract is called `Floe` - a floating sheet of ice where Seals are spawned,\n\n`Floe` deploys three contracts per auction:\n1. [Bloc](./src/Bloc.sol) - The Sealed Auction Manager Contract.\n2. [Nibs](./src/Nibs.sol) - The Project Shares issued once the reveal session ends.\n3. [Coffer](./src/Coffer.sol) - A Lockbox Contract that stores auction collaterals.\n\n\n## Architecture\n\nTODO\n\n## Blueprint\n\n```ml\nlib\n├─ ds-test — https://github.com/dapphub/ds-test\n├─ forge-std — https://github.com/brockelmore/forge-std\n├─ solmate — https://github.com/Rari-Capital/solmate\n├─ clones-with-immutable-args — https://github.com/wighawag/clones-with-immutable-args\nsrc\n├─ tests\n│  └─ Seal.t — \"Seal Tests\"\n└─ Seal — \"The Seal Coordination Contract\"\n```\n\n## Glossary\n\nWe use Primitive and Maker's approach of Unconvential Naming inspired by [The Dangers of Surprising Code](https://samczsun.com/the-dangers-of-surprising-code/) h/t [Alex](https://twitter.com/alexangelj) [Mistrusting Variable Names](https://twitter.com/alexangelj/status/1491280313162813441?s=20\u0026t=NoFpNkO9orH8OZ34-DIfMQ).\n\n\n`\n\n## Development\n\n[seals](https://github.com/abigger87/seals) is built with [Foundry](https://github.com/gaskonst/foundry) but remains backwards compatible with [DappTools](https://dapp.tools/).\n\nSet up your environment by following the instructions outlined in [abigger87/foundry-starter](https://github.com/abigger87/foundry-starter#development).\n\n\n```bash\n# Setup\nmake setup\n```\n\n```bash\n# Build #\nmake build\n```\n\n```bash\n# Testing #\nmake test\n```\n\n#### Configure Foundry\n\nUsing [foundry.toml](./foundry.toml), Foundry is easily configurable.\n\n## Install Seals as a Dependency\n\nTo install with [DappTools](https://dapp.tools/), run:\n```sh\ndapp install abigger87/seals\n```\n\nTo install with [Foundry](https://github.com/gakonst/foundry), run:\n```sh\nforge install abigger87/seals\n```\n\nTo install with [Hardhat](https://hardhat.org/), run:\n```sh\nnpm i -D seals\n```\n\n## License\n\n[AGPL-3.0-only](https://github.com/abigger87/seals/blob/master/LICENSE)\n\n# Acknowledgements\n\n- [lil Juicebox](https://github.com/m1guelpf/lil-web3/blob/main/src/LilJuicebox.sol) created by [Miguel Piedrafita](https://twitter.com/m1guelpf)\n- [Soulbound](https://github.com/primitivefinance/soulbound)\n- [NFT Call Options](https://github.com/verumlotus/NFT-Call-Option) built by [verumlotus](https://twitter.com/verumlotus)\n- [foundry](https://github.com/gakonst/foundry)\n- [solmate](https://github.com/Rari-Capital/solmate)\n- [forge-std](https://github.com/brockelmore/forge-std)\n- [clones-with-immutable-args](https://github.com/wighawag/clones-with-immutable-args).\n- [foundry-toolchain](https://github.com/onbjerg/foundry-toolchain) by [onbjerg](https://github.com/onbjerg).\n- [forge-template](https://github.com/FrankieIsLost/forge-template) by [FrankieIsLost](https://github.com/FrankieIsLost).\n- [Georgios Konstantopoulos](https://github.com/gakonst) for [forge-template](https://github.com/gakonst/forge-template) resource.\n\n## Disclaimer\n\n_These smart contracts are being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the user interface or the smart contracts. They have not been audited and as such there can be no assurance they will work as intended, and users may experience delays, failures, errors, omissions, loss of transmitted information or loss of funds. The creators are not liable for any of the foregoing. Users should proceed with caution and use at their own risk._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefcell%2Fseals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frefcell%2Fseals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefcell%2Fseals/lists"}