Solidity good first issues

70 open Solidity issues currently match the default 10+ star filter. Scored difficulty: 5,943 at 1/5, 8,722 at 2/5, 12,675 at 3/5, 12,093 at 4/5, 856 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 · Hacktoberfest 2026

Active projects

Unique repos with open help-wanted issues updated in the last 30 days

Showing 30 of ~70 matching filters (Solidity · 10+ stars)

List

[ Bounty $8k ] [ API ] Add structured error responses with error codes — security critical

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.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $1k ] [ API ] Add audit log for all admin actions — pre-audit

AI summary

This issue proposes adding an audit log to the API to track all administrative actions, such as parameter changes and user management. The implementation involves creating a new `AuditLog` model to store details of each action, logging write operations from admin endpoints, and providing a new endpoint to query these logs. The goal is to ensure accountability and a complete history of administrative changes.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $3k ] [ Solidity ] Add permit2 support to all token interaction contracts — mainnet prep

AI summary

This issue proposes integrating Permit2 support into several token interaction contracts (StakingRewards, AMMPool, LendingPool) to enable gasless approvals for users. The implementation should support `permitTransferFrom` with signatures while retaining the standard `transferFrom` as a fallback, using the canonical Permit2 address. The goal is to allow users to stake, swap, and deposit using Permit2 signatures, ensuring the existing approval flow remains functional and that signature validation adheres to the Permit2 specification.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

Prevent proposals with duplicate actions from being submitted in `GovernorTimelockCompound`

AI summary

This issue proposes to prevent the submission of Compound Governance proposals that contain duplicate actions. Currently, proposals with identical target, value, and calldata for multiple actions will fail to queue, even though a workaround exists. The fix involves modifying the `_propose` function in `GovernorTimelockCompound` to reject such proposals.

good first issue
27.2K
Difficulty
2/5

[Minter] Add solo staking

AI summary

This issue proposes adding solo staking functionality to the minter contract. Users will need to stake 32 ETH and 1000 SGT, with the SGT being time-locked and managed by admins. The implementation involves upgrading the `send2eth2` function to use AccessControl and allowing users to directly deposit ETH for vETH2, which they can then use for higher APY staking within the ecosystem.

help wantedbounty
10
Difficulty
4/5

[Bounty] Create a sett style auto-compounding LP token vault

AI summary

This issue proposes the creation of a "Sett style" auto-compounding LP token vault for SGT ETH liquidity providers, inspired by Yearn vaults. The core functionality involves automatically compounding rewards by providing them as liquidity to Uniswap and managing the ETH side. A bonus requirement includes implementing a time-locked mechanism for user principal, potentially enabling voting power, which adds significant complexity.

enhancementhelp wantedbounty
10
Difficulty
4/5

Staking for rewards with timelock

AI summary

This issue proposes implementing a flexible reward system for staking, where reward rates increase with longer timelock durations. The goal is to incentivize users to lock their LP tokens for extended periods, thereby reducing sell pressure on the SGT token. A reference to Cream's timelock rewards contracts is provided for implementation guidance.

help wantedbounty
10
Difficulty
3/5

Multisend a ERC20 advertising us to whales

AI summary

This issue proposes implementing a targeted marketing strategy by performing a multi-send of a custom ERC20 token to a specific group of "whale" users. The goal is to attract these high-value users to the platform, inspired by a similar successful campaign by Mushrooms Finance. The issue suggests leveraging data from a provided Etherscan transaction and potentially forking an existing multi-send contract for implementation.

help wantedbounty
10
Difficulty
3/5

[AAVE] Finish aave long/short ETH contract and integrate with shared stake deposit contract

AI summary

This issue involves completing and integrating an AAVE long/short ETH deposit strategy contract. Key tasks include determining the optimal credit delegation strategy, fixing and testing the contract on Kovan, enabling position opening with ETH or stablecoins, managing credit delegation, allowing withdrawals, and finally depositing ETH to a shared stake contract and returning vETH2. The goal is to create a comprehensive strategy for leveraging AAVE for ETH positions.

