Abstract:Smart contracts have obtained much attention and are crucial for automatic financial and business transactions. For end-users who have never seen the source code, they can read the user notice shown in end-user client to understand what a transaction does of a smart contract function. However, due to time constraints or lack of motivation, user notice is often missing during the development of smart contracts. For end-users who lack the information of the user notices, there is no easy way for them to check the code semantics of the smart contracts. Thus, in this paper, we propose a new approach SMARTDOC to generate user notice for smart contract functions automatically. Our tool can help end-users better understand the smart contract and aware of the financial risks, improving the users' confidence on the reliability of the smart contracts. SMARTDOC exploits the Transformer to learn the representation of source code and generates natural language descriptions from the learned representation. We also integrate the Pointer mechanism to copy words from the input source code instead of generating words during the prediction process. We extract 7,878 (function, notice) pairs from 54,739 smart contracts written in Solidity. Due to the limited amount of collected smart contract functions (i.e., 7,878 functions), we exploit a transfer learning technique to utilize the learned knowledge to improve the performance of SMARTDOC. The learned knowledge obtained by the pre-training on a corpus of Java code, that has similar characteristics as Solidity code. The experimental results show that our approach can effectively generate user notice given the source code and significantly outperform the state-of-the-art approaches. To investigate human perspectives on our generated user notice, we also conduct a human evaluation and ask participants to score user notice generated by different approaches. Results show that SMARTDOC outperforms baselines from three aspects, naturalness, informativeness, and similarity.

Source Code Based On-demand Class Documentation Generation.

An automatic documentation generator based on model-driven techniques

Automatic Generation of API Documentations for Open-Source Projects

Automating User Notice Generation for Smart Contract Functions

Automatic Retrieval Method for Tracing Links Between Code and Chinese Documentation

gDoc: Automatic Generation of Structured API Documentation

Generating query-specific class API summaries.

RepoAgent: An LLM-Powered Open-Source Framework for Repository-level Code Documentation Generation

Automatic Model Generation from Documentation for Java API Functions

Flowgen: Flowchart-Based Documentation for C++ Codes

PinNet: Pinpoint Instructive Information for Retrieval Augmented Code-to-Text Generation

Automatic Code Documentation Generation Using GPT-3

APIDocBooster: An Extract-Then-Abstract Framework Leveraging Large Language Models for Augmenting API Documentation

Do we really need to write documentation for a system? CASE tool add-ons: generator+editor for a precise documentation

A^3-CodGen: A Repository-Level Code Generation Framework for Code Reuse with Local-Aware, Global-Aware, and Third-Party-Library-Aware

Combining Contexts from Multiple Sources for Documentation-Specific Code Example Generation

A Survey of Automatic Generation of Source Code Comments: Algorithms and Techniques

CloCom: Mining existing source code for automatic comment generation

Auto-generation of Class Diagram from Free-text Functional Specifications and Domain Ontology

DevDocOps: towards automated documentation for DevOps

ANDROID CODE AUTOMATIC GENERATION BASED ON APPLICATION DESCRIPTION