Add EIP: Tranche Sequence #7169

pcanwar · 2023-06-12T14:59:14Z

Updated the EIP file :

https://github.com/pcanwar/TrancheSequence

https://github.com/pcanwar/EIPs/blob/tranche/EIPS/eip-trnache.md

Thanks

eth-bot · 2023-06-12T14:59:47Z

File `EIPS/eip-7169.md`

Requires 1 more reviewers from @axic, @Pandapip1, @SamWilsn, @xinbenlv

EIPS/eip-trnache.md

pcanwar · 2023-06-19T20:03:29Z

Hey @abcoathup, is there anything I have to do? Thanks

abcoathup · 2023-06-21T01:50:25Z

The draft is still failing validation. You need to address those issues and an EIP editor can review.

github-actions · 2023-09-17T22:03:58Z

The commit b6e668d (as a parent of 2d4608b) contains errors.
Please inspect the Run Summary for details.

pcanwar · 2023-10-09T18:12:30Z

Hey @abcoathup, I have addressed all issues! Any suggestions? I appreciate it.

abcoathup · 2023-10-09T20:35:10Z

Hey @abcoathup, I have addressed all issues! Any suggestions? I appreciate it.

You need to wait for an EIP editor to review. There is an EIP office hours meeting that you could attend.

SamWilsn

A bit of overall feedback on this proposal: libraries do not need to be EIPs. Just write the library. You only need an EIP if you expect different independent parties to have to coordinate on a system. For example, ERC-20 is a good proposal because wallets need to interact with any number of different tokens, and every ERC-20 token wants to work with every wallet.

If you wish to standardize the interface for a library, and expect there to be multiple implementations, then an EIP is a good idea.

SamWilsn · 2023-10-24T22:00:57Z

EIPS/eip-7169.md

+
+## Abstract
+
+This concept is extended through a library that builds on [ERC-20](./eip-20.md), [ERC-721](./eip-721.md), and other standards, offering a transparent and structured approach to on-chain time management. With the help of additional functions, the library enables stakeholders to define time milestones and a sequence of opportunities to evaluate and decide on the next steps.


Your abstract should be a terse technical summary that gives readers a high level understanding of what the proposal does. I haven't read further down yet, but perhaps something like:

Building on [ERC-20](./eip-20.md), [ERC-721](./eip-721.md), and other standards this proposal defines a transparent and structured approach to on-chain time management using tranche sequences. A tranche sequence is a **this is where I would put a definition of a tranche sequence if I knew what it was**.

SamWilsn · 2023-10-24T23:04:32Z

EIPS/eip-7169.md

+
+## Motivation
+
+The motivation behind this library is to overcome the challenges of managing multi-stage projects or use cases on utility tokens or NFTs while providing a fair and transparent approach to on-chain time management. This structured approach facilitates effective smart contract management and enables stakeholders to progress and make informed decisions. The library can be applied to various use cases, such as salary negotiations, project funding, or resource allocation, promoting trust and collaboration among stakeholders. The library's flexibility and transparency can result in a fairer and more effective decision-making process for all parties involved.


Suggested change

The motivation behind this library is to overcome the challenges of managing multi-stage projects or use cases on utility tokens or NFTs while providing a fair and transparent approach to on-chain time management. This structured approach facilitates effective smart contract management and enables stakeholders to progress and make informed decisions. The library can be applied to various use cases, such as salary negotiations, project funding, or resource allocation, promoting trust and collaboration among stakeholders. The library's flexibility and transparency can result in a fairer and more effective decision-making process for all parties involved.

The motivation behind this proposal is to overcome the challenges of managing multi-stage projects or use cases on utility tokens or NFTs while providing a fair and transparent approach to on-chain time management. This structured approach facilitates effective smart contract management and enables stakeholders to progress and make informed decisions. This proposal can be applied to various use cases, such as salary negotiations, project funding, or resource allocation, promoting trust and collaboration among stakeholders. Its flexibility and transparency can result in a fairer and more effective decision-making process for all parties involved.

SamWilsn · 2023-10-24T23:05:06Z

EIPS/eip-7169.md

+The following properties make tranche sequences an effective tool for managing multi-stage use cases and projects on utility tokens or NFTs in a structured and transparent manner:
+


Can uncomment this when ready

Suggested change

The following properties make tranche sequences an effective tool for managing multi-stage use cases and projects on utility tokens or NFTs in a structured and transparent manner:

SamWilsn · 2023-10-24T23:07:45Z

EIPS/eip-7169.md

+
+## Specification
+
+Library


This section needs to be better organized. I recommend using a single code block for the interface, followed by sections describing each function in detail. For example:

## Specification ```solidity interface Tranche { function initialize(uint256[] memory sequence) public; } ``` ### Functions #### `initialize` The initialize function floops the flob. ### Events ...

