Skip to content

Ethereum Comments Protocol

An open protocol and toolkit for onchain comments.

npm install @ecp.eth/sdk

Implementation Options

iframe (no code)

Single-line, copy and paste implementation for static sites, blogs, and basic integrations.

TypeScript SDK

Customize your own commenting UI, using an open source Ponder indexer and example code for React and React Native.

Smart Contracts

Direct contract integration for custom implementations and advanced use cases.

Technical Overview

Chain Agnostic

Identical contract interfaces across all EVM chains. Deploy on your existing chain or index across multiple.

Modular Architecture

Integrate specific components without dependencies on a full vertical stack. No vendor lock-in.

Infrastructure Layer

Functions as backend infrastructure without user-facing branding requirements or network effects.

Contract Stability

Non-upgradeable contracts and standardized interfaces ensure long-term API stability and predictable behavior.

EVM Standards

Built on established Ethereum standards and tooling. Compatible with existing infrastructure and wallets.

Gas Optimization

Optimized for L2s: ~$0.001 per comment on Base. Optional delegated signing and calldata suffix for UX.

Integration Example

import { CommentsEmbed } from '@ecp.eth/sdk/embed'
 
const baseOrigin = 'https://blog.example.com'
 
export function Comments() {
  return (
    <div>
      <h3>Comments</h3>
      <CommentsEmbed
        uri={new URL(
          window.location.pathname,
          baseOrigin
        )}
      />
    </div>
  );
}