Skip to content

docs: add COTI ERC-7984 as a top-level product section - #32

Closed
plucena-coti wants to merge 3 commits into
coti-io:mainfrom
plucena-coti:docs/private-erc20-erc7984
Closed

plucena-coti wants to merge 3 commits into
coti-io:mainfrom
plucena-coti:docs/private-erc20-erc7984

Conversation

@plucena-coti

@plucena-coti plucena-coti commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds COTI ERC-7984 as a new top-level product section, comparing COTI's Privacy on Demand pERC20 with FHE-based implementations of the ERC-7984 confidential-token standard.

An earlier revision of this PR placed the material as a single page inside the Privacy Portal developer guide. It now stands on its own in the main hierarchy, split into a landing page and six sub-pages.

Structure

* [COTI ERC-7984](coti-erc7984/README.md)
  * [Precision and decimals](coti-erc7984/precision-and-decimals.md)
  * [Host-chain deployment](coti-erc7984/host-chain-deployment.md)
  * [Transaction economics](coti-erc7984/transaction-economics.md)
  * [Transfer semantics](coti-erc7984/transfer-semantics.md)
  * [Concurrency](coti-erc7984/concurrency.md)
  * [Deployed contracts](coti-erc7984/deployed-contracts.md)

Listed after Privacy on Avalanche in SUMMARY.md, so the PoD / PoA pair stays together.

What the section covers

  • Precision and decimals — 256-bit values vs the 64-bit ceiling that caps an 18-decimal FHE token at roughly 18.4 whole units
  • Host-chain deployment — any EVM chain with a PoD Inbox; no FHE precompiles, no forked EVM, no migration
  • Transaction economics — ~192-byte encrypted inputs and 2-slot balances vs ~16–20 KB ZK input proofs and offloaded ciphertext blobs, plus encrypt-and-sign vs per-transaction browser proof generation
  • Transfer semantics — exact encrypted allowances with standard approve / transferFrom, and over-balance transfers that resolve to an encrypted zero with no revert or observable difference
  • Concurrency — multiple in-flight requests per account, ordered by a monotonic nonce
  • Deployed contracts — the six pTokens live on Avalanche Fuji and Ethereum Sepolia, plus explorer classification via ConfidentialTransfer events and ERC-7984 metadata

Navigation

  • coti-privacy-portal/developer-guide/privateERC20-ERC7984.md deleted; its entry removed from the Privacy Portal developer guide
  • Cross-link in privateerc20.sol.md repointed at the new product
  • Sub-pages cross-link into Privacy on Demand (architecture, async operations)

Note for reviewers

Prose is unchanged from the previously reviewed page — this revision is a restructure, not a rewrite. No claims, figures, or addresses were altered.

The security-model section of the original page (garbled circuits with non-colluding parties, and the "No master key" row of the summary table) has been dropped from this PR.

…er guide

Documents how COTI's Privacy on Demand pERC20 compares with FHE-based
confidential-token implementations of ERC-7984, covering 256-bit vs 64-bit
numeric range, ~192-byte encrypted inputs vs multi-KB ZK proofs, exact
encrypted allowances vs time-boxed operators, non-revealing failure, and the
session-scoped garbled-circuit security model. Includes the six pTokens live
on Avalanche Fuji and Ethereum Sepolia.

Adds the page to SUMMARY.md navigation and cross-links it from
PrivateERC20.sol.
@plucena-coti
plucena-coti requested a review from a team August 19, 2026 18:55

@gmesika-coti gmesika-coti left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as disscussed in daily. plz see fireflies video

Moves the PoD pERC20 vs ERC-7984 page out of the Privacy Portal developer
guide and republishes it as its own product section in the main hierarchy,
split into seven sub-pages.

- New section: COTI ERC-7984, listed after Privacy on Avalanche in SUMMARY.md
- Sub-pages: precision and decimals, host-chain deployment, transaction
  economics, transfer semantics, security model, concurrency, deployed contracts
- README carries the overview, a nav list, and the summary table
- privateerc20.sol.md cross-link repointed at the new product

Content is the same prose as before; no claims changed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@plucena-coti plucena-coti changed the title docs: add PoD pERC20 vs ERC-7984 comparison to Privacy Portal developer guide docs: add COTI ERC-7984 as a top-level product section Aug 23, 2026
Removes coti-erc7984/security-model.md along with its SUMMARY entry, the
README nav item, and the "No master key" row from the summary table.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@plucena-coti

Copy link
Copy Markdown
Contributor Author

Superseded by #33, which lands the same material as a new top-level COTI ERC-7984 product section in one clean commit against main — no add-then-move churn in the history.

Closing this in favour of that one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants