{"id":28380723,"url":"https://github.com/0xsequence/marketplace-contracts","last_synced_at":"2025-06-24T21:31:28.664Z","repository":{"id":194401048,"uuid":"687708044","full_name":"0xsequence/marketplace-contracts","owner":"0xsequence","description":"Sequence Marketplace Contracts","archived":false,"fork":false,"pushed_at":"2024-12-03T20:42:09.000Z","size":1271,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-06-06T03:40:51.897Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://sequence.build","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xsequence.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audits/2023-12-20-Quantstamp.pdf","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-05T20:55:29.000Z","updated_at":"2024-12-03T20:35:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"a71e2222-61f3-44dd-9bb9-efc1c33c0ec3","html_url":"https://github.com/0xsequence/marketplace-contracts","commit_stats":null,"previous_names":["0xsequence/marketplace-contracts"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/0xsequence/marketplace-contracts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fmarketplace-contracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fmarketplace-contracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fmarketplace-contracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fmarketplace-contracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xsequence","download_url":"https://codeload.github.com/0xsequence/marketplace-contracts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fmarketplace-contracts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261759110,"owners_count":23205497,"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":"2025-05-30T03:09:08.951Z","updated_at":"2025-06-24T21:31:28.623Z","avatar_url":"https://github.com/0xsequence.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marketplace Contracts\n\nContains contracts for the Sequence Marketplace.\n\n## Contracts\n\n### Sequence Market\n\nThe Sequence Market contract enables marketplace participants to create and fill listings and offers exchanging ERC-1155 and ERC-721 tokens for ERC-20 tokens.\n\nThe Sequence Market accept partial fills of any order using ERC-1155 tokens.\n\nThe Sequence Market contract has an owner who can set the royalty parameters for any contract that doesn't natively support ERC-2981. There are no other administrative functions.\n\nAny platform is free to integrate with the Sequence Market contract to provide a marketplace for their users.\n\nNote: The Sequence Market is designed to support standard ERC-1155, ERC-721 and ERC-20 implementations. Tokens with non-standard implementations (e.g. tokens that take fees on transfer) may not be compatible with the Sequence Market contract. Use of a token in the Sequence Market does not imply endorsement of the token by the Sequence Market.\n\n#### Flow\n\n1. The order creator approves the Sequence Market contract to transfer of ERC-1155 or ERC-721 tokens for a listing, or ERC-20 tokens for an offer.\n2. The order creator calls the Sequence Market to create an order.\n3. The order acceptor approves the Sequence Market contract to transfer the corresponding ERC-20 tokens for a listing, or ERC-1155 or ERC-721 tokens for an offer.\n4. The order acceptor calls the Sequence Market to accept the order.\n5. The Sequence Market contract transfers the tokens between the order creator and acceptor, deducting fees as applicable.\n\nNote: The order creator can cancel their order at any time, even after a partial fill.\n\n#### Fees\n\nThe Sequence Market automatically deducts ERC-2981 royalty payments from the order **creator** when an order is filled.\n\nAdditional fees (e.g. platform fees) can be taken from the **acceptor** of an order by specifying a fee recipient address when accepting an order.\n\nAll fees are taken from the ERC-20 token used in the transfer.\n\n## Development\n\n### Prerequisites\n\nClone the repo with submodules:\n\n```bash\ngit clone https://github.com/0xsequence/marketplace-contracts\ngit submodule update --init --recursive\n```\n\nInstall Forge via [Foundry](https://book.getfoundry.sh/getting-started/installation).\n\n### Tests\n\nRun the tests with:\n\n```bash\nforge test -vvv\n```\n\nRun coverage report with:\n\n```bash\nforge coverage --report lcov \u0026\u0026 lcov --remove lcov.info -o lcov.info 'test/*' 'script/*' \u0026\u0026 genhtml -o report lcov.info\ncd report \u0026\u0026 py -m http.server\n```\n\nCompare and save gas report with:\n\n```bash\nforge snapshot --diff .gas-snapshot\nforge snapshot\n```\n\n### Formatting\n\nPlease ensure code is formatted before committing. If you use VSCode, you will be prompted to install the Prettier extension.\n\n### Docs\n\nGenerate docs with:\n\n```bash\n./generateDocs.sh\n```\n\n## Audits\n\nThe contracts in this repository have been audited by [Quantstamp](https://quantstamp.com). Audit reports are available in the [audits](./audits) folder.\n\n## License\n\nCopyright (c) 2023-present [Horizon Blockchain Games Inc](https://horizon.io).\n\nLicensed under [Apache-2.0](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Fmarketplace-contracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xsequence%2Fmarketplace-contracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Fmarketplace-contracts/lists"}