Documentation uses "Account Creation Fee" in multiple ways and should be clarified.
Open
Nobody has claimed this yet.
Document
Feedback
- Dominant language
- Go
- Stars
- 361
- Forks
- 159
- PR merge metrics
- No merged PRs in 30d
Description
Portions of the documentation site use the phrase "account creation fee" in an overloaded manner, which can be quite confusing to reconcile. This is particularly true now that the Segmented Transaction Fees documentation is live.
Examples:
- "account creation fee" means "The account balance minimum of 0.001 flow"
- "account creation fee" used ambiguously along with "storage fees"
*. https://docs.onflow.org/dapp-development/user-accounts-and-wallets/#flow-client-library-fcl - "create account" used within the Segmented Transaction Fees refers to only the amount of execution effort for the
AuthAccount(payer)function call, and doesn't mention the storage minimum at all.
I think to clear this up we should do two things:
- Align on the terminology here. Is the initial 0.001 flow an account creation fee, or is it a "minimum storage balance"
- Segmented Transction Fee documentation should:
- Refer to the operation as "AuthAccount" instead of the descriptive "create account"
- Point to the documentation on storage fees for new accounts and note that the "minimum storage balance" must still be satisfied by the payer.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read the storage/account-fee sections at the flow-token, flow-cli, and dapp-development links, then compare them with Segmented Transaction Fees. Confirm the agreed terminology and update the referenced documentation so AuthAccount, minimum storage balance, and storage-fee guidance are consistent and cross-linked.
Written by the indexing model from the issue text.
Assessment
- Domain
- blockchain, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100