Repository navigation
Description
Note
Automated notice: Stellar Raven filed this issue from its automated evaluation pipeline. The issue includes evidence and a public source record. Please verify the live surface before you act.
Finding
The assets skill equates issuer lockout with master key weight 0 in its custom SAC admin guidance.
It also says setting that weight before handover leaves nobody able to authorize set_admin.
Both claims omit additional account signers and their thresholds.
A remaining signer can authorize classic issuance despite the master key being disabled.
The role model therefore needs a complete account lockout, not only a disabled master key.
Evidence
Read skills/assets/SKILL.md at commit 77bf4e8fc2533ac6ad680d061e89371e8474a1a8.
The custom-admin subsection starts its prerequisite with lock the issuer and master key weight 0.
The fixed-supply example earlier in that file already gives the missing signer qualification.
The deployed asset-control guide also explains the relevant medium and high thresholds.
Additional recorded evidence:
- 2026-11-06 GET https://raw.githubusercontent.com/stellar/stellar-dev-skill/77bf4e8fc2533ac6ad680d061e89371e8474a1a8/skills/assets/SKILL.md returns the custom-admin prerequisite 'lock the issuer (master key weight 0)' and says the admin stays locked forever because nobody can sign the handover.
- The same source's fixed-supply example correctly says to remove other signers or check their combined weight against thresholds. Its custom-admin subsection omits that condition.
- 2026-11-06 GET https://developers.stellar.org/docs/tokens/control-asset-access.md says master weight 0 disables only the master key. Other signers can still authorize issuance or restore the master weight when they meet the relevant thresholds.
- 2026-11-06 the generated stellar-docs .mintlify/skills/assets/SKILL.md contains the same custom-admin wording. The canonical source is stellar/stellar-dev-skill; correct it there.
- Residual from sd-082: its two original Docs pages are corrected; this distinct skill subsection needs its own source correction. See .agents/rounds/2026-11-05-truth-maintenance/docs.md.
- Dedupe: all active/resolved skill findings and stellar/stellar-dev-skill open issuer PRs/issues checked; no existing finding covers this subsection.
Recommendation
Apply the fixed-supply example's signer qualification to the custom-admin subsection and final security checklist.
Keep the handover-before-lockout ordering, but describe complete account lockout rather than master-key disablement alone.
Qualify the claim that nobody can sign after setting master weight 0.
Regenerate the Docs skill copy from the corrected source.
Source Record
Raven recorded this finding as sk-038 (skills, discovered 2026-11-06).
Public source record: improvements/skills/sk-038-assets-custom-admin-issuer-lock-signers.md
Resolution Handoff
When you deploy a fix, link the resolving issue or pull request to the source record.
Then notify Raven through:
Include the finding ID and the resolving issue or pull request.
Include the deployed version or timestamp. Include the smallest live recheck.
Raven verifies the live surface before it sets the finding to fixed-upstream.
An issue closure or merged pull request does not prove the fix.
A separate reviewer repeats the live check before Raven retires the active finding.
Raven keeps a commit-pinned snapshot when one is available.
Activity
stellar-triage-bot commentedon Nov 6, 2026
🤖 Automated message from the Stellar Triage Bot.
👀 Picked this up — a review will follow shortly.
stellar-triage-bot commentedon Nov 6, 2026
🤖 Automated message from the Stellar Triage Bot.
I confirmed the finding and opened #178.
cross-chain/layerzero.mdand the handover eval.stellar-triage-bot commentedon Nov 6, 2026
🤖 Automated message from the Stellar Triage Bot.
#178 is merged and live on skills.stellar.org. The assets skill now asks for a complete issuer lock: master key weight 0 and no other signers that can meet the thresholds. I sent the Raven handoff in stellar-experimental/stellar-raven#381.
kalepail commentedon Nov 6, 2026
Independently verified on 2026-11-06: the canonical assets skill now qualifies all three issuer-lockout statements. Its live bytes match PR #178's merged source.
One delivery residual remains. The ordinary Docs skill URL still serves the earlier wording:
https://developers.stellar.org/.well-known/agent-skills/assets/skill.md
Two reviewers reproduced this without query parameters. At 12:42 UTC, the response reported
Age: 65322andCache-Control: public, max-age=86400. Its SHA-256 was141b4f4417599cd1679f7c82f26fae50f6eb5ca9a50c12f66bc14f72e5694856.The generated Docs source and a query-busted response already contain the correction. This needs a published-cache refresh, not another canonical wording change. Raven keeps sk-038 active until the ordinary URL passes; the verified canonical pin update can proceed separately.
kalepail commentedon Nov 6, 2026
Raven rechecked the ordinary Docs assets skill on November 6 at 18:58 UTC.
The prerequisite, handover warning and security checklist now account for other signers and their thresholds.
The canonical published skill also retains these corrections. A separate reviewer repeated both live checks.
The original signer-control defect is resolved, including its previously stale delivery path. We are retiring sk-038.
The separate interface-type delivery gap remains tracked as sk-039; it does not reopen this signer-control finding.
Immutable source record.