<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.0 20120330//EN" "JATS-archivearticle1.dtd">
<article xmlns:xlink="http://www.w3.org/1999/xlink">
  <front>
    <journal-meta />
    <article-meta>
      <title-group>
        <article-title>Smart contracts and issue reporting: a preliminary analysis</article-title>
      </title-group>
      <contrib-group>
        <contrib contrib-type="author">
          <string-name>Ermanno Francesco Sannini</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Andrea Di Sorbo</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Corrado Aaron Visaggio</string-name>
          <xref ref-type="aff" rid="aff0">0</xref>
        </contrib>
        <aff id="aff0">
          <label>0</label>
          <institution>University of Foggia</institution>
          ,
          <addr-line>Foggia</addr-line>
          ,
          <country country="IT">Italy</country>
        </aff>
        <aff id="aff1">
          <label>1</label>
          <institution>University of Sannio</institution>
          ,
          <addr-line>Benevento</addr-line>
          ,
          <country country="IT">Italy</country>
        </aff>
      </contrib-group>
      <pub-date>
        <year>2025</year>
      </pub-date>
      <abstract>
        <p>The widespread adoption of blockchain and smart contracts (SCs) in contexts and tasks beyond currency management has introduced novel challenges in their development and maintenance. This paper investigates the characteristics of issue reports and their handling dynamics in SC-related projects, comparing them against traditional software. To this end, we curated a dataset of Ethereum-based smart contracts, selecting the top 2,000 active and used ones. Out of them, 42 projects with publicly maintained source code on GitHub were discovered. Using data extracted from the issue trackers of these projects, we conducted a statistical comparison with known patterns in traditional software projects. The results reveal that SC developers and users actively engage with issue-tracking systems, though most SC projects receive fewer than 50 issue reports. Besides, a significant portion of issue reports in SC-related projects pertain to feature enhancements, and resolution tends to be faster, often involving extensive use of comments. These trends reflect the community's emphasis on modularity, upgradeability, and collaborative development practices, suggesting that, in SC-related projects, maintenance tools and platforms should prioritize support for enhancement-oriented workflows and collaborative communication. Additionally, the heavy use of commentary features underscores the importance of integrated communication tools and traceability features to support transparent and audit-friendly development processes.</p>
      </abstract>
      <kwd-group>
        <kwd>eol&gt;Solidity</kwd>
        <kwd>Ethereum</kwd>
        <kwd>Issue Report</kwd>
        <kwd>Github</kwd>
      </kwd-group>
    </article-meta>
  </front>
  <body>
    <sec id="sec-1">
      <title>1. Introduction</title>
      <p>
        Smart Contracts (SCs) have been established as one of the most innovative and promising tools,
mainly valued for their ability to automate transactions and processes in a secure and decentralized way.
Initially tied to the transfer of digital assets, their use has rapidly expanded to areas such as decentralized
ifnance (DeFi), digital identity, supply chain tracking, gaming, and virtual property management [
        <xref ref-type="bibr" rid="ref1">1</xref>
        ].
A chief factor that has contributed significantly to the massive use of SCs was the completion and
capability of the Ethereum blockchain, which led the blockchain as a programmable platform [
        <xref ref-type="bibr" rid="ref2">2</xref>
        ]. While
early blockchain systems focused only on digital asset transfer, Ethereum introduced an execution
environment through a distinctive Virtual Machine (EVM), which makes it possible to build and deploy
decentralized applications (dApps) [
        <xref ref-type="bibr" rid="ref3">3</xref>
        ]. They are usually developed in a high-level language, such as
Solidity, Vyper, or other languages. Solidity is the programming language’s most popular way to develop
SCs on Ethereum. Based on the concept of immutability, SCs cannot be modified once added to the
blockchain. Once started, all contract execution is based on its code. No one can change it, even the
creator [
        <xref ref-type="bibr" rid="ref4">4</xref>
        ]. Another distinctive facet of Ethereum is the introduction of the gas mechanism, a measure
of the computational work required to perform operations on the platform, i.e. the cost of operations
performed on the blockchain [
        <xref ref-type="bibr" rid="ref5">5</xref>
        ]. Every transaction, from a simple value transfer to a complex function
call, incurs a gas cost that must be paid in Ether. Eficient gas usage is therefore a key design concern in
SCs development [
        <xref ref-type="bibr" rid="ref4">4</xref>
        ].
      </p>
      <p>
        The inherent characteristics of SCs lead to unusual challenges influencing all phases of the software
life cycle [
        <xref ref-type="bibr" rid="ref6">6</xref>
        ]. For instance, due to the characteristics of immutability and transparency of SCs, in the
design steps, it is necessary to make systems modular and upgradable and avoid storing sensitive
information, as, once published, it will be accessible to everyone. During the development phase,
instead, care must be taken in implementing the smart contract by optimizing both the computational
cost of gas that would be required for its execution and security because smart contracts often control
and manage sensitive digital assets and, after the deployment, an attacker could identify any flaws
and exploit them. Due to immutability, it will not be possible to accomplish updates or corrective
patches [
        <xref ref-type="bibr" rid="ref7">7</xref>
        ]. Furthermore, the lack of consolidated best practices, universal standards in terms of security
and eficiency, and adequate tools to verify the correctness of the code complicates these already tangled
steps. Finally, concerning the maintenance phase, challenges inevitably arise in implementing corrective
and adaptive actions when a problem is discovered or a change disrupts the SC operation. Once deployed,
modifications to the specific smart contract to restore proper functionality are no longer possible.
      </p>
      <p>However, little is known about the issues users and developers of active SCs typically encounter after
