Realms Integration

Etch uses Realms (spl-governance) for DAO governance.

Overview

Realms V3 is the standard Solana governance program:

Community and council voting
On-chain proposals and execution
Treasury management
Battle-tested by major DAOs

How Etch Uses Realms

When you enable DAO in your launch:


{
  "daoConfig": {
    "enabled": true,
    "name": "MyToken DAO",
    "type": "community",
    "quorum": 10,
    "passThreshold": 60,
    "votingPeriodHours": 72
  }
}

Etch creates:

Realm — The DAO organization
Governance — Voting rules and parameters
Treasury — Token-controlled wallet (PDA)

Governance Types

Community

Token holders vote on proposals:


{
  "daoConfig": {
    "enabled": true,
    "type": "community",
    "quorum": 10,           // 10% of tokens must vote
    "passThreshold": 60     // 60% approval to pass
  }
}

Council

Designated wallets control the DAO:


{
  "daoConfig": {
    "enabled": true,
    "type": "council",
    "council": [
      "Wallet1...",
      "Wallet2...",
      "Wallet3..."
    ],
    "councilThreshold": 2   // 2 of 3 must approve
  }
}

Hybrid

Both community and council votes required:


{
  "daoConfig": {
    "enabled": true,
    "type": "hybrid",
    "quorum": 10,
    "passThreshold": 60,
    "council": ["Wallet1...", "Wallet2..."],
    "councilThreshold": 1
  }
}

Key Parameters

Parameter	Description	Default
`name`	DAO display name	Token name + “DAO”
`quorum`	% of tokens required to vote	10%
`passThreshold`	% approval to pass	60%
`votingPeriodHours`	How long voting is open	72 hours
`treasuryVesting`	Put reserved tokens in treasury	true
`milestoneApproval`	Who approves treasury proposals (dao vs council)	“dao”

Treasury Vesting

By default, Etch puts reserved tokens in the DAO treasury:


{
  "reservePercent": 20,
  "daoConfig": {
    "enabled": true,
    "treasuryVesting": true   // 20% goes to treasury
  }
}

The DAO can then:

Create proposals to spend treasury funds
Vote on proposals (self-managed governance)
Manage token distribution

API Endpoints

Create Proposal


POST /api/dao/{mint}/proposals

Cast Vote


POST /api/dao/{mint}/proposals/{id}/vote

Deposit Tokens


POST /api/dao/{mint}/deposit

Realms UI

After creation, your DAO is live on realms.today :


https://realms.today/dao/{realm-address}

Etch uses Realms program version 3 (latest) for all DAOs.