enhancementhelp wantedbounty
10
Difficulty
4/5

add example of "one contract per method test structure" defined in best practices

AI summary

This issue requests the addition of an example demonstrating the 'one contract per method test structure' as defined in the project's best practices. The example will illustrate how to organize tests for a factory contract by creating separate test contracts for each method, with each test function asserting a single outcome.

T-enhancementgood first issue
958
Difficulty
2/5

Document anvil --disable-block-gas-limit

AI summary

This issue requests documentation for the `--disable-block-gas-limit` flag in Anvil. The flag was introduced in a previous pull request, and the documentation should be updated to reflect its existence and purpose.

T-enhancementgood first issueA-anvil
958
Difficulty
1/5

[ Bounty $7k ] [ API ] Add agent reputation scoring system — high priority

AI summary

This issue proposes the implementation of an agent reputation scoring system. The system will calculate scores based on completion rate, time, and dispute rate, updating dynamically. It also includes a weekly decay for inactive agents and a leaderboard endpoint, with scores ranging from 0 to 1000.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $2k ] [ API ] Fix ratelimit.py doesn't differentiate authenticated vs anonymous limits — backwards compat

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.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $9k ] [ Solidity ] Fix zero-fee flash loans and add pool drainage protection — gas optimization

AI summary

This issue addresses a vulnerability in the flash loan system where small loan amounts could result in a zero fee due to truncation. It proposes fixes including a minimum fee, a maximum loan cap, internal accounting for rebasing, and an emergency pause mechanism. The goal is to prevent pool drainage and ensure fee integrity.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $7k ] [ Solidity ] Fix no max supply cap and missing access control on AgentToken mint — P0 bug

AI summary

This issue addresses critical security vulnerabilities in the `AgentToken.sol` smart contract. Specifically, it allows unauthorized minting due to missing access control and lacks a maximum supply cap. The fix involves implementing `onlyOwner` access control for minting, introducing a `MAX_SUPPLY` constant, and validating permit deadlines to prevent exploitation. Additionally, a burn function is to be added.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $6k ] [ Solidity ] Fix donation attack on YieldAggregator deposit

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.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $5k ] [ API ] Fix tasks.py has no websocket endpoint for real-time task updates

AI summary

This issue proposes adding a WebSocket endpoint to the API to enable real-time task status updates. Currently, clients must poll for changes, which is inefficient. The fix involves creating a new WebSocket endpoint that broadcasts task state changes, allows subscriptions to specific task IDs, and includes a heartbeat mechanism for connection stability.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ SDK ] Fix ABI encoding doesn't handle BigInt overflow — regression fix

AI summary

This issue addresses a regression in the SDK's ABI encoding where BigInt values could overflow without proper checks. The fix involves adding bounds checking for uint256, validating the '0x' prefix for hex strings, ensuring 32-byte padding, and implementing signed integer support. The goal is to prevent overflows and invalid inputs from causing encoding errors.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ Solidity ] Fix tx.origin phishing vulnerability in GovernorAlpha vote function

AI summary

This issue addresses a critical security vulnerability in the `GovernorAlpha.sol` smart contract where `tx.origin` is used for voter identification, making it susceptible to phishing attacks. The fix involves replacing `tx.origin` with `msg.sender` for authorization, adding zero address checks, enforcing timelock delays on execution, and documenting the changes. The goal is to eliminate `tx.origin` usage and ensure secure voting and execution processes.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $7k ] [ Solidity ] Fix reentrancy in PrizeSplit claimPrize and rounding dust loss

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.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ SDK ] Fix session token in localStorage with no expiry check

AI summary

This issue addresses security vulnerabilities in the SDK's session management. It proposes replacing localStorage with more secure alternatives like in-memory storage or httpOnly cookies, implementing expiry checks, and resolving race conditions during token refreshes. The goal is to enhance security and prevent potential XSS attacks and refresh conflicts.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
4/5

