ERC-6372 — Contract Clock

Back to DeFi Building Blocks

ERC-6372: Contract Clock for Governance

A meta-standard that pairs with ERC-5805. Every governance contract advertises its timekeeping mode via two methods:

• clock() returns the current "time" in the contract's chosen unit.
• CLOCK_MODE() returns a machine-readable string like mode=blocknumber&from=default or mode=timestamp.

This lets governance frontends and oracles work uniformly across token contracts that use block numbers vs timestamps.

Neo Equivalent

The Neo C# port simply exposes both methods, returning Ledger.CurrentIndex (block number) or Runtime.Time (millisecond timestamp).

Live on Neo TestNet

Both implementations deployed on Neo N3 TestNet.

Implementation	TestNet Address	Contract Hash
Solidity (neo-solc)	NPrkGGCSZwLTUQxzUQnf4WSKsk2rZPTSKt	0xe3c55758…df77442b
Neo C# (nccs)	NQpFbsh7JUys9dYhB86gCVr2hxfYkzKJYw	0xeb454a6b…1ed6c335

Verified: CLOCK_MODE returns "mode=blocknumber&from=default" from both. The Neo C# version uses Ledger.CurrentIndex directly. docs/standards-mirror/deployments/erc-6372/.

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

interface IERC6372 {
    function clock() external view returns (uint48);
    function CLOCK_MODE() external view returns (string memory);
}

contract BlockClockGov is IERC6372 {
    function clock() public view returns (uint48) { return uint48(block.number); }
    function CLOCK_MODE() public pure returns (string memory) {
        return "mode=blocknumber&from=default";
    }
}

contract TimestampClockGov is IERC6372 {
    function clock() public view returns (uint48) { return uint48(block.timestamp); }
    function CLOCK_MODE() public pure returns (string memory) { return "mode=timestamp"; }
}

using Neo;
using Neo.SmartContract.Framework;
using Neo.SmartContract.Framework.Attributes;
using Neo.SmartContract.Framework.Native;

namespace R3E.Examples;

[DisplayName("BlockClockGovernance")]
public class BlockClockGovernance : SmartContract
{
    public static uint   Clock()      => Ledger.CurrentIndex;
    [Safe]
    public static string ClockMode()  => "mode=blocknumber&from=default";
}

[DisplayName("TimestampClockGovernance")]
public class TimestampClockGovernance : SmartContract
{
    // EIP-6372 `mode=timestamp` is unix seconds — Runtime.Time is unix ms,
    // so divide by 1000 to match the spec's default unit.
    public static ulong  Clock()      => Runtime.Time / 1000;
    [Safe]
    public static string ClockMode()  => "mode=timestamp";
}

Ledger.CurrentIndex is the block number; Runtime.Time is the block-time in milliseconds since unix epoch (the timestamp clock divides by 1000 so its value matches the seconds-precision unit that EIP-6372 governance frontends assume). Both are deterministic per-block primitives.