From 27b253214fd01e0fb131fbe7bcd7622e80cf15ae Mon Sep 17 00:00:00 2001 From: Quentin Le Sceller Date: Mon, 6 Feb 2017 14:38:07 -0500 Subject: [PATCH 1/2] Added French Translation --- fr/Mining_Guide.md | 69 +++++++++++ fr/Sprout_User_Guide.md | 263 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 332 insertions(+) create mode 100644 fr/Mining_Guide.md create mode 100644 fr/Sprout_User_Guide.md diff --git a/fr/Mining_Guide.md b/fr/Mining_Guide.md new file mode 100644 index 0000000..89f5c01 --- /dev/null +++ b/fr/Mining_Guide.md @@ -0,0 +1,69 @@ +# Guide de Minage de Zcash + +Bienvenue ! Ce guide est destiné à vous faire miner Zcash, a.k.a "ZEC", sur le mainnet Zcash. +L'unité pour miner est la Sol/s (solution par seconde). + +Si vous rencontrez des problèmes, n'hésitez pas à nous contacter. Cela demande beaucoup de travail pour rendre cela utilisable and vos commentaires nous aides à prioriser les problèmes les plus importants. Pour l'aide utilisateur, nous recommendons d'utiliser notre forum : + +https://forum.z.cash/ + +## Préparation + +Tout d'abord, vous devez configurer un noeud local Zcash. Suivez le [Guide Utilisateur 1.0](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md) jusqu'à la section "Compilation", puis revenez sur ce guide. (Vous pouvez aussi faire la section "Tests" si vous le désirez !) + +## Configuration + +Configurez votre noeud comme dans [1.0-User-Guide#configuration](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md#configuration), jusqu'à la section [Activer le Minage CPU](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md#activer-le-minage-cpu-). + +## Minage + +Maintenant, commençons à miner ! +```bash +$ ./src/zcashd +``` + +Pour le lancer en tâche de fond (sans l'écran avec les métriques du noeud qui est normalement affiché) : + +```bash +$ ./src/zcashd -daemon +``` + +Vous devriez voir la sortie suivante dans le registre de déboggage (`~/.zcash/debug.log`) : + +```bash +Zcash Miner started +``` + +Félicitations ! Vous minez sur le mainnet. + +### Dépenser la Récompense de Minage + +Les pièces sont minés dans une t-addr (adresse transparente), mais peuvent seulement être dépensée vers une z-addr (adresse protégée). Référez vous à notre [Guide Utilisateur 1.0](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md) pour de plus amples instructions sur comment utiliser la commande `z_sendmany` pour envoyer des pièces de t-addr vers une z-addr. Vous devez avoir au moins 4GB de mémoire vive pour cette opération. + +## Modifications + +### Miner vers une seule adresse + +Le miner interne `zcashd` utilise une nouvelle adresse transparente pour chaque blocs miné. Si vous désirez utiliser la même adresse à chaque nouveau bloc miné, allez à la ligne suivante dans les fichiers `src/miner.cpp` (dans la fonction `ProcessBlockFound()`) et `src/wallet/wallet.cpp` (dans la fonction `CommitTransaction()`) : + +```cpp +reservekey.KeepKey(); +``` + +Enlevez ou commentez la ligne dans les deux fichiers. + +### Utiliser des transactions P2PKH + +Le miner interne `zcashd` hérité de Bitcoin utilise des transactions P2PK pour les transactions coinbase. La tendance actuelle dans la blockchain Bitcoin est d'utiliser P2PKH à la place ; nous considérons [changer le mineur interne pour utiliser P2PKH](https://github.com/zcash/zcash/issues/945), mais pas pour la version 1.0. + +Si vous désirez utiliser P2PKH pour les transactions coinbase, chercher la ligne suivante dans `src/miner.cpp` (dans la fonction `CreateNewBlockWithKey()`) : + +```cpp +CScript scriptPubKey = CScript() << ToByteVector(pubkey) << OP_CHECKSIG; +``` + +Changez la en : + +```cpp +CScript scriptPubKey = CScript() << OP_DUP << OP_HASH160 << ToByteVector(pubkey.GetID()) << OP_EQUALVERIFY << OP_CHECKSIG; +``` diff --git a/fr/Sprout_User_Guide.md b/fr/Sprout_User_Guide.md new file mode 100644 index 0000000..ca1c275 --- /dev/null +++ b/fr/Sprout_User_Guide.md @@ -0,0 +1,263 @@ +# Guide Zcash 1.0 "Pousse" + +Bienvenue ! Ce guide est destiné à vous permettre d'utiliser le réseau Zcash officiel. Actuellement, Zcash a encore quelques limitations : seulement Linux est officiellement supporté, requiert 64-bit, et dans certaines situations requiert une utilisation importante de la mémoire vive et du CPU pour créer des transactions. + +N'hésitez pas à nous contacter si vous rencontrez un problème. Nous planifions de diminuer l'utilisation du CPU et de la mémoire ainsi que le support d'autres architectures et systèmes d'exploitation. + +## Mise à jour + +Si vous participiez aux alpha/beta/rc testnets, vérifier que votre `~/.zcash/zcash.conf` ne contient pas `testnet=1` ou `addnode=betatestnet.z.cash`. Si vous êtes sur un distribution basé sur Debian, vous pouvez suivre les [instructions Debian](https://github.com/zcash/zcash/wiki/Debian-binary-packages) pour installer zcash sur votre système. +Dans le cas contraire, vous pouvez mettre à jour votre snapshot avec ce code : + +``` +git fetch origin +git checkout v1.0.3 +./zcutil/fetch-params.sh +./zcutil/build.sh -j$(nproc) +``` + +Vérifier également que votre dossier ``~/.zcash`` contient seulement ``zcash.conf`` pour commencer. + + +## Bref note sur la terminologie + +Zcash supporte deux type d'adresses, une _z-addr_ (qui commence avec un **z**) est un type d'adresse qui utilise les preuves à divulgation nulle de connaissance et d'autres chiffrements pour protéger la vie privée de l'utilisateur. Les t-addr (qui commence avec un **t**) sont similaires aux adresses Bitcoin. + +## Configuration Requise + +Actuellement, il vous faudra : + +* Linux (de préférence une distribution basée sur Debian) +* 64-bit +* 4GB de mémoire vive disponible. + +Les interface sont un client en ligne de commande (`zcash-cli`) et une interface d'appel de procédure à distance (en anglais RPC), qui est documentée ici : + +https://github.com/zcash/zcash/blob/v1.0.3/doc/payment-api.md + +## Sécurité + +Avant d'installer, de mettre à jour ou de mettre en marche zcash, assurez-vous d'avoir vérifier les potentielles problèmes de sécurité. Veuillez lire notre page sur la sécurité : + +https://z.cash/support/security.html + +## Démarrez + +### Système d'exploitation basé sur Debian + +Veuillez suivre les instructions ici : https://github.com/zcash/zcash/wiki/Debian-binary-packages + +### Compiler vous même + +Sur un système basé sur Ubuntu/Debian : + +```bash +$ sudo apt-get install \ + build-essential pkg-config libc6-dev m4 g++-multilib \ + autoconf libtool ncurses-dev unzip git python \ + zlib1g-dev wget bsdmainutils automake +``` + +Sur un système basé sur Fedora : + +```bash +$ sudo dnf install \ + git pkgconfig automake autoconf ncurses-devel python wget \ + gtest-devel gcc gcc-c++ libtool patch +``` + +Récupérer notre répertoire avec git et exécuter `fetch-params.sh` comme ceci : + +```bash +$ git clone https://github.com/zcash/zcash.git +$ cd zcash/ +$ git checkout v1.0.3 +$ ./zcutil/fetch-params.sh +``` + +Cela va récupérer les clés de vérification et de preuve (les clés finales créées lors de la [Cérémonie de Génération des Paramètres](https://github.com/zcash/mpc)), et les places dans `~/.zcash-params/`. Ces clés occupent un peu moins de 911MB d'espace disque, ainsi le téléchargement peut prendre du temps. + +Le message affiché par ``git checkout`` sur une "detached head" est normal et n'indique pas un problème. + +#### Compilation + +Assurez-vous d'avoir correctement installé les dépendances listées ci-dessus. Puis, lancer la compilation : + +```bash +$ ./zcutil/build.sh -j$(nproc) +``` +Cela devrait compiler les dépendances et `zcashd`. (Note : si vous n'avez pas de `nproc`, remplacez le par votre nombre de processeur.) + +#### Tests + +Les test prennent du temps à s'exécuter et peuvent requérir plus de 8GB de mémoire vive. Si vous préférez démarrer directement, vous pouvez directement aller à la section suivante. Si vous voulez lancer les tests pour vous assurer que Zcash fonctionne, exécutez : + +```bash +$ ./qa/zcash/full-test-suite.sh +``` + +Vous pouvez aussi exécuter les tests RPC, qui prennent plus de temps : + +```bash +$ ./qa/pull-tester/rpc-tests.sh +``` + +Ces tests nécessitent une quantité importante de mémoire vive pour s'exécuter correctement. Une erreur de mémoire insuffisante (out-of-memory error en anglais) résulte en général en un FAIL ou en une ERROR avec "std::bad_alloc" quelque part dans la sortie. + +## Configuration + +Créer le dossier `~/.zcash` et placer une fichier de configuration à `~/.zcash/zcash.conf` avec les commandes suivantes : + +```bash +mkdir -p ~/.zcash +echo "addnode=mainnet.z.cash" >~/.zcash/zcash.conf +echo "rpcuser=username" >>~/.zcash/zcash.conf +echo "rpcpassword=`head -c 32 /dev/urandom | base64`" >>~/.zcash/zcash.conf +``` + +Notez qu'il est possible que cela écrase vos réglages `zcash.conf` précédents que vous auriez pu ajouter lors du testnet. Vous pouvez garder un `zcash.conf` du testnet, mais vérifier que les réglages `testnet=1` et `addnode=betatestnet.z.cash` ont été supprimés; et ajoutez `addnode=mainnet.z.cash` à la place. Nous vous recommandons fortement d'utiliser une mot de passe aléatoire afin d'éviter des [problèmes de sécurité potentiel avec l'interface RPC](https://github.com/zcash/zcash/blob/master/doc/security-warnings.md#rpc-interface). + +### Activer le minage CPU : + +Si vous voulez activer le minage avec le CPU, exécutez ces commandes : + +```bash +$ echo 'gen=1' >> ~/.zcash/zcash.conf +$ echo "genproclimit=$(nproc)" >> ~/.zcash/zcash.conf +``` + +Le mineur par défaut n'est pas efficace, mais a été bien passé en revue. Pour utiliser un mineur bien plus efficace mais non passé en revue, vous pouvez exécuter cette commande : + +```bash +$ echo 'equihashsolver=tromp' >> ~/.zcash/zcash.conf +``` + +Note : vous pouvez lire le [Guide de Minage](https://github.com/zcash/zcash-docs/blob/master/fr/Mining_Guide.md) pour plus d'informations sur le minage. + +## Exécuter Zcash : + +Maintenant, lancer zcashd ! + +```bash +$ ./src/zcashd +``` + +Pour le lancer en tâche de fond (sans l'écran avec les différentes métriques du noeud qui est normalement affiché) exécutez ``./src/zcashd --daemon``. + +Vous devriez pouvoir utiliser l'interface RPC une fois que le chargement est terminé. Une façon rapide de tester : + +```bash +$ ./src/zcash-cli getinfo +``` + +**NOTE** : Si vous êtes familier avec l'interface RPC de bitcoind, vous pouvez utiliser la plupart de ces commandes pour envoyer des ZEC entre les `t-addr` adresses. Nous ne supportons pas la fonctionnalité de 'Comptes' (qui est maintenant obsolète dans ``bitcoind``) — seulement une chaine de caractères vide ``""`` peut être utilisée comme nom de compte. + +**NOTE** : Le noeud principal du réseau accessible à mainnet.z.cash est aussi accessible via les services cachés de Tor à zcmaintvsivr7pcn.onion. + +Pour voir à quels pairs vous êtes connectées : + +```bash +$ ./src/zcash-cli getpeerinfo +``` + +## Utiliser Zcash + +Tout d'abord, il vous faut obtenir des Zcash. Vous pouvez les acheter sur une plateforme d'échange, à d'autres utilisateurs, ou vendre des produits et services pour en récupérer ! La meilleur façon d'obtenir des Zcash (de manière sécuritaire) n'est pas documentée ici, mais faites attention. Evitez les arnaques ! + +### Générez une t-addr + +Tout d'abord, générons une t-addr. + +```bash +$ ./src/zcash-cli getnewaddress +tb4oHp2v54vfmdgQ3v3SNuQga8JKHTNi2a1 +``` + +### Recevoir des Zcash avec une z-addr + +Maintenant, générons une z-addr. + +```bash +$ ./src/zcash-cli z_getnewaddress +ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG +``` + +Cela va créer une adresse privée et stocker les clés dans votre fichier portefeuille local. Donnez cette adresse à votre expéditeur ! + +Les z-addr sont plutôt longues, une erreur est vite arrivée. Mettons la dans une variable d'environnement pour éviter les erreurs : + +```bash +$ ZADDR='ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG' +``` + +Pour obtenir une liste de toutes les adresses de votre portefeuille dont vous avec les clés, exécutez cette commande : + +```bash +$ ./src/zcash-cli z_listaddresses +``` + +Vous devriez voir quelque chose comme : +```json +[ + "zta6qngiR3U7HxYopyTWkaDLwYBd83D5MT7Jb9gpgTzPLMZytzRbtdPP1Syv4RvRgHeoZrJWSask3DyfwXG9DGPMWMvX7aC", + "ztbqWB8VDjVER7uLKb4oHp2v54v2a1jKd9o4FY7mdgQ3gDfG8MiZLvdQga8JK3t58yjXGjQHzMzkGUxSguSs6ZzqpgTNiZG" +] +``` + +Super ! Maintenant envoyer votre z-addr à votre expéditeur. Vous devriez voir à un moment la transaction en exécutant : + +```bash +$ ./src/zcash-cli z_listreceivedbyaddress "$ZADDR" +``` +```json +[ + { + "txid" : "af1665b317abe538148114a45322f28151925501c081949cc7a5207ef21cb750", + "amount" : 1.23, + "memo" : "48656c6c6f20ceb2210000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000" + } +] +``` + +### Envoyer des pièces avec votre z-addr + +Si quelqu'un vous donne sa z-addr... + +```bash +$ FRIEND='ztcDe8krwEt1ozWmGZhBDWrcUfmK3Ue5D5z1f6u2EZLLCjQq7mBRkaAPb45FUH4Tca91rF4R1vf983ukR71kHyXeED4quGV' +``` + +Vous pouvez lui envoyer 0.8 ZEC en faisant... + +```bash +$ ./src/zcash-cli z_sendmany "$ZADDR" "[{\"amount\": 0.8, \"address\": \"$FRIEND\"}]" +``` + +Après avoir attendu environ une minute, vous pouvez vérifier si l'opération est finie et a produit un résultat : +```bash +$ ./src/zcash-cli z_getoperationresult +``` +```json +[ + { + "id" : "opid-4eafcaf3-b028-40e0-9c29-137da5612f63", + "status" : "success", + "creation_time" : 1473439760, + "result" : { + "txid" : "3b85cab48629713cc0caae99a49557d7b906c52a4ade97b944f57b81d9b0852d" + }, + "execution_secs" : 51.64785629 + } +] +``` + + +## Problèmes de Sécurité Connus + +Chaque version contient un document `./doc/security-warnings.md` décrivant les problèmes de sécurités connues qui concernent cette version. Vous pouvez trouver la version la plus récente de ce document ici : + +https://github.com/zcash/zcash/blob/master/doc/security-warnings.md + +Pour de plus amples informations sur les notifications récentes et d'autres ressources, veuillez consulter notre page sur la sécurité : + +https://z.cash/support/security.html From 94938a20e4d1e498a33fbe686a9081175c61c974 Mon Sep 17 00:00:00 2001 From: ziruinyc Date: Wed, 5 Jul 2017 15:21:50 -0400 Subject: [PATCH 2/2] minor changes --- fr/Mining_Guide.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fr/Mining_Guide.md b/fr/Mining_Guide.md index 89f5c01..fca9c01 100644 --- a/fr/Mining_Guide.md +++ b/fr/Mining_Guide.md @@ -3,7 +3,7 @@ Bienvenue ! Ce guide est destiné à vous faire miner Zcash, a.k.a "ZEC", sur le mainnet Zcash. L'unité pour miner est la Sol/s (solution par seconde). -Si vous rencontrez des problèmes, n'hésitez pas à nous contacter. Cela demande beaucoup de travail pour rendre cela utilisable and vos commentaires nous aides à prioriser les problèmes les plus importants. Pour l'aide utilisateur, nous recommendons d'utiliser notre forum : +Si vous rencontrez des problèmes, n'hésitez pas à nous contacter. Cela demande beaucoup de travail pour rendre cela utilisable et vos commentaires nous aident à prioriser les problèmes les plus importants. Pour l'aide utilisateur, nous recommandons d'utiliser notre forum : https://forum.z.cash/ @@ -38,13 +38,13 @@ Félicitations ! Vous minez sur le mainnet. ### Dépenser la Récompense de Minage -Les pièces sont minés dans une t-addr (adresse transparente), mais peuvent seulement être dépensée vers une z-addr (adresse protégée). Référez vous à notre [Guide Utilisateur 1.0](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md) pour de plus amples instructions sur comment utiliser la commande `z_sendmany` pour envoyer des pièces de t-addr vers une z-addr. Vous devez avoir au moins 4GB de mémoire vive pour cette opération. +Les pièces sont minées dans une t-addr (adresse transparente), mais peuvent seulement être dépensées vers une z-addr (adresse protégée). Référez vous à notre [Guide Utilisateur 1.0](https://github.com/zcash/zcash-docs/blob/master/fr/Sprout_User_Guide.md) pour de plus amples instructions sur comment utiliser la commande `z_sendmany` pour envoyer des pièces de t-addr vers une z-addr. Vous devez avoir au moins 4GB de mémoire vive pour cette opération. ## Modifications ### Miner vers une seule adresse -Le miner interne `zcashd` utilise une nouvelle adresse transparente pour chaque blocs miné. Si vous désirez utiliser la même adresse à chaque nouveau bloc miné, allez à la ligne suivante dans les fichiers `src/miner.cpp` (dans la fonction `ProcessBlockFound()`) et `src/wallet/wallet.cpp` (dans la fonction `CommitTransaction()`) : +Le miner interne `zcashd` utilise une nouvelle adresse transparente pour chaque blocs minés. Si vous désirez utiliser la même adresse à chaque nouveau bloc miné, allez à la ligne suivante dans les fichiers `src/miner.cpp` (dans la fonction `ProcessBlockFound()`) et `src/wallet/wallet.cpp` (dans la fonction `CommitTransaction()`) : ```cpp reservekey.KeepKey();