Evm precompile maintenance skill by UnArbosFour · Pull Request #2998 · RaoFoundation/subtensor

UnArbosFour · 2026-07-27T22:57:55Z

Adds public documentation for current and proposed EVM precompiles, including ABI lifecycle and subscription-based event reporting. Extends the EVM maintainer skill with focused guidance for ABI versioning, backwards compatibility, coverage, and regression testing—requiring migration before any mainnet change that would force hard deprecation.

…lude issue 2445 notes.

vercel · 2026-07-27T22:58:00Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
subtensor	Ready	Preview	Aug 6, 2026 1:44pm

github-actions · 2026-07-27T22:59:43Z

🛡️ AI Review — Skeptic (security review)

VERDICT: SAFE

VERY HIGH scrutiny: limited profile data and previously identified young account; repository write permission, no known Gittensor association, and branch targets main.

Static analysis found no runtime, dependency, workflow, credential, or AI-review trust-boundary changes. The prior unsafe blanket balance-conversion guidance remains corrected: released ABI units are preserved, and 10^9 scaling is limited to interfaces explicitly defined in 18-decimal EVM units.

Findings

No findings.

Conclusion

No security vulnerability or malicious behavior was found in the current diff.

🔍 AI Review — Auditor (domain review)

VERDICT: 👍

LIKELY Gittensor-associated; newer contributor with repository write access, so maintainer guidance received close correctness scrutiny.

The Auditor proposed a replacement PR description, but the current body is non-trivial; not overwriting. Maintainers: ask the Auditor to regenerate if you want it.

The prior blocking issue is fixed: reserved addresses are now explicitly distinguished from implemented precompiles. No competing duplicate was identified, and this documentation-only change requires neither a runtime build nor a spec_version bump.

Auto-fixed four end-of-file whitespace errors in the documentation. Two remaining trailing spaces in the read-only skill path are covered by inline suggestions.

Findings

Sev	File	Finding
LOW	`.agents/skills/evm-maintainer/references/state-exposure.md:6`	Remove trailing whitespace	inline
LOW	`.agents/skills/evm-maintainer/references/state-exposure.md:79`	Remove trailing whitespace	inline

Prior-comment reconciliation

d12899a2: addressed — The skill now says addresses 0x080f–0x0813 are reserved and must be treated as implemented only after routing, tests, and runtime registration ship.

Conclusion

The guidance now preserves the distinction between reserved and deployed precompiles and is ready after the two whitespace suggestions are applied.

📜 Previous run (superseded)

~~Sev~~	~~File~~	~~Finding~~	Status
~~HIGH~~	~~`.agents/skills/evm-maintainer/SKILL.md:114`~~	~~Do not classify reserved precompiles as implemented~~	✅ Addressed The skill now says addresses `0x080f`–`0x0813` are reserved and must be treated as implemented only after routing, tests, and runtime registration ship.

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-27T23:01:58Z

🔄 AI review updated — Skeptic: SAFE Auditor: 👎

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-28T12:57:25Z

🔄 AI review updated — Skeptic: VULNERABLE

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-29T20:59:30Z

🔄 AI review updated — Skeptic: VULNERABLE

…n evm maintainer skill

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-29T21:38:24Z

🔄 AI review updated — Skeptic: VULNERABLE

…st annotations

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-29T22:22:23Z

🔄 AI review updated — Skeptic: VULNERABLE

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-30T21:10:45Z

🔄 AI review updated — Skeptic: VULNERABLE

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-31T15:08:27Z

🔄 AI review updated — Skeptic: VULNERABLE

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-07-31T17:55:56Z

🔄 AI review updated — Skeptic: VULNERABLE

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-08-05T17:19:28Z

🔄 AI review updated — Skeptic: VULNERABLE

unarbos

Docs/skill-only (verified: no runtime/pallet/node Rust touched; only a docs-site React component). Skill guidance is consistent with the release process. Two stale wordings to reconcile in a follow-up now that #3018 ships the five precompiles it calls 'proposed', including the state-exposure classification of root-claim storage.

Co-authored-by: Cursor <cursoragent@cursor.com>

unarbos

Re-approving after docs drift-gate regeneration (13 generated files, verified with generate.py --check).

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-08-06T13:01:04Z

