Clarify ERC-3643 upstream provenance: canonical repo vs legacy npm package

Context

While researching SF-1 (Hardhat workspace) for reference-implementations, we noticed the ERC-3643/T-REX upstream story is easy to misread:

The adapter implementation appears technically correct (source repo column points at ERC-3643/ERC-3643; ABI headers note verification against org repo main). The confusion is that the Pinned version column only lists legacy @tokenysolutions/t-rex@4.1.6, which readers (including downstream RI contract-setup work) can misinterpret as "track the deprecated Tokeny repo."

What is NOT wrong today

• packages/adapter-evm-core/src/erc3643/abi.ts — Source repo column is github.com/ERC-3643/ERC-3643; signatures verified against org repo main (2026-06-01).
• packages/adapter-evm-core/src/irs/abis.ts — same pattern.
• packages/adapter-evm/CHANGELOG.md 2.1.0 — Source column is ERC-3643/ERC-3643.
• packages/adapter-evm-core/README.md — links org repo in parentheses next to legacy npm pin.

Suggested documentation improvements

1. Provenance tables (abi.ts headers, CHANGELOG, adapter-evm-core README): add a short note that @tokenysolutions/t-rex@4.1.6 is the legacy npm artifact pin at ship time, not the repo to track, and mention @erc3643org/erc-3643 as the org-published successor npm package.
2. ABI refresh procedure (adapter-evm-core/README.md): prefer verifying against ERC-3643/ERC-3643 tags/releases; evaluate @erc3643org/erc-3643 before staying on legacy npm.
3. Optional follow-up (separate PR): run ABI gate against @erc3643org/erc-3643@4.1.3 and update pinned npm references if bytecode/interface parity holds.

Downstream impact

reference-implementations SF-2 (upstream pinning + ABI compatibility gate) needs an unambiguous canonical upstream. RI docs were updated to point at ERC-3643/ERC-3643; adapter doc clarity would prevent future misreads.

Labels

documentation, erc-3643, ri-tokenized-deposits

Review the provenance tables and ABI headers in packages/adapter-evm-core/src/erc3643/abi.ts and packages/adapter-evm-core/src/irs/abis.ts, plus adapter-evm/CHANGELOG.md and packages/adapter-evm-core/README.md. Clarify that @tokenysolutions/t-rex@4.1.6 is a legacy artifact pin, identify ERC-3643/ERC-3643 as canonical, and mention the successor npm package. Keep the ABI refresh and pin update as a separate follow-up.