SC deployment and how these issues are specifically managed and resolved. To start filling this gap,
this work explores issues reported in SC-related projects on collaborative platforms, investigating how
they are communicated and managed. By comparing these practices with those of more conventional
software repositories, we aim to identify patterns occurring in similar underlying reports and assess
the efectiveness of the current reporting and management dynamics, with the long-term goal of
improving the accuracy and timeliness of issue management practices in SC-related projects. The
analysis specifically focuses on (i) identifying active smart contract repositories with issue reporting
enabled, (ii) analyzing the frequency, nature, and classification of reported issues, and (iii) drawing
comparisons with traditional software projects in terms of issue types and their lifecycle. In particular,
understanding how often issues arise and what types are most common can help teams prioritize
recurring pain points and allocate resources more efectively. In addition, parallels with conventional
software allow for identifying gaps or best practices, leading to improved maturity in issue management.</p>
      <p>Paper structure. The paper proceeds as follows. Section 2 discusses the related literature,
highlighting the novelty of our findings. Section 3 presents the research questions and the methodology to
answer them. Section 4 reports and discusses the preliminary results. Finally, Section 5 concludes the
paper outlining future research directions.</p>
    </sec>
    <sec id="sec-2">
      <title>2. Related work</title>
      <p>The scientific community is currently paying particular attention to the critical phases of the smart
contract life cycle, focusing on development and maintenance. To date, these phases represent the
ones that most difer from traditional systems, giving rise to innovative challenges to improve security,
reliability, and eficiency.</p>
      <p>
        Regarding the development phase, the study conducted by the Karlsruhe Institute of Technology
(KIT) [
        <xref ref-type="bibr" rid="ref8">8</xref>
        ] pinpointed three main categories of challenges: (i) the platform makes it dificult to trace
the user’s identity through the address used, and the updateability of the code; (ii) the programming
language and execution environment are lean to computational ineficiency and inadequate memory
management, leading to performance drops and gas leaks; (iii) the adoption of complex code practices
concerning transactions’ security and the currency management that can disrupt code readability and
understandability.
      </p>
      <p>
        Regarding the maintenance phase, instead, Chen et al. [
        <xref ref-type="bibr" rid="ref4">4</xref>
        ] focused on the challenges afecting
three main tasks: (i) the corrective maintenance is hampered by the lack of refined tools for bugs and
error detections, alongside skimpy community support in reporting due to the lack of developers and
researchers with expertise in the field; (ii) the adaptive maintenance is made tricky by the ongoing
evolution of the Ethereum network, that can make any SC obsolete or even no longer operational, heavily
afecting its dependability; (iii) the perfective maintenance is deeply restricted by the plainness of Solidity
grammar, which limits projects’ scalability, and imposes trade-ofs between gas cost optimization and
code readability. Besides, preventive maintenance is fairly absent due to the constant SCs’ ecosystem
growth and the lack of consolidated standards and experts in the field. Finally, the study emphasizes
the shortage of fruitful tools and methodologies to support the maintenance phase of smart contracts.
      </p>
      <p>
        A further obstacle impacting the development and maintenance of smart contracts is represented
by code duplication, a widespread practice, especially among less skilled developers. For example,
Pierro and Tonelli [
        <xref ref-type="bibr" rid="ref9">9</xref>
        ] discovered that on 7,500 smart contracts carried from the Ethereum platform,
over 80% of them include duplicate portions of code. This behavior makes the implementation phase
easier but raises severe issues. Without appropriate verification and customization, code clones improve
complexity. This often translates into greater gas consumption, increasing the maintenance eforts
required for optimization. Moreover, code clones often contain outdated functions or libraries or
functions developed for other purposes, introducing errors or vulnerabilities. Indeed, He et al. [
        <xref ref-type="bibr" rid="ref10">10</xref>
        ]
observed that the high presence of SCs containing duplicate code fragments has led to a proliferation of
contracts that inherit vulnerabilities or design errors in the Ethereum ecosystem.
      </p>
      <p>
        The high propagation of vulnerabilities represents an efective criticality for SC security and reliability.
In 2022, observing 30 SC-related security flaws, the estimated financial losses amounted to 1.2 billion,
with an increase of 837% compared to the previous year, indicative that many developers had not
updated the code of their SCs to fix known vulnerabilities [
        <xref ref-type="bibr" rid="ref11">11</xref>
        ]. In light of these findings, the scientific
community is reserving greater awareness of vulnerability analysis and developing increasingly refined
tools for the static and dynamic analysis of SCs.
      </p>
      <p>
        In contrast to prior studies focusing on technical and structural challenges, the work by Vaccargiu et
al. [
        <xref ref-type="bibr" rid="ref12">12</xref>
        ] investigates the socio-technical factors of issue management within blockchain-based projects.
Analyzing 15, 954 Go-Ethereum issues and 50, 023 comments from GitHub, the authors apply topic
modeling to reveal that sustainability emerges as a prominent theme, accounting for about 38% of the
identified topics. Additionally, network analysis highlights gas prices and cost eficiency as main topics
in sustainability communities.
      </p>
      <p>Unlike the studies above, this work investigates issue reporting and management in SC-related
