Getting started

SOLUX Protocol Documentation

SOLUX links GitHub contributions to Solana-native bounty settlement with Guardian identity attestations, Blinky AI audits, and instant Blink claims.

NestJS + Anchor Integration

The API layer consumes GitHub webhooks in NestJS and delegates payout settlement to an Anchor client bound to your vault program.

@Injectable()
export class SettlementService {
  async onPullRequestMerged(event: PullRequestEvent) {
    const identity = await this.guardian.verify(event.githubUserId);
    const audit = await this.blinky.score(event.diff);
    if (!audit.eligible) return;

    await this.anchorVault.settle({
      repo: event.repoId,
      contributor: identity.wallet,
      amount: audit.rewardUsdc,
    });
  }
}

Integration Note

Keep webhook verification and Anchor signer management in separate providers to avoid exposing signer context in your API controllers.

Settlement Workflow

1. Guardian maps GitHub handle to wallet

2. Blinky verifies merged diff quality

3. Blink claim settles from on-chain vault

Security Model

Payout execution checks both merge authorship and wallet signature against Guardian attestations. This prevents impersonation and replay claims.

Operational Warning

Rotate settlement signer keys and monitor webhook delivery integrity to prevent delayed payout processing.