A collaboration with Proof · 1 public repo per week

Are you an open source maintainer? We can help your project.

Completely free for open source repositories.

Proof turns your repository into a graph of requirements that humans and agents can both use. It finds as many bugs as it can, and gives you the tools to triage GitHub issues and pull requests from contributors — including community bug reports and security reports.

Solidity good first issues

57 open Solidity issues currently match the default 10+ star filter. Scored difficulty: 5,947 at 1/5, 8,791 at 2/5, 12,710 at 3/5, 12,148 at 4/5, 859 at 5/5. This hub uses the same feed as the homepage, limited to repositories whose GitHub language is Solidity.

All languages · Browse projects · How to find good first issues

Active filters:Language: Solidity • Stars: 10+ Stars
Filters trigger API requests for better performance

Showing 30 of 57 opportunities to contribute from the last 27 days

AI Summary: This issue requires modifying the API rate limiter to differentiate between anonymous, authenticated, and premium API key users, applying distinct request limits for each tier. The fix also involves returning standard rate limit headers and ensuring proper handling of the 429 Too Many Requests response.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a critical security vulnerability in the `MultiTokenStaking` contract where there is no emergency withdrawal function. The proposed fix involves adding an `emergencyWithdraw` function to allow users to recover their staked tokens without rewards in case of a bug, while also ensuring proper accounting and event emission.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a bug where payment escrows can become permanently locked if neither party takes action. A new endpoint will be implemented to automatically refund expired escrows after a 30-day grace period, ensuring funds are returned to the payer and all actions are logged.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue proposes adding real-time event subscription functionality to the OpenAgentsSDK. The SDK currently lacks the ability to listen for on-chain events, forcing users to poll manually. The implementation will involve adding a new method to subscribe to events, decoding event logs using ABI, supporting filtering by indexed parameters, and implementing auto-reconnection for WebSocket connections.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$3k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue proposes adding contract deployment helper functions to the SDK. Currently, users must rely on external tools like Hardhat for contract deployment. The implementation will involve a new `deployContract` method that handles deployment, confirmation waiting, and returns a deployed contract instance with relevant metadata.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$3k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a critical bug in the `InterestRateModel.sol` contract where changes to interest rate parameters (base rate, multiplier, jump multiplier) do not emit events. This prevents off-chain monitoring systems from detecting these crucial updates. The fix involves adding a new event to log parameter changes with old and new values, emitting this event on every setter call, and introducing a new view function to retrieve all current parameters.

Complexity:2/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$4k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue proposes adding a `batchRegister` function to the `AgentRegistry.sol` contract to improve gas efficiency when registering multiple agents. The new function will allow registering up to 50 agents in a single transaction, emitting individual events and collecting the total fee once, while maintaining backward compatibility.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$4k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a vulnerability in the Timelock contract where queued transactions can be executed indefinitely after their scheduled execution time (eta). The fix involves introducing a grace period, rejecting executions beyond this period, and adding a mechanism for the admin to cancel queued transactions. This ensures that stale transactions cannot be exploited.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$7k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue proposes to standardize API error responses by introducing a consistent JSON schema that includes error codes, messages, and optional details. The goal is to improve clarity and security by ensuring all errors, including validation, not found, authentication, rate limiting, and internal errors, are handled uniformly and include a request ID.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$8k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: The `decodeParameter` function in the SDK currently only supports fixed-size data types, incorrectly returning dynamic types like strings, bytes, and arrays as raw hexadecimal. This issue requires adding specific decoding logic for each dynamic type and for tuples, ensuring they are correctly represented in JavaScript. The fix also includes comprehensive testing and documentation for contributors.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$9k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a critical reentrancy vulnerability in the StakingRewards contract. The `withdraw` and `claimRewards` functions incorrectly perform external ETH transfers before updating user balances, allowing attackers to drain funds. The fix involves reordering state updates, applying OpenZeppelin's `ReentrancyGuard`, and adding a new test case to prevent such attacks.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$4k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: A vulnerability exists in Nexus's ComposableExecutionLib where constraint validation can be bypassed for constraints beyond the first one. This occurs because the library incorrectly uses the constraint index as an offset into memory, leading to checks against unintended memory locations instead of the actual fetched value. Consequently, constraints like LTE(10 ether) on a balance of 100 ether can be bypassed, allowing execution to proceed with invalid data.

