We’re rewarding the question askers & reputations are being recalculated! Read more.

Questions tagged [documentation]

The tag has no usage guidance.

Filter by
Sorted by
Tagged with
1
vote
1answer
94 views

Deploying custom code to private network results in “instrinsic gas too low” or “check your gas” errors

TL:DR My first contract fails to deploy reporting variously: Error: intrinsic gas too low undefined Error: The contract code couldn't be stored, please check your gas amount. undefined Having just ...
1
vote
1answer
141 views

Documentation For Token Smart Contracts with JSON RPC

This is the documentation for the Ethereum Json RPC: https://github.com/ethereum/wiki/wiki/JSON-RPC Pretty straight forward, but where is the documentation for dealing with tokens via this protocol? ...
2
votes
1answer
796 views

Are there any tools to generate human-readable docs from Solidity source code?

Solidity's got built in support for generating JSON from docstrings, which does the hard part of extracting machine-readable data to build developer reference documentation. Are there any tools to ...
0
votes
1answer
23 views

What does this mean: “It is not possible to enumerate storage from within a contract” (Solidity doc)?

In the Solidity docs section on memory, you find this paragraph (emphasis added): Each account has a data area called storage, which is persistent between function calls and transactions. Storage ...
1
vote
0answers
19 views

How to process null TransactionReceipt?

I have some transaction that is sent and from time to time when I call the eth_getTransactionReceipt I get a null. I see esentially two approaches for handling this: I could reiterate the call to ...
3
votes
1answer
34 views

Documenting Smart Contracts and Dapps - community standards and tools

Do you guys know of any kind of documentation standards that are widely used within the Ethereum community? Any kind of documentation tools will also be of great help. Thanks in advance.
3
votes
2answers
1k views

Control Structures- why is switch and goto not in Solidity?

I was surprised to not see this question here already, and I've either missed the explanation in the docs or it's just not there. It's appreciated. Thanks.
19
votes
2answers
3k views

List of pre-compiled contracts

Where can I find an authoritative/"official" listing of the pre-compiled contracts currently on the Ethereum network, along with their exact specifications? I couldn't find anything in the official ...
1
vote
0answers
28 views

How can I convert natspec into human readable document from Windows and Linux? [closed]

How can I convert natspec into human readable document? Doxity looks good, but I need something for Windows or Linux.
1
vote
1answer
544 views

solidity-doc documentation?

I see something I assume to be akin to javadoc at https://www.npmjs.com/package/solidity-doc and Github at https://github.com/vitiko/solidity-doc. However, I see no documentation... the closest I get ...
2
votes
1answer
481 views

Local storage variable

I am reading the solidity docs here and I seem to be struggling to understand the following. Data locations are important because they change how assignments behave: assignments between ...
1
vote
1answer
57 views

Is there an explanation in the documentation (or elsewhere) for why so many of web3.js functions return Promises?

It seems that for a lot of these functions in web3js 1.0.0 there's no reason for it to not return a value or JS object, rather than a promise object. For example in a previous version of web3js (0....
0
votes
0answers
102 views

Dynamically-sized byte array is value type?

In the doc, it says bytes: Dynamically-sized byte array, see Arrays. Not a value-type! string: Dynamically-sized UTF-8-encoded string, see Arrays. Not a value-type! Not a value-type! If ...
2
votes
1answer
114 views

Understanding Low-Level Interface to Logs

This question is about Low-Level Interface to Logs, Solidity Documentation. In given examples we are able to emit event normally: pragma solidity ^0.4.0; contract ClientReceipt { event Deposit( ...
0
votes
1answer
28 views

What is an example of a require-style exception when receiving ether via a public getter?

In the Solidity documentation it is stated that: A require-style exception is generated in the following situations: ... If your contract receives Ether via a public getter function. ...
3
votes
0answers
131 views

Horrible Documentation! Better Solidity Documentation Location? [closed]

Hello Stack Exchange Ethereum list members: Can someone recommend a better resource for Solidity programming documentation other than solidity.readthedocs.io? To the Ethereum Documentation Team: ...
1
vote
3answers
297 views

What is the status of Proof of Stake?

Many different PoS approaches have been proposed but I am having a hard time finding documents that explain exactly how their protocols work. So, what are some current implementations of PoS? Where ...
1
vote
2answers
1k views

How to take a snapshot of addresses and balances of all normal addresses?

How would one take an addresses and balances "snapshot" of all 6,086,374 normal addresses at block number 4293752?
2
votes
0answers
25 views

Is an accurate clock really required to participate in the Ethereum network?

The Ethereum documentation states: https://github.com/ethereum/homestead-guide/blob/master/source/network/connecting-to-the-network.rst#static-nodes-trusted-nodes-and-boot-nodes "An accurate clock ...
1
vote
2answers
175 views

“Glossary of terms” for Ethereum components

very new to all this I'd think a bit of defining term's and getting started to know how some key components (like Ethereum, Ether, Gas, Token, etc.) relate to each like other would help a lot in ...
0
votes
2answers
957 views

How do I connect a blockchain system to a cloud database

I am very new to blockchain, so I just wanted to get some preliminary answers and clarity. So currently we have a cloud database to manage certain documents (which contains sensitive information). ...
6
votes
1answer
197 views

Solidity Documentation vs Grammar, which one is the most correct?

I was using the solidity grammar specification https://github.com/ethereum/solidity/blob/develop/docs/grammar.txt to write a parser in Smalltalk. After coding a first version of the parser, I started ...
2
votes
1answer
774 views

Is there a layered architecture diagram for Ethereum?

I wonder if there is a layered architecture diagram for Ethereum that shows from the lowest level to the highest level like the one of Java (http://docs.oracle.com/javase/8/docs/index.html)? It could ...
2
votes
1answer
446 views

How does automatic selling and buying with the constantly flowing price work?

From the docs: AUTOMATIC SELLING AND BUYING So far, you've relied on utility and trust to value your token. But if you want you can make the token's value be backed by ether (or other ...
3
votes
2answers
255 views

Give some examples of documentation that talks about reentrancy attacks / recursive call vulnerabilities

The DAO, a smart-contract on Ethereum, was vulnerable to reentrancy attacks and 3 million ETH worth $50 million was stolen from it. What are some examples of content that mentions reentrancy attacks? ...
1
vote
1answer
445 views

How do I use the proof of work function given in here: https://www.ethereum.org/token#proof-of-work?

I am creating a cryptocurrency contract, which rewards the miner a proof of work generated. To get the reward you will need to call proofOfWork(uint nonce). If the nonce is correct, the miner is ...
3
votes
1answer
642 views

Where can I find documentation/specification for mining pool communication?

I am looking for documentation or specification of communication/protocol between client and pool. Is there some or do I have to dig into source code of geth? (Yes, I know about the RPC documentation,...
4
votes
2answers
715 views

What's the default value for the second parameter of eth_getBalance() if not supplied

It's not clear in the documentation, but this function works if the 2nd parameter is not passed. What's the default if not passed?