This is the Governance resource for the Allocator project of Filecoin Plus. Within this repo are the common links and
- Specification on governance, and operations layers.
- Information on Allocators roles and responsibility.
- Information on how to become an Allocator, selection rubric, and onboarding resources.
- Directions for how to file a support issue and the steps for how disputes are resolved.
Short 5 minute summary of the Allocator Program Allocator Model Youtube
The Governance teams, FIDL, Allocators, and Community meet for a bi-weekly call to discuss the programatic updates. The call is open to the public and all are encouraged to join in order to learn more about Filecoin Plus. The last call of 2024 is scheduled to take place on 17December. The 2025 schedule will be posted soon.
- Allocator Slack Channel
- Open and Pending Applications
- Allocator Support Registry
- FIDL Allocator Application
- Distribution Metrics
- DataCap Stats IO
- Spark Retrevial Metrics
The purpose of this repository is to manage the governance and evolution of specific of the program as insantiated in this diagram. FIP and illustrated in the follow
Allocators are given a high degree of autonomy in their decision making power. In order to build trust in the stability of this mechanism, below outlined are some basic criteria by which all Allocators are expected to adhere. In the future these restrictions may be reduced or removed, upon approval by the community (going through the standard PR process).
-
Upfront Disclosures: Prior to being confirmed as a Allocator, Allocators are expected to disclose all relevant addresses which they control, have a financial stake in, or are strongly connected to by other means. For the disclosure, the Allocator should state the relevant addresses and the nature of the relationship.
-
Promoting Client Best Practices: Allocators agree to educate approved clients about the best practices for using their DataCap (e.g. how to request additonal services from miners, storing data redundantly across many miners, etc). Some reference information can be found here.
-
Commitment to effeciently serving the Network: Allocators agree to serve as fiduciaries of the Network, striving to work towards bringing useful data onto Filecoin and improving the experience for clients to do so. Allocators should generally be able to respond to Client applications and updates within 3 days, and should be comfortable communicating with Clients and Allocators if an application needs to be redirected.
-
No Self Dealing: To prevent conflicts of interest, Allocators should not allocate DataCap to Clients over which they control the private keys, or to a Client who intends to specifically spend the allocated DataCap with an address affiliated with the Allocator. When in doubt, Allocators should bias towards transparency (i.e. public disclosure) or to getting a different Notary to handle the individual request.
-
Operating in Good Faith: Allocators hold a position of trust in the network, and as such it is expected that they operate keeping the Principles of this mechanism in mind. While each form of abuse cannot be exhaustively defined, Allocators are expected to bias towards caution and act in a way that promotes transparency. Allocators should expect to potentially recieve requests or questions for allocation decisions (within reason) - and should make decisions with this in mind.
-
Community Governance Participation: It is expected that Allocators regularly attend the scheduled Governance calls. As these calls are a forum to shape this process, it is important to ensure Allocators are present to provide their context, learnings, and input.
-
Filecoin Plus is designed for all client actors with quality data who engage in distributed onboarding. Client actors can be either data owners or preparers (including SPs), who either provide some form of KYC (and KYB) information to earn social trust or prove long-term commitment (i.e. collateral in a trustless notary).
-
The Filecoin Plus program defines 'quality data' as all content that meets local regulatory requirements AND
- the data owner wants to see on the network, including private/encrypted data;
- or is open and retrievable;
- or demonstrates proof of concept or utility of the network, such as efforts to improve onboarding.
-
Allocators are responsible for performing diligence on their clients and datasets.
-
Each allocator pathway will be subject to an audit performed by the MetaAllocator that supervises that pathway. When the pathway has distributed 75% of the DataCap they received in the previous round, the allocator should trigger the review by submitting the appropriate template in this GitHub repo (current link).
-
Storage providers will be tested for retrievability using the Spark protocol (https://github.com/filecoin-station/spark). As an allocator, you are responsible for holding your clients accountable, and those clients are responsible for working with reputable Storage Providers that meet your onboarding, distribution, and retrieval requirements.
-
Every dataset participating in the Fil+ program should be stored in at least two different physical regions.
-
If there are no client allocations or developer progress after 2 months of approval of an allocator, that pathway's DataCap may be paused or revoked.
-
Within two weeks of approval & receiving initial DataCap allocation, each allocator must publish a Readme document detailing:
- Short description of pathway for clients, to be included in Allocator website.
- Contact info, such as Slack ID.
- Detailed Allocator policies, procedures, and requirements.
- Risk mitigation strategies - the processes for protecting your organization, reputation, and pathway from abuse. For example, what Operational Security (OpSec) standards, user agreements, alerts, or throttling mechanisms will you employ?
- Dispute Resolutions - A dispute within the context of DataCap allocation refers to any contention or disagreement arising between parties involved in the storage and retrieval of data on the Filecoin network. This could involve discrepancies over DataCap distribution, disagreements on data compliance with stated parameters, or conflicts over the execution of storage deals. Disputes may be internal, involving yourself and your client, or external, where you will need to defend your decisions against another active allocator or the Fil+ Governance Team.
- Compliance Audit Check - how do you plan to ensure that your clients, and the storage providers they interact with are all in compliance with both program-wide and pathway specific requirements.
Auditors assess the Allocator's performance using on-chain data from tools like datacapstats.io and CID audits, as well as off-chain data from bookkeeping sources.
- Proposed claims versus evidence: Did the allocator uphold requirements (e.g. client types, SP relationships)?
- DataCap Distribution & Utilization:
- Scaling trust over time
- Number of SPs connected to clients
- Number and size of unique datasets
- Time clients took to use DataCap
- Revoking unused DataCap
- Client Behavior: Did clients use listed SPs and datasets? Provenance Checks: Verifying dataset ownership (e.g. attestations, contracts)
- SP Info Gathering: KYB and diligence evidence
If the allocator supports Enterprise Data, the auditor may request:
- Client KYC: ID documents, proof of address, risk assessments, business purpose
- SP KYB: Incorporation docs, governance records, ownership proof, KYB reports
- Non-Collusion Proofs: Signed affidavits, org charts, due diligence reports
- Economic Transfer Evidence: Invoices, payment receipts, on-chain logs
All documents must show clear separation and legitimate business relationships between clients and SPs.
For Open/Public datasets, the auditor will investigate:
- Retrievability: Tested via Spark protocol (≤20ms latency, target RSR >75%); alternate proofs pending approval
- Provenance: Public URLs, digital signatures, agreements with original data sources
- Data Preparation Verification: Scripts, processing logs, and step-by-step audit trail
- Justification for uploading duplicate datasets
- Content Validation: Auditors may download and inspect stored data for authenticity
Successful allocators must maintain transparency, diversity, and a strong audit trail throughout.
The Filecoin Plus program is intended to onboard high quality data to a distributed network, which operates under a governance framework to ensure trust and collaboration.
Defined Roles and Rights:
- Responsibilities for applicants, clients, and Allocators in ensuring standards are met and maintained.
- Accountability and Transparency: Regular audits and transparent reporting of datacap refresh and applications for new pathways. Operationally, governance should balance stability and innovation.
Key practices include:
- Formal Proposal Processes: Community discussions - either in Slack, Github, or bi-weekly Fil+ Governance meeting, for issues and proposed changes.
- Consensus: Major changes, such as security patches or adjustments, should require broad agreement and thorough testing. By focusing on standards and accountability, Fil+ should evolve while maintaining its core mandate - to onboard quality data to the Filecoin network.
Standards for Submission:
- Visit the Allocator Governance GitHub page.
- Create a new pull request by adding a new file to the repository.
- Name it appropriately, "Allocator application ".
- Commit the change and add it as a branch, then click "Create pull request".
Required Documentation:
- A comment will appear with a link to the Airtable, which serves as your actual application form.
- Open this link in a new tab for easy access.
- See the blog from FIDL on their experience/input on the application process
2. New Application (for Allocators) Review and Approval
Community Review System:
- All new applications are received and reviews on their ability to add value to the Filecoin Network.
- Pathways are prioritized on their ability to onboard data as well as providing a novel approach other than manual.
Approval Tiers:
- RFA (pathway other than manual) with an existing readme and established MVP - immediate.
- Manual Pathways which focus on a human verification - these will be onboarded as needed for the program.
- Applications for new Pathways should be for a pathway that is ready to operate. Pathways which need to develop tooling in order to operate are encouraged to obtain a small amount of testing DataCap (DC).
3. Use of Governance Tools These tools do NOT need to be used, but are recommended as verified and helpful ways to ensure compliance. If a pathway wishes to utilize their own tooling or a 3rd party tooling, they should meet the spirit of standards set forth.
KYC:
- Applications which claim to function as a MARKET or AUTOMATED should not rely on a human verification of clients or organizations. While no specific tooling is mandated to participate in Fil+ as an Allocator, the tooling for verifying your clients should be - clearly defined - able to produce a record - capture the KYC include the customer identification program (CIP), customer due diligence (CDD), and enhanced due diligence (EDD)
CID Checker:
- Automated checks for testing as part of the submission process. These will be used as one of the primary sources of truth for verification of standards setup in the application to be maintained.
SPARK:
- Automated checks for testing as part of the submission process. These will be used as one of the primary sources of truth for verification of standards setup in the application to be maintained.
4. Stakeholder Involvement
Crypto-Specific Oversight:
- If working with clients in paid storage deals, deals should have a minimum value that is viewable on-chain.
- Contacts with clients can be verified as a one off, but should not be utilized as a primary manual verification of deals.
- Allocators and Clients should operate in good faith. In event of breach of standards in applications, review and removal from the Filecoin Plus program will be conducted by the Filecoin Foundation Governance Team. In the event a pathway is found to have NOT operated in good, it will be denied access to additional DataCap for disbursement.
5. Existing Allocator DatCap Refresh After DataCap is awarded to a pathway, in order to receive a refresh the pathway must submit a request. This request will be reviewed by the Community (Watchdog may serve to compile and comment in place of community if now comments are received), Governance, and Root Key Holders.
Security Audits:
- SPARK is the primary verification of retrievability. If a pathway wishes to demonstrate their own metrics, examples, or programs for verifying retrievability - they must meet the same standards as SPARK.
Compliance Standards:
- Adhere to requirements that were established in the application to become an Allocator. Failure to adhere to standards (Bookkeeping, Retrievability, SP accounting) may result in - Guidance from Governance - Throttling of DataCap refresh - Removal as Allocator. Reasons for compliance will be noted in the request for additional DataCap.
6. Community Accountability
Key Expectations for Allocators:
a. High Retrieval Expectations
- Allocators must prioritize high retrieval rates for data (75% as verified in SPARK).
- Ensuring data is easily accessible is a critical responsibility.
- Allocators are responsible to ensuring that clients operate within the standards the Allocator outlined in their application.
b. No Excessive Padding of Datasets
- Metadata and supporting information are allowed, but padding exceeding 25% of a dataset is not acceptable. Datasets should be appropriately sized, focused, and free of unnecessary filler content.
c. Standardized Bookkeeping
- Allocators must maintain clear bookkeeping, ideally through GitHub for transparency and community access.
- If not using GitHub, follow another clear and organized bookkeeping process. Process should be open and made available to public as well as Governance for refresh audit.
d. Clear Communication of Intent
- Clearly state your intentions and objectives in the application process.
- Stay aligned with your declared goals and maintain transparent, well-documented communication.
- Maintain onboarding of client data to remain active in the program (as an Allocator)
- Bi-Weekly Governance meetings will serve as the community source of truth for discussions and forum.
- Fil+ Shared Calendar
- Allocator Governance Meetings are recorded and posted to Youtube
e. Follow a Standardized Format
- Use a consistent and standardized format for all steps in the allocation process, including applications, data submission, retrieval, and compliance reporting.
f. Fee Structures
- Fees are allowed but must be communicated transparently.
- Allocators must clearly state any associated costs and the rules governing them.
- Paid deals should include an on-chain record.
g. Clients and Multiple Allocators
- Applying to multiple allocators is acceptable, but transparency is required.
- Allocators should verify a client is not onboarding duplicate data to multiple Allocator Pathways
- Avoid conflicts of interest and provide clarity to all parties involved.
h. Act in the Interest of Filecoin
- Always evaluate actions by asking: "Is this growing the Filecoin network and contributing to its success?"
- If the answer is an honest yes, you are likely operating within the spirit of the Filecoin community and guidelines.