CIFI Ecosystem
  • CIFI 2.0 - Beyond Smart Cities
    • From Web2 to Web4 & Beyond
    • Society 5.0: Smart Cities and Integrated Systems
    • The Six Layers of Value Exchange
    • Micro-Economies: The Building Blocks of Society 6.0
    • Net Zero Financing: Aligning Capital with Planetary Health
    • AI and the New Computational Economy
    • Catalyzing the Transition to Society 6.0 Through Regenerative Finance
    • The 100 Day Incubator: Cultivating the Regenerative Economy
    • Creating NetZero Financing for Global Trade
    • Tokenizing Natural Capital: A New Asset Class for Preservation
    • Universal Data Points and Global Incentive Programs
    • The CUSD Stablecoin: Connecting Traditional Finance with Regenerative Economics
    • Smart Markets and Climate Finance Integration
    • Educational Impact and Capacity Building
    • The Role of the 100 Day Incubator
    • The Asset Tokenization Revolution
    • Smart Cities and Society 5.0 Integration
    • Creating a Multi-Stakeholder Economy
    • The Power of a Dual Token Ecosystem in Society 6.0
  • Build With CIFI
    • Community Contribution to Ecosystem Growth
    • Integration with the 100 Day Incubator
    • The CIFI Product Ecosystem
    • The Playground as Ecosystem Accelerator
  • Give With REFI Net
    • Technical Architecture: The Three Pillars of REFI Net
    • REFI Net for Philanthropy: Empowering Positive Global Impact
    • Smart Markets: Embedding Philanthropy into Economic Systems
    • Implementation for REFI Projects: The Incubator Connection
    • The Future of REFI Net: Evolving the System
  • Governance Of Circularity
    • The Three DAOs: Specialized Governance Bodies
    • The Technical Infrastructure: CIFI Town Hall System
    • From Centralization to Full Decentralization
    • Maximizing Token Value Through Governance Participation
    • Building on Circularity Finance: Governance as an Integration Point
    • Case Studies: Governance in Action
Powered by GitBook
On this page
  1. Give With REFI Net

Technical Architecture: The Three Pillars of REFI Net

The Enterprise Payment System is built on three interconnected smart contracts, each serving a specific function in the overall value distribution ecosystem. Understanding these contracts is essential to grasping the full potential of REFI Net.

ProfitDistributionEnhanced: Equitable Distribution to NFT Holders

The ProfitDistributionEnhanced contract enables the distribution of funds (both native blockchain currency and ERC20 tokens) to holders of specific NFT collections based on configurable templates.

Key Features:

  • Distribution Instances: Creates distribution configurations specifying how funds should be allocated among different NFT collections.

  • Percentage-Based Allocation: Each NFT collection receives a defined percentage of the total distributed funds.

  • Equitable Distribution: Within each collection, funds are divided equally among all NFT holders.

  • Flexible Distribution Methods: Supports both immediate distribution and batch-based distribution for gas efficiency.

  • Templated Configurations: Enables the creation of reusable templates that can be cloned to new instances.

  • Multi-Token Support: Handles distribution of both native blockchain currency (ETH, XDC, etc.) and any ERC20 tokens.

Technical Operation:

When funds are sent to the ProfitDistributionEnhanced contract, the distribution process follows these steps:

  1. The contract identifies the appropriate distribution instance to use.

  2. It calculates the amount allocated to each NFT collection based on the configured percentages.

  3. For each collection, it determines the per-NFT allocation by dividing the collection's total by the number of NFTs.

  4. It distributes the appropriate amount to each NFT holder, either immediately or in batches.

Use Cases in Philanthropy:

  • Impact NFTs: Organizations can issue NFTs representing impact contributions, with holders receiving a share of project revenues.

  • Governance-Weighted Donations: Communities can vote on donation recipients through governance NFTs, with distribution weighted by NFT holdings.

  • Recognition Systems: Philanthropic contributions can be recognized through NFTs that entitle holders to a share of future proceeds.