Complexity:3/5
bughelp wanted

Nexus by Biconomy: ERC-7579 Modular Smart Account for Enhanced Account Abstraction

Solidity
#account-abstraction#biconomy#erc-4337#erc-7579#erc4337#erc7579#smart-account#smart-contract-wallets#smart-wallet

AI Summary: This issue addresses a security vulnerability in a Solidity smart contract where the `block.prevrandao` value, used for determining lottery winners, is manipulable. The fix involves replacing the current randomness mechanism with a more secure method like commit-reveal or VRF, enforcing a minimum number of participants, handling cases where a winner rejects ETH, and implementing a draw cooldown. The goal is to ensure the randomness is not validator-manipulable and that the lottery operates as intended with proper participant and rejection handling.

Complexity:4/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a donation attack vulnerability in the YieldAggregator's deposit function. The attacker exploits the lack of slippage protection by donating to artificially inflate the share price. The proposed fix involves adding a `minShares` parameter, improving internal accounting, checking for zero-address strategies, and implementing a share price sanity check.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$6k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a bug in the SDK's retry utility where the default maximum retries is set to infinity, leading to potential backoff overflows. The fix involves implementing a default maximum of 5 retries, capping backoff at 60 seconds, resetting retries on success, and adding jitter to the backoff strategy. Additionally, it requires adding a documentation block to modified files for contributor tracking and build reproducibility.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$4k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses critical security vulnerabilities in a Chainlink adapter contract. The `getPrice` function currently lacks validation for round IDs, price staleness, and negative or zero prices. The fix involves implementing checks for these conditions to ensure data integrity and prevent potential exploits, along with adding a fallback oracle mechanism.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a vulnerability in the TWAP oracle contract where a 1-block window allows for manipulation. The fix involves implementing a minimum 30-minute window, ensuring only one observation per block, adding a staleness check, and introducing a cumulative price accumulator.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$2k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses two critical problems in the `claimPrize` function of the `PrizeSplit.sol` smart contract. Firstly, it fixes a reentrancy vulnerability by ensuring ETH is sent only after state updates, adhering to the checks-effects-interactions pattern. Secondly, it resolves a dust loss issue by tracking and adding any remaining small amounts to the last winner, and also adds a check to revert if there are zero winners.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$7k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses an integer overflow vulnerability in the `VestingWallet.sol` smart contract, specifically affecting the calculation of vested amounts for large token allocations. The fix involves reordering arithmetic operations to prevent overflow, correcting the `revoke` function's logic, and adding a check for zero-address beneficiaries. The goal is to ensure accurate vested amount calculations and proper revocation behavior, even with very large token amounts.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$7k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses critical security vulnerabilities in the AgentToken contract. It requires implementing access control to restrict minting to the owner, enforcing a maximum supply cap, and validating permit deadlines to prevent exploitation. Additionally, a burn function needs to be added.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$9k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a security vulnerability in the Timelock contract where the delay can be set to zero and lacks access control. The fix involves adding `onlyOwner` access control, enforcing a delay between 1 and 30 days, and validating the `eta` against the current timestamp and new delay. Additionally, it requires specific documentation and contributor tracking conventions.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$9k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

AI Summary: This issue addresses a vulnerability in an AMM (Automated Market Maker) pool's `addLiquidity` function where the first depositor can manipulate the LP (Liquidity Provider) price due to a lack of minimum liquidity lock. The fix involves locking a minimum amount of LP tokens to a zero address on the first deposit and ensuring `removeLiquidity` uses internal reserves to prevent donation attacks.

Complexity:3/5
Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible$3k

Decentralized AI Agent Orchestration Protocol — see CONTRIBUTING.md.

Solidity

Also browsing: Python , TypeScript , JavaScript