diff --git a/_i18n/fr/resources/developer-guides/daemon-rpc.md b/_i18n/fr/resources/developer-guides/daemon-rpc.md index cd616c8b..0cf8010d 100644 --- a/_i18n/fr/resources/developer-guides/daemon-rpc.md +++ b/_i18n/fr/resources/developer-guides/daemon-rpc.md @@ -1,16 +1,16 @@ {% assign version = '2.3.0' | split: '.' %} -{% include disclaimer.html translated="false" version=page.version %} +{% include disclaimer.html translated="true" version=page.version %} ## Introduction -This is a list of the monerod daemon RPC calls, their inputs and outputs, and examples of each. +Voici une liste des appels de procédures distantes (RPC) du démon, leurs entrées et sorties, et des exemples pour chacun d'eux. -Many RPC calls use the daemon's JSON RPC interface while others use their own interfaces, as demonstrated below. +De nombreux appels RPC utilisent l'interface JSON RPC du démon, alors que d'autres utilisent leurs propres interfaces, comme démontré plus bas. -Note: "@atomic-units" refer to the smallest fraction of 1 XMR according to the monerod implementation. **1 XMR = 1e12 @atomic-units.** +Remarque : "@unité-atomique" réfère à la plus petite fraction de 1 XMR selon l'implémentation monerod. **1 XMR = 1e12 unités atomiques** -Note2: Guide updated as of network height of 1,562,465. +Remarque 2 : Guide mis à jour à la hauteur du réseau 1562465. -### [JSON RPC Methods](#json-rpc-methods): +### [Méthodes JSON RPC](#methodes-json-rpc) : * [get_block_count](#get_block_count) * [on_get_block_hash](#on_get_block_hash) @@ -37,7 +37,7 @@ Note2: Guide updated as of network height of 1,562,465. * [get_txpool_backlog](#get_txpool_backlog) * [get_output_distribution](#get_output_distribution) -### [Other RPC Methods](#other-daemon-rpc-calls): +### [Autres Méthodes RPC](#autres-appels-rpc-du-demon) : * [/get_height](#get_height) * [/get_blocks.bin](#get_blocksbin) @@ -74,9 +74,9 @@ Note2: Guide updated as of network height of 1,562,465. --- -## JSON RPC Methods +## Méthodes JSON RPC -The majority of monerod RPC calls use the daemon's `json_rpc` interface to request various bits of information. These methods all follow a similar structure, for example: +La majorité des appels RPC de monerod utilisent l'interface `json_rpc` du démon pour demander des bribes d'information. Ces méthodes suivent toutes une structure similaire, par exemple : ``` IP=127.0.0.1 @@ -90,22 +90,22 @@ curl \ -H 'Content-Type: application/json' ``` -Some methods include parameters, while others do not. Examples of each JSON RPC method follow. +Certaines méthodes comportent des paramètres, alors que d'autres non. Chaque méthode JSON RPC est suivit d'exemple(s). ### **get_block_count** -Look up how many blocks are in the longest chain known to the node. +Cherche combien de blocs sont contenus dans la plus longue chaîne connue du nœud. -Alias: *getblockcount*. +Alias : *getblockcount*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *count* - unsigned int; Number of blocks in longest chain seen by the node. -* *status* - string; General RPC error code. "OK" means everything looks good. +* *count* - entier non signé; Nombre de blocs dans la plus longue chaîne vue par le nœud. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block_count"}' -H 'Content-Type: application/json' @@ -123,19 +123,19 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **on_get_block_hash** -Look up a block's hash by its height. +Cherche le hachage d'un bloc par sa hauteur de bloc. -Alias: *on_getblockhash*. +Alias : *on_getblockhash*. -Inputs: +Entrées : -* block height (int array of length 1) +* *block height* - tableau d'entiers de longueur 1; Hauteur(s) de bloc à rechercher. -Outputs: +Sorties : -* block hash (string) +* *block hash* - chaîne de caractères; Hachage du bloc correspondant. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"on_get_block_hash","params":[912345]}' -H 'Content-Type: application/json' @@ -150,28 +150,28 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_block_template** -Get a block template on which mining a new block. +Obtenir un modèle de bloc à partir duquel miner un nouveau bloc. -Alias: *getblocktemplate*. +Alias : *getblocktemplate*. -Inputs: +Entrées : -* *wallet_address* - string; Address of wallet to receive coinbase transactions if block is successfully mined. -* *reserve_size* - unsigned int; Reserve size. +* *wallet_address* - chaîne de caractères; Adresse du portefeuille à laquelle recevoir la transaction de la base de la pièce si le bloc est miné avec succès. +* *reserve_size* - entier non signé; Taille de réserve. -Outputs: +Sorties : -* *blocktemplate_blob* - string; Blob on which to try to mine a new block. -* *blockhashing_blob* - string; Blob on which to try to find a valid nonce. -* *difficulty* - unsigned int; Difficulty of next block. -* *expected_reward* - unsigned int; Coinbase reward expected to be received if block is successfully mined. -* *height* - unsigned int; Height on which to mine. -* *prev_hash* - string; Hash of the most recent block on which to mine the next block. -* *reserved_offset* - unsigned int; Reserved offset. -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *blocktemplate_blob* - chaîne de caractères; Forme sur laquelle essayer de miner un nouveau bloc. +* *blockhashing_blob* - chaîne de caractères; Forme sur laquelle essayer de trouver un nonce valide. +* *difficulty* - entier non signé; Difficulté du bloc suivant. +* *expected_reward* - entier non signé; Récompense de la base de la pièce à espérer si le bloc est miné avec succès. +* *height* - entier non signé; Hauteur à laquelle miner. +* *prev_hash* - chaîne de caractères; Hachage du bloc le plus récent sur lequel miner le bloc suivant. +* *reserved_offset* - entier non signé; Déport réservé. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block_template","params":{"wallet_address":"44GBHzv6ZyQdJkjqZje6KLZ3xSyN1hBSFAnLP6EAqJtCRVzMzZmeXTC2AHKDS9aEDTRKmo6a6o9r9j86pYfhCWDkKjbtcns","reserve_size":60}' -H 'Content-Type: application/json' @@ -196,19 +196,19 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **submit_block** -Submit a mined block to the network. +Soumettre un bloc miné au réseau. -Alias: *submitblock*. +Alias : *submitblock*. -Inputs: +Entrées : -* Block blob data - array of strings; list of block blobs which have been mined. See [get_block_template](#get_block_template) to get a blob on which to mine. +* *Block blob data* - liste de chaînes de caractères; Liste des formes de blocs qui ont été minées. Voir [get_block_template](#get_block_template) pour obtenir une forme sur laquelle miner. -Outputs: +Sorties : -* *status* - string; Block submit status. +* *status* - chaîne de caractères; Statut de la soumission du bloc. -In this example, a block blob which has not been mined is submitted: +Dans cet exemple, un bloc qui n'a pas été miné est soumis : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"submit_block","params":["0707e6bdfedc053771512f1bc27c62731ae9e8f2443db64ce742f4e57f5cf8d393de28551e441a0000000002fb830a01ffbf830a018cfe88bee283060274c0aae2ef5730e680308d9c00b6da59187ad0352efe3c71d36eeeb28782f29f2501bd56b952c3ddc3e350c2631d3a5086cac172c56893831228b17de296ff4669de020200000000"]' -H 'Content-Type: application/json' @@ -226,32 +226,32 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_last_block_header** -Block header information for the most recent block is easily retrieved with this method. No inputs are needed. +Les informations d'entête du bloc le plus récent sont facilement récupérées avec cette méthode. Aucune entrée n'est nécessaire. -Alias: *getlastblockheader*. +Alias : *getlastblockheader*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *block_header* - A structure containing block header information. - * *block_size* - unsigned int; The block size in bytes. - * *depth* - unsigned int; The number of blocks succeeding this block on the blockchain. A larger number means an older block. - * *difficulty* - unsigned int; The strength of the Monero network based on mining power. - * *hash* - string; The hash of this block. - * *height* - unsigned int; The number of blocks preceding this block on the blockchain. - * *major_version* - unsigned int; The major version of the monero protocol at this block height. - * *minor_version* - unsigned int; The minor version of the monero protocol at this block height. - * *nonce* - unsigned int; a cryptographic random one-time number used in mining a Monero block. - * *num_txes* - unsigned int; Number of transactions in the block, not counting the coinbase tx. - * *orphan_status* - boolean; Usually `false`. If `true`, this block is not part of the longest chain. - * *prev_hash* - string; The hash of the block immediately preceding this block in the chain. - * *reward* - unsigned int; The amount of new @atomic-units generated in this block and rewarded to the miner. Note: 1 XMR = 1e12 @atomic-units. - * *timestamp* - unsigned int; The unix time at which the block was recorded into the blockchain. -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *block_header* - Une structure contenant les informations d'entête du bloc. + * *block_size* - entier non signé; La taille du bloc en octets. + * *depth* - entier non signé; Le nombre de blocs succédant à ce bloc dans la chaîne de blocs. Un plus grand nombre signifie un bloc plus ancien. + * *difficulty* - entier non signé; La robustesse du réseau Monero basé sur la puissance d'extraction minière. + * *hash* - chaîne de caractères; Le hachage de ce bloc. + * *height* - entier non signé; Le nombre de blocs précédant ce bloc sur la chaîne de blocs. + * *major_version* - entier non signé; La version majeure du protocole Monero à cette hauteur de bloc. + * *minor_version* - entier non signé; La version mineure du protocole Monero à cette hauteur de bloc. + * *nonce* - entier non signé; Un nombre cryptographique aléatoire à usage unique utilisé dans l'extraction minière d'un bloc Monero. + * *num_txes* - entier non signé; Nombre de transactions dans le bloc, sans compter la transaction de la base de la pièce. + * *orphan_status* - booléen; Habituellement `false`. Si `true`, ce bloc ne fait pas partie de la chaîne la plus longue. + * *prev_hash* - chaîne de caractères; Le hachage du bloc précédent immédiatement ce bloc dans la chaîne de blocs. + * *reward* - entier non signé; Le montant de nouvelles @unités-atomiques généré dans ce bloc et fournies en récompense au mineur. Remarque : 1 XMR = 1e12 @unités-atomiques. + * *timestamp* - entier non signé; Le temps Unix auquel ce bloc à été enregistré dans la chaîne de blocs. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -In this example, the most recent block (1562023 at the time) is returned: +Dans cette exmemple, le bloc le plus récent (1562023 à ce moment-là) est retourné : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_last_block_header"}' -H 'Content-Type: application/json' @@ -284,21 +284,21 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_block_header_by_hash** -Block header information can be retrieved using either a block's hash or height. This method includes a block's hash as an input parameter to retrieve basic information about the block. +Les informations d'entête de bloc peuvent être récupérées en utilisant soit un hachage, soit une hauteur de bloc. Cette méthode inclue un hachage de bloc comme paramètre d'entrée pour récupérer les informations basiques du bloc. -Alias: *getblockheaderbyhash*. +Alias : *getblockheaderbyhash*. -Inputs: +Entrées : -* *hash* - string; The block's sha256 hash. +* *hash* - chaîne de caractères; Le hachage sha256 du bloc. -Outputs: +Sorties : -* *block_header* - A structure containing block header information. See [get_last_block_header](#get_last_block_header). -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *block_header* - Une structure contenant les informations d'entête du bloc. Voir [get_last_block_header](#get_last_block_header). +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -In this example, block 912345 is looked up by its hash: +Dans cet exemple, le bloc 912345 est recherché par son hachage : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block_header_by_hash","params":{"hash":"e22cf75f39ae720e8b71b3d120a5ac03f0db50bba6379e2850975b4859190bc6"}}' -H 'Content-Type: application/json' @@ -331,21 +331,21 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_block_header_by_height** -Similar to [get_block_header_by_hash](#get_block_header_by_hash) above, this method includes a block's height as an input parameter to retrieve basic information about the block. +Similaire à [get_block_header_by_hash](#get_block_header_by_hash) ci-dessus, cette méthode prend la hauteur de bloc comme paramètre d'entrée pour récupérer les informations basiques du bloc. -Alias: *getblockheaderbyheight*. +Alias : *getblockheaderbyheight*. -Inputs: +Entrées : -* *height* - unsigned int; The block's height. +* *height* - entier non signé; La hauteur du bloc. -Outputs: +Sorties : -* *block_header* - A structure containing block header information. See [get_last_block_header](#get_last_block_header). -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *block_header* - Une structure contenant les informations d'entête du bloc. Voir [get_last_block_header](#get_last_block_header). +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -In this example, block 912345 is looked up by its height (notice that the returned information is the same as in the previous example): +Dans cet exemple, le bloc 912345 est recherché par sa hauteur (remarquez que les informations renvoyées sont les mêmes que dans l'exemple précédent) : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block_header_by_height","params":{"height":912345}}' -H 'Content-Type: application/json' @@ -377,22 +377,22 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_block_headers_range** -Similar to [get_block_header_by_height](#get_block_header_by_height) above, but for a range of blocks. This method includes a starting block height and an ending block height as parameters to retrieve basic information about the range of blocks. +Similaire à [get_block_header_by_height](#get_block_header_by_height) ci-dessus, mais pour une plage de blocs. Cette méthode nécessite une hauteur de bloc de départ et une hauteur de bloc de fin comme paramètres pour récupérer les informations basiques de la plage de blocs. -Alias: *getblockheadersrange*. +Alias : *getblockheadersrange*. -Inputs: +Entrées : -* *start_height* - unsigned int; The starting block's height. -* *end_height* - unsigned int; The ending block's height. +* *start_height* - entier non signé; La hauteur de bloc de départ. +* *end_height* - entier non signé; La hauteur de bloc de fin. -Outputs: +Sorties : -* *headers* - array of `block_header` (a structure containing block header information. See [get_last_block_header](#get_last_block_header)). -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *headers* - liste de `block_header` (Une structure contenant les informations d'entête du bloc. Voir [get_last_block_header](#get_last_block_header)). +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -In this example, blocks range from height 1545999 to 1546000 is looked up (notice that the returned informations are ascending order and that it is at the April 2018 network upgrade time): +Dans cet exemple, la plage de bloc de la hauteur 1545999 à la hauteur 1546000 est recherchée (remarquez que les informations renvoyées sont dans l'ordre ascendant et qu'il s'agit du moment de la mise à jour réseau d'Avril 2018) : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block_headers_range","params":{"start_height":1545999,"end_height":1546000}}' -H 'Content-Type: application/json' @@ -439,44 +439,44 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_block** -Full block information can be retrieved by either block height or hash, like with the above block header calls. For full block information, both lookups use the same method, but with different input parameters. +Les informations complètes d'un bloc peuvent être récupérées soit par sa hauteur, soit par son hachage, comme pour les appels précédents. Pour les informations complètes du bloc, les deux recherches utilisent la même méthode, mais avec des paramètres d'entrées différents. -Alias: *getblock*. +Alias : *getblock*. -Inputs (pick one of the following): +Entrées (choisir l'un des suivant) : -* *height* - unsigned int; The block's height. -* *hash* - string; The block's hash. +* *height* - entier non signé; La hauteur du bloc. +* *hash* - chaîne de caractères; Le hachage du bloc. -Outputs: +Sorties : -* *blob* - string; Hexadecimal blob of block information. -* *block_header* - A structure containing block header information. See [get_last_block_header](#get_last_block_header). -* *json* - json string; JSON formatted block details: - * *major_version* - Same as in block header. - * *minor_version* - Same as in block header. - * *timestamp* - Same as in block header. - * *prev_id* - Same as `prev_hash` in block header. - * *nonce* - Same as in block header. - * *miner_tx* - Miner transaction information - * *version* - Transaction version number. - * *unlock_time* - The block height when the coinbase transaction becomes spendable. - * *vin* - List of transaction inputs: - * *gen* - Miner txs are coinbase txs, or "gen". - * *height* - This block height, a.k.a. when the coinbase is generated. - * *vout* - List of transaction outputs. Each output contains: - * *amount* - The amount of the output, in @atomic-units. +* *blob* - chaîne de caractères; Forme au format hexadécimal des informations du bloc. +* *block_header* - Une structure contenant les informations d'entête du bloc. Voir [get_last_block_header](#get_last_block_header). +* *json* - chaîne de caractères json; détail du bloc au format JSON : + * *major_version* - Comme dans l'entête du bloc. + * *minor_version* - Comme dans l'entête du bloc. + * *timestamp* - Comme dans l'entête du bloc. + * *prev_id* - Comme `prev_hash` dans l'entête du bloc. + * *nonce* - Comme dans l'entête du bloc. + * *miner_tx* - Information de la transaction du mineur. + * *version* - Numéro de version de la transaction. + * *unlock_time* - La hauteur de bloc à laquelle la transaction de la base de la pièce peut être dépensée. + * *vin* - Liste des entrées de la transaction : + * *gen* - Les transactions du mineur sont des transactions de la base de la pièce, ou "gen". + * *height* - Cette hauteur de bloc, c.a.d lorsque la transaction de la base de la pièce est générée. + * *vout* - Liste des sorties de la transaction. Chaque sortie contient : + * *amount* - Le montant de la sortie, en @unités-atomiques. * *target* - * *key* - - * *extra* - Usually called the "transaction ID" but can be used to include any random 32 byte/64 character hex string. - * *signatures* - Contain signatures of tx signers. Coinbased txs do not have signatures. - * *tx_hashes* - List of hashes of non-coinbase transactions in the block. If there are no other transactions, this will be an empty list. -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). + * *extra* - Habituellement appelé "ID de transaction" mais peut inclure n'importe quelle chaîne de 32 octets ou 64 caractères hexadécimaux. + * *signatures* - Contient les signatures des signataires de la transaction. Les transactions de la base de la pièce n'ont pas de signatures. + * *tx_hashes* - Liste des hachages des transactions autres que la transaction de la base de la pièce. S'il n'y a pas d'autre transaction, cette liste sera vide. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -**Look up by height:** +**Recherche par hauteur :** -In the following example, block 912345 is looked up by its height. Note that block 912345 does not have any non-coinbase transactions. (See the next example for a block with extra transactions): +Dans l'exemple ci-desous, le bloc 912345 est recherché par sa hauteur. Remarquez que le bloc 912345 n'a pas de transactions autre que la transaction de la base de la pièce. (voir l'exemple suivant pour un bloc avec d'autres transactions): ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block","params":{"height":912345}}' -H 'Content-Type: application/json' @@ -509,9 +509,9 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me } ``` -**Look up by hash:** +**Recherche par hachage :** -In the following example, block 993056 is looked up by its hash. Note that block 993056 has 3 non-coinbase transactions: +Dans cet exemple, le bloc 993056 est recherché par son hachage. Remarquez que le bloc 993056 a 3 transactions autres que la transaction de la base de la pièce : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_block","params":{"hash":"510ee3c4e14330a7b96e883c323a60ebd1b5556ac1262d0bc03c24a3b785516f"}}' -H 'Content-Type: application/json' @@ -548,38 +548,38 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_connections** -Retrieve information about incoming and outgoing connections to your node. +Récupère les informations des connexions entrantes et sortantes de votre nœud. -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *connections* - List of all connections and their info: - * *address* - string; The peer's address, actually IPv4 & port - * *avg_download* - unsigned int; Average bytes of data downloaded by node. - * *avg_upload* - unsigned int; Average bytes of data uploaded by node. - * *connection_id* - string; The connection ID - * *current_download* - unsigned int; Current bytes downloaded by node. - * *current_upload* - unsigned int; Current bytes uploaded by node. - * *height*- unsigned int; The peer height - * *host* - string; The peer host - * *incoming* - boolean; Is the node getting information from your node? - * *ip* - string; The node's IP address. - * *live_time* - unsigned int - * *local_ip* - boolean - * *localhost* - boolean - * *peer_id* - string; The node's ID on the network. - * *port* - string; The port that the node is using to connect to the network. - * *recv_count* - unsigned int - * *recv_idle_time* - unsigned int - * *send_count* - unsigned int - * *send_idle_time* - unsigned int - * *state* - string - * *support_flags* - unsigned int +* *connections* - Liste de toutes les connexions et leurs infos : + * *address* - chaîne de caractères; L'adresse de l'homologue, actuellement IPv4 & port + * *avg_download* - entier non signé; Moyenne des octets de données téléchargés par le nœud. + * *avg_upload* - entier non signé; Moyenne des octets de données téléversés par le nœud. + * *connection_id* - chaîne de caractères; L'ID de connexion + * *current_download* - entier non signé; Octets actuellement téléchargés par le nœud. + * *current_upload* - entier non signé; Octets actuellement téléversés par le nœud. + * *height*- entier non signé; La hauteur de bloc de l'homologue. + * *host* - chaîne de caractères; L'hôte de l'homologue. + * *incoming* - booléen; Est-ce que l'homologue récupère des informations depuis votre nœud ? + * *ip* - chaîne de caractères; L'adresse IP du nœud. + * *live_time* - entier non signé + * *local_ip* - booléen + * *localhost* - booléen + * *peer_id* - chaîne de caractères; L'ID du nœud sur le réseau. + * *port* - chaîne de caractères; Le port utilisé par le nœud pour se connecter au réseau. + * *recv_count* - entier non signé + * *recv_idle_time* - entier non signé + * *send_count* - entier non signé + * *send_idle_time* - entier non signé + * *state* - chaîne de caractères + * *support_flags* - entier non signé -Following is an example of `get_connections` and it's return: +Ci-dessous un exemple de `get_connections` et son retour : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_connections"}' -H 'Content-Type: application/json' @@ -621,48 +621,48 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_info** -Retrieve general information about the state of your node and the network. +Récupère les informations générales à propos de l'état de votre nœud et du réseau. -Alias: +Alias : * */get_info* * */getinfo* -See other RPC Methods [/get_info (not JSON)](#get_info-not-json) +Voir l'autre appel RPC du démon [/get_info (not JSON)](#get_info-not-json) -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *alt_blocks_count* - unsigned int; Number of alternative blocks to main chain. -* *block_size_limit* - unsigned int; Maximum allowed block size -* *block_size_median* - unsigned int; Median block size of latest 100 blocks -* *bootstrap_daemon_address* - string; @Bootstrap-node to give immediate usability to wallets while syncing by proxying RPC to it. (Note: the replies may be untrustworthy). -* *cumulative_difficulty* - unsigned int; Cumulative difficulty of all blocks in the blockchain. -* *difficulty* - unsigned int; Network difficulty (analogous to the strength of the network) -* *free_space* - unsigned int; Available disk space on the node. -* *grey_peerlist_size* - unsigned int; Grey Peerlist Size -* *height* - unsigned int; Current length of longest chain known to daemon. -* *height_without_bootstrap* - unsigned int; Current length of the local chain of the daemon. -* *incoming_connections_count* - unsigned int; Number of peers connected to and pulling from your node. -* *mainnet* - boolean; States if the node is on the mainnet (`true`) or not (`false`). -* *offline* - boolean; States if the node is offline (`true`) or online (`false`). -* *outgoing_connections_count* - unsigned int; Number of peers that you are connected to and getting information from. -* *rpc_connections_count* - unsigned int; Number of RPC client connected to the daemon (Including this RPC request). -* *stagenet* - boolean; States if the node is on the stagenet (`true`) or not (`false`). -* *start_time* - unsigned int; Start time of the daemon, as UNIX time. -* *status* - string; General RPC error code. "OK" means everything looks good. -* *target* - unsigned int; Current target for next proof of work. -* *target_height* - unsigned int; The height of the next block in the chain. -* *testnet* - boolean; States if the node is on the testnet (`true`) or not (`false`). -* *top_block_hash* - string; Hash of the highest block in the chain. -* *tx_count* - unsigned int; Total number of non-coinbase transaction in the chain. -* *tx_pool_size* - unsigned int; Number of transactions that have been broadcast but not included in a block. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). -* *was_bootstrap_ever_used* - boolean; States if a bootstrap node has ever been used since the daemon started. -* *white_peerlist_size* - unsigned int; White Peerlist Size +* *alt_blocks_count* - entier non signé; Nombre de bloc alternatifs jusqu'à la chaîne principale. +* *block_size_limit* - entier non signé; Taille de bloc maximale autorisée. +* *block_size_median* - entier non signé; Taille de bloc médiane des 100 derniers blocs. +* *bootstrap_daemon_address* - chaîne de caractères; @nœud-d'amorce permettant d'utiliser immédiatement des portefeuilles durant la synchronisation en proxyfiant le RPC vers celui-ci. (Remarque : les réponses pourraient ne pas être digne de confiance). +* *cumulative_difficulty* - entier non signé; Cumule de difficulté de tous les blocs de la chaîne de blocs. +* *difficulty* - entier non signé; Difficulté du réseau (analogue à la robustesse du réseau) +* *free_space* - entier non signé; Espace disque disponible sur le nœud. +* *grey_peerlist_size* - entier non signé; Taille de la liste grise d'homologues. +* *height* - entier non signé; Longueur actuelle de la plus longue chaîne connue du démon. +* *height_without_bootstrap* - entier non signé; Longueur actuelle de la chaîne locale du démon. +* *incoming_connections_count* - entier non signé; Nombre d'homologue connectés et se synchronisant depuis notre nœud. +* *mainnet* - booléen; Indique si le nœud est sur le mainnet (`true`) ou non (`false`). +* *offline* - booléen; Indique si le nœud est hors ligne (`true`) ou en ligne (`false`). +* *outgoing_connections_count* - entier non signé; Nombre d'homologues auxquels vous êtes connectés et auprès desquels cous récupérez des informations. +* *rpc_connections_count* - entier non signé; Nombre de client RPC connectés au démon (cette requête RPC comprise). +* *stagenet* - booléen; Indique si le nœud est sur le stagenet (`true`) ou non (`false`). +* *start_time* - entier non signé; Heure de démarage du démon, au format UNIX. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *target* - entier non signé; Cible actuel pour la prochaine preuve de travail. +* *target_height* - entier non signé; La hauteur du prochain bloc dans la chaîne. +* *testnet* - booléen; Indique si le nœud est sur le testnet (`true`) ou non (`false`). +* *top_block_hash* - chaîne de caractères; Hachage du plus haut bloc dans la chaîne. +* *tx_count* - entier non signé; Nombre total de transactions (hors transactions de la base de la pièce) dans la chaîne. +* *tx_pool_size* - entier non signé; Nombre de transactions qui ont été diffusées mais pas incluses dans un bloc. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). +* *was_bootstrap_ever_used* - booléen; Indique si un nœud d'amorce à jamais été utilisé depuis le démarrage du démon. +* *white_peerlist_size* - entier non signé; Taille de la liste blanche d'homologues. -Following is an example `get_info` call and its return: +Ci-dessous un exemple d'appel `get_info` et de son retour : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_info"}' -H 'Content-Type: application/json' @@ -705,25 +705,25 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **hard_fork_info** -Look up information regarding hard fork voting and readiness. +Recherche des informations concernant le vote et la disponibilité d'une mise à jour réseau. -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *earliest_height* - unsigned int; Block height at which hard fork would be enabled if voted in. -* *enabled* - boolean; Tells if hard fork is enforced. -* *state* - unsigned int; Current hard fork state: 0 (There is likely a hard fork), 1 (An update is needed to fork properly), or 2 (Everything looks good). -* *status* - string; General RPC error code. "OK" means everything looks good. -* *threshold* - unsigned int; Minimum percent of votes to trigger hard fork. Default is 80. -* *version* - unsigned int; The major block version for the fork. -* *votes* - unsigned int; Number of votes towards hard fork. -* *voting* - unsigned int; Hard fork voting status. -* *window* - unsigned int; Number of blocks over which current votes are cast. Default is 10080 blocks. +* *earliest_height* - entier non signé; Hauteur de bloc à laquelle la mise à jour réseau sera activée si elle est votée. +* *enabled* - booléen; Indique si la mise à jour réseau est appliquée. +* *state* - entier non signé; Statut actuel de mise à jour réseau : 0 (il semble y avoir une mise à jour du réseau), 1 (une mise à jour logicielle est nécessaire pour suivre la mise à jour du réseau) ou 2 (tout va bien). +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *threshold* - entier non signé; Pourcentage de vote minimum nécessaire pour déclencher la mise à jour du réseau. 80 par défaut. +* *version* - entier non signé; La verion de bloc majeure pour cette mise mise à jour réseau. +* *votes* - entier non signé; Nombre de votes en faveur de la mise à jour réseau. +* *voting* - entier non signé; Statut du vote de la mise à jour réseau +* *window* - entier non signé; Nombre de blocs sur lesquels les votes actuels sont diffusés. 10080 blocs par défaut. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"hard_fork_info"}' -H 'Content-Type: application/json' @@ -748,27 +748,27 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **set_bans** -Ban another node by IP. +Bannir un autre nœud par son IP. -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *bans* - A list of nodes to ban: - * *host* - string; Host to ban (IP in A.B.C.D form - will support I2P address in the future). - * *ip* - unsigned int; IP address to ban, in Int format. - * *ban* - boolean; Set `true` to ban. - * *seconds* - unsigned int; Number of seconds to ban node. +* *bans* - Une liste de nœuds à bannir : + * *host* - chaîne de caractères; Hôte à bannir (IP au format A.B.C.D - supportera des adresses I2P à l'avenir). + * *ip* - entier non signé; Adresse IP à bannir, sous forme d'entier. + * *ban* - booléen; Spécifier `true` pour bannir. + * *seconds* - entier non signé; Nombre de secondes pendant lesquelles bannir le nœud. -Outputs: +Sorties : -* *status* - string; General RPC error code. "OK" means everything looks good. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. Examples: -**banning by host** +**bannir par hôte** -In the following example, host is banned with its IP address string-formatted as A.B.C.D: +Dans l'exemple ci-dessous, un hôte est banni avec son adresse IP sous la forme d'une chaîne de caractères A.B.C.D : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"set_bans","params":{"bans":[{"host":"192.168.1.51","ban":true,"seconds":30}]}}' -H 'Content-Type: application/json' @@ -782,9 +782,9 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me } ``` -**banning by ip** +**bannir par ip** -In the following example, integer-formatted IP is banned: +Dans l'exemple ci-dessous, une adresse IP au format entier est bannie : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"set_bans","params":{"bans":[{"ip":838969536,"ban":true,"seconds":30}]}}' -H 'Content-Type: application/json' @@ -801,21 +801,21 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_bans** -Get list of banned IPs. +Obtenir la liste des IPs bannies. -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *bans* - List of banned nodes: - * *host* - string; Banned host (IP in A.B.C.D form). - * *ip* - unsigned int; Banned IP address, in Int format. - * *seconds* - unsigned int; Local Unix time that IP is banned until. -* *status* - string; General RPC error code. "OK" means everything looks good. +* *bans* - Liste des nœuds bannis : + * *host* - chaîne de caractères; Hôte banni (IP au format A.B.C.D). + * *ip* - entier non signé; Adresse IP bannie, au format entier. + * *seconds* - entier non signé; Temps Unix local jusqu'auquel cette IP est bannie. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_bans"}' -H 'Content-Type: application/json' @@ -841,19 +841,19 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **flush_txpool** -Flush tx ids from transaction pool +Vide le pool de transactions de certains ids de tx. -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *txids* - array of strings; Optional, list of transactions IDs to flush from pool (all tx ids flushed if empty). +* *txids* - liste de chaînes de caractères; Optionnel, liste d'IDs de transactions à vider du pool (tous les ids de tx sont vidés si vide). -Outputs: +Sorties : -* *status* - string; General RPC error code. "OK" means everything looks good. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"flush_txpool","params":{"txids":["dc16fa8eaffe1484ca9014ea050e13131d3acf23b419f33bb4cc0b32b6c49308",""]}}' -H 'Content-Type: application/json' @@ -869,28 +869,28 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_output_histogram** -Get a histogram of output amounts. For all amounts (possibly filtered by parameters), gives the number of outputs on the chain for that amount. -RingCT outputs counts as 0 amount. +Obtenir un histogramme des montant des sorties. Pour tous les montants (pouvant être filtrés par les paramètres), fournit le nombre de sorties sur la chaîne pour chaque montant. +Les sorties des transactions confidentielles de cercle comptent comme un montant de 0. -Inputs: +Entrées : -* *amounts* - list of unsigned int -* *min_count* - unsigned int -* *max_count* - unsigned int -* *unlocked* - boolean -* *recent_cutoff* - unsigned int +* *amounts* - liste d'entiers non signés +* *min_count* - entier non signé +* *max_count* - entier non signé +* *unlocked* - booléen +* *recent_cutoff* - entier non signé -Outputs: +Sorties : -* *histogram* - list of histogram entries, in the following structure: - * *amount* - unsigned int; Output amount in @atomic-units - * *total_instances* - unsigned int; - * *unlocked_instances* - unsigned int; - * *recent_instances* - unsigned int; -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *histogram* - liste d'entrées de l'histogramme, avec la structure suivante : + * *amount* - entier non signé; Montant des sorties en @unités-atomiques + * *total_instances* - entier non signé; + * *unlocked_instances* - entier non signé; + * *recent_instances* - entier non signé; +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_output_histogram","params":{"amounts":[20000000000]}}' -H 'Content-Type: application/json' @@ -914,22 +914,22 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_coinbase_tx_sum** -Get the coinbase ammount and the fees ammount for n last blocks starting at particular height +Obtenir la somme des montants des transactions de la base de la pièce et des frais des n derniers blocs en débutant à une certaine hauteur. -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *height* - unsigned int; Block height from which getting the amounts -* *count* - unsigned int; number of blocks to include in the sum +* *height* - entier non signé; Hauteur de bloc à partir de laquelle récupérer les montants. +* *count* - entier non signé; Nombre de bloc à inclure dans la somme. -Outputs: +Sorties : -* *emission_amount* - unsigned int; amount of coinbase reward in @atomic-units -* *fee_amount* - unsigned int; amount of fees in @atomic-units -* *status* - string; General RPC error code. "OK" means everything looks good. +* *emission_amount* - entier non signé; Montant des récompenses de la base de la pièce en @unités-atomiques +* *fee_amount* - entier non signé; Montant des frais en @unités-atomiques +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_coinbase_tx_sum","params":{"height":1563078,"count":2}}' -H 'Content-Type: application/json' @@ -948,19 +948,19 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_version** -Give the node current version +Indique la version actuelle du nœud -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). -* *version* - unsigned int; +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). +* *version* - entier non signé; -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_version"}' -H 'Content-Type: application/json' @@ -979,21 +979,21 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_fee_estimate** -Gives an estimation on fees per kB. +Donne une estimation des frais par kO. -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *grace_blocks* - unsigned int; Optional +* *grace_blocks* - entier non signé; Optionnel -Outputs: +Sorties : -* *fee* - unsigned int; Amount of fees estimated per kB in @atomic-units -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *fee* - entier non signé; Montant estimé des frais par kO en @unités-atomiques +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_fee_estimate"}' -H 'Content-Type: application/json' @@ -1012,22 +1012,22 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_alternate_chains** -Display alternative chains seen by the node. +Affiche les chaînes alternatives vues par le nœud -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *chains* - array of chains, the following structure: - * *block_hash* - string; the block hash of the first diverging block of this alternative chain. - * *difficulty* - unsigned int; the cumulative difficulty of all blocks in the alternative chain. - * *height* - unsigned int; the block height of the first diverging block of this alternative chain. - * *length* - unsigned int; the length in blocks of this alternative chain, after divergence. -* *status* - string; General RPC error code. "OK" means everything looks good. +* *chains* - liste de chains, La structure suivante : + * *block_hash* - chaîne de caractères; Le hachage de bloc du premier bloc divergeant de cette chaîne alternative. + * *difficulty* - entier non signé; La difficulté cumulée de tous les blocs de cette chaîne alternative. + * *height* - entier non signé; La hauteur de bloc du premier bloc divergeant de cette chaîne alternative. + * *length* - entier non signé; La longueur en blocs de cette chaîne alternative, après divergence. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_alternate_chains"}' -H 'Content-Type: application/json' @@ -1050,19 +1050,19 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **relay_tx** -Relay a list of transaction IDs. +Relaye une liste d'IDs de transactions. -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *txids* - array of string; list of transaction IDs to relay +* *txids* - Liste de chaîne de caractères; Liste d'IDs de transactions à relayer. -Outputs: +Sorties : -* *status* - string; General RPC error code. "OK" means everything looks good. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"relay_tx","params":{"txids":[9fd75c429cbe52da9a52f2ffc5fbd107fe7fd2099c0d8de274dc8a67e0c98613]}}' -H 'Content-Type: application/json' @@ -1079,29 +1079,29 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **sync_info** -Get synchronisation informations +Obtenir les informations de synchronisation. -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *height* - unsigned int; -* *peers* - array of peer structure, defined as follows: - * *info* - structure of connection info, as defined in [get_connections](#get_connections) -* *spans* - array of span structure, defined as follows (optional, absent if node is fully synced): - * *connection_id* - string; Id of connection - * *nblocks* - unsigned int; number of blocks in that span - * *rate* - unsigned int; connection rate - * *remote_address* - string; peer address the node is downloading (or has downloaded) than span from - * *size* - unsigned int; total number of bytes in that span's blocks (including txes) - * *speed* - unsigned int; connection speed - * *start_block_height* - unsigned int; block height of the first block in that span -* *status* - string; General RPC error code. "OK" means everything looks good. -* *target_height* - unsigned int; target height the node is syncing from (optional, absent if node is fully synced) +* *height* - entier non signé; +* *peers* - liste de structures d'homologues, définies comme suit : + * *info* - structure d'information de connexion, comme définit dans [get_connections](#get_connections) +* *spans* - liste de structure de plages, définies comme suit (optionnelle, absente si le nœud est totalement synchronisé) : + * *connection_id* - chaîne de caractères; ID de connexion. + * *nblocks* - entier non signé; Nombre de blocs dans cette plage. + * *rate* - entier non signé; Débit de connexion. + * *remote_address* - chaîne de caractères; Adresse de l'homologue à partir duquel le nœud télécharge (ou a téléchargé) cette plage. + * *size* - entier non signé; Nombre total d'octets dans les blocs de cette plage (comprenant les transactions). + * *speed* - entier non signé; Vitesse de la connexion. + * *start_block_height* - entier non signé; Hauteur de bloc du premier bloc de cette plage. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *target_height* - entier non signé; Hauteur de bloc cible vers laquelle le nœud se synchronise (optionnel, absent si le nœud est totalement synchronisé). -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"sync_info"}' -H 'Content-Type: application/json' @@ -1155,22 +1155,22 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me ### **get_txpool_backlog** -Get all transaction pool backlog +Obtenir toutes les transactions en retard du pool. -Alias: *None*. +Alias : *Aucun*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *backlog*: array of structures *tx_backlog_entry* (in binary form): - * *blob_size* - unsigned int (in binary form) - * *fee* - unsigned int (in binary form) - * *time_in_pool* - unsigned int (in binary form) -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *backlog*: liste de structures *tx_backlog_entry* (au format binaire) : + * *blob_size* - entier non signé (au format binaire) + * *fee* - entier non signé (au format binaire) + * *time_in_pool* - entier non signé (au format binaire) +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_txpool_backlog"}' -H 'Content-Type: application/json' @@ -1191,25 +1191,25 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me -Alias: *None*. +Alias : *Aucun*. -Inputs: +Entrées : -* *amounts* - array of unsigned int; amounts to look for -* *cumulative* - boolean; (optional, default is `false`) States if the result should be cumulative (`true`) or not (`false`) -* *from_height* - unsigned int; (optional, default is 0) starting height to check from -* *to_height* - unsigned int; (optional, default is 0) ending height to check up to +* *amounts* - liste d'entier non signé; Montants à rechercher. +* *cumulative* - booléen; (optionnel, `false` par défaut) Indique si le résultat doit être cumulatif (`true`) ou non (`false`). +* *from_height* - entier non signé; (optionnel, 0 par défaut) Hauteur de bloc de départ à partir de laquelle vérifier. +* *to_height* - entier non signé; (optionnel, 0 par défaut) Hauteur de bloc de fin jusqu'à laquelle vérifier. -Outputs: +Sorties : -* *distributions* - array of structure distribution as follows: - * *amount* - unsigned int - * *base* - unsigned int - * *distribution* - array of unsigned int - * *start_height* - unsigned int -* *status* - string; General RPC error code. "OK" means everything looks good. +* *distributions* - liste de structure distribution comme suit : + * *amount* - entier non signé + * *base* - entier non signé + * *distribution* - liste d'entier non signé + * *start_height* - entier non signé +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. -Example: +Exemple : ``` $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","method":"get_output_distribution","params":{"amounts":[628780000],"from_height":1462078}}' -H 'Content-Type: application/json' @@ -1232,11 +1232,11 @@ $ curl -X POST http://127.0.0.1:18081/json_rpc -d '{"jsonrpc":"2.0","id":"0","me --- -## Other Daemon RPC Calls +## Autres appels RPC du Démon -Not all daemon RPC calls use the JSON_RPC interface. This section gives examples of these calls. +Tous les appels RPC du démon n'utilisent pas l'interface JSON. Cette rubrique donne des exemples de ces appels. -The data structure for these calls is different than the JSON RPC calls. Whereas the JSON RPC methods were called using the `/json_rpc` extension and specifying a method, these methods are called at their own extensions. For example: +La structure de données pour ces appels diffère de celle des appels JSON RPC. Alors que les méthodes JSON RPC sont appellées en utilisant l'extension `/json_rpc` et en spécifiant une méthode, ces méthodes sont appelées avec leurs propres extensions. Par exemple : IP=127.0.0.1 PORT=18081 @@ -1247,24 +1247,24 @@ The data structure for these calls is different than the JSON RPC calls. Whereas -d $PARAMS \ -H 'Content-Type: application/json' -Note: It is recommended to use JSON RPC where such alternatives exist, rather than the following methods. For example, the recommended way to get a node's height is via the JSON RPC methods [get_info](#getinfo) or [get_last_block_header](#get_last_block_header), rather than [getheight](#getheight) below. +Remarque : Il est recommandé d'utiliser JSON RPC lorsque l'alternative existe, plutôt que les méthodes suivantes. Par exemple, la méthode recommandée pour obtenir la hauteur d'un nœud est via la méthode JSON RPC [get_info](#getinfo) ou [get_last_block_header](#get_last_block_header), plutôt que [getheight](#getheight) ci-dessous. -For calls that end with **.bin**, the data is exchanged in the form of binary, serialized objects, as defined in the [Core RPC Server](https://github.com/monero-project/monero/blob/master/src/rpc/core_rpc_server_commands_defs.h). +Pour les appels qui se terminent par **.bin**, les données sont échangées sous forme d'objets sérialisés binaire, comme définit dans le [Core RPC Server](https://github.com/monero-project/monero/blob/master/src/rpc/core_rpc_server_commands_defs.h). ### **/get_height** -Get the node's current height. +Obtenir la hauteur actuelle du nœud. -Alias: */getheight*. +Alias : */getheight*. -Inputs: *None*. +Entrées : *Aucune*. -Outputs: +Sorties : -* *height* - unsigned int; Current length of longest chain known to daemon. -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *height* - entier non signé; Longueur actuelle de la plus longue chaîne connue du démon. +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`). ``` $ curl -X POST http://127.0.0.1:18081/get_height -H 'Content-Type: application/json' @@ -1280,29 +1280,29 @@ $ curl -X POST http://127.0.0.1:18081/get_height -H 'Content-Type: application/j ### **/get_blocks.bin** -Get all blocks info. Binary request. +Récupère toutes les infos des blocs. Requête binaire. -Alias: */getblocks.bin*. +Alias : */getblocks.bin*. -Inputs: +Entrées : -* *block_ids* - binary array of hashes; first 10 blocks id goes sequential, next goes in pow(2,n) offset, like 2, 4, 8, 16, 32, 64 and so on, and the last one is always genesis block -* *start_height* - unsigned int -* *prune* - boolean +* *block_ids* - liste binaire de hashes; Les 10 premiers blocs sont attendus séquentiellement, les suivant par décalage de puissance de 2, comme 2, 4, 8, 16, 32, 64 et ainsi de suite, et le dernier est toujours le bloc de genèse. +* *start_height* - entier non signé +* *prune* - booléen -Outputs: +Sorties : -* *blocks* - array of block complete entries -* *current_height* - unsigned int -* *output_indices* - structure as follows: - * *indices* - array of tx output indices, structure as follows: - * *indices* - array of unsigned int -* *start_height* - unsigned int -* *status* - string; General RPC error code. "OK" means everything looks good. -* *untrusted* - boolean; States if the result is obtained using the bootstrap mode, and is therefore not trusted (`true`), or when the daemon is fully synced (`false`). +* *blocks* - liste d'entrées de bloc complets +* *current_height* - entier non signé +* *output_indices* - structure comme suit : + * *indices* - liste d'indice de sorties de transactions, structure comme suit : + * *indices* - liste d'entier non signé +* *start_height* - entier non signé +* *status* - chaîne de caractères; Code erreur général RPC. "OK" signifie que tout va bien. +* *untrusted* - booléen; Indique si le résultat est obtenu en utilisant un nœud d'amorce, auquel il ne faudrait pas faire confiance (`true`), ou si le démon est totalement synchronisé (`false`).