SOLUX

The Autonomous Bounty Protocol for GitHub & Solana.

We use Agentic AI (Llama 3) to evaluate Pull Requests and execute instant USDC settlements to contributors via Smart Contracts on Solana Devnet.

Devnet Smart Contract

All SOLUX transactions are currently verifiable on the Solana Devnet via the official master contract address below.

JBnTbnqcvXTmw7nZ6TuLbGcY7U5b8Du7YPpK5G8nByyi

For Maintainers

Initialize a Repository Vault

To automate payouts for a repository, you must first create its on-chain vault.

1Install the Blinky-Solux GitHub Bot on your repository.
2Navigate to the Repositories tab in your SOLUX dashboard.
3Select your target repository from the list.
4Click Initialize Vault. This generates a unique PDA for that repo.

Recharge Your Vault

Your vault needs USDC to automatically pay your contributors.

1Navigate to the Recharge tab in the dashboard.
2Find the repository vault you want to fund.
3Enter the amount of Devnet USDC to deposit.
4Click submit and approve the transaction in your wallet.

For Contributors

Connect Your Identity

Before you can get paid, the Smart Contract needs to securely bind your GitHub account to your Solana Wallet.

Click the "Claim Bounty" link posted by Blinky in your merged PR.
Step 1: Authorize your GitHub account.
Step 2: Connect your Solana Wallet.
Click Finalize Connection to anchor your identity.

Claim Your Payout

Wait for Blinky AI to approve the PR audit.
Click the settlement link in the comments.
Click the Proceed to Settlement button.
Approve transaction. USDC transfers instantly.

You can update your payout wallet at any time by revisiting the link page and selecting a new wallet.

Common Troubleshooting

Transaction Failed

Even though you are receiving USDC, the Solana network requires a fraction of a cent in SOL to process the receipt. Make sure you have at least 0.01 Devnet SOL in your wallet.

The Vault is Empty

If a transaction fails with "insufficient funds", the Maintainer's vault has run out of USDC. Contact the maintainer directly to recharge their vault.

Navigating the Platform

The SOLUX dashboard provides real-time oversight of your open-source treasury. Here is a breakdown of the primary tabs.

1. Overview Dashboard

View high-level metrics including Total USDC Distributed, the number of Active Vaults anchored to your account, and any Pending Claims awaiting withdrawal.

2. Repositories Tab

Manage all connected GitHub repositories. This is where you deploy the AI Guardian and generate unique Smart Contract PDAs for each repo.

3. Recharge Tab

Fund your repository smart contracts. Remember: You cannot add USDC directly from a faucet to the PDA. You must fund the vault using Devnet USDC held within your connected wallet.

GitHub Bot

Install Blinky App

To make the magic happen, Maintainers must install our GitHub application (blinky-solux) to bridge their repository with the smart contract.

Is it free to use?

Yes! While SOLUX is operating on the Solana Devnet, the platform and bot are completely free to use.

Will it take over my repo?

No. The bot operates strictly on a principle of least privilege. It cannot merge code, delete repositories, or modify branch settings. It functions solely as an auditor and a messenger.

Required Permissions

Read access (Code, PRs, Issues)So the Llama 3 AI can read the code diffs and requirements to perform the automated agentic audit.
Write access (Issues, PR Comments)So the bot can post the audit results and drop the encrypted settlement links directly in the PR thread for your contributors.