Lux Docs

Project Settings

Configure and manage your DAO project settings

Project Settings

This guide covers how to configure and manage settings for your DAO project. Settings control governance parameters, token configurations, access permissions, and more.

Overview

Project settings are organized into categories:

┌─────────────────────────────────────────────────────────────────┐
│                      Settings Overview                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │   General    │  │  Governance  │  │    Tokens    │           │
│  │   Settings   │  │   Settings   │  │   Settings   │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
│                                                                   │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │    Access    │  │  Treasury    │  │  Integrations│           │
│  │   Control    │  │   Settings   │  │              │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘

Settings Categories

Accessing Settings

Admin Access

To modify settings, you need admin permissions:

  1. Navigate to Project > Settings
  2. Select the category you want to modify
  3. Make changes and save
  4. Changes may require governance approval
┌─────────────────────────────────────────────────────────────────┐
│  Project Settings                          [Admin Required]      │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │ Navigation                                                   │ │
│  │                                                              │ │
│  │ ▸ General                                                    │ │
│  │ ▸ Governance                                                 │ │
│  │ ▸ Tokens                                                     │ │
│  │ ▸ Access Control                                             │ │
│  │ ▸ Treasury                                                   │ │
│  │ ▸ Integrations                                               │ │
│  │ ▸ Advanced                                                   │ │
│  │                                                              │ │
│  └─────────────────────────────────────────────────────────────┘ │
│                                                                   │
│  Select a category to view and modify settings                   │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘

Permission Levels

LevelCan ViewCan ModifyRequires Vote
MemberYesNoN/A
ContributorYesLimitedNo
AdminYesYesSome settings
OwnerYesYesCritical settings

Settings Change Process

Immediate Changes

Some settings can be changed immediately by admins:

  • Project name and description
  • External links
  • Notification preferences
  • Display settings

Governance-Required Changes

Critical settings require governance approval:

┌────────────────────────────────────────────────────────────────┐
│                                                                  │
│  Settings Change Flow                                            │
│  ───────────────────                                            │
│                                                                  │
│  1. Admin proposes change                                        │
│  2. System creates governance proposal                           │
│  3. Token holders vote                                           │
│  4. If passed, change enters timelock                            │
│  5. After timelock, change is applied                            │
│                                                                  │
│  Timeline: 7-14 days typical                                     │
│                                                                  │
└────────────────────────────────────────────────────────────────┘

Settings requiring governance:

  • Voting period changes
  • Quorum threshold changes
  • Token configurations
  • Access control modifications
  • Treasury parameters

Settings Summary

General Settings

SettingDescriptionRequires Vote
Project NameDisplay nameNo
DescriptionProject descriptionNo
LogoProject logo/avatarNo
LinksWebsite, social linksNo
ContactSupport emailNo

Governance Settings

SettingDescriptionRequires Vote
Voting PeriodHow long votes are openYes
Timelock DelayDelay before executionYes
Proposal ThresholdTokens needed to proposeYes
QuorumMinimum participationYes

Token Settings

SettingDescriptionRequires Vote
Governance TokenToken used for votingYes
Lock ParametersMin/max lock durationsYes
MultipliersTime-based multipliersYes

Treasury Settings

SettingDescriptionRequires Vote
Spending LimitsPer-transaction limitsYes
Approved TokensTokens treasury can holdYes
Reserve RequirementsMinimum reservesYes

Best Practices

Before Changing Settings

  1. Understand Impact

    • How will this affect governance?
    • Are there unintended consequences?
    • Have similar changes been made elsewhere?
  2. Communicate

    • Discuss changes in forum/Discord
    • Gather community feedback
    • Build consensus before proposing
  3. Test First

    • Use testnet when possible
    • Simulate changes
    • Review with other admins

Making Changes

  1. Document Rationale

    • Why is this change needed?
    • What problem does it solve?
    • What alternatives were considered?
  2. Propose Conservatively

    • Make incremental changes
    • Avoid changing multiple settings at once
    • Allow time to observe effects
  3. Monitor After

    • Watch for unexpected behavior
    • Gather feedback
    • Be ready to adjust

Troubleshooting

"Permission Denied"

Causes:

  • Insufficient role permissions
  • Settings require governance vote
  • Connected with wrong wallet

Solutions:

  • Verify your role level
  • Check if setting requires proposal
  • Connect with admin wallet

"Change Not Applied"

Causes:

  • Change pending governance vote
  • In timelock queue
  • Transaction failed

Solutions:

  • Check proposal status
  • Wait for timelock to expire
  • Retry the transaction

"Invalid Value"

Causes:

  • Value out of allowed range
  • Incorrect format
  • Conflicts with other settings

Solutions:

  • Check allowed ranges
  • Use correct format (numbers, addresses, etc.)
  • Resolve conflicts with related settings

Next Steps

On this page