projects. Bug reports or requests for new features are essential to software maintenance and evolution
tasks. In traditional software systems, issue management happens through consolidated tools, such
as issue tracking systems, which allow recording, categorizing, and managing reports in a structured
way. As regards smart contracts, however, it is unclear how and what types of issues are reported and
efectively addressed. Therefore, this study evaluates how much and in what way consolidated software
maintenance tools are adopted in the distinct context of smart contracts.</p>
    </sec>
    <sec id="sec-3">
      <title>3. Objectives and Study Design</title>
      <p>The goal of our study is to investigate the issue reporting and management practices in SC-related
projects to spot operational peculiarities. Starting from open source projects (as a preliminary analysis,
only projects publicly available on GitHub were considered), the goal is to understand the process of
issue report discussion, management, and resolution in SC-related projects and compare them with
those observed in traditional software systems. The findings provide useful knowledge to improve the
tools and practices of problem management in blockchain-based projects. With these objectives, we
pose the following research questions:
• RQ1: Among the most active and used SCs on the Ethereum blockchain, how many have
their source code publicly developed and maintained on the GitHub collaborative
development platform?
• RQ2: What percentage of smart contract projects found on GitHub have received at least
one issue report and how many issues are tracked?
• RQ3: What are the most recurring labels associated with issue reports in smart contract
projects found on GitHub?
• RQ4: What are the characteristics of closed issue reports across smart contract projects
hosted on GitHub?</p>
      <p>RQ1 assesses the transparency and accessibility of the source code of the most used smart contracts
on the Ethereum blockchain. With RQ2, we pinpoint the adoption of issue trackers among SC
developers. The frequency and distribution of issue reports are also evaluated to understand the extent and
complexity of issue management in the identified smart contract-related projects. RQ 3 determines
the recurrent cases and their categorization for gaining a better understanding of the most common
criticalities. Finally, with RQ4, we analyze the dynamics of closed issues reported on the diferent
projects.</p>
      <sec id="sec-3-1">
        <title>3.1. Experimental dataset</title>
        <p>
          Starting from the public Ethereum dataset bigquery-public-data.crypto_ethereum1, Google BigQuery
was used to find all contract addresses, joined with the total number of transactions, performed since
the contract deployment on the blockchain, and the date of the last recorded transaction. This stage has
led to the identification of 8, 922, 530 contract addresses. Since we were interested in mining active
and used SCs, the relevance of the collected data was assured by removing addresses with less than
10 transactions associated or whose last transaction was earlier than 2024, reducing the addresses to
272, 014. Later, the contracts’ source code was retrieved using Etherscan, a well-known platform to
explore and examine the Ethereum blockchain [
          <xref ref-type="bibr" rid="ref13">13</xref>
          ], obtaining 203,033 files. All the contracts with a
language diferent from Solidity and any duplicates were eventually filtered out. After this filtering step,
the experimental dataset evolved to 82, 337 files. We then ordered the remaining files by the number of
transactions received and selected the top 2, 000, ensuring extensive interaction and representativeness.
        </p>
      </sec>
      <sec id="sec-3-2">
        <title>3.2. Analysis methodology</title>
        <p>
          To answer RQ1, a Python script was built to automate the invocation of the GitHub REST API.
This service allows access to a wide range of GitHub features [
          <xref ref-type="bibr" rid="ref14">14</xref>
          ], i.e. full_name, description,
created_at, updated_at, stargazers_count, forks_count, open_issues, open_issues_count, pushed_at, license,
default_branch, topics. For each of the 2,000 smart contracts featured in the dataset detailed in Section 3.1,
the script exploits the GitHub search feature by (i) building a query containing a noteworthy piece of the
Solidity source code and (ii) analyzing all the retrieved repositories in terms of the number of Solidity
ifles contained: if this number is greater than 100, the script recognizes the repository as a collection of
SCs and, therefore, discard it; otherwise, the repository is identified as worth of further analysis. For
the remaining repositories (i.e., the ones worthy of further analysis), a deeper comparison between the
whole source code of the smart contract extracted from the initial dataset and the one retrieved from
GitHub is performed. The main limitations encountered are: (i) the limited number of searches that can
be executed via the GitHub API in a given time frame, causing long execution time; (ii) a high number of
search results for each query due to smart contracts with duplicate code fragments; (iii) the GitHub API
limit for query size to 256 characters, leading to high false positives in query results. The first limitation
was mitigated through a sleep function. To address the others, we created queries reporting the first
200 characters of the source code contained in the initial dataset and filtering the results to the Solidity
ifles only. Despite being simple, this method has proven valid as, usually, details at the beginning
of the source code, such as specific metadata, introductory comments, the Solidity version, or any
logos, allow for obtaining more pertaining search results. GitHub’s search algorithm sorts results based
on the position of the search phrase within the code; that is, the first outcomes produced match the
search string in the initial lines, increasing the precision of the search. The second approach populates
the query with the functions’ signatures of the source code, obtained with regular expressions. The
ifnal results include all distinct projects successfully retrieved using these two approaches, without
considering out-of-scope (e.g., audits, replication packages, API documentation, testing tools, etc.) and
projects with less than five stargazers, to exclude toy projects or projects with too limited visibility.
        </p>
        <p>
          The other RQs were answered using the Perceval tool [
          <xref ref-type="bibr" rid="ref15">15</xref>
          ]. Leveraging the GitHub REST API, Perceval
