Add ERC: Intent spec for contracts by collinsadi · Pull Request #1557 · ethereum/ERCs

collinsadi · 2026-02-21T15:23:42Z

This PR introduces a draft ERC defining a standardized, machine-readable semantic metadata layer for smart contracts.

The proposal specifies:

An ERC-165 discoverable interface (IIntentSpec) exposing a metadata URI.
A canonical JSON schema defining contract-level and function-level semantic intent.
Normative requirements for metadata resolution and schema compliance.

The goal is to provide a structured documentation layer enabling automated systems to reason about contract behavior prior to execution.

This ERC is complementary to ERC-8004. While ERC-8004 standardizes identity, reputation, and validation primitives for autonomous agents, this proposal standardizes semantic intent disclosure at the contract level.

Discussion thread:
To be opened on Ethereum Magicians.

eip-review-bot · 2026-02-21T15:24:04Z

File `ERCS/erc-8174.md`

Requires 1 more reviewers from @g11tech, @jochem-brouwer, @samwilsn, @xinbenlv

abcoathup · 2026-02-23T00:36:02Z

@collinsadi your PR includes 3 files, please remove the duplicate files.

collinsadi · 2026-02-25T02:51:48Z

@abcoathup I’ve completed that step, but I haven’t been able to start a discussion on Ethereum Magicians yet since I’m new to the platform.

abcoathup · 2026-02-25T03:00:32Z

What is your user name?

collinsadi · 2026-02-25T03:02:58Z

@abcoathup Collins Adi

collinsadi · 2026-02-25T03:04:20Z

@collinsadi

abcoathup · 2026-02-26T11:03:15Z

@@ -0,0 +1,256 @@
+---


Suggested change

---

---

eip: 8174

Assigning next sequential EIP/ERC/RIP number.
Numbers are assigned by editors & associates.

Please also update the filename.

abcoathup · 2026-02-26T11:05:29Z

@@ -0,0 +1,256 @@
+---
+title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)


Suggested change

title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)

title: Intent spec for contracts

Title needs to be 44 characters or less. Note: I am NOT an editor.

abcoathup · 2026-02-26T11:06:13Z

+---
+title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)
+description: A standard for machine-verifiable semantic metadata to enable autonomous agent reasoning
+author: Collins Adi <@collinsadi>


Suggested change

author: Collins Adi <@collinsadi>

author: Collins Adi (@collinsadi)

abcoathup · 2026-02-26T11:07:01Z

+title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)
+description: A standard for machine-verifiable semantic metadata to enable autonomous agent reasoning
+author: Collins Adi <@collinsadi>
+discussions-to:


Please create a discussions topic on Eth Magicians. I have bumped your permissions so you can create one. It needs to include a link to this PR.

abcoathup · 2026-02-26T11:09:10Z

+
+This proposal defines a standard for attaching machine-readable semantic manifests to Ethereum smart contracts. It specifies:
+
+1. An ERC-165 discoverable interface (`IIntentSpec`) exposing a metadata URI.


Suggested change

1. An ERC-165 discoverable interface (`IIntentSpec`) exposing a metadata URI.

1. An [ERC-165](./eip-165.md) discoverable interface (`IIntentSpec`) exposing a metadata URI.

abcoathup · 2026-02-26T11:09:31Z

+
+## Motivation
+
+This ERC is complementary to ERC-8004.


Suggested change

This ERC is complementary to ERC-8004.

This ERC is complementary to [ERC-8004](./eip-8004.md).

collinsadi · 2026-03-01T16:20:50Z

@abcoathup Thanks for the feedbacks, working on them

github-actions · 2026-03-01T17:01:54Z

The commit 3b4bb29 (as a parent of 22f0a3f) contains errors.
Please inspect the Run Summary for details.

collinsadi added 2 commits February 21, 2026 16:14

Add ERC: Intent Spec (Agent-Readable Smart Contract Documentation Layer)

5aeca1c

Change: updated author name from brackets to angles

03b7f34

collinsadi requested a review from eip-review-bot as a code owner February 21, 2026 15:23

github-actions bot added c-new s-draft t-erc labels Feb 21, 2026

eip-review-bot added e-consensus e-review labels Feb 21, 2026

eip-review-bot changed the title ~~Add ERC: Intent Spec (Agent-Readable Smart Contract Documentation Layer)~~ Add ERC: Agent-Readable Smart Contract Documentation Layer (Intent Spec) Feb 21, 2026

collinsadi added 2 commits February 21, 2026 16:27

Rename file to ERC-XXXX.md for submission

8796df7

Rename file to ERC-2004.md for submission

fc0e00a

github-actions bot added the w-ci label Feb 21, 2026

collinsadi added 2 commits February 25, 2026 03:47

Delete ERCS/erc-intent-spec.md

a709a85

Delete ERCS/erc-XXXX.md

704f9cb

github-actions bot removed the w-ci label Feb 25, 2026

github-actions bot added the w-ci label Feb 25, 2026

abcoathup reviewed Feb 26, 2026

View reviewed changes

chore: modified draft based on Pull Request feedbacks and suggestions

a30992d

chore: modified draft based on Pull Request feedbacks and suggestions

a79e381

eip-review-bot changed the title ~~Add ERC: Agent-Readable Smart Contract Documentation Layer (Intent Spec)~~ Add ERC: Intent spec for contracts Mar 1, 2026

github-actions bot removed the w-ci label Mar 1, 2026

chore: modified draft based on feedbacks and comments on github

3b4bb29

github-actions bot added the w-ci label Mar 1, 2026

chore: changed referenced from erc-* to eip-*, to fix build errors

e631cc8

github-actions bot removed the w-ci label Mar 5, 2026

collinsadi requested a review from abcoathup March 5, 2026 18:37

collinsadi added 2 commits March 17, 2026 12:38

Merge branch 'master' into erc-intent-spec

92171bc

Merge branch 'master' into erc-intent-spec

0d1cf11

		@@ -0,0 +1,256 @@
		---
		title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)

	title: Agent-Readable Smart Contract Documentation Layer (Intent Spec)
	title: Intent spec for contracts

	author: Collins Adi <@collinsadi>
	author: Collins Adi (@collinsadi)


		This proposal defines a standard for attaching machine-readable semantic manifests to Ethereum smart contracts. It specifies:

		1. An ERC-165 discoverable interface (`IIntentSpec`) exposing a metadata URI.

	1. An ERC-165 discoverable interface (`IIntentSpec`) exposing a metadata URI.
	1. An [ERC-165](./eip-165.md) discoverable interface (`IIntentSpec`) exposing a metadata URI.

	This ERC is complementary to ERC-8004.
	This ERC is complementary to [ERC-8004](./eip-8004.md).

Conversation

collinsadi commented Feb 21, 2026

Uh oh!

eip-review-bot commented Feb 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

File ERCS/erc-8174.md

Uh oh!

abcoathup commented Feb 23, 2026

Uh oh!

collinsadi commented Feb 25, 2026

Uh oh!

abcoathup commented Feb 25, 2026

Uh oh!

collinsadi commented Feb 25, 2026

Uh oh!

collinsadi commented Feb 25, 2026

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

abcoathup Feb 26, 2026

Choose a reason for hiding this comment

Uh oh!

collinsadi commented Mar 1, 2026

Uh oh!

github-actions bot commented Mar 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

eip-review-bot commented Feb 21, 2026 •

edited

Loading

File `ERCS/erc-8174.md`