SamWilsn · 2023-10-24T23:08:58Z

EIPS/eip-7169.md

+Features
+
+Flexible Time Units: The library allows you to define time in various units: minutes, hours, days, and weeks. This enables flexibility when dealing with different periods.
+
+Customizable Tranches: The library is built around tranches or blocks of time that can be used to represent milestones. These tranches can be initialized according to your needs.
+
+Dynamic Time Sequencing: It enables dynamic time sequencing. The time sequence can be increased based on the existing series in the smart contract.
+
+Rest Time Inclusion: The library includes a feature for a rest time on the sequence. This offers flexibility for stakeholders, allowing for pauses or intervals between different time sequences.
+
+Time Extension: The library allows for the time of a particular sequence to be increased if needed. This is particularly useful when an ongoing event or process needs an extended time duration.
+
+Immutable Time Entries: Once a timestamp is added, it cannot be removed or modified. This feature offers immutability for time entries, ensuring the integrity and reliability of the time sequences.
+
+Milestone Tracking: The library provides utilities to track milestones and understand their progress. You can get the number of completed and missed milestones, check if the current timestamp is within a milestone, and even forcibly advance to the next milestone.
+
+Timestamp Reporting: The library provides utilities for reporting missed timestamps, getting the start and end times of the current milestone, and listing all missing timestamps since the last completed milestone.
+
+Force Increase of Milestones: If needed, milestones can be forcibly advanced manually, regardless of whether they're currently extendable.
+
+Start Time Customization: The library allows the initialization of milestones with a custom start time instead of the current block timestamp, which can be helpful for specific project timelines.
+
+Effective Milestone Management: Functions such as resetMileStone, isCurrentMilestone, isMilestoneStarted, and isMilestoneExpired provide the ability to effectively manage milestones, including initiating, resetting, tracking, and identifying the completion of a milestone.
+
+Precision and Accuracy: The library uses block.timestamp for timekeeping, which ensures precise and accurate timestamps for all operations. This accuracy is essential for a fair and accurate representation of project progress.


EIPs don't usually contain lists of features. Instead, you should convert these into requirements (eg. "The contract MUST ...", or "Implementations SHOULD ...") or explanations in your rationale.

SamWilsn · 2023-10-24T23:10:08Z

EIPS/eip-7169.md

+
+## Rationale
+
+This library is intended to provide a standardized and efficient way to manage time-based milestones in smart contracts, enabling developers to easily integrate this functionality into a variety of applications.


This first line of your rationale should be moved to the motivation section. The rationale section should describe technical decisions made within the EIP itself, while the motivation section justifies the EIP as a whole.

SamWilsn · 2023-10-24T23:10:50Z

EIPS/eip-7169.md

+## Rationale
+
+This library is intended to provide a standardized and efficient way to manage time-based milestones in smart contracts, enabling developers to easily integrate this functionality into a variety of applications.
+Update, getter, initialization, modification, query, and helper functions provide a set of tools for managing time based milestones and offer the ability to create, manage, update, and query milestones flexibly and efficiently.


This is a truth, but it doesn't really offer much in the way of explanation. Please expand it or reword it so that it answers a "why" question.

SamWilsn · 2023-10-24T23:11:12Z

EIPS/eip-7169.md

+
+This library is intended to provide a standardized and efficient way to manage time-based milestones in smart contracts, enabling developers to easily integrate this functionality into a variety of applications.
+Update, getter, initialization, modification, query, and helper functions provide a set of tools for managing time based milestones and offer the ability to create, manage, update, and query milestones flexibly and efficiently.
+The library provides replay protection and ensures security by enforcing time boundaries for each milestone and providing the ability to extend time sequences if necessary.


Again, this is true, but it doesn't explain why it is necessary to provide replay protection.

SamWilsn · 2023-10-24T23:11:51Z

EIPS/eip-7169.md

+
+## Test Cases
+
+The test cases presented in the src directory.


You can link to any file in the /assets/eip-7169/ directory (but not the whole directory.) It's pretty common to include a README.md file, and link to that from the EIP.

SamWilsn · 2023-10-25T22:18:50Z

I am closing this pull request because we are in the process of separating EIPs and ERCs into distinct repositories. Unfortunately, as far as we are aware, GitHub does not provide any tools to ease this migration, so every pull request will need to be re-opened manually.

As this is a PR to create / modify an ERC, I will kindly ask you to redirect this to the new repository at ethereum/ERCs. We have prepared a guide to help with the process.

If there is relevant history here, please link to this PR from the new pull request.

On behalf of the EIP Editors, I apologize for this inconvenience.

pcanwar and others added 6 commits May 26, 2023 19:06

added a ERC library for time management

c8d89c6

add a library for time managment Tranche Sequence

6f17642

Merge branch 'master' into tranche

