Skip to content

[Allocator Application] <NiwanDao>< NiwanDaoAutomaticPathway> PR #293 #295

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
martapiekarska opened this issue Feb 17, 2025 · 5 comments
Assignees
Labels
Allocator Application Application received from an Organization to receive DataCap and function as an Allocator Automated Pathway

Comments

@martapiekarska
Copy link
Collaborator

Allocator Application

Application Number

recKZsIEMlZqcPBLk

Organization Name

NiwanDao

Organization On-chain Identity

f1a2lia2cwwekeubwo4nppt4v4vebxs2frozarz3q

Allocator Pathway Name

NiwanDaoAutomaticPathway

Github PR Number

293

Region of Operation

Greater China Region,North America

GitHub ID

NiwanDao

On-chain address

I will provide an address on a later date

Type of Allocator

Novel allocator not on RFA

Filecoin Community Agreement

As a member in the Filecoin Community, I acknowledge that I must adhere to the Community Code of Conduct, as well other End User License Agreements for accessing various tools and services, such as GitHub and Slack. Additionally, I will adhere to all local & regional laws & regulations that may relate to my role as a business partner, organization, notary, allocator, or other operating entity
Acknowledge

Type of Allocator and RFA List

RFA: Automated - GitHub

Allocator Description

The Filecoin Plus Ecosystem has long struggled with inefficiencies in the Client onboarding and DataCap allocation process. Traditional methods either expose the system to abuse due to overly simplistic approvals or discourage legitimate clients with unnecessarily complex verification procedures. Niwan Automatic Allocator introduces an innovative, automated, and cross-chain-integrated approach that enhances speed, compliance, and efficiency while strengthening the Filecoin ecosystem.

1. Speed with Quality: Dual-Track Client Verification

In the past two years, the FilPlus Ecosystem has faced two major challenges:

  1. Loopholes in overly simple application processes, allowing fraudulent users to abuse the system without penalties.
  2. Excessively complex approval workflows, deterring legitimate clients with unnecessary delays.
    To address these issues, Niwan Automatic Pathway introduces a dual-track client verification systemPledge Clients and KYC Clients—based on their confidence in compliance with deal-making requirements for storage providers.
  • Pledge Clients: Upon application submission, clients must provide a security deposit to the allocator’s address, proportional to their requested DataCap amount. This deposit is refunded only after the DataCap is used in compliance with established rules, as verified through Spark and CID Checker. If the usage fails to meet compliance standards, the deposit is forfeited.
  • KYC Clients: These clients undergo a Gitcoin-backed KYC process and receive DataCap allocations in batches, based on their compliance with usage progress and quality standards. This ensures a more secure and transparent verification process while enabling efficient allocation.
    By balancing speed and quality, this dual-pathway approach enhances trust, accountability, and efficiency in the ecosystem.

2. Advanced Cross-Chain and Smart Contract Integration for Automated DataCap Allocation

Previously, DataCap allocation has required extensive manual verification to ensure client compliance. This leads to long approval times and a poor user experience, even for fully compliant clients.
To address this inefficiency, Niwan Automatic Allocator integrates smart contract-based automation into the allocation process. Clients who meet all the requirements for the next approval cycle can instantly receive DataCap, eliminating manual bottlenecks. This approach:

  • Speeds up allocation by removing unnecessary verification delays.
  • Enhances efficiency by automating compliance checks.
  • Improves the user experience while maintaining compliance and security.
    Furthermore, the use of cross-chain bridges and smart contract technology extends Filecoin's interoperability with other blockchain networks, opening up new applications and integrations that strengthen the overall blockchain ecosystem.

3. Broader Benefits for the Filecoin Ecosystem

Beyond solving immediate inefficiencies, Niwan Automatic Allocator significantly contributes to the long-term sustainability and expansion of the Filecoin network:

Strengthening Network Security and Compliance

By using automated compliance verification and security deposits, Niwan Automatic Allocator reduces fraud and abuse, ensuring DataCap is allocated only to legitimate users. This enhances trust and transparency within the ecosystem.

Accelerating Real-World Data Onboarding

With instant DataCap approvals for compliant clients, valuable data can be onboarded faster, increasing the utility of Filecoin’s decentralized storage network.

Lowering Administrative Costs and Overhead

The shift from manual verification to smart contract automation significantly reduces operational costs, allowing more resources to be redirected toward innovation and ecosystem growth.

Contributions to EcosystemDevelop Open-Source Tools,Build better data onboarding pathway

Monetization and Fee structure

Client fees,Client staking.

Target Clients

Individuals,Web3 developers,Open/Public,Commercial/Enterprise

Client Diligence Check

3rd party Know your customer (KYC) service,Manual verification

Description of client diligence

Pledge Clients: Stake-Based Trust Establishment
Clients who choose the Pledge Client pathway establish initial trust through a security deposit mechanism, which deters fraudulent applications by imposing financial risk on non-compliant behavior.

  • Upon application submission, clients must deposit a stake proportional to their requested DataCap to the allocator’s designated address.
  • DataCap usage is monitored via automated smart contract enforcement, leveraging Spark and CID Checker for compliance validation.
  • Clients receive a full refund of their deposit only after proving compliance with storage deal requirements.
  • If the client fails to meet compliance standards, the deposit is forfeited, discouraging malicious activity.
    This method creates a cost-based deterrent against Sybil attacks by ensuring that malicious actors must risk significant financial loss to exploit the system.