allows users to pull out all issue reports’ data from a repository and collect them in JSON format. A
Python script was used to run Perceval on all repositories found in RQ1, analyze the corresponding
outputs, and compute the required statistics. The procedure first involves the extraction of issues only,
as the GitHub API includes also pull requests in issue retrieval. For each issue retrieve the current
1https://cloud.google.com/blog/products/data-analytics/data-for-11-more-blockchains-in-bigquery-public-datasets
state, and, if it is closed, collect the comments’ number and compute the Time to Resolution (TTR), by
subtracting created_at from closed_at time. Eventually, gather the tags related to each issue.
        </p>
      </sec>
    </sec>
    <sec id="sec-4">
      <title>4. Results</title>
      <p>
        This section reports the obtained results and compares them with those concerning traditional software
observed in previous work: for RQ2 and RQ3, we considered the study of Bissyandé et al. [
        <xref ref-type="bibr" rid="ref16">16</xref>
        ], who
analyzed 100, 000 GitHub repositories, focusing on the adoption and impact of issue tracking systems
in traditional open source projects on GitHub; for RQ4, the comparison is made considering the work
of Sülün et al. [
        <xref ref-type="bibr" rid="ref17">17</xref>
        ], who examined the adoption of issue templates across GitHub projects and the
managing dynamics of 1.9 million issue reports with and without conformance to templates.
      </p>
      <sec id="sec-4-1">
        <title>4.1. Smart contracts developed on GitHub and issue report adoption</title>
        <p>To answer RQ1, the execution of the queries described in 3.2 led respectively to 339 files within 251
repositories and 217 files within 175 repositories, merged into 436 unique files within 316 distinct
repositories. After filtering out low visibility and out-of-scope projects, the repositories’ number
significantly decreased to 42 items. Therefore, among the 2, 000 most active and used SCs on the Ethereum
blockchain, only 2.1% of them are publicly developed and maintained on the GitHub collaborative
development platform. The limited number of identified repositories highlights a key limitation of
relying solely on open-source sources for smart contract investigation, suggesting that most active
contracts are likely developed and maintained privately or via alternative platforms. To investigate this
further, since in some platforms such as GitLab the global search is restricted to premium users, and
manually querying every single project was prohibitively time-consuming, we performed a raw Google
query search using the first 150 characters for each of the 2, 000 contracts and filtered the results
matching the domains https://gitlab.com, https://bitbucket.com, and https://openzeppelin.com. However, this
strategy yielded no successful matches. Therefore, we proceeded by collecting the top ten domains from
Google’s response to each of the queries above. As reported in Table 1, GitHub is the most frequently
occurring domain, confirming its essential role for future analyses. Notably, for 223 repositories, no
trace could be found on the public web, suggesting they may be private or hosted on non-indexed
or restricted-access platforms. Among the domains identified, several are not hosting platforms but
discussion forums (e.g., Ethereum StackExchange, OpenZeppelin Forum), documentation sites (e.g.,
docs.openzeppelin.com, docs.soliditylang.org), or educational resources (e.g., O’Reilly, GeeksforGeeks,
Metaschool). This mix indicates that while GitHub remains prominent for code hosting, much of the
smart contract discussions, learning, and technical reference happen on generic domains, reflecting the
scraped nature of the smart contract development ecosystem. On the contrary, further platforms like
GitLab and Bitbucket yielded no successful outcomes via direct or indirect query methods, emphasizing
the limitations in visibility and accessibility on those platforms.</p>
        <p>
          Concerning RQ2, out of 42 SC-related projects found on GitHub, three have the issue tracker disabled
(7%), 18 have not received any issue reported (40%), and 21 feature at least one issue report (52%).
Figure 1a compares these results with those from traditional software (SWs) [
          <xref ref-type="bibr" rid="ref16">16</xref>
          ], where 3.8% projects
have the issue tracker disabled, 66% have no issues received, and 30% feature at least one issue report.
Therefore, SC projects tend to take advantage of the issue-tracking systems more. Instead, Figure 1b
provides a picture of issue distributions. For SC-related projects, (i) 39 repositories have less than 50
issues reported, 93% against the 86% of traditional software, (ii) no repository has between 50 and
100 issue reported, against the 7% of traditional software, (iii) one repository has between 100 and
500 issues, 2% against the 6.31% of traditional software, and (iv) two repositories have more than 500
issues, 5% against the 1.14% of traditional software. The distribution of SC-related projects is not
homogeneous in the intermediate ranges, showing a high proportion of projects with very few issues,
while a few projects show higher issue rates. This highlights developers’ and users’ trends to consider
more popular projects, leading to a more prominent reporting of bugs, requests, and suggestions, with
lesser-known projects resulting in few reports.
        </p>
      </sec>
      <sec id="sec-4-2">
        <title>4.2. Label analysis and issue characteristics in smart contract-related projects</title>
        <p>To answer 3, we analyzed the 3, 793 issues extracted through Perceval from the 42 SC-related
repositories, examining the labels (i.e., customizable tags used to classify an issue) assigned to each
issue report and reporting a total of 4, 126 labels. Table 2 reports the top-10 frequent tags: the most
used are enhancement and bug, which occur in 29% and 20% of cases, respectively. The comparison
with traditional software (see Figure 2) corroborates the trend to use an issue tracker to mainly request
enhancements, while bugs have similar distributions in both contexts. Although the relevant presence
of bug reports is expected as SCs generally handle financial transactions or sensitive data, the high
frequency of enhancement requests likely reflects the dynamic nature of the blockchain ecosystem.
As this ecosystem evolves rapidly, developers and users propose improvements to adapt to emerging
standards or optimize existing functionalities to keep pace with technological advancements and
changing user needs.</p>
        <p>
          To answer 4, we considered the Time To Resolve (TTR) in days and the number of comments