5bffcb9

pulled

2032613

Merge branch 'master' into tranche

e067a7a

updated eip-trnache

a72bf04

pcanwar requested a review from eth-bot as a code owner June 12, 2023 14:59

github-actions bot added c-new Creates a brand new proposal s-draft This EIP is a Draft t-erc labels Jun 12, 2023

eth-bot changed the title ~~Sequence of Time Management Tranches on-chain~~ Add EIP: Tranche Sequence Jun 12, 2023

eth-bot added e-consensus Waiting on editor consensus e-review Waiting on editor to review labels Jun 12, 2023

github-actions bot added the w-ci Waiting on CI to pass label Jun 12, 2023

updated the test case

328054c

abcoathup reviewed Jun 13, 2023

View reviewed changes

EIPS/eip-trnache.md Outdated Show resolved Hide resolved

pcanwar added 2 commits June 13, 2023 10:09

added eip: 7169 and rename the file

3a83abd

Merge branch 'master' into tranche

ecef98b

github-actions bot added w-ci Waiting on CI to pass and removed w-ci Waiting on CI to pass labels Jun 13, 2023

pcanwar and others added 3 commits June 21, 2023 23:55

updated eip-7169

ccb2859

discussions pointed to ethereum-magicians.org

1f950dc

unrecognized header

f63b52e

github-actions bot added w-ci Waiting on CI to pass and removed w-ci Waiting on CI to pass labels Aug 22, 2023

pcanwar added 2 commits August 22, 2023 16:15

unrecognized headers

4c4a7ae

sections are out of order

b65a97c

github-actions bot removed the w-ci Waiting on CI to pass label Aug 22, 2023

pcanwar added 3 commits August 22, 2023 16:23

sections are out of order

7f7d691

sections are out of order

fe11ba2

Update eip-7169

b6e668d

github-actions bot added the w-ci Waiting on CI to pass label Sep 17, 2023

pcanwar added 2 commits October 9, 2023 14:03

remove an extra space eip-7169.md

def34f1

Merge branch 'ethereum:master' into tranche

a0bd671

github-actions bot removed the w-ci Waiting on CI to pass label Oct 9, 2023

SamWilsn reviewed Oct 24, 2023

View reviewed changes

SamWilsn closed this Oct 25, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add EIP: Tranche Sequence #7169

Add EIP: Tranche Sequence #7169

pcanwar commented Jun 12, 2023

eth-bot commented Jun 12, 2023 •

edited

Loading

pcanwar commented Jun 19, 2023

abcoathup commented Jun 21, 2023

github-actions bot commented Sep 17, 2023

pcanwar commented Oct 9, 2023

abcoathup commented Oct 9, 2023

SamWilsn left a comment

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn Oct 24, 2023

SamWilsn commented Oct 25, 2023


		## Abstract

		This concept is extended through a library that builds on [ERC-20](./eip-20.md), [ERC-721](./eip-721.md), and other standards, offering a transparent and structured approach to on-chain time management. With the help of additional functions, the library enables stakeholders to define time milestones and a sequence of opportunities to evaluate and decide on the next steps.


		## Motivation

		The motivation behind this library is to overcome the challenges of managing multi-stage projects or use cases on utility tokens or NFTs while providing a fair and transparent approach to on-chain time management. This structured approach facilitates effective smart contract management and enables stakeholders to progress and make informed decisions. The library can be applied to various use cases, such as salary negotiations, project funding, or resource allocation, promoting trust and collaboration among stakeholders. The library's flexibility and transparency can result in a fairer and more effective decision-making process for all parties involved.

		The following properties make tranche sequences an effective tool for managing multi-stage use cases and projects on utility tokens or NFTs in a structured and transparent manner:

	The following properties make tranche sequences an effective tool for managing multi-stage use cases and projects on utility tokens or NFTs in a structured and transparent manner:
	<!-- The following properties make tranche sequences an effective tool for managing multi-stage use cases and projects on utility tokens or NFTs in a structured and transparent manner: -->


		## Rationale

		This library is intended to provide a standardized and efficient way to manage time-based milestones in smart contracts, enabling developers to easily integrate this functionality into a variety of applications.


		## Specification

		Library

Add EIP: Tranche Sequence #7169

Add EIP: Tranche Sequence #7169

Conversation

pcanwar commented Jun 12, 2023

eth-bot commented Jun 12, 2023 • edited Loading

File EIPS/eip-7169.md

pcanwar commented Jun 19, 2023

abcoathup commented Jun 21, 2023

github-actions bot commented Sep 17, 2023

pcanwar commented Oct 9, 2023

abcoathup commented Oct 9, 2023

SamWilsn left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

SamWilsn commented Oct 25, 2023

eth-bot commented Jun 12, 2023 •

edited

Loading

File `EIPS/eip-7169.md`