Account Flags State Inspector

[Kingsman-99]

Description

Stellar accounts carry boolean flags (AUTH_REQUIRED, AUTH_REVOCABLE, AUTH_CLAWBACK_ENABLED, AUTH_IMMUTABLE) that significantly affect which operations can be performed against them. The SDK does not currently surface these flags in a typed, structured form, forcing callers to inspect raw Horizon AccountRecord.flags objects. A flags inspector should decode account flags and expose typed methods for checking each flag.

Technical Context

Add src/accountFlagsInspector.ts. Reads AccountRecord.flags from @stellar/stellar-sdk Horizon types. Extends src/flags.ts. Adds AccountFlagSet interface to src/types.ts. Integrates with src/preflightChecker.ts to warn or block operations that are incompatible with the recipient's flag state (e.g. sending to an AUTH_REQUIRED asset issuer without prior authorisation).

Acceptance Criteria

• inspectFlags(accountId: string): Promise<AccountFlagSet> returns { authRequired, authRevocable, authImmutable, authClawbackEnabled } as typed booleans
• AccountFlagSet.isCompatibleWith(operation: string): boolean returns false when a flag makes the operation impossible (e.g. authRequired blocks trustline creation without explicit authorisation)
• src/preflightChecker.ts calls inspectFlags() for each recipient and attaches the result to the preflight report
• Exposes hasAnyRestrictiveFlag(account): boolean as a convenience method for quick-fail checks
• Unit tests mock AccountRecord.flags combinations and assert correct boolean decoding for all 16 possible flag combinations
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[Abdulrasaq1515]

@Abdulrasaq1515 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I want to build an account flags inspector because Stellar accounts carry boolean flags that significantly affect which operations can be performed, and the SDK does not surface them in a typed form. The inspector decodes AccountRecord.flags, exposes typed methods for checking each flag, integrates with preflightChecker to warn or block incompatible operations, and includes tests for all 16 flag combinations.

Relevant experience:

Account flags — built flag inspectors for 2 Stellar SDKs; typed decoding, preflight integration

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Abdulrasaq1515 to this issue.

[CELIAu1]

@CELIAu1 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi maintainer, I'd like to take on this issue.

I specialize in Backend and frontend development with Golang, Next.js and TypeScript. My experience allows me to bridge functionality with intuitive user experiences, ensuring both technical correctness and usability.

I'll follow the existing codebase conventions, communicate progress clearly, and deliver a high-quality solution within the expected timeline.

Thank you for your consideration.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @CELIAu1 to this issue.

[whisper011]

@whisper011 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I can work on this.
please assign

ℹ️ Repo Maintainers: To accept this application, review their application or assign @whisper011 to this issue.

[drips-wave]

Congratulations, @whisper011! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @whisper011: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @whisper011 as part of the Stellar Wave Program's 7th Wave 🥳

😎 @whisper011: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.