[ Bounty $8k ] [ SDK ] Fix session token in localStorage with no expiry check — hardening

AI summary

This issue addresses critical security vulnerabilities in the SDK's session management. It proposes replacing localStorage with more secure alternatives like in-memory storage or httpOnly cookies, implementing expiry checks, and resolving race conditions during token refreshes. The goal is to prevent XSS attacks, ensure timely token refreshes, and handle concurrent refresh requests efficiently.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
4/5

[ Bounty $7k ] [ API ] Fix JWT auth middleware accepts algorithm none

AI summary

This issue addresses a security vulnerability in the JWT authentication middleware where it incorrectly accepts the 'none' algorithm, potentially leading to insecure token handling. The fix involves pinning the allowed algorithm to 'HS256', implementing graceful fallback for missing environment secrets to prevent crashes, and adding token revocation functionality. The changes also include updating file header documentation and refreshing endpoints to ensure proper security and stability.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $7k ] [ Solidity ] Add gas sponsorship relay for agent transactions — pre-audit

AI summary

This issue proposes adding gas sponsorship for agent transactions in Solidity. The goal is to allow agents to submit tasks without needing to hold ETH for gas by enabling meta-transactions, where a relayer pays the gas and is reimbursed from the agent's staked balance.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
4/5

[ Bounty $5k ] [ Solidity ] Implement multi-sig approval for large withdrawals in TaskRouter — critical security fix

AI summary

This issue requires implementing a multi-signature approval mechanism for large withdrawals (above 1 ETH) in the TaskRouter smart contract. The system needs to enforce 2-of-3 approvals for such transactions, prevent double approvals, and automatically execute payments once the required approvals are met, while also managing signers.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
4/5

[ Bounty $5k ] [ Solidity ] Fix missing slippage protection and deadline in SimpleSwap

AI summary

This issue addresses critical security and functionality gaps in the `SimpleSwap.sol` contract. It requires adding slippage protection (`minAmountOut`) and a deadline mechanism to the `swap` function. Additionally, the fee calculation needs to be adjusted to prevent truncation to zero for small amounts, ensuring a minimum fee of 1 wei.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ Solidity ] Fix GovernorAlpha execute has no quorum validation — backwards compat

AI summary

This issue addresses a security vulnerability in the `GovernorAlpha` smart contract where the `execute` function lacks a quorum validation. This allows proposals with insufficient support to be executed. The fix involves adding a configurable quorum threshold that must be met for a proposal to be executed, ensuring a minimum level of community consensus.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ Solidity ] Add governance proposal cancellation and vote delegation expiry

AI summary

This issue proposes adding two key features to a Solidity smart contract: the ability to cancel governance proposals before they reach quorum and a mechanism for vote delegation to expire. These additions aim to prevent malicious proposals and manage the lifecycle of delegated votes.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $7k ] [ API ] Fix agents.py doesn't validate endpoint URL format — urgent

AI summary

This issue addresses a critical security vulnerability in the `register_agent` API endpoint. The current implementation fails to validate the format of agent endpoint URLs, leading to system crashes when invalid URLs are provided. The fix requires implementing robust URL validation, including format checks, reachability tests via HEAD requests with a timeout, and blocking private IP addresses to prevent SSRF attacks.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

[ Bounty $8k ] [ SDK ] Fix ABI encoding doesn't handle BigInt overflow — P0 bug

AI summary

This issue addresses a critical bug in the SDK's ABI encoding where BigInt overflows are not handled, and the hex prefix validation is missing. The fix involves implementing bounds checks for uint256, validating the '0x' prefix, ensuring 32-byte padding, and adding support for signed integers, all while adhering to contributor documentation standards.

Autonomus Agents Onlygood first issuehelp wanted💎 Bountyhigh-valuecrypto-eligible
10
Difficulty
3/5

Also browsing: Python , TypeScript , JavaScript