{"id":40541324,"url":"https://github.com/filozone/filecoin-services","last_synced_at":"2026-01-30T18:02:17.612Z","repository":{"id":296221826,"uuid":"988027323","full_name":"FilOzone/filecoin-services","owner":"FilOzone","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-28T06:53:05.000Z","size":1583,"stargazers_count":5,"open_issues_count":40,"forks_count":18,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-01-28T19:13:10.059Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/FilOzone.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-22T00:23:48.000Z","updated_at":"2026-01-28T03:18:55.000Z","dependencies_parsed_at":"2025-05-30T07:58:44.250Z","dependency_job_id":"b5c8889a-d474-4d9c-91be-6e038a0db268","html_url":"https://github.com/FilOzone/filecoin-services","commit_stats":null,"previous_names":["filozone/synapse-services","filozone/filecoin-services"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/FilOzone/filecoin-services","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FilOzone%2Ffilecoin-services","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FilOzone%2Ffilecoin-services/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FilOzone%2Ffilecoin-services/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FilOzone%2Ffilecoin-services/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FilOzone","download_url":"https://codeload.github.com/FilOzone/filecoin-services/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FilOzone%2Ffilecoin-services/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28917033,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T16:37:38.804Z","status":"ssl_error","status_checked_at":"2026-01-30T16:37:37.878Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2026-01-20T23:05:42.149Z","updated_at":"2026-01-30T18:02:17.607Z","avatar_url":"https://github.com/FilOzone.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Filecoin Services\n\nBuilding Filecoin onchain programmable services that integrate with the Filecoin network for decentralized storage.\n\n## ⚠️ IMPORTANT DISCLAIMER\n\n**🚨 THE WARM STORAGE CONTRACT IS CURRENTLY UNDER ACTIVE DEVELOPMENT AND IS NOT READY FOR PRODUCTION USE 🚨**\n\n**DO NOT USE IN PRODUCTION ENVIRONMENTS**\n\nThis software is provided for development, testing, and research purposes only. The smart contracts have not undergone comprehensive security audits and may contain bugs, vulnerabilities, or other issues that could result in loss of funds or data.\n\n**Use at your own risk. The developers and contributors are not responsible for any losses or damages.**\n\n## Overview\n\nThis repository contains smart contracts and services for the Filecoin ecosystem, featuring:\n\n- **FilecoinWarmStorageService**: A comprehensive service contract that combines PDP (Proof of Data Possession) verification with integrated payment rails for data set management\n- **Payment Integration**: Built on top of the [Filecoin Services Payments](https://github.com/FilOzone/filecoin-services-payments) framework\n- **Data Verification**: Uses [PDP verifiers](https://github.com/FilOzone/pdp) for cryptographic proof of data possession\n\n## Pricing\n\nThe service uses static global pricing set by the contract owner (default: 2.5 USDFC per TiB/month). Rail payment rates are calculated based on data size with a minimum floor. See [SPEC.md](SPEC.md) for details on rate calculation, pricing updates, and top-up/renewal behavior.\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Foundry](https://getfoundry.sh/) - Ethereum development toolchain\n- [jq](https://jqlang.github.io/jq/) - Command-line JSON processor (v1.7+ recommended)\n- Git with submodule support\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/your-org/filecoin-services.git\ncd filecoin-services/service_contracts\n```\n\n2. Install dependencies and initialize submodules:\n```bash\nmake install\n```\n\n3. Build the contracts:\n```bash\nmake build\n```\n\n4. Run tests:\n```bash\nmake test\n```\n\n## 📋 Project Structure\n\n```\nservice_contracts/\n├── src/                                 # Smart contract source files\n│   └── FilecoinWarmStorageService.sol   # Main service contract with PDP and payment integration\n├── test/                                # Test files\n│   └── FilecoinWarmStorageService.t.sol # Contract tests\n├── tools/                               # Deployment and utility scripts\n├── lib/                                 # Dependencies (git submodules)\n│   ├── forge-std/                       # Foundry standard library\n│   ├── openzeppelin-contracts/\n│   ├── fws-payments/                    # Filecoin Services payments\n│   └── pdp/                             # PDP verifier contracts\n└── out/                                 # Compiled artifacts\n```\n\n## 🌐 Deployed Contracts\n\n### Calibnet (Testnet)\n- Contract Addresses listed in: https://github.com/FilOzone/filecoin-services/releases/tag/v1.0.0 \n\n### Mainnet\n- Contract Addresses listed in: https://github.com/FilOzone/filecoin-services/releases/tag/v1.0.0 \n\n## 🔧 Development\n\n### Running Tests\n\n```bash\ncd ./service_contracts/\n\n# Run all tests\nmake test\n\n# Run tests with specific verbosity (using forge directly)\nforge test -vvv --via-ir\n\n# Run specific test file (using forge directly)\nforge test --match-path test/FilecoinWarmStorageService.t.sol --via-ir\n```\n\n### Code Quality\n\n```bash\n# Format code\nmake fmt\n\n# Check code formatting\nmake fmt-check\n\n# Generate test coverage\nmake coverage\n\n# Clean build artifacts\nmake clean\n```\n\n### Available Make Targets\n\nRun `make help` to see all available targets:\n\n```bash\nmake help\n```\n\n## 🚀 Deployment\n\nFor comprehensive deployment instructions, parameters, and scripts, see [service_contracts/tools/README.md](./service_contracts/tools/README.md).\n\n## 🔗 Dependencies\n\nThis project builds on several key components:\n\n- **PDP Contracts**: [FilOzone/pdp](https://github.com/FilOzone/pdp) - Proof of Data Possession verification\n- **Payment Rails**: [FilOzone/filecoin-services-payments](https://github.com/FilOzone/filecoin-services-payments) - Payment infrastructure\n- **OpenZeppelin**: Industry-standard smart contract libraries for security and upgradeability\n\n## 🤝 Contributing\n\nSee [service_contracts/CONTRIBUTING.md](./service_contracts/CONTRIBUTING.md) for development guidelines and code generation details.\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests for new functionality\n5. Ensure all tests pass\n6. Submit a pull request\n\n## 📄 License\nDual-licensed under [MIT](https://github.com/filecoin-project/lotus/blob/master/LICENSE-MIT) + [Apache 2.0](https://github.com/filecoin-project/lotus/blob/master/LICENSE-APACHE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilozone%2Ffilecoin-services","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilozone%2Ffilecoin-services","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilozone%2Ffilecoin-services/lists"}