FeeSplitter: Precise Allocation to Specified Recipients

The FeeSplitter contract distributes funds to specific addresses based on percentage shares defined in templates.

Key Features:

  • Distribution Templates: Creates configurations specifying how funds should be split among various recipients.

  • Percentage-Based Allocation: Each recipient receives a specific percentage of the distributed funds.

  • Multiple Distribution Methods: Supports both manual distribution and automatic distribution through token hooks (ERC223/677).

  • Template Management: Templates can be updated or deactivated as organizational needs evolve.

  • Multi-Token Support: Handles distribution of both native blockchain currency and any ERC20 tokens.

  • Efficient Gas Usage: Optimized for minimal gas consumption during distribution operations.

Technical Operation:

The FeeSplitter contract operates through the following process:

  1. A distribution template is created, specifying recipient addresses and their percentage shares.

  2. When funds are sent to the contract, it identifies the appropriate template to use.

  3. For each recipient in the template, it calculates their share based on the configured percentage.

  4. It transfers the appropriate amount to each recipient's address.

Use Cases in Philanthropy:

  • Automatic Donations: Projects can automatically allocate a percentage of every transaction to specified nonprofits.

  • Multi-Cause Support: A single transaction can be distributed across multiple charitable organizations based on predetermined ratios.

  • Transparent Giving: All distributions are recorded on-chain, creating immutable records of philanthropic contributions.

  • Coalition Funding: Alliances of nonprofits can receive proportional funding through a single entry point.

DripPaymentManager: Scheduled Value Distribution

The DripPaymentManager contract manages recurring payments that can be directed to either the FeeSplitter or ProfitDistributionEnhanced contracts.

Key Features:

  • Payment Streams: Creates configurations specifying frequency, amount, and target for recurring payments.

  • Automated Execution: Automatically checks if payments are due and distributes them accordingly.

  • Flexible Targeting: Can direct payments to either FeeSplitter templates or ProfitDistributionEnhanced instances.

  • Stream Management: Allows modifying or deactivating payment streams as needed.

  • Multi-Token Support: Configures separate streams for different token types.

  • Permissioned Control: Includes appropriate access controls to ensure only authorized parties can modify streams.

Technical Operation:

The DripPaymentManager operates through this process:

  1. A payment stream is created, specifying the frequency, amount, token type, and target (either a FeeSplitter template or a ProfitDistributionEnhanced instance).

  2. At regular intervals, the contract checks if any payments are due based on the configured frequencies.

  3. For each due payment, it transfers the specified amount to the appropriate target contract.

  4. The target contract then handles the distribution according to its configured rules.

Use Cases in Philanthropy:

  • Sustainable Funding: Nonprofits can receive predictable, recurring funding rather than one-time donations.

  • Tithe Automation: Organizations can implement automatic "tithing" of a percentage of revenues at regular intervals.

  • Grant Disbursement: Foundations can schedule grant payments to be distributed over time rather than as lump sums.

  • Budget Alignment: Donations can be synchronized with organizational fiscal calendars for better planning.

System Integration: The Complete Value Distribution Ecosystem

These three contracts form a modular, integrated system that handles the complete lifecycle of value distribution:

  • DripPaymentManager manages the "when" of distribution, handling scheduling and triggering of payments.

  • FeeSplitter and ProfitDistributionEnhanced manage the "how" of distribution, determining who receives funds and in what proportions.

This integration creates a powerful, flexible system where:

  1. Recurring payments can be scheduled through DripPaymentManager.

  2. When payments are due, DripPaymentManager calls either FeeSplitter or ProfitDistributionEnhanced.

  3. The receiving contract distributes the funds according to its configured rules, either to specific addresses (FeeSplitter) or NFT holders (ProfitDistributionEnhanced).

The modular design allows for complex distribution strategies that can evolve over time, creating a foundation for sophisticated economic models that seamlessly incorporate philanthropic giving.

PreviousGive With REFI NetNextREFI Net for Philanthropy: Empowering Positive Global Impact

Last updated 24 days ago