of closed issues. The collected statistics are compared with the work of Sülün et al. [
          <xref ref-type="bibr" rid="ref17">17</xref>
          ], whose main
scope is to inspect how the adoption of templates afects issue management. Out of the 42 SC-related
projects, only one employs issue templates. Therefore, the comparisons of Figure 3 consider issues
in projects with no templates available. The histograms of Figure 3 reveal that issue resolution in
SC-related projects generally requires less time than traditional software despite the high number of
comments received. However, the high standard deviation value suggests that large projects notably
impact results.
        </p>
        <p>
          A manual inspection of the issue reports in our dataset reveals recurring themes. In particular, several
reports [
          <xref ref-type="bibr" rid="ref18 ref19">18, 19</xref>
          ], even unlabeled [20, 21, 22, 23, 24], concern bugs, highlighting that the percentages
in Figure 2 are underestimated. Security-related concerns [25, 26] also emerge, including potential
vulnerabilities, typical blockchain attacks, and security flaws. Other issues [ 27] regard development
workflows, emphasizing the increasing complexity of managing smart contract ecosystems. Instead,
enhancement requests are mainly oriented toward testing improvements [28], gas optimization [29, 30]
and general code quality refinement [ 31, 32]. Finally, our manual inspection confirms that SC developers
follow a collaborative approach to issue resolution, making intensive use of issue comments [33, 24].
        </p>
      </sec>
    </sec>
    <sec id="sec-5">
      <title>5. Conclusion</title>
      <p>Nowadays, the scientific community has started investigating the general development dynamics and
problem management practices in the smart contract ecosystem, as the widespread difusion of this
technology has inevitably led to an increase in specific challenges developers and smart contract users
have to address. In this context, this paper explores the characteristics of issue reports and their
management in SC-related projects, comparing them with those of traditional software projects. To
conduct this analysis, we built a dataset of public data containing smart contracts from the Ethereum
blockchain, considering the programming language, source code accessibility, and their degree of
activity. As a preliminary investigation, the top 2000 SCs in terms of transactions carried out were
selected. However, only 42 of them have their source code publicly developed and maintained on the
GitHub platform. Leveraging the information stored in the issue trackers of these projects, we gathered
the data required to pursue the statistical analysis. The collected data were compared with those from
previous literature concerning traditional software, emphasizing diferences between the two areas
within the limits of the small size of the experimental dataset. Our results remark that SC developers and
users employ the issue-tracking system more than traditional software. However, the vast majority of
SC-related projects receive less than 50 issues; only a few projects receive more than 500 issues, lacking
an intermediate range. Furthermore, while the rate of bug reports is similar for the two contexts, the
study highlighted that, in SC-related projects, there is a greater demand for enhancements compared to
traditional software. However, among SC projects, we also found a scarce adoption of standardized issue
templates. Standardized issue templates and contribution guidelines would ensure higher consistency
and clarity in reporting, likely enhancing interactions and collaborative development. Finally, there is a
general trend to resolve issues earlier than traditional software, with an extensive use of comments in
the resolution process. Therefore, the integration of communication and traceability tools like Gitter or
Discord would allow for dynamic and threaded conversations, ensuring more transparent, eficient, and
audit-friendly development workflows.</p>
      <sec id="sec-5-1">
        <title>5.1. Limitations and Future Work</title>
        <p>The reported results are subject to several limitations that should be addressed in future work. First, the
process used to match smart contracts with their corresponding GitHub repositories (see Section 3.2)
may lack completeness and precision. Refining the search methodology, both by improving matching
heuristics and incorporating additional collaborative platforms such as GitLab (with premium
functionalities), could increase the efectiveness and accuracy of the dataset. Besides, the analysis is based
on Ethereum smart contracts only, with just 42 repositories out of the top 2,000 most used contracts
publicly available and maintained on GitHub. This small subset (2.1%) may introduce a significant
selection bias and limit the findings’ generalizability. Further, popular contracts are inherently more
likely to receive issue reports, potentially growing metrics related to issue frequency and management
activity. To mitigate these limitations, we plan to extend the dataset both in scale and variety. This
expansion will involve incorporating a substantially larger number of smart contracts, not only from
Ethereum but also from other leading blockchain platforms such as Binance Smart Chain and Solana.
This would ensure a more representative and reliable understanding of the smart contract development
landscape, enabling the analysis of a broader range of development and maintenance practices.</p>
        <p>Beyond the dataset issue, there is also a noteworthy possibility to pull practical insights from the issue
reports themselves. Future directions should investigate the nature and timing of reported issues to
identify common error patterns, recurring feature requests, and the stages of the typical problem-solving
cycle.</p>
      </sec>
    </sec>
    <sec id="sec-6">
      <title>Declaration on Generative AI</title>
      <p>The author(s) have not employed any Generative AI tools.
[20] Github.com, datachainlab/ethereum-ibc-relay-chain issue #41, https://github.com/datachainlab/
ethereum-ibc-relay-chain/issues/41, 2024.
[21] Github.com, kryptoklob-deprecated/zethr-issue-tracker issue #2, https://github.com/
kryptoklob-deprecated/Zethr-Issue-Tracker/issues/2, 2018.
[22] Github.com, larvalabs/cryptopunks issue #3, https://github.com/larvalabs/cryptopunks/issues/3,
2024.
[23] Github.com, Nibiruchain/nibiru issue #2252, https://github.com/NibiruChain/nibiru/issues/2252,
2025.
[24] Github.com, Nibiruchain/nibiru issue #2158, https://github.com/NibiruChain/nibiru/issues/2158,
2025.
[25] Github.com, aragon/aragon-network-token issue #23, https://github.com/aragon/
aragon-network-token/issues/23, 2020.
[26] Github.com, larvalabs/cryptopunks issue #31, https://github.com/larvalabs/cryptopunks/issues/31,
2024.
[27] Github.com, radicle-dev/radicle-contracts issue #130, https://github.com/radicle-dev/
radicle-contracts/issues/130, 2021.
[28] Github.com, bcnmy/mexa issue #14, https://github.com/bcnmy/mexa/issues/14, 2020.
[29] Github.com, balancer/exchange-proxy issue #3, https://github.com/balancer/exchange-proxy/
issues/3, 2020.
[30] Github.com, bokkypoobah/bokkypoobahstokenteleportationservicesmartcontract issue #10, https:
//github.com/bokkypoobah/BokkyPooBahsTokenTeleportationServiceSmartContract/issues/10,
2018.
[31] Github.com, hexoul/ether-stealer issue #2, https://github.com/hexoul/ether-stealer/issues/2, 2018.
[32] Github.com, bokkypoobah/bokkypoobahstokenteleportationservicesmartcontract issue #8, https://
github.com/bokkypoobah/BokkyPooBahsTokenTeleportationServiceSmartContract/issues/8, 2018.
[33] Github.com, larvalabs/cryptopunks issue #19, https://github.com/larvalabs/cryptopunks/issues/19,
2024.</p>
    </sec>
  </body>
  <back>
    <ref-list>
      <ref id="ref1">
        <mixed-citation>
          [1]
          <string-name>
            <given-names>A.</given-names>
            <surname>Di Sorbo</surname>
          </string-name>
          ,
          <string-name>
            <given-names>S.</given-names>
            <surname>Laudanna</surname>
          </string-name>
          ,
          <string-name>
            <given-names>A.</given-names>
            <surname>Vacca</surname>
          </string-name>
          ,
          <string-name>
            <given-names>C. A.</given-names>
            <surname>Visaggio</surname>
          </string-name>
          , G. Canfora,
          <article-title>Profiling gas consumption in solidity smart contracts</article-title>
          ,
          <source>Journal of Systems and Software</source>
          <volume>186</volume>
          (
          <year>2022</year>
          )
          <fpage>111193</fpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref2">
        <mixed-citation>
          [2]
          <string-name>
            <given-names>M.</given-names>
            <surname>Pacheco</surname>
          </string-name>
          , G. Oliva,
          <string-name>
            <given-names>G. K.</given-names>
            <surname>Rajbahadur</surname>
          </string-name>
          ,
          <string-name>
            <given-names>A.</given-names>
            <surname>Hassan</surname>
          </string-name>
          ,
          <article-title>Is my transaction done yet? an empirical study of transaction processing times in the ethereum blockchain platform</article-title>
          ,
          <source>ACM Transactions on Software Engineering and Methodology</source>
          <volume>32</volume>
          (
          <year>2023</year>
          )
          <fpage>1</fpage>
          -
          <lpage>46</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref3">
        <mixed-citation>
          [3]
          <string-name>
            <given-names>G.</given-names>
            <surname>Wood</surname>
          </string-name>
          , et al.,
          <article-title>Ethereum: A secure decentralised generalised transaction ledger</article-title>
          ,
          <source>Ethereum project yellow paper 151</source>
          (
          <year>2014</year>
          )
          <fpage>1</fpage>
          -
          <lpage>32</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref4">
        <mixed-citation>
          [4]
          <string-name>
            <given-names>J.</given-names>
            <surname>Chen</surname>
          </string-name>
          ,
          <string-name>
            <given-names>X.</given-names>
            <surname>Xia</surname>
          </string-name>
          ,
          <string-name>
            <given-names>D.</given-names>
            <surname>Lo</surname>
          </string-name>
          ,
          <string-name>
            <given-names>J.</given-names>
            <surname>Grundy</surname>
          </string-name>
          ,
          <string-name>
            <given-names>X.</given-names>
            <surname>Yang</surname>
          </string-name>
          ,
          <article-title>Maintenance-related concerns for post-deployed ethereum smart contract development: issues, techniques, and future challenges</article-title>
          ,
          <source>Empirical Software Engineering</source>
          <volume>26</volume>
          (
          <year>2021</year>
          )
          <fpage>117</fpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref5">
        <mixed-citation>
          [5]
          <string-name>
            <given-names>P.</given-names>
            <surname>Maidamwar</surname>
          </string-name>
          ,
          <string-name>
            <given-names>N.</given-names>
            <surname>Chavhan</surname>
          </string-name>
          ,
          <article-title>Blockchain technology: a review on architecture, security issues and challenges</article-title>
          , in: International Conference on IoT,
          <year>2023</year>
          .
        </mixed-citation>
      </ref>
      <ref id="ref6">
        <mixed-citation>
          [6]
          <string-name>
            <given-names>M. H.</given-names>
            <surname>Miraz</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Ali</surname>
          </string-name>
          ,
          <article-title>Blockchain enabled smart contract based applications: Deficiencies with the software development life cycle models</article-title>
          , arXiv preprint arXiv:
          <year>2001</year>
          .
          <volume>10589</volume>
          (
          <year>2020</year>
          ).
        </mixed-citation>
      </ref>
      <ref id="ref7">
        <mixed-citation>
          [7]
          <string-name>
            <given-names>W.</given-names>
            <surname>Zou</surname>
          </string-name>
          ,
          <string-name>
            <given-names>D.</given-names>
            <surname>Lo</surname>
          </string-name>
          ,
          <string-name>
            <given-names>P. S.</given-names>
            <surname>Kochhar</surname>
          </string-name>
          ,
          <string-name>
            <surname>X.-B. D. Le</surname>
            ,
            <given-names>X.</given-names>
          </string-name>
          <string-name>
            <surname>Xia</surname>
            ,
            <given-names>Y.</given-names>
          </string-name>
          <string-name>
            <surname>Feng</surname>
            ,
            <given-names>Z.</given-names>
          </string-name>
          <string-name>
            <surname>Chen</surname>
            ,
            <given-names>B.</given-names>
          </string-name>
          <string-name>
            <surname>Xu</surname>
          </string-name>
          ,
          <article-title>Smart contract development: Challenges and opportunities</article-title>
          ,
          <source>IEEE transactions on software engineering 47</source>
          (
          <year>2019</year>
          )
          <fpage>2084</fpage>
          -
          <lpage>2106</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref8">
        <mixed-citation>
          [8]
          <string-name>
            <given-names>N.</given-names>
            <surname>Kannengiesser</surname>
          </string-name>
          ,
          <string-name>
            <given-names>S.</given-names>
            <surname>Lins</surname>
          </string-name>
          ,
          <string-name>
            <given-names>C.</given-names>
            <surname>Sander</surname>
          </string-name>
          ,
          <string-name>
            <given-names>K.</given-names>
            <surname>Winter</surname>
          </string-name>
          ,
          <string-name>
            <given-names>H.</given-names>
            <surname>Frey</surname>
          </string-name>
          ,
          <string-name>
            <given-names>A.</given-names>
            <surname>Sunyaev</surname>
          </string-name>
          ,
          <article-title>Challenges and common solutions in smart contract development</article-title>
          ,
          <source>IEEE Transactions on Software Engineering</source>
          <volume>48</volume>
          (
          <year>2021</year>
          )
          <fpage>4291</fpage>
          -
          <lpage>4318</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref9">
        <mixed-citation>
          [9]
          <string-name>
            <given-names>G. A.</given-names>
            <surname>Pierro</surname>
          </string-name>
          ,
          <string-name>
            <given-names>R.</given-names>
            <surname>Tonelli</surname>
          </string-name>
          ,
          <article-title>Analysis of source code duplication in ethreum smart contracts</article-title>
          ,
          <source>in: 2021 IEEE International Conference on Software Analysis, Evolution and Reengineering</source>
          (SANER), IEEE,
          <year>2021</year>
          , pp.
          <fpage>701</fpage>
          -
          <lpage>707</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref10">
        <mixed-citation>
          [10]
          <string-name>
            <given-names>N.</given-names>
            <surname>He</surname>
          </string-name>
          ,
          <string-name>
            <given-names>L.</given-names>
            <surname>Wu</surname>
          </string-name>
          ,
          <string-name>
            <given-names>H.</given-names>
            <surname>Wang</surname>
          </string-name>
          ,
          <string-name>
            <given-names>Y.</given-names>
            <surname>Guo</surname>
          </string-name>
          ,
          <string-name>
            <given-names>X.</given-names>
            <surname>Jiang</surname>
          </string-name>
          ,
          <article-title>Characterizing code clones in the ethereum smart contract ecosystem</article-title>
          ,
          <source>in: Financial Cryptography and Data Security: 24th International Conference, FC</source>
          <year>2020</year>
          ,
          <string-name>
            <given-names>Kota</given-names>
            <surname>Kinabalu</surname>
          </string-name>
          , Malaysia,
          <source>February 10-14</source>
          ,
          <source>2020 Revised Selected Papers 24</source>
          , Springer,
          <year>2020</year>
          , pp.
          <fpage>654</fpage>
          -
          <lpage>675</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref11">
        <mixed-citation>
          [11]
          <string-name>
            <given-names>G.</given-names>
            <surname>Wu</surname>
          </string-name>
          ,
          <string-name>
            <given-names>H.</given-names>
            <surname>Wang</surname>
          </string-name>
          ,
          <string-name>
            <given-names>X.</given-names>
            <surname>Lai</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Wang</surname>
          </string-name>
          ,
          <string-name>
            <given-names>D.</given-names>
            <surname>He</surname>
          </string-name>
          ,
          <string-name>
            <given-names>S.</given-names>
            <surname>Chan</surname>
          </string-name>
          ,
          <article-title>A comprehensive survey of smart contract security: State of the art and research directions</article-title>
          ,
          <source>Journal of Network and Computer Applications</source>
          (
          <year>2024</year>
          )
          <fpage>103882</fpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref12">
        <mixed-citation>
          [12]
          <string-name>
            <given-names>M.</given-names>
            <surname>Vaccargiu</surname>
          </string-name>
          ,
          <string-name>
            <given-names>S.</given-names>
            <surname>Aufiero</surname>
          </string-name>
          ,
          <string-name>
            <given-names>S.</given-names>
            <surname>Bartolucci</surname>
          </string-name>
          ,
          <string-name>
            <given-names>R.</given-names>
            <surname>Neykova</surname>
          </string-name>
          ,
          <string-name>
            <given-names>R.</given-names>
            <surname>Tonelli</surname>
          </string-name>
          , G. Destefanis,
          <article-title>Sustainability assessment of ethereum developers issues and comments: Topic and network analysis</article-title>
          ,
          <source>Preprint</source>
          (
          <year>2025</year>
          ).
        </mixed-citation>
      </ref>
      <ref id="ref13">
        <mixed-citation>
          [13]
          <string-name>
            <given-names>N.</given-names>
            <surname>Grech</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Kong</surname>
          </string-name>
          ,
          <string-name>
            <given-names>A.</given-names>
            <surname>Jurisevic</surname>
          </string-name>
          ,
          <string-name>
            <given-names>L.</given-names>
            <surname>Brent</surname>
          </string-name>
          ,
          <string-name>
            <given-names>B.</given-names>
            <surname>Scholz</surname>
          </string-name>
          ,
          <string-name>
            <given-names>Y.</given-names>
            <surname>Smaragdakis</surname>
          </string-name>
          , Madmax:
          <article-title>Surviving out-of-gas conditions in ethereum smart contracts</article-title>
          ,
          <source>Proceedings of the ACM on Programming Languages</source>
          <volume>2</volume>
          (
          <year>2018</year>
          )
          <fpage>1</fpage>
          -
          <lpage>27</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref14">
        <mixed-citation>
          [14]
          <string-name>
            <given-names>A.</given-names>
            <surname>Lima</surname>
          </string-name>
          ,
          <string-name>
            <given-names>L.</given-names>
            <surname>Rossi</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Musolesi</surname>
          </string-name>
          ,
          <article-title>Coding together at scale: Github as a collaborative social network</article-title>
          ,
          <source>in: Proceedings of the international AAAI conference on web and social media</source>
          , volume
          <volume>8</volume>
          ,
          <year>2014</year>
          , pp.
          <fpage>295</fpage>
          -
          <lpage>304</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref15">
        <mixed-citation>
          [15]
          <string-name>
            <given-names>S.</given-names>
            <surname>Dueñas</surname>
          </string-name>
          ,
          <string-name>
            <given-names>V.</given-names>
            <surname>Cosentino</surname>
          </string-name>
          , G. Robles,
          <string-name>
            <given-names>J. M.</given-names>
            <surname>González-Barahona</surname>
          </string-name>
          ,
          <article-title>Perceval: software project data at your will</article-title>
          ,
          <source>in: Proceedings of the 40th International Conference on Software Engineering: Companion Proceeedings, ICSE</source>
          <year>2018</year>
          , Gothenburg, Sweden, May 27 - June 03,
          <year>2018</year>
          ,
          <year>2018</year>
          , pp.
          <fpage>1</fpage>
          -
          <lpage>4</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref16">
        <mixed-citation>
          [16]
          <string-name>
            <given-names>T. F.</given-names>
            <surname>Bissyandé</surname>
          </string-name>
          ,
          <string-name>
            <given-names>D.</given-names>
            <surname>Lo</surname>
          </string-name>
          ,
          <string-name>
            <given-names>L.</given-names>
            <surname>Jiang</surname>
          </string-name>
          ,
          <string-name>
            <given-names>L.</given-names>
            <surname>Réveillere</surname>
          </string-name>
          ,
          <string-name>
            <given-names>J.</given-names>
            <surname>Klein</surname>
          </string-name>
          ,
          <string-name>
            <given-names>Y.</given-names>
            <surname>Le Traon</surname>
          </string-name>
          ,
          <article-title>Got issues? who cares about it? a large scale investigation of issue trackers from github</article-title>
          ,
          <source>in: 2013 IEEE 24th international symposium on software reliability engineering (ISSRE)</source>
          , IEEE,
          <year>2013</year>
          , pp.
          <fpage>188</fpage>
          -
          <lpage>197</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref17">
        <mixed-citation>
          [17]
          <string-name>
            <given-names>E.</given-names>
            <surname>Sülün</surname>
          </string-name>
          ,
          <string-name>
            <given-names>M.</given-names>
            <surname>Saçakçı</surname>
          </string-name>
          ,
          <string-name>
            <surname>E. Tüzün,</surname>
          </string-name>
          <article-title>An empirical analysis of issue templates usage in large-scale projects on github</article-title>
          ,
          <source>ACM Transactions on Software Engineering and Methodology</source>
          <volume>33</volume>
          (
          <year>2024</year>
          )
          <fpage>1</fpage>
          -
          <lpage>28</lpage>
          .
        </mixed-citation>
      </ref>
      <ref id="ref18">
        <mixed-citation>
          [18]
          <string-name>
            <surname>Github</surname>
          </string-name>
          .com, Trueblocks/trueblocks-core issue #
          <volume>3587</volume>
          , https://github.com/TrueBlocks/ trueblocks-core/issues/3587,
          <year>2024</year>
          .
        </mixed-citation>
      </ref>
      <ref id="ref19">
        <mixed-citation>
          [19]
          <string-name>
            <surname>Github</surname>
          </string-name>
          .com, Trueblocks/trueblocks-core issue #
          <volume>3914</volume>
          , https://github.com/TrueBlocks/ trueblocks-core/issues/3914,
          <year>2024</year>
          .
        </mixed-citation>
      </ref>
    </ref-list>
  </back>
</article>