Settlus L2 docs
  • About Settlus
    • What is Settlus?
    • Key Features
    • Mission: Shift the power from platforms to creators
  • Getting Started
    • Prerequisites
    • Accessing the Testnet
  • Smart Contracts
    • Settlus Smart Contracts
    • For Tenant
    • For DApp Developers
  • Technical Details
    • Network Information
    • Contract addresses
      • Mainnet
      • Testnet
    • Run a node
  • Infrastructure Providers
    • Nodes
    • Bridges
    • Block Explorers
  • Settlus Web
Powered by GitBook
On this page
  • For Tenant
  • What is Tenant and Who Can Become a Tenant?
  • How to create a Tenant on Settlus
  • Why Does It Cost Money to Become a Tenant?
  • Benefits of Becoming a Tenant
  1. Smart Contracts

For Tenant

PreviousSettlus Smart ContractsNextFor DApp Developers

Last updated 3 months ago

For Tenant

The Settlus platform is designed to empower creators by enabling platforms and organizations to become tenants and manage payouts, transactions, and collaborations seamlessly. Becoming a tenant on Settlus is straightforward and open to anyone who meets the requirements. However, a small cost is required to ensure only serious and dedicated platforms participate, fostering a high-quality ecosystem.


What is Tenant and Who Can Become a Tenant?

Tenant represents a unique entity or organization on the Settlus platform. Any platform, organization, or individual that wishes to leverage Settlus’ infrastructure to manage creator payouts, transactions, or collaborations can become a tenant. Common examples include:

  • Content creation platforms

  • Digital marketplaces

  • Music and video streaming services

  • NFT or token-based communities

Whether you’re a startup or an established platform, Settlus offers the tools and scalability to manage your operations effectively.


How to create a Tenant on Settlus

1. Requirements

To become a tenant, you’ll need to:

  • Have an Ethereum-compatible wallet to interact with the Settlus contracts.

  • Cover the onboarding cost (payable in ETH) to ensure participation by serious platforms only.

  • Provide the necessary tenant details, such as a unique name, currency type, and payout configurations.

2. Tenant Creation Process

Becoming a tenant involves the following steps:

  1. Initiate Tenant Creation:

    • Use the TenantManager contract to create a new tenant.

    • Provide details like the tenant’s name, preferred currency type (ETH, ERC20, or mintable tokens), and payout period.

    • Tenants can either create new contracts required for settlement through the TenantManager or reuse existing contracts you've been using.

    Example call with existing token contract:

    createTenant("YourTenantName", Tenant.CurrencyType.ETH, address(0), 604800); // 604800 seconds = 7 days
  2. Pay the Setup Fee:

    • A setup fee is required to finalize the tenant creation process. This fee ensures commitment from the tenant and supports the network’s operations. Initially, it is set to 0.01 eth.

  3. Configure Tenant Details:

    • After creation, tenants can configure additional parameters, such as administrative roles and payout periods.

    • If an existing contract is connected to the tenant, the tenant must be granted permission to access the contract. For an ERC20 contract, the tenant must have the authority to call the transfer function. For a Mintable contract, the tenant must have the authority to call the mint function.

3. Cost Structure

The cost to become a tenant is set at a level to prevent spam registrations while remaining accessible to serious platforms. This cost is subject to periodic reviews to ensure it aligns with network economics and the needs of the ecosystem.


Why Does It Cost Money to Become a Tenant?

Requiring a fee to become a tenant serves several purposes.:

  1. Encourages Serious Participation:

    • By requiring a financial commitment, Settlus ensures only serious and dedicated platforms onboard, creating a high-quality ecosystem.

  2. Reduces Spam:

    • The cost acts as a deterrent for spam or malicious registrations, protecting the integrity of the network.

  3. Supports Network Sustainability:

    • The fee contributes to maintaining and upgrading the network, ensuring it continues to serve tenants and creators effectively.


Benefits of Becoming a Tenant

1. Efficient Payout Management

Automate the payout process to creators through the use of UTXRs (off-chain transaction records), saving time and reducing administrative overhead.

2. Customizable Ecosystem

Tailor your tenant settings, including payment methods (ETH, ERC20, or mintable tokens), payout periods, and administrative roles, to suit your platform’s needs.

3. Transparent Transactions

Leverage blockchain’s immutability to maintain trust and transparency with creators and collaborators.

4. Seamless Creator Economy Integration

Integrate with the broader Settlus ecosystem to unlock tools and services that enhance your platform’s functionality and user experience.


Becoming a tenant on Settlus positions your platform as part of an ecosystem dedicated to empowering creators. For detailed technical instructions on onboarding, refer to the Developer Guide or explore tenant-specific smart contract APIs in the Technical Reference.

How EOA can create Tenant