KYC Clients: Identity Verification & Ownership Validation
For enterprise or paying clients, Niwan Automatic Allocator implements a Gitcoin-backed KYC process, ensuring:

  • Real-world identity verification, reducing the likelihood of Sybil attacks.
  • Validation of data ownership claims through cryptographic signatures and on-chain attestations.
  • Progressive DataCap allocation based on compliance milestones, preventing upfront abuse.
    By combining identity validation with progressive allocation, this pathway establishes strong trust signals for governance and ensures that DataCap is allocated to genuine, verifiable users.

Type of data

Public, open, and retrievable,Private encrypted with on-chain deal pricing

Description of Data Diligence

  1. Eligibility Assessment – Ask Client to provide data sample, and confirms that client's data aligns with FIL Plus criteria and data serves its stated purpose.
  2. Regulatory & Ownership Checks – Requires legal documentation and contracts to validate compliance and rightful data ownership.
  3. Data Integrity Sampling – Conducts periodic random inspections of data to ensure authenticity and accuracy.
  4. Automated Consistency Checks – Uses hash matching and automated scripts to verify data integrity and prevent discrepancies.
  5. Transparent Auditing – Maintains detailed logs and provides quarterly** compliance reports** for governance review.

Data Preparation

Singularity

Replicas required, verified by CID checker

2+

Distribution required

Equal distribution of deals across regions

Number of Storage Providers required

2+

Retrieval Requirements

Public data highly retrievable over Spark.

Allocation Tranche Schedule TypeManual or other allocation schedule.

Based on the Client's requested total amount of Datacap, the Datacap will be automatically calculated and distributed in the following proportions: 10% for the first allocation, 20% for the second, 35% for the third, and 35% for the fourth.

Will you use FIDL tooling, such as allocator.tech and other bots?

Yes, some tools

GitHub Bookkeeping Repo Link

https://github.com/NiwanDao/NiwanPathway

Success metrics

Speed of allocations (TTD),Amount of data onboarded, daily & aggregate

Timeline to begin allocating to clients

1 month from RKH approval

Funnel: Expected DataCap usage over 12 months

50-75PiB

Risk mitigation strategies

  • Caps the maximum DataCap allocation per client within a specified timeframe to prevent hoarding.
  • Introduces progressive trust levels, requiring new clients to gradually scale allocations based on compliance history.
  • Blacklists malicious actors and fraudulent storage providers, preventing repeat offenses.

Dispute Resolutions

Prevention & Transparency

  • Enforces clear DataCap allocation rules to minimize ambiguities.
  • Maintains immutable on-chain records of allocations and compliance checks for transparency.
  • Uses automated verification tools to ensure objective decision-making.
    Internal Dispute Resolution (Client-Level)
  • Establishes a formal appeal process for clients disputing allocations or compliance results.
  • Provides detailed audit logs to resolve discrepancies.
    External Dispute Handling (Governance-Level)
  • Submits comprehensive compliance reports to the Fil+ Governance Team for review.
  • Uses on-chain proofs and smart contract logic to justify allocation decisions.

Compliance Audit Check

We will rely on CID Checker and Spark Report as the source for now, and aggregate all client's status in self-developed allocator dashboard

Compliance Report content presented for audit

Client Diligence: KYC/KYB report on clients,Success metric: onchain report of data onboarded,Success metric: Proof of Payments from clients,Success metric: onchain data report,Data Compliance: Data Samples,Compliance: CID report,Contributions: Github repos with the tools developed.

Connections to Filecoin Ecosystem

Previous allocator,Previous notary,Storage provider,Developer

Slack ID

cabrinahuang

@martapiekarska martapiekarska added the Proposal Modifications to improve the operating of Allocator processes. label Feb 17, 2025
@NiwanDao
Copy link

I have shared two demo videos through GoogleDrive at Google Drive

It is also available at NiwanDaoGithub

@Kevin-FF-USA Kevin-FF-USA self-assigned this Feb 25, 2025
@Kevin-FF-USA Kevin-FF-USA added Allocator Application Application received from an Organization to receive DataCap and function as an Allocator Automated Pathway and removed Proposal Modifications to improve the operating of Allocator processes. labels Feb 25, 2025
@Kevin-FF-USA
Copy link
Collaborator

Hi @NiwanDao,

Thanks for submitting this and excellent to see the development! Really looking forward to this.
I've tagged this application for the automated pathway and seeking feedback (from wonderful folks who are more technical than I am that can comment on the video specifics and readme files shared.

So - to keep you updated. Have this received and will get back soon on recommendations or next steps.

@Kevin-FF-USA
Copy link
Collaborator

Hello @NiwanDao,

Continuing to work through the applications received to provide input and testing on new pathways. Just wanted to send a friendly check in on this application to keep you updated.

As these pathways develop, also wanted to keep you updated that in the coming Quarter the program will publish an updated Application form to better fast track this type of onboarding, along with a dedicated pipeline for reviews and audits. Will be introducing in the Governance Call tomorrow.

#297
(you will be able to find recordings and link to slides in this issue as well)

@Kevin-FF-USA
Copy link
Collaborator

Hi @NiwanDao,
Is there a link to the site where the Automatic pathways is operating? (for testing). If so, I can link feedback.

@NiwanDao
Copy link

Hi Kevin, thanks for your reply. The pathway has not been launched yet—for now, I’ve only created a demo video showing how it works.
The new allocator uses a smart contract to automate the process in two main parts:

It leverages a third-party tool for the KYC process.
Datacap usage is continuously monitored, and the allocator automatically signs the next tranche of Datacap for users who pass the CID checker report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Allocator Application Application received from an Organization to receive DataCap and function as an Allocator Automated Pathway
Projects
None yet
Development

No branches or pull requests

3 participants