Repository navigation
Implement access-check APIs in GuildPass SDK V2 #495
Description
Difficulty
Medium
Type
Feature / Access Control
Background
Access evaluation is a central GuildPass capability and should be easy to consume from applications, bots, and integrations.
Problem
Consumers currently have no V2 SDK method for submitting access checks and receiving structured decisions from Core.
Expected Outcome
The SDK exposes a strongly typed client.access.check() operation with deterministic, explainable results.
Suggested Implementation
Support an API similar to:
const result = await client.access.check({
guildId,
account,
resource,
action
});Return a result similar to:
{
allowed: true,
reason: "required_pass_owned"
}Do not duplicate policy evaluation logic inside the SDK.
Acceptance Criteria
-
client.access.check()is implemented. - Request input is strongly typed.
- Result uses the canonical
AccessDecisiontype. - Stellar account identifiers are supported.
- Policy evaluation remains a Core responsibility.
- Denied access is represented as a normal decision where appropriate rather than always throwing.
- Transport/API failures still use typed SDK errors.
- Unit tests cover allowed, denied, and error scenarios.
Likely Affected Files/Directories
src/resources/access.tssrc/client.tssrc/types/test/
Activity
abojeEdwin commentedon Sep 12, 2026
Hi maintainer, I've gone through the issue and I have a clear understanding of the fix for this issue. I'd love to be assigned to this issue. Thank you
Okorie2000-code commentedon Sep 14, 2026
Hi Maintainer, I'd like to work on this issue and can start right away. Please assign it to me.
rupesh-kumar-sah commentedon Sep 14, 2026
Hello @maintainers,
I can tackle
Implement access-check APIs in GuildPass SDK V2. Proposed implementation roadmap:Adamantine-guild/guildpass-sdkImplement access-check APIs in GuildPass SDK V2with clean React/Next.js components, responsive styling, and proper loading/error boundaries.I am ready to start immediately—please assign this to me!
grantfox-oss commentedon Sep 16, 2026
🎉 This issue has been marked as completed on GrantFox!
@rupesh-kumar-sah's PR #503 was approved and merged by @Lakes41.
🏆 @rupesh-kumar-sah: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (35 total points). Track your full progress on GrantFox.
👏 Great work, @rupesh-kumar-sah! Keep contributing to Adamantine-guild.
feat(access): implement client.access.check API and AccessDecision ty…