Skip to content
This repository has been archived by the owner on Jan 13, 2025. It is now read-only.

Added web3 reference guide #19970

Merged
merged 1 commit into from
Sep 22, 2021
Merged

Conversation

jacobcreech
Copy link
Contributor

Problem

Web3 was lacking a reference guide, and many ask for it in the support discord

Summary of Changes

Added web3 reference guide to the docs

@vercel
Copy link

vercel bot commented Sep 17, 2021

@cryptogosu is attempting to deploy a commit to the Solana Team on Vercel.

A member of the Team first needs to authorize it.

@mergify mergify bot added the community Community contribution label Sep 17, 2021
@mergify mergify bot requested a review from a team September 17, 2021 03:34
@jacobcreech jacobcreech force-pushed the web3-reference branch 3 times, most recently from c28370e to 686bb68 Compare September 17, 2021 14:53
@chaseeb chaseeb requested a review from jordaaash September 17, 2021 16:26
Copy link
Contributor

@jstarry jstarry left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is super helpful!

docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
docs/src/developing/clients/javascript-reference.md Outdated Show resolved Hide resolved
@mergify mergify bot requested a review from a team September 18, 2021 04:13
@jacobcreech jacobcreech force-pushed the web3-reference branch 2 times, most recently from 47fa6ed to d4cda94 Compare September 20, 2021 01:07
@jacobcreech
Copy link
Contributor Author

@jstarry Updated all documentation based on your suggestions.


[Source Documentation](https://solana-labs.github.io/solana-web3.js/classes/NonceAccount.html)

Normally a transaction is rejected if a transaction's `recentBlockhash` field is too old. To provide for certain custodial services, Nonce Accounts are used. Transactions created by a Nonce Account do not expire because they start with an `AdvanceNonceAccount` instruction, which updates the Nonce Account with an up-to-date `recentBlockhash`. This on-chain `recentBlockhash` is then used in the Nonce Account's transaction.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Normally a transaction is rejected if a transaction's `recentBlockhash` field is too old. To provide for certain custodial services, Nonce Accounts are used. Transactions created by a Nonce Account do not expire because they start with an `AdvanceNonceAccount` instruction, which updates the Nonce Account with an up-to-date `recentBlockhash`. This on-chain `recentBlockhash` is then used in the Nonce Account's transaction.
Normally a transaction is rejected if a transaction's `recentBlockhash` field is too old. To provide for certain custodial services, Nonce Accounts are used. Transactions which use a `recentBlockhash` captured on-chain by a Nonce Account do not expire as long at the Nonce Account is not advanced.

@mergify mergify bot requested a review from a team September 21, 2021 04:02
Copy link
Contributor

@jstarry jstarry left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wish that the most important classes came first and the others were grouped by category. For example, starting off with Authorized makes it feel that it's a foundational important thing to learn, but it's really just a detail of how the stake program. How about splitting some of these classes into categories like "General", "Staking", etc

@mergify mergify bot requested a review from a team September 21, 2021 04:04
Added web3 reference guide

Added web3 reference guide
@jacobcreech
Copy link
Contributor Author

@jstarry I updated the order and format to have General and Staking.

I also removed StakeInstruction, TransactionInstruction, and SystemInstruction and put a small reference to them in their respective StakeProgram, Transaction, and SystemProgram.

Let me know what you think about the new format.

@mergify mergify bot requested a review from a team September 22, 2021 13:38
@jstarry jstarry added the v1.7 label Sep 22, 2021
@jstarry jstarry merged commit b16f2da into solana-labs:master Sep 22, 2021
@jstarry
Copy link
Contributor

jstarry commented Sep 22, 2021

Looks much better thanks!

mergify bot pushed a commit that referenced this pull request Sep 22, 2021
Added web3 reference guide

Added web3 reference guide

(cherry picked from commit b16f2da)
danpaul000 pushed a commit to danpaul000/solana that referenced this pull request Oct 9, 2021
Added web3 reference guide

Added web3 reference guide
danpaul000 added a commit that referenced this pull request Oct 9, 2021
Co-authored-by: cryptogosu <82475023+cryptogosu@users.noreply.github.com>
dankelleher pushed a commit to identity-com/solana that referenced this pull request Nov 24, 2021
Added web3 reference guide

Added web3 reference guide
frits-metalogix added a commit to identity-com/solana that referenced this pull request Nov 24, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
community Community contribution
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants