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.

Automating Comment Generation for Smart Contract from Bytecode

Automating User Notice Generation for Smart Contract Functions

Automating Just-In-Time Comment Updating

Low-level Comments auto-generation for Solidity Smart Contracts

A Multi-Modal Transformer-based Code Summarization Approach for Smart Contracts

Cross-Modality Mutual Learning for Enhancing Smart Contract Vulnerability Detection on Bytecode

CCGIR: Information retrieval-based code comment generation method for smart contracts

Towards Automatic Smart-contract Codes Classification by Means of Word Embedding Model and Transaction Information

Automatic Smart Contract Comment Generation via Large Language Models and In-Context Learning

STAN: Towards Describing Bytecodes of Smart Contract

CodeAttention: Translating Source Code to Comments by Exploiting the Code Constructs

Bytecode Similarity Detection of Smart Contract across Optimization Options and Compiler Versions Based on Triplet Network

A Bytecode-based Approach for Smart Contract Classification

Code to Comment "Translation": Data, Metrics, Baselining & Evaluation

From Code to Natural Language: Type-Aware Sketch-Based Seq2Seq Learning

Deep Code Comment Generation with Hybrid Lexical and Syntactical Information

DeepCommenter: a Deep Code Comment Generation Tool with Hybrid Lexical and Syntactical Information

ComFormer: Code Comment Generation via Transformer and Fusion Method-based Hybrid Code Representation

Code Attention: Translating Code to Comments by Exploiting Domain Features

Retrieve and Refine: Exemplar-based Neural Comment Generation

CloCom: Mining existing source code for automatic comment generation