{"id":20841272,"url":"https://github.com/iotexproject/iips","last_synced_at":"2026-02-14T02:33:11.530Z","repository":{"id":39758185,"uuid":"187737141","full_name":"iotexproject/iips","owner":"iotexproject","description":"This repository contains IoTeX Improvement Proposals, detailing standards and protocols for the IoTeX blockchain. It is designed for the community to discuss, propose, and implement enhancements to the IoTeX ecosystem. Engage with the development process and contribute to the future of IoTeX by reviewing and submitting proposals.","archived":false,"fork":false,"pushed_at":"2025-09-12T16:55:10.000Z","size":1834,"stargazers_count":22,"open_issues_count":9,"forks_count":3,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-09-12T18:57:24.378Z","etag":null,"topics":["governance","improvement-proposals","iotex"],"latest_commit_sha":null,"homepage":"https://docs.iotex.io/depin-infra-modules-dim/iotex-l1-depin-blockchain/staking-and-governance/join-the-governance/improvement-proposals","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iotexproject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-05-21T01:12:49.000Z","updated_at":"2025-09-12T16:55:15.000Z","dependencies_parsed_at":"2023-12-06T02:59:47.019Z","dependency_job_id":"a739e9be-658e-4d77-aa3a-5508756a209b","html_url":"https://github.com/iotexproject/iips","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iotexproject/iips","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiips","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiips/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiips/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiips/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iotexproject","download_url":"https://codeload.github.com/iotexproject/iips/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotexproject%2Fiips/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277088731,"owners_count":25758763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-26T02:00:09.010Z","response_time":78,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["governance","improvement-proposals","iotex"],"created_at":"2024-11-18T01:19:31.522Z","updated_at":"2025-09-26T13:54:13.153Z","avatar_url":"https://github.com/iotexproject.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# What is a IIP?\n\nIIP stands for IoTeX Improvement Proposal. An IIP is a design document providing information to the IoTeX community, or\ndescribing a new feature for IoTeX or its processes or environment. The IIP should provide a concise technical\nspecification of the feature and a rationale for the feature.\n\nWe intend IIPs to be the primary mechanisms for proposing new features, for collecting community input on an issue, and\nfor documenting the design decisions that have gone into IoTeX. The IIP author is responsible for building consensus\nwithin the community and documenting dissenting opinions.\n\nBecause the IIPs are maintained as text files in a versioned repository, their revision history is the historical record\nof the feature proposal.\n\n# IIP Types\n\nThere are three kinds of IIP:\n\n- A Standards Track IIP describes any change that affects most or all IoTeX implementations, such as a change to the\nnetwork protocol, a change in block or transaction validity rules, or any change or addition that affects the\ninteroperability of applications using IoTeX.\n\n- An Informational IIP describes an IoTeX design issue, or provides general guidelines or information to the IoTeX\ncommunity, but does not propose a new feature. Informational IIPs do not necessarily represent an IoTeX community\nconsensus or recommendation, so users and implementors are free to ignore Informational IIPs or follow their advice.\n\n- A Process IIP describes a process surrounding IoTeX, or proposes a change to (or an event in) a process. Process IIPs\nare like Standards Track IIPs but apply to areas other than the IoTeX protocol itself. They may propose an\nimplementation, but not to IoTeX's codebase; they often require community consensus; unlike Informational IIPs, they are\nmore than recommendations, and users are typically not free to ignore them. Examples include procedures, guidelines,\nchanges to the decision-making process, and changes to the tools or environment used in IoTeX development. Any meta-IIP\nis also considered a Process IIP.\n\n# IoTeX Improvement Proposal (IIP) Lifecycle\n\n## 1. Draft\n- An initial specification is written by the proposer.  \n- At this stage, the IIP is informal and subject to major revisions.\n\n## 2. Community Review\n- The proposal is shared in the **IoTeX Community Forum** for open discussion.  \n- Feedback is collected from the community, developers, and stakeholders.  \n- The author may revise the draft based on input.\n\n## 3. Under Voting\n- Once matured, the IIP is submitted for **on-chain governance voting** via the **IoTeX Hub**.  \n- Voting determines whether the IIP proceeds to implementation or is rejected.  \n  - **If passed** → moves to Implementation.  \n  - **If rejected** → moved to Archive.  \n\n## 4. Implementation\n- Technical work is carried out (usually in the next scheduled hardfork).  \n- This includes development, testing, and integration of the proposal into **IoTeX L1 Core**.\n\n## 5. Live\n- The IIP becomes active on mainnet and part of IoTeX’s protocol.  \n- At this stage, the proposal is considered complete.\n\n## 6. Archive\n- IIPs that are rejected, deprecated, or made obsolete are moved into the archive for historical reference.\n\n\u003cimg width=\"5004\" height=\"2052\" alt=\"whiteboard_exported_image\" src=\"https://github.com/user-attachments/assets/03be529d-c652-4d94-a1d0-2c7c2f95adc1\" /\u003e\n\n\n## IIP Formats and Templates\n\nIIPs should be written in markdown format, and the file should be named `iip-X.md`, where `X` is IIP number. Image files\nshould be included `assets/iip-X` folder. When linking to an image in the IIP, use relative links such as\n`assets/iip-X/image.png`.\n\nEach IIP must begin with an RFC 822 style header preamble. The headers must appear in the following order. Headers\nmarked with `*` are optional and are described below. All other headers are required.\n \n```\n  IIP: \u003cIIP number\u003e\n  Title: \u003cIIP title\u003e\n  Author: \u003clist of authors' real names and optionally, email addrs\u003e\n* Discussions-To: \u003cURL to the discussion thread\u003e\n  Status: \u003cDraft | Accepted | Final | Deferred | Closed\u003e\n  Type: \u003cStandards Track | Informational | Process\u003e\n  Created: \u003cdate created on, in ISO 8601 (yyyy-mm-dd) format\u003e\n* Replaces: \u003cIIP number\u003e\n* Superseded-By: \u003cIIP number\u003e\n* Resolution: \u003curl\u003e\n```\n\nRefer to the [example](iip-X.md) for details.\n\n## Process of creating a new IIP\n\n1) Review the IIPs public repo\nThis will help you ensure that your idea is unique and has not already been proposed or discussed. It will also give you an idea of the standard of other successful proposals. \n\n2) Determine the next IIP number: To avoid conflicts, find the current latest IIP and use the next number for your proposal (don't forget to check any PRs with pending proposals).\n\n3) Draft your proposal: Try using the same format as the existing IIP documents you find the repository to draft yours. When in doubt, feel free to reach out to any IoTeX team member on Discord, on X,  Telegram, or on the community forum. Not sure where to look? \nStart here:  https://iotex.io\n\n4) Submit for discussion: Once your proposal is ready, post it to the IoTeX Community Forum for discussion under the Governance Proposals category: https://community.iotex.io/c/governance-proposals\n\n5) Voting and implementation: Based on the feedback received, you may need to make revisions to your proposal. Once the IIP is finalized, it will go through community voting on the IoTeX Governance Hub at: https://hub.iotex.io/governance \n\n6) Implementation: Once the voting is passed, it will be implemented into the relevant IoTeX ecosystem protocol.\n\n\n\n## Acknowledgement\n\nThanks for those who contribute to [BIPs](https://github.com/bitcoin/bips), [EIPs](https://github.com/ethereum/EIPs)\nand [EEPs](https://eeps.io/), where we have learned and borrowed clauses heavily.\n\n## Changelog\n\n2019-05-20: Drafted the initial version of IIP guideline.\n\n2019-06-11: Added the IIP sample file.\n\n2025-09-09: Updated the IIP lifecycle section. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotexproject%2Fiips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiotexproject%2Fiips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotexproject%2Fiips/lists"}