{
  "$schema": "https://degreesofsatoshi.com/encyclopedia/schemas/article-v1.json",
  "schemaVersion": "1.0.0",
  "id": "governance-timelocks",
  "canonical": "https://degreesofsatoshi.com/encyclopedia/governance-timelocks/",
  "collection": "defi",
  "title": "Governance timelocks: a delay, not an automatic veto",
  "description": "Understand governance execution delays, distinguish voting from scheduling and execution, and inspect which privileged actions a timelock actually controls.",
  "aliases": [],
  "dates": {
    "published": "2026-10-02",
    "modified": "2026-10-02",
    "verified": "2026-10-02T18:19:48.887Z",
    "dataAsOf": "2026-10-02"
  },
  "authorship": {
    "publisher": "Degrees of Satoshi editorial project",
    "process": "AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied."
  },
  "quickAnswer": {
    "text": "A governance timelock delays eligible actions between scheduling and execution. In OpenZeppelin’s Governor example, a successful proposal is queued, waits the configured delay and can then be executed. The delay creates an observation period; it does not prove the proposal is safe, guarantee that users can exit or automatically constrain powers held outside the timelock.",
    "claimId": "governance-timelocks-quick-answer",
    "sourceIds": [
      "oz-governance"
    ]
  },
  "keyFacts": [
    {
      "label": "Sequence",
      "value": "With a timelock, the documented proposal flow includes queueing before execution.",
      "sourceIds": [
        "oz-governance"
      ],
      "id": "sequence",
      "claimId": "governance-timelocks-fact-sequence"
    },
    {
      "label": "Delay",
      "value": "Execution must wait for the configured delay after scheduling.",
      "sourceIds": [
        "oz-governance"
      ],
      "id": "delay",
      "claimId": "governance-timelocks-fact-delay"
    },
    {
      "label": "Authority",
      "value": "The timelock needs the assets or permissions required to execute the governed action.",
      "sourceIds": [
        "oz-governance"
      ],
      "id": "authority",
      "claimId": "governance-timelocks-fact-authority"
    }
  ],
  "prerequisites": [
    "decentralized-autonomous-organizations"
  ],
  "sections": [
    {
      "id": "example",
      "heading": "Start the waiting period at the right event",
      "sourceIds": [
        "oz-governance"
      ],
      "paragraphs": [
        "If a hypothetical proposal finishes voting on Monday but is queued on Tuesday with a two-day delay, the execution waiting period starts with queueing under that configuration. It does not necessarily start when the vote was first proposed.",
        "The example is illustrative. Actual contracts determine the clock, minimum delay and whether the proposal has been scheduled successfully."
      ]
    },
    {
      "id": "execution",
      "heading": "Time passing does not send a transaction",
      "sourceIds": [
        "oz-governance"
      ],
      "paragraphs": [
        "After the required delay, an eligible actor still needs to execute the operation. The target call can also depend on permissions, balances and other state.",
        "A proposal can therefore be successful at voting yet remain unexecuted. Follow the proposal’s execution status and resulting transaction rather than treating a favorable vote as proof the requested change already happened."
      ]
    },
    {
      "id": "coverage",
      "heading": "Trace every route to the privileged action",
      "sourceIds": [
        "oz-governance"
      ],
      "paragraphs": [
        "OpenZeppelin’s setup places control in the timelock so the Governor’s decisions follow the delayed execution path. Separate administrators or other privileged roles require their own examination.",
        "Ask what the timelock controls, who can propose or execute operations and how its permissions are configured. A delay helps observers react only when they can identify the action and have meaningful response options; it is not a substitute for reviewing the proposal itself."
      ]
    }
  ],
  "faq": [
    {
      "question": "Does every DAO vote have a mandatory timelock?",
      "answer": "No. OpenZeppelin’s Governor tutorial explicitly supports configurations with or without one. The deployed governance modules and permissions determine whether a delay is enforced.",
      "sourceIds": [
        "oz-governance"
      ]
    }
  ],
  "claims": [
    {
      "id": "governance-timelocks-quick-answer",
      "articleSlug": "governance-timelocks",
      "statement": "A governance timelock delays eligible actions between scheduling and execution. In OpenZeppelin’s Governor example, a successful proposal is queued, waits the configured delay and can then be executed. The delay creates an observation period; it does not prove the proposal is safe, guarantee that users can exit or automatically constrain powers held outside the timelock.",
      "sourceIds": [
        "source-5ae9ea0050b20bf7"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-5ae9ea0050b20bf7",
          "locator": "Voting token; Governor; Timelock"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:19:48.887Z",
        "reviewer": "automated independent verification — Codex root, separate from final-ten DeFi author",
        "notes": [
          "Read OpenZeppelin Governor Timelock/Queue-and-execute plus role configuration. Delay starts at scheduling; execution needs a call and authority; optional modules and bypass roles retained. Two-day hypothetical is explicitly not a live delay."
        ]
      }
    },
    {
      "id": "governance-timelocks-fact-sequence",
      "articleSlug": "governance-timelocks",
      "statement": "Sequence: With a timelock, the documented proposal flow includes queueing before execution.",
      "sourceIds": [
        "source-5ae9ea0050b20bf7"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-5ae9ea0050b20bf7",
          "locator": "Voting token; Governor; Timelock"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:19:48.887Z",
        "reviewer": "automated independent verification — Codex root, separate from final-ten DeFi author",
        "notes": [
          "Read OpenZeppelin Governor Timelock/Queue-and-execute plus role configuration. Delay starts at scheduling; execution needs a call and authority; optional modules and bypass roles retained. Two-day hypothetical is explicitly not a live delay."
        ]
      }
    },
    {
      "id": "governance-timelocks-fact-delay",
      "articleSlug": "governance-timelocks",
      "statement": "Delay: Execution must wait for the configured delay after scheduling.",
      "sourceIds": [
        "source-5ae9ea0050b20bf7"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-5ae9ea0050b20bf7",
          "locator": "Voting token; Governor; Timelock"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:19:48.887Z",
        "reviewer": "automated independent verification — Codex root, separate from final-ten DeFi author",
        "notes": [
          "Read OpenZeppelin Governor Timelock/Queue-and-execute plus role configuration. Delay starts at scheduling; execution needs a call and authority; optional modules and bypass roles retained. Two-day hypothetical is explicitly not a live delay."
        ]
      }
    },
    {
      "id": "governance-timelocks-fact-authority",
      "articleSlug": "governance-timelocks",
      "statement": "Authority: The timelock needs the assets or permissions required to execute the governed action.",
      "sourceIds": [
        "source-5ae9ea0050b20bf7"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-5ae9ea0050b20bf7",
          "locator": "Voting token; Governor; Timelock"
        }
      ],
      "scope": {
        "collection": "defi",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T18:19:48.887Z",
        "reviewer": "automated independent verification — Codex root, separate from final-ten DeFi author",
        "notes": [
          "Read OpenZeppelin Governor Timelock/Queue-and-execute plus role configuration. Delay starts at scheduling; execution needs a call and authority; optional modules and bypass roles retained. Two-day hypothetical is explicitly not a live delay."
        ]
      }
    }
  ],
  "sources": [
    {
      "id": "oz-governance",
      "label": "How to set up on-chain governance",
      "publisher": "OpenZeppelin",
      "url": "https://docs.openzeppelin.com/contracts/5.x/governance",
      "locator": "Voting token; Governor; Timelock",
      "note": "Delegation, historical checkpoints, quorum and execution delays.",
      "version": "OpenZeppelin Contracts 5.x",
      "checkedAt": "2026-10-02T17:03:45.975Z",
      "contentSha256": "19ce3f01a1c3b81e2d8939e6b1efb114008622ff01fa96c3ac838a44ae011697",
      "recordId": "source-5ae9ea0050b20bf7"
    }
  ],
  "related": {
    "articles": [
      "governance-delegation",
      "protocol-upgrades-and-admin-powers",
      "smart-contract-audits"
    ],
    "dossiers": [],
    "wallets": []
  },
  "revisionHistory": [
    {
      "date": "2026-10-02",
      "kind": "published",
      "summary": "First publication after primary-source research and independent automated verification."
    }
  ],
  "citation": "Degrees of Satoshi editorial project. “Governance timelocks: a delay, not an automatic veto.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/governance-timelocks/"
}