From 74d3defd9d88a1f8395ff09a90f8e7448666d820 Mon Sep 17 00:00:00 2001 From: Joe Date: Wed, 3 Aug 2022 15:57:46 +0100 Subject: [PATCH] update api text --- README.md | 5 +++++ content/docs/interacting_with_geth/RPC/ns-clique.md | 6 +----- content/docs/interacting_with_geth/RPC/ns-eth.md | 7 ++----- content/docs/interacting_with_geth/RPC/ns-les.md | 2 +- content/docs/interacting_with_geth/RPC/ns-miner.md | 10 +++------- content/docs/interacting_with_geth/RPC/ns-net.md | 2 -- content/docs/interacting_with_geth/RPC/ns-personal.md | 7 ++----- content/docs/interacting_with_geth/RPC/ns-txpool.md | 5 +---- content/docs/interacting_with_geth/RPC/objects.md | 2 +- 9 files changed, 16 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 735b089fed..62509f9fe6 100644 --- a/README.md +++ b/README.md @@ -8,3 +8,8 @@ Resources: - some draft figma files for design sketching: https://www.figma.com/file/ekzIgwyeVKLtFSAcnA0Q0D/geth-website?node-id=6%3A31 - content planning notes: https://www.notion.so/efdn/Content-Strategy-3252234338814a749374fa7f11049083 - meeting notes: https://www.notion.so/efdn/Call-notes-46aa0202810a402ebfda07b046761cbd + + +Notes: + +**Dev note**: Remember that the fiules in `vulnerabilities` must be served at the same URLs as they are currently to avoid breaking some Geth functions related to security auditing. \ No newline at end of file diff --git a/content/docs/interacting_with_geth/RPC/ns-clique.md b/content/docs/interacting_with_geth/RPC/ns-clique.md index ac0b09f19f..98c68c5317 100644 --- a/content/docs/interacting_with_geth/RPC/ns-clique.md +++ b/content/docs/interacting_with_geth/RPC/ns-clique.md @@ -3,11 +3,7 @@ title: clique Namespace sort_key: C --- -The `clique` API provides access to the state of the clique consensus engine. You can use -this API to manage signer votes and to check the health of a private network. - -* TOC -{:toc} +The `clique` API provides access to the state of the clique consensus engine. This API cna be used to manage signer votes and to check the health of a private network. ### clique_getSnapshot diff --git a/content/docs/interacting_with_geth/RPC/ns-eth.md b/content/docs/interacting_with_geth/RPC/ns-eth.md index e8589ac56e..fe126eb99d 100644 --- a/content/docs/interacting_with_geth/RPC/ns-eth.md +++ b/content/docs/interacting_with_geth/RPC/ns-eth.md @@ -5,9 +5,6 @@ sort_key: C Geth provides several extensions to the standard "eth" JSON-RPC namespace. -* TOC -{:toc} - ### eth_subscribe, eth_unsubscribe These methods are used for real-time events through subscriptions. See the [subscription @@ -188,8 +185,8 @@ curl --data '{"method":"eth_createAccessList","params":[{"from": "0x8cd02c6cbd83 The method `eth_createAccessList` returns list of addresses and storage keys used by the transaction, plus the gas consumed when the access list is added. -That is, it gives you the list of addresses and storage keys that will be used by that transaction, plus the gas consumed if the access list is included. Like `eth_estimateGas`, this is an estimation; the list could change when the transaction is actually mined. -Adding an `accessList` to your transaction does not necessary result in lower gas usage compared to a transaction without an access list. +That is, it gives the list of addresses and storage keys that will be used by that transaction, plus the gas consumed if the access list is included. Like `eth_estimateGas`, this is an estimation; the list could change when the transaction is actually mined. +Adding an `accessList` to a transaction does not necessary result in lower gas usage compared to a transaction without an access list. Example: ```json diff --git a/content/docs/interacting_with_geth/RPC/ns-les.md b/content/docs/interacting_with_geth/RPC/ns-les.md index 457efc2175..cbc965b832 100644 --- a/content/docs/interacting_with_geth/RPC/ns-les.md +++ b/content/docs/interacting_with_geth/RPC/ns-les.md @@ -3,7 +3,7 @@ title: les Namespace sort_key: C --- -The `les` API allows you to manage LES server settings, including client parameters and payment settings for prioritized clients. It also provides functions to query checkpoint information in both server and client mode. +The `les` API is for managing LES server settings, including client parameters and payment settings for prioritized clients. It also provides functions to query checkpoint information in both server and client mode. * TOC {:toc} diff --git a/content/docs/interacting_with_geth/RPC/ns-miner.md b/content/docs/interacting_with_geth/RPC/ns-miner.md index 303f177b9d..8eea5e8c87 100644 --- a/content/docs/interacting_with_geth/RPC/ns-miner.md +++ b/content/docs/interacting_with_geth/RPC/ns-miner.md @@ -3,15 +3,11 @@ title: miner Namespace sort_key: C --- -The `miner` API allows you to remote control the node's mining operation and set various -mining specific settings. - -* TOC -{:toc} +The `miner` API is **now deprecated** because mining was switched off at the transition to proof-of-stake. It existed to provide remote control the node's mining operation and set various mining specific settings. It is provided here for historical interest! ### miner_getHashrate -Get your hashrate in H/s (Hash operations per second). +Get hashrate in H/s (Hash operations per second). | Client | Method invocation | |:--------|-------------------------------------------------------------| @@ -82,7 +78,7 @@ Sets the etherbase, where mining rewards will go. ### miner_setGasLimit -Sets the gas limit the miner will target when mining. Note: on networks where EIP-1559 is activated, this should be set to twice what you want the gas target (i.e. the effective gas used on average per block) to be. +Sets the gas limit the miner will target when mining. Note: on networks where EIP-1559 is activated, this should be set to twice the gas target (i.e. the effective gas used on average per block) to be. | Client | Method invocation | |:--------|-------------------------------------------------------------| diff --git a/content/docs/interacting_with_geth/RPC/ns-net.md b/content/docs/interacting_with_geth/RPC/ns-net.md index 1a92cabb9d..ad4ee571a3 100644 --- a/content/docs/interacting_with_geth/RPC/ns-net.md +++ b/content/docs/interacting_with_geth/RPC/ns-net.md @@ -5,8 +5,6 @@ sort_key: C The `net` API provides insight about the networking aspect of the client. -* TOC -{:toc} ### net_listening diff --git a/content/docs/interacting_with_geth/RPC/ns-personal.md b/content/docs/interacting_with_geth/RPC/ns-personal.md index 436471b773..6a2d7903fc 100644 --- a/content/docs/interacting_with_geth/RPC/ns-personal.md +++ b/content/docs/interacting_with_geth/RPC/ns-personal.md @@ -5,9 +5,6 @@ sort_key: C The personal API manages private keys in the key store. -* TOC -{:toc} - ### personal_deriveAccount Requests a HD wallet to derive a new account, optionally pinning it for later reuse. @@ -165,7 +162,7 @@ Supplying the passphrase and unlock duration as arguments: true ``` -If you want to type in the passphrase and stil override the default unlock duration, +To type in the passphrase and still override the default unlock duration, pass `null` as the passphrase. ``` @@ -177,7 +174,7 @@ true ### personal_unpair -Deletes a pairing between wallet and geth. +Deletes a pairing between wallet and Geth. | Client | Method invocation | | :--------| ----------------------------------------------------------- | diff --git a/content/docs/interacting_with_geth/RPC/ns-txpool.md b/content/docs/interacting_with_geth/RPC/ns-txpool.md index fc935c77a6..1790ec9dcc 100644 --- a/content/docs/interacting_with_geth/RPC/ns-txpool.md +++ b/content/docs/interacting_with_geth/RPC/ns-txpool.md @@ -3,13 +3,10 @@ title: txpool Namespace sort_key: C --- -The `txpool` API gives you access to several non-standard RPC methods to inspect the contents of the +The `txpool` API gives access to several non-standard RPC methods to inspect the contents of the transaction pool containing all the currently pending transactions as well as the ones queued for future processing. -* TOC -{:toc} - ### txpool_content The `content` inspection property can be queried to list the exact details of all the transactions diff --git a/content/docs/interacting_with_geth/RPC/objects.md b/content/docs/interacting_with_geth/RPC/objects.md index 6331680e39..703270687e 100644 --- a/content/docs/interacting_with_geth/RPC/objects.md +++ b/content/docs/interacting_with_geth/RPC/objects.md @@ -19,7 +19,7 @@ The *transaction call object* contains all the necessary parameters for executin | `maxPriorityFeePerGas` | `Quantity` | <32 | Yes | Maximum tip per gas that's given directly to the miner. Relevant for type-2 transactions. | | `value` | `Quantity` | <32 | Yes | Amount of `wei` to simulate sending along with the transaction. Defaults to `0`. | | `nonce` | `Quantity` | <8 | Yes | Nonce of sender account. | -| `input` | `Binary` | any | Yes | Binary data to send to the target contract. Generally the 4 byte hash of the method signature followed by the ABI encoded parameters. For details please see the [Ethereum Contract ABI](https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABI). This field was previously called `data`. | +| `input` | `Binary` | any | Yes | Binary data to send to the target contract. Generally the 4 byte hash of the method signature followed by the ABI encoded parameters. For details please see the [Ethereum Contract ABI](https://docs.soliditylang.org/en/v0.7.0/abi-spec.html). This field was previously called `data`. | | `accessList` | `AccessList` | any | Yes | A list of addresses and storage keys that the transaction plans to access. Used in non-legacy, i.e. type 1 and 2 transactions. | | `chainId` | `Quantity` | <32 | Yes | Transaction only valid on networks with this chain ID. Used in non-legacy, i.e. type 1 and 2 transactions. |