+- Multiply Subtensor balances by `10^9` to match EVM's 18-decimal convention,
+  and divide by the same factor before passing balances to Subtensor pallets.


[HIGH] Do not apply 18-decimal scaling to every precompile balance

This blanket rule conflicts with released precompile interfaces that explicitly use rao, including staking and balance views. Following it would multiply returned values or divide call arguments by 10^9, silently changing economic semantics for existing contracts. Native EVM account-balance conversion is a distinct boundary; each precompile must preserve its released ABI units.

Suggested change

- Multiply Subtensor balances by `10^9` to match EVM's 18-decimal convention,

and divide by the same factor before passing balances to Subtensor pallets.

- Preserve each released precompile's documented balance units and scaling.

Apply `10^9` conversion only at the native EVM/Substrate balance boundary;

define and test conversions per selector before introducing a new ABI.

github-actions · 2026-08-06T13:01:15Z

🔄 AI review updated — Skeptic: VULNERABLE

Address review: the maintainer skill instructed a blanket 10^9 scaling for all precompile balances, which contradicts released rao/alpha-denominated interfaces. Require preserving each released ABI's documented units and name/annotate the staking-v2 amount parameters (rao in, alpha out). Also update stale 'proposal' wording for the now-implemented 0x080f-0x0813 addresses. Co-authored-by: Cursor <cursoragent@cursor.com>

unarbos

Re-approved at 4f7a46d: drift-gate regeneration plus per-ABI unit-contract fix in the maintainer skill (blanket 18-decimal rule removed, staking-v2 amounts named and unit-annotated per the implementation).

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-08-06T13:06:56Z

+- Assign new Bittensor domain precompiles sequentially from the next unused
+  Bittensor address. Addresses `0x080f` through `0x0813` are implemented as
+  Scheduler, Drand, Timestamp, Runtime Configuration, and the Precompile
+  Registry, respectively. Add routing and tests that lock every implemented
+  address and selector before release.


[HIGH] Do not classify reserved precompiles as implemented

None of 0x080f–0x0813 is routed or implemented in precompiles/src; the new public documentation also consistently marks all five as proposed and reserved. This executable guidance can therefore make future maintenance skip missing coverage or allocate the next domain at the wrong address.

Suggested change

- Assign new Bittensor domain precompiles sequentially from the next unused

Bittensor address. Addresses `0x080f` through `0x0813` are implemented as

Scheduler, Drand, Timestamp, Runtime Configuration, and the Precompile

Registry, respectively. Add routing and tests that lock every implemented

address and selector before release.

- Assign new Bittensor domain precompiles sequentially from the next unused

Bittensor address. The current proposal reserves `0x080f` through `0x0813`

for Scheduler, Drand, Timestamp, Runtime Configuration, and the Precompile

Registry, respectively. Add routing and tests that lock every implemented

address and selector before release.

github-actions · 2026-08-06T13:07:08Z

🔄 AI review updated — Skeptic: SAFE Auditor: 👎

…ipped Co-authored-by: Cursor <cursoragent@cursor.com>

github-actions

AI review — see the sticky summary comment for the verdict and the inline comments below for specific findings.

github-actions · 2026-08-06T13:41:55Z

+This file lists concrete state variables, maps, and runtime constants and
+classifies them as one of three classes:
+
+1. Safe to expose directly, as is, or 


[LOW] Remove trailing whitespace

git diff --check reports trailing whitespace here.

Suggested change

1. Safe to expose directly, as is, or

1. Safe to expose directly, as is, or

github-actions · 2026-08-06T13:41:55Z

+
+InactiveIssuance, the reserved, frozen, and flags portions of Account: Locks, Reserves, Holds, Freezes
+
+### Pallet swap 


[LOW] Remove trailing whitespace

git diff --check reports trailing whitespace here.

Suggested change

### Pallet swap

### Pallet swap

github-actions · 2026-08-06T13:42:06Z

🔄 AI review updated — Skeptic: SAFE Auditor: 👍

Expand evm precompile maintenance skill with compatibility notes, inc…

1201a6a

…lude issue 2445 notes.

UnArbosFour added the skip-cargo-audit This PR fails cargo audit but needs to be merged anyway label Jul 27, 2026

vercel Bot deployed to Preview July 27, 2026 22:59 View deployment

github-actions Bot reviewed Jul 27, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

Comment thread docs/guides/evm/precompiles/staking-v2.mdx

Add precompile coverage gaps for existing domains

5d10f59

github-actions Bot reviewed Jul 28, 2026

View reviewed changes

Comment thread .agents/skills/emv-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 28, 2026 12:57 View deployment

taopunks mentioned this pull request Jul 28, 2026

Add ABI/annotation drift check; fix one dropped stakingV2 face #3003

Closed

Remove event reporting precompile suggestions

48445d7

github-actions Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 29, 2026 21:00 View deployment

Require root priviledged calls to not be implemented in precompiles i…

32980cd

…n evm maintainer skill

github-actions Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 29, 2026 21:38 View deployment

Spec out the deprecation with locally defined precompile lifecycle ru…

36dee7c

…st annotations

github-actions Bot reviewed Jul 29, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 29, 2026 22:22 View deployment

Add rules for read exposure of state variables and maps

26d9925

github-actions Bot reviewed Jul 30, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 30, 2026 21:11 View deployment

Fix typo in path

7f9ae80

github-actions Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview July 31, 2026 15:09 View deployment

Add runtime constants to the precompile requirements

539f5d0

vercel Bot deployed to Preview July 31, 2026 17:55 View deployment

github-actions Bot reviewed Jul 31, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md

Merge branch 'main' into feat/add-evm-maintainer-skill

7a7d410

github-actions Bot reviewed Aug 5, 2026

View reviewed changes

Comment thread .agents/skills/evm-maintainer/SKILL.md Outdated

vercel Bot deployed to Preview August 5, 2026 17:20 View deployment

unarbos mentioned this pull request Aug 6, 2026

Release v444: remove miner-burn scaling from subnet emission shares #3058

Open

15 tasks

unarbos approved these changes Aug 6, 2026

View reviewed changes

chore(docs): regenerate tx pages and intents catalog for drift gate

61a043b

Co-authored-by: Cursor <cursoragent@cursor.com>

unarbos approved these changes Aug 6, 2026

View reviewed changes

unarbos marked this pull request as ready for review August 6, 2026 12:58

vercel Bot deployed to Preview August 6, 2026 13:00 View deployment

github-actions Bot reviewed Aug 6, 2026

View reviewed changes

unarbos approved these changes Aug 6, 2026

View reviewed changes

vercel Bot deployed to Preview August 6, 2026 13:04 View deployment

github-actions Bot reviewed Aug 6, 2026

View reviewed changes

docs(skill): keep 0x080f-0x0813 as reserved; implemented only once sh…

d846cd0

…ipped Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 6, 2026 13:39 View deployment

chore: auditor auto-fix

94160fd

github-actions Bot reviewed Aug 6, 2026

View reviewed changes

vercel Bot deployed to Preview August 6, 2026 13:44 View deployment

		- Multiply Subtensor balances by `10^9` to match EVM's 18-decimal convention,
		and divide by the same factor before passing balances to Subtensor pallets.

-- Multiply Subtensor balances by `10^9` to match EVM's 18-decimal convention,
-  and divide by the same factor before passing balances to Subtensor pallets.
+- Preserve each released precompile's documented balance units and scaling.
+  Apply `10^9` conversion only at the native EVM/Substrate balance boundary;
+  define and test conversions per selector before introducing a new ABI.

	1. Safe to expose directly, as is, or
	1. Safe to expose directly, as is, or


		InactiveIssuance, the reserved, frozen, and flags portions of Account: Locks, Reserves, Holds, Freezes

		### Pallet swap

Uh oh!

Conversation

UnArbosFour commented Jul 27, 2026

Uh oh!

vercel Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🛡️ AI Review — Skeptic (security review)

Findings

Conclusion

🔍 AI Review — Auditor (domain review)

Findings

Prior-comment reconciliation

Conclusion

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 27, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 28, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 29, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 29, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 29, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 30, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Aug 5, 2026

Uh oh!

unarbos left a comment

Choose a reason for hiding this comment

Uh oh!

unarbos left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

vercel Bot commented Jul 27, 2026 •

edited

Loading

github-actions Bot commented Jul 27, 2026